@xopcai/xopc 0.0.82 → 0.0.83

package/dist/src/agent/tools/delegate-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"delegate-tool.js","names":[],"sources":["../../../../src/agent/tools/delegate-tool.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport { createDelegateChildHandle, type DelegateChildHandleOptions } from '../child-agent-factory.js';\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport const DEFAULT_DELEGATE_TOOLS = [\n  'shell',\n  'read_file',\n  'write_file',\n  'edit_file',\n  'grep',\n  'find',\n  'list_dir',\n  'web_search',\n  'web_fetch',\n] as const;\n\n/** Tools never passed to a delegated sub-agent (even if requested). */\nexport const DELEGATE_BLOCKED_TOOLS = new Set([\n  'delegate_task',\n  'clarify',\n  'curated_memory',\n  'send_message',\n  'send_media',\n  'todo',\n  'session_search',\n  'memory_search',\n  'memory_get',\n  'cronjob',\n  'skills_list',\n  'skill_view',\n  'skill_manage',\n  'bundle-mcp',\n]);\n\nconst DelegateTaskSchema = Type.Object({\n  goal: Type.String({\n    description: 'Clear description of what the sub-agent should accomplish',\n  }),\n  context: Type.Optional(\n    Type.String({\n      description: 'Additional context the sub-agent needs (file paths, constraints, etc.)',\n    }),\n  ),\n  toolset: Type.Optional(\n    Type.Array(Type.String(), {\n      description:\n        'Tool names the sub-agent may use. Defaults to shell, read_file, write_file, edit_file, grep, find, list_dir, web_search, web_fetch. ' +\n        'Dangerous or interactive tools are always removed.',\n    }),\n  ),\n  maxIterations: Type.Optional(\n    Type.Number({\n      description: 'Maximum tool executions in the sub-agent (default: 30)',\n      default: DEFAULT_MAX_ITERATIONS,\n    }),\n  ),\n});\n\nexport interface DelegateToolDeps {\n  workspace: string;\n  getSubagentModel: () => import('@earendil-works/pi-ai').Model<import('@earendil-works/pi-ai').Api>;\n  bus: import('../../infra/bus/index.js').MessageBus;\n  getConfig: () => import('../../config/schema.js').Config | undefined;\n  getCurrentContext?: () => { sessionKey?: string; channel?: string; accountId?: string; to?: string; threadId?: string | number } | null;\n  hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;\n  toolExecutorConfig?: Partial<import('./executor.js').ToolExecutorConfig>;\n}\n\ntype DelegateTaskParams = {\n  goal: string;\n  context?: string;\n  toolset?: string[];\n  maxIterations?: number;\n};\n\nexport function createDelegateTool(deps: DelegateToolDeps): AgentTool {\n  return {\n    name: 'delegate_task',\n    label: '🤖 Delegate',\n    description:\n      'Spawn a sub-agent for an isolated subtask with a fresh conversation (no parent transcript).\\n\\n' +\n      'The sub-agent returns a text summary only — tool traces stay out of your context.\\n\\n' +\n      'WHEN TO USE:\\n' +\n      '- Independent work (research, multi-file exploration) where you only need the outcome\\n' +\n      '- Avoiding context bloat from long intermediate tool output\\n\\n' +\n      'WHEN NOT TO USE:\\n' +\n      '- Tasks that need this chat history or user clarification\\n' +\n      '- Single trivial steps\\n\\n' +\n      'Sub-agents cannot use clarify, messaging, memory tools, todo, or nested delegate_task.',\n    parameters: DelegateTaskSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{ summary: string; iterations: number }>> {\n      const p = params as DelegateTaskParams;\n      const maxIterations = p.maxIterations ?? DEFAULT_MAX_ITERATIONS;\n      if (!Number.isFinite(maxIterations) || maxIterations < 1 || maxIterations > 200) {\n        return {\n          content: [{ type: 'text', text: 'Invalid maxIterations (use 1–200).' }],\n          details: { summary: '', iterations: 0 },\n        };\n      }\n\n      const requested = p.toolset ?? [...DEFAULT_DELEGATE_TOOLS];\n      const allowedNames = [\n        ...new Set(\n          requested.map((t) => String(t).trim()).filter(Boolean).filter((t) => !DELEGATE_BLOCKED_TOOLS.has(t)),\n        ),\n      ];\n\n      if (allowedNames.length === 0) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: 'No allowed tools remain after applying the delegation blocklist. Expand `toolset` with safe tools.',\n            },\n          ],\n          details: { summary: '', iterations: 0 },\n        };\n      }\n\n      let model: ReturnType<DelegateToolDeps['getSubagentModel']>;\n      try {\n        model = deps.getSubagentModel();\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `delegate_task: ${msg}` }],\n          details: { summary: '', iterations: 0 },\n        };\n      }\n\n      const childOptions: DelegateChildHandleOptions = {\n        workspace: deps.workspace,\n        goal: p.goal,\n        context: p.context,\n        allowedToolNames: allowedNames,\n        maxIterations,\n        model,\n        bus: deps.bus,\n        getConfig: deps.getConfig,\n        toolExecutorConfig: deps.toolExecutorConfig,\n      };\n\n      // Sub-agent lifecycle hook (parity surface for channel thread bindings).\n      const ctx = deps.getCurrentContext?.() ?? null;\n      const parentSessionKey = ctx?.sessionKey;\n      let childSessionKey: string | undefined;\n      try {\n        if (deps.hookRunner && parentSessionKey) {\n          const { parseSessionKey, buildSessionKey } = await import('../../routing/session-key.js');\n          const parsed = parseSessionKey(parentSessionKey);\n          if (parsed) {\n            childSessionKey = buildSessionKey({\n              agentId: 'subagent',\n              source: parsed.agentId,\n              accountId: parsed.accountId,\n              peerKind: parsed.peerKind,\n              peerId: parsed.peerId,\n              threadId: parsed.threadId,\n              scopeId: parsed.scopeId,\n            });\n          }\n          if (childSessionKey) {\n            const hookResult = await (deps.hookRunner as any).runHooksWithResult(\n              'subagent_spawning',\n              {\n                childSessionKey,\n                requester: {\n                  channel: ctx?.channel,\n                  accountId: ctx?.accountId,\n                  to: (ctx as any)?.to,\n                  threadId: (ctx as any)?.threadId,\n                },\n                threadRequested: true,\n                agentId: 'subagent',\n                label: 'delegate_task',\n              },\n              { sessionKey: parentSessionKey, agentId: ctx?.channel },\n            );\n            const r = hookResult as any;\n            if (r && r.status === 'error') {\n              return {\n                content: [{ type: 'text', text: `delegate_task: ${String(r.error || 'subagent spawn blocked')}` }],\n                details: { summary: '', iterations: 0 },\n              };\n            }\n          }\n        }\n      } catch {\n        // Hooks are best-effort.\n      }\n\n      const child = createDelegateChildHandle(childOptions);\n\n      if (signal) {\n        signal.addEventListener('abort', () => child.abort(), { once: true });\n      }\n\n      try {\n        const { summary, toolIterations } = await child.run();\n        try {\n          if (deps.hookRunner && childSessionKey) {\n            await (deps.hookRunner as any).runHooks(\n              'subagent_ended',\n              { targetSessionKey: childSessionKey, accountId: ctx?.accountId },\n              { sessionKey: parentSessionKey },\n            );\n          }\n        } catch {\n          // best-effort\n        }\n        return {\n          content: [{ type: 'text', text: `Sub-agent completed:\\n\\n${summary}` }],\n          details: { summary, iterations: toolIterations },\n        };\n      } catch (error) {\n        child.abort();\n        try {\n          if (deps.hookRunner && childSessionKey) {\n            await (deps.hookRunner as any).runHooks(\n              'subagent_ended',\n              { targetSessionKey: childSessionKey, accountId: ctx?.accountId },\n              { sessionKey: parentSessionKey },\n            );\n          }\n        } catch {\n          // best-effort\n        }\n        const message = error instanceof Error ? error.message : String(error);\n        return {\n          content: [{ type: 'text', text: `Sub-agent failed: ${message}` }],\n          details: { summary: '', iterations: 0 },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"delegate-tool.js","names":[],"sources":["../../../../src/agent/tools/delegate-tool.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport {\n  createDelegateChildHandle,\n  type BuildChildToolsOptions,\n  type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport const DEFAULT_DELEGATE_TOOLS = [\n  'shell',\n  'read_file',\n  'write_file',\n  'edit_file',\n  'grep',\n  'find',\n  'list_dir',\n  'web_search',\n  'web_fetch',\n] as const;\n\n/** Tools never passed to a delegated sub-agent (even if requested). */\nexport const DELEGATE_BLOCKED_TOOLS = new Set([\n  'delegate_task',\n  'clarify',\n  'curated_memory',\n  'send_message',\n  'send_media',\n  'todo',\n  'session_search',\n  'memory_search',\n  'memory_get',\n  'cronjob',\n  'skills_list',\n  'skill_view',\n  'skill_manage',\n  'bundle-mcp',\n]);\n\nconst DelegateTaskSchema = Type.Object({\n  goal: Type.String({\n    description: 'Clear description of what the sub-agent should accomplish',\n  }),\n  context: Type.Optional(\n    Type.String({\n      description: 'Additional context the sub-agent needs (file paths, constraints, etc.)',\n    }),\n  ),\n  toolset: Type.Optional(\n    Type.Array(Type.String(), {\n      description:\n        'Tool names the sub-agent may use. Defaults to shell, read_file, write_file, edit_file, grep, find, list_dir, web_search, web_fetch. ' +\n        'Dangerous or interactive tools are always removed.',\n    }),\n  ),\n  maxIterations: Type.Optional(\n    Type.Number({\n      description: 'Maximum tool executions in the sub-agent (default: 30)',\n      default: DEFAULT_MAX_ITERATIONS,\n    }),\n  ),\n});\n\nexport interface DelegateToolDeps {\n  workspace: string;\n  getSubagentModel: () => import('@earendil-works/pi-ai').Model<import('@earendil-works/pi-ai').Api>;\n  bus: import('../../infra/bus/index.js').MessageBus;\n  getConfig: () => import('../../config/schema.js').Config | undefined;\n  getCurrentContext?: () => { sessionKey?: string; channel?: string; accountId?: string; to?: string; threadId?: string | number } | null;\n  hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;\n  toolExecutorConfig?: Partial<import('./executor.js').ToolExecutorConfig>;\n  /**\n   * Construct the child agent's tool set. Injected by `AgentToolsFactory` so\n   * the child-agent-factory module does not import `tools/factory.ts`\n   * (which would form a factory ↔ delegate-tool ↔ child-agent-factory cycle).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\ntype DelegateTaskParams = {\n  goal: string;\n  context?: string;\n  toolset?: string[];\n  maxIterations?: number;\n};\n\nexport function createDelegateTool(deps: DelegateToolDeps): AgentTool {\n  return {\n    name: 'delegate_task',\n    label: '🤖 Delegate',\n    description:\n      'Spawn a sub-agent for an isolated subtask with a fresh conversation (no parent transcript).\\n\\n' +\n      'The sub-agent returns a text summary only — tool traces stay out of your context.\\n\\n' +\n      'WHEN TO USE:\\n' +\n      '- Independent work (research, multi-file exploration) where you only need the outcome\\n' +\n      '- Avoiding context bloat from long intermediate tool output\\n\\n' +\n      'WHEN NOT TO USE:\\n' +\n      '- Tasks that need this chat history or user clarification\\n' +\n      '- Single trivial steps\\n\\n' +\n      'Sub-agents cannot use clarify, messaging, memory tools, todo, or nested delegate_task.',\n    parameters: DelegateTaskSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{ summary: string; iterations: number }>> {\n      const p = params as DelegateTaskParams;\n      const maxIterations = p.maxIterations ?? DEFAULT_MAX_ITERATIONS;\n      if (!Number.isFinite(maxIterations) || maxIterations < 1 || maxIterations > 200) {\n        return {\n          content: [{ type: 'text', text: 'Invalid maxIterations (use 1–200).' }],\n          details: { summary: '', iterations: 0 },\n        };\n      }\n\n      const requested = p.toolset ?? [...DEFAULT_DELEGATE_TOOLS];\n      const allowedNames = [\n        ...new Set(\n          requested.map((t) => String(t).trim()).filter(Boolean).filter((t) => !DELEGATE_BLOCKED_TOOLS.has(t)),\n        ),\n      ];\n\n      if (allowedNames.length === 0) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: 'No allowed tools remain after applying the delegation blocklist. Expand `toolset` with safe tools.',\n            },\n          ],\n          details: { summary: '', iterations: 0 },\n        };\n      }\n\n      let model: ReturnType<DelegateToolDeps['getSubagentModel']>;\n      try {\n        model = deps.getSubagentModel();\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `delegate_task: ${msg}` }],\n          details: { summary: '', iterations: 0 },\n        };\n      }\n\n      const childOptions: DelegateChildHandleOptions = {\n        workspace: deps.workspace,\n        goal: p.goal,\n        context: p.context,\n        allowedToolNames: allowedNames,\n        maxIterations,\n        model,\n        bus: deps.bus,\n        getConfig: deps.getConfig,\n        toolExecutorConfig: deps.toolExecutorConfig,\n        buildChildTools: deps.buildChildTools,\n      };\n\n      // Sub-agent lifecycle hook (parity surface for channel thread bindings).\n      const ctx = deps.getCurrentContext?.() ?? null;\n      const parentSessionKey = ctx?.sessionKey;\n      let childSessionKey: string | undefined;\n      try {\n        if (deps.hookRunner && parentSessionKey) {\n          const { parseSessionKey, buildSessionKey } = await import('../../routing/session-key.js');\n          const parsed = parseSessionKey(parentSessionKey);\n          if (parsed) {\n            childSessionKey = buildSessionKey({\n              agentId: 'subagent',\n              source: parsed.agentId,\n              accountId: parsed.accountId,\n              peerKind: parsed.peerKind,\n              peerId: parsed.peerId,\n              threadId: parsed.threadId,\n              scopeId: parsed.scopeId,\n            });\n          }\n          if (childSessionKey) {\n            const hookResult = await (deps.hookRunner as any).runHooksWithResult(\n              'subagent_spawning',\n              {\n                childSessionKey,\n                requester: {\n                  channel: ctx?.channel,\n                  accountId: ctx?.accountId,\n                  to: (ctx as any)?.to,\n                  threadId: (ctx as any)?.threadId,\n                },\n                threadRequested: true,\n                agentId: 'subagent',\n                label: 'delegate_task',\n              },\n              { sessionKey: parentSessionKey, agentId: ctx?.channel },\n            );\n            const r = hookResult as any;\n            if (r && r.status === 'error') {\n              return {\n                content: [{ type: 'text', text: `delegate_task: ${String(r.error || 'subagent spawn blocked')}` }],\n                details: { summary: '', iterations: 0 },\n              };\n            }\n          }\n        }\n      } catch {\n        // Hooks are best-effort.\n      }\n\n      const child = createDelegateChildHandle(childOptions);\n\n      if (signal) {\n        signal.addEventListener('abort', () => child.abort(), { once: true });\n      }\n\n      try {\n        const { summary, toolIterations } = await child.run();\n        try {\n          if (deps.hookRunner && childSessionKey) {\n            await (deps.hookRunner as any).runHooks(\n              'subagent_ended',\n              { targetSessionKey: childSessionKey, accountId: ctx?.accountId },\n              { sessionKey: parentSessionKey },\n            );\n          }\n        } catch {\n          // best-effort\n        }\n        return {\n          content: [{ type: 'text', text: `Sub-agent completed:\\n\\n${summary}` }],\n          details: { summary, iterations: toolIterations },\n        };\n      } catch (error) {\n        child.abort();\n        try {\n          if (deps.hookRunner && childSessionKey) {\n            await (deps.hookRunner as any).runHooks(\n              'subagent_ended',\n              { targetSessionKey: childSessionKey, accountId: ctx?.accountId },\n              { sessionKey: parentSessionKey },\n            );\n          }\n        } catch {\n          // best-effort\n        }\n        const message = error instanceof Error ? error.message : String(error);\n        return {\n          content: [{ type: 'text', text: `Sub-agent failed: ${message}` }],\n          details: { summary: '', iterations: 0 },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/dreaming-tool.js

@@ -3,8 +3,8 @@ import { init_logger } from "../../utils/logger.js";
 import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "../memory/dreaming/constants.js";
 import { loadDreamingStore, saveDreamingStore } from "../memory/dreaming/short-term-store.js";
 import { resolveDreamingConfig } from "../memory/dreaming/config.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/dreaming-tool.ts
 init_logger();

package/dist/src/agent/tools/executor.d.ts

@@ -1,34 +1,53 @@
 /**
- * Tool Executor - Unified tool execution with timeout and retry
+ * Tool Executor - Unified tool execution wrapper.
  *
- * Wraps tool execution with:
- * - Timeout protection (prevents hanging)
- * - Retry mechanism (for transient failures)
- * - Error tracking (for reliability)
+ * Adds:
+ * - Timeout protection (tools that hang would otherwise stall the turn).
+ * - Optional retry for tools explicitly marked `idempotent`.
+ *
+ * Pi-agent contract (from `AgentTool.execute` docstring): "Throw on failure
+ * instead of encoding errors in `content`." Pi-agent turns thrown errors into
+ * `tool_execution_end` events with `isError=true`, which feeds the loop guard,
+ * error tracker, and error-pattern matcher. This wrapper therefore re-throws
+ * instead of synthesising fake-success results.
  */
-import type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';
+import type { AgentTool, AgentToolResult, AgentToolUpdateCallback } from '@earendil-works/pi-agent-core';
 export interface ToolExecutorConfig {
+    /** Default per-tool timeout when the tool does not declare its own `timeoutMs`. */
     defaultTimeoutMs: number;
-    shellTimeoutMs: number;
-    readTimeoutMs: number;
-    writeTimeoutMs: number;
-    networkTimeoutMs: number;
+    /** Max retry attempts for tools opted into retry via `idempotent: true`. */
     maxRetries: number;
+    /** Initial backoff between retries (passed straight to `withRetry`). */
     retryDelayMs: number;
+    /** Master switches; default both on so the wrapper is still effective. */
     enableTimeout: boolean;
     enableRetry: boolean;
 }
 declare const DEFAULT_CONFIG: ToolExecutorConfig;
 /**
- * Execute tool with timeout and retry protection
+ * Optional xopc-side hints that any tool may attach. They are not part of the
+ * pi-agent `AgentTool` contract; the wrapper reads them via structural typing.
+ *
+ * - `timeoutMs`: per-tool override of the default execution timeout.
+ * - `idempotent`: marks a tool as safe to retry. The wrapper retries only
+ *   tools that opt in — write/edit-like tools must leave this `false`.
+ */
+export interface XopcToolHints {
+    timeoutMs?: number;
+    idempotent?: boolean;
+}
+/**
+ * Execute tool with timeout (always) and retry (only for idempotent tools).
+ * Re-throws on failure so pi-agent records `isError=true`.
  */
-export declare function executeToolWithProtection(tool: AgentTool<any, any>, toolCallId: string, params: any, config?: Partial<ToolExecutorConfig>): Promise<AgentToolResult<any>>;
+export declare function executeToolWithProtection<TDetails>(tool: AgentTool<any, TDetails>, toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<TDetails>, config?: Partial<ToolExecutorConfig>): Promise<AgentToolResult<TDetails>>;
 /**
- * Create wrapped tool with protection
+ * Wrap a single tool with the protection pipeline. Preserves the original
+ * `execute` signature so streaming `signal` / `onUpdate` reach the tool.
  */
-export declare function wrapToolWithProtection(tool: AgentTool<any, any>, config?: Partial<ToolExecutorConfig>): AgentTool<any, any>;
+export declare function wrapToolWithProtection<TDetails>(tool: AgentTool<any, TDetails>, config?: Partial<ToolExecutorConfig>): AgentTool<any, TDetails>;
 /**
- * Wrap all tools with protection
+ * Wrap a batch of tools with protection.
  */
 export declare function wrapToolsWithProtection(tools: AgentTool<any, any>[], config?: Partial<ToolExecutorConfig>): AgentTool<any, any>[];
 export { DEFAULT_CONFIG as DEFAULT_TOOL_EXECUTOR_CONFIG };

package/dist/src/agent/tools/executor.js

@@ -7,79 +7,64 @@ init_logger();
 const log = createLogger("ToolExecutor");
 const DEFAULT_CONFIG = {
 	defaultTimeoutMs: 300 * 1e3,
-	shellTimeoutMs: 300 * 1e3,
-	readTimeoutMs: 30 * 1e3,
-	writeTimeoutMs: 60 * 1e3,
-	networkTimeoutMs: 60 * 1e3,
 	maxRetries: 2,
 	retryDelayMs: 1e3,
 	enableTimeout: true,
 	enableRetry: true
 };
-/**
-* Get timeout for specific tool type
-*/
-function getTimeoutForTool(toolName, config) {
-	const name = toolName.toLowerCase();
-	if (name.includes("shell") || name.includes("exec") || name.includes("bash")) return config.shellTimeoutMs;
-	if (name.includes("read") || name.includes("view") || name.includes("cat")) return config.readTimeoutMs;
-	if (name.includes("write") || name.includes("edit") || name.includes("create")) return config.writeTimeoutMs;
-	if (name.includes("web") || name.includes("http") || name.includes("fetch") || name.includes("search")) return config.networkTimeoutMs;
-	return config.defaultTimeoutMs;
+function readToolHints(tool) {
+	const t = tool;
+	return {
+		timeoutMs: typeof t.timeoutMs === "number" && t.timeoutMs > 0 ? t.timeoutMs : void 0,
+		idempotent: t.idempotent === true
+	};
+}
+function resolveTimeoutMs(tool, config) {
+	return readToolHints(tool).timeoutMs ?? config.defaultTimeoutMs;
 }
 /**
-* Execute tool with timeout and retry protection
+* Execute tool with timeout (always) and retry (only for idempotent tools).
+* Re-throws on failure so pi-agent records `isError=true`.
 */
-async function executeToolWithProtection(tool, toolCallId, params, config = {}) {
+async function executeToolWithProtection(tool, toolCallId, params, signal, onUpdate, config = {}) {
 	const fullConfig = {
 		...DEFAULT_CONFIG,
 		...config
 	};
 	const toolName = tool.name;
-	const execute = async () => {
-		try {
-			return await tool.execute(toolCallId, params);
-		} catch (error) {
-			if (error instanceof Error) throw error;
-			throw new Error(String(error));
-		}
-	};
-	let operation = execute;
+	const hints = readToolHints(tool);
+	const runOnce = () => tool.execute(toolCallId, params, signal, onUpdate);
+	let operation = runOnce;
 	if (fullConfig.enableTimeout) {
-		const timeoutMs = getTimeoutForTool(toolName, fullConfig);
-		const originalExecute = execute;
-		operation = async () => {
-			return executeWithTimeout(originalExecute, {
-				toolName,
-				timeoutMs,
-				description: `Executing ${toolName}`
-			});
-		};
+		const timeoutMs = resolveTimeoutMs(tool, fullConfig);
+		const inner = operation;
+		operation = () => executeWithTimeout(inner, {
+			toolName,
+			timeoutMs,
+			description: `Executing ${toolName}`
+		});
 	}
-	if (fullConfig.enableRetry && fullConfig.maxRetries > 0) {
-		const originalOperation = operation;
-		operation = async () => {
-			return withRetry(originalOperation, {
-				attempts: fullConfig.maxRetries + 1,
-				minDelayMs: fullConfig.retryDelayMs,
-				onRetry: (info) => {
-					log.warn({
-						tool: toolName,
-						attempt: info.attempt,
-						delayMs: info.delayMs,
-						error: info.error
-					}, "Tool execution failed, retrying");
-				}
-			});
-		};
+	if (fullConfig.enableRetry && fullConfig.maxRetries > 0 && hints.idempotent) {
+		const inner = operation;
+		operation = () => withRetry(inner, {
+			attempts: fullConfig.maxRetries + 1,
+			minDelayMs: fullConfig.retryDelayMs,
+			onRetry: (info) => {
+				log.warn({
+					tool: toolName,
+					attempt: info.attempt,
+					delayMs: info.delayMs,
+					error: info.error
+				}, "Tool execution failed, retrying (idempotent)");
+			}
+		});
 	}
 	const startTime = Date.now();
 	try {
 		const result = await operation();
-		const durationMs = Date.now() - startTime;
 		log.debug({
 			tool: toolName,
-			durationMs,
+			durationMs: Date.now() - startTime,
 			success: true
 		}, "Tool execution completed");
 		return result;
@@ -91,17 +76,7 @@ async function executeToolWithProtection(tool, toolCallId, params, config = {})
 				timeoutMs: error.timeoutMs,
 				durationMs
 			}, "Tool execution timed out");
-			return {
-				content: [{
-					type: "text",
-					text: error.getUserMessage()
-				}],
-				details: {
-					exitCode: null,
-					timedOut: true,
-					truncated: false
-				}
-			};
+			throw new Error(`Tool '${toolName}' timed out after ${error.timeoutMs}ms`, { cause: error });
 		}
 		const errorMessage = error instanceof Error ? error.message : String(error);
 		log.error({
@@ -109,33 +84,23 @@ async function executeToolWithProtection(tool, toolCallId, params, config = {})
 			error: errorMessage,
 			durationMs
 		}, "Tool execution failed");
-		return {
-			content: [{
-				type: "text",
-				text: `❌ Tool '${toolName}' failed: ${errorMessage}`
-			}],
-			details: {
-				exitCode: null,
-				timedOut: false,
-				truncated: false,
-				error: errorMessage
-			}
-		};
+		throw error instanceof Error ? error : new Error(errorMessage);
 	}
 }
 /**
-* Create wrapped tool with protection
+* Wrap a single tool with the protection pipeline. Preserves the original
+* `execute` signature so streaming `signal` / `onUpdate` reach the tool.
 */
 function wrapToolWithProtection(tool, config) {
 	return {
 		...tool,
-		async execute(toolCallId, params) {
-			return executeToolWithProtection(tool, toolCallId, params, config);
+		async execute(toolCallId, params, signal, onUpdate) {
+			return executeToolWithProtection(tool, toolCallId, params, signal, onUpdate, config);
 		}
 	};
 }
 /**
-* Wrap all tools with protection
+* Wrap a batch of tools with protection.
 */
 function wrapToolsWithProtection(tools, config) {
 	return tools.map((tool) => wrapToolWithProtection(tool, config));

package/dist/src/agent/tools/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","names":[],"sources":["../../../../src/agent/tools/executor.ts"],"sourcesContent":["/**\n * Tool Executor - Unified tool execution with timeout and retry\n *\n * Wraps tool execution with:\n * - Timeout protection (prevents hanging)\n * - Retry mechanism (for transient failures)\n * - Error tracking (for reliability)\n */\n\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { createLogger } from '../../utils/logger.js';\nimport { executeWithTimeout, TimeoutError } from '../lifecycle/timeout-wrapper.js';\nimport { withRetry } from '../../infra/retry.js';\n\nconst log = createLogger('ToolExecutor');\n\nexport interface ToolExecutorConfig {\n  // Timeout configuration\n  defaultTimeoutMs: number;\n  shellTimeoutMs: number;\n  readTimeoutMs: number;\n  writeTimeoutMs: number;\n  networkTimeoutMs: number;\n  \n  // Retry configuration\n  maxRetries: number;\n  retryDelayMs: number;\n  \n  // Enable/disable features\n  enableTimeout: boolean;\n  enableRetry: boolean;\n}\n\nconst DEFAULT_CONFIG: ToolExecutorConfig = {\n  defaultTimeoutMs: 5 * 60 * 1000,  // 5 minutes\n  shellTimeoutMs: 5 * 60 * 1000,    // 5 minutes\n  readTimeoutMs: 30 * 1000,         // 30 seconds\n  writeTimeoutMs: 60 * 1000,        // 1 minute\n  networkTimeoutMs: 60 * 1000,      // 1 minute\n  \n  maxRetries: 2,\n  retryDelayMs: 1000,\n  \n  enableTimeout: true,\n  enableRetry: true,\n};\n\n/**\n * Get timeout for specific tool type\n */\nfunction getTimeoutForTool(toolName: string, config: ToolExecutorConfig): number {\n  const name = toolName.toLowerCase();\n  \n  if (name.includes('shell') || name.includes('exec') || name.includes('bash')) {\n    return config.shellTimeoutMs;\n  }\n  if (name.includes('read') || name.includes('view') || name.includes('cat')) {\n    return config.readTimeoutMs;\n  }\n  if (name.includes('write') || name.includes('edit') || name.includes('create')) {\n    return config.writeTimeoutMs;\n  }\n  if (name.includes('web') || name.includes('http') || name.includes('fetch') || name.includes('search')) {\n    return config.networkTimeoutMs;\n  }\n  \n  return config.defaultTimeoutMs;\n}\n\n/**\n * Execute tool with timeout and retry protection\n */\nexport async function executeToolWithProtection(\n  tool: AgentTool<any, any>,\n  toolCallId: string,\n  params: any,\n  config: Partial<ToolExecutorConfig> = {}\n): Promise<AgentToolResult<any>> {\n  const fullConfig = { ...DEFAULT_CONFIG, ...config };\n  const toolName = tool.name;\n  \n  // Build execution function\n  const execute = async (): Promise<AgentToolResult<any>> => {\n    try {\n      const result = await (tool as any).execute(toolCallId, params);\n      return result;\n    } catch (error) {\n      // Wrap non-error throws\n      if (error instanceof Error) {\n        throw error;\n      }\n      throw new Error(String(error));\n    }\n  };\n  \n  // Apply timeout if enabled\n  let operation = execute;\n  if (fullConfig.enableTimeout) {\n    const timeoutMs = getTimeoutForTool(toolName, fullConfig);\n    const originalExecute = execute;\n    \n    operation = async () => {\n      return executeWithTimeout(\n        originalExecute,\n        {\n          toolName,\n          timeoutMs,\n          description: `Executing ${toolName}`,\n        }\n      );\n    };\n  }\n  \n  // Apply retry if enabled\n  if (fullConfig.enableRetry && fullConfig.maxRetries > 0) {\n    const originalOperation = operation;\n    \n    operation = async () => {\n      return withRetry(\n        originalOperation,\n        {\n          attempts: fullConfig.maxRetries + 1,\n          minDelayMs: fullConfig.retryDelayMs,\n          onRetry: (info) => {\n            log.warn(\n              { tool: toolName, attempt: info.attempt, delayMs: info.delayMs, error: info.error },\n              'Tool execution failed, retrying'\n            );\n          },\n        }\n      );\n    };\n  }\n  \n  // Execute with error handling\n  const startTime = Date.now();\n  try {\n    const result = await operation();\n    const durationMs = Date.now() - startTime;\n    \n    log.debug(\n      { tool: toolName, durationMs, success: true },\n      'Tool execution completed'\n    );\n    \n    return result;\n  } catch (error) {\n    const durationMs = Date.now() - startTime;\n    \n    // Handle timeout error\n    if (error instanceof TimeoutError) {\n      log.error(\n        { tool: toolName, timeoutMs: error.timeoutMs, durationMs },\n        'Tool execution timed out'\n      );\n      \n      return {\n        content: [\n          {\n            type: 'text',\n            text: error.getUserMessage(),\n          },\n        ],\n        details: {\n          exitCode: null,\n          timedOut: true,\n          truncated: false,\n        },\n      };\n    }\n    \n    // Handle other errors\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    log.error(\n      { tool: toolName, error: errorMessage, durationMs },\n      'Tool execution failed'\n    );\n    \n    return {\n      content: [\n        {\n          type: 'text',\n          text: `❌ Tool '${toolName}' failed: ${errorMessage}`,\n        },\n      ],\n      details: {\n        exitCode: null,\n        timedOut: false,\n        truncated: false,\n        error: errorMessage,\n      },\n    };\n  }\n}\n\n/**\n * Create wrapped tool with protection\n */\nexport function wrapToolWithProtection(\n  tool: AgentTool<any, any>,\n  config?: Partial<ToolExecutorConfig>\n): AgentTool<any, any> {\n  return ({\n    ...tool,\n    async execute(toolCallId: string, params: any): Promise<AgentToolResult<any>> {\n      return executeToolWithProtection(tool, toolCallId, params, config);\n    },\n  } as any) as AgentTool<any, any>;\n}\n\n/**\n * Wrap all tools with protection\n */\nexport function wrapToolsWithProtection(\n  tools: AgentTool<any, any>[],\n  config?: Partial<ToolExecutorConfig>\n): AgentTool<any, any>[] {\n  return tools.map(tool => wrapToolWithProtection(tool, config));\n}\n\n// Export configuration\nexport { DEFAULT_CONFIG as DEFAULT_TOOL_EXECUTOR_CONFIG };\n"],"mappings":"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"}
+{"version":3,"file":"executor.js","names":[],"sources":["../../../../src/agent/tools/executor.ts"],"sourcesContent":["/**\n * Tool Executor - Unified tool execution wrapper.\n *\n * Adds:\n * - Timeout protection (tools that hang would otherwise stall the turn).\n * - Optional retry for tools explicitly marked `idempotent`.\n *\n * Pi-agent contract (from `AgentTool.execute` docstring): \"Throw on failure\n * instead of encoding errors in `content`.\" Pi-agent turns thrown errors into\n * `tool_execution_end` events with `isError=true`, which feeds the loop guard,\n * error tracker, and error-pattern matcher. This wrapper therefore re-throws\n * instead of synthesising fake-success results.\n */\n\nimport type {\n  AgentTool,\n  AgentToolResult,\n  AgentToolUpdateCallback,\n} from '@earendil-works/pi-agent-core';\nimport { createLogger } from '../../utils/logger.js';\nimport { executeWithTimeout, TimeoutError } from '../lifecycle/timeout-wrapper.js';\nimport { withRetry } from '../../infra/retry.js';\n\nconst log = createLogger('ToolExecutor');\n\nexport interface ToolExecutorConfig {\n  /** Default per-tool timeout when the tool does not declare its own `timeoutMs`. */\n  defaultTimeoutMs: number;\n\n  /** Max retry attempts for tools opted into retry via `idempotent: true`. */\n  maxRetries: number;\n  /** Initial backoff between retries (passed straight to `withRetry`). */\n  retryDelayMs: number;\n\n  /** Master switches; default both on so the wrapper is still effective. */\n  enableTimeout: boolean;\n  enableRetry: boolean;\n}\n\nconst DEFAULT_CONFIG: ToolExecutorConfig = {\n  defaultTimeoutMs: 5 * 60 * 1000, // 5 minutes\n  maxRetries: 2,\n  retryDelayMs: 1000,\n  enableTimeout: true,\n  enableRetry: true,\n};\n\n/**\n * Optional xopc-side hints that any tool may attach. They are not part of the\n * pi-agent `AgentTool` contract; the wrapper reads them via structural typing.\n *\n * - `timeoutMs`: per-tool override of the default execution timeout.\n * - `idempotent`: marks a tool as safe to retry. The wrapper retries only\n *   tools that opt in — write/edit-like tools must leave this `false`.\n */\nexport interface XopcToolHints {\n  timeoutMs?: number;\n  idempotent?: boolean;\n}\n\nfunction readToolHints(tool: AgentTool<any, any>): XopcToolHints {\n  const t = tool as AgentTool<any, any> & XopcToolHints;\n  return {\n    timeoutMs: typeof t.timeoutMs === 'number' && t.timeoutMs > 0 ? t.timeoutMs : undefined,\n    idempotent: t.idempotent === true,\n  };\n}\n\nfunction resolveTimeoutMs(tool: AgentTool<any, any>, config: ToolExecutorConfig): number {\n  const hints = readToolHints(tool);\n  return hints.timeoutMs ?? config.defaultTimeoutMs;\n}\n\n/**\n * Execute tool with timeout (always) and retry (only for idempotent tools).\n * Re-throws on failure so pi-agent records `isError=true`.\n */\nexport async function executeToolWithProtection<TDetails>(\n  tool: AgentTool<any, TDetails>,\n  toolCallId: string,\n  params: any,\n  signal?: AbortSignal,\n  onUpdate?: AgentToolUpdateCallback<TDetails>,\n  config: Partial<ToolExecutorConfig> = {},\n): Promise<AgentToolResult<TDetails>> {\n  const fullConfig = { ...DEFAULT_CONFIG, ...config };\n  const toolName = tool.name;\n  const hints = readToolHints(tool);\n\n  const runOnce = (): Promise<AgentToolResult<TDetails>> =>\n    tool.execute(toolCallId, params, signal, onUpdate);\n\n  let operation: () => Promise<AgentToolResult<TDetails>> = runOnce;\n\n  if (fullConfig.enableTimeout) {\n    const timeoutMs = resolveTimeoutMs(tool, fullConfig);\n    const inner = operation;\n    operation = () =>\n      executeWithTimeout(inner, {\n        toolName,\n        timeoutMs,\n        description: `Executing ${toolName}`,\n      });\n  }\n\n  const shouldRetry = fullConfig.enableRetry && fullConfig.maxRetries > 0 && hints.idempotent;\n  if (shouldRetry) {\n    const inner = operation;\n    operation = () =>\n      withRetry(inner, {\n        attempts: fullConfig.maxRetries + 1,\n        minDelayMs: fullConfig.retryDelayMs,\n        onRetry: (info) => {\n          log.warn(\n            { tool: toolName, attempt: info.attempt, delayMs: info.delayMs, error: info.error },\n            'Tool execution failed, retrying (idempotent)',\n          );\n        },\n      });\n  }\n\n  const startTime = Date.now();\n  try {\n    const result = await operation();\n    log.debug(\n      { tool: toolName, durationMs: Date.now() - startTime, success: true },\n      'Tool execution completed',\n    );\n    return result;\n  } catch (error) {\n    const durationMs = Date.now() - startTime;\n\n    if (error instanceof TimeoutError) {\n      log.error(\n        { tool: toolName, timeoutMs: error.timeoutMs, durationMs },\n        'Tool execution timed out',\n      );\n      throw new Error(`Tool '${toolName}' timed out after ${error.timeoutMs}ms`, { cause: error });\n    }\n\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    log.error(\n      { tool: toolName, error: errorMessage, durationMs },\n      'Tool execution failed',\n    );\n    throw error instanceof Error ? error : new Error(errorMessage);\n  }\n}\n\n/**\n * Wrap a single tool with the protection pipeline. Preserves the original\n * `execute` signature so streaming `signal` / `onUpdate` reach the tool.\n */\nexport function wrapToolWithProtection<TDetails>(\n  tool: AgentTool<any, TDetails>,\n  config?: Partial<ToolExecutorConfig>,\n): AgentTool<any, TDetails> {\n  return {\n    ...tool,\n    async execute(\n      toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n      onUpdate?: AgentToolUpdateCallback<TDetails>,\n    ): Promise<AgentToolResult<TDetails>> {\n      return executeToolWithProtection(tool, toolCallId, params, signal, onUpdate, config);\n    },\n  } as AgentTool<any, TDetails>;\n}\n\n/**\n * Wrap a batch of tools with protection.\n */\nexport function wrapToolsWithProtection(\n  tools: AgentTool<any, any>[],\n  config?: Partial<ToolExecutorConfig>,\n): AgentTool<any, any>[] {\n  return tools.map((tool) => wrapToolWithProtection(tool, config));\n}\n\n// Export configuration\nexport { DEFAULT_CONFIG as DEFAULT_TOOL_EXECUTOR_CONFIG };\n"],"mappings":";;;;;aAmBqD;AAIrD,MAAM,MAAM,aAAa,eAAe;AAgBxC,MAAM,iBAAqC;CACzC,kBAAkB,MAAS;CAC3B,YAAY;CACZ,cAAc;CACd,eAAe;CACf,aAAa;CACd;AAeD,SAAS,cAAc,MAA0C;CAC/D,MAAM,IAAI;AACV,QAAO;EACL,WAAW,OAAO,EAAE,cAAc,YAAY,EAAE,YAAY,IAAI,EAAE,YAAY,KAAA;EAC9E,YAAY,EAAE,eAAe;EAC9B;;AAGH,SAAS,iBAAiB,MAA2B,QAAoC;AAEvF,QADc,cAAc,KAChB,CAAC,aAAa,OAAO;;;;;;AAOnC,eAAsB,0BACpB,MACA,YACA,QACA,QACA,UACA,SAAsC,EAAE,EACJ;CACpC,MAAM,aAAa;EAAE,GAAG;EAAgB,GAAG;EAAQ;CACnD,MAAM,WAAW,KAAK;CACtB,MAAM,QAAQ,cAAc,KAAK;CAEjC,MAAM,gBACJ,KAAK,QAAQ,YAAY,QAAQ,QAAQ,SAAS;CAEpD,IAAI,YAAsD;AAE1D,KAAI,WAAW,eAAe;EAC5B,MAAM,YAAY,iBAAiB,MAAM,WAAW;EACpD,MAAM,QAAQ;AACd,oBACE,mBAAmB,OAAO;GACxB;GACA;GACA,aAAa,aAAa;GAC3B,CAAC;;AAIN,KADoB,WAAW,eAAe,WAAW,aAAa,KAAK,MAAM,YAChE;EACf,MAAM,QAAQ;AACd,oBACE,UAAU,OAAO;GACf,UAAU,WAAW,aAAa;GAClC,YAAY,WAAW;GACvB,UAAU,SAAS;AACjB,QAAI,KACF;KAAE,MAAM;KAAU,SAAS,KAAK;KAAS,SAAS,KAAK;KAAS,OAAO,KAAK;KAAO,EACnF,+CACD;;GAEJ,CAAC;;CAGN,MAAM,YAAY,KAAK,KAAK;AAC5B,KAAI;EACF,MAAM,SAAS,MAAM,WAAW;AAChC,MAAI,MACF;GAAE,MAAM;GAAU,YAAY,KAAK,KAAK,GAAG;GAAW,SAAS;GAAM,EACrE,2BACD;AACD,SAAO;UACA,OAAO;EACd,MAAM,aAAa,KAAK,KAAK,GAAG;AAEhC,MAAI,iBAAiB,cAAc;AACjC,OAAI,MACF;IAAE,MAAM;IAAU,WAAW,MAAM;IAAW;IAAY,EAC1D,2BACD;AACD,SAAM,IAAI,MAAM,SAAS,SAAS,oBAAoB,MAAM,UAAU,KAAK,EAAE,OAAO,OAAO,CAAC;;EAG9F,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3E,MAAI,MACF;GAAE,MAAM;GAAU,OAAO;GAAc;GAAY,EACnD,wBACD;AACD,QAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,aAAa;;;;;;;AAQlE,SAAgB,uBACd,MACA,QAC0B;AAC1B,QAAO;EACL,GAAG;EACH,MAAM,QACJ,YACA,QACA,QACA,UACoC;AACpC,UAAO,0BAA0B,MAAM,YAAY,QAAQ,QAAQ,UAAU,OAAO;;EAEvF;;;;;AAMH,SAAgB,wBACd,OACA,QACuB;AACvB,QAAO,MAAM,KAAK,SAAS,uBAAuB,MAAM,OAAO,CAAC"}

package/dist/src/agent/tools/factory.d.ts

@@ -75,7 +75,13 @@ export declare class AgentToolsFactory {
     private browserManager;
     /** One dialog/console supervisor per chat session (browser tab). */
     private readonly browserTaskSupervisors;
+    /** Cached readiness probe — keyed by backend mode + extension host:port. */
+    private browserReadinessCache;
     constructor(deps: ToolFactoryDeps);
+    private browserReadinessKey;
+    private checkBrowserReadinessCached;
+    /** Invalidate the readiness cache (config hot-reload, settings-page save, etc.). */
+    invalidateBrowserReadinessCache(): void;
     private browserSupervisorForTask;
     private acquireBrowserPage;
     private ensureBrowserManager;

package/dist/src/agent/tools/factory.js

@@ -1,7 +1,6 @@
-import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createEditFileTool } from "./edit.js";
@@ -23,6 +22,7 @@ import { createClarifyTool } from "./clarify-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { BrowserManager } from "../../browser/manager.js";
 import { resolveBrowserBackendFromConfig } from "../../browser/backend-from-config.js";
+import { checkBrowserReadiness } from "../../browser/readiness.js";
 import { CdpSupervisor } from "../../browser/cdp-supervisor.js";
 import "../../browser/index.js";
 import { createDelegateTool } from "./delegate-tool.js";
@@ -35,6 +35,7 @@ import "./index.js";
 import { shouldRegisterCuratedMemoryTool } from "../memory/memory-config.js";
 import { createBrowserUseTool } from "./browser/tool/browser-use-tool.js";
 import { wrapToolsWithProtection } from "./executor.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { createTextToSpeechTool } from "./tts-tool.js";
 //#region src/agent/tools/factory.ts
 init_session_key();
@@ -52,13 +53,55 @@ function clarifyTransportSource(sessionKey) {
 	const first = sessionKey.split(":").filter(Boolean)[0] ?? "";
 	if (first === "cli" || first === "webchat") return first;
 }
-var AgentToolsFactory = class {
+var AgentToolsFactory = class AgentToolsFactory {
 	browserManager = null;
 	/** One dialog/console supervisor per chat session (browser tab). */
 	browserTaskSupervisors = /* @__PURE__ */ new Map();
+	/** Cached readiness probe — keyed by backend mode + extension host:port. */
+	browserReadinessCache = null;
 	constructor(deps) {
 		this.deps = deps;
 	}
+	browserReadinessKey() {
+		const cfg = this.deps.getConfig?.();
+		const backend = resolveBrowserBackendFromConfig(cfg);
+		const ext = cfg?.agents?.defaults?.browser?.extension;
+		const host = typeof ext?.host === "string" && ext.host.trim() ? ext.host.trim() : "127.0.0.1";
+		const port = typeof ext?.port === "number" ? ext.port : 19820;
+		const cdpUrl = backend.mode === "cdp" ? backend.config.wsEndpoint : "";
+		const cloudKind = backend.mode === "cloud" ? backend.config.type : "";
+		return `${backend.mode}@${host}:${port}|${cdpUrl}|${cloudKind}`;
+	}
+	async checkBrowserReadinessCached() {
+		const key = this.browserReadinessKey();
+		const now = Date.now();
+		const cached = this.browserReadinessCache;
+		if (cached && cached.key === key && cached.expiresAt > now && cached.inflight === void 0) return cached.result ?? null;
+		if (cached && cached.key === key && cached.inflight) return cached.inflight;
+		const inflight = checkBrowserReadiness(this.deps.getConfig?.());
+		this.browserReadinessCache = {
+			key,
+			expiresAt: now + 3e4,
+			inflight
+		};
+		try {
+			const result = await inflight;
+			this.browserReadinessCache = {
+				key,
+				expiresAt: Date.now() + 3e4,
+				result
+			};
+			return result;
+		} catch (e) {
+			this.browserReadinessCache = null;
+			log.warn({ err: e }, "browserReadiness probe failed");
+			return null;
+		}
+	}
+	/** Invalidate the readiness cache (config hot-reload, settings-page save, etc.). */
+	invalidateBrowserReadinessCache() {
+		this.browserReadinessCache = null;
+	}
 	browserSupervisorForTask(taskId) {
 		let s = this.browserTaskSupervisors.get(taskId);
 		if (!s) {
@@ -89,6 +132,7 @@ var AgentToolsFactory = class {
 	}
 	/** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */
 	async shutdownBrowser() {
+		this.browserReadinessCache = null;
 		if (!this.browserManager) return;
 		await this.browserManager.shutdown();
 		this.browserManager = null;
@@ -197,6 +241,7 @@ var AgentToolsFactory = class {
 				getPageForTask: () => this.acquireBrowserPage(),
 				getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? "default",
 				getConfig: () => this.deps.getConfig?.(),
+				getReadiness: () => this.checkBrowserReadinessCached(),
 				getSupervisor: () => this.browserSupervisorForTask(this.deps.getCurrentContext()?.sessionKey ?? "default"),
 				notifyBrowserPageClosed: (taskId) => {
 					this.browserTaskSupervisors.delete(taskId);
@@ -213,7 +258,21 @@ var AgentToolsFactory = class {
 				getConfig: () => this.deps.getConfig?.(),
 				getCurrentContext: () => this.deps.getCurrentContext?.() ?? null,
 				hookRunner: this.deps.hookRunner,
-				toolExecutorConfig: this.deps.toolExecutorConfig
+				toolExecutorConfig: this.deps.toolExecutorConfig,
+				buildChildTools: (childOpts) => {
+					return new AgentToolsFactory({
+						workspace: childOpts.workspace,
+						bus: childOpts.bus,
+						getCurrentContext: () => null,
+						getConfig: childOpts.getConfig,
+						getPrimaryModel: () => childOpts.model,
+						toolExecutorConfig: childOpts.toolExecutorConfig
+					}).createAllTools({
+						workspace: childOpts.workspace,
+						getPrimaryModel: () => childOpts.model,
+						disabledTools: new Set(["extensions"])
+					});
+				}
 			})] : [],
 			...optionalTools
 		], disabled);

package/dist/src/agent/tools/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","names":["parseRoutingSessionKey"],"sources":["../../../../src/agent/tools/factory.ts"],"sourcesContent":["/**\n * Agent Tools Factory - Creates and configures agent tools\n *\n * Centralizes tool creation logic to keep service.ts focused on orchestration.\n *\n * TTS: auto TTS is applied at the ChannelManager via maybeApplyTtsToPayload().\n * Optional \\`text_to_speech\\` tool sends explicit voice when TTS is enabled.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport type { Page } from 'playwright-core';\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport {\n  createReadFileTool,\n  createWriteFileTool,\n  createEditFileTool,\n  createListDirTool,\n  createGrepTool,\n  createFindTool,\n  createShellTool,\n  createWebSearchTool,\n  createWebFetchTool,\n  createWebExtractTool,\n  createMessageTool,\n  createSendMediaTool,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createSessionStatusTool,\n  createDreamingTool,\n  createClarifyTool,\n} from './index.js';\nimport { createCuratedMemoryTool } from './curated-memory-tool.js';\nimport { createSessionSearchTool } from './session-search-tool.js';\nimport type { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { shouldRegisterCuratedMemoryTool } from '../memory/memory-config.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { parseSessionKey as parseRoutingSessionKey } from '../../routing/session-key.js';\nimport type { GatewayClarifyRequestFn } from './clarify-tool.js';\nimport { createImageTool } from './image-tool.js';\nimport { createImageGenerateTool } from './image-generate-tool.js';\nimport {\n  BrowserManager,\n  CdpSupervisor,\n  resolveBrowserBackendFromConfig,\n} from '../../browser/index.js';\nimport { createBrowserUseTool } from './browser/tool/browser-use-tool.js';\nimport { createDelegateTool } from './delegate-tool.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport { createCronjobTool } from './cronjob-tool.js';\nimport type { CronService } from '../../cron/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { wrapToolsWithProtection, type ToolExecutorConfig } from './executor.js';\nimport { createSkillsListTool, createSkillViewTool } from './skills-tools.js';\nimport { createSkillManageTool } from './skill-manage-tool.js';\nimport { createTextToSpeechTool } from './tts-tool.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\n\nconst log = createLogger('AgentToolsFactory');\n\n/** Channels where `clarify` can block for a user answer (web UI, Telegram, CLI readline). */\nconst CLARIFY_SUPPORTED_CHANNELS = new Set(['webchat', 'telegram', 'cli']);\n\nfunction clarifyTransportSource(sessionKey: string): string | undefined {\n  const parsed = parseRoutingSessionKey(sessionKey);\n  if (parsed) return parsed.source;\n  // Fallback for simple `<channel>:<chatId>` keys used by webchat and CLI.\n  const first = sessionKey.split(':').filter(Boolean)[0] ?? '';\n  if (first === 'cli' || first === 'webchat') return first;\n  return undefined;\n}\n\nexport interface ToolFactoryDeps {\n  workspace: string;\n  extensionRegistry?: any;\n  getCurrentContext: () => { channel: string; chatId: string; sessionKey: string } | null;\n  hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;\n  bus: MessageBus;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /** Agent defaults (image tools, etc.); use getter so hot-reloaded config applies. */\n  getConfig?: () => Config | undefined;\n  /** Session / default chat model for vision tool description. */\n  getPrimaryModel?: () => Model<Api>;\n  /** Built-in curated memory store (agent home `memories/`). */\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  /** Memory orchestration (prefetch/sync + external tools). */\n  getMemoryManager?: () => MemoryManager;\n  /** Session store for `session_search`. */\n  getSessionStore?: () => SessionStore;\n  /** When set (gateway webchat), enables the `clarify` tool. */\n  gatewayClarify?: { requestClarification: GatewayClarifyRequestFn };\n  /** Gateway: enables the `cronjob` tool. */\n  getCronService?: () => CronService | undefined;\n  /** Current session skill indexing (tool gating + allowlist); used by skills_list / skill_view. */\n  getSkillIndexingContext?: () =>\n    | { registeredToolNames: string[]; skillAllowlist?: string[] }\n    | undefined;\n  /** After skill_manage mutates disk, reload skills + refresh agent prompts (optional). */\n  onSkillsFilesystemMutate?: () => void;\n  /** Names registered via skill_view for shell env passthrough. */\n  getSkillPassthroughEnvVarNames?: () => string[];\n  /** Add declared env names for the current session (no values stored). */\n  registerSkillEnvPassthrough?: (names: string[]) => void;\n}\n\nexport interface CreateCoreToolsOptions {\n  /** Workspace root for file/shell tools (defaults to factory workspace). */\n  workspace?: string;\n  /** Canonical `agents/<id>/profile/`: bare SOUL.md / IDENTITY.md resolve here after the workspace. */\n  profileMarkdownRoot?: string;\n  /** Tool `name` values to omit (e.g. `shell`, `extensions` for extension tools). */\n  disabledTools?: Set<string>;\n  /** Optional primary model for image tool heuristics. */\n  getPrimaryModel?: () => Model<Api>;\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  getMemoryManager?: () => MemoryManager;\n  /** When set, registers `skills_list` and `skill_view` bound to this workspace\\'s skills. */\n  getSkillManager?: () => SkillManager;\n}\n\nexport class AgentToolsFactory {\n  private browserManager: BrowserManager | null = null;\n  /** One dialog/console supervisor per chat session (browser tab). */\n  private readonly browserTaskSupervisors = new Map<string, CdpSupervisor>();\n\n  constructor(private deps: ToolFactoryDeps) {}\n\n  private browserSupervisorForTask(taskId: string): CdpSupervisor {\n    let s = this.browserTaskSupervisors.get(taskId);\n    if (!s) {\n      const b = this.deps.getConfig?.()?.agents?.defaults?.browser;\n      const dialogPolicy =\n        b?.dialogPolicy === 'must_respond' || b?.dialogPolicy === 'auto_accept' || b?.dialogPolicy === 'auto_dismiss'\n          ? b.dialogPolicy\n          : 'auto_dismiss';\n      const dialogTimeoutSeconds =\n        typeof b?.dialogTimeoutSeconds === 'number' &&\n        Number.isFinite(b.dialogTimeoutSeconds) &&\n        b.dialogTimeoutSeconds >= 1\n          ? Math.floor(b.dialogTimeoutSeconds)\n          : 300;\n      s = new CdpSupervisor({ dialogPolicy, dialogTimeoutSeconds });\n      this.browserTaskSupervisors.set(taskId, s);\n    }\n    return s;\n  }\n\n  private async acquireBrowserPage(): Promise<Page> {\n    const taskId = this.deps.getCurrentContext()?.sessionKey ?? 'default';\n    const mgr = this.ensureBrowserManager();\n    await mgr.ensureConnected();\n    if (mgr.getExtensionProvider()) {\n      return null as unknown as Page;\n    }\n    const page = await mgr.getPage(taskId);\n    this.browserSupervisorForTask(taskId).attach(page);\n    return page;\n  }\n\n  private ensureBrowserManager(): BrowserManager {\n    if (!this.browserManager) {\n      this.browserManager = new BrowserManager({\n        getHeadless: () => this.deps.getConfig?.()?.agents?.defaults?.browser?.headless === true,\n        getBackend: () => resolveBrowserBackendFromConfig(this.deps.getConfig?.()),\n      });\n    }\n    return this.browserManager;\n  }\n\n  /** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */\n  async shutdownBrowser(): Promise<void> {\n    if (!this.browserManager) {\n      return;\n    }\n    await this.browserManager.shutdown();\n    this.browserManager = null;\n    this.browserTaskSupervisors.clear();\n  }\n\n  /** Drop the tab for a session when its agent instance is removed. */\n  async closeBrowserPageForSession(sessionKey: string): Promise<void> {\n    this.browserTaskSupervisors.delete(sessionKey);\n    await this.browserManager?.closePage(sessionKey);\n  }\n\n  createCoreTools(options?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const workspace = options?.workspace ?? this.deps.workspace;\n    const { bus } = this.deps;\n    const getPrimary = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n    const getBuiltin = options?.getBuiltinMemoryStore ?? this.deps.getBuiltinMemoryStore;\n    const builtinStore = getBuiltin?.();\n    const memoriesDir = builtinStore?.memoriesDir;\n    const getMemMgr = options?.getMemoryManager ?? this.deps.getMemoryManager;\n    const getSkillMgr = options?.getSkillManager;\n    const disabled = options?.disabledTools;\n\n    const primary = getPrimary?.();\n    const modelHasVision = primary?.input?.includes('image') ?? false;\n    const cfg = this.deps.getConfig?.();\n    const imageTool = createImageTool({\n      config: cfg,\n      workspace,\n      modelHasVision,\n    });\n    const imageGenerateTool = createImageGenerateTool({\n      config: cfg,\n      workspace,\n    });\n\n    const optionalTools = [imageTool, imageGenerateTool].filter((t) => t != null) as any[];\n\n    const readTool = createReadFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n    });\n    const writeTool = createWriteFileTool(workspace);\n    const editTool = createEditFileTool(workspace);\n    const listDir = createListDirTool(workspace);\n    const grep = createGrepTool(workspace);\n    const find = createFindTool(workspace);\n\n    const core: AgentTool<any, any>[] = [\n      createSessionStatusTool(),\n      createDreamingTool({\n        getWorkspace: () => workspace,\n        getConfig: () => this.deps.getConfig?.(),\n      }),\n      createClarifyTool({\n        resolveAskUser: () => {\n          const req = this.deps.gatewayClarify?.requestClarification;\n          if (!req) return null;\n          const ctx = this.deps.getCurrentContext();\n          if (!ctx?.sessionKey) return null;\n          const source = clarifyTransportSource(ctx.sessionKey);\n          if (!source || !CLARIFY_SUPPORTED_CHANNELS.has(source)) return null;\n          return (r) => req(ctx.sessionKey, r);\n        },\n      }),\n      createTodoTool({\n        getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      ...(getSkillMgr\n        ? [\n            createSkillsListTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n            }),\n            createSkillViewTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n              registerSkillEnvPassthrough: this.deps.registerSkillEnvPassthrough,\n            }),\n            createSkillManageTool({\n              getSkillManager: getSkillMgr,\n              getWorkspace: () => workspace,\n              onSkillsFilesystemMutate: this.deps.onSkillsFilesystemMutate,\n            }),\n          ]\n        : []),\n      readTool,\n      writeTool,\n      editTool,\n      listDir,\n      grep,\n      find,\n      createShellTool(workspace, {\n        getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,\n      }),\n      createWebSearchTool(() => this.deps.getConfig?.()),\n      createWebFetchTool(() => this.deps.getConfig?.()),\n      createWebExtractTool({ getConfig: () => this.deps.getConfig?.() }),\n      // Note: TTS is NOT handled by send_message tool anymore\n      // TTS is applied at the ChannelManager dispatch layer\n      createMessageTool(bus, () => this.deps.getCurrentContext()),\n      ...(mergeTtsConfigFromAppConfig(cfg?.messages?.tts).enabled\n        ? [\n            createTextToSpeechTool({\n              bus,\n              getContext: () => this.deps.getCurrentContext(),\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),\n      createMemorySearchTool({ workspaceDir: workspace, memoriesDir }),\n      createMemoryGetTool({ workspaceDir: workspace, memoriesDir }),\n      ...(getBuiltin && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.())\n        ? [\n            createCuratedMemoryTool(getBuiltin, {\n              onMemoryWrite: (action, target, content) => {\n                getMemMgr?.().onMemoryWrite(action, target, content);\n              },\n            }),\n          ]\n        : []),\n      ...(getMemMgr?.().getAdditionalTools() ?? []),\n      ...(this.deps.getSessionStore\n        ? [\n            createSessionSearchTool({\n              getSessionStore: this.deps.getSessionStore,\n              getConfig: this.deps.getConfig,\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n            }),\n          ]\n        : []),\n      ...(this.deps.getCronService\n        ? [\n            createCronjobTool({\n              getCronService: this.deps.getCronService,\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.browser?.enabled !== false\n        ? [\n            createBrowserUseTool({\n              getManager: () => this.ensureBrowserManager(),\n              getPageForTask: () => this.acquireBrowserPage(),\n              getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? 'default',\n              getConfig: () => this.deps.getConfig?.(),\n              getSupervisor: () =>\n                this.browserSupervisorForTask(this.deps.getCurrentContext()?.sessionKey ?? 'default'),\n              notifyBrowserPageClosed: (taskId) => {\n                this.browserTaskSupervisors.delete(taskId);\n              },\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.delegate?.enabled === true && primary\n        ? [\n            createDelegateTool({\n              workspace,\n              getSubagentModel: () => {\n                const gp = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n                const m = gp?.();\n                if (!m) {\n                  throw new Error('No primary model configured for delegate_task');\n                }\n                return m;\n              },\n              bus: this.deps.bus,\n              getConfig: () => this.deps.getConfig?.(),\n              getCurrentContext: () => this.deps.getCurrentContext?.() ?? null,\n              hookRunner: this.deps.hookRunner,\n              toolExecutorConfig: this.deps.toolExecutorConfig,\n            }),\n          ]\n        : []),\n      ...optionalTools,\n    ];\n\n    return filterToolsByDisabledSet(core, disabled);\n  }\n\n  createAllTools(coreOptions?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const coreTools = this.createCoreTools(coreOptions);\n    const disableExtensions = coreOptions?.disabledTools?.has('extensions');\n    const cfg = this.deps.getConfig?.();\n\n    let bundled: AgentTool<any, any>[];\n    if (!this.deps.extensionRegistry || disableExtensions) {\n      bundled = coreTools;\n    } else {\n      const extensionTools = this.deps.extensionRegistry.getAllTools();\n      log.info({ count: extensionTools.length }, 'Loaded extension tools');\n      bundled = [...coreTools, ...extensionTools];\n    }\n\n    const wrapped = wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);\n\n    const executeEnabled =\n      cfg?.agents?.defaults?.executeCode?.enabled === true &&\n      !coreOptions?.disabledTools?.has('execute_code');\n\n    if (executeEnabled) {\n      const sandboxMap = buildSandboxToolMap(wrapped);\n      const executeTool = createExecuteCodeTool({ getSandboxToolMap: () => sandboxMap });\n      const wrappedExecute = wrapToolsWithProtection([executeTool as any], this.deps.toolExecutorConfig);\n      return [...wrapped, ...wrappedExecute];\n    }\n\n    return wrapped;\n  }\n}\n\nfunction filterToolsByDisabledSet(\n  tools: any[],\n  disabled: Set<string> | undefined,\n): any[] {\n  if (!disabled || disabled.size === 0) {\n    return tools;\n  }\n  return tools.filter((t) => !disabled.has(t.name));\n}\n"],"mappings":"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"}
+{"version":3,"file":"factory.js","names":["parseRoutingSessionKey"],"sources":["../../../../src/agent/tools/factory.ts"],"sourcesContent":["/**\n * Agent Tools Factory - Creates and configures agent tools\n *\n * Centralizes tool creation logic to keep service.ts focused on orchestration.\n *\n * TTS: auto TTS is applied at the ChannelManager via maybeApplyTtsToPayload().\n * Optional \\`text_to_speech\\` tool sends explicit voice when TTS is enabled.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport type { Page } from 'playwright-core';\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport {\n  createReadFileTool,\n  createWriteFileTool,\n  createEditFileTool,\n  createListDirTool,\n  createGrepTool,\n  createFindTool,\n  createShellTool,\n  createWebSearchTool,\n  createWebFetchTool,\n  createWebExtractTool,\n  createMessageTool,\n  createSendMediaTool,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createSessionStatusTool,\n  createDreamingTool,\n  createClarifyTool,\n} from './index.js';\nimport { createCuratedMemoryTool } from './curated-memory-tool.js';\nimport { createSessionSearchTool } from './session-search-tool.js';\nimport type { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { shouldRegisterCuratedMemoryTool } from '../memory/memory-config.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { parseSessionKey as parseRoutingSessionKey } from '../../routing/session-key.js';\nimport type { GatewayClarifyRequestFn } from './clarify-tool.js';\nimport { createImageTool } from './image-tool.js';\nimport { createImageGenerateTool } from './image-generate-tool.js';\nimport {\n  BrowserManager,\n  BrowserNotReadyError,\n  CdpSupervisor,\n  checkBrowserReadiness,\n  resolveBrowserBackendFromConfig,\n} from '../../browser/index.js';\nimport { createBrowserUseTool } from './browser/tool/browser-use-tool.js';\nimport { createDelegateTool } from './delegate-tool.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport { createCronjobTool } from './cronjob-tool.js';\nimport type { CronService } from '../../cron/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { wrapToolsWithProtection, type ToolExecutorConfig } from './executor.js';\nimport { createSkillsListTool, createSkillViewTool } from './skills-tools.js';\nimport { createSkillManageTool } from './skill-manage-tool.js';\nimport { createTextToSpeechTool } from './tts-tool.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\n\nconst log = createLogger('AgentToolsFactory');\n\n/** Channels where `clarify` can block for a user answer (web UI, Telegram, CLI readline). */\nconst CLARIFY_SUPPORTED_CHANNELS = new Set(['webchat', 'telegram', 'cli']);\n\nfunction clarifyTransportSource(sessionKey: string): string | undefined {\n  const parsed = parseRoutingSessionKey(sessionKey);\n  if (parsed) return parsed.source;\n  // Fallback for simple `<channel>:<chatId>` keys used by webchat and CLI.\n  const first = sessionKey.split(':').filter(Boolean)[0] ?? '';\n  if (first === 'cli' || first === 'webchat') return first;\n  return undefined;\n}\n\nexport interface ToolFactoryDeps {\n  workspace: string;\n  extensionRegistry?: any;\n  getCurrentContext: () => { channel: string; chatId: string; sessionKey: string } | null;\n  hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;\n  bus: MessageBus;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /** Agent defaults (image tools, etc.); use getter so hot-reloaded config applies. */\n  getConfig?: () => Config | undefined;\n  /** Session / default chat model for vision tool description. */\n  getPrimaryModel?: () => Model<Api>;\n  /** Built-in curated memory store (agent home `memories/`). */\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  /** Memory orchestration (prefetch/sync + external tools). */\n  getMemoryManager?: () => MemoryManager;\n  /** Session store for `session_search`. */\n  getSessionStore?: () => SessionStore;\n  /** When set (gateway webchat), enables the `clarify` tool. */\n  gatewayClarify?: { requestClarification: GatewayClarifyRequestFn };\n  /** Gateway: enables the `cronjob` tool. */\n  getCronService?: () => CronService | undefined;\n  /** Current session skill indexing (tool gating + allowlist); used by skills_list / skill_view. */\n  getSkillIndexingContext?: () =>\n    | { registeredToolNames: string[]; skillAllowlist?: string[] }\n    | undefined;\n  /** After skill_manage mutates disk, reload skills + refresh agent prompts (optional). */\n  onSkillsFilesystemMutate?: () => void;\n  /** Names registered via skill_view for shell env passthrough. */\n  getSkillPassthroughEnvVarNames?: () => string[];\n  /** Add declared env names for the current session (no values stored). */\n  registerSkillEnvPassthrough?: (names: string[]) => void;\n}\n\nexport interface CreateCoreToolsOptions {\n  /** Workspace root for file/shell tools (defaults to factory workspace). */\n  workspace?: string;\n  /** Canonical `agents/<id>/profile/`: bare SOUL.md / IDENTITY.md resolve here after the workspace. */\n  profileMarkdownRoot?: string;\n  /** Tool `name` values to omit (e.g. `shell`, `extensions` for extension tools). */\n  disabledTools?: Set<string>;\n  /** Optional primary model for image tool heuristics. */\n  getPrimaryModel?: () => Model<Api>;\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  getMemoryManager?: () => MemoryManager;\n  /** When set, registers `skills_list` and `skill_view` bound to this workspace\\'s skills. */\n  getSkillManager?: () => SkillManager;\n}\n\nexport class AgentToolsFactory {\n  private browserManager: BrowserManager | null = null;\n  /** One dialog/console supervisor per chat session (browser tab). */\n  private readonly browserTaskSupervisors = new Map<string, CdpSupervisor>();\n  /** Cached readiness probe — keyed by backend mode + extension host:port. */\n  private browserReadinessCache: {\n    key: string;\n    expiresAt: number;\n    inflight?: Promise<BrowserNotReadyError | null>;\n    result?: BrowserNotReadyError | null;\n  } | null = null;\n\n  constructor(private deps: ToolFactoryDeps) {}\n\n  private browserReadinessKey(): string {\n    const cfg = this.deps.getConfig?.();\n    const backend = resolveBrowserBackendFromConfig(cfg);\n    const ext = cfg?.agents?.defaults?.browser?.extension;\n    const host = typeof ext?.host === 'string' && ext.host.trim() ? ext.host.trim() : '127.0.0.1';\n    const port = typeof ext?.port === 'number' ? ext.port : 19820;\n    const cdpUrl = backend.mode === 'cdp' ? backend.config.wsEndpoint : '';\n    const cloudKind = backend.mode === 'cloud' ? backend.config.type : '';\n    return `${backend.mode}@${host}:${port}|${cdpUrl}|${cloudKind}`;\n  }\n\n  private async checkBrowserReadinessCached(): Promise<BrowserNotReadyError | null> {\n    const key = this.browserReadinessKey();\n    const now = Date.now();\n    const cached = this.browserReadinessCache;\n    if (cached && cached.key === key && cached.expiresAt > now && cached.inflight === undefined) {\n      return cached.result ?? null;\n    }\n    if (cached && cached.key === key && cached.inflight) {\n      return cached.inflight;\n    }\n    const inflight = checkBrowserReadiness(this.deps.getConfig?.());\n    this.browserReadinessCache = { key, expiresAt: now + 30_000, inflight };\n    try {\n      const result = await inflight;\n      this.browserReadinessCache = { key, expiresAt: Date.now() + 30_000, result };\n      return result;\n    } catch (e) {\n      // Probe should never throw, but if it does we just bypass the cache.\n      this.browserReadinessCache = null;\n      log.warn({ err: e }, 'browserReadiness probe failed');\n      return null;\n    }\n  }\n\n  /** Invalidate the readiness cache (config hot-reload, settings-page save, etc.). */\n  invalidateBrowserReadinessCache(): void {\n    this.browserReadinessCache = null;\n  }\n\n  private browserSupervisorForTask(taskId: string): CdpSupervisor {\n    let s = this.browserTaskSupervisors.get(taskId);\n    if (!s) {\n      const b = this.deps.getConfig?.()?.agents?.defaults?.browser;\n      const dialogPolicy =\n        b?.dialogPolicy === 'must_respond' || b?.dialogPolicy === 'auto_accept' || b?.dialogPolicy === 'auto_dismiss'\n          ? b.dialogPolicy\n          : 'auto_dismiss';\n      const dialogTimeoutSeconds =\n        typeof b?.dialogTimeoutSeconds === 'number' &&\n        Number.isFinite(b.dialogTimeoutSeconds) &&\n        b.dialogTimeoutSeconds >= 1\n          ? Math.floor(b.dialogTimeoutSeconds)\n          : 300;\n      s = new CdpSupervisor({ dialogPolicy, dialogTimeoutSeconds });\n      this.browserTaskSupervisors.set(taskId, s);\n    }\n    return s;\n  }\n\n  private async acquireBrowserPage(): Promise<Page> {\n    const taskId = this.deps.getCurrentContext()?.sessionKey ?? 'default';\n    const mgr = this.ensureBrowserManager();\n    await mgr.ensureConnected();\n    if (mgr.getExtensionProvider()) {\n      return null as unknown as Page;\n    }\n    const page = await mgr.getPage(taskId);\n    this.browserSupervisorForTask(taskId).attach(page);\n    return page;\n  }\n\n  private ensureBrowserManager(): BrowserManager {\n    if (!this.browserManager) {\n      this.browserManager = new BrowserManager({\n        getHeadless: () => this.deps.getConfig?.()?.agents?.defaults?.browser?.headless === true,\n        getBackend: () => resolveBrowserBackendFromConfig(this.deps.getConfig?.()),\n      });\n    }\n    return this.browserManager;\n  }\n\n  /** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */\n  async shutdownBrowser(): Promise<void> {\n    this.browserReadinessCache = null;\n    if (!this.browserManager) {\n      return;\n    }\n    await this.browserManager.shutdown();\n    this.browserManager = null;\n    this.browserTaskSupervisors.clear();\n  }\n\n  /** Drop the tab for a session when its agent instance is removed. */\n  async closeBrowserPageForSession(sessionKey: string): Promise<void> {\n    this.browserTaskSupervisors.delete(sessionKey);\n    await this.browserManager?.closePage(sessionKey);\n  }\n\n  createCoreTools(options?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const workspace = options?.workspace ?? this.deps.workspace;\n    const { bus } = this.deps;\n    const getPrimary = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n    const getBuiltin = options?.getBuiltinMemoryStore ?? this.deps.getBuiltinMemoryStore;\n    const builtinStore = getBuiltin?.();\n    const memoriesDir = builtinStore?.memoriesDir;\n    const getMemMgr = options?.getMemoryManager ?? this.deps.getMemoryManager;\n    const getSkillMgr = options?.getSkillManager;\n    const disabled = options?.disabledTools;\n\n    const primary = getPrimary?.();\n    const modelHasVision = primary?.input?.includes('image') ?? false;\n    const cfg = this.deps.getConfig?.();\n    const imageTool = createImageTool({\n      config: cfg,\n      workspace,\n      modelHasVision,\n    });\n    const imageGenerateTool = createImageGenerateTool({\n      config: cfg,\n      workspace,\n    });\n\n    const optionalTools = [imageTool, imageGenerateTool].filter((t) => t != null) as any[];\n\n    const readTool = createReadFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n    });\n    const writeTool = createWriteFileTool(workspace);\n    const editTool = createEditFileTool(workspace);\n    const listDir = createListDirTool(workspace);\n    const grep = createGrepTool(workspace);\n    const find = createFindTool(workspace);\n\n    const core: AgentTool<any, any>[] = [\n      createSessionStatusTool(),\n      createDreamingTool({\n        getWorkspace: () => workspace,\n        getConfig: () => this.deps.getConfig?.(),\n      }),\n      createClarifyTool({\n        resolveAskUser: () => {\n          const req = this.deps.gatewayClarify?.requestClarification;\n          if (!req) return null;\n          const ctx = this.deps.getCurrentContext();\n          if (!ctx?.sessionKey) return null;\n          const source = clarifyTransportSource(ctx.sessionKey);\n          if (!source || !CLARIFY_SUPPORTED_CHANNELS.has(source)) return null;\n          return (r) => req(ctx.sessionKey, r);\n        },\n      }),\n      createTodoTool({\n        getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      ...(getSkillMgr\n        ? [\n            createSkillsListTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n            }),\n            createSkillViewTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n              registerSkillEnvPassthrough: this.deps.registerSkillEnvPassthrough,\n            }),\n            createSkillManageTool({\n              getSkillManager: getSkillMgr,\n              getWorkspace: () => workspace,\n              onSkillsFilesystemMutate: this.deps.onSkillsFilesystemMutate,\n            }),\n          ]\n        : []),\n      readTool,\n      writeTool,\n      editTool,\n      listDir,\n      grep,\n      find,\n      createShellTool(workspace, {\n        getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,\n      }),\n      createWebSearchTool(() => this.deps.getConfig?.()),\n      createWebFetchTool(() => this.deps.getConfig?.()),\n      createWebExtractTool({ getConfig: () => this.deps.getConfig?.() }),\n      // Note: TTS is NOT handled by send_message tool anymore\n      // TTS is applied at the ChannelManager dispatch layer\n      createMessageTool(bus, () => this.deps.getCurrentContext()),\n      ...(mergeTtsConfigFromAppConfig(cfg?.messages?.tts).enabled\n        ? [\n            createTextToSpeechTool({\n              bus,\n              getContext: () => this.deps.getCurrentContext(),\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),\n      createMemorySearchTool({ workspaceDir: workspace, memoriesDir }),\n      createMemoryGetTool({ workspaceDir: workspace, memoriesDir }),\n      ...(getBuiltin && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.())\n        ? [\n            createCuratedMemoryTool(getBuiltin, {\n              onMemoryWrite: (action, target, content) => {\n                getMemMgr?.().onMemoryWrite(action, target, content);\n              },\n            }),\n          ]\n        : []),\n      ...(getMemMgr?.().getAdditionalTools() ?? []),\n      ...(this.deps.getSessionStore\n        ? [\n            createSessionSearchTool({\n              getSessionStore: this.deps.getSessionStore,\n              getConfig: this.deps.getConfig,\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n            }),\n          ]\n        : []),\n      ...(this.deps.getCronService\n        ? [\n            createCronjobTool({\n              getCronService: this.deps.getCronService,\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.browser?.enabled !== false\n        ? [\n            createBrowserUseTool({\n              getManager: () => this.ensureBrowserManager(),\n              getPageForTask: () => this.acquireBrowserPage(),\n              getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? 'default',\n              getConfig: () => this.deps.getConfig?.(),\n              getReadiness: () => this.checkBrowserReadinessCached(),\n              getSupervisor: () =>\n                this.browserSupervisorForTask(this.deps.getCurrentContext()?.sessionKey ?? 'default'),\n              notifyBrowserPageClosed: (taskId) => {\n                this.browserTaskSupervisors.delete(taskId);\n              },\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.delegate?.enabled === true && primary\n        ? [\n            createDelegateTool({\n              workspace,\n              getSubagentModel: () => {\n                const gp = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n                const m = gp?.();\n                if (!m) {\n                  throw new Error('No primary model configured for delegate_task');\n                }\n                return m;\n              },\n              bus: this.deps.bus,\n              getConfig: () => this.deps.getConfig?.(),\n              getCurrentContext: () => this.deps.getCurrentContext?.() ?? null,\n              hookRunner: this.deps.hookRunner,\n              toolExecutorConfig: this.deps.toolExecutorConfig,\n              // Injected so `child-agent-factory.ts` does not need to import\n              // `AgentToolsFactory` directly (which would form a cycle).\n              buildChildTools: (childOpts) => {\n                const childFactory = new AgentToolsFactory({\n                  workspace: childOpts.workspace,\n                  bus: childOpts.bus,\n                  getCurrentContext: () => null,\n                  getConfig: childOpts.getConfig,\n                  getPrimaryModel: () => childOpts.model,\n                  toolExecutorConfig: childOpts.toolExecutorConfig,\n                });\n                return childFactory.createAllTools({\n                  workspace: childOpts.workspace,\n                  getPrimaryModel: () => childOpts.model,\n                  disabledTools: new Set(['extensions']),\n                });\n              },\n            }),\n          ]\n        : []),\n      ...optionalTools,\n    ];\n\n    return filterToolsByDisabledSet(core, disabled);\n  }\n\n  createAllTools(coreOptions?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const coreTools = this.createCoreTools(coreOptions);\n    const disableExtensions = coreOptions?.disabledTools?.has('extensions');\n    const cfg = this.deps.getConfig?.();\n\n    let bundled: AgentTool<any, any>[];\n    if (!this.deps.extensionRegistry || disableExtensions) {\n      bundled = coreTools;\n    } else {\n      const extensionTools = this.deps.extensionRegistry.getAllTools();\n      log.info({ count: extensionTools.length }, 'Loaded extension tools');\n      bundled = [...coreTools, ...extensionTools];\n    }\n\n    const wrapped = wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);\n\n    const executeEnabled =\n      cfg?.agents?.defaults?.executeCode?.enabled === true &&\n      !coreOptions?.disabledTools?.has('execute_code');\n\n    if (executeEnabled) {\n      const sandboxMap = buildSandboxToolMap(wrapped);\n      const executeTool = createExecuteCodeTool({ getSandboxToolMap: () => sandboxMap });\n      const wrappedExecute = wrapToolsWithProtection([executeTool as any], this.deps.toolExecutorConfig);\n      return [...wrapped, ...wrappedExecute];\n    }\n\n    return wrapped;\n  }\n}\n\nfunction filterToolsByDisabledSet(\n  tools: any[],\n  disabled: Set<string> | undefined,\n): any[] {\n  if (!disabled || disabled.size === 0) {\n    return tools;\n  }\n  return tools.filter((t) => !disabled.has(t.name));\n}\n"],"mappings":"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"}