@librechat/agents 3.2.2 → 3.2.31

package/dist/cjs/tools/cloudflare/CloudflareSandboxTools.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"CloudflareSandboxTools.cjs","sources":["../../../../src/tools/cloudflare/CloudflareSandboxTools.ts"],"sourcesContent":["import { tool } from '@langchain/core/tools';\nimport type { DynamicStructuredTool } from '@langchain/core/tools';\nimport type * as t from '@/types';\nimport {\n  CodeExecutionToolName,\n  CodeExecutionToolSchema,\n} from '@/tools/CodeExecutor';\nimport {\n  BashExecutionToolName,\n  BashExecutionToolSchema,\n  BashToolOutputReferencesGuide,\n} from '@/tools/BashExecutor';\nimport {\n  createLocalReadFileTool,\n  createLocalWriteFileTool,\n  createLocalEditFileTool,\n  createLocalGrepSearchTool,\n  createLocalGlobSearchTool,\n  createLocalListDirectoryTool,\n} from '@/tools/local/LocalCodingTools';\nimport { createLocalFileCheckpointer } from '@/tools/local/FileCheckpointer';\nimport { createCompileCheckTool } from '@/tools/local/CompileCheckTool';\nimport { Constants } from '@/common';\nimport {\n  createCloudflareLocalExecutionConfig,\n  createCloudflareWorkspaceFS,\n  executeCloudflareBash,\n  executeCloudflareCode,\n  formatCloudflareOutput,\n  getCloudflareWorkspaceRoot,\n} from './CloudflareSandboxExecutionEngine';\nimport {\n  createCloudflareBashProgrammaticToolCallingTool,\n  createCloudflareProgrammaticToolCallingTool,\n} from './CloudflareProgrammaticToolCalling';\n\nexport const CLOUDFLARE_CODING_TOOL_NAMES: readonly string[] = [\n  Constants.READ_FILE,\n  Constants.WRITE_FILE,\n  Constants.EDIT_FILE,\n  Constants.GREP_SEARCH,\n  Constants.GLOB_SEARCH,\n  Constants.LIST_DIRECTORY,\n  Constants.COMPILE_CHECK,\n  Constants.BASH_TOOL,\n  Constants.EXECUTE_CODE,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n];\n\nexport const CLOUDFLARE_BASH_CODING_TOOL_NAMES: readonly string[] = [\n  Constants.READ_FILE,\n  Constants.WRITE_FILE,\n  Constants.EDIT_FILE,\n  Constants.GREP_SEARCH,\n  Constants.GLOB_SEARCH,\n  Constants.LIST_DIRECTORY,\n  Constants.COMPILE_CHECK,\n  Constants.BASH_TOOL,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n];\n\nexport const CloudflareCodeExecutionToolDescription = `\nRuns code inside the configured Cloudflare Sandbox workspace. The sandbox can see files and installed runtimes available inside the Cloudflare Sandbox container.\n\nUsage:\n- Commands execute in the Cloudflare Sandbox workspace and may modify sandbox files.\n- Input code is already displayed to the user, so do not repeat it unless asked.\n- Output is not displayed unless you print it explicitly.\n`.trim();\n\nexport const CloudflareBashExecutionToolDescription = `\nRuns bash commands inside the configured Cloudflare Sandbox workspace.\n\nUsage:\n- Commands execute in the Cloudflare Sandbox workspace and may modify sandbox files.\n- Output is not displayed unless you print it explicitly.\n- Prefer project-native commands and inspect files before changing them.\n`.trim();\n\nexport function createCloudflareCodeExecutionTool(\n  config: t.CloudflareSandboxExecutionConfig\n): DynamicStructuredTool {\n  return tool(\n    async (rawInput) => {\n      const input = rawInput as {\n        lang: string;\n        code: string;\n        args?: string[];\n      };\n      const cwd = getCloudflareWorkspaceRoot(config);\n      const result = await executeCloudflareCode(input, config);\n      return [\n        formatCloudflareOutput(result, cwd),\n        {\n          session_id: 'cloudflare-sandbox',\n          files: [],\n        } satisfies t.CodeExecutionArtifact,\n      ];\n    },\n    {\n      name: CodeExecutionToolName,\n      description: CloudflareCodeExecutionToolDescription,\n      schema: CodeExecutionToolSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\nexport function createCloudflareBashExecutionTool(options: {\n  config: t.CloudflareSandboxExecutionConfig;\n  enableToolOutputReferences?: boolean;\n}): DynamicStructuredTool {\n  const { config } = options;\n  return tool(\n    async (rawInput) => {\n      const input = rawInput as { command: string; args?: string[] };\n      const cwd = getCloudflareWorkspaceRoot(config);\n      const result = await executeCloudflareBash(\n        input.command,\n        config,\n        input.args ?? []\n      );\n      return [\n        formatCloudflareOutput(result, cwd),\n        {\n          session_id: 'cloudflare-sandbox',\n          files: [],\n        } satisfies t.CodeExecutionArtifact,\n      ];\n    },\n    {\n      name: BashExecutionToolName,\n      description:\n        options.enableToolOutputReferences === true\n          ? `${CloudflareBashExecutionToolDescription}\\n\\n${BashToolOutputReferencesGuide}`\n          : CloudflareBashExecutionToolDescription,\n      schema: BashExecutionToolSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\nexport type CloudflareCodingToolBundle = {\n  tools: DynamicStructuredTool[];\n  checkpointer?: t.LocalFileCheckpointer;\n};\n\nfunction getSelectedCodingToolNames(\n  config: t.CloudflareSandboxExecutionConfig\n): Set<string> {\n  return new Set(config.codingToolNames ?? CLOUDFLARE_CODING_TOOL_NAMES);\n}\n\nexport function createCloudflareCodingTools(\n  config: t.CloudflareSandboxExecutionConfig,\n  options: { checkpointer?: t.LocalFileCheckpointer } = {}\n): DynamicStructuredTool[] {\n  const localConfig = createCloudflareLocalExecutionConfig(config);\n  const checkpointer =\n    options.checkpointer ??\n    (config.fileCheckpointing === true\n      ? createLocalFileCheckpointer({\n        fs: createCloudflareWorkspaceFS(config),\n      })\n      : undefined);\n  const tools = [\n    [Constants.READ_FILE, createLocalReadFileTool(localConfig)],\n    [Constants.WRITE_FILE, createLocalWriteFileTool(localConfig, checkpointer)],\n    [Constants.EDIT_FILE, createLocalEditFileTool(localConfig, checkpointer)],\n    [Constants.GREP_SEARCH, createLocalGrepSearchTool(localConfig)],\n    [Constants.GLOB_SEARCH, createLocalGlobSearchTool(localConfig)],\n    [Constants.LIST_DIRECTORY, createLocalListDirectoryTool(localConfig)],\n    [Constants.COMPILE_CHECK, createCompileCheckTool(localConfig)],\n    [Constants.BASH_TOOL, createCloudflareBashExecutionTool({ config })],\n    [Constants.EXECUTE_CODE, createCloudflareCodeExecutionTool(config)],\n    [\n      Constants.PROGRAMMATIC_TOOL_CALLING,\n      createCloudflareProgrammaticToolCallingTool(config),\n    ],\n    [\n      Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n      createCloudflareBashProgrammaticToolCallingTool(config),\n    ],\n  ] satisfies Array<[string, DynamicStructuredTool]>;\n  const selectedNames = getSelectedCodingToolNames(config);\n  return tools\n    .filter(([name]) => selectedNames.has(name))\n    .map(([, selectedTool]) => selectedTool);\n}\n\nexport function createCloudflareCodingToolBundle(\n  config: t.CloudflareSandboxExecutionConfig,\n  options: { checkpointer?: t.LocalFileCheckpointer } = {}\n): CloudflareCodingToolBundle {\n  const checkpointer =\n    options.checkpointer ??\n    (config.fileCheckpointing === true\n      ? createLocalFileCheckpointer({\n        fs: createCloudflareWorkspaceFS(config),\n      })\n      : undefined);\n  return {\n    tools: createCloudflareCodingTools(config, { checkpointer }),\n    checkpointer,\n  };\n}\n\nexport function createCloudflareExecutionTool(\n  name: string,\n  config: t.CloudflareSandboxExecutionConfig\n): t.GenericTool | undefined {\n  switch (name) {\n  case Constants.EXECUTE_CODE:\n    return createCloudflareCodeExecutionTool(config);\n  case Constants.BASH_TOOL:\n    return createCloudflareBashExecutionTool({ config });\n  case Constants.PROGRAMMATIC_TOOL_CALLING:\n    return createCloudflareProgrammaticToolCallingTool(config);\n  case Constants.BASH_PROGRAMMATIC_TOOL_CALLING:\n    return createCloudflareBashProgrammaticToolCallingTool(config);\n  default:\n    return undefined;\n  }\n}\n"],"names":["Constants","tool","getCloudflareWorkspaceRoot","executeCloudflareCode","formatCloudflareOutput","CodeExecutionToolName","CodeExecutionToolSchema","executeCloudflareBash","BashExecutionToolName","BashToolOutputReferencesGuide","BashExecutionToolSchema","createCloudflareLocalExecutionConfig","createLocalFileCheckpointer","createCloudflareWorkspaceFS","createLocalReadFileTool","createLocalWriteFileTool","createLocalEditFileTool","createLocalGrepSearchTool","createLocalGlobSearchTool","createLocalListDirectoryTool","createCompileCheckTool","createCloudflareProgrammaticToolCallingTool","createCloudflareBashProgrammaticToolCallingTool"],"mappings":"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"}
+{"version":3,"file":"CloudflareSandboxTools.cjs","sources":["../../../../src/tools/cloudflare/CloudflareSandboxTools.ts"],"sourcesContent":["import { tool } from '@langchain/core/tools';\nimport type { DynamicStructuredTool } from '@langchain/core/tools';\nimport type * as t from '@/types';\nimport {\n  createCloudflareLocalExecutionConfig,\n  createCloudflareWorkspaceFS,\n  executeCloudflareBash,\n  executeCloudflareCode,\n  formatCloudflareOutput,\n  getCloudflareWorkspaceRoot,\n} from './CloudflareSandboxExecutionEngine';\nimport {\n  createLocalReadFileTool,\n  createLocalWriteFileTool,\n  createLocalEditFileTool,\n  createLocalGrepSearchTool,\n  createLocalGlobSearchTool,\n  createLocalListDirectoryTool,\n} from '@/tools/local/LocalCodingTools';\nimport {\n  createCloudflareBashProgrammaticToolCallingTool,\n  createCloudflareProgrammaticToolCallingTool,\n} from './CloudflareProgrammaticToolCalling';\nimport {\n  BashExecutionToolName,\n  BashExecutionToolSchema,\n  BashToolOutputReferencesGuide,\n} from '@/tools/BashExecutor';\nimport {\n  CodeExecutionToolName,\n  CodeExecutionToolSchema,\n} from '@/tools/CodeExecutor';\nimport { createLocalFileCheckpointer } from '@/tools/local/FileCheckpointer';\nimport { createCompileCheckTool } from '@/tools/local/CompileCheckTool';\nimport { Constants } from '@/common';\n\nexport const CLOUDFLARE_CODING_TOOL_NAMES: readonly string[] = [\n  Constants.READ_FILE,\n  Constants.WRITE_FILE,\n  Constants.EDIT_FILE,\n  Constants.GREP_SEARCH,\n  Constants.GLOB_SEARCH,\n  Constants.LIST_DIRECTORY,\n  Constants.COMPILE_CHECK,\n  Constants.BASH_TOOL,\n  Constants.EXECUTE_CODE,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n];\n\nexport const CLOUDFLARE_BASH_CODING_TOOL_NAMES: readonly string[] = [\n  Constants.READ_FILE,\n  Constants.WRITE_FILE,\n  Constants.EDIT_FILE,\n  Constants.GREP_SEARCH,\n  Constants.GLOB_SEARCH,\n  Constants.LIST_DIRECTORY,\n  Constants.COMPILE_CHECK,\n  Constants.BASH_TOOL,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n];\n\nexport const CloudflareCodeExecutionToolDescription = `\nRuns code inside the configured Cloudflare Sandbox workspace. The sandbox can see files and installed runtimes available inside the Cloudflare Sandbox container.\n\nUsage:\n- Commands execute in the Cloudflare Sandbox workspace and may modify sandbox files.\n- Input code is already displayed to the user, so do not repeat it unless asked.\n- Output is not displayed unless you print it explicitly.\n`.trim();\n\nexport const CloudflareBashExecutionToolDescription = `\nRuns bash commands inside the configured Cloudflare Sandbox workspace.\n\nUsage:\n- Commands execute in the Cloudflare Sandbox workspace and may modify sandbox files.\n- Output is not displayed unless you print it explicitly.\n- Prefer project-native commands and inspect files before changing them.\n`.trim();\n\nexport function createCloudflareCodeExecutionTool(\n  config: t.CloudflareSandboxExecutionConfig\n): DynamicStructuredTool {\n  return tool(\n    async (rawInput) => {\n      const input = rawInput as {\n        lang: string;\n        code: string;\n        args?: string[];\n      };\n      const cwd = getCloudflareWorkspaceRoot(config);\n      const result = await executeCloudflareCode(input, config);\n      return [\n        formatCloudflareOutput(result, cwd),\n        {\n          session_id: 'cloudflare-sandbox',\n          files: [],\n        } satisfies t.CodeExecutionArtifact,\n      ];\n    },\n    {\n      name: CodeExecutionToolName,\n      description: CloudflareCodeExecutionToolDescription,\n      schema: CodeExecutionToolSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\nexport function createCloudflareBashExecutionTool(options: {\n  config: t.CloudflareSandboxExecutionConfig;\n  enableToolOutputReferences?: boolean;\n}): DynamicStructuredTool {\n  const { config } = options;\n  return tool(\n    async (rawInput) => {\n      const input = rawInput as { command: string; args?: string[] };\n      const cwd = getCloudflareWorkspaceRoot(config);\n      const result = await executeCloudflareBash(\n        input.command,\n        config,\n        input.args ?? []\n      );\n      return [\n        formatCloudflareOutput(result, cwd),\n        {\n          session_id: 'cloudflare-sandbox',\n          files: [],\n        } satisfies t.CodeExecutionArtifact,\n      ];\n    },\n    {\n      name: BashExecutionToolName,\n      description:\n        options.enableToolOutputReferences === true\n          ? `${CloudflareBashExecutionToolDescription}\\n\\n${BashToolOutputReferencesGuide}`\n          : CloudflareBashExecutionToolDescription,\n      schema: BashExecutionToolSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\nexport type CloudflareCodingToolBundle = {\n  tools: DynamicStructuredTool[];\n  checkpointer?: t.LocalFileCheckpointer;\n};\n\nfunction getSelectedCodingToolNames(\n  config: t.CloudflareSandboxExecutionConfig\n): Set<string> {\n  return new Set(config.codingToolNames ?? CLOUDFLARE_CODING_TOOL_NAMES);\n}\n\nexport function createCloudflareCodingTools(\n  config: t.CloudflareSandboxExecutionConfig,\n  options: { checkpointer?: t.LocalFileCheckpointer } = {}\n): DynamicStructuredTool[] {\n  const localConfig = createCloudflareLocalExecutionConfig(config);\n  const checkpointer =\n    options.checkpointer ??\n    (config.fileCheckpointing === true\n      ? createLocalFileCheckpointer({\n        fs: createCloudflareWorkspaceFS(config),\n      })\n      : undefined);\n  const tools = [\n    [Constants.READ_FILE, createLocalReadFileTool(localConfig)],\n    [Constants.WRITE_FILE, createLocalWriteFileTool(localConfig, checkpointer)],\n    [Constants.EDIT_FILE, createLocalEditFileTool(localConfig, checkpointer)],\n    [Constants.GREP_SEARCH, createLocalGrepSearchTool(localConfig)],\n    [Constants.GLOB_SEARCH, createLocalGlobSearchTool(localConfig)],\n    [Constants.LIST_DIRECTORY, createLocalListDirectoryTool(localConfig)],\n    [Constants.COMPILE_CHECK, createCompileCheckTool(localConfig)],\n    [Constants.BASH_TOOL, createCloudflareBashExecutionTool({ config })],\n    [Constants.EXECUTE_CODE, createCloudflareCodeExecutionTool(config)],\n    [\n      Constants.PROGRAMMATIC_TOOL_CALLING,\n      createCloudflareProgrammaticToolCallingTool(config),\n    ],\n    [\n      Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n      createCloudflareBashProgrammaticToolCallingTool(config),\n    ],\n  ] satisfies Array<[string, DynamicStructuredTool]>;\n  const selectedNames = getSelectedCodingToolNames(config);\n  return tools\n    .filter(([name]) => selectedNames.has(name))\n    .map(([, selectedTool]) => selectedTool);\n}\n\nexport function createCloudflareCodingToolBundle(\n  config: t.CloudflareSandboxExecutionConfig,\n  options: { checkpointer?: t.LocalFileCheckpointer } = {}\n): CloudflareCodingToolBundle {\n  const checkpointer =\n    options.checkpointer ??\n    (config.fileCheckpointing === true\n      ? createLocalFileCheckpointer({\n        fs: createCloudflareWorkspaceFS(config),\n      })\n      : undefined);\n  return {\n    tools: createCloudflareCodingTools(config, { checkpointer }),\n    checkpointer,\n  };\n}\n\nexport function createCloudflareExecutionTool(\n  name: string,\n  config: t.CloudflareSandboxExecutionConfig\n): t.GenericTool | undefined {\n  switch (name) {\n  case Constants.EXECUTE_CODE:\n    return createCloudflareCodeExecutionTool(config);\n  case Constants.BASH_TOOL:\n    return createCloudflareBashExecutionTool({ config });\n  case Constants.PROGRAMMATIC_TOOL_CALLING:\n    return createCloudflareProgrammaticToolCallingTool(config);\n  case Constants.BASH_PROGRAMMATIC_TOOL_CALLING:\n    return createCloudflareBashProgrammaticToolCallingTool(config);\n  default:\n    return undefined;\n  }\n}\n"],"names":["Constants","tool","getCloudflareWorkspaceRoot","executeCloudflareCode","formatCloudflareOutput","CodeExecutionToolName","CodeExecutionToolSchema","executeCloudflareBash","BashExecutionToolName","BashToolOutputReferencesGuide","BashExecutionToolSchema","createCloudflareLocalExecutionConfig","createLocalFileCheckpointer","createCloudflareWorkspaceFS","createLocalReadFileTool","createLocalWriteFileTool","createLocalEditFileTool","createLocalGrepSearchTool","createLocalGlobSearchTool","createLocalListDirectoryTool","createCompileCheckTool","createCloudflareProgrammaticToolCallingTool","createCloudflareBashProgrammaticToolCallingTool"],"mappings":"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"}

package/dist/cjs/tools/handlers.cjs

@@ -2,11 +2,12 @@
 
 var nanoid = require('nanoid');
 var messages = require('@langchain/core/messages');
-var _enum = require('../common/enum.cjs');
 var anthropic = require('./search/anthropic.cjs');
+var _enum = require('../common/enum.cjs');
 var format = require('./search/format.cjs');
 require('../messages/core.cjs');
 var ids = require('../messages/ids.cjs');
+require('node:crypto');
 require('@langchain/core/callbacks/dispatch');
 require('uuid');
 

package/dist/cjs/tools/handlers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.cjs","sources":["../../../src/tools/handlers.ts"],"sourcesContent":["/* eslint-disable no-console */\n// src/tools/handlers.ts\nimport { nanoid } from 'nanoid';\nimport { ToolMessage } from '@langchain/core/messages';\nimport type { AnthropicWebSearchResultBlockParam } from '@/llm/anthropic/types';\nimport type { ToolCall, ToolCallChunk } from '@langchain/core/messages/tool';\nimport type { Graph, MultiAgentGraph, StandardGraph } from '@/graphs';\nimport type { AgentContext } from '@/agents/AgentContext';\nimport type * as t from '@/types';\nimport {\n  ToolCallTypes,\n  GraphEvents,\n  StepTypes,\n  Providers,\n  Constants,\n} from '@/common';\nimport {\n  coerceAnthropicSearchResults,\n  isAnthropicWebSearchResult,\n} from '@/tools/search/anthropic';\nimport { formatResultsForLLM } from '@/tools/search/format';\nimport { getMessageId } from '@/messages';\n\nexport async function handleToolCallChunks({\n  graph,\n  stepKey,\n  toolCallChunks,\n  metadata,\n}: {\n  graph: StandardGraph | MultiAgentGraph;\n  stepKey: string;\n  toolCallChunks: ToolCallChunk[];\n  metadata?: Record<string, unknown>;\n}): Promise<void> {\n  let prevStepId: string;\n  let prevRunStep: t.RunStep | undefined;\n  try {\n    prevStepId = graph.getStepIdByKey(stepKey);\n    prevRunStep = graph.getRunStep(prevStepId);\n  } catch {\n    /** Edge Case: If no previous step exists, create a new message creation step */\n    const message_id = getMessageId(stepKey, graph, true) ?? '';\n    prevStepId = await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.MESSAGE_CREATION,\n        message_creation: {\n          message_id,\n        },\n      },\n      metadata\n    );\n    prevRunStep = graph.getRunStep(prevStepId);\n  }\n\n  const _stepId = graph.getStepIdByKey(stepKey);\n\n  /** Edge Case: Tool Call Run Step or `tool_call_ids` never dispatched */\n  const tool_calls: ToolCall[] | undefined =\n    prevStepId && prevRunStep && prevRunStep.type === StepTypes.MESSAGE_CREATION\n      ? []\n      : undefined;\n\n  /** Edge Case: `id` and `name` fields cannot be empty strings */\n  for (const toolCallChunk of toolCallChunks) {\n    if (toolCallChunk.name === '') {\n      toolCallChunk.name = undefined;\n    }\n    if (toolCallChunk.id === '') {\n      toolCallChunk.id = undefined;\n    } else if (\n      tool_calls != null &&\n      toolCallChunk.id != null &&\n      toolCallChunk.name != null\n    ) {\n      tool_calls.push({\n        args: {},\n        id: toolCallChunk.id,\n        name: toolCallChunk.name,\n        type: ToolCallTypes.TOOL_CALL,\n      });\n    }\n  }\n\n  let stepId: string = _stepId;\n  const alreadyDispatched =\n    prevRunStep?.type === StepTypes.MESSAGE_CREATION &&\n    graph.messageStepHasToolCalls.has(prevStepId);\n\n  if (prevRunStep?.type === StepTypes.TOOL_CALLS) {\n    /**\n     * If previous step is already a tool_calls step, use that step ID\n     * This ensures tool call deltas are dispatched to the correct step\n     */\n    stepId = prevStepId;\n  } else if (\n    !alreadyDispatched &&\n    prevRunStep?.type === StepTypes.MESSAGE_CREATION\n  ) {\n    /**\n     * Create tool_calls step as soon as we receive the first tool call chunk\n     * This ensures deltas are always associated with the correct step\n     *\n     * NOTE: We do NOT dispatch an empty text block here because:\n     * - Empty text blocks cause providers (Anthropic, Bedrock) to reject messages\n     * - The tool_calls themselves are sufficient for the step\n     * - Empty content with tool_call_ids gets stored in conversation history\n     *   and causes \"messages must have non-empty content\" errors on replay\n     */\n    graph.messageStepHasToolCalls.set(prevStepId, true);\n    stepId = await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.TOOL_CALLS,\n        tool_calls: tool_calls ?? [],\n      },\n      metadata\n    );\n  }\n\n  await graph.dispatchRunStepDelta(\n    stepId,\n    {\n      type: StepTypes.TOOL_CALLS,\n      tool_calls: toolCallChunks,\n    },\n    metadata\n  );\n}\n\nexport const handleToolCalls = async (\n  toolCalls?: ToolCall[],\n  metadata?: Record<string, unknown>,\n  graph?: Graph | StandardGraph | MultiAgentGraph\n): Promise<void> => {\n  if (!graph || !metadata) {\n    console.warn('Graph or metadata not found in `handleToolCalls`');\n    return;\n  }\n\n  if (!toolCalls) {\n    return;\n  }\n\n  if (toolCalls.length === 0) {\n    return;\n  }\n\n  const stepKey = graph.getStepKey(metadata);\n\n  /**\n   * Track whether we've already reused an empty TOOL_CALLS step created by\n   * handleToolCallChunks during streaming. Only reuse it once (for the first\n   * tool call); subsequent parallel tool calls must create their own steps.\n   */\n  let reusedChunkStepId: string | undefined;\n\n  for (const tool_call of toolCalls) {\n    const toolCallId = tool_call.id ?? `toolu_${nanoid()}`;\n    tool_call.id = toolCallId;\n    if (!toolCallId || graph.toolCallStepIds.has(toolCallId)) {\n      continue;\n    }\n\n    let prevStepId = '';\n    let prevRunStep: t.RunStep | undefined;\n    try {\n      prevStepId = graph.getStepIdByKey(stepKey);\n      prevRunStep = graph.getRunStep(prevStepId);\n    } catch {\n      // no previous step\n    }\n\n    /**\n     * If the previous step is TOOL_CALLS (from handleToolCallChunks or a prior\n     * iteration), either reuse it (if empty) or dispatch a new TOOL_CALLS step\n     * directly — skip the intermediate MESSAGE_CREATION to avoid orphaned gaps.\n     */\n    if (prevRunStep?.type === StepTypes.TOOL_CALLS) {\n      const details = prevRunStep.stepDetails as t.ToolCallsDetails;\n      const isEmpty = !details.tool_calls || details.tool_calls.length === 0;\n      if (isEmpty && prevStepId !== reusedChunkStepId) {\n        graph.toolCallStepIds.set(toolCallId, prevStepId);\n        reusedChunkStepId = prevStepId;\n        continue;\n      }\n      await graph.dispatchRunStep(\n        stepKey,\n        { type: StepTypes.TOOL_CALLS, tool_calls: [tool_call] },\n        metadata\n      );\n      continue;\n    }\n\n    /**\n     * NOTE: We do NOT dispatch empty text blocks with tool_call_ids because:\n     * - Empty text blocks cause providers (Anthropic, Bedrock) to reject messages\n     * - They get stored in conversation history and cause errors on replay:\n     *   \"messages must have non-empty content\" (Anthropic)\n     *   \"The content field in the Message object is empty\" (Bedrock)\n     * - The tool_calls themselves are sufficient\n     */\n    if (prevStepId && prevRunStep) {\n      graph.messageStepHasToolCalls.set(prevStepId, true);\n    } else if (!prevRunStep) {\n      const messageId = getMessageId(stepKey, graph, true) ?? '';\n      const stepId = await graph.dispatchRunStep(\n        stepKey,\n        {\n          type: StepTypes.MESSAGE_CREATION,\n          message_creation: {\n            message_id: messageId,\n          },\n        },\n        metadata\n      );\n      graph.messageStepHasToolCalls.set(stepId, true);\n    }\n\n    await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.TOOL_CALLS,\n        tool_calls: [tool_call],\n      },\n      metadata\n    );\n  }\n};\n\nexport const toolResultTypes = new Set([\n  // 'tool_use',\n  // 'server_tool_use',\n  // 'input_json_delta',\n  'tool_result',\n  'web_search_result',\n  'web_search_tool_result',\n]);\n\n/**\n * Handles the result of a server tool call; in other words, a provider's built-in tool.\n * As of 2025-07-06, only Anthropic handles server tool calls with this pattern.\n */\nexport async function handleServerToolResult({\n  graph,\n  content,\n  metadata,\n  agentContext,\n}: {\n  graph: StandardGraph | MultiAgentGraph;\n  content?: string | t.MessageContentComplex[];\n  metadata?: Record<string, unknown>;\n  agentContext?: AgentContext;\n}): Promise<boolean> {\n  let skipHandling = false;\n  if (agentContext?.provider !== Providers.ANTHROPIC) {\n    return skipHandling;\n  }\n  if (\n    typeof content === 'string' ||\n    content == null ||\n    content.length === 0 ||\n    (content.length === 1 &&\n      (content[0] as t.ToolResultContent).tool_use_id == null)\n  ) {\n    return skipHandling;\n  }\n\n  for (const contentPart of content) {\n    const toolUseId = (contentPart as t.ToolResultContent).tool_use_id;\n    if (toolUseId == null || toolUseId === '') {\n      continue;\n    }\n    const stepId = graph.toolCallStepIds.get(toolUseId);\n    if (stepId == null || stepId === '') {\n      console.warn(\n        `Tool use ID ${toolUseId} not found in graph, cannot dispatch tool result.`\n      );\n      continue;\n    }\n    const runStep = graph.getRunStep(stepId);\n    if (!runStep) {\n      console.warn(\n        `Run step for ${stepId} does not exist, cannot dispatch tool result.`\n      );\n      continue;\n    } else if (runStep.type !== StepTypes.TOOL_CALLS) {\n      console.warn(\n        `Run step for ${stepId} is not a tool call step, cannot dispatch tool result.`\n      );\n      continue;\n    }\n\n    const toolCall =\n      runStep.stepDetails.type === StepTypes.TOOL_CALLS\n        ? (runStep.stepDetails.tool_calls?.find(\n          (toolCall) => toolCall.id === toolUseId\n        ) as ToolCall)\n        : undefined;\n\n    if (!toolCall) {\n      continue;\n    }\n\n    if (\n      contentPart.type === 'web_search_result' ||\n      contentPart.type === 'web_search_tool_result'\n    ) {\n      await handleAnthropicSearchResults({\n        contentPart: contentPart as t.ToolResultContent,\n        toolCall,\n        metadata,\n        graph,\n      });\n    }\n\n    if (!skipHandling) {\n      skipHandling = true;\n    }\n  }\n\n  return skipHandling;\n}\n\nasync function handleAnthropicSearchResults({\n  contentPart,\n  toolCall,\n  metadata,\n  graph,\n}: {\n  contentPart: t.ToolResultContent;\n  toolCall: Partial<ToolCall>;\n  metadata?: Record<string, unknown>;\n  graph: StandardGraph | MultiAgentGraph;\n}): Promise<void> {\n  if (!Array.isArray(contentPart.content)) {\n    console.warn(\n      `Expected content to be an array, got ${typeof contentPart.content}`\n    );\n    return;\n  }\n\n  if (!isAnthropicWebSearchResult(contentPart.content[0])) {\n    console.warn(\n      `Expected content to be an Anthropic web search result, got ${JSON.stringify(\n        contentPart.content\n      )}`\n    );\n    return;\n  }\n\n  const turn = graph.invokedToolIds?.size ?? 0;\n  const searchResultData = coerceAnthropicSearchResults({\n    turn,\n    results: contentPart.content as AnthropicWebSearchResultBlockParam[],\n  });\n\n  const name = toolCall.name;\n  const input = toolCall.args ?? {};\n  const artifact = {\n    [Constants.WEB_SEARCH]: searchResultData,\n  };\n  const { output: formattedOutput } = formatResultsForLLM(\n    turn,\n    searchResultData\n  );\n  const output = new ToolMessage({\n    name,\n    artifact,\n    content: formattedOutput,\n    tool_call_id: toolCall.id!,\n  });\n  const toolEndData: t.ToolEndData = {\n    input,\n    output,\n  };\n  await graph.handlerRegistry\n    ?.getHandler(GraphEvents.TOOL_END)\n    ?.handle(GraphEvents.TOOL_END, toolEndData, metadata, graph);\n\n  if (graph.invokedToolIds == null) {\n    graph.invokedToolIds = new Set<string>();\n  }\n\n  graph.invokedToolIds.add(toolCall.id!);\n}\n"],"names":["getMessageId","StepTypes","ToolCallTypes","nanoid","Providers","isAnthropicWebSearchResult","coerceAnthropicSearchResults","Constants","formatResultsForLLM","ToolMessage","GraphEvents"],"mappings":"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"}
+{"version":3,"file":"handlers.cjs","sources":["../../../src/tools/handlers.ts"],"sourcesContent":["/* eslint-disable no-console */\n// src/tools/handlers.ts\nimport { nanoid } from 'nanoid';\nimport { ToolMessage } from '@langchain/core/messages';\nimport type { ToolCall, ToolCallChunk } from '@langchain/core/messages/tool';\nimport type { AnthropicWebSearchResultBlockParam } from '@/llm/anthropic/types';\nimport type { Graph, MultiAgentGraph, StandardGraph } from '@/graphs';\nimport type { AgentContext } from '@/agents/AgentContext';\nimport type * as t from '@/types';\nimport {\n  coerceAnthropicSearchResults,\n  isAnthropicWebSearchResult,\n} from '@/tools/search/anthropic';\nimport {\n  ToolCallTypes,\n  GraphEvents,\n  StepTypes,\n  Providers,\n  Constants,\n} from '@/common';\nimport { formatResultsForLLM } from '@/tools/search/format';\nimport { getMessageId } from '@/messages';\n\nexport async function handleToolCallChunks({\n  graph,\n  stepKey,\n  toolCallChunks,\n  metadata,\n}: {\n  graph: StandardGraph | MultiAgentGraph;\n  stepKey: string;\n  toolCallChunks: ToolCallChunk[];\n  metadata?: Record<string, unknown>;\n}): Promise<void> {\n  let prevStepId: string;\n  let prevRunStep: t.RunStep | undefined;\n  try {\n    prevStepId = graph.getStepIdByKey(stepKey);\n    prevRunStep = graph.getRunStep(prevStepId);\n  } catch {\n    /** Edge Case: If no previous step exists, create a new message creation step */\n    const message_id = getMessageId(stepKey, graph, true) ?? '';\n    prevStepId = await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.MESSAGE_CREATION,\n        message_creation: {\n          message_id,\n        },\n      },\n      metadata\n    );\n    prevRunStep = graph.getRunStep(prevStepId);\n  }\n\n  const _stepId = graph.getStepIdByKey(stepKey);\n\n  /** Edge Case: Tool Call Run Step or `tool_call_ids` never dispatched */\n  const tool_calls: ToolCall[] | undefined =\n    prevStepId && prevRunStep && prevRunStep.type === StepTypes.MESSAGE_CREATION\n      ? []\n      : undefined;\n\n  /** Edge Case: `id` and `name` fields cannot be empty strings */\n  for (const toolCallChunk of toolCallChunks) {\n    if (toolCallChunk.name === '') {\n      toolCallChunk.name = undefined;\n    }\n    if (toolCallChunk.id === '') {\n      toolCallChunk.id = undefined;\n    } else if (\n      tool_calls != null &&\n      toolCallChunk.id != null &&\n      toolCallChunk.name != null\n    ) {\n      tool_calls.push({\n        args: {},\n        id: toolCallChunk.id,\n        name: toolCallChunk.name,\n        type: ToolCallTypes.TOOL_CALL,\n      });\n    }\n  }\n\n  let stepId: string = _stepId;\n  const alreadyDispatched =\n    prevRunStep?.type === StepTypes.MESSAGE_CREATION &&\n    graph.messageStepHasToolCalls.has(prevStepId);\n\n  if (prevRunStep?.type === StepTypes.TOOL_CALLS) {\n    /**\n     * If previous step is already a tool_calls step, use that step ID\n     * This ensures tool call deltas are dispatched to the correct step\n     */\n    stepId = prevStepId;\n  } else if (\n    !alreadyDispatched &&\n    prevRunStep?.type === StepTypes.MESSAGE_CREATION\n  ) {\n    /**\n     * Create tool_calls step as soon as we receive the first tool call chunk\n     * This ensures deltas are always associated with the correct step\n     *\n     * NOTE: We do NOT dispatch an empty text block here because:\n     * - Empty text blocks cause providers (Anthropic, Bedrock) to reject messages\n     * - The tool_calls themselves are sufficient for the step\n     * - Empty content with tool_call_ids gets stored in conversation history\n     *   and causes \"messages must have non-empty content\" errors on replay\n     */\n    graph.messageStepHasToolCalls.set(prevStepId, true);\n    stepId = await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.TOOL_CALLS,\n        tool_calls: tool_calls ?? [],\n      },\n      metadata\n    );\n  }\n\n  await graph.dispatchRunStepDelta(\n    stepId,\n    {\n      type: StepTypes.TOOL_CALLS,\n      tool_calls: toolCallChunks,\n    },\n    metadata\n  );\n}\n\nexport const handleToolCalls = async (\n  toolCalls?: ToolCall[],\n  metadata?: Record<string, unknown>,\n  graph?: Graph | StandardGraph | MultiAgentGraph\n): Promise<void> => {\n  if (!graph || !metadata) {\n    console.warn('Graph or metadata not found in `handleToolCalls`');\n    return;\n  }\n\n  if (!toolCalls) {\n    return;\n  }\n\n  if (toolCalls.length === 0) {\n    return;\n  }\n\n  const stepKey = graph.getStepKey(metadata);\n\n  /**\n   * Track whether we've already reused an empty TOOL_CALLS step created by\n   * handleToolCallChunks during streaming. Only reuse it once (for the first\n   * tool call); subsequent parallel tool calls must create their own steps.\n   */\n  let reusedChunkStepId: string | undefined;\n\n  for (const tool_call of toolCalls) {\n    const toolCallId = tool_call.id ?? `toolu_${nanoid()}`;\n    tool_call.id = toolCallId;\n    if (!toolCallId || graph.toolCallStepIds.has(toolCallId)) {\n      continue;\n    }\n\n    let prevStepId = '';\n    let prevRunStep: t.RunStep | undefined;\n    try {\n      prevStepId = graph.getStepIdByKey(stepKey);\n      prevRunStep = graph.getRunStep(prevStepId);\n    } catch {\n      // no previous step\n    }\n\n    /**\n     * If the previous step is TOOL_CALLS (from handleToolCallChunks or a prior\n     * iteration), either reuse it (if empty) or dispatch a new TOOL_CALLS step\n     * directly — skip the intermediate MESSAGE_CREATION to avoid orphaned gaps.\n     */\n    if (prevRunStep?.type === StepTypes.TOOL_CALLS) {\n      const details = prevRunStep.stepDetails as t.ToolCallsDetails;\n      const isEmpty = !details.tool_calls || details.tool_calls.length === 0;\n      if (isEmpty && prevStepId !== reusedChunkStepId) {\n        graph.toolCallStepIds.set(toolCallId, prevStepId);\n        reusedChunkStepId = prevStepId;\n        continue;\n      }\n      await graph.dispatchRunStep(\n        stepKey,\n        { type: StepTypes.TOOL_CALLS, tool_calls: [tool_call] },\n        metadata\n      );\n      continue;\n    }\n\n    /**\n     * NOTE: We do NOT dispatch empty text blocks with tool_call_ids because:\n     * - Empty text blocks cause providers (Anthropic, Bedrock) to reject messages\n     * - They get stored in conversation history and cause errors on replay:\n     *   \"messages must have non-empty content\" (Anthropic)\n     *   \"The content field in the Message object is empty\" (Bedrock)\n     * - The tool_calls themselves are sufficient\n     */\n    if (prevStepId && prevRunStep) {\n      graph.messageStepHasToolCalls.set(prevStepId, true);\n    } else if (!prevRunStep) {\n      const messageId = getMessageId(stepKey, graph, true) ?? '';\n      const stepId = await graph.dispatchRunStep(\n        stepKey,\n        {\n          type: StepTypes.MESSAGE_CREATION,\n          message_creation: {\n            message_id: messageId,\n          },\n        },\n        metadata\n      );\n      graph.messageStepHasToolCalls.set(stepId, true);\n    }\n\n    await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.TOOL_CALLS,\n        tool_calls: [tool_call],\n      },\n      metadata\n    );\n  }\n};\n\nexport const toolResultTypes = new Set([\n  // 'tool_use',\n  // 'server_tool_use',\n  // 'input_json_delta',\n  'tool_result',\n  'web_search_result',\n  'web_search_tool_result',\n]);\n\n/**\n * Handles the result of a server tool call; in other words, a provider's built-in tool.\n * As of 2025-07-06, only Anthropic handles server tool calls with this pattern.\n */\nexport async function handleServerToolResult({\n  graph,\n  content,\n  metadata,\n  agentContext,\n}: {\n  graph: StandardGraph | MultiAgentGraph;\n  content?: string | t.MessageContentComplex[];\n  metadata?: Record<string, unknown>;\n  agentContext?: AgentContext;\n}): Promise<boolean> {\n  let skipHandling = false;\n  if (agentContext?.provider !== Providers.ANTHROPIC) {\n    return skipHandling;\n  }\n  if (\n    typeof content === 'string' ||\n    content == null ||\n    content.length === 0 ||\n    (content.length === 1 &&\n      (content[0] as t.ToolResultContent).tool_use_id == null)\n  ) {\n    return skipHandling;\n  }\n\n  for (const contentPart of content) {\n    const toolUseId = (contentPart as t.ToolResultContent).tool_use_id;\n    if (toolUseId == null || toolUseId === '') {\n      continue;\n    }\n    const stepId = graph.toolCallStepIds.get(toolUseId);\n    if (stepId == null || stepId === '') {\n      console.warn(\n        `Tool use ID ${toolUseId} not found in graph, cannot dispatch tool result.`\n      );\n      continue;\n    }\n    const runStep = graph.getRunStep(stepId);\n    if (!runStep) {\n      console.warn(\n        `Run step for ${stepId} does not exist, cannot dispatch tool result.`\n      );\n      continue;\n    } else if (runStep.type !== StepTypes.TOOL_CALLS) {\n      console.warn(\n        `Run step for ${stepId} is not a tool call step, cannot dispatch tool result.`\n      );\n      continue;\n    }\n\n    const toolCall =\n      runStep.stepDetails.type === StepTypes.TOOL_CALLS\n        ? (runStep.stepDetails.tool_calls?.find(\n          (toolCall) => toolCall.id === toolUseId\n        ) as ToolCall)\n        : undefined;\n\n    if (!toolCall) {\n      continue;\n    }\n\n    if (\n      contentPart.type === 'web_search_result' ||\n      contentPart.type === 'web_search_tool_result'\n    ) {\n      await handleAnthropicSearchResults({\n        contentPart: contentPart as t.ToolResultContent,\n        toolCall,\n        metadata,\n        graph,\n      });\n    }\n\n    if (!skipHandling) {\n      skipHandling = true;\n    }\n  }\n\n  return skipHandling;\n}\n\nasync function handleAnthropicSearchResults({\n  contentPart,\n  toolCall,\n  metadata,\n  graph,\n}: {\n  contentPart: t.ToolResultContent;\n  toolCall: Partial<ToolCall>;\n  metadata?: Record<string, unknown>;\n  graph: StandardGraph | MultiAgentGraph;\n}): Promise<void> {\n  if (!Array.isArray(contentPart.content)) {\n    console.warn(\n      `Expected content to be an array, got ${typeof contentPart.content}`\n    );\n    return;\n  }\n\n  if (!isAnthropicWebSearchResult(contentPart.content[0])) {\n    console.warn(\n      `Expected content to be an Anthropic web search result, got ${JSON.stringify(\n        contentPart.content\n      )}`\n    );\n    return;\n  }\n\n  const turn = graph.invokedToolIds?.size ?? 0;\n  const searchResultData = coerceAnthropicSearchResults({\n    turn,\n    results: contentPart.content as AnthropicWebSearchResultBlockParam[],\n  });\n\n  const name = toolCall.name;\n  const input = toolCall.args ?? {};\n  const artifact = {\n    [Constants.WEB_SEARCH]: searchResultData,\n  };\n  const { output: formattedOutput } = formatResultsForLLM(\n    turn,\n    searchResultData\n  );\n  const output = new ToolMessage({\n    name,\n    artifact,\n    content: formattedOutput,\n    tool_call_id: toolCall.id!,\n  });\n  const toolEndData: t.ToolEndData = {\n    input,\n    output,\n  };\n  await graph.handlerRegistry\n    ?.getHandler(GraphEvents.TOOL_END)\n    ?.handle(GraphEvents.TOOL_END, toolEndData, metadata, graph);\n\n  if (graph.invokedToolIds == null) {\n    graph.invokedToolIds = new Set<string>();\n  }\n\n  graph.invokedToolIds.add(toolCall.id!);\n}\n"],"names":["getMessageId","StepTypes","ToolCallTypes","nanoid","Providers","isAnthropicWebSearchResult","coerceAnthropicSearchResults","Constants","formatResultsForLLM","ToolMessage","GraphEvents"],"mappings":";;;;;;;;;;;;;AAAA;AACA;AAsBO,eAAe,oBAAoB,CAAC,EACzC,KAAK,EACL,OAAO,EACP,cAAc,EACd,QAAQ,GAMT,EAAA;AACC,IAAA,IAAI,UAAkB;AACtB,IAAA,IAAI,WAAkC;AACtC,IAAA,IAAI;AACF,QAAA,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC;AAC1C,QAAA,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;IAC5C;AAAE,IAAA,MAAM;;AAEN,QAAA,MAAM,UAAU,GAAGA,gBAAY,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE;AAC3D,QAAA,UAAU,GAAG,MAAM,KAAK,CAAC,eAAe,CACtC,OAAO,EACP;YACE,IAAI,EAAEC,eAAS,CAAC,gBAAgB;AAChC,YAAA,gBAAgB,EAAE;gBAChB,UAAU;AACX,aAAA;SACF,EACD,QAAQ,CACT;AACD,QAAA,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;IAC5C;IAEA,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC;;AAG7C,IAAA,MAAM,UAAU,GACd,UAAU,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,KAAKA,eAAS,CAAC;AAC1D,UAAE;UACA,SAAS;;AAGf,IAAA,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE;AAC1C,QAAA,IAAI,aAAa,CAAC,IAAI,KAAK,EAAE,EAAE;AAC7B,YAAA,aAAa,CAAC,IAAI,GAAG,SAAS;QAChC;AACA,QAAA,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE;AAC3B,YAAA,aAAa,CAAC,EAAE,GAAG,SAAS;QAC9B;aAAO,IACL,UAAU,IAAI,IAAI;YAClB,aAAa,CAAC,EAAE,IAAI,IAAI;AACxB,YAAA,aAAa,CAAC,IAAI,IAAI,IAAI,EAC1B;YACA,UAAU,CAAC,IAAI,CAAC;AACd,gBAAA,IAAI,EAAE,EAAE;gBACR,EAAE,EAAE,aAAa,CAAC,EAAE;gBACpB,IAAI,EAAE,aAAa,CAAC,IAAI;gBACxB,IAAI,EAAEC,mBAAa,CAAC,SAAS;AAC9B,aAAA,CAAC;QACJ;IACF;IAEA,IAAI,MAAM,GAAW,OAAO;IAC5B,MAAM,iBAAiB,GACrB,WAAW,EAAE,IAAI,KAAKD,eAAS,CAAC,gBAAgB;AAChD,QAAA,KAAK,CAAC,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC;IAE/C,IAAI,WAAW,EAAE,IAAI,KAAKA,eAAS,CAAC,UAAU,EAAE;AAC9C;;;AAGG;QACH,MAAM,GAAG,UAAU;IACrB;AAAO,SAAA,IACL,CAAC,iBAAiB;AAClB,QAAA,WAAW,EAAE,IAAI,KAAKA,eAAS,CAAC,gBAAgB,EAChD;AACA;;;;;;;;;AASG;QACH,KAAK,CAAC,uBAAuB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC;AACnD,QAAA,MAAM,GAAG,MAAM,KAAK,CAAC,eAAe,CAClC,OAAO,EACP;YACE,IAAI,EAAEA,eAAS,CAAC,UAAU;YAC1B,UAAU,EAAE,UAAU,IAAI,EAAE;SAC7B,EACD,QAAQ,CACT;IACH;AAEA,IAAA,MAAM,KAAK,CAAC,oBAAoB,CAC9B,MAAM,EACN;QACE,IAAI,EAAEA,eAAS,CAAC,UAAU;AAC1B,QAAA,UAAU,EAAE,cAAc;KAC3B,EACD,QAAQ,CACT;AACH;AAEO,MAAM,eAAe,GAAG,OAC7B,SAAsB,EACtB,QAAkC,EAClC,KAA+C,KAC9B;AACjB,IAAA,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE;AACvB,QAAA,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC;QAChE;IACF;IAEA,IAAI,CAAC,SAAS,EAAE;QACd;IACF;AAEA,IAAA,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;QAC1B;IACF;IAEA,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;AAE1C;;;;AAIG;AACH,IAAA,IAAI,iBAAqC;AAEzC,IAAA,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE;QACjC,MAAM,UAAU,GAAG,SAAS,CAAC,EAAE,IAAI,CAAA,MAAA,EAASE,aAAM,EAAE,CAAA,CAAE;AACtD,QAAA,SAAS,CAAC,EAAE,GAAG,UAAU;AACzB,QAAA,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;YACxD;QACF;QAEA,IAAI,UAAU,GAAG,EAAE;AACnB,QAAA,IAAI,WAAkC;AACtC,QAAA,IAAI;AACF,YAAA,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC;AAC1C,YAAA,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;QAC5C;AAAE,QAAA,MAAM;;QAER;AAEA;;;;AAIG;QACH,IAAI,WAAW,EAAE,IAAI,KAAKF,eAAS,CAAC,UAAU,EAAE;AAC9C,YAAA,MAAM,OAAO,GAAG,WAAW,CAAC,WAAiC;AAC7D,YAAA,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;AACtE,YAAA,IAAI,OAAO,IAAI,UAAU,KAAK,iBAAiB,EAAE;gBAC/C,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC;gBACjD,iBAAiB,GAAG,UAAU;gBAC9B;YACF;YACA,MAAM,KAAK,CAAC,eAAe,CACzB,OAAO,EACP,EAAE,IAAI,EAAEA,eAAS,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE,EACvD,QAAQ,CACT;YACD;QACF;AAEA;;;;;;;AAOG;AACH,QAAA,IAAI,UAAU,IAAI,WAAW,EAAE;YAC7B,KAAK,CAAC,uBAAuB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC;QACrD;aAAO,IAAI,CAAC,WAAW,EAAE;AACvB,YAAA,MAAM,SAAS,GAAGD,gBAAY,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE;YAC1D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,eAAe,CACxC,OAAO,EACP;gBACE,IAAI,EAAEC,eAAS,CAAC,gBAAgB;AAChC,gBAAA,gBAAgB,EAAE;AAChB,oBAAA,UAAU,EAAE,SAAS;AACtB,iBAAA;aACF,EACD,QAAQ,CACT;YACD,KAAK,CAAC,uBAAuB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;QACjD;AAEA,QAAA,MAAM,KAAK,CAAC,eAAe,CACzB,OAAO,EACP;YACE,IAAI,EAAEA,eAAS,CAAC,UAAU;YAC1B,UAAU,EAAE,CAAC,SAAS,CAAC;SACxB,EACD,QAAQ,CACT;IACH;AACF;AAEO,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;;;;IAIrC,aAAa;IACb,mBAAmB;IACnB,wBAAwB;AACzB,CAAA;AAED;;;AAGG;AACI,eAAe,sBAAsB,CAAC,EAC3C,KAAK,EACL,OAAO,EACP,QAAQ,EACR,YAAY,GAMb,EAAA;IACC,IAAI,YAAY,GAAG,KAAK;IACxB,IAAI,YAAY,EAAE,QAAQ,KAAKG,eAAS,CAAC,SAAS,EAAE;AAClD,QAAA,OAAO,YAAY;IACrB;IACA,IACE,OAAO,OAAO,KAAK,QAAQ;AAC3B,QAAA,OAAO,IAAI,IAAI;QACf,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,SAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAClB,OAAO,CAAC,CAAC,CAAyB,CAAC,WAAW,IAAI,IAAI,CAAC,EAC1D;AACA,QAAA,OAAO,YAAY;IACrB;AAEA,IAAA,KAAK,MAAM,WAAW,IAAI,OAAO,EAAE;AACjC,QAAA,MAAM,SAAS,GAAI,WAAmC,CAAC,WAAW;QAClE,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,KAAK,EAAE,EAAE;YACzC;QACF;QACA,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC;QACnD,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,EAAE,EAAE;AACnC,YAAA,OAAO,CAAC,IAAI,CACV,eAAe,SAAS,CAAA,iDAAA,CAAmD,CAC5E;YACD;QACF;QACA,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE;AACZ,YAAA,OAAO,CAAC,IAAI,CACV,gBAAgB,MAAM,CAAA,6CAAA,CAA+C,CACtE;YACD;QACF;aAAO,IAAI,OAAO,CAAC,IAAI,KAAKH,eAAS,CAAC,UAAU,EAAE;AAChD,YAAA,OAAO,CAAC,IAAI,CACV,gBAAgB,MAAM,CAAA,sDAAA,CAAwD,CAC/E;YACD;QACF;QAEA,MAAM,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,IAAI,KAAKA,eAAS,CAAC;AACrC,cAAG,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CACrC,CAAC,QAAQ,KAAK,QAAQ,CAAC,EAAE,KAAK,SAAS;cAEvC,SAAS;QAEf,IAAI,CAAC,QAAQ,EAAE;YACb;QACF;AAEA,QAAA,IACE,WAAW,CAAC,IAAI,KAAK,mBAAmB;AACxC,YAAA,WAAW,CAAC,IAAI,KAAK,wBAAwB,EAC7C;AACA,YAAA,MAAM,4BAA4B,CAAC;AACjC,gBAAA,WAAW,EAAE,WAAkC;gBAC/C,QAAQ;gBACR,QAAQ;gBACR,KAAK;AACN,aAAA,CAAC;QACJ;QAEA,IAAI,CAAC,YAAY,EAAE;YACjB,YAAY,GAAG,IAAI;QACrB;IACF;AAEA,IAAA,OAAO,YAAY;AACrB;AAEA,eAAe,4BAA4B,CAAC,EAC1C,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,KAAK,GAMN,EAAA;IACC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE;QACvC,OAAO,CAAC,IAAI,CACV,CAAA,qCAAA,EAAwC,OAAO,WAAW,CAAC,OAAO,CAAA,CAAE,CACrE;QACD;IACF;IAEA,IAAI,CAACI,oCAA0B,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;AACvD,QAAA,OAAO,CAAC,IAAI,CACV,CAAA,2DAAA,EAA8D,IAAI,CAAC,SAAS,CAC1E,WAAW,CAAC,OAAO,CACpB,CAAA,CAAE,CACJ;QACD;IACF;IAEA,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC;IAC5C,MAAM,gBAAgB,GAAGC,sCAA4B,CAAC;QACpD,IAAI;QACJ,OAAO,EAAE,WAAW,CAAC,OAA+C;AACrE,KAAA,CAAC;AAEF,IAAA,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI;AAC1B,IAAA,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE;AACjC,IAAA,MAAM,QAAQ,GAAG;AACf,QAAA,CAACC,eAAS,CAAC,UAAU,GAAG,gBAAgB;KACzC;AACD,IAAA,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAGC,0BAAmB,CACrD,IAAI,EACJ,gBAAgB,CACjB;AACD,IAAA,MAAM,MAAM,GAAG,IAAIC,oBAAW,CAAC;QAC7B,IAAI;QACJ,QAAQ;AACR,QAAA,OAAO,EAAE,eAAe;QACxB,YAAY,EAAE,QAAQ,CAAC,EAAG;AAC3B,KAAA,CAAC;AACF,IAAA,MAAM,WAAW,GAAkB;QACjC,KAAK;QACL,MAAM;KACP;IACD,MAAM,KAAK,CAAC;AACV,UAAE,UAAU,CAACC,iBAAW,CAAC,QAAQ;AACjC,UAAE,MAAM,CAACA,iBAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC;AAE9D,IAAA,IAAI,KAAK,CAAC,cAAc,IAAI,IAAI,EAAE;AAChC,QAAA,KAAK,CAAC,cAAc,GAAG,IAAI,GAAG,EAAU;IAC1C;IAEA,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAG,CAAC;AACxC;;;;;;;"}

package/dist/cjs/tools/local/CompileCheckTool.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"CompileCheckTool.cjs","sources":["../../../../src/tools/local/CompileCheckTool.ts"],"sourcesContent":["/**\n * `compile_check` — a thin LLM-callable wrapper around the project's\n * standard typecheck/lint command. Lets the agent answer \"did my\n * change break anything?\" without us shipping a real LSP client.\n *\n * Auto-detection priority (first hit wins):\n *\n *   1. `local.compileCheck.command`            — explicit override\n *   2. `tsconfig.json`                          → `npx --no-install tsc --noEmit`\n *   3. `package.json` with a typescript dep    → same as 2\n *   4. `pyproject.toml` or `setup.py` / `setup.cfg`\n *      with a dev dep on mypy                  → `python3 -m mypy .`\n *      else                                    → `python3 -m py_compile <every .py>`\n *      (bounded by find-walk so node_modules\n *      and `.venv` don't blow up)\n *   5. `Cargo.toml`                            → `cargo check --message-format=short`\n *   6. `go.mod`                                → `go vet ./...`\n *   7. otherwise                               → tells the agent there's\n *                                                 no detected toolchain.\n *\n * Output is the spawn process's stdout/stderr passed through\n * `truncateLocalOutput` so a 10MB tsc dump can't blow context. The\n * exit code is reported.\n */\n\nimport { resolve } from 'path';\nimport { tool } from '@langchain/core/tools';\nimport type { DynamicStructuredTool } from '@langchain/core/tools';\nimport type * as t from '@/types';\nimport {\n  getLocalCwd,\n  getWorkspaceFS,\n  spawnLocalProcess,\n  truncateLocalOutput,\n  validateBashCommand,\n} from './LocalExecutionEngine';\nimport type { WorkspaceFS } from './workspaceFS';\nimport { Constants } from '@/common';\n\n/** Back-compat alias; canonical name lives on `Constants.COMPILE_CHECK`. */\nexport const CompileCheckToolName = Constants.COMPILE_CHECK;\n\nconst CompileCheckSchema: t.JsonSchemaType = {\n  type: 'object',\n  properties: {\n    command: {\n      type: 'string',\n      description:\n        'Optional explicit command to run instead of the auto-detected one. Runs verbatim from the local engine cwd; honours the standard sandbox/AST gate.',\n    },\n    timeout_ms: {\n      type: 'integer',\n      description:\n        'Optional timeout in milliseconds. Defaults to 120000 (2 min).',\n    },\n  },\n};\n\ntype DetectedKind =\n  | 'typescript'\n  | 'python-mypy'\n  | 'python-compile'\n  | 'rust'\n  | 'go'\n  | 'unknown';\n\ntype Detection = {\n  kind: DetectedKind;\n  command: string;\n  reason: string;\n};\n\nasync function pathExists(fs: WorkspaceFS, p: string): Promise<boolean> {\n  try {\n    await fs.stat(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// Probes for project markers via the configured WorkspaceFS so a Run\n// with `local.exec.fs` (in-memory or remote engine) detects the right\n// toolchain against the actual workspace — not the host filesystem.\n// Codex P1 #25.\nasync function detect(cwd: string, fs: WorkspaceFS): Promise<Detection> {\n  if (await pathExists(fs, resolve(cwd, 'tsconfig.json'))) {\n    return {\n      kind: 'typescript',\n      command: 'npx --no-install tsc --noEmit',\n      reason: 'tsconfig.json present',\n    };\n  }\n  if (await pathExists(fs, resolve(cwd, 'package.json'))) {\n    const pkgRaw = await fs\n      .readFile(resolve(cwd, 'package.json'), 'utf8')\n      .catch(() => '');\n    if (pkgRaw.includes('\"typescript\"')) {\n      return {\n        kind: 'typescript',\n        command: 'npx --no-install tsc --noEmit',\n        reason: 'package.json declares typescript',\n      };\n    }\n  }\n  if (await pathExists(fs, resolve(cwd, 'Cargo.toml'))) {\n    return {\n      kind: 'rust',\n      command: 'cargo check --message-format=short',\n      reason: 'Cargo.toml present',\n    };\n  }\n  if (await pathExists(fs, resolve(cwd, 'go.mod'))) {\n    return {\n      kind: 'go',\n      command: 'go vet ./...',\n      reason: 'go.mod present',\n    };\n  }\n  if (\n    (await pathExists(fs, resolve(cwd, 'pyproject.toml'))) ||\n    (await pathExists(fs, resolve(cwd, 'setup.py'))) ||\n    (await pathExists(fs, resolve(cwd, 'setup.cfg')))\n  ) {\n    const pyToml = await fs\n      .readFile(resolve(cwd, 'pyproject.toml'), 'utf8')\n      .catch(() => '');\n    if (pyToml.includes('mypy')) {\n      return {\n        kind: 'python-mypy',\n        command: 'python3 -m mypy .',\n        reason: 'pyproject.toml declares mypy',\n      };\n    }\n    return {\n      kind: 'python-compile',\n      command:\n        'python3 -c \"import compileall, sys; sys.exit(0 if compileall.compile_dir(\\'.\\', quiet=1, rx=__import__(\\'re\\').compile(r\\'(node_modules|\\\\.venv|\\\\.git|build|dist)\\')) else 1)\"',\n      reason: 'Python project (no mypy detected)',\n    };\n  }\n  return {\n    kind: 'unknown',\n    command: '',\n    reason:\n      'no recognised project marker (tsconfig.json, package.json[typescript], Cargo.toml, go.mod, pyproject.toml, setup.py)',\n  };\n}\n\nconst DEFAULT_TIMEOUT_MS = 120_000;\n\nexport function createCompileCheckTool(\n  config: t.LocalExecutionConfig = {}\n): DynamicStructuredTool {\n  return tool(\n    async (rawInput) => {\n      const input = rawInput as {\n        command?: string;\n        timeout_ms?: number;\n      };\n      const cwd = getLocalCwd(config);\n      const fs = getWorkspaceFS(config);\n      const overrideCommand = input.command ?? config.compileCheck?.command;\n      let detection: Detection;\n      if (overrideCommand != null && overrideCommand.trim() !== '') {\n        detection = {\n          kind: 'unknown',\n          command: overrideCommand,\n          reason: 'explicit override',\n        };\n      } else {\n        detection = await detect(cwd, fs);\n      }\n\n      if (detection.command === '') {\n        const explainer =\n          `compile_check: ${detection.reason}. Pass an explicit \\`command\\` (e.g. \\`npm run typecheck\\`) to override.`;\n        return [\n          explainer,\n          {\n            kind: detection.kind,\n            ran: false,\n            reason: detection.reason,\n            cwd,\n          },\n        ];\n      }\n\n      // Codex P1 #21: route the resolved command through the same\n      // safety gates the rest of the local engine uses. Without this\n      // a host with `readOnly: true` (or relying on the destructive-\n      // command guard) could be bypassed by passing a `command`\n      // override to compile_check that performs writes/deletes.\n      // Auto-detected commands (tsc/cargo/etc.) pass these gates\n      // unchanged — the validation is only blocking for genuinely\n      // mutating overrides.\n      const validation = await validateBashCommand(detection.command, config);\n      if (!validation.valid) {\n        const explainer =\n          `compile_check refused to run \\`${detection.command}\\`: ${validation.errors.join('; ')}`;\n        return [\n          explainer,\n          {\n            kind: detection.kind,\n            ran: false,\n            reason: validation.errors.join('; '),\n            cwd,\n          },\n        ];\n      }\n\n      const timeoutMs =\n        input.timeout_ms ??\n        config.compileCheck?.timeoutMs ??\n        DEFAULT_TIMEOUT_MS;\n      const result = await spawnLocalProcess(\n        config.shell ?? (process.platform === 'win32' ? 'bash.exe' : 'bash'),\n        ['-lc', detection.command],\n        {\n          ...config,\n          timeoutMs,\n          maxOutputChars: config.maxOutputChars ?? 8000,\n        }\n      );\n\n      const passed =\n        result.exitCode === 0 && !result.timedOut;\n      const headline = passed\n        ? `compile_check (${detection.kind}) PASSED via \\`${detection.command}\\``\n        : `compile_check (${detection.kind}) FAILED via \\`${detection.command}\\` ` +\n          `(exit=${result.exitCode ?? 'unknown'}${result.timedOut ? ', timed_out=true' : ''})`;\n\n      let body = '';\n      if (result.stdout !== '') {\n        body += `\\n\\nstdout:\\n${truncateLocalOutput(result.stdout, 4000)}`;\n      }\n      if (result.stderr !== '') {\n        body += `\\n\\nstderr:\\n${truncateLocalOutput(result.stderr, 4000)}`;\n      }\n      if (result.fullOutputPath != null) {\n        body += `\\n\\nfull_output_path: ${result.fullOutputPath}`;\n      }\n      const summary = `${headline}${body}\\n\\nworking_directory: ${cwd}\\nreason: ${detection.reason}`;\n\n      return [\n        summary,\n        {\n          kind: detection.kind,\n          ran: true,\n          passed,\n          exit_code: result.exitCode,\n          timed_out: result.timedOut,\n          command: detection.command,\n          cwd,\n        },\n      ];\n    },\n    {\n      name: CompileCheckToolName,\n      description:\n        'Run the project\\'s standard typecheck or lint pass and return its output. Auto-detects from project markers (tsconfig.json/package.json -> tsc; Cargo.toml -> cargo check; go.mod -> go vet; pyproject.toml -> mypy or py_compile). Pass `command` to override.',\n      schema: CompileCheckSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\nexport function createCompileCheckToolDefinition(): t.LCTool {\n  return {\n    name: CompileCheckToolName,\n    description:\n      'Run the project\\'s standard typecheck or lint pass and return its output.',\n    parameters: CompileCheckSchema,\n    allowed_callers: ['direct', 'code_execution'],\n    responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    toolType: 'builtin',\n  };\n}\n"],"names":["Constants","resolve","tool","getLocalCwd","getWorkspaceFS","validateBashCommand","spawnLocalProcess","truncateLocalOutput"],"mappings":"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"}
+{"version":3,"file":"CompileCheckTool.cjs","sources":["../../../../src/tools/local/CompileCheckTool.ts"],"sourcesContent":["/**\n * `compile_check` — a thin LLM-callable wrapper around the project's\n * standard typecheck/lint command. Lets the agent answer \"did my\n * change break anything?\" without us shipping a real LSP client.\n *\n * Auto-detection priority (first hit wins):\n *\n *   1. `local.compileCheck.command`            — explicit override\n *   2. `tsconfig.json`                          → `npx --no-install tsc --noEmit`\n *   3. `package.json` with a typescript dep    → same as 2\n *   4. `pyproject.toml` or `setup.py` / `setup.cfg`\n *      with a dev dep on mypy                  → `python3 -m mypy .`\n *      else                                    → `python3 -m py_compile <every .py>`\n *      (bounded by find-walk so node_modules\n *      and `.venv` don't blow up)\n *   5. `Cargo.toml`                            → `cargo check --message-format=short`\n *   6. `go.mod`                                → `go vet ./...`\n *   7. otherwise                               → tells the agent there's\n *                                                 no detected toolchain.\n *\n * Output is the spawn process's stdout/stderr passed through\n * `truncateLocalOutput` so a 10MB tsc dump can't blow context. The\n * exit code is reported.\n */\n\nimport { resolve } from 'path';\nimport { tool } from '@langchain/core/tools';\nimport type { DynamicStructuredTool } from '@langchain/core/tools';\nimport type { WorkspaceFS } from './workspaceFS';\nimport type * as t from '@/types';\nimport {\n  getLocalCwd,\n  getWorkspaceFS,\n  spawnLocalProcess,\n  truncateLocalOutput,\n  validateBashCommand,\n} from './LocalExecutionEngine';\nimport { Constants } from '@/common';\n\n/** Back-compat alias; canonical name lives on `Constants.COMPILE_CHECK`. */\nexport const CompileCheckToolName = Constants.COMPILE_CHECK;\n\nconst CompileCheckSchema: t.JsonSchemaType = {\n  type: 'object',\n  properties: {\n    command: {\n      type: 'string',\n      description:\n        'Optional explicit command to run instead of the auto-detected one. Runs verbatim from the local engine cwd; honours the standard sandbox/AST gate.',\n    },\n    timeout_ms: {\n      type: 'integer',\n      description:\n        'Optional timeout in milliseconds. Defaults to 120000 (2 min).',\n    },\n  },\n};\n\ntype DetectedKind =\n  | 'typescript'\n  | 'python-mypy'\n  | 'python-compile'\n  | 'rust'\n  | 'go'\n  | 'unknown';\n\ntype Detection = {\n  kind: DetectedKind;\n  command: string;\n  reason: string;\n};\n\nasync function pathExists(fs: WorkspaceFS, p: string): Promise<boolean> {\n  try {\n    await fs.stat(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// Probes for project markers via the configured WorkspaceFS so a Run\n// with `local.exec.fs` (in-memory or remote engine) detects the right\n// toolchain against the actual workspace — not the host filesystem.\n// Codex P1 #25.\nasync function detect(cwd: string, fs: WorkspaceFS): Promise<Detection> {\n  if (await pathExists(fs, resolve(cwd, 'tsconfig.json'))) {\n    return {\n      kind: 'typescript',\n      command: 'npx --no-install tsc --noEmit',\n      reason: 'tsconfig.json present',\n    };\n  }\n  if (await pathExists(fs, resolve(cwd, 'package.json'))) {\n    const pkgRaw = await fs\n      .readFile(resolve(cwd, 'package.json'), 'utf8')\n      .catch(() => '');\n    if (pkgRaw.includes('\"typescript\"')) {\n      return {\n        kind: 'typescript',\n        command: 'npx --no-install tsc --noEmit',\n        reason: 'package.json declares typescript',\n      };\n    }\n  }\n  if (await pathExists(fs, resolve(cwd, 'Cargo.toml'))) {\n    return {\n      kind: 'rust',\n      command: 'cargo check --message-format=short',\n      reason: 'Cargo.toml present',\n    };\n  }\n  if (await pathExists(fs, resolve(cwd, 'go.mod'))) {\n    return {\n      kind: 'go',\n      command: 'go vet ./...',\n      reason: 'go.mod present',\n    };\n  }\n  if (\n    (await pathExists(fs, resolve(cwd, 'pyproject.toml'))) ||\n    (await pathExists(fs, resolve(cwd, 'setup.py'))) ||\n    (await pathExists(fs, resolve(cwd, 'setup.cfg')))\n  ) {\n    const pyToml = await fs\n      .readFile(resolve(cwd, 'pyproject.toml'), 'utf8')\n      .catch(() => '');\n    if (pyToml.includes('mypy')) {\n      return {\n        kind: 'python-mypy',\n        command: 'python3 -m mypy .',\n        reason: 'pyproject.toml declares mypy',\n      };\n    }\n    return {\n      kind: 'python-compile',\n      command:\n        'python3 -c \"import compileall, sys; sys.exit(0 if compileall.compile_dir(\\'.\\', quiet=1, rx=__import__(\\'re\\').compile(r\\'(node_modules|\\\\.venv|\\\\.git|build|dist)\\')) else 1)\"',\n      reason: 'Python project (no mypy detected)',\n    };\n  }\n  return {\n    kind: 'unknown',\n    command: '',\n    reason:\n      'no recognised project marker (tsconfig.json, package.json[typescript], Cargo.toml, go.mod, pyproject.toml, setup.py)',\n  };\n}\n\nconst DEFAULT_TIMEOUT_MS = 120_000;\n\nexport function createCompileCheckTool(\n  config: t.LocalExecutionConfig = {}\n): DynamicStructuredTool {\n  return tool(\n    async (rawInput) => {\n      const input = rawInput as {\n        command?: string;\n        timeout_ms?: number;\n      };\n      const cwd = getLocalCwd(config);\n      const fs = getWorkspaceFS(config);\n      const overrideCommand = input.command ?? config.compileCheck?.command;\n      let detection: Detection;\n      if (overrideCommand != null && overrideCommand.trim() !== '') {\n        detection = {\n          kind: 'unknown',\n          command: overrideCommand,\n          reason: 'explicit override',\n        };\n      } else {\n        detection = await detect(cwd, fs);\n      }\n\n      if (detection.command === '') {\n        const explainer = `compile_check: ${detection.reason}. Pass an explicit \\`command\\` (e.g. \\`npm run typecheck\\`) to override.`;\n        return [\n          explainer,\n          {\n            kind: detection.kind,\n            ran: false,\n            reason: detection.reason,\n            cwd,\n          },\n        ];\n      }\n\n      // Codex P1 #21: route the resolved command through the same\n      // safety gates the rest of the local engine uses. Without this\n      // a host with `readOnly: true` (or relying on the destructive-\n      // command guard) could be bypassed by passing a `command`\n      // override to compile_check that performs writes/deletes.\n      // Auto-detected commands (tsc/cargo/etc.) pass these gates\n      // unchanged — the validation is only blocking for genuinely\n      // mutating overrides.\n      const validation = await validateBashCommand(detection.command, config);\n      if (!validation.valid) {\n        const explainer = `compile_check refused to run \\`${detection.command}\\`: ${validation.errors.join('; ')}`;\n        return [\n          explainer,\n          {\n            kind: detection.kind,\n            ran: false,\n            reason: validation.errors.join('; '),\n            cwd,\n          },\n        ];\n      }\n\n      const timeoutMs =\n        input.timeout_ms ??\n        config.compileCheck?.timeoutMs ??\n        DEFAULT_TIMEOUT_MS;\n      const result = await spawnLocalProcess(\n        config.shell ?? (process.platform === 'win32' ? 'bash.exe' : 'bash'),\n        ['-lc', detection.command],\n        {\n          ...config,\n          timeoutMs,\n          maxOutputChars: config.maxOutputChars ?? 8000,\n        }\n      );\n\n      const passed = result.exitCode === 0 && !result.timedOut;\n      const headline = passed\n        ? `compile_check (${detection.kind}) PASSED via \\`${detection.command}\\``\n        : `compile_check (${detection.kind}) FAILED via \\`${detection.command}\\` ` +\n          `(exit=${result.exitCode ?? 'unknown'}${result.timedOut ? ', timed_out=true' : ''})`;\n\n      let body = '';\n      if (result.stdout !== '') {\n        body += `\\n\\nstdout:\\n${truncateLocalOutput(result.stdout, 4000)}`;\n      }\n      if (result.stderr !== '') {\n        body += `\\n\\nstderr:\\n${truncateLocalOutput(result.stderr, 4000)}`;\n      }\n      if (result.fullOutputPath != null) {\n        body += `\\n\\nfull_output_path: ${result.fullOutputPath}`;\n      }\n      const summary = `${headline}${body}\\n\\nworking_directory: ${cwd}\\nreason: ${detection.reason}`;\n\n      return [\n        summary,\n        {\n          kind: detection.kind,\n          ran: true,\n          passed,\n          exit_code: result.exitCode,\n          timed_out: result.timedOut,\n          command: detection.command,\n          cwd,\n        },\n      ];\n    },\n    {\n      name: CompileCheckToolName,\n      description:\n        'Run the project\\'s standard typecheck or lint pass and return its output. Auto-detects from project markers (tsconfig.json/package.json -> tsc; Cargo.toml -> cargo check; go.mod -> go vet; pyproject.toml -> mypy or py_compile). Pass `command` to override.',\n      schema: CompileCheckSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\nexport function createCompileCheckToolDefinition(): t.LCTool {\n  return {\n    name: CompileCheckToolName,\n    description:\n      'Run the project\\'s standard typecheck or lint pass and return its output.',\n    parameters: CompileCheckSchema,\n    allowed_callers: ['direct', 'code_execution'],\n    responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    toolType: 'builtin',\n  };\n}\n"],"names":["Constants","resolve","tool","getLocalCwd","getWorkspaceFS","validateBashCommand","spawnLocalProcess","truncateLocalOutput"],"mappings":"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"}

package/dist/cjs/tools/local/FileCheckpointer.cjs

@@ -30,7 +30,8 @@ class LocalFileCheckpointerImpl {
         this.fs = fs;
     }
     async captureBeforeWrite(absolutePath) {
-        if (this.snapshots.has(absolutePath) || this.oversizePaths.has(absolutePath)) {
+        if (this.snapshots.has(absolutePath) ||
+            this.oversizePaths.has(absolutePath)) {
             return;
         }
         let info;

package/dist/cjs/tools/local/FileCheckpointer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"FileCheckpointer.cjs","sources":["../../../../src/tools/local/FileCheckpointer.ts"],"sourcesContent":["import { dirname } from 'path';\nimport { nodeWorkspaceFS } from './workspaceFS';\nimport type { WorkspaceFS } from './workspaceFS';\nimport type * as t from '@/types';\n\ntype Snapshot =\n  | { kind: 'absent' }\n  | { kind: 'present'; content: Buffer };\n\n/**\n * Per-Run snapshot store for write_file / edit_file. Captures the\n * pre-write byte content of every path the local engine is about to\n * mutate so a later `rewind()` can restore the working tree to its\n * original state. Notes:\n *\n *  - Idempotent per path: subsequent captures preserve the first\n *    snapshot (so rewind always restores the *original* content).\n *  - Captures missing files as `{ kind: 'absent' }`; rewind deletes\n *    those paths so created files are removed.\n *  - In-memory: snapshots live for the lifetime of this instance and\n *    are not persisted across processes. Tie the lifetime to a Run.\n *  - Bounded by `maxBytesPerFile` (default 32 MiB) to bound memory.\n *    A file larger than the cap is recorded but not snapshotted; the\n *    rewind of that path is best-effort and the caller is told via\n *    the result count not to trust it.\n */\nexport class LocalFileCheckpointerImpl implements t.LocalFileCheckpointer {\n  private snapshots = new Map<string, Snapshot>();\n  private oversizePaths = new Set<string>();\n\n  constructor(\n    private readonly maxBytesPerFile: number = 32 * 1024 * 1024,\n    private readonly fs: WorkspaceFS = nodeWorkspaceFS\n  ) {}\n\n  async captureBeforeWrite(absolutePath: string): Promise<void> {\n    if (this.snapshots.has(absolutePath) || this.oversizePaths.has(absolutePath)) {\n      return;\n    }\n    let info;\n    try {\n      info = await this.fs.stat(absolutePath);\n    } catch {\n      this.snapshots.set(absolutePath, { kind: 'absent' });\n      return;\n    }\n    if (!info.isFile()) {\n      return;\n    }\n    if (info.size > this.maxBytesPerFile) {\n      this.oversizePaths.add(absolutePath);\n      return;\n    }\n    const content = (await this.fs.readFile(absolutePath)) as Buffer;\n    this.snapshots.set(absolutePath, { kind: 'present', content });\n  }\n\n  async rewind(): Promise<number> {\n    let restored = 0;\n    for (const [path, snapshot] of this.snapshots.entries()) {\n      if (snapshot.kind === 'absent') {\n        await this.fs.unlink(path).catch(() => undefined);\n        restored++;\n        continue;\n      }\n      try {\n        await this.fs.mkdir(dirname(path), { recursive: true });\n        await this.fs.writeFile(path, snapshot.content);\n        restored++;\n      } catch {\n        // Best-effort: ignore individual restore failures so the rest\n        // of the rewind continues.\n      }\n    }\n    return restored;\n  }\n\n  capturedPaths(): string[] {\n    return [...this.snapshots.keys(), ...this.oversizePaths];\n  }\n}\n\n/**\n * Convenience factory so callers don't have to reach for the impl\n * class directly. Accepts an optional `WorkspaceFS` so a host using a\n * non-default engine (remote sandbox, in-memory test FS, etc.) can\n * route the checkpointer through the same I/O.\n */\nexport function createLocalFileCheckpointer(\n  options: { maxBytesPerFile?: number; fs?: WorkspaceFS } = {}\n): t.LocalFileCheckpointer {\n  return new LocalFileCheckpointerImpl(options.maxBytesPerFile, options.fs);\n}\n"],"names":["nodeWorkspaceFS","path","dirname"],"mappings":";;;;;AASA;;;;;;;;;;;;;;;;AAgBG;MACU,yBAAyB,CAAA;AAKjB,IAAA,eAAA;AACA,IAAA,EAAA;AALX,IAAA,SAAS,GAAG,IAAI,GAAG,EAAoB;AACvC,IAAA,aAAa,GAAG,IAAI,GAAG,EAAU;IAEzC,WAAA,CACmB,eAAA,GAA0B,EAAE,GAAG,IAAI,GAAG,IAAI,EAC1C,KAAkBA,2BAAe,EAAA;QADjC,IAAA,CAAA,eAAe,GAAf,eAAe;QACf,IAAA,CAAA,EAAE,GAAF,EAAE;IAClB;IAEH,MAAM,kBAAkB,CAAC,YAAoB,EAAA;AAC3C,QAAA,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE;YAC5E;QACF;AACA,QAAA,IAAI,IAAI;AACR,QAAA,IAAI;YACF,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;QACzC;AAAE,QAAA,MAAM;AACN,YAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACpD;QACF;AACA,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE;YAClB;QACF;QACA,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,eAAe,EAAE;AACpC,YAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC;YACpC;QACF;AACA,QAAA,MAAM,OAAO,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAW;AAChE,QAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAChE;AAEA,IAAA,MAAM,MAAM,GAAA;QACV,IAAI,QAAQ,GAAG,CAAC;AAChB,QAAA,KAAK,MAAM,CAACC,MAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE;AACvD,YAAA,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE;AAC9B,gBAAA,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAACA,MAAI,CAAC,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC;AACjD,gBAAA,QAAQ,EAAE;gBACV;YACF;AACA,YAAA,IAAI;AACF,gBAAA,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAACC,YAAO,CAACD,MAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACvD,gBAAA,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAACA,MAAI,EAAE,QAAQ,CAAC,OAAO,CAAC;AAC/C,gBAAA,QAAQ,EAAE;YACZ;AAAE,YAAA,MAAM;;;YAGR;QACF;AACA,QAAA,OAAO,QAAQ;IACjB;IAEA,aAAa,GAAA;AACX,QAAA,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;IAC1D;AACD;AAED;;;;;AAKG;AACG,SAAU,2BAA2B,CACzC,OAAA,GAA0D,EAAE,EAAA;IAE5D,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,CAAC;AAC3E;;;;;"}
+{"version":3,"file":"FileCheckpointer.cjs","sources":["../../../../src/tools/local/FileCheckpointer.ts"],"sourcesContent":["import { dirname } from 'path';\nimport type { WorkspaceFS } from './workspaceFS';\nimport type * as t from '@/types';\nimport { nodeWorkspaceFS } from './workspaceFS';\n\ntype Snapshot = { kind: 'absent' } | { kind: 'present'; content: Buffer };\n\n/**\n * Per-Run snapshot store for write_file / edit_file. Captures the\n * pre-write byte content of every path the local engine is about to\n * mutate so a later `rewind()` can restore the working tree to its\n * original state. Notes:\n *\n *  - Idempotent per path: subsequent captures preserve the first\n *    snapshot (so rewind always restores the *original* content).\n *  - Captures missing files as `{ kind: 'absent' }`; rewind deletes\n *    those paths so created files are removed.\n *  - In-memory: snapshots live for the lifetime of this instance and\n *    are not persisted across processes. Tie the lifetime to a Run.\n *  - Bounded by `maxBytesPerFile` (default 32 MiB) to bound memory.\n *    A file larger than the cap is recorded but not snapshotted; the\n *    rewind of that path is best-effort and the caller is told via\n *    the result count not to trust it.\n */\nexport class LocalFileCheckpointerImpl implements t.LocalFileCheckpointer {\n  private snapshots = new Map<string, Snapshot>();\n  private oversizePaths = new Set<string>();\n\n  constructor(\n    private readonly maxBytesPerFile: number = 32 * 1024 * 1024,\n    private readonly fs: WorkspaceFS = nodeWorkspaceFS\n  ) {}\n\n  async captureBeforeWrite(absolutePath: string): Promise<void> {\n    if (\n      this.snapshots.has(absolutePath) ||\n      this.oversizePaths.has(absolutePath)\n    ) {\n      return;\n    }\n    let info;\n    try {\n      info = await this.fs.stat(absolutePath);\n    } catch {\n      this.snapshots.set(absolutePath, { kind: 'absent' });\n      return;\n    }\n    if (!info.isFile()) {\n      return;\n    }\n    if (info.size > this.maxBytesPerFile) {\n      this.oversizePaths.add(absolutePath);\n      return;\n    }\n    const content = (await this.fs.readFile(absolutePath)) as Buffer;\n    this.snapshots.set(absolutePath, { kind: 'present', content });\n  }\n\n  async rewind(): Promise<number> {\n    let restored = 0;\n    for (const [path, snapshot] of this.snapshots.entries()) {\n      if (snapshot.kind === 'absent') {\n        await this.fs.unlink(path).catch(() => undefined);\n        restored++;\n        continue;\n      }\n      try {\n        await this.fs.mkdir(dirname(path), { recursive: true });\n        await this.fs.writeFile(path, snapshot.content);\n        restored++;\n      } catch {\n        // Best-effort: ignore individual restore failures so the rest\n        // of the rewind continues.\n      }\n    }\n    return restored;\n  }\n\n  capturedPaths(): string[] {\n    return [...this.snapshots.keys(), ...this.oversizePaths];\n  }\n}\n\n/**\n * Convenience factory so callers don't have to reach for the impl\n * class directly. Accepts an optional `WorkspaceFS` so a host using a\n * non-default engine (remote sandbox, in-memory test FS, etc.) can\n * route the checkpointer through the same I/O.\n */\nexport function createLocalFileCheckpointer(\n  options: { maxBytesPerFile?: number; fs?: WorkspaceFS } = {}\n): t.LocalFileCheckpointer {\n  return new LocalFileCheckpointerImpl(options.maxBytesPerFile, options.fs);\n}\n"],"names":["nodeWorkspaceFS","path","dirname"],"mappings":";;;;;AAOA;;;;;;;;;;;;;;;;AAgBG;MACU,yBAAyB,CAAA;AAKjB,IAAA,eAAA;AACA,IAAA,EAAA;AALX,IAAA,SAAS,GAAG,IAAI,GAAG,EAAoB;AACvC,IAAA,aAAa,GAAG,IAAI,GAAG,EAAU;IAEzC,WAAA,CACmB,eAAA,GAA0B,EAAE,GAAG,IAAI,GAAG,IAAI,EAC1C,KAAkBA,2BAAe,EAAA;QADjC,IAAA,CAAA,eAAe,GAAf,eAAe;QACf,IAAA,CAAA,EAAE,GAAF,EAAE;IAClB;IAEH,MAAM,kBAAkB,CAAC,YAAoB,EAAA;AAC3C,QAAA,IACE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EACpC;YACA;QACF;AACA,QAAA,IAAI,IAAI;AACR,QAAA,IAAI;YACF,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;QACzC;AAAE,QAAA,MAAM;AACN,YAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACpD;QACF;AACA,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE;YAClB;QACF;QACA,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,eAAe,EAAE;AACpC,YAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC;YACpC;QACF;AACA,QAAA,MAAM,OAAO,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAW;AAChE,QAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAChE;AAEA,IAAA,MAAM,MAAM,GAAA;QACV,IAAI,QAAQ,GAAG,CAAC;AAChB,QAAA,KAAK,MAAM,CAACC,MAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE;AACvD,YAAA,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE;AAC9B,gBAAA,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAACA,MAAI,CAAC,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC;AACjD,gBAAA,QAAQ,EAAE;gBACV;YACF;AACA,YAAA,IAAI;AACF,gBAAA,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAACC,YAAO,CAACD,MAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACvD,gBAAA,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAACA,MAAI,EAAE,QAAQ,CAAC,OAAO,CAAC;AAC/C,gBAAA,QAAQ,EAAE;YACZ;AAAE,YAAA,MAAM;;;YAGR;QACF;AACA,QAAA,OAAO,QAAQ;IACjB;IAEA,aAAa,GAAA;AACX,QAAA,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;IAC1D;AACD;AAED;;;;;AAKG;AACG,SAAU,2BAA2B,CACzC,OAAA,GAA0D,EAAE,EAAA;IAE5D,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,CAAC;AAC3E;;;;;"}

package/dist/cjs/tools/local/LocalCodingTools.cjs

@@ -1,17 +1,17 @@
 'use strict';
 
 var path = require('path');
-var tools = require('@langchain/core/tools');
 var diff = require('diff');
-var LocalExecutionTools = require('./LocalExecutionTools.cjs');
+var tools = require('@langchain/core/tools');
 var LocalProgrammaticToolCalling = require('./LocalProgrammaticToolCalling.cjs');
 var LocalExecutionEngine = require('./LocalExecutionEngine.cjs');
+var LocalExecutionTools = require('./LocalExecutionTools.cjs');
+var CompileCheckTool = require('./CompileCheckTool.cjs');
+var attachments = require('./attachments.cjs');
 var FileCheckpointer = require('./FileCheckpointer.cjs');
 var editStrategies = require('./editStrategies.cjs');
 var textEncoding = require('./textEncoding.cjs');
-var attachments = require('./attachments.cjs');
 var syntaxCheck = require('./syntaxCheck.cjs');
-var CompileCheckTool = require('./CompileCheckTool.cjs');
 var _enum = require('../../common/enum.cjs');
 
 const MAX_READ_CHARS = 256000;
@@ -578,7 +578,7 @@ async function isRipgrepAvailable(config) {
     let probePromise = envMap.get(envKey);
     if (probePromise == null) {
         probePromise = LocalExecutionEngine.spawnLocalProcess('rg', ['--version'], { ...config, timeoutMs: 5000, sandbox: { enabled: false } }, { internal: true })
-            .then((probe) => probe != null && probe.exitCode === 0)
+            .then((probe) => probe.exitCode === 0)
             .catch(() => false);
         envMap.set(envKey, probePromise);
     }
@@ -780,10 +780,22 @@ function compileFallbackRegex(pattern) {
         throw new FallbackGrepError('invalid-pattern', `Invalid regex: ${e.message}`);
     }
 }
+/** Renders fallback-grep output: real matches first, skip diagnostics appended. */
+function formatFallbackGrepDisplay(result) {
+    if (result.matches.length > 0) {
+        return [...result.matches, ...result.skipped].join('\n');
+    }
+    if (result.skipped.length > 0) {
+        return result.skipped.join('\n');
+    }
+    return 'No matches found.';
+}
 async function fallbackGrep(root, pattern, globFilter, maxResults, fs) {
     const rx = compileFallbackRegex(pattern);
     const deadline = Date.now() + FALLBACK_GREP_BUDGET_MS;
-    const globRx = globFilter != null && globFilter !== '' ? globToRegExp(globFilter) : undefined;
+    const globRx = globFilter != null && globFilter !== ''
+        ? globToRegExp(globFilter)
+        : undefined;
     const matches = [];
     // Track skipped (oversize) files separately so they don't consume
     // the maxResults budget. Codex P2 [43]: round 14's fix pushed skip
@@ -800,7 +812,9 @@ async function fallbackGrep(root, pattern, globFilter, maxResults, fs) {
             return { matches, skipped: skippedDiagnostics };
         }
         if (globRx != null) {
-            const rel = file.startsWith(root + '/') ? file.slice(root.length + 1) : file;
+            const rel = file.startsWith(root + '/')
+                ? file.slice(root.length + 1)
+                : file;
             if (!globRx.test(rel)) {
                 continue;
             }
@@ -852,7 +866,9 @@ async function fallbackGlob(root, pattern, maxResults, fs) {
     const rx = globToRegExp(pattern);
     const out = [];
     for await (const file of walkFiles(root, fs)) {
-        const rel = file.startsWith(root + '/') ? file.slice(root.length + 1) : file;
+        const rel = file.startsWith(root + '/')
+            ? file.slice(root.length + 1)
+            : file;
         if (rx.test(rel)) {
             out.push(file);
             if (out.length >= maxResults) {
@@ -881,7 +897,9 @@ function createLocalGrepSearchTool(config = {}) {
                 '--hidden',
                 '--glob',
                 '!.git/**',
-                ...(input.glob != null && input.glob !== '' ? ['--glob', input.glob] : []),
+                ...(input.glob != null && input.glob !== ''
+                    ? ['--glob', input.glob]
+                    : []),
                 '-e',
                 input.pattern,
                 target,
@@ -898,7 +916,8 @@ function createLocalGrepSearchTool(config = {}) {
             // got from P2 #13), exit-2 errors silently mapped to
             // `matches: 0`, so the agent treated tooling failures as a
             // genuine absence of matches.
-            if (result.timedOut || (result.exitCode != null && result.exitCode > 1)) {
+            if (result.timedOut ||
+                (result.exitCode != null && result.exitCode > 1)) {
                 const detail = result.stderr.trim() || `rg exited ${result.exitCode}`;
                 return [
                     `grep_search failed: ${detail}`,
@@ -910,7 +929,10 @@ function createLocalGrepSearchTool(config = {}) {
                     },
                 ];
             }
-            const lines = result.stdout.split('\n').filter(Boolean).slice(0, maxResults);
+            const lines = result.stdout
+                .split('\n')
+                .filter(Boolean)
+                .slice(0, maxResults);
             const output = lines.length > 0
                 ? lines.join('\n')
                 : result.stderr.trim() || 'No matches found.';
@@ -918,14 +940,9 @@ function createLocalGrepSearchTool(config = {}) {
         }
         try {
             const { matches, skipped } = await fallbackGrep(target, input.pattern, input.glob, maxResults, fs);
-            // Display: real matches first, skip diagnostics appended.
             // Artifact count: ONLY real matches (Codex P2 [43] —
             // skip sentinels used to inflate the count and the budget).
-            const display = matches.length > 0
-                ? [...matches, ...skipped].join('\n')
-                : skipped.length > 0
-                    ? skipped.join('\n')
-                    : 'No matches found.';
+            const display = formatFallbackGrepDisplay({ matches, skipped });
             return [
                 display,
                 {
@@ -963,7 +980,15 @@ function createLocalGlobSearchTool(config = {}) {
         const target = await LocalExecutionEngine.resolveWorkspacePathSafe(input.path ?? '.', config, 'read');
         const maxResults = Math.max(input.max_results ?? DEFAULT_MAX_RESULTS, 1);
         if (await isRipgrepAvailable(config)) {
-            const result = await LocalExecutionEngine.spawnLocalProcess('rg', ['--files', '--hidden', '--glob', '!.git/**', '--glob', input.pattern, target], { ...config, timeoutMs: config.timeoutMs ?? 30000 });
+            const result = await LocalExecutionEngine.spawnLocalProcess('rg', [
+                '--files',
+                '--hidden',
+                '--glob',
+                '!.git/**',
+                '--glob',
+                input.pattern,
+                target,
+            ], { ...config, timeoutMs: config.timeoutMs ?? 30000 });
             // rg --files exit codes:
             //   0  → at least one file matched
             //   1  → no files matched (clean — "No files found.")
@@ -971,7 +996,8 @@ function createLocalGlobSearchTool(config = {}) {
             // Without this branch, exit-2 errors used to silently map to
             // "No files found." — the agent then treats a tooling failure
             // as a real absence of matches.
-            if (result.timedOut || (result.exitCode != null && result.exitCode > 1)) {
+            if (result.timedOut ||
+                (result.exitCode != null && result.exitCode > 1)) {
                 const detail = result.stderr.trim() || `rg exited ${result.exitCode}`;
                 return [
                     `glob_search failed: ${detail}`,