@workerdeck/core 1.1.0 → 1.3.0

package/build/index.d.mts

@@ -190,6 +190,7 @@ type AiSdkRunnerConfig = Omit<CreateSessionRequest, 'cwd'> & {
     memoryLimitBytes?: number;
   };
   executionBackend?: ToolExecutionBackend;
+  toolTitles?: Record<string, string>;
   shouldApprove?: (call: {
     toolName: string;
     input: unknown;
@@ -424,6 +425,7 @@ type ToolDefinition = {
   name: string;
   trust: ToolTrust;
   tool: Tool$1;
+  title?: string;
 };
 type ToolContextOptions = {
   executor: ToolExecutor;
@@ -462,6 +464,7 @@ declare function withMcpTools(context: ToolContext, mcpTools: ToolSet$1): ToolCo
 type HostToolDefinition = {
   tool: Tool$1;
   trust: ToolTrust;
+  title?: string;
 };
 declare function withHostTools(context: ToolContext, hostTools: Record<string, HostToolDefinition>, kind?: string): ToolContext;
 //#endregion
@@ -664,7 +667,11 @@ type AppServerUserMessageItem = {
   type: 'userMessage';
   content?: unknown;
 };
-type AppServerItem = AppServerAgentMessageItem | AppServerReasoningItem | AppServerCommandExecutionItem | AppServerFileChangeItem | AppServerMcpToolCallItem | AppServerWebSearchItem | AppServerImageGenerationItem | AppServerImageViewItem | AppServerUserMessageItem | AppServerSubAgentActivityItem | AppServerCollabAgentToolCallItem;
+type AppServerContextCompactionItem = {
+  id: string;
+  type: 'contextCompaction';
+};
+type AppServerItem = AppServerAgentMessageItem | AppServerReasoningItem | AppServerCommandExecutionItem | AppServerFileChangeItem | AppServerMcpToolCallItem | AppServerWebSearchItem | AppServerImageGenerationItem | AppServerImageViewItem | AppServerUserMessageItem | AppServerSubAgentActivityItem | AppServerCollabAgentToolCallItem | AppServerContextCompactionItem;
 type AppServerTurn = {
   id: string;
   status: string;
@@ -728,33 +735,6 @@ declare function listCodexSessions(options: {
 declare const codexAdapter: EngineAdapter;
 //#endregion
 //#region src/engines/codex/catalog.d.ts
-/**
- * The Codex engine's model catalog, seeded from the binary's own embedded model
- * table (see `provenance` for the version) — that table, not the SDK's stale
- * `ModelReasoningEffort` union, is the truth about which reasoning efforts each
- * model takes. Mapping decisions: the internal `codex-auto-review` row is dropped
- * (the codex analogue of the CLI's `default` sentinel), `primary` mirrors the
- * binary's own `visibility` field so both UIs group the way codex's picker does,
- * and `reasoningEfforts` carries `supported_reasoning_levels` verbatim — `max`
- * and `ultra` go beyond the SDK union, so trust the binary and keep strings open.
- *
- * **Refresh procedure** (release checklist): extract the embedded JSON from the
- * platform binary and diff. The two-hop resolve is NOT optional — under pnpm's
- * strict layout the platform package is a dependency of `@openai/codex` and
- * resolves only from that wrapper's location (MODULE_NOT_FOUND otherwise), the
- * same two hops `resolveBundledCodexExecutable` makes.
- *
- *   node -e 'const d=require("fs").readFileSync(process.argv[1]);
- *     const s=d.indexOf(`{\n  "models": [`);
- *     let i=s,n=0; do{n+=(d[i]===123)-(d[i]===125);i++}while(n);
- *     const c=JSON.parse(d.slice(s,i));
- *     for(const m of c.models) console.log(m.slug, m.display_name,
- *       m.visibility, m.supported_reasoning_levels.map(l=>l.effort).join(","))'\
- *     "$(node -p 'const{createRequire}=require("module");
- *       const w=require.resolve("@openai/codex/package.json");
- *       createRequire(w).resolve("@openai/codex-darwin-arm64/package.json")
- *         .replace("package.json","vendor/aarch64-apple-darwin/bin/codex")')"
- */
 declare const CODEX_CATALOG: ModelCatalog;
 //#endregion
 //#region src/engines/codex/runner.d.ts

package/build/index.mjs

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
 import { createHash, randomUUID } from "node:crypto";
 import { getSessionInfo, getSessionMessages, listSessions, query } from "@anthropic-ai/claude-agent-sdk";
-import { ENGINE_CAPABILITIES, PROTOCOL_VERSION, SUBAGENT_HISTORY, TOOL_RESULT_HEAD_CHARS, contextReading, imagePartRef, replayCoalesceKey, replayRetains, snapshotRetains, transcriptActivity, transcriptContent, transcriptProse } from "@workerdeck/protocol";
+import { ENGINE_CAPABILITIES, PROTOCOL_VERSION, SUBAGENT_HISTORY, TOOL_RESULT_HEAD_CHARS, contextReading, imagePartRef, replayCoalesceKey, replayRetains, sanitizeToolTitle, snapshotRetains, transcriptActivity, transcriptContent, transcriptProse } from "@workerdeck/protocol";
 import { ToolLoopAgent, generateText, isStepCount, tool } from "ai";
 import { execFile, spawn } from "node:child_process";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
@@ -276,11 +276,16 @@ function mcpStatusInfo(status) {
 		command: config?.command,
 		args: config?.args,
 		url: config?.url,
-		tools: status.tools?.map((tool) => ({
-			name: tool.name,
-			description: tool.description,
-			annotations: tool.annotations
-		}))
+		tools: status.tools?.map((tool) => {
+			const probe = tool;
+			const title = probe.title ?? probe.annotations?.title;
+			return {
+				name: tool.name,
+				title: sanitizeToolTitle(typeof title === "string" ? title : void 0, tool.name),
+				description: tool.description,
+				annotations: tool.annotations
+			};
+		})
 	};
 }
 function defaultModelFromSdk(models) {
@@ -418,7 +423,6 @@ var EventLog = class {
 	get activityCount() {
 		return this.#activityCount;
 	}
-	/** The unread badge's unit — see `transcriptProse`. Folded here so a restored log recomputes it. */
 	get proseCount() {
 		return this.#proseCount;
 	}
@@ -1120,6 +1124,7 @@ var SessionRunner = class {
 			this.#turnOverWhileBlocked = false;
 			this.#setStatus("running");
 			this.#fetchCapabilities();
+			this.#fetchToolTitles();
 			this.#fetchContextUsage();
 			this.#fetchRateLimits();
 			this.#fetchEngineTitle();
@@ -1153,6 +1158,16 @@ var SessionRunner = class {
 			}
 		}
 	}
+	async #fetchToolTitles() {
+		const servers = await this.mcpServers().catch(() => void 0);
+		if (this.#closed || !servers) return;
+		const titles = {};
+		for (const server of servers) for (const tool of server.tools ?? []) if (tool.title) titles[`mcp__${server.name}__${tool.name}`] = tool.title;
+		if (Object.keys(titles).length > 0) this.#emit({
+			type: "tool_titles",
+			titles
+		});
+	}
 	async #fetchCapabilities() {
 		if (this.#capabilitiesEmitted) return;
 		const query = this.#query;
@@ -1477,6 +1492,7 @@ var AiSdkRunner = class {
 	start() {
 		if (this.#started) return this.#turnChain;
 		this.#started = true;
+		this.#emitToolTitles();
 		if (this.#config.restore) return this.#turnChain;
 		this.#setStatus("idle");
 		if (this.#config.prompt) this.sendMessage(this.#config.prompt);
@@ -2135,6 +2151,13 @@ var AiSdkRunner = class {
 			detail
 		});
 	}
+	#emitToolTitles() {
+		const titles = this.#config.toolTitles;
+		if (titles && Object.keys(titles).length > 0) this.#emit({
+			type: "tool_titles",
+			titles
+		});
+	}
 	#emit(body) {
 		this.#subscribers.emit(this.#log.append(body));
 	}
@@ -2667,7 +2690,7 @@ function withHostTools(context, hostTools, kind = "host tool") {
 	const definitions = [...context.definitions];
 	const tools = { ...context.tools };
 	const sandboxedToolNames = [...context.sandboxedToolNames];
-	for (const [name, { tool: hostTool, trust }] of entries) {
+	for (const [name, { tool: hostTool, trust, title }] of entries) {
 		if (name in tools) throw new Error(`${kind} '${name}' collides with an existing tool of the same name`);
 		const executes = typeof hostTool.execute === "function";
 		if (trust === "sandboxed" && executes) throw new Error(`${kind} '${name}' is declared sandboxed but has an \`execute\` — it would run in this process with full authority. Drop \`execute\` so it rides the ToolExecutor seam.`);
@@ -2675,7 +2698,8 @@ function withHostTools(context, hostTools, kind = "host tool") {
 		definitions.push({
 			name,
 			trust,
-			tool: hostTool
+			tool: hostTool,
+			title
 		});
 		tools[name] = hostTool;
 		if (trust === "sandboxed") sandboxedToolNames.push(name);
@@ -2947,6 +2971,7 @@ function createEngineSession(options) {
 		vfs,
 		executor,
 		executableTools: context.sandboxedToolNames,
+		toolTitles: collectToolTitles(context.definitions, options.mcp?.servers),
 		executionBackend: typeof options.backend === "function" ? void 0 : options.backend ?? "server",
 		executionLimits: options.executionLimits,
 		shouldApprove: options.shouldApprove,
@@ -2955,6 +2980,18 @@ function createEngineSession(options) {
 	}, options.id);
 	return runner;
 }
+function collectToolTitles(definitions, servers) {
+	const titles = {};
+	for (const definition of definitions) {
+		const title = sanitizeToolTitle(definition.title, definition.name);
+		if (title) titles[definition.name] = title;
+	}
+	for (const server of servers ?? []) for (const tool of server.tools ?? []) {
+		const title = sanitizeToolTitle(tool.title, tool.name);
+		if (title) titles[`${server.name}__${tool.name}`] = title;
+	}
+	return Object.keys(titles).length > 0 ? titles : void 0;
+}
 function requireDeclaredServers(profileName, declared, mcp, tools) {
 	if (!declared || declared.length === 0) return;
 	const missing = declared.filter((name) => {
@@ -2999,12 +3036,13 @@ async function connectMcpTools(servers, options = {}) {
 			});
 			clients.push(client);
 			const connected = await client.tools();
+			const listed = await listToolRecords(client);
 			for (const [toolName, mcpTool] of Object.entries(connected)) tools[`${name}__${toolName}`] = mcpTool;
 			statuses.push({
 				name,
 				status: "connected",
 				...identity,
-				tools: Object.entries(connected).map(([toolName, mcpTool]) => toToolInfo(toolName, mcpTool))
+				tools: Object.entries(connected).map(([toolName, mcpTool]) => toToolInfo(toolName, mcpTool, listed.get(toolName)))
 			});
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error);
@@ -3038,11 +3076,27 @@ function describeServer(server) {
 		args: server.args
 	};
 }
-function toToolInfo(name, mcpTool) {
+async function listToolRecords(client) {
+	const records = /* @__PURE__ */ new Map();
+	if (typeof client.listTools !== "function") return records;
+	try {
+		const listed = await client.listTools();
+		for (const record of listed.tools ?? []) records.set(record.name, record);
+	} catch {}
+	return records;
+}
+function toToolInfo(name, mcpTool, record) {
 	const { description, inputSchema } = mcpTool ?? {};
+	const hints = record?.annotations;
 	return {
 		name,
+		title: sanitizeToolTitle(record?.title ?? hints?.title, name),
 		description: typeof description === "string" ? description : void 0,
+		annotations: hints ? {
+			readOnly: hints.readOnlyHint,
+			destructive: hints.destructiveHint,
+			openWorld: hints.openWorldHint
+		} : void 0,
 		inputSchema: inputSchema?.jsonSchema
 	};
 }
@@ -3171,18 +3225,12 @@ const claudeAdapter = {
 };
 //#endregion
 //#region src/engines/codex/connect.ts
-/**
-* The operator's environment reaches the child whole — WorkerDeck resolves no credential of its
-* own — and the profile's CODEX_HOME is the one key it pins, last, so a profile always wins over
-* an inherited value. Every path that spawns or connects to an app-server goes through here.
-*/
 function codexChildEnv(base, codexHome) {
 	const env = {};
 	for (const [key, value] of Object.entries(base)) if (value !== void 0) env[key] = value;
 	if (codexHome) env.CODEX_HOME = codexHome;
 	return env;
 }
-/** `experimentalApi` gates the granular approval policy and there is no non-experimental fallback, so it is not per-call-site. */
 const INITIALIZE_PARAMS = {
 	clientInfo: {
 		name: "workerdeck",
@@ -4903,6 +4951,13 @@ var CodexRunner = class {
 			this.#emitToolUse(id, "CodexImageView", { path: item.path }, agent);
 			this.#emitToolResult(id, item.path, false, void 0, agent?.toolUseId ?? null);
 		},
+		contextCompaction: (_item, _active, id, agent) => {
+			this.#emit({
+				type: "context_compacted",
+				uuid: id,
+				parentToolUseId: agent?.toolUseId ?? null
+			});
+		},
 		subAgentActivity: (item, _active, id, agent) => {
 			if (this.#replayingHistory) {
 				if (item.kind !== "started") return;
@@ -5094,33 +5149,6 @@ var CodexRunner = class {
 };
 //#endregion
 //#region src/engines/codex/catalog.ts
-/**
-* The Codex engine's model catalog, seeded from the binary's own embedded model
-* table (see `provenance` for the version) — that table, not the SDK's stale
-* `ModelReasoningEffort` union, is the truth about which reasoning efforts each
-* model takes. Mapping decisions: the internal `codex-auto-review` row is dropped
-* (the codex analogue of the CLI's `default` sentinel), `primary` mirrors the
-* binary's own `visibility` field so both UIs group the way codex's picker does,
-* and `reasoningEfforts` carries `supported_reasoning_levels` verbatim — `max`
-* and `ultra` go beyond the SDK union, so trust the binary and keep strings open.
-*
-* **Refresh procedure** (release checklist): extract the embedded JSON from the
-* platform binary and diff. The two-hop resolve is NOT optional — under pnpm's
-* strict layout the platform package is a dependency of `@openai/codex` and
-* resolves only from that wrapper's location (MODULE_NOT_FOUND otherwise), the
-* same two hops `resolveBundledCodexExecutable` makes.
-*
-*   node -e 'const d=require("fs").readFileSync(process.argv[1]);
-*     const s=d.indexOf(`{\n  "models": [`);
-*     let i=s,n=0; do{n+=(d[i]===123)-(d[i]===125);i++}while(n);
-*     const c=JSON.parse(d.slice(s,i));
-*     for(const m of c.models) console.log(m.slug, m.display_name,
-*       m.visibility, m.supported_reasoning_levels.map(l=>l.effort).join(","))'\
-*     "$(node -p 'const{createRequire}=require("module");
-*       const w=require.resolve("@openai/codex/package.json");
-*       createRequire(w).resolve("@openai/codex-darwin-arm64/package.json")
-*         .replace("package.json","vendor/aarch64-apple-darwin/bin/codex")')"
-*/
 const CODEX_CATALOG = {
 	provenance: "embedded model presets of @openai/codex@0.151.0 (darwin-arm64 binary), re-extracted 2026-09-02 and unchanged since 0.149.0",
 	models: [