Files
cobble/src/harness/tools/computer/open-computer-tools.ts
T
tbenandClaude Opus 5.5 0ce61cdb49 Add workspaces, conversation sessions, app-managed computers and pictures
- Rail: Add icon with stacked form modals (bot, workspace, computer),
  coordinator, recent bots with "See all bots", Workspaces section, and
  a workspace mode listing only its crew
- Workspaces: page for context, bots (per-workspace instructions and
  memory), computers (default, link, unlink), models and delete;
  conversations scoped per bot per workspace
- Sessions: conversations split into searchable, reopenable sessions
  with carry-over summaries; sessions and new-session header icons
- Computers: created and provisioned over the docker socket, home dir
  kept at DATA_DIR/computers/<id> after delete; super admins only
- Models: workspace settings win over a bot's own, then the defaults
- Pictures for bots and workspaces; bots editable from the header
- Coordinator tools: update_workspace, set_bot_workspace_instructions

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-19 08:39:33 +01:00

95 lines
3.4 KiB
TypeScript

import { ComputerMcpExcludedTools } from "@/src/dict/computer-dict";
import grabComputerMcpUrl from "@/src/functions/backend/db/computers/grab-computer-mcp-url";
import grabComputerEnvs from "@/src/functions/backend/db/envs/grab-computer-envs";
import redactSecrets from "@/src/utils/redact-secrets";
import connectMcpServer from "../../mcp/connect-mcp-server";
import grabMcpTools from "../../mcp/grab-mcp-tools";
import readImage from "../../media/read-image";
import type { HarnessTool } from "../../types";
import withComputerEnv from "./with-computer-env";
import writeComputerEnv from "./write-computer-env";
type Params = {
computer_id: number | string;
/**
* Screenshots are read with this bot's media reading model.
*/
bot_id?: number | string;
/**
* The workspace the run is in: its envs apply, and its models read
* screenshots.
*/
workspace_id?: number | string | null;
signal?: AbortSignal;
};
export type OpenComputer = {
name: string;
tools: HarnessTool[];
/**
* The envs set on the computer, for the prompt: keys and descriptions,
* never values.
*/
envs: { key: string; description: string }[];
/**
* Blanks the computer's secret values out of text, e.g. the report.
*/
redact: (text: string) => string;
close: () => Promise<void>;
};
/**
* Connects to a computer (its AIO sandbox, over MCP) and returns its tools:
* shell, files, code and browser. Its envs (`grabComputerEnvs`) are written
* to the computer and loaded by the shell and code tools; secret values are
* redacted from everything the tools return. Screenshots come back as
* readings from the media reading harness. Call `close` when the run ends.
* Throws when the computer can't be reached, which the queue retries.
*/
export default async function openComputerTools({
computer_id,
bot_id,
workspace_id,
signal,
}: Params): Promise<OpenComputer> {
const target = await grabComputerMcpUrl({ computer_id });
if (!target) {
throw new Error(`Computer #${computer_id} has no container to connect to.`);
}
const envs = await grabComputerEnvs({ computer_id, workspace_id });
const paths = await writeComputerEnv({ base_url: target.base_url, envs, signal });
const secrets = envs.filter((env) => env.secret);
const redact = (text: string) => redactSecrets({ text, secrets });
const client = await connectMcpServer({ url: target.url, signal });
try {
const tools = await grabMcpTools({
client,
exclude: ComputerMcpExcludedTools,
redact,
describeImage: ({ data, mime_type }) =>
readImage({
url: `data:${mime_type};base64,${data}`,
focus: "This is a screenshot of a computer screen. Describe the page layout, text, buttons and form fields, and any errors or popups.",
signal,
bot_id,
workspace_id,
}),
});
return {
name: target.name,
tools: tools.map((tool) => withComputerEnv({ tool, ...paths })),
envs: envs.map((env) => ({ key: env.key, description: env.description })),
redact,
close: () => client.close().catch(() => {}),
};
} catch (error) {
await client.close().catch(() => {});
throw error;
}
}