@xopcai/xopc 0.0.123 → 0.0.125

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

@@ -51,21 +51,24 @@ export interface ToolFactoryDeps {
     } | undefined;
     /** After skill_manage mutates disk, reload skills + refresh agent prompts (optional). */
     onSkillsFilesystemMutate?: () => void;
-    /** Names registered via skill_view for shell env passthrough. */
+    /** Names registered via skill_view for command env passthrough. */
     getSkillPassthroughEnvVarNames?: () => string[];
     /** Add declared env names for the current session (no values stored). */
     registerSkillEnvPassthrough?: (names: string[]) => void;
 }
 export interface CreateCoreToolsOptions {
-    /** Workspace root for file/shell tools (defaults to factory workspace). */
+    /** Workspace root for file/command tools (defaults to factory workspace). */
     workspace?: string;
     /** Canonical `agents/<id>/profile/`: bare SOUL.md / IDENTITY.md resolve here after the workspace. */
     profileMarkdownRoot?: string;
-    /** Tool `name` values to omit (e.g. `shell`, `extensions` for extension tools). */
+    /** Tool `name` values to omit (e.g. `exec_command`, `extensions` for extension tools). */
     disabledTools?: Set<string>;
     /** Optional primary model for image tool heuristics. */
     getPrimaryModel?: () => Model<Api>;
     getMemoryManager?: () => MemoryManager;
+    /** Agent-scoped memories directory used for dreaming state (`agents/<id>/memories`). */
+    dreamingRoot?: string;
+    agentId?: string;
     /** When set, registers `skills_list` and `skill_view` bound to this workspace\'s skills. */
     getSkillManager?: () => SkillManager;
 }

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

@@ -2,9 +2,9 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
-import { createEditFileTool } from "./edit.js";
 import { createListDirTool } from "./list-dir.js";
-import { createShellTool } from "./shell.js";
+import { createExecCommandTool } from "./exec-command.js";
+import { createApplyPatchTool } from "./apply-patch.js";
 import { createMemoryGetTool, createMemorySearchTool } from "./memory-tool.js";
 import { createCuratedMemoryTool } from "./curated-memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
@@ -18,6 +18,7 @@ import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
 import { createTodoTool } from "./todo-tool.js";
+import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createDreamingTool } from "./dreaming-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
@@ -40,6 +41,7 @@ import { createImageGenerateTool } from "./image-generate-tool.js";
 import "./index.js";
 import { shouldRegisterCuratedMemoryTool } from "../memory/memory-config.js";
 import { createBrowserUseTool } from "./browser/tool/browser-use-tool.js";
+import { resolveDreamingRootForAgent } from "../memory/dreaming/scope.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { createTextToSpeechTool } from "./tts-tool.js";
@@ -151,6 +153,7 @@ var AgentToolsFactory = class {
 		const primary = getPrimary?.();
 		const modelHasVision = primary?.input?.includes("image") ?? false;
 		const cfg = this.deps.getConfig?.();
+		const dreamingRoot = options?.dreamingRoot ?? (cfg ? resolveDreamingRootForAgent(cfg, options?.agentId) : workspace);
 		const browserEnabled = cfg?.browser?.enabled !== false;
 		const recordGoalEvidence = createGoalEvidenceRecorder({ getSessionKey: () => this.deps.getCurrentContext()?.sessionKey });
 		const optionalTools = [
@@ -170,10 +173,7 @@ var AgentToolsFactory = class {
 			profileMarkdownRoot: options?.profileMarkdownRoot,
 			recordGoalEvidence
 		});
-		const editTool = createEditFileTool(workspace, {
-			profileMarkdownRoot: options?.profileMarkdownRoot,
-			recordGoalEvidence
-		});
+		const applyPatchTool = createApplyPatchTool(workspace, { recordGoalEvidence });
 		const listDir = createListDirTool(workspace);
 		const grep = createGrepTool(workspace);
 		const find = createFindTool(workspace);
@@ -181,7 +181,9 @@ var AgentToolsFactory = class {
 			createSessionStatusTool(),
 			createDreamingTool({
 				getWorkspace: () => workspace,
-				getConfig: () => this.deps.getConfig?.()
+				getDreamingRoot: () => dreamingRoot,
+				getConfig: () => this.deps.getConfig?.(),
+				getAgentId: () => options?.agentId
 			}),
 			createToolManualTool(),
 			createClarifyTool({ resolveAskUser: () => {
@@ -193,6 +195,7 @@ var AgentToolsFactory = class {
 				return (r) => req(ctx.sessionKey, r);
 			} }),
 			createTodoTool({ getSessionKey: () => this.deps.getCurrentContext()?.sessionKey }),
+			createUpdatePlanTool(),
 			...getSkillMgr ? [
 				createSkillsListTool({
 					getSkillManager: getSkillMgr,
@@ -211,11 +214,11 @@ var AgentToolsFactory = class {
 			] : [],
 			readTool,
 			writeTool,
-			editTool,
+			applyPatchTool,
 			listDir,
 			grep,
 			find,
-			createShellTool(workspace, {
+			createExecCommandTool(workspace, {
 				getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,
 				recordGoalEvidence
 			}),
@@ -236,9 +239,11 @@ var AgentToolsFactory = class {
 			})] : [],
 			...getMemMgr ? [createMemorySearchTool({
 				workspaceDir: workspace,
+				dreamingRoot,
 				getMemoryManager: () => getMemMgr()
 			}), createMemoryGetTool({
 				workspaceDir: workspace,
+				dreamingRoot,
 				getMemoryManager: () => getMemMgr()
 			})] : [],
 			...getMemMgr && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.()) ? [createCuratedMemoryTool(() => getMemMgr())] : [],

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  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  createAutomationTool,\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 type { AutomationService } from '../../automations/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 `automation` tool. */\n  getAutomationService?: () => AutomationService | 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.getAutomationService\n        ? [\n            createAutomationTool({\n              getAutomationService: this.deps.getAutomationService,\n            }),\n          ]\n        : []),\n      createGoalTool({\n        getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\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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"}
+{"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  createApplyPatchTool,\n  createListDirTool,\n  createGrepTool,\n  createFindTool,\n  createExecCommandTool,\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  createUpdatePlanTool,\n  createSessionStatusTool,\n  createDreamingTool,\n  createClarifyTool,\n  createToolManualTool,\n  createGoalTool,\n  createAutomationTool,\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 { resolveDreamingRootForAgent } from '../memory/dreaming/scope.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport type { AutomationService } from '../../automations/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 `automation` tool. */\n  getAutomationService?: () => AutomationService | 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 command 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/command 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. `exec_command`, `extensions` for extension tools). */\n  disabledTools?: Set<string>;\n  /** Optional primary model for image tool heuristics. */\n  getPrimaryModel?: () => Model<Api>;\n  getMemoryManager?: () => MemoryManager;\n  /** Agent-scoped memories directory used for dreaming state (`agents/<id>/memories`). */\n  dreamingRoot?: string;\n  agentId?: string;\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 dreamingRoot = options?.dreamingRoot ?? (cfg ? resolveDreamingRootForAgent(cfg, options?.agentId) : workspace);\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 applyPatchTool = createApplyPatchTool(workspace, { recordGoalEvidence });\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        getDreamingRoot: () => dreamingRoot,\n        getConfig: () => this.deps.getConfig?.(),\n        getAgentId: () => options?.agentId,\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      createUpdatePlanTool(),\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      applyPatchTool,\n      listDir,\n      grep,\n      find,\n      createExecCommandTool(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, dreamingRoot, getMemoryManager: () => getMemMgr() }),\n            createMemoryGetTool({ workspaceDir: workspace, dreamingRoot, 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.getAutomationService\n        ? [\n            createAutomationTool({\n              getAutomationService: this.deps.getAutomationService,\n            }),\n          ]\n        : []),\n      createGoalTool({\n        getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\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                  agentId: options?.agentId ?? childOpts.agentId,\n                  dreamingRoot: options?.dreamingRoot,\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/find.js

@@ -20,6 +20,8 @@ function createFindTool(cwd) {
 		label: "📁 find",
 		description: "Find files by glob pattern (e.g., *.ts, **/*.json).",
 		parameters: findSchema,
+		supportsParallel: true,
+		idempotent: true,
 		execute: async (_toolCallId, params, signal) => {
 			try {
 				const p = params;

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

@@ -1 +1 @@
-{"version":3,"file":"find.js","names":[],"sources":["../../../../src/agent/tools/find.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { existsSync } from 'fs';\nimport { globSync } from 'glob';\nimport path from 'path';\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from './truncate.js';\nimport { resolveToCwd } from '../../utils/helpers.js';\n\nconst findSchema = Type.Object({\n\tpattern: Type.String({\n\t\tdescription: \"Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'\",\n\t}),\n\tpath: Type.Optional(Type.String({ description: 'Directory to search in (default: current directory)' })),\n\tlimit: Type.Optional(Type.Number({ description: 'Maximum number of results (default: 1000)' })),\n});\n\nexport type FindToolInput = { pattern: string; path?: string; limit?: number };\n\nconst DEFAULT_LIMIT = 1000;\n\nexport interface FindToolDetails {\n\ttruncation?: TruncationResult;\n\tresultLimitReached?: number;\n}\n\n/**\n * Find tool - Search for files by glob pattern\n */\nexport function createFindTool(cwd: string): AgentTool {\n\treturn {\n\t\tname: 'find',\n\t\tlabel: '📁 find',\n\t\tdescription: 'Find files by glob pattern (e.g., *.ts, **/*.json).',\n\t\tparameters: findSchema,\n\t\texecute: async (\n\t\t\t_toolCallId: string,\n\t\t\tparams: any,\n\t\t\tsignal?: AbortSignal\n\t\t): Promise<AgentToolResult<FindToolDetails>> => {\n\t\t\ttry {\n\t\t\t\tconst p = params as FindToolInput;\n\t\t\t\tconst searchPath = resolveToCwd(p.path || '.', cwd);\n\t\t\t\tconst effectiveLimit = p.limit || DEFAULT_LIMIT;\n\n\t\t\t\tif (!existsSync(searchPath)) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: `Error: Path not found: ${searchPath}` }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: 'Operation aborted' }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst filePaths = globSync(p.pattern, {\n\t\t\t\t\tcwd: searchPath,\n\t\t\t\t\tdot: true,\n\t\t\t\t\tignore: ['**/node_modules/**', '**/.git/**'],\n\t\t\t\t});\n\n\t\t\t\tif (filePaths.length === 0) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: 'No files found matching pattern' }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\t// Relativize paths\n\t\t\t\tconst relativized = filePaths.map((p) => {\n\t\t\t\t\tif (p.startsWith(searchPath)) {\n\t\t\t\t\t\treturn p.slice(searchPath.length + 1);\n\t\t\t\t\t}\n\t\t\t\t\treturn path.relative(searchPath, p);\n\t\t\t\t});\n\n\t\t\t\t// Sort results\n\t\t\t\trelativized.sort();\n\n\t\t\t\tconst resultLimitReached = relativized.length >= effectiveLimit;\n\t\t\t\tconst outputLines = resultLimitReached ? relativized.slice(0, effectiveLimit) : relativized;\n\t\t\t\tconst rawOutput = outputLines.join('\\n');\n\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\n\n\t\t\t\tlet resultOutput = truncation.content;\n\t\t\t\tconst details: FindToolDetails = {};\n\t\t\t\tconst notices: string[] = [];\n\n\t\t\t\tif (resultLimitReached) {\n\t\t\t\t\tnotices.push(`${effectiveLimit} results limit reached`);\n\t\t\t\t\tdetails.resultLimitReached = effectiveLimit;\n\t\t\t\t}\n\n\t\t\t\tif (truncation.truncated) {\n\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\n\t\t\t\t\tdetails.truncation = truncation;\n\t\t\t\t}\n\n\t\t\t\tif (notices.length > 0) {\n\t\t\t\t\tresultOutput += `\\n\\n[${notices.join('. ')}]`;\n\t\t\t\t}\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: 'text', text: resultOutput }],\n\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\n\t\t\t\t};\n\t\t\t} catch (error) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\t\ttext: `Error during find: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t} as any;\n}\n\n/** Default find tool using process.cwd() */\nexport const findTool: AgentTool = createFindTool(process.cwd());\n"],"mappings":";;;;;;;AAQA,MAAM,aAAa,KAAK,OAAO;CAC9B,SAAS,KAAK,OAAO,EACpB,aAAa,gFACb,CAAC;CACF,MAAM,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,uDAAuD,CAAC,CAAC;CACxG,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,6CAA6C,CAAC,CAAC;CAC/F,CAAC;AAIF,MAAM,gBAAgB;;;;AAUtB,SAAgB,eAAe,KAAwB;AACtD,QAAO;EACN,MAAM;EACN,OAAO;EACP,aAAa;EACb,YAAY;EACZ,SAAS,OACR,aACA,QACA,WAC+C;AAC/C,OAAI;IACH,MAAM,IAAI;IACV,MAAM,aAAa,aAAa,EAAE,QAAQ,KAAK,IAAI;IACnD,MAAM,iBAAiB,EAAE,SAAS;AAElC,QAAI,CAAC,WAAW,WAAW,CAC1B,QAAO;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,0BAA0B;MAAc,CAAC;KACzE,SAAS,EAAE;KACX;AAGF,QAAI,QAAQ,QACX,QAAO;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAqB,CAAC;KACtD,SAAS,EAAE;KACX;IAGF,MAAM,YAAY,SAAS,EAAE,SAAS;KACrC,KAAK;KACL,KAAK;KACL,QAAQ,CAAC,sBAAsB,aAAa;KAC5C,CAAC;AAEF,QAAI,UAAU,WAAW,EACxB,QAAO;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAmC,CAAC;KACpE,SAAS,EAAE;KACX;IAIF,MAAM,cAAc,UAAU,KAAK,MAAM;AACxC,SAAI,EAAE,WAAW,WAAW,CAC3B,QAAO,EAAE,MAAM,WAAW,SAAS,EAAE;AAEtC,YAAO,KAAK,SAAS,YAAY,EAAE;MAClC;AAGF,gBAAY,MAAM;IAElB,MAAM,qBAAqB,YAAY,UAAU;IAGjD,MAAM,aAAa,cAFC,qBAAqB,YAAY,MAAM,GAAG,eAAe,GAAG,aAClD,KAAK,KACM,EAAE,EAAE,UAAU,OAAO,kBAAkB,CAAC;IAEjF,IAAI,eAAe,WAAW;IAC9B,MAAM,UAA2B,EAAE;IACnC,MAAM,UAAoB,EAAE;AAE5B,QAAI,oBAAoB;AACvB,aAAQ,KAAK,GAAG,eAAe,wBAAwB;AACvD,aAAQ,qBAAqB;;AAG9B,QAAI,WAAW,WAAW;AACzB,aAAQ,KAAK,GAAG,WAAW,kBAAkB,CAAC,gBAAgB;AAC9D,aAAQ,aAAa;;AAGtB,QAAI,QAAQ,SAAS,EACpB,iBAAgB,QAAQ,QAAQ,KAAK,KAAK,CAAC;AAG5C,WAAO;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAc,CAAC;KAC/C,SAAS,OAAO,KAAK,QAAQ,CAAC,SAAS,IAAI,UAAU,KAAA;KACrD;YACO,OAAO;AACf,WAAO;KACN,SAAS,CACR;MACC,MAAM;MACN,MAAM,sBAAsB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;MAClF,CACD;KACD,SAAS,EAAE;KACX;;;EAGH;;;AAIF,MAAa,WAAsB,eAAe,QAAQ,KAAK,CAAC"}
+{"version":3,"file":"find.js","names":[],"sources":["../../../../src/agent/tools/find.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { existsSync } from 'fs';\nimport { globSync } from 'glob';\nimport path from 'path';\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from './truncate.js';\nimport { resolveToCwd } from '../../utils/helpers.js';\n\nconst findSchema = Type.Object({\n\tpattern: Type.String({\n\t\tdescription: \"Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'\",\n\t}),\n\tpath: Type.Optional(Type.String({ description: 'Directory to search in (default: current directory)' })),\n\tlimit: Type.Optional(Type.Number({ description: 'Maximum number of results (default: 1000)' })),\n});\n\nexport type FindToolInput = { pattern: string; path?: string; limit?: number };\n\nconst DEFAULT_LIMIT = 1000;\n\nexport interface FindToolDetails {\n\ttruncation?: TruncationResult;\n\tresultLimitReached?: number;\n}\n\n/**\n * Find tool - Search for files by glob pattern\n */\nexport function createFindTool(cwd: string): AgentTool {\n\treturn {\n\t\tname: 'find',\n\t\tlabel: '📁 find',\n\t\tdescription: 'Find files by glob pattern (e.g., *.ts, **/*.json).',\n\t\tparameters: findSchema,\n\t\tsupportsParallel: true,\n\t\tidempotent: true,\n\t\texecute: async (\n\t\t\t_toolCallId: string,\n\t\t\tparams: any,\n\t\t\tsignal?: AbortSignal\n\t\t): Promise<AgentToolResult<FindToolDetails>> => {\n\t\t\ttry {\n\t\t\t\tconst p = params as FindToolInput;\n\t\t\t\tconst searchPath = resolveToCwd(p.path || '.', cwd);\n\t\t\t\tconst effectiveLimit = p.limit || DEFAULT_LIMIT;\n\n\t\t\t\tif (!existsSync(searchPath)) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: `Error: Path not found: ${searchPath}` }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: 'Operation aborted' }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst filePaths = globSync(p.pattern, {\n\t\t\t\t\tcwd: searchPath,\n\t\t\t\t\tdot: true,\n\t\t\t\t\tignore: ['**/node_modules/**', '**/.git/**'],\n\t\t\t\t});\n\n\t\t\t\tif (filePaths.length === 0) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: 'No files found matching pattern' }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\t// Relativize paths\n\t\t\t\tconst relativized = filePaths.map((p) => {\n\t\t\t\t\tif (p.startsWith(searchPath)) {\n\t\t\t\t\t\treturn p.slice(searchPath.length + 1);\n\t\t\t\t\t}\n\t\t\t\t\treturn path.relative(searchPath, p);\n\t\t\t\t});\n\n\t\t\t\t// Sort results\n\t\t\t\trelativized.sort();\n\n\t\t\t\tconst resultLimitReached = relativized.length >= effectiveLimit;\n\t\t\t\tconst outputLines = resultLimitReached ? relativized.slice(0, effectiveLimit) : relativized;\n\t\t\t\tconst rawOutput = outputLines.join('\\n');\n\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\n\n\t\t\t\tlet resultOutput = truncation.content;\n\t\t\t\tconst details: FindToolDetails = {};\n\t\t\t\tconst notices: string[] = [];\n\n\t\t\t\tif (resultLimitReached) {\n\t\t\t\t\tnotices.push(`${effectiveLimit} results limit reached`);\n\t\t\t\t\tdetails.resultLimitReached = effectiveLimit;\n\t\t\t\t}\n\n\t\t\t\tif (truncation.truncated) {\n\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\n\t\t\t\t\tdetails.truncation = truncation;\n\t\t\t\t}\n\n\t\t\t\tif (notices.length > 0) {\n\t\t\t\t\tresultOutput += `\\n\\n[${notices.join('. ')}]`;\n\t\t\t\t}\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: 'text', text: resultOutput }],\n\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\n\t\t\t\t};\n\t\t\t} catch (error) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\t\ttext: `Error during find: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t} as any;\n}\n\n/** Default find tool using process.cwd() */\nexport const findTool: AgentTool = createFindTool(process.cwd());\n"],"mappings":";;;;;;;AAQA,MAAM,aAAa,KAAK,OAAO;CAC9B,SAAS,KAAK,OAAO,EACpB,aAAa,gFACb,CAAC;CACF,MAAM,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,uDAAuD,CAAC,CAAC;CACxG,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,6CAA6C,CAAC,CAAC;CAC/F,CAAC;AAIF,MAAM,gBAAgB;;;;AAUtB,SAAgB,eAAe,KAAwB;AACtD,QAAO;EACN,MAAM;EACN,OAAO;EACP,aAAa;EACb,YAAY;EACZ,kBAAkB;EAClB,YAAY;EACZ,SAAS,OACR,aACA,QACA,WAC+C;AAC/C,OAAI;IACH,MAAM,IAAI;IACV,MAAM,aAAa,aAAa,EAAE,QAAQ,KAAK,IAAI;IACnD,MAAM,iBAAiB,EAAE,SAAS;AAElC,QAAI,CAAC,WAAW,WAAW,CAC1B,QAAO;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,0BAA0B;MAAc,CAAC;KACzE,SAAS,EAAE;KACX;AAGF,QAAI,QAAQ,QACX,QAAO;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAqB,CAAC;KACtD,SAAS,EAAE;KACX;IAGF,MAAM,YAAY,SAAS,EAAE,SAAS;KACrC,KAAK;KACL,KAAK;KACL,QAAQ,CAAC,sBAAsB,aAAa;KAC5C,CAAC;AAEF,QAAI,UAAU,WAAW,EACxB,QAAO;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAmC,CAAC;KACpE,SAAS,EAAE;KACX;IAIF,MAAM,cAAc,UAAU,KAAK,MAAM;AACxC,SAAI,EAAE,WAAW,WAAW,CAC3B,QAAO,EAAE,MAAM,WAAW,SAAS,EAAE;AAEtC,YAAO,KAAK,SAAS,YAAY,EAAE;MAClC;AAGF,gBAAY,MAAM;IAElB,MAAM,qBAAqB,YAAY,UAAU;IAGjD,MAAM,aAAa,cAFC,qBAAqB,YAAY,MAAM,GAAG,eAAe,GAAG,aAClD,KAAK,KACM,EAAE,EAAE,UAAU,OAAO,kBAAkB,CAAC;IAEjF,IAAI,eAAe,WAAW;IAC9B,MAAM,UAA2B,EAAE;IACnC,MAAM,UAAoB,EAAE;AAE5B,QAAI,oBAAoB;AACvB,aAAQ,KAAK,GAAG,eAAe,wBAAwB;AACvD,aAAQ,qBAAqB;;AAG9B,QAAI,WAAW,WAAW;AACzB,aAAQ,KAAK,GAAG,WAAW,kBAAkB,CAAC,gBAAgB;AAC9D,aAAQ,aAAa;;AAGtB,QAAI,QAAQ,SAAS,EACpB,iBAAgB,QAAQ,QAAQ,KAAK,KAAK,CAAC;AAG5C,WAAO;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAc,CAAC;KAC/C,SAAS,OAAO,KAAK,QAAQ,CAAC,SAAS,IAAI,UAAU,KAAA;KACrD;YACO,OAAO;AACf,WAAO;KACN,SAAS,CACR;MACC,MAAM;MACN,MAAM,sBAAsB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;MAClF,CACD;KACD,SAAS,EAAE;KACX;;;EAGH;;;AAIF,MAAa,WAAsB,eAAe,QAAQ,KAAK,CAAC"}

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

@@ -39,6 +39,8 @@ function createGrepTool(cwd) {
 		label: "🔍 grep",
 		description: "Search file contents for a pattern (regex or literal).",
 		parameters: grepSchema,
+		supportsParallel: true,
+		idempotent: true,
 		execute: async (_toolCallId, params, signal) => {
 			try {
 				const p = params;

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

@@ -1 +1 @@
-{"version":3,"file":"grep.js","names":[],"sources":["../../../../src/agent/tools/grep.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { readFileSync, existsSync, statSync } from 'fs';\nimport { globSync } from 'glob';\nimport path from 'path';\nimport {\n\tDEFAULT_MAX_BYTES,\n\tformatSize,\n\tGREP_MAX_LINE_LENGTH,\n\ttype TruncationResult,\n\ttruncateHead,\n\ttruncateLine,\n} from './truncate.js';\nimport { resolveToCwd } from '../../utils/helpers.js';\n\nconst grepSchema = Type.Object({\n\tpattern: Type.String({ description: 'Search pattern (regex or literal string)' }),\n\tpath: Type.Optional(Type.String({ description: 'Directory or file to search (default: current directory)' })),\n\tglob: Type.Optional(Type.String({ description: \"Filter files by glob pattern, e.g. '*.ts'\" })),\n\tignoreCase: Type.Optional(Type.Boolean({ description: 'Case-insensitive search (default: false)' })),\n\tliteral: Type.Optional(Type.Boolean({ description: 'Treat pattern as literal string instead of regex (default: false)' })),\n\tcontext: Type.Optional(Type.Number({ description: 'Number of lines to show before and after each match (default: 0)' })),\n\tlimit: Type.Optional(Type.Number({ description: 'Maximum number of matches to return (default: 100)' })),\n});\n\nexport type GrepToolInput = {\n\tpattern: string;\n\tpath?: string;\n\tglob?: string;\n\tignoreCase?: boolean;\n\tliteral?: boolean;\n\tcontext?: number;\n\tlimit?: number;\n};\n\nconst DEFAULT_LIMIT = 100;\n\nexport interface GrepToolDetails {\n\ttruncation?: TruncationResult;\n\tmatchLimitReached?: number;\n\tlinesTruncated?: boolean;\n}\n\n/**\n * Simple grep implementation using Node.js regex\n */\nfunction simpleGrep(\n\tcontent: string,\n\tpattern: string,\n\toptions: { ignoreCase: boolean; literal: boolean }\n): Array<{ lineNumber: number; line: string }> {\n\tconst matches: Array<{ lineNumber: number; line: string }> = [];\n\tconst lines = content.split('\\n');\n\tconst regexPattern = options.literal\n\t\t? pattern.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\t\t: pattern;\n\tconst flags = options.ignoreCase ? 'i' : '';\n\tconst regex = new RegExp(regexPattern, flags);\n\n\tfor (let i = 0; i < lines.length; i++) {\n\t\tif (regex.test(lines[i])) {\n\t\t\tmatches.push({ lineNumber: i + 1, line: lines[i] });\n\t\t}\n\t}\n\n\treturn matches;\n}\n\n/**\n * Grep tool - Search file contents for a pattern\n */\nexport function createGrepTool(cwd: string): AgentTool {\n\treturn {\n\t\tname: 'grep',\n\t\tlabel: '🔍 grep',\n\t\tdescription: 'Search file contents for a pattern (regex or literal).',\n\t\tparameters: grepSchema,\n\t\texecute: async (\n\t\t\t_toolCallId: string,\n\t\t\tparams: any,\n\t\t\tsignal?: AbortSignal\n\t\t): Promise<AgentToolResult<GrepToolDetails>> => {\n\t\t\ttry {\n\t\t\t\tconst p = params as GrepToolInput;\n\t\t\t\tconst searchPath = resolveToCwd(p.path || '.', cwd);\n\t\t\t\t\n\t\t\t\tif (!existsSync(searchPath)) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: `Error: Path not found: ${searchPath}` }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst isDirectory = statSync(searchPath).isDirectory();\n\t\t\t\tconst context = p.context || 0;\n\t\t\t\tconst effectiveLimit = p.limit || DEFAULT_LIMIT;\n\t\t\t\tconst files: string[] = [];\n\n\t\t\t\t// Collect files to search\n\t\t\t\tif (isDirectory) {\n\t\t\t\t\tconst globPattern = p.glob || '**/*';\n\t\t\t\t\tconst filePaths = globSync(globPattern, {\n\t\t\t\t\t\tcwd: searchPath,\n\t\t\t\t\t\tdot: true,\n\t\t\t\t\t\tignore: ['**/node_modules/**', '**/.git/**'],\n\t\t\t\t\t});\n\t\t\t\t\tfiles.push(...filePaths.map(f => path.join(searchPath, f)));\n\t\t\t\t} else {\n\t\t\t\t\tfiles.push(searchPath);\n\t\t\t\t}\n\n\t\t\t\tconst matches: Array<{ file: string; lineNumber: number; line: string }> = [];\n\t\t\t\tlet matchCount = 0;\n\t\t\t\tlet linesTruncated = false;\n\n\t\t\t\t// Search each file\n\t\t\t\tfor (const filePath of files) {\n\t\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcontent: [{ type: 'text', text: 'Operation aborted' }],\n\t\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\n\t\t\t\t\ttry {\n\t\t\t\t\t\tif (!existsSync(filePath)) continue;\n\t\t\t\t\t\tconst content = readFileSync(filePath, 'utf-8');\n\t\t\t\t\t\tconst fileMatches = simpleGrep(content, p.pattern, {\n\t\t\t\t\t\t\tignoreCase: p.ignoreCase || false,\n\t\t\t\t\t\t\tliteral: p.literal || false,\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tfor (const match of fileMatches) {\n\t\t\t\t\t\t\tif (matchCount >= effectiveLimit) break;\n\t\t\t\t\t\t\tmatches.push({ file: filePath, ...match });\n\t\t\t\t\t\t\tmatchCount++;\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Skip files that can't be read\n\t\t\t\t\t}\n\n\t\t\t\t\tif (matchCount >= effectiveLimit) break;\n\t\t\t\t}\n\n\t\t\t\tif (matches.length === 0) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: 'No matches found' }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\t// Format output\n\t\t\t\tconst outputLines: string[] = [];\n\t\t\t\tconst basePath = isDirectory ? searchPath : path.dirname(searchPath);\n\n\t\t\t\tfor (const match of matches) {\n\t\t\t\t\tconst relativePath = path.relative(basePath, match.file);\n\t\t\t\t\tconst { text: truncatedLine, wasTruncated } = truncateLine(match.line);\n\t\t\t\t\tif (wasTruncated) linesTruncated = true;\n\n\t\t\t\t\tif (context > 0) {\n\t\t\t\t\t\t// Add context lines\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst content = readFileSync(match.file, 'utf-8');\n\t\t\t\t\t\t\tconst allLines = content.split('\\n');\n\t\t\t\t\t\t\tconst start = Math.max(1, match.lineNumber - context);\n\t\t\t\t\t\t\tconst end = Math.min(allLines.length, match.lineNumber + context);\n\n\t\t\t\t\t\t\tfor (let i = start; i <= end; i++) {\n\t\t\t\t\t\t\t\tconst lineText = allLines[i - 1] || '';\n\t\t\t\t\t\t\t\tconst { text: truncatedContextLine } = truncateLine(lineText);\n\t\t\t\t\t\t\t\tif (i === match.lineNumber) {\n\t\t\t\t\t\t\t\t\toutputLines.push(`${relativePath}:${i}: ${truncatedContextLine}`);\n\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\toutputLines.push(`${relativePath}-${i}- ${truncatedContextLine}`);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\toutputLines.push(`${relativePath}:${match.lineNumber}: ${truncatedLine}`);\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\toutputLines.push(`${relativePath}:${match.lineNumber}: ${truncatedLine}`);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst rawOutput = outputLines.join('\\n');\n\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\n\n\t\t\t\tlet output = truncation.content;\n\t\t\t\tconst details: GrepToolDetails = {};\n\t\t\t\tconst notices: string[] = [];\n\n\t\t\t\tif (matches.length >= effectiveLimit) {\n\t\t\t\t\tnotices.push(`${effectiveLimit} matches limit reached`);\n\t\t\t\t\tdetails.matchLimitReached = effectiveLimit;\n\t\t\t\t}\n\n\t\t\t\tif (truncation.truncated) {\n\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\n\t\t\t\t\tdetails.truncation = truncation;\n\t\t\t\t}\n\n\t\t\t\tif (linesTruncated) {\n\t\t\t\t\tnotices.push(`Some lines truncated to ${GREP_MAX_LINE_LENGTH} chars`);\n\t\t\t\t\tdetails.linesTruncated = true;\n\t\t\t\t}\n\n\t\t\t\tif (notices.length > 0) {\n\t\t\t\t\toutput += `\\n\\n[${notices.join('. ')}]`;\n\t\t\t\t}\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: 'text', text: output }],\n\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\n\t\t\t\t};\n\t\t\t} catch (error) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\t\ttext: `Error during grep: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t} as any;\n}\n\n/** Default grep tool using process.cwd() */\nexport const grepTool: AgentTool = createGrepTool(process.cwd());\n"],"mappings":"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"}
+{"version":3,"file":"grep.js","names":[],"sources":["../../../../src/agent/tools/grep.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { readFileSync, existsSync, statSync } from 'fs';\nimport { globSync } from 'glob';\nimport path from 'path';\nimport {\n\tDEFAULT_MAX_BYTES,\n\tformatSize,\n\tGREP_MAX_LINE_LENGTH,\n\ttype TruncationResult,\n\ttruncateHead,\n\ttruncateLine,\n} from './truncate.js';\nimport { resolveToCwd } from '../../utils/helpers.js';\n\nconst grepSchema = Type.Object({\n\tpattern: Type.String({ description: 'Search pattern (regex or literal string)' }),\n\tpath: Type.Optional(Type.String({ description: 'Directory or file to search (default: current directory)' })),\n\tglob: Type.Optional(Type.String({ description: \"Filter files by glob pattern, e.g. '*.ts'\" })),\n\tignoreCase: Type.Optional(Type.Boolean({ description: 'Case-insensitive search (default: false)' })),\n\tliteral: Type.Optional(Type.Boolean({ description: 'Treat pattern as literal string instead of regex (default: false)' })),\n\tcontext: Type.Optional(Type.Number({ description: 'Number of lines to show before and after each match (default: 0)' })),\n\tlimit: Type.Optional(Type.Number({ description: 'Maximum number of matches to return (default: 100)' })),\n});\n\nexport type GrepToolInput = {\n\tpattern: string;\n\tpath?: string;\n\tglob?: string;\n\tignoreCase?: boolean;\n\tliteral?: boolean;\n\tcontext?: number;\n\tlimit?: number;\n};\n\nconst DEFAULT_LIMIT = 100;\n\nexport interface GrepToolDetails {\n\ttruncation?: TruncationResult;\n\tmatchLimitReached?: number;\n\tlinesTruncated?: boolean;\n}\n\n/**\n * Simple grep implementation using Node.js regex\n */\nfunction simpleGrep(\n\tcontent: string,\n\tpattern: string,\n\toptions: { ignoreCase: boolean; literal: boolean }\n): Array<{ lineNumber: number; line: string }> {\n\tconst matches: Array<{ lineNumber: number; line: string }> = [];\n\tconst lines = content.split('\\n');\n\tconst regexPattern = options.literal\n\t\t? pattern.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\t\t: pattern;\n\tconst flags = options.ignoreCase ? 'i' : '';\n\tconst regex = new RegExp(regexPattern, flags);\n\n\tfor (let i = 0; i < lines.length; i++) {\n\t\tif (regex.test(lines[i])) {\n\t\t\tmatches.push({ lineNumber: i + 1, line: lines[i] });\n\t\t}\n\t}\n\n\treturn matches;\n}\n\n/**\n * Grep tool - Search file contents for a pattern\n */\nexport function createGrepTool(cwd: string): AgentTool {\n\treturn {\n\t\tname: 'grep',\n\t\tlabel: '🔍 grep',\n\t\tdescription: 'Search file contents for a pattern (regex or literal).',\n\t\tparameters: grepSchema,\n\t\tsupportsParallel: true,\n\t\tidempotent: true,\n\t\texecute: async (\n\t\t\t_toolCallId: string,\n\t\t\tparams: any,\n\t\t\tsignal?: AbortSignal\n\t\t): Promise<AgentToolResult<GrepToolDetails>> => {\n\t\t\ttry {\n\t\t\t\tconst p = params as GrepToolInput;\n\t\t\t\tconst searchPath = resolveToCwd(p.path || '.', cwd);\n\t\t\t\t\n\t\t\t\tif (!existsSync(searchPath)) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: `Error: Path not found: ${searchPath}` }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst isDirectory = statSync(searchPath).isDirectory();\n\t\t\t\tconst context = p.context || 0;\n\t\t\t\tconst effectiveLimit = p.limit || DEFAULT_LIMIT;\n\t\t\t\tconst files: string[] = [];\n\n\t\t\t\t// Collect files to search\n\t\t\t\tif (isDirectory) {\n\t\t\t\t\tconst globPattern = p.glob || '**/*';\n\t\t\t\t\tconst filePaths = globSync(globPattern, {\n\t\t\t\t\t\tcwd: searchPath,\n\t\t\t\t\t\tdot: true,\n\t\t\t\t\t\tignore: ['**/node_modules/**', '**/.git/**'],\n\t\t\t\t\t});\n\t\t\t\t\tfiles.push(...filePaths.map(f => path.join(searchPath, f)));\n\t\t\t\t} else {\n\t\t\t\t\tfiles.push(searchPath);\n\t\t\t\t}\n\n\t\t\t\tconst matches: Array<{ file: string; lineNumber: number; line: string }> = [];\n\t\t\t\tlet matchCount = 0;\n\t\t\t\tlet linesTruncated = false;\n\n\t\t\t\t// Search each file\n\t\t\t\tfor (const filePath of files) {\n\t\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcontent: [{ type: 'text', text: 'Operation aborted' }],\n\t\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\n\t\t\t\t\ttry {\n\t\t\t\t\t\tif (!existsSync(filePath)) continue;\n\t\t\t\t\t\tconst content = readFileSync(filePath, 'utf-8');\n\t\t\t\t\t\tconst fileMatches = simpleGrep(content, p.pattern, {\n\t\t\t\t\t\t\tignoreCase: p.ignoreCase || false,\n\t\t\t\t\t\t\tliteral: p.literal || false,\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tfor (const match of fileMatches) {\n\t\t\t\t\t\t\tif (matchCount >= effectiveLimit) break;\n\t\t\t\t\t\t\tmatches.push({ file: filePath, ...match });\n\t\t\t\t\t\t\tmatchCount++;\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Skip files that can't be read\n\t\t\t\t\t}\n\n\t\t\t\t\tif (matchCount >= effectiveLimit) break;\n\t\t\t\t}\n\n\t\t\t\tif (matches.length === 0) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: 'text', text: 'No matches found' }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\t// Format output\n\t\t\t\tconst outputLines: string[] = [];\n\t\t\t\tconst basePath = isDirectory ? searchPath : path.dirname(searchPath);\n\n\t\t\t\tfor (const match of matches) {\n\t\t\t\t\tconst relativePath = path.relative(basePath, match.file);\n\t\t\t\t\tconst { text: truncatedLine, wasTruncated } = truncateLine(match.line);\n\t\t\t\t\tif (wasTruncated) linesTruncated = true;\n\n\t\t\t\t\tif (context > 0) {\n\t\t\t\t\t\t// Add context lines\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst content = readFileSync(match.file, 'utf-8');\n\t\t\t\t\t\t\tconst allLines = content.split('\\n');\n\t\t\t\t\t\t\tconst start = Math.max(1, match.lineNumber - context);\n\t\t\t\t\t\t\tconst end = Math.min(allLines.length, match.lineNumber + context);\n\n\t\t\t\t\t\t\tfor (let i = start; i <= end; i++) {\n\t\t\t\t\t\t\t\tconst lineText = allLines[i - 1] || '';\n\t\t\t\t\t\t\t\tconst { text: truncatedContextLine } = truncateLine(lineText);\n\t\t\t\t\t\t\t\tif (i === match.lineNumber) {\n\t\t\t\t\t\t\t\t\toutputLines.push(`${relativePath}:${i}: ${truncatedContextLine}`);\n\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\toutputLines.push(`${relativePath}-${i}- ${truncatedContextLine}`);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\toutputLines.push(`${relativePath}:${match.lineNumber}: ${truncatedLine}`);\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\toutputLines.push(`${relativePath}:${match.lineNumber}: ${truncatedLine}`);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst rawOutput = outputLines.join('\\n');\n\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\n\n\t\t\t\tlet output = truncation.content;\n\t\t\t\tconst details: GrepToolDetails = {};\n\t\t\t\tconst notices: string[] = [];\n\n\t\t\t\tif (matches.length >= effectiveLimit) {\n\t\t\t\t\tnotices.push(`${effectiveLimit} matches limit reached`);\n\t\t\t\t\tdetails.matchLimitReached = effectiveLimit;\n\t\t\t\t}\n\n\t\t\t\tif (truncation.truncated) {\n\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\n\t\t\t\t\tdetails.truncation = truncation;\n\t\t\t\t}\n\n\t\t\t\tif (linesTruncated) {\n\t\t\t\t\tnotices.push(`Some lines truncated to ${GREP_MAX_LINE_LENGTH} chars`);\n\t\t\t\t\tdetails.linesTruncated = true;\n\t\t\t\t}\n\n\t\t\t\tif (notices.length > 0) {\n\t\t\t\t\toutput += `\\n\\n[${notices.join('. ')}]`;\n\t\t\t\t}\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: 'text', text: output }],\n\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\n\t\t\t\t};\n\t\t\t} catch (error) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\t\ttext: `Error during grep: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t} as any;\n}\n\n/** Default grep tool using process.cwd() */\nexport const grepTool: AgentTool = createGrepTool(process.cwd());\n"],"mappings":"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"}

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

@@ -1,8 +1,10 @@
+export { getToolMetadata, DEFAULT_TOOL_METADATA, type AgentToolWithMetadata, type ToolMutationScope, type ToolVerificationKind, type XopcToolMetadata, } from './metadata.js';
+export { ToolConcurrencyController, resolveToolLockMode, type ToolLockMode, } from './concurrency.js';
 export { createReadFileTool, type CreateReadFileToolOptions } from './read.js';
 export { createWriteFileTool, writeFileTool } from './write.js';
-export { createEditFileTool, editFileTool, type EditToolDetails } from './edit.js';
 export { createListDirTool, listDirTool } from './list-dir.js';
-export { createShellTool } from './shell.js';
+export { createExecCommandTool, type ExecCommandDetails, type ExecCommandUpdateDetails, } from './exec-command.js';
+export { createApplyPatchTool, type AppliedPatchChange, type ApplyPatchDetails, } from './apply-patch.js';
 export { createMemorySearchTool, createMemoryGetTool, type MemoryToolOptions, } from './memory-tool.js';
 export { createCuratedMemoryTool } from './curated-memory-tool.js';
 export { createSessionSearchTool } from './session-search-tool.js';
@@ -16,6 +18,7 @@ export { createSendMediaTool } from './send-media.js';
 export { createReadMediaTool } from './media-read-tool.js';
 export { createCreateShareTool, isShareToolAvailable, type CreateShareToolDeps, } from './create-share-tool.js';
 export { createTodoTool, TodoStore, type TodoItem, type TodoStatus } from './todo-tool.js';
+export { createUpdatePlanTool, type TurnPlanDetails, type TurnPlanStatus, type TurnPlanStep, } from './update-plan-tool.js';
 export { createSessionStatusTool } from './session-status-tool.js';
 export { createDreamingTool, type DreamingToolDeps } from './dreaming-tool.js';
 export { createClarifyTool, type ClarifyRequestPayload, type GatewayClarifyRequestFn, } from './clarify-tool.js';

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

@@ -1,10 +1,12 @@
+import { DEFAULT_TOOL_METADATA, getToolMetadata } from "./metadata.js";
+import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
 import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, GREP_MAX_LINE_LENGTH, formatSize, truncateHead, truncateLine, truncateTail } from "./truncate.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool, writeFileTool } from "./write.js";
-import { fuzzyFindText, generateDiffString, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings, stripBom } from "./edit-diff.js";
-import { createEditFileTool, editFileTool } from "./edit.js";
 import { createListDirTool, listDirTool } from "./list-dir.js";
-import { createShellTool } from "./shell.js";
+import { createExecCommandTool } from "./exec-command.js";
+import { fuzzyFindText, generateDiffString, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings, stripBom } from "./edit-diff.js";
+import { createApplyPatchTool } from "./apply-patch.js";
 import { createMemoryGetTool, createMemorySearchTool } from "./memory-tool.js";
 import { createCuratedMemoryTool } from "./curated-memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
@@ -18,6 +20,7 @@ import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
 import { TodoStore, createTodoTool } from "./todo-tool.js";
+import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createDreamingTool } from "./dreaming-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
@@ -35,4 +38,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, createAutomationTool, createClarifyTool, createComposioExecuteTool, createCreateShareTool, 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, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createClarifyTool, createComposioExecuteTool, createCreateShareTool, createCuratedMemoryTool, createDelegateTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGoalTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

package/dist/src/agent/tools/list-dir.js

@@ -9,6 +9,8 @@ function createListDirTool(workspace) {
 		description: "List the contents of a directory. Relative paths are under the current agent workspace.",
 		parameters: ListDirSchema,
 		label: "📁 List Directory",
+		supportsParallel: true,
+		idempotent: true,
 		async execute(_toolCallId, params, _signal) {
 			try {
 				return {

package/dist/src/agent/tools/list-dir.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-dir.js","names":["p"],"sources":["../../../../src/agent/tools/list-dir.ts"],"sourcesContent":["// List Directory Tool\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { readdir } from 'fs/promises';\nimport { resolvePathUnderWorkspace } from './tool-paths.js';\n\nconst ListDirSchema = Type.Object({\n  path: Type.String({ description: 'The directory path to list' }),\n});\n\ntype ListDirParams = { path: string };\n\nexport function createListDirTool(workspace: string): AgentTool {\n  return {\n    name: 'list_dir',\n    description: 'List the contents of a directory. Relative paths are under the current agent workspace.',\n    parameters: ListDirSchema,\n    label: '📁 List Directory',\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      try {\n        const p = params as ListDirParams;\n        const target = resolvePathUnderWorkspace(p.path, workspace);\n        const entries = await readdir(target, { withFileTypes: true });\n        const lines = entries.map((e) => {\n          const type = e.isDirectory() ? 'd' : e.isFile() ? 'f' : '?';\n          return `${type} ${e.name}`;\n        });\n        return {\n          content: [{ type: 'text', text: lines.join('\\n') || '(empty)' }],\n          details: {},\n        };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Error listing directory: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          details: {},\n        };\n      }\n    },\n  } as any;\n}\n\nexport const listDirTool: AgentTool = createListDirTool(process.cwd());\n"],"mappings":";;;;AAMA,MAAM,gBAAgB,KAAK,OAAO,EAChC,MAAM,KAAK,OAAO,EAAE,aAAa,8BAA8B,CAAC,EACjE,CAAC;AAIF,SAAgB,kBAAkB,WAA8B;AAC9D,QAAO;EACL,MAAM;EACN,aAAa;EACb,YAAY;EACZ,OAAO;EAEP,MAAM,QACJ,aACA,QACA,SAC8B;AAC9B,OAAI;AAQF,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,OALd,MADQ,QADP,0BAA0BA,OAAE,MAAM,UACb,EAAE,EAAE,eAAe,MAAM,CAAC,EACxC,KAAK,MAAM;AAE/B,cAAO,GADM,EAAE,aAAa,GAAG,MAAM,EAAE,QAAQ,GAAG,MAAM,IACzC,GAAG,EAAE;QAGiB,CAAC,KAAK,KAAK,IAAI;MAAW,CAAC;KAChE,SAAS,EAAE;KACZ;YACM,OAAO;AACd,WAAO;KACL,SAAS,CACP;MACE,MAAM;MACN,MAAM,4BAA4B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;MACzF,CACF;KACD,SAAS,EAAE;KACZ;;;EAGN;;AAGH,MAAa,cAAyB,kBAAkB,QAAQ,KAAK,CAAC"}
+{"version":3,"file":"list-dir.js","names":["p"],"sources":["../../../../src/agent/tools/list-dir.ts"],"sourcesContent":["// List Directory Tool\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { readdir } from 'fs/promises';\nimport { resolvePathUnderWorkspace } from './tool-paths.js';\n\nconst ListDirSchema = Type.Object({\n  path: Type.String({ description: 'The directory path to list' }),\n});\n\ntype ListDirParams = { path: string };\n\nexport function createListDirTool(workspace: string): AgentTool {\n  return {\n    name: 'list_dir',\n    description: 'List the contents of a directory. Relative paths are under the current agent workspace.',\n    parameters: ListDirSchema,\n    label: '📁 List Directory',\n    supportsParallel: true,\n    idempotent: true,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      try {\n        const p = params as ListDirParams;\n        const target = resolvePathUnderWorkspace(p.path, workspace);\n        const entries = await readdir(target, { withFileTypes: true });\n        const lines = entries.map((e) => {\n          const type = e.isDirectory() ? 'd' : e.isFile() ? 'f' : '?';\n          return `${type} ${e.name}`;\n        });\n        return {\n          content: [{ type: 'text', text: lines.join('\\n') || '(empty)' }],\n          details: {},\n        };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Error listing directory: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          details: {},\n        };\n      }\n    },\n  } as any;\n}\n\nexport const listDirTool: AgentTool = createListDirTool(process.cwd());\n"],"mappings":";;;;AAMA,MAAM,gBAAgB,KAAK,OAAO,EAChC,MAAM,KAAK,OAAO,EAAE,aAAa,8BAA8B,CAAC,EACjE,CAAC;AAIF,SAAgB,kBAAkB,WAA8B;AAC9D,QAAO;EACL,MAAM;EACN,aAAa;EACb,YAAY;EACZ,OAAO;EACP,kBAAkB;EAClB,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,SAC8B;AAC9B,OAAI;AAQF,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,OALd,MADQ,QADP,0BAA0BA,OAAE,MAAM,UACb,EAAE,EAAE,eAAe,MAAM,CAAC,EACxC,KAAK,MAAM;AAE/B,cAAO,GADM,EAAE,aAAa,GAAG,MAAM,EAAE,QAAQ,GAAG,MAAM,IACzC,GAAG,EAAE;QAGiB,CAAC,KAAK,KAAK,IAAI;MAAW,CAAC;KAChE,SAAS,EAAE;KACZ;YACM,OAAO;AACd,WAAO;KACL,SAAS,CACP;MACE,MAAM;MACN,MAAM,4BAA4B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;MACzF,CACF;KACD,SAAS,EAAE;KACZ;;;EAGN;;AAGH,MAAa,cAAyB,kBAAkB,QAAQ,KAAK,CAAC"}

package/dist/src/agent/tools/memory-tool.d.ts

@@ -2,6 +2,7 @@ import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { MemoryManager } from '../memory/manager.js';
 export interface MemoryToolOptions {
     workspaceDir: string;
+    dreamingRoot: string;
     getMemoryManager: () => MemoryManager;
 }
 export declare function createMemorySearchTool(options: MemoryToolOptions): AgentTool;

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

@@ -7,7 +7,7 @@ const MemorySearchSchema = Type.Object({
 	minScore: Type.Optional(Type.Number())
 });
 function createMemorySearchTool(options) {
-	const { workspaceDir, getMemoryManager } = options;
+	const { dreamingRoot, getMemoryManager } = options;
 	return {
 		name: "memory_search",
 		label: "🔍 Memory Search",
@@ -34,7 +34,7 @@ function createMemorySearchTool(options) {
 					}
 				});
 				recordDreamingRecalls({
-					workspaceDir,
+					dreamingRoot,
 					query,
 					matches: results.map((entry) => ({
 						file: entry.citation.path ?? entry.record.source.path ?? entry.record.id,

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

@@ -1 +1 @@
-{"version":3,"file":"memory-tool.js","names":[],"sources":["../../../../src/agent/tools/memory-tool.ts"],"sourcesContent":["// Memory search tools for xopc agent\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { recordDreamingRecalls } from '../memory/dreaming/short-term-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\n\n// =============================================================================\n// Memory Search Tool\n// =============================================================================\nconst MemorySearchSchema = Type.Object({\n  query: Type.String(),\n  maxResults: Type.Optional(Type.Number()),\n  minScore: Type.Optional(Type.Number()),\n});\n\ntype MemorySearchParams = { query: string; maxResults?: number; minScore?: number };\n\nexport interface MemoryToolOptions {\n  workspaceDir: string;\n  getMemoryManager: () => MemoryManager;\n}\n\nexport function createMemorySearchTool(options: MemoryToolOptions): AgentTool {\n  const { workspaceDir, getMemoryManager } = options;\n  return {\n    name: 'memory_search',\n    label: '🔍 Memory Search',\n    description:\n      'Mandatory recall step: search indexed profile, curated, and session memory sources before answering questions about prior work, decisions, dates, people, preferences, or todos; returns top snippets with source path + lines.',\n    parameters: MemorySearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { query, maxResults, minScore } = params as MemorySearchParams;\n\n      try {\n        const results = await getMemoryManager().search({ query, maxResults, minScore });\n        for (const result of results) {\n          getMemoryManager().recordSignal({\n            source: 'search_recall',\n            recordId: result.record.id,\n            score: result.score,\n            content: result.snippet,\n            metadata: {\n              providerId: result.citation.providerId,\n              path: result.citation.path,\n              lineStart: result.citation.lineStart,\n              lineEnd: result.citation.lineEnd,\n            },\n          });\n        }\n        // Dreaming: record short-term recall evidence from memory_search.\n        void recordDreamingRecalls({\n          workspaceDir,\n          query,\n          matches: results.map((entry) => ({\n            file: entry.citation.path ?? entry.record.source.path ?? entry.record.id,\n            lines: entry.snippet,\n            score: entry.score,\n            lineNumbers:\n              entry.citation.lineStart != null\n                ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n                : [],\n          })),\n        }).catch(() => {});\n        const withCitations = results.map((entry) => ({\n          id: entry.record.id,\n          kind: entry.record.kind,\n          file: entry.citation.path ?? entry.record.source.path,\n          lines: entry.snippet,\n          score: entry.score,\n          lineNumbers:\n            entry.citation.lineStart != null\n              ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n              : [],\n          citation: `${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n          snippet: `${entry.snippet.trim()}\\n\\nSource: ${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n        }));\n\n        return {\n          content: [{ type: 'text', text: JSON.stringify({ results: withCitations, provider: 'memory-manager' }, null, 2) }],\n          details: { results: withCitations },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n\n// =============================================================================\n// Memory Get Tool\n// =============================================================================\nconst MemoryGetSchema = Type.Object({\n  path: Type.String(),\n  from: Type.Optional(Type.Number()),\n  lines: Type.Optional(Type.Number()),\n});\n\ntype MemoryGetParams = { path: string; from?: number; lines?: number };\n\nexport function createMemoryGetTool(options: MemoryToolOptions): AgentTool {\n  const { getMemoryManager } = options;\n  return {\n    name: 'memory_get',\n    label: '📄 Memory Get',\n    description: 'Safe snippet read from a source path returned by memory_search, with optional from/lines; pull only the needed lines and keep context small.',\n    parameters: MemoryGetSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { path, from, lines } = params as MemoryGetParams;\n\n      try {\n        const result = await getMemoryManager().read({ path, from, lines });\n        if (!result) {\n          return {\n            content: [{ type: 'text', text: `File not found: ${path}` }],\n            details: { path, text: '' },\n          };\n        }\n        return {\n          content: [{ type: 'text', text: result.record.content }],\n          details: { path, text: result.record.content, lineNumbers: result.lineNumbers },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Read error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"memory-tool.js","names":[],"sources":["../../../../src/agent/tools/memory-tool.ts"],"sourcesContent":["// Memory search tools for xopc agent\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { recordDreamingRecalls } from '../memory/dreaming/short-term-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\n\n// =============================================================================\n// Memory Search Tool\n// =============================================================================\nconst MemorySearchSchema = Type.Object({\n  query: Type.String(),\n  maxResults: Type.Optional(Type.Number()),\n  minScore: Type.Optional(Type.Number()),\n});\n\ntype MemorySearchParams = { query: string; maxResults?: number; minScore?: number };\n\nexport interface MemoryToolOptions {\n  workspaceDir: string;\n  dreamingRoot: string;\n  getMemoryManager: () => MemoryManager;\n}\n\nexport function createMemorySearchTool(options: MemoryToolOptions): AgentTool {\n  const { dreamingRoot, getMemoryManager } = options;\n  return {\n    name: 'memory_search',\n    label: '🔍 Memory Search',\n    description:\n      'Mandatory recall step: search indexed profile, curated, and session memory sources before answering questions about prior work, decisions, dates, people, preferences, or todos; returns top snippets with source path + lines.',\n    parameters: MemorySearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { query, maxResults, minScore } = params as MemorySearchParams;\n\n      try {\n        const results = await getMemoryManager().search({ query, maxResults, minScore });\n        for (const result of results) {\n          getMemoryManager().recordSignal({\n            source: 'search_recall',\n            recordId: result.record.id,\n            score: result.score,\n            content: result.snippet,\n            metadata: {\n              providerId: result.citation.providerId,\n              path: result.citation.path,\n              lineStart: result.citation.lineStart,\n              lineEnd: result.citation.lineEnd,\n            },\n          });\n        }\n        // Dreaming: record short-term recall evidence from memory_search.\n        void recordDreamingRecalls({\n          dreamingRoot,\n          query,\n          matches: results.map((entry) => ({\n            file: entry.citation.path ?? entry.record.source.path ?? entry.record.id,\n            lines: entry.snippet,\n            score: entry.score,\n            lineNumbers:\n              entry.citation.lineStart != null\n                ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n                : [],\n          })),\n        }).catch(() => {});\n        const withCitations = results.map((entry) => ({\n          id: entry.record.id,\n          kind: entry.record.kind,\n          file: entry.citation.path ?? entry.record.source.path,\n          lines: entry.snippet,\n          score: entry.score,\n          lineNumbers:\n            entry.citation.lineStart != null\n              ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n              : [],\n          citation: `${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n          snippet: `${entry.snippet.trim()}\\n\\nSource: ${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n        }));\n\n        return {\n          content: [{ type: 'text', text: JSON.stringify({ results: withCitations, provider: 'memory-manager' }, null, 2) }],\n          details: { results: withCitations },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n\n// =============================================================================\n// Memory Get Tool\n// =============================================================================\nconst MemoryGetSchema = Type.Object({\n  path: Type.String(),\n  from: Type.Optional(Type.Number()),\n  lines: Type.Optional(Type.Number()),\n});\n\ntype MemoryGetParams = { path: string; from?: number; lines?: number };\n\nexport function createMemoryGetTool(options: MemoryToolOptions): AgentTool {\n  const { getMemoryManager } = options;\n  return {\n    name: 'memory_get',\n    label: '📄 Memory Get',\n    description: 'Safe snippet read from a source path returned by memory_search, with optional from/lines; pull only the needed lines and keep context small.',\n    parameters: MemoryGetSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { path, from, lines } = params as MemoryGetParams;\n\n      try {\n        const result = await getMemoryManager().read({ path, from, lines });\n        if (!result) {\n          return {\n            content: [{ type: 'text', text: `File not found: ${path}` }],\n            details: { path, text: '' },\n          };\n        }\n        return {\n          content: [{ type: 'text', text: result.record.content }],\n          details: { path, text: result.record.content, lineNumbers: result.lineNumbers },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Read error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,15 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+export type ToolMutationScope = 'none' | 'workspace' | 'external' | 'unknown';
+export type ToolVerificationKind = 'none' | 'diff-review' | 'test' | 'build' | 'lint' | 'typecheck';
+export interface XopcToolMetadata {
+    mutatesWorkspace?: boolean;
+    mutationScope?: ToolMutationScope;
+    supportsParallel?: boolean;
+    idempotent?: boolean;
+    verificationKind?: ToolVerificationKind;
+    requiresExclusiveWorkspaceLock?: boolean;
+    finalGuardRelevant?: boolean;
+}
+export type AgentToolWithMetadata<TParams = any, TDetails = any> = AgentTool<TParams, TDetails> & XopcToolMetadata;
+export declare const DEFAULT_TOOL_METADATA: Required<XopcToolMetadata>;
+export declare function getToolMetadata(tool: AgentTool<any, any>): Required<XopcToolMetadata>;

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

@@ -0,0 +1,26 @@
+//#region src/agent/tools/metadata.ts
+const DEFAULT_TOOL_METADATA = {
+	mutatesWorkspace: false,
+	mutationScope: "none",
+	supportsParallel: false,
+	idempotent: false,
+	verificationKind: "none",
+	requiresExclusiveWorkspaceLock: false,
+	finalGuardRelevant: false
+};
+function getToolMetadata(tool) {
+	const t = tool;
+	return {
+		mutatesWorkspace: t.mutatesWorkspace === true,
+		mutationScope: t.mutationScope ?? DEFAULT_TOOL_METADATA.mutationScope,
+		supportsParallel: t.supportsParallel === true,
+		idempotent: t.idempotent === true,
+		verificationKind: t.verificationKind ?? DEFAULT_TOOL_METADATA.verificationKind,
+		requiresExclusiveWorkspaceLock: t.requiresExclusiveWorkspaceLock === true,
+		finalGuardRelevant: t.finalGuardRelevant === true
+	};
+}
+//#endregion
+export { DEFAULT_TOOL_METADATA, getToolMetadata };
+
+//# sourceMappingURL=metadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","names":[],"sources":["../../../../src/agent/tools/metadata.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\n\nexport type ToolMutationScope = 'none' | 'workspace' | 'external' | 'unknown';\n\nexport type ToolVerificationKind = 'none' | 'diff-review' | 'test' | 'build' | 'lint' | 'typecheck';\n\nexport interface XopcToolMetadata {\n  mutatesWorkspace?: boolean;\n  mutationScope?: ToolMutationScope;\n  supportsParallel?: boolean;\n  idempotent?: boolean;\n  verificationKind?: ToolVerificationKind;\n  requiresExclusiveWorkspaceLock?: boolean;\n  finalGuardRelevant?: boolean;\n}\n\nexport type AgentToolWithMetadata<TParams = any, TDetails = any> = AgentTool<TParams, TDetails> & XopcToolMetadata;\n\nexport const DEFAULT_TOOL_METADATA: Required<XopcToolMetadata> = {\n  mutatesWorkspace: false,\n  mutationScope: 'none',\n  supportsParallel: false,\n  idempotent: false,\n  verificationKind: 'none',\n  requiresExclusiveWorkspaceLock: false,\n  finalGuardRelevant: false,\n};\n\nexport function getToolMetadata(tool: AgentTool<any, any>): Required<XopcToolMetadata> {\n  const t = tool as AgentToolWithMetadata;\n  return {\n    mutatesWorkspace: t.mutatesWorkspace === true,\n    mutationScope: t.mutationScope ?? DEFAULT_TOOL_METADATA.mutationScope,\n    supportsParallel: t.supportsParallel === true,\n    idempotent: t.idempotent === true,\n    verificationKind: t.verificationKind ?? DEFAULT_TOOL_METADATA.verificationKind,\n    requiresExclusiveWorkspaceLock: t.requiresExclusiveWorkspaceLock === true,\n    finalGuardRelevant: t.finalGuardRelevant === true,\n  };\n}\n"],"mappings":";AAkBA,MAAa,wBAAoD;CAC/D,kBAAkB;CAClB,eAAe;CACf,kBAAkB;CAClB,YAAY;CACZ,kBAAkB;CAClB,gCAAgC;CAChC,oBAAoB;CACrB;AAED,SAAgB,gBAAgB,MAAuD;CACrF,MAAM,IAAI;AACV,QAAO;EACL,kBAAkB,EAAE,qBAAqB;EACzC,eAAe,EAAE,iBAAiB,sBAAsB;EACxD,kBAAkB,EAAE,qBAAqB;EACzC,YAAY,EAAE,eAAe;EAC7B,kBAAkB,EAAE,oBAAoB,sBAAsB;EAC9D,gCAAgC,EAAE,mCAAmC;EACrE,oBAAoB,EAAE,uBAAuB;EAC9C"}

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

@@ -16,6 +16,8 @@ function createReadFileTool(workspace, options) {
 		description: "Read file contents. Relative paths are from the current agent workspace; profile Markdown (SOUL.md, etc.) is found automatically when given by filename.",
 		parameters: ReadFileSchema,
 		label: "📄 Read",
+		supportsParallel: true,
+		idempotent: true,
 		async execute(_toolCallId, params, _signal) {
 			return executeReadFile(workspace, options?.profileMarkdownRoot, params);
 		}

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

@@ -1 +1 @@
-{"version":3,"file":"read.js","names":[],"sources":["../../../../src/agent/tools/read.ts"],"sourcesContent":["// Read file tool\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { readFile, stat } from 'fs/promises';\nimport { checkFileSafety } from '../prompt/safety.js';\nimport { truncateHead, formatSize, DEFAULT_MAX_BYTES } from './truncate.js';\nimport {\n  isBareProfileMarkdownFileName,\n  resolveProfileMarkdownPathIfBareName,\n  resolvePathUnderWorkspace,\n} from './tool-paths.js';\n\nconst MAX_FILE_SIZE = 10 * 1024 * 1024;\nconst DEFAULT_MAX_LINES = 500;\n\nconst ReadFileSchema = Type.Object({\n  path: Type.String({ description: 'File path to read' }),\n  limit: Type.Optional(Type.Number({ description: 'Max lines (default: 500)' })),\n});\n\nexport interface CreateReadFileToolOptions {\n  /** When set and the path is a bare profile filename (e.g. SOUL.md), try this root if not in workspace. */\n  profileMarkdownRoot?: string;\n}\n\ntype ReadFileParams = {\n  path: string;\n  limit?: number;\n};\n\nexport function createReadFileTool(\n  workspace: string,\n  options?: CreateReadFileToolOptions,\n): AgentTool {\n  return {\n    name: 'read_file',\n    description:\n      'Read file contents. Relative paths are from the current agent workspace; profile Markdown (SOUL.md, etc.) is found automatically when given by filename.',\n    parameters: ReadFileSchema,\n    label: '📄 Read',\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      return executeReadFile(workspace, options?.profileMarkdownRoot, params as ReadFileParams);\n    },\n  } as any;\n}\n\nasync function executeReadFile(\n  workspace: string,\n  profileMarkdownRoot: string | undefined,\n  params: ReadFileParams,\n): Promise<AgentToolResult<{}>> {\n  try {\n    const safety = checkFileSafety('read', params.path);\n    if (!safety.allowed) {\n      return { content: [{ type: 'text', text: `🚫 ${safety.message}` }], details: {} };\n    }\n\n    let normalized = resolvePathUnderWorkspace(params.path, workspace);\n    let stats;\n    try {\n      stats = await stat(normalized);\n    } catch (e) {\n      const code = (e as NodeJS.ErrnoException)?.code;\n      if (\n        code === 'ENOENT' &&\n        profileMarkdownRoot &&\n        isBareProfileMarkdownFileName(params.path)\n      ) {\n        const alt = resolveProfileMarkdownPathIfBareName(params.path, profileMarkdownRoot);\n        try {\n          stats = await stat(alt);\n          normalized = alt;\n        } catch {\n          throw e;\n        }\n      } else {\n        throw e;\n      }\n    }\n\n    if (stats.size > MAX_FILE_SIZE) {\n      return { content: [{ type: 'text', text: `🚫 File too large: ${formatSize(stats.size)}` }], details: {} };\n    }\n\n    const content = await readFile(normalized, 'utf-8');\n    const truncation = truncateHead(content, { maxLines: params.limit || DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });\n\n    let outputText = truncation.content;\n    if (truncation.truncated) {\n      if (truncation.firstLineExceedsLimit) {\n        outputText = `(Line exceeds ${formatSize(DEFAULT_MAX_BYTES)})`;\n      } else {\n        outputText += `\\n\\n[${truncation.outputLines}/${truncation.totalLines} lines]`;\n      }\n    }\n\n    return { content: [{ type: 'text', text: outputText }], details: {} };\n  } catch (error) {\n    return { content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }], details: {} };\n  }\n}\n"],"mappings":";;;;;;AAYA,MAAM,gBAAgB,KAAK,OAAO;AAClC,MAAM,oBAAoB;AAE1B,MAAM,iBAAiB,KAAK,OAAO;CACjC,MAAM,KAAK,OAAO,EAAE,aAAa,qBAAqB,CAAC;CACvD,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,4BAA4B,CAAC,CAAC;CAC/E,CAAC;AAYF,SAAgB,mBACd,WACA,SACW;AACX,QAAO;EACL,MAAM;EACN,aACE;EACF,YAAY;EACZ,OAAO;EAEP,MAAM,QACJ,aACA,QACA,SAC8B;AAC9B,UAAO,gBAAgB,WAAW,SAAS,qBAAqB,OAAyB;;EAE5F;;AAGH,eAAe,gBACb,WACA,qBACA,QAC8B;AAC9B,KAAI;EACF,MAAM,SAAS,gBAAgB,QAAQ,OAAO,KAAK;AACnD,MAAI,CAAC,OAAO,QACV,QAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,MAAM,OAAO;IAAW,CAAC;GAAE,SAAS,EAAE;GAAE;EAGnF,IAAI,aAAa,0BAA0B,OAAO,MAAM,UAAU;EAClE,IAAI;AACJ,MAAI;AACF,WAAQ,MAAM,KAAK,WAAW;WACvB,GAAG;AAEV,OADc,GAA6B,SAEhC,YACT,uBACA,8BAA8B,OAAO,KAAK,EAC1C;IACA,MAAM,MAAM,qCAAqC,OAAO,MAAM,oBAAoB;AAClF,QAAI;AACF,aAAQ,MAAM,KAAK,IAAI;AACvB,kBAAa;YACP;AACN,WAAM;;SAGR,OAAM;;AAIV,MAAI,MAAM,OAAO,cACf,QAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,sBAAsB,WAAW,MAAM,KAAK;IAAI,CAAC;GAAE,SAAS,EAAE;GAAE;EAI3G,MAAM,aAAa,aAAa,MADV,SAAS,YAAY,QAAQ,EACV;GAAE,UAAU,OAAO,SAAS;GAAmB,UAAU;GAAmB,CAAC;EAEtH,IAAI,aAAa,WAAW;AAC5B,MAAI,WAAW,UACb,KAAI,WAAW,sBACb,cAAa,iBAAiB,WAAW,kBAAkB,CAAC;MAE5D,eAAc,QAAQ,WAAW,YAAY,GAAG,WAAW,WAAW;AAI1E,SAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;IAAY,CAAC;GAAE,SAAS,EAAE;GAAE;UAC9D,OAAO;AACd,SAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAAI,CAAC;GAAE,SAAS,EAAE;GAAE"}
+{"version":3,"file":"read.js","names":[],"sources":["../../../../src/agent/tools/read.ts"],"sourcesContent":["// Read file tool\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { readFile, stat } from 'fs/promises';\nimport { checkFileSafety } from '../prompt/safety.js';\nimport { truncateHead, formatSize, DEFAULT_MAX_BYTES } from './truncate.js';\nimport {\n  isBareProfileMarkdownFileName,\n  resolveProfileMarkdownPathIfBareName,\n  resolvePathUnderWorkspace,\n} from './tool-paths.js';\n\nconst MAX_FILE_SIZE = 10 * 1024 * 1024;\nconst DEFAULT_MAX_LINES = 500;\n\nconst ReadFileSchema = Type.Object({\n  path: Type.String({ description: 'File path to read' }),\n  limit: Type.Optional(Type.Number({ description: 'Max lines (default: 500)' })),\n});\n\nexport interface CreateReadFileToolOptions {\n  /** When set and the path is a bare profile filename (e.g. SOUL.md), try this root if not in workspace. */\n  profileMarkdownRoot?: string;\n}\n\ntype ReadFileParams = {\n  path: string;\n  limit?: number;\n};\n\nexport function createReadFileTool(\n  workspace: string,\n  options?: CreateReadFileToolOptions,\n): AgentTool {\n  return {\n    name: 'read_file',\n    description:\n      'Read file contents. Relative paths are from the current agent workspace; profile Markdown (SOUL.md, etc.) is found automatically when given by filename.',\n    parameters: ReadFileSchema,\n    label: '📄 Read',\n    supportsParallel: true,\n    idempotent: true,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      return executeReadFile(workspace, options?.profileMarkdownRoot, params as ReadFileParams);\n    },\n  } as any;\n}\n\nasync function executeReadFile(\n  workspace: string,\n  profileMarkdownRoot: string | undefined,\n  params: ReadFileParams,\n): Promise<AgentToolResult<{}>> {\n  try {\n    const safety = checkFileSafety('read', params.path);\n    if (!safety.allowed) {\n      return { content: [{ type: 'text', text: `🚫 ${safety.message}` }], details: {} };\n    }\n\n    let normalized = resolvePathUnderWorkspace(params.path, workspace);\n    let stats;\n    try {\n      stats = await stat(normalized);\n    } catch (e) {\n      const code = (e as NodeJS.ErrnoException)?.code;\n      if (\n        code === 'ENOENT' &&\n        profileMarkdownRoot &&\n        isBareProfileMarkdownFileName(params.path)\n      ) {\n        const alt = resolveProfileMarkdownPathIfBareName(params.path, profileMarkdownRoot);\n        try {\n          stats = await stat(alt);\n          normalized = alt;\n        } catch {\n          throw e;\n        }\n      } else {\n        throw e;\n      }\n    }\n\n    if (stats.size > MAX_FILE_SIZE) {\n      return { content: [{ type: 'text', text: `🚫 File too large: ${formatSize(stats.size)}` }], details: {} };\n    }\n\n    const content = await readFile(normalized, 'utf-8');\n    const truncation = truncateHead(content, { maxLines: params.limit || DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });\n\n    let outputText = truncation.content;\n    if (truncation.truncated) {\n      if (truncation.firstLineExceedsLimit) {\n        outputText = `(Line exceeds ${formatSize(DEFAULT_MAX_BYTES)})`;\n      } else {\n        outputText += `\\n\\n[${truncation.outputLines}/${truncation.totalLines} lines]`;\n      }\n    }\n\n    return { content: [{ type: 'text', text: outputText }], details: {} };\n  } catch (error) {\n    return { content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }], details: {} };\n  }\n}\n"],"mappings":";;;;;;AAYA,MAAM,gBAAgB,KAAK,OAAO;AAClC,MAAM,oBAAoB;AAE1B,MAAM,iBAAiB,KAAK,OAAO;CACjC,MAAM,KAAK,OAAO,EAAE,aAAa,qBAAqB,CAAC;CACvD,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,4BAA4B,CAAC,CAAC;CAC/E,CAAC;AAYF,SAAgB,mBACd,WACA,SACW;AACX,QAAO;EACL,MAAM;EACN,aACE;EACF,YAAY;EACZ,OAAO;EACP,kBAAkB;EAClB,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,SAC8B;AAC9B,UAAO,gBAAgB,WAAW,SAAS,qBAAqB,OAAyB;;EAE5F;;AAGH,eAAe,gBACb,WACA,qBACA,QAC8B;AAC9B,KAAI;EACF,MAAM,SAAS,gBAAgB,QAAQ,OAAO,KAAK;AACnD,MAAI,CAAC,OAAO,QACV,QAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,MAAM,OAAO;IAAW,CAAC;GAAE,SAAS,EAAE;GAAE;EAGnF,IAAI,aAAa,0BAA0B,OAAO,MAAM,UAAU;EAClE,IAAI;AACJ,MAAI;AACF,WAAQ,MAAM,KAAK,WAAW;WACvB,GAAG;AAEV,OADc,GAA6B,SAEhC,YACT,uBACA,8BAA8B,OAAO,KAAK,EAC1C;IACA,MAAM,MAAM,qCAAqC,OAAO,MAAM,oBAAoB;AAClF,QAAI;AACF,aAAQ,MAAM,KAAK,IAAI;AACvB,kBAAa;YACP;AACN,WAAM;;SAGR,OAAM;;AAIV,MAAI,MAAM,OAAO,cACf,QAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,sBAAsB,WAAW,MAAM,KAAK;IAAI,CAAC;GAAE,SAAS,EAAE;GAAE;EAI3G,MAAM,aAAa,aAAa,MADV,SAAS,YAAY,QAAQ,EACV;GAAE,UAAU,OAAO,SAAS;GAAmB,UAAU;GAAmB,CAAC;EAEtH,IAAI,aAAa,WAAW;AAC5B,MAAI,WAAW,UACb,KAAI,WAAW,sBACb,cAAa,iBAAiB,WAAW,kBAAkB,CAAC;MAE5D,eAAc,QAAQ,WAAW,YAAY,GAAG,WAAW,WAAW;AAI1E,SAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;IAAY,CAAC;GAAE,SAAS,EAAE;GAAE;UAC9D,OAAO;AACd,SAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAAI,CAAC;GAAE,SAAS,EAAE;GAAE"}