Move secrets between users and computers without the model seeing them

A new personal env scope (paradigm user: one user's secret for one bot)
beats every other scope, reaches only that user's runs of that bot, and
is redacted like any secret. Bots take secrets in with request_secret,
which puts a [secret-request:ID] card in the chat: the user types the
value into a masked input there, never into a message, and the bot is
told only the key. Bots show secrets with capture_secret (a task's
computer tool that saves a file or a command's output straight to a
personal env, then redacts it from the rest of the run) and show_secret
(an env by key): both give a [secret:ID] chip whose Reveal and Copy fetch
the value on click, for its own user (personal) or a super admin
(anything else), logged by key. Values never go into messages, page
props, history, Copy chat or logs. Users manage their own secrets on
Settings > Secrets; the Environment page lists everyone's, remove only.
Deleting a bot or user removes its personal secrets, and SecretsNote
tells bots never to ask for or print secrets in chat.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
2026-10-25 16:51:32 +01:00
co-authored by Claude Opus 5.5
parent 83ff79b9c3
commit 69988e08fc
78 changed files with 2472 additions and 52 deletions
@@ -10,6 +10,7 @@ import grabMcpTools from "../../mcp/grab-mcp-tools";
import readImage from "../../media/read-image";
import type { HarnessTool } from "../../types";
import computerDirsShell from "./computer-dirs-shell";
import captureSecretTool from "./capture-secret-tool";
import runComputerCommand from "./run-computer-command";
import withComputerDirs from "./with-computer-dirs";
import withComputerEnv from "./with-computer-env";
@@ -21,6 +22,10 @@ type Params = {
* Screenshots are read with this bot's media reading model.
*/
bot_id?: number | string;
/**
* The user the run is for: their personal envs for the bot apply.
*/
user_id?: number | string | null;
/**
* The workspace the run is in: its envs apply, and its models read
* screenshots.
@@ -31,6 +36,12 @@ type Params = {
* kept inside them.
*/
dirs: ComputerRunDirs;
/**
* Called with the ref of each secret the bot captures on the computer
* (`capture_secret`), so the run's message always carries its chip.
* Without it, or without a user, the bot can't capture secrets.
*/
onSecretRef?: (params: { ref: string }) => void;
signal?: AbortSignal;
};
@@ -61,8 +72,10 @@ export type OpenComputer = {
export default async function openComputerTools({
computer_id,
bot_id,
user_id,
workspace_id,
dirs,
onSecretRef,
signal,
}: Params): Promise<OpenComputer> {
const target = await grabComputerMcpUrl({ computer_id });
@@ -75,7 +88,7 @@ export default async function openComputerTools({
throw new Error(computerNotReadyMessage(target));
}
const envs = await grabComputerEnvs({ computer_id, bot_id, workspace_id });
const envs = await grabComputerEnvs({ computer_id, bot_id, user_id, workspace_id });
const paths = await writeComputerEnv({ base_url: target.base_url, envs, signal });
await runComputerCommand({
@@ -85,7 +98,11 @@ export default async function openComputerTools({
signal,
});
const secrets = envs.filter((env) => env.secret);
/**
* Grows as the bot captures secrets, so a value it saved is blanked
* from everything it reads afterwards too.
*/
const secrets: { key: string; value: string }[] = envs.filter((env) => env.secret);
const redact = (text: string) => redactSecrets({ text, secrets });
const client = await connectMcpServer({ url: target.url, signal });
@@ -107,7 +124,24 @@ export default async function openComputerTools({
return {
name: target.name,
tools: tools.map((tool) => withComputerDirs({ tool: withComputerEnv({ tool, ...paths }), dirs })),
tools: [
...tools.map((tool) => withComputerDirs({ tool: withComputerEnv({ tool, ...paths }), dirs })),
...(user_id && bot_id && onSecretRef
? [
captureSecretTool({
base_url: target.base_url,
shell_path: paths.shell_path,
dirs,
user_id,
bot_id,
onCapture: ({ key, value, ref }) => {
secrets.push({ key, value });
onSecretRef({ ref });
},
}),
]
: []),
],
envs: envs.map((env) => ({ key: env.key, description: env.description })),
redact,
close: () => client.close().catch(() => {}),