@xopcai/xopc 0.0.115 → 0.0.117

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

@@ -13,6 +13,7 @@ import { createFindTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { createWebExtractTool } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
+import { createComposioExecuteTool } from "./composio-tool.js";
 import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
@@ -25,10 +26,10 @@ import { resolveBrowserBackendFromConfig } from "../../browser/backend-from-conf
 import { checkBrowserReadiness } from "../../browser/readiness.js";
 import { CdpSupervisor } from "../../browser/cdp-supervisor.js";
 import "../../browser/index.js";
-import { createDelegateTool } from "./delegate-tool.js";
+import "./delegate-tool.js";
 import { createWorkflowCatalog } from "../workflow/catalog.js";
 import { createWorkflowTool } from "./workflow-tool.js";
-import { buildSandboxToolMap, createExecuteCodeTool } from "./execute-code-tool.js";
+import "./execute-code-tool.js";
 import { createCronjobTool } from "./cronjob-tool.js";
 import { createGoalTool } from "./goal-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
@@ -52,7 +53,7 @@ const CLARIFY_SUPPORTED_CHANNELS = new Set([
 	"telegram",
 	"cli"
 ]);
-var AgentToolsFactory = class AgentToolsFactory {
+var AgentToolsFactory = class {
 	browserManager = null;
 	/** One dialog/console supervisor per chat session (browser tab). */
 	browserTaskSupervisors = /* @__PURE__ */ new Map();
@@ -64,9 +65,8 @@ var AgentToolsFactory = class AgentToolsFactory {
 	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 host = "127.0.0.1";
+		const 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}`;
@@ -104,10 +104,9 @@ var AgentToolsFactory = class AgentToolsFactory {
 	browserSupervisorForTask(taskId) {
 		let s = this.browserTaskSupervisors.get(taskId);
 		if (!s) {
-			const b = this.deps.getConfig?.()?.agents?.defaults?.browser;
 			s = new CdpSupervisor({
-				dialogPolicy: b?.dialogPolicy === "must_respond" || b?.dialogPolicy === "auto_accept" || b?.dialogPolicy === "auto_dismiss" ? b.dialogPolicy : "auto_dismiss",
-				dialogTimeoutSeconds: typeof b?.dialogTimeoutSeconds === "number" && Number.isFinite(b.dialogTimeoutSeconds) && b.dialogTimeoutSeconds >= 1 ? Math.floor(b.dialogTimeoutSeconds) : 300
+				dialogPolicy: "auto_dismiss",
+				dialogTimeoutSeconds: 300
 			});
 			this.browserTaskSupervisors.set(taskId, s);
 		}
@@ -124,7 +123,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 	}
 	ensureBrowserManager() {
 		if (!this.browserManager) this.browserManager = new BrowserManager({
-			getHeadless: () => this.deps.getConfig?.()?.agents?.defaults?.browser?.headless === true,
+			getHeadless: () => false,
 			getBackend: () => resolveBrowserBackendFromConfig(this.deps.getConfig?.())
 		});
 		return this.browserManager;
@@ -146,23 +145,26 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const workspace = options?.workspace ?? this.deps.workspace;
 		const { bus } = this.deps;
 		const getPrimary = options?.getPrimaryModel ?? this.deps.getPrimaryModel;
-		const getBuiltin = options?.getBuiltinMemoryStore ?? this.deps.getBuiltinMemoryStore;
-		const memoriesDir = (getBuiltin?.())?.memoriesDir;
 		const getMemMgr = options?.getMemoryManager ?? this.deps.getMemoryManager;
 		const getSkillMgr = options?.getSkillManager;
 		const disabled = options?.disabledTools;
 		const primary = getPrimary?.();
 		const modelHasVision = primary?.input?.includes("image") ?? false;
 		const cfg = this.deps.getConfig?.();
+		const browserEnabled = cfg?.browser?.enabled !== false;
 		const recordGoalEvidence = createGoalEvidenceRecorder({ getSessionKey: () => this.deps.getCurrentContext()?.sessionKey });
-		const optionalTools = [createImageTool({
-			config: cfg,
-			workspace,
-			modelHasVision
-		}), createImageGenerateTool({
-			config: cfg,
-			workspace
-		})].filter((t) => t != null);
+		const optionalTools = [
+			createImageTool({
+				config: cfg,
+				workspace,
+				modelHasVision
+			}),
+			createImageGenerateTool({
+				config: cfg,
+				workspace
+			}),
+			createComposioExecuteTool(() => this.deps.getConfig?.())
+		].filter((t) => t != null);
 		const readTool = createReadFileTool(workspace, { profileMarkdownRoot: options?.profileMarkdownRoot });
 		const writeTool = createWriteFileTool(workspace, {
 			profileMarkdownRoot: options?.profileMarkdownRoot,
@@ -232,17 +234,14 @@ var AgentToolsFactory = class AgentToolsFactory {
 				workspace,
 				getConfig: () => this.deps.getConfig?.()
 			})] : [],
-			createMemorySearchTool({
+			...getMemMgr ? [createMemorySearchTool({
 				workspaceDir: workspace,
-				memoriesDir
-			}),
-			createMemoryGetTool({
+				getMemoryManager: () => getMemMgr()
+			}), createMemoryGetTool({
 				workspaceDir: workspace,
-				memoriesDir
-			}),
-			...getBuiltin && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.()) ? [createCuratedMemoryTool(getBuiltin, { onMemoryWrite: (action, target, content) => {
-				getMemMgr?.().onMemoryWrite(action, target, content);
-			} })] : [],
+				getMemoryManager: () => getMemMgr()
+			})] : [],
+			...getMemMgr && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.()) ? [createCuratedMemoryTool(() => getMemMgr())] : [],
 			...getMemMgr?.().getAdditionalTools() ?? [],
 			...this.deps.getSessionStore ? [createSessionSearchTool({
 				getSessionStore: this.deps.getSessionStore,
@@ -251,7 +250,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 			})] : [],
 			...this.deps.getCronService ? [createCronjobTool({ getCronService: this.deps.getCronService })] : [],
 			createGoalTool(),
-			...cfg?.agents?.defaults?.browser?.enabled !== false ? [createBrowserUseTool({
+			...browserEnabled ? [createBrowserUseTool({
 				getManager: () => this.ensureBrowserManager(),
 				getPageForTask: () => this.acquireBrowserPage(),
 				getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? "default",
@@ -262,46 +261,19 @@ var AgentToolsFactory = class AgentToolsFactory {
 					this.browserTaskSupervisors.delete(taskId);
 				}
 			})] : [],
-			...cfg?.agents?.defaults?.workflow?.enabled !== false && primary ? [createWorkflowTool({
+			...primary ? [createWorkflowTool({
 				catalog: createWorkflowCatalog(),
 				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
 				getConfig: () => this.deps.getConfig?.(),
 				startWorkflowRun: this.deps.getWorkflowRunService ? (params) => this.deps.getWorkflowRunService().startWorkflowRun(params) : void 0
 			})] : [],
-			...cfg?.agents?.defaults?.delegate?.enabled === true && primary ? [createDelegateTool({
-				workspace,
-				getSubagentModel: () => {
-					const m = (options?.getPrimaryModel ?? this.deps.getPrimaryModel)?.();
-					if (!m) throw new Error("No primary model configured for delegate_task");
-					return m;
-				},
-				bus: this.deps.bus,
-				getConfig: () => this.deps.getConfig?.(),
-				getCurrentContext: () => this.deps.getCurrentContext?.() ?? null,
-				hookRunner: this.deps.hookRunner,
-				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);
 	}
 	createAllTools(coreOptions) {
 		const coreTools = this.createCoreTools(coreOptions);
 		const disableExtensions = coreOptions?.disabledTools?.has("extensions");
-		const cfg = this.deps.getConfig?.();
 		let bundled;
 		if (!this.deps.extensionRegistry || disableExtensions) bundled = coreTools;
 		else {
@@ -309,13 +281,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 			log.info({ count: extensionTools.length }, "Loaded extension tools");
 			bundled = [...coreTools, ...extensionTools];
 		}
-		const wrapped = wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);
-		if (cfg?.agents?.defaults?.executeCode?.enabled === true && !coreOptions?.disabledTools?.has("execute_code")) {
-			const sandboxMap = buildSandboxToolMap(wrapped);
-			const wrappedExecute = wrapToolsWithProtection([createExecuteCodeTool({ getSandboxToolMap: () => sandboxMap })], this.deps.toolExecutorConfig);
-			return [...wrapped, ...wrappedExecute];
-		}
-		return wrapped;
+		return wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);
 	}
 };
 function filterToolsByDisabledSet(tools, disabled) {

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

@@ -1 +1 @@
-{"version":3,"file":"factory.js","names":[],"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  createReadMediaTool,\n  createCreateShareTool,\n  isShareToolAvailable,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createSessionStatusTool,\n  createDreamingTool,\n  createClarifyTool,\n  createToolManualTool,\n  createGoalTool,\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 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 { createWorkflowTool } from './workflow-tool.js';\nimport { createWorkflowCatalog } from '../workflow/catalog.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport { createCronjobTool } from './cronjob-tool.js';\nimport type { CronService } from '../../cron/index.js';\nimport type { WorkflowRunServiceLike } from '../../workflows/service/workflow-run-service.types.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';\nimport { createGoalEvidenceRecorder } from './goal-evidence-recorder.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\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  /** Gateway: starts persisted workflow runs (dedicated chat session per run). */\n  getWorkflowRunService?: () => WorkflowRunServiceLike | 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 recordGoalEvidence = createGoalEvidenceRecorder({\n      getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n    });\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      profileMarkdownRoot: options?.profileMarkdownRoot,\n      recordGoalEvidence,\n    });\n    const editTool = createEditFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n      recordGoalEvidence,\n    });\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      createToolManualTool(),\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          if (!CLARIFY_SUPPORTED_CHANNELS.has(ctx.channel)) 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        recordGoalEvidence,\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      createReadMediaTool(),\n      ...(isShareToolAvailable(cfg)\n        ? [\n            createCreateShareTool({\n              workspace,\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\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      createGoalTool(),\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?.workflow?.enabled !== false && primary\n        ? [\n            createWorkflowTool({\n              catalog: createWorkflowCatalog(),\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n              getConfig: () => this.deps.getConfig?.(),\n              startWorkflowRun: this.deps.getWorkflowRunService\n                ? (params) => this.deps.getWorkflowRunService!().startWorkflowRun(params)\n                : undefined,\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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"}
+{"version":3,"file":"factory.js","names":[],"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  createComposioExecuteTool,\n  createSendMediaTool,\n  createReadMediaTool,\n  createCreateShareTool,\n  isShareToolAvailable,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createSessionStatusTool,\n  createDreamingTool,\n  createClarifyTool,\n  createToolManualTool,\n  createGoalTool,\n} from './index.js';\nimport { createCuratedMemoryTool } from './curated-memory-tool.js';\nimport { createSessionSearchTool } from './session-search-tool.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { shouldRegisterCuratedMemoryTool } from '../memory/memory-config.js';\nimport type { SessionStore } from '../../session/store.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 { createWorkflowTool } from './workflow-tool.js';\nimport { createWorkflowCatalog } from '../workflow/catalog.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport { createCronjobTool } from './cronjob-tool.js';\nimport type { CronService } from '../../cron/index.js';\nimport type { WorkflowRunServiceLike } from '../../workflows/service/workflow-run-service.types.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';\nimport { createGoalEvidenceRecorder } from './goal-evidence-recorder.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\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  /** 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  /** Gateway: starts persisted workflow runs (dedicated chat session per run). */\n  getWorkflowRunService?: () => WorkflowRunServiceLike | 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  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 host = '127.0.0.1';\n    const 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      s = new CdpSupervisor({ dialogPolicy: 'auto_dismiss', dialogTimeoutSeconds: 300 });\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: () => false,\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 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 browserEnabled = cfg?.browser?.enabled !== false;\n    const recordGoalEvidence = createGoalEvidenceRecorder({\n      getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n    });\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 composioTool = createComposioExecuteTool(() => this.deps.getConfig?.());\n    const optionalTools = [imageTool, imageGenerateTool, composioTool].filter((t) => t != null) as any[];\n\n    const readTool = createReadFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n    });\n    const writeTool = createWriteFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n      recordGoalEvidence,\n    });\n    const editTool = createEditFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n      recordGoalEvidence,\n    });\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      createToolManualTool(),\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          if (!CLARIFY_SUPPORTED_CHANNELS.has(ctx.channel)) 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        recordGoalEvidence,\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      createReadMediaTool(),\n      ...(isShareToolAvailable(cfg)\n        ? [\n            createCreateShareTool({\n              workspace,\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      ...(getMemMgr\n        ? [\n            createMemorySearchTool({ workspaceDir: workspace, getMemoryManager: () => getMemMgr() }),\n            createMemoryGetTool({ workspaceDir: workspace, getMemoryManager: () => getMemMgr() }),\n          ]\n        : []),\n      ...(getMemMgr && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.())\n        ? [\n            createCuratedMemoryTool(() => getMemMgr()),\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      createGoalTool(),\n      ...(browserEnabled\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      ...(primary\n        ? [\n            createWorkflowTool({\n              catalog: createWorkflowCatalog(),\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n              getConfig: () => this.deps.getConfig?.(),\n              startWorkflowRun: this.deps.getWorkflowRunService\n                ? (params) => this.deps.getWorkflowRunService!().startWorkflowRun(params)\n                : undefined,\n            }),\n          ]\n        : []),\n      ...(false && 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\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 = false && !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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"}

package/dist/src/agent/tools/image-generate-tool.d.ts

@@ -1,7 +1,7 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { Config } from '../../config/schema.js';
 import { parseImageDataUrl } from '../image/generation/image-assets.js';
-import { type ToolModelConfig } from '../image/tool-model-config.js';
+import type { ToolModelConfig } from '../image/tool-model-config.js';
 export { parseImageDataUrl };
 export declare function resolveImageGenerationModelConfigForTool(params: {
     cfg?: Config;

package/dist/src/agent/tools/image-generate-tool.js

@@ -1,4 +1,3 @@
-import { buildToolModelConfigFromCandidates, coerceToolModelConfig, hasToolModelConfig } from "../image/tool-model-config.js";
 import { applyImageGenerationModelConfigDefaults } from "../image/image-helpers.js";
 import { isFailoverError } from "../failover-error.js";
 import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
@@ -124,19 +123,24 @@ async function loadInputImages(params) {
 	return out;
 }
 function resolveImageGenerationModelConfigForTool(params) {
-	const explicit = coerceToolModelConfig(params.cfg?.agents?.defaults?.imageGenerationModel);
-	if (hasToolModelConfig(explicit)) return explicit;
-	return buildToolModelConfigFromCandidates({
-		explicit,
-		candidates: listImageGenerationProvidersSummary(params.cfg).filter((p) => {
-			const provider = getImageGenerationProvider(p.id, params.cfg);
-			try {
-				return provider?.isConfigured?.({ cfg: params.cfg }) ?? false;
-			} catch {
-				return false;
-			}
-		}).map((p) => `${p.id}/${p.defaultModel ?? p.models[0] ?? ""}`).filter((s) => /^[a-z0-9-]+\/.+/.test(s))
-	});
+	const providers = listImageGenerationProvidersSummary(params.cfg);
+	const candidates = [];
+	for (const providerSummary of providers) {
+		const provider = getImageGenerationProvider(providerSummary.id, params.cfg);
+		let configured = false;
+		try {
+			configured = provider?.isConfigured?.({ cfg: params.cfg }) ?? false;
+		} catch {
+			configured = false;
+		}
+		const modelRef = `${providerSummary.id}/${providerSummary.defaultModel ?? providerSummary.models[0] ?? ""}`;
+		if (configured && /^[a-z0-9-]+\/.+/.test(modelRef) && !candidates.includes(modelRef)) candidates.push(modelRef);
+	}
+	if (candidates.length === 0) return null;
+	return {
+		primary: candidates[0],
+		...candidates.length > 1 ? { fallbacks: candidates.slice(1) } : {}
+	};
 }
 async function saveGeneratedImages(params) {
 	const dir = path.join(params.workspace, "media", "generated");
@@ -220,6 +224,7 @@ function createImageGenerateTool(options) {
 			try {
 				const result = await generateImage({
 					cfg: effectiveCfg,
+					modelConfig: imageGenerationModelConfig,
 					prompt,
 					...modelOverride ? { modelOverride } : {},
 					count,

package/dist/src/agent/tools/image-generate-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-generate-tool.js","names":[],"sources":["../../../../src/agent/tools/image-generate-tool.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport { isFailoverError } from '../failover-error.js';\nimport {\n  imageAssetFromDataUrl,\n  imageFileExtensionForMimeType,\n  mimeTypeFromFileName,\n  parseImageDataUrl,\n  sniffImageMimeType,\n} from '../image/generation/image-assets.js';\nimport {\n  generateImage,\n  listImageGenerationProvidersSummary,\n} from '../image/generation/runtime.js';\nimport { getImageGenerationProvider } from '../image/generation/provider-registry.js';\nimport type {\n  ImageGenerationBackground,\n  ImageGenerationOutputFormat,\n  ImageGenerationProviderOptions,\n  ImageGenerationQuality,\n  ImageGenerationResolution,\n  ImageGenerationSourceImage,\n} from '../image/generation/types.js';\nimport { applyImageGenerationModelConfigDefaults } from '../image/image-helpers.js';\nimport {\n  buildToolModelConfigFromCandidates,\n  coerceToolModelConfig,\n  hasToolModelConfig,\n  type ToolModelConfig,\n} from '../image/tool-model-config.js';\n\nconst DEFAULT_COUNT = 1;\nconst MAX_COUNT = 9;\nconst ALLOWED_QUALITIES: ImageGenerationQuality[] = ['low', 'medium', 'high', 'auto'];\nconst ALLOWED_OUTPUT_FORMATS: ImageGenerationOutputFormat[] = ['png', 'jpeg', 'webp'];\nconst ALLOWED_BACKGROUNDS: ImageGenerationBackground[] = ['transparent', 'opaque', 'auto'];\nconst ALLOWED_RESOLUTIONS: ImageGenerationResolution[] = ['1K', '2K', '4K'];\n\nconst ImageGenerateToolSchema = Type.Object({\n  action: Type.Optional(\n    Type.String({\n      description: 'Optional: \"generate\" (default) or \"list\" available image-generation providers.',\n    }),\n  ),\n  prompt: Type.Optional(Type.String({ description: 'Image generation prompt.' })),\n  model: Type.Optional(\n    Type.String({\n      description:\n        'Optional provider/model override, e.g. openai/gpt-image-1 / dashscope/wan2.7-image-pro / minimax/image-01.',\n    }),\n  ),\n  filename: Type.Optional(Type.String({ description: 'Optional basename hint for saved files.' })),\n  size: Type.Optional(Type.String({ description: 'Optional pixel size, e.g. 1024x1024.' })),\n  aspectRatio: Type.Optional(\n    Type.String({ description: 'Optional aspect ratio, e.g. 16:9 / 9:16 / 1:1.' }),\n  ),\n  resolution: Type.Optional(\n    Type.String({\n      description: 'Optional resolution tier: 1K / 2K / 4K (provider-dependent).',\n    }),\n  ),\n  count: Type.Optional(\n    Type.Number({ minimum: 1, maximum: MAX_COUNT, description: `Number of images (1–${MAX_COUNT}).` }),\n  ),\n  quality: Type.Optional(\n    Type.String({ description: 'Optional quality: low / medium / high / auto.' }),\n  ),\n  outputFormat: Type.Optional(\n    Type.String({ description: 'Optional output format: png / jpeg / webp.' }),\n  ),\n  background: Type.Optional(\n    Type.String({ description: 'Optional background: transparent / opaque / auto.' }),\n  ),\n  inputImages: Type.Optional(\n    Type.Array(\n      Type.Object({\n        source: Type.String({\n          description: 'Workspace-relative file path or `data:image/...;base64,...` URL.',\n        }),\n      }),\n      { description: 'Reference images for edit mode (provider must support edit).' },\n    ),\n  ),\n  providerOptions: Type.Optional(\n    Type.Object({\n      openai: Type.Optional(\n        Type.Object({\n          moderation: Type.Optional(Type.String()),\n          outputCompression: Type.Optional(Type.Number()),\n          user: Type.Optional(Type.String()),\n        }),\n      ),\n    }),\n  ),\n});\n\nfunction readStringParam(args: Record<string, unknown>, key: string): string | undefined {\n  const v = args[key];\n  return typeof v === 'string' && v.trim() ? v.trim() : undefined;\n}\n\nfunction readEnumParam<T extends string>(\n  args: Record<string, unknown>,\n  key: string,\n  allowed: ReadonlyArray<T>,\n): T | undefined {\n  const raw = readStringParam(args, key);\n  if (!raw) return undefined;\n  const lower = raw.toLowerCase() as T;\n  return allowed.includes(lower) ? lower : undefined;\n}\n\nfunction readResolutionParam(args: Record<string, unknown>): ImageGenerationResolution | undefined {\n  const raw = readStringParam(args, 'resolution');\n  if (!raw) return undefined;\n  const upper = raw.toUpperCase();\n  return (ALLOWED_RESOLUTIONS as ReadonlyArray<string>).includes(upper)\n    ? (upper as ImageGenerationResolution)\n    : undefined;\n}\n\nfunction readProviderOptions(args: Record<string, unknown>): ImageGenerationProviderOptions | undefined {\n  const raw = args.providerOptions;\n  if (!raw || typeof raw !== 'object') return undefined;\n  const out: ImageGenerationProviderOptions = {};\n  const oa = (raw as Record<string, unknown>).openai;\n  if (oa && typeof oa === 'object') {\n    const oaRec = oa as Record<string, unknown>;\n    const moderation = typeof oaRec.moderation === 'string' ? oaRec.moderation.toLowerCase() : undefined;\n    const outputCompression =\n      typeof oaRec.outputCompression === 'number' && Number.isFinite(oaRec.outputCompression)\n        ? oaRec.outputCompression\n        : undefined;\n    const user = typeof oaRec.user === 'string' && oaRec.user.trim() ? oaRec.user.trim() : undefined;\n    out.openai = {\n      ...(moderation === 'low' || moderation === 'auto' ? { moderation: moderation as 'low' | 'auto' } : {}),\n      ...(outputCompression !== undefined ? { outputCompression } : {}),\n      ...(user ? { user } : {}),\n    };\n    if (Object.keys(out.openai).length === 0) delete out.openai;\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\nclass ToolInputError extends Error {}\n\nasync function loadInputImages(params: {\n  workspace: string;\n  sources: ReadonlyArray<{ source: string }>;\n}): Promise<ImageGenerationSourceImage[]> {\n  if (!params.sources?.length) return [];\n  const out: ImageGenerationSourceImage[] = [];\n  const workspaceAbs = path.resolve(params.workspace);\n  for (const entry of params.sources) {\n    const source = entry?.source;\n    if (typeof source !== 'string' || !source.trim()) {\n      throw new ToolInputError('inputImages[].source is required.');\n    }\n    const trimmed = source.trim();\n    if (/^data:image\\//i.test(trimmed)) {\n      const parsed = imageAssetFromDataUrl(trimmed);\n      if (!parsed) throw new ToolInputError('Invalid data URL in inputImages[].source.');\n      out.push(parsed);\n      continue;\n    }\n    if (/^https?:\\/\\//i.test(trimmed)) {\n      throw new ToolInputError('Sandboxed image_generate does not allow remote URLs.');\n    }\n    const resolved = path.resolve(workspaceAbs, trimmed);\n    if (resolved !== workspaceAbs && !resolved.startsWith(workspaceAbs + path.sep)) {\n      throw new ToolInputError('inputImages[].source escapes workspace.');\n    }\n    let buffer: Buffer;\n    try {\n      buffer = await readFile(resolved);\n    } catch (e) {\n      const em = e instanceof Error ? e.message : String(e);\n      throw new ToolInputError(`inputImages[].source not readable: ${em}`);\n    }\n    const mimeType = mimeTypeFromFileName(resolved) ?? sniffImageMimeType(buffer).mimeType;\n    out.push({ buffer, mimeType, fileName: path.basename(resolved) });\n  }\n  return out;\n}\n\n// Re-exported for callers / tests; no behavioural change vs imported helper.\nexport { parseImageDataUrl };\n\nexport function resolveImageGenerationModelConfigForTool(params: { cfg?: Config }): ToolModelConfig | null {\n  const explicit = coerceToolModelConfig(params.cfg?.agents?.defaults?.imageGenerationModel);\n  if (hasToolModelConfig(explicit)) {\n    return explicit;\n  }\n  // Step 2: tool default = enumerate every provider whose isConfigured() is true,\n  // ordered as registered. No more hard-coded openai/dashscope fallback.\n  const providers = listImageGenerationProvidersSummary(params.cfg);\n  const candidates = providers\n    .filter((p) => {\n      const provider = getImageGenerationProvider(p.id, params.cfg);\n      try {\n        return provider?.isConfigured?.({ cfg: params.cfg }) ?? false;\n      } catch {\n        return false;\n      }\n    })\n    .map((p) => `${p.id}/${p.defaultModel ?? p.models[0] ?? ''}`)\n    .filter((s) => /^[a-z0-9-]+\\/.+/.test(s));\n\n  return buildToolModelConfigFromCandidates({ explicit, candidates });\n}\n\nasync function saveGeneratedImages(params: {\n  workspace: string;\n  images: Array<{ buffer: Buffer; mimeType: string; fileName?: string }>;\n  filenameHint?: string;\n}): Promise<string[]> {\n  const dir = path.join(params.workspace, 'media', 'generated');\n  await mkdir(dir, { recursive: true });\n  const out: string[] = [];\n  const random = randomBytes(4).toString('hex');\n  let i = 0;\n  for (const img of params.images) {\n    i += 1;\n    const ext = imageFileExtensionForMimeType(img.mimeType);\n    const base = (params.filenameHint?.replace(/[^\\w.-]/g, '') || 'image') + `-${random}`;\n    const name = `${base}-${i}.${ext}`;\n    const full = path.join(dir, name);\n    await writeFile(full, img.buffer);\n    out.push(full);\n  }\n  return out;\n}\n\nexport function createImageGenerateTool(options: {\n  config?: Config;\n  workspace: string;\n}): AgentTool<any, Record<string, unknown>> | null {\n  const imageGenerationModelConfig = resolveImageGenerationModelConfigForTool({ cfg: options.config });\n  if (!imageGenerationModelConfig) {\n    return null;\n  }\n\n  const effectiveCfg =\n    applyImageGenerationModelConfigDefaults(options.config, imageGenerationModelConfig) ??\n    options.config;\n\n  return {\n    name: 'image_generate',\n    label: 'Image Generation',\n    description:\n      'Generate images with the configured image-generation model (default OpenAI). Use action=\"list\" to see providers. Saves files under workspace/media/generated/.',\n    parameters: ImageGenerateToolSchema,\n    async execute(\n      _toolCallId: string,\n      args: Record<string, unknown>,\n    ): Promise<AgentToolResult<Record<string, unknown>>> {\n      const params = args as Record<string, unknown>;\n      const action = (readStringParam(params, 'action') || 'generate').toLowerCase();\n      if (action === 'list') {\n        const providers = listImageGenerationProvidersSummary(effectiveCfg);\n        const lines = providers.flatMap((p) => [\n          `${p.id}${p.defaultModel ? ` (default ${p.defaultModel})` : ''}`,\n          `  models: ${p.models.join(', ')}`,\n        ]);\n        return {\n          content: [{ type: 'text', text: lines.join('\\n') }],\n          details: { providers },\n        };\n      }\n      if (action !== 'generate') {\n        return {\n          content: [{ type: 'text', text: 'action must be \"generate\" or \"list\".' }],\n          details: { error: 'bad_action' },\n        };\n      }\n\n      const prompt = readStringParam(params, 'prompt');\n      if (!prompt) {\n        return {\n          content: [{ type: 'text', text: 'prompt is required for image generation.' }],\n          details: { error: 'missing_prompt' },\n        };\n      }\n\n      const modelOverride = readStringParam(params, 'model');\n      const filename = readStringParam(params, 'filename');\n      const size = readStringParam(params, 'size');\n      const aspectRatio = readStringParam(params, 'aspectRatio');\n      const resolution = readResolutionParam(params);\n      const quality = readEnumParam(params, 'quality', ALLOWED_QUALITIES);\n      const outputFormat = readEnumParam(params, 'outputFormat', ALLOWED_OUTPUT_FORMATS);\n      const background = readEnumParam(params, 'background', ALLOWED_BACKGROUNDS);\n      const providerOptions = readProviderOptions(params);\n\n      const countRaw = params.count;\n      const count =\n        typeof countRaw === 'number' && Number.isFinite(countRaw)\n          ? Math.min(MAX_COUNT, Math.max(1, Math.floor(countRaw)))\n          : DEFAULT_COUNT;\n\n      let inputImages: ImageGenerationSourceImage[] = [];\n      try {\n        inputImages = await loadInputImages({\n          workspace: options.workspace,\n          sources: (params.inputImages as Array<{ source: string }>) ?? [],\n        });\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Image generation failed: ${msg}` }],\n          details: {\n            error: e instanceof ToolInputError ? 'invalid_input_images' : 'generation_failed',\n          },\n        };\n      }\n\n      try {\n        const result = await generateImage({\n          cfg: effectiveCfg,\n          prompt,\n          ...(modelOverride ? { modelOverride } : {}),\n          count,\n          ...(size ? { size } : {}),\n          ...(aspectRatio ? { aspectRatio } : {}),\n          ...(resolution ? { resolution } : {}),\n          ...(quality ? { quality } : {}),\n          ...(outputFormat ? { outputFormat } : {}),\n          ...(background ? { background } : {}),\n          ...(inputImages.length > 0 ? { inputImages } : {}),\n          ...(providerOptions ? { providerOptions } : {}),\n        });\n\n        const paths = await saveGeneratedImages({\n          workspace: options.workspace,\n          images: result.images,\n          ...(filename ? { filenameHint: filename } : {}),\n        });\n\n        const workspaceRelativePaths = paths.map((p) =>\n          path.relative(options.workspace, p).split(path.sep).join('/'),\n        );\n\n        const lines: string[] = [\n          `Generated ${paths.length} image(s) with ${result.provider}/${result.model}.`,\n          ...paths.map((p) => `Saved: ${p}`),\n        ];\n        for (const note of buildNormalizationNotes(result.normalization, result.ignoredOverrides)) {\n          lines.push(note);\n        }\n\n        return {\n          content: [{ type: 'text', text: lines.join('\\n') }],\n          details: {\n            provider: result.provider,\n            model: result.model,\n            paths,\n            workspaceRelativePaths,\n            attempts: result.attempts,\n            ...(result.normalization ? { normalization: result.normalization } : {}),\n            ...(result.ignoredOverrides.length > 0\n              ? { ignoredOverrides: result.ignoredOverrides }\n              : {}),\n            ...(result.metadata ? { metadata: result.metadata } : {}),\n          },\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        const failoverFields = isFailoverError(e)\n          ? {\n              ...(e.reason !== undefined ? { reason: e.reason } : {}),\n              ...(e.status !== undefined ? { status: e.status } : {}),\n              ...(e.code !== undefined ? { code: e.code } : {}),\n              ...(e.provider !== undefined ? { provider: e.provider } : {}),\n              ...(e.model !== undefined ? { model: e.model } : {}),\n              attempts: e.attempts,\n            }\n          : {};\n        return {\n          content: [{ type: 'text', text: `Image generation failed: ${msg}` }],\n          details: { error: 'generation_failed', ...failoverFields },\n        };\n      }\n    },\n  } as any;\n}\n\nfunction buildNormalizationNotes(\n  normalization: import('../image/generation/types.js').ImageGenerationNormalization | undefined,\n  ignoredOverrides: ReadonlyArray<import('../image/generation/types.js').ImageGenerationIgnoredOverride>,\n): string[] {\n  const notes: string[] = [];\n  if (normalization) {\n    for (const [key, entry] of Object.entries(normalization)) {\n      if (!entry) continue;\n      const requested = entry.requested;\n      const applied = entry.applied;\n      if (requested !== undefined && applied !== undefined && requested !== applied) {\n        notes.push(`Note: requested ${key}=\"${requested}\" → applied \"${applied}\".`);\n      } else if (applied !== undefined && entry.derivedFrom) {\n        notes.push(`Note: ${key}=\"${applied}\" derived from ${entry.derivedFrom}.`);\n      }\n    }\n  }\n  for (const ig of ignoredOverrides) {\n    notes.push(`Note: ignored ${ig.key}=\"${ig.value}\" (not supported by provider).`);\n  }\n  return notes;\n}\n"],"mappings":"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"}
+{"version":3,"file":"image-generate-tool.js","names":[],"sources":["../../../../src/agent/tools/image-generate-tool.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport { isFailoverError } from '../failover-error.js';\nimport {\n  imageAssetFromDataUrl,\n  imageFileExtensionForMimeType,\n  mimeTypeFromFileName,\n  parseImageDataUrl,\n  sniffImageMimeType,\n} from '../image/generation/image-assets.js';\nimport {\n  generateImage,\n  listImageGenerationProvidersSummary,\n} from '../image/generation/runtime.js';\nimport { getImageGenerationProvider } from '../image/generation/provider-registry.js';\nimport type {\n  ImageGenerationBackground,\n  ImageGenerationOutputFormat,\n  ImageGenerationProviderOptions,\n  ImageGenerationQuality,\n  ImageGenerationResolution,\n  ImageGenerationSourceImage,\n} from '../image/generation/types.js';\nimport { applyImageGenerationModelConfigDefaults } from '../image/image-helpers.js';\nimport type { ToolModelConfig } from '../image/tool-model-config.js';\n\nconst DEFAULT_COUNT = 1;\nconst MAX_COUNT = 9;\nconst ALLOWED_QUALITIES: ImageGenerationQuality[] = ['low', 'medium', 'high', 'auto'];\nconst ALLOWED_OUTPUT_FORMATS: ImageGenerationOutputFormat[] = ['png', 'jpeg', 'webp'];\nconst ALLOWED_BACKGROUNDS: ImageGenerationBackground[] = ['transparent', 'opaque', 'auto'];\nconst ALLOWED_RESOLUTIONS: ImageGenerationResolution[] = ['1K', '2K', '4K'];\n\nconst ImageGenerateToolSchema = Type.Object({\n  action: Type.Optional(\n    Type.String({\n      description: 'Optional: \"generate\" (default) or \"list\" available image-generation providers.',\n    }),\n  ),\n  prompt: Type.Optional(Type.String({ description: 'Image generation prompt.' })),\n  model: Type.Optional(\n    Type.String({\n      description:\n        'Optional provider/model override, e.g. openai/gpt-image-1 / dashscope/wan2.7-image-pro / minimax/image-01.',\n    }),\n  ),\n  filename: Type.Optional(Type.String({ description: 'Optional basename hint for saved files.' })),\n  size: Type.Optional(Type.String({ description: 'Optional pixel size, e.g. 1024x1024.' })),\n  aspectRatio: Type.Optional(\n    Type.String({ description: 'Optional aspect ratio, e.g. 16:9 / 9:16 / 1:1.' }),\n  ),\n  resolution: Type.Optional(\n    Type.String({\n      description: 'Optional resolution tier: 1K / 2K / 4K (provider-dependent).',\n    }),\n  ),\n  count: Type.Optional(\n    Type.Number({ minimum: 1, maximum: MAX_COUNT, description: `Number of images (1–${MAX_COUNT}).` }),\n  ),\n  quality: Type.Optional(\n    Type.String({ description: 'Optional quality: low / medium / high / auto.' }),\n  ),\n  outputFormat: Type.Optional(\n    Type.String({ description: 'Optional output format: png / jpeg / webp.' }),\n  ),\n  background: Type.Optional(\n    Type.String({ description: 'Optional background: transparent / opaque / auto.' }),\n  ),\n  inputImages: Type.Optional(\n    Type.Array(\n      Type.Object({\n        source: Type.String({\n          description: 'Workspace-relative file path or `data:image/...;base64,...` URL.',\n        }),\n      }),\n      { description: 'Reference images for edit mode (provider must support edit).' },\n    ),\n  ),\n  providerOptions: Type.Optional(\n    Type.Object({\n      openai: Type.Optional(\n        Type.Object({\n          moderation: Type.Optional(Type.String()),\n          outputCompression: Type.Optional(Type.Number()),\n          user: Type.Optional(Type.String()),\n        }),\n      ),\n    }),\n  ),\n});\n\nfunction readStringParam(args: Record<string, unknown>, key: string): string | undefined {\n  const v = args[key];\n  return typeof v === 'string' && v.trim() ? v.trim() : undefined;\n}\n\nfunction readEnumParam<T extends string>(\n  args: Record<string, unknown>,\n  key: string,\n  allowed: ReadonlyArray<T>,\n): T | undefined {\n  const raw = readStringParam(args, key);\n  if (!raw) return undefined;\n  const lower = raw.toLowerCase() as T;\n  return allowed.includes(lower) ? lower : undefined;\n}\n\nfunction readResolutionParam(args: Record<string, unknown>): ImageGenerationResolution | undefined {\n  const raw = readStringParam(args, 'resolution');\n  if (!raw) return undefined;\n  const upper = raw.toUpperCase();\n  return (ALLOWED_RESOLUTIONS as ReadonlyArray<string>).includes(upper)\n    ? (upper as ImageGenerationResolution)\n    : undefined;\n}\n\nfunction readProviderOptions(args: Record<string, unknown>): ImageGenerationProviderOptions | undefined {\n  const raw = args.providerOptions;\n  if (!raw || typeof raw !== 'object') return undefined;\n  const out: ImageGenerationProviderOptions = {};\n  const oa = (raw as Record<string, unknown>).openai;\n  if (oa && typeof oa === 'object') {\n    const oaRec = oa as Record<string, unknown>;\n    const moderation = typeof oaRec.moderation === 'string' ? oaRec.moderation.toLowerCase() : undefined;\n    const outputCompression =\n      typeof oaRec.outputCompression === 'number' && Number.isFinite(oaRec.outputCompression)\n        ? oaRec.outputCompression\n        : undefined;\n    const user = typeof oaRec.user === 'string' && oaRec.user.trim() ? oaRec.user.trim() : undefined;\n    out.openai = {\n      ...(moderation === 'low' || moderation === 'auto' ? { moderation: moderation as 'low' | 'auto' } : {}),\n      ...(outputCompression !== undefined ? { outputCompression } : {}),\n      ...(user ? { user } : {}),\n    };\n    if (Object.keys(out.openai).length === 0) delete out.openai;\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\nclass ToolInputError extends Error {}\n\nasync function loadInputImages(params: {\n  workspace: string;\n  sources: ReadonlyArray<{ source: string }>;\n}): Promise<ImageGenerationSourceImage[]> {\n  if (!params.sources?.length) return [];\n  const out: ImageGenerationSourceImage[] = [];\n  const workspaceAbs = path.resolve(params.workspace);\n  for (const entry of params.sources) {\n    const source = entry?.source;\n    if (typeof source !== 'string' || !source.trim()) {\n      throw new ToolInputError('inputImages[].source is required.');\n    }\n    const trimmed = source.trim();\n    if (/^data:image\\//i.test(trimmed)) {\n      const parsed = imageAssetFromDataUrl(trimmed);\n      if (!parsed) throw new ToolInputError('Invalid data URL in inputImages[].source.');\n      out.push(parsed);\n      continue;\n    }\n    if (/^https?:\\/\\//i.test(trimmed)) {\n      throw new ToolInputError('Sandboxed image_generate does not allow remote URLs.');\n    }\n    const resolved = path.resolve(workspaceAbs, trimmed);\n    if (resolved !== workspaceAbs && !resolved.startsWith(workspaceAbs + path.sep)) {\n      throw new ToolInputError('inputImages[].source escapes workspace.');\n    }\n    let buffer: Buffer;\n    try {\n      buffer = await readFile(resolved);\n    } catch (e) {\n      const em = e instanceof Error ? e.message : String(e);\n      throw new ToolInputError(`inputImages[].source not readable: ${em}`);\n    }\n    const mimeType = mimeTypeFromFileName(resolved) ?? sniffImageMimeType(buffer).mimeType;\n    out.push({ buffer, mimeType, fileName: path.basename(resolved) });\n  }\n  return out;\n}\n\n// Re-exported for callers / tests; no behavioural change vs imported helper.\nexport { parseImageDataUrl };\n\nexport function resolveImageGenerationModelConfigForTool(params: { cfg?: Config }): ToolModelConfig | null {\n  // Step 2: tool default = enumerate every provider whose isConfigured() is true,\n  // ordered as registered. No more hard-coded openai/dashscope fallback.\n  const providers = listImageGenerationProvidersSummary(params.cfg);\n  const candidates: string[] = [];\n  for (const providerSummary of providers) {\n    const provider = getImageGenerationProvider(providerSummary.id, params.cfg);\n    let configured = false;\n    try {\n      configured = provider?.isConfigured?.({ cfg: params.cfg }) ?? false;\n    } catch {\n      configured = false;\n    }\n    const modelRef = `${providerSummary.id}/${providerSummary.defaultModel ?? providerSummary.models[0] ?? ''}`;\n    if (configured && /^[a-z0-9-]+\\/.+/.test(modelRef) && !candidates.includes(modelRef)) {\n      candidates.push(modelRef);\n    }\n  }\n\n  if (candidates.length === 0) {\n    return null;\n  }\n\n  return {\n    primary: candidates[0],\n    ...(candidates.length > 1 ? { fallbacks: candidates.slice(1) } : {}),\n  };\n}\n\nasync function saveGeneratedImages(params: {\n  workspace: string;\n  images: Array<{ buffer: Buffer; mimeType: string; fileName?: string }>;\n  filenameHint?: string;\n}): Promise<string[]> {\n  const dir = path.join(params.workspace, 'media', 'generated');\n  await mkdir(dir, { recursive: true });\n  const out: string[] = [];\n  const random = randomBytes(4).toString('hex');\n  let i = 0;\n  for (const img of params.images) {\n    i += 1;\n    const ext = imageFileExtensionForMimeType(img.mimeType);\n    const base = (params.filenameHint?.replace(/[^\\w.-]/g, '') || 'image') + `-${random}`;\n    const name = `${base}-${i}.${ext}`;\n    const full = path.join(dir, name);\n    await writeFile(full, img.buffer);\n    out.push(full);\n  }\n  return out;\n}\n\nexport function createImageGenerateTool(options: {\n  config?: Config;\n  workspace: string;\n}): AgentTool<any, Record<string, unknown>> | null {\n  const imageGenerationModelConfig = resolveImageGenerationModelConfigForTool({ cfg: options.config });\n  if (!imageGenerationModelConfig) {\n    return null;\n  }\n\n  const effectiveCfg =\n    applyImageGenerationModelConfigDefaults(options.config, imageGenerationModelConfig) ??\n    options.config;\n\n  return {\n    name: 'image_generate',\n    label: 'Image Generation',\n    description:\n      'Generate images with the configured image-generation model (default OpenAI). Use action=\"list\" to see providers. Saves files under workspace/media/generated/.',\n    parameters: ImageGenerateToolSchema,\n    async execute(\n      _toolCallId: string,\n      args: Record<string, unknown>,\n    ): Promise<AgentToolResult<Record<string, unknown>>> {\n      const params = args as Record<string, unknown>;\n      const action = (readStringParam(params, 'action') || 'generate').toLowerCase();\n      if (action === 'list') {\n        const providers = listImageGenerationProvidersSummary(effectiveCfg);\n        const lines = providers.flatMap((p) => [\n          `${p.id}${p.defaultModel ? ` (default ${p.defaultModel})` : ''}`,\n          `  models: ${p.models.join(', ')}`,\n        ]);\n        return {\n          content: [{ type: 'text', text: lines.join('\\n') }],\n          details: { providers },\n        };\n      }\n      if (action !== 'generate') {\n        return {\n          content: [{ type: 'text', text: 'action must be \"generate\" or \"list\".' }],\n          details: { error: 'bad_action' },\n        };\n      }\n\n      const prompt = readStringParam(params, 'prompt');\n      if (!prompt) {\n        return {\n          content: [{ type: 'text', text: 'prompt is required for image generation.' }],\n          details: { error: 'missing_prompt' },\n        };\n      }\n\n      const modelOverride = readStringParam(params, 'model');\n      const filename = readStringParam(params, 'filename');\n      const size = readStringParam(params, 'size');\n      const aspectRatio = readStringParam(params, 'aspectRatio');\n      const resolution = readResolutionParam(params);\n      const quality = readEnumParam(params, 'quality', ALLOWED_QUALITIES);\n      const outputFormat = readEnumParam(params, 'outputFormat', ALLOWED_OUTPUT_FORMATS);\n      const background = readEnumParam(params, 'background', ALLOWED_BACKGROUNDS);\n      const providerOptions = readProviderOptions(params);\n\n      const countRaw = params.count;\n      const count =\n        typeof countRaw === 'number' && Number.isFinite(countRaw)\n          ? Math.min(MAX_COUNT, Math.max(1, Math.floor(countRaw)))\n          : DEFAULT_COUNT;\n\n      let inputImages: ImageGenerationSourceImage[] = [];\n      try {\n        inputImages = await loadInputImages({\n          workspace: options.workspace,\n          sources: (params.inputImages as Array<{ source: string }>) ?? [],\n        });\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Image generation failed: ${msg}` }],\n          details: {\n            error: e instanceof ToolInputError ? 'invalid_input_images' : 'generation_failed',\n          },\n        };\n      }\n\n      try {\n        const result = await generateImage({\n          cfg: effectiveCfg,\n          modelConfig: imageGenerationModelConfig,\n          prompt,\n          ...(modelOverride ? { modelOverride } : {}),\n          count,\n          ...(size ? { size } : {}),\n          ...(aspectRatio ? { aspectRatio } : {}),\n          ...(resolution ? { resolution } : {}),\n          ...(quality ? { quality } : {}),\n          ...(outputFormat ? { outputFormat } : {}),\n          ...(background ? { background } : {}),\n          ...(inputImages.length > 0 ? { inputImages } : {}),\n          ...(providerOptions ? { providerOptions } : {}),\n        });\n\n        const paths = await saveGeneratedImages({\n          workspace: options.workspace,\n          images: result.images,\n          ...(filename ? { filenameHint: filename } : {}),\n        });\n\n        const workspaceRelativePaths = paths.map((p) =>\n          path.relative(options.workspace, p).split(path.sep).join('/'),\n        );\n\n        const lines: string[] = [\n          `Generated ${paths.length} image(s) with ${result.provider}/${result.model}.`,\n          ...paths.map((p) => `Saved: ${p}`),\n        ];\n        for (const note of buildNormalizationNotes(result.normalization, result.ignoredOverrides)) {\n          lines.push(note);\n        }\n\n        return {\n          content: [{ type: 'text', text: lines.join('\\n') }],\n          details: {\n            provider: result.provider,\n            model: result.model,\n            paths,\n            workspaceRelativePaths,\n            attempts: result.attempts,\n            ...(result.normalization ? { normalization: result.normalization } : {}),\n            ...(result.ignoredOverrides.length > 0\n              ? { ignoredOverrides: result.ignoredOverrides }\n              : {}),\n            ...(result.metadata ? { metadata: result.metadata } : {}),\n          },\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        const failoverFields = isFailoverError(e)\n          ? {\n              ...(e.reason !== undefined ? { reason: e.reason } : {}),\n              ...(e.status !== undefined ? { status: e.status } : {}),\n              ...(e.code !== undefined ? { code: e.code } : {}),\n              ...(e.provider !== undefined ? { provider: e.provider } : {}),\n              ...(e.model !== undefined ? { model: e.model } : {}),\n              attempts: e.attempts,\n            }\n          : {};\n        return {\n          content: [{ type: 'text', text: `Image generation failed: ${msg}` }],\n          details: { error: 'generation_failed', ...failoverFields },\n        };\n      }\n    },\n  } as any;\n}\n\nfunction buildNormalizationNotes(\n  normalization: import('../image/generation/types.js').ImageGenerationNormalization | undefined,\n  ignoredOverrides: ReadonlyArray<import('../image/generation/types.js').ImageGenerationIgnoredOverride>,\n): string[] {\n  const notes: string[] = [];\n  if (normalization) {\n    for (const [key, entry] of Object.entries(normalization)) {\n      if (!entry) continue;\n      const requested = entry.requested;\n      const applied = entry.applied;\n      if (requested !== undefined && applied !== undefined && requested !== applied) {\n        notes.push(`Note: requested ${key}=\"${requested}\" → applied \"${applied}\".`);\n      } else if (applied !== undefined && entry.derivedFrom) {\n        notes.push(`Note: ${key}=\"${applied}\" derived from ${entry.derivedFrom}.`);\n      }\n    }\n  }\n  for (const ig of ignoredOverrides) {\n    notes.push(`Note: ignored ${ig.key}=\"${ig.value}\" (not supported by provider).`);\n  }\n  return notes;\n}\n"],"mappings":"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"}

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

@@ -9,14 +9,12 @@ const DEFAULT_PROMPT = "Describe the image.";
 const DEFAULT_MAX_IMAGES = 20;
 function pickMaxBytes(cfg, maxBytesMb) {
 	if (typeof maxBytesMb === "number" && Number.isFinite(maxBytesMb) && maxBytesMb > 0) return Math.floor(maxBytesMb * 1024 * 1024);
-	const configured = cfg?.agents?.defaults?.mediaMaxMb;
-	if (typeof configured === "number" && Number.isFinite(configured) && configured > 0) return Math.floor(configured * 1024 * 1024);
 	return 20 * 1024 * 1024;
 }
 function createImageTool(options) {
 	const imageModelConfig = resolveImageModelConfigForTool({ cfg: options.config });
 	if (!imageModelConfig) return null;
-	const description = options.modelHasVision ? "Analyze one or more images with a vision model. Use `image` for a single path/URL, or `images` for multiple (up to 20). Only use when images were NOT already in the user message." : "Analyze one or more images using the configured image model (agents.defaults.imageModel). Use `image` or `images` for paths/URLs; optional `prompt` for what to extract.";
+	const description = options.modelHasVision ? "Analyze one or more images with a vision model. Use `image` for a single path/URL, or `images` for multiple (up to 20). Only use when images were NOT already in the user message." : "Analyze one or more images using the available image model. Use `image` or `images` for paths/URLs; optional `prompt` for what to extract.";
 	const localRoots = [options.workspace];
 	return {
 		name: "image",

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

@@ -1 +1 @@
-{"version":3,"file":"image-tool.js","names":[],"sources":["../../../../src/agent/tools/image-tool.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport { describeImages } from '../image/understanding/runtime.js';\nimport { buildImageToolTextResult, resolvePromptAndModelOverride } from '../image/image-helpers.js';\nimport { runWithImageModelFallback } from '../image/image-model-fallback.js';\nimport { loadImageForToolInput } from '../image/load-image-media.js';\nimport { resolveImageModelConfigForTool } from '../image/tool-model-config.js';\n\nconst DEFAULT_PROMPT = 'Describe the image.';\nconst DEFAULT_MAX_IMAGES = 20;\n\nexport { resolveImageModelConfigForTool } from '../image/tool-model-config.js';\n\nfunction pickMaxBytes(cfg?: Config, maxBytesMb?: number): number {\n  if (typeof maxBytesMb === 'number' && Number.isFinite(maxBytesMb) && maxBytesMb > 0) {\n    return Math.floor(maxBytesMb * 1024 * 1024);\n  }\n  const configured = cfg?.agents?.defaults?.mediaMaxMb;\n  if (typeof configured === 'number' && Number.isFinite(configured) && configured > 0) {\n    return Math.floor(configured * 1024 * 1024);\n  }\n  return 20 * 1024 * 1024;\n}\n\nexport function createImageTool(options: {\n  config?: Config;\n  workspace: string;\n  /** When true, session model already receives images in the user message. */\n  modelHasVision?: boolean;\n}): AgentTool<any, Record<string, unknown>> | null {\n  const imageModelConfig = resolveImageModelConfigForTool({ cfg: options.config });\n  if (!imageModelConfig) {\n    return null;\n  }\n\n  const description = options.modelHasVision\n    ? 'Analyze one or more images with a vision model. Use `image` for a single path/URL, or `images` for multiple (up to 20). Only use when images were NOT already in the user message.'\n    : 'Analyze one or more images using the configured image model (agents.defaults.imageModel). Use `image` or `images` for paths/URLs; optional `prompt` for what to extract.';\n\n  const localRoots = [options.workspace];\n\n  return {\n    name: 'image',\n    label: 'Image',\n    description,\n    parameters: Type.Object({\n      prompt: Type.Optional(Type.String()),\n      image: Type.Optional(Type.String({ description: 'Single image path or URL.' })),\n      images: Type.Optional(\n        Type.Array(Type.String(), {\n          description: 'Multiple image paths or URLs (up to maxImages, default 20).',\n        }),\n      ),\n      model: Type.Optional(Type.String({ description: 'Optional provider/model override.' })),\n      maxBytesMb: Type.Optional(Type.Number()),\n      maxImages: Type.Optional(Type.Number()),\n    }),\n    async execute(\n      _toolCallId: string,\n      args: Record<string, unknown>,\n    ): Promise<AgentToolResult<Record<string, unknown>>> {\n      const record = args && typeof args === 'object' ? args : {};\n\n      const imageCandidates: string[] = [];\n      if (typeof record.image === 'string') {\n        imageCandidates.push(record.image);\n      }\n      if (Array.isArray(record.images)) {\n        imageCandidates.push(...record.images.filter((v): v is string => typeof v === 'string'));\n      }\n\n      const seenImages = new Set<string>();\n      const imageInputs: string[] = [];\n      for (const candidate of imageCandidates) {\n        const trimmedCandidate = candidate.trim();\n        const normalizedForDedupe = trimmedCandidate.startsWith('@')\n          ? trimmedCandidate.slice(1).trim()\n          : trimmedCandidate;\n        if (!normalizedForDedupe || seenImages.has(normalizedForDedupe)) {\n          continue;\n        }\n        seenImages.add(normalizedForDedupe);\n        imageInputs.push(trimmedCandidate);\n      }\n\n      if (imageInputs.length === 0) {\n        return {\n          content: [{ type: 'text', text: 'Error: provide `image` or `images`.' }],\n          details: { error: 'missing_image' },\n        };\n      }\n\n      const maxImagesRaw = typeof record.maxImages === 'number' ? record.maxImages : undefined;\n      const maxImages =\n        typeof maxImagesRaw === 'number' && Number.isFinite(maxImagesRaw) && maxImagesRaw > 0\n          ? Math.floor(maxImagesRaw)\n          : DEFAULT_MAX_IMAGES;\n      if (imageInputs.length > maxImages) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Too many images: ${imageInputs.length} (max ${maxImages}).`,\n            },\n          ],\n          details: { error: 'too_many_images', count: imageInputs.length, max: maxImages },\n        };\n      }\n\n      const { prompt: promptRaw, modelOverride } = resolvePromptAndModelOverride(\n        record,\n        DEFAULT_PROMPT,\n      );\n      const maxBytesMb = typeof record.maxBytesMb === 'number' ? record.maxBytesMb : undefined;\n      const maxBytes = pickMaxBytes(options.config, maxBytesMb);\n\n      const loadedImages: Array<{ buffer: Buffer; mimeType: string; resolvedImage: string }> = [];\n\n      for (const imageRawInput of imageInputs) {\n        const trimmed = imageRawInput.trim();\n        const imageRaw = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n        if (!imageRaw) {\n          return {\n            content: [{ type: 'text', text: 'Error: empty image entry.' }],\n            details: { error: 'empty_image' },\n          };\n        }\n\n        const looksLikeWindowsDrivePath = /^[a-zA-Z]:[\\\\/]/.test(imageRaw);\n        const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(imageRaw);\n        const isFileUrl = /^file:/i.test(imageRaw);\n        const isHttpUrl = /^https?:\\/\\//i.test(imageRaw);\n        const isDataUrl = /^data:/i.test(imageRaw);\n        if (hasScheme && !looksLikeWindowsDrivePath && !isFileUrl && !isHttpUrl && !isDataUrl) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Unsupported image reference: ${imageRawInput}. Use a path, file://, data:, or http(s) URL.`,\n              },\n            ],\n            details: { error: 'unsupported_image_reference', image: imageRawInput },\n          };\n        }\n\n        try {\n          const media = await loadImageForToolInput(imageRaw, {\n            maxBytes,\n            workspace: options.workspace,\n            localRoots,\n          });\n          loadedImages.push({\n            buffer: media.buffer,\n            mimeType: media.mimeType,\n            resolvedImage: imageRaw,\n          });\n        } catch (e) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Failed to load image (${imageRawInput}): ${e instanceof Error ? e.message : String(e)}`,\n              },\n            ],\n            details: { error: 'load_failed', image: imageRawInput },\n          };\n        }\n      }\n\n      const runResult = await runWithImageModelFallback({\n        toolConfig: imageModelConfig,\n        modelOverride,\n        run: async (modelRef) => {\n          const { text, provider, model } = await describeImages({\n            modelRef,\n            prompt: promptRaw,\n            images: loadedImages.map((img) => ({ buffer: img.buffer, mimeType: img.mimeType })),\n            timeoutMs: 60_000,\n          });\n          return { text, provider, model };\n        },\n      });\n\n      const { result: inner, attempts } = runResult;\n      const result = {\n        text: inner.text,\n        provider: inner.provider,\n        model: inner.model,\n        attempts,\n      };\n\n      const imageDetails =\n        loadedImages.length === 1\n          ? { image: loadedImages[0].resolvedImage }\n          : {\n              images: loadedImages.map((img) => ({ image: img.resolvedImage })),\n            };\n\n      return buildImageToolTextResult(result, imageDetails);\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"image-tool.js","names":[],"sources":["../../../../src/agent/tools/image-tool.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport { describeImages } from '../image/understanding/runtime.js';\nimport { buildImageToolTextResult, resolvePromptAndModelOverride } from '../image/image-helpers.js';\nimport { runWithImageModelFallback } from '../image/image-model-fallback.js';\nimport { loadImageForToolInput } from '../image/load-image-media.js';\nimport { resolveImageModelConfigForTool } from '../image/tool-model-config.js';\n\nconst DEFAULT_PROMPT = 'Describe the image.';\nconst DEFAULT_MAX_IMAGES = 20;\n\nexport { resolveImageModelConfigForTool } from '../image/tool-model-config.js';\n\nfunction pickMaxBytes(cfg?: Config, maxBytesMb?: number): number {\n  if (typeof maxBytesMb === 'number' && Number.isFinite(maxBytesMb) && maxBytesMb > 0) {\n    return Math.floor(maxBytesMb * 1024 * 1024);\n  }\n  return 20 * 1024 * 1024;\n}\n\nexport function createImageTool(options: {\n  config?: Config;\n  workspace: string;\n  /** When true, session model already receives images in the user message. */\n  modelHasVision?: boolean;\n}): AgentTool<any, Record<string, unknown>> | null {\n  const imageModelConfig = resolveImageModelConfigForTool({ cfg: options.config });\n  if (!imageModelConfig) {\n    return null;\n  }\n\n  const description = options.modelHasVision\n    ? 'Analyze one or more images with a vision model. Use `image` for a single path/URL, or `images` for multiple (up to 20). Only use when images were NOT already in the user message.'\n    : 'Analyze one or more images using the available image model. Use `image` or `images` for paths/URLs; optional `prompt` for what to extract.';\n\n  const localRoots = [options.workspace];\n\n  return {\n    name: 'image',\n    label: 'Image',\n    description,\n    parameters: Type.Object({\n      prompt: Type.Optional(Type.String()),\n      image: Type.Optional(Type.String({ description: 'Single image path or URL.' })),\n      images: Type.Optional(\n        Type.Array(Type.String(), {\n          description: 'Multiple image paths or URLs (up to maxImages, default 20).',\n        }),\n      ),\n      model: Type.Optional(Type.String({ description: 'Optional provider/model override.' })),\n      maxBytesMb: Type.Optional(Type.Number()),\n      maxImages: Type.Optional(Type.Number()),\n    }),\n    async execute(\n      _toolCallId: string,\n      args: Record<string, unknown>,\n    ): Promise<AgentToolResult<Record<string, unknown>>> {\n      const record = args && typeof args === 'object' ? args : {};\n\n      const imageCandidates: string[] = [];\n      if (typeof record.image === 'string') {\n        imageCandidates.push(record.image);\n      }\n      if (Array.isArray(record.images)) {\n        imageCandidates.push(...record.images.filter((v): v is string => typeof v === 'string'));\n      }\n\n      const seenImages = new Set<string>();\n      const imageInputs: string[] = [];\n      for (const candidate of imageCandidates) {\n        const trimmedCandidate = candidate.trim();\n        const normalizedForDedupe = trimmedCandidate.startsWith('@')\n          ? trimmedCandidate.slice(1).trim()\n          : trimmedCandidate;\n        if (!normalizedForDedupe || seenImages.has(normalizedForDedupe)) {\n          continue;\n        }\n        seenImages.add(normalizedForDedupe);\n        imageInputs.push(trimmedCandidate);\n      }\n\n      if (imageInputs.length === 0) {\n        return {\n          content: [{ type: 'text', text: 'Error: provide `image` or `images`.' }],\n          details: { error: 'missing_image' },\n        };\n      }\n\n      const maxImagesRaw = typeof record.maxImages === 'number' ? record.maxImages : undefined;\n      const maxImages =\n        typeof maxImagesRaw === 'number' && Number.isFinite(maxImagesRaw) && maxImagesRaw > 0\n          ? Math.floor(maxImagesRaw)\n          : DEFAULT_MAX_IMAGES;\n      if (imageInputs.length > maxImages) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Too many images: ${imageInputs.length} (max ${maxImages}).`,\n            },\n          ],\n          details: { error: 'too_many_images', count: imageInputs.length, max: maxImages },\n        };\n      }\n\n      const { prompt: promptRaw, modelOverride } = resolvePromptAndModelOverride(\n        record,\n        DEFAULT_PROMPT,\n      );\n      const maxBytesMb = typeof record.maxBytesMb === 'number' ? record.maxBytesMb : undefined;\n      const maxBytes = pickMaxBytes(options.config, maxBytesMb);\n\n      const loadedImages: Array<{ buffer: Buffer; mimeType: string; resolvedImage: string }> = [];\n\n      for (const imageRawInput of imageInputs) {\n        const trimmed = imageRawInput.trim();\n        const imageRaw = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n        if (!imageRaw) {\n          return {\n            content: [{ type: 'text', text: 'Error: empty image entry.' }],\n            details: { error: 'empty_image' },\n          };\n        }\n\n        const looksLikeWindowsDrivePath = /^[a-zA-Z]:[\\\\/]/.test(imageRaw);\n        const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(imageRaw);\n        const isFileUrl = /^file:/i.test(imageRaw);\n        const isHttpUrl = /^https?:\\/\\//i.test(imageRaw);\n        const isDataUrl = /^data:/i.test(imageRaw);\n        if (hasScheme && !looksLikeWindowsDrivePath && !isFileUrl && !isHttpUrl && !isDataUrl) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Unsupported image reference: ${imageRawInput}. Use a path, file://, data:, or http(s) URL.`,\n              },\n            ],\n            details: { error: 'unsupported_image_reference', image: imageRawInput },\n          };\n        }\n\n        try {\n          const media = await loadImageForToolInput(imageRaw, {\n            maxBytes,\n            workspace: options.workspace,\n            localRoots,\n          });\n          loadedImages.push({\n            buffer: media.buffer,\n            mimeType: media.mimeType,\n            resolvedImage: imageRaw,\n          });\n        } catch (e) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Failed to load image (${imageRawInput}): ${e instanceof Error ? e.message : String(e)}`,\n              },\n            ],\n            details: { error: 'load_failed', image: imageRawInput },\n          };\n        }\n      }\n\n      const runResult = await runWithImageModelFallback({\n        toolConfig: imageModelConfig,\n        modelOverride,\n        run: async (modelRef) => {\n          const { text, provider, model } = await describeImages({\n            modelRef,\n            prompt: promptRaw,\n            images: loadedImages.map((img) => ({ buffer: img.buffer, mimeType: img.mimeType })),\n            timeoutMs: 60_000,\n          });\n          return { text, provider, model };\n        },\n      });\n\n      const { result: inner, attempts } = runResult;\n      const result = {\n        text: inner.text,\n        provider: inner.provider,\n        model: inner.model,\n        attempts,\n      };\n\n      const imageDetails =\n        loadedImages.length === 1\n          ? { image: loadedImages[0].resolvedImage }\n          : {\n              images: loadedImages.map((img) => ({ image: img.resolvedImage })),\n            };\n\n      return buildImageToolTextResult(result, imageDetails);\n    },\n  } as any;\n}\n"],"mappings":"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"}

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

@@ -11,6 +11,7 @@ export { findTool, createFindTool, type FindToolInput, type FindToolDetails, } f
 export { createWebSearchTool, createWebFetchTool } from './web.js';
 export { createWebExtractTool, stripHtmlBoilerplate, DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, } from './web-extract.js';
 export { createMessageTool } from './communication.js';
+export { createComposioExecuteTool } from './composio-tool.js';
 export { createSendMediaTool } from './send-media.js';
 export { createReadMediaTool } from './media-read-tool.js';
 export { createCreateShareTool, isShareToolAvailable, type CreateShareToolDeps, } from './create-share-tool.js';

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

@@ -13,6 +13,7 @@ import { createFindTool, findTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, createWebExtractTool, stripHtmlBoilerplate } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
+import { createComposioExecuteTool } from "./composio-tool.js";
 import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
@@ -34,4 +35,4 @@ import { createToolManualTool } from "./tool-manual-tool.js";
 import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, assertBrowserUrlAllowed, buildSandboxToolMap, createClarifyTool, createCreateShareTool, createCronjobTool, createCuratedMemoryTool, createDelegateTool, createDreamingTool, createEditFileTool, createExecuteCodeTool, createFindTool, createGoalTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createShellTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createTodoTool, createToolManualTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, editFileTool, findTool, formatSize, fuzzyFindText, generateDiffString, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, restoreLineEndings, scanCronPrompt, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, assertBrowserUrlAllowed, buildSandboxToolMap, createClarifyTool, createComposioExecuteTool, createCreateShareTool, createCronjobTool, createCuratedMemoryTool, createDelegateTool, createDreamingTool, createEditFileTool, createExecuteCodeTool, createFindTool, createGoalTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createShellTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createTodoTool, createToolManualTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, editFileTool, findTool, formatSize, fuzzyFindText, generateDiffString, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, restoreLineEndings, scanCronPrompt, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };