@librechat/agents 3.2.31 → 3.2.33

package/dist/cjs/tools/BashExecutor.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"BashExecutor.cjs","sources":["../../../src/tools/BashExecutor.ts"],"sourcesContent":["import { config } from 'dotenv';\nimport fetch, { RequestInit } from 'node-fetch';\nimport { HttpsProxyAgent } from 'https-proxy-agent';\nimport { tool, DynamicStructuredTool } from '@langchain/core/tools';\nimport type * as t from '@/types';\nimport {\n  BASH_SHELL_GUIDANCE,\n  CODE_ARTIFACT_PATH_GUIDANCE,\n  appendFailedExecutionFileReminder,\n  appendTmpScratchReminder,\n  appendCodeSessionFileSummary,\n  emptyOutputMessage,\n  buildCodeApiHttpErrorMessage,\n  getCodeBaseURL,\n  resolveCodeApiAuthHeaders,\n} from './CodeExecutor';\nimport { Constants } from '@/common';\n\nconfig();\n\nconst baseEndpoint = getCodeBaseURL();\nconst EXEC_ENDPOINT = `${baseEndpoint}/exec`;\n\nexport const BashExecutionToolSchema = {\n  type: 'object',\n  properties: {\n    command: {\n      type: 'string',\n      description: `The bash command or script to execute.\n- The environment is stateless; variables and state don't persist between executions.\n- Prior /mnt/data files are available and can be modified in place.\n- ${CODE_ARTIFACT_PATH_GUIDANCE}\n- ${BASH_SHELL_GUIDANCE}\n- Input code **IS ALREADY** displayed to the user, so **DO NOT** repeat it in your response unless asked.\n- Output code **IS NOT** displayed to the user, so **DO** write all desired output explicitly.\n- IMPORTANT: You MUST explicitly print/output ALL results you want the user to see.\n- Use \\`echo\\`, \\`printf\\`, or \\`cat\\` for all outputs.`,\n    },\n    args: {\n      type: 'array',\n      items: { type: 'string' },\n      description:\n        'Additional arguments to execute the command with. This should only be used if the input command requires additional arguments to run.',\n    },\n  },\n  required: ['command'],\n} as const;\n\nexport const BashExecutionToolDescription = `\nRuns bash commands and returns stdout/stderr output from a stateless execution environment, similar to running scripts in a command-line interface. Each execution is isolated and independent.\n\nUsage:\n- No network access available.\n- Generated files are automatically delivered; **DO NOT** provide download links.\n- ${CODE_ARTIFACT_PATH_GUIDANCE}\n- ${BASH_SHELL_GUIDANCE}\n- NEVER use this tool to execute malicious commands.\n`.trim();\n\n/**\n * Supplemental prompt documenting the tool-output reference feature.\n *\n * Hosts should append this (separated by a blank line) to the base\n * {@link BashExecutionToolDescription} only when\n * `RunConfig.toolOutputReferences.enabled` is `true`. When the feature\n * is disabled, including this text would tell the LLM to emit\n * `{{tool0turn0}}` placeholders that pass through unsubstituted and\n * leak into the shell.\n */\nexport const BashToolOutputReferencesGuide = `\nReferencing previous tool outputs:\n- Every successful tool result is tagged with a reference key of the form \\`tool<idx>turn<turn>\\` (e.g., \\`tool0turn0\\`). The key appears either as a \\`[ref: tool0turn0]\\` prefix line or, when the output is a JSON object, as a \\`_ref\\` field on the object.\n- To pipe a previous tool output into this tool, embed the placeholder \\`{{tool<idx>turn<turn>}}\\` literally anywhere in the \\`command\\` string (or any string arg). It will be substituted with the stored output verbatim before the command runs.\n- The substituted value is the original output string (no \\`[ref: …]\\` prefix, no \\`_ref\\` key), so it is safe to pipe directly into \\`jq\\`, \\`grep\\`, \\`awk\\`, etc.\n- Example (simple ASCII output): \\`echo '{{tool0turn0}}' | jq '.foo'\\` takes the full output of the first tool from the first turn and pipes it into jq.\n- For payloads that may contain quotes, parentheses, backticks, or arbitrary bytes (random/binary data, JSON with embedded quotes, multi-line strings), prefer a quoted-delimiter heredoc over \\`echo '…'\\`. The heredoc body is not interpreted by the shell, so substituted payloads pass through unchanged.\n- Heredoc example: \\`wc -c << 'EOF'\\\\n{{tool0turn0}}\\\\nEOF\\` (the quotes around \\`'EOF'\\` disable interpolation inside the body).\n- Unknown reference keys are left in place and surfaced as \\`[unresolved refs: …]\\` after the output.\n`.trim();\n\n/**\n * Composes the bash tool description, optionally appending the\n * tool-output references guide. Hosts that enable\n * `RunConfig.toolOutputReferences` should pass `enableToolOutputReferences: true`\n * when registering the tool so the LLM learns the `{{…}}` syntax it\n * will actually be able to use.\n */\nexport function buildBashExecutionToolDescription(options?: {\n  enableToolOutputReferences?: boolean;\n}): string {\n  if (options?.enableToolOutputReferences === true) {\n    return `${BashExecutionToolDescription}\\n\\n${BashToolOutputReferencesGuide}`;\n  }\n  return BashExecutionToolDescription;\n}\n\nexport const BashExecutionToolName = Constants.BASH_TOOL;\n\n/**\n * Default bash tool definition using the base description.\n *\n * When `RunConfig.toolOutputReferences.enabled` is `true`, build a\n * reference-aware description with\n * {@link buildBashExecutionToolDescription}\n * (`{ enableToolOutputReferences: true }`) and construct a custom\n * definition using it — using this constant as-is leaves the LLM\n * unaware of the `{{tool<i>turn<n>}}` syntax.\n */\nexport const BashExecutionToolDefinition = {\n  name: BashExecutionToolName,\n  description: BashExecutionToolDescription,\n  schema: BashExecutionToolSchema,\n} as const;\n\nfunction createBashExecutionTool(\n  params: t.BashExecutionToolParams | null = {}\n): DynamicStructuredTool {\n  return tool(\n    async (rawInput, config) => {\n      const { authHeaders, ...executionParams } = params ?? {};\n      const { command, ...rest } = rawInput as {\n        command: string;\n        args?: string[];\n      };\n      const { session_id, _injected_files } = (config.toolCall ?? {}) as {\n        session_id?: string;\n        _injected_files?: t.CodeEnvFile[];\n      };\n\n      const postData: Record<string, unknown> = {\n        lang: 'bash',\n        code: command,\n        ...rest,\n        ...executionParams,\n      };\n\n      /* See `CodeExecutor.ts` for the rationale — `/files/<session_id>`\n       * HTTP fallback was removed because codeapi's sessionAuth requires\n       * kind/id query params unavailable at this point. */\n      if (_injected_files && _injected_files.length > 0) {\n        postData.files = _injected_files;\n      } else if (\n        session_id != null &&\n        session_id.length > 0 &&\n        !Array.isArray(postData.files)\n      ) {\n        // eslint-disable-next-line no-console\n        console.debug(\n          `[BashExecutor] No injected files for session_id=${session_id} — exec will run without input files`\n        );\n      }\n\n      try {\n        const resolvedAuthHeaders =\n          await resolveCodeApiAuthHeaders(authHeaders);\n        const fetchOptions: RequestInit = {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'User-Agent': 'LibreChat/1.0',\n            ...resolvedAuthHeaders,\n          },\n          body: JSON.stringify(postData),\n        };\n\n        if (process.env.PROXY != null && process.env.PROXY !== '') {\n          fetchOptions.agent = new HttpsProxyAgent(process.env.PROXY);\n        }\n        const response = await fetch(EXEC_ENDPOINT, fetchOptions);\n        if (!response.ok) {\n          throw new Error(\n            await buildCodeApiHttpErrorMessage('POST', EXEC_ENDPOINT, response)\n          );\n        }\n\n        const result: t.ExecuteResult = await response.json();\n        let formattedOutput = '';\n        if (result.stdout) {\n          formattedOutput += `stdout:\\n${result.stdout}\\n`;\n        } else {\n          formattedOutput += emptyOutputMessage;\n        }\n        if (result.stderr) formattedOutput += `stderr:\\n${result.stderr}\\n`;\n\n        const outputWithReminder = appendTmpScratchReminder(\n          formattedOutput,\n          command\n        );\n        const hasFiles = result.files != null && result.files.length > 0;\n        return [\n          appendCodeSessionFileSummary(outputWithReminder, result.files),\n          (hasFiles\n            ? { session_id: result.session_id, files: result.files }\n            : {\n              session_id: result.session_id,\n            }) satisfies t.CodeExecutionArtifact,\n        ];\n      } catch (error) {\n        const messageWithReminder = appendFailedExecutionFileReminder(\n          (error as Error | undefined)?.message ?? '',\n          command\n        );\n        throw new Error(\n          `Execution error:\\n\\n${messageWithReminder}`\n        );\n      }\n    },\n    {\n      name: BashExecutionToolName,\n      description: BashExecutionToolDescription,\n      schema: BashExecutionToolSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\nexport { createBashExecutionTool };\n"],"names":["config","getCodeBaseURL","CODE_ARTIFACT_PATH_GUIDANCE","BASH_SHELL_GUIDANCE","Constants","tool","resolveCodeApiAuthHeaders","HttpsProxyAgent","buildCodeApiHttpErrorMessage","emptyOutputMessage","appendTmpScratchReminder","appendCodeSessionFileSummary","appendFailedExecutionFileReminder"],"mappings":"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"}
+{"version":3,"file":"BashExecutor.cjs","names":["getCodeBaseURL","CODE_ARTIFACT_PATH_GUIDANCE","BASH_SHELL_GUIDANCE","resolveCodeApiAuthHeaders","HttpsProxyAgent","buildCodeApiHttpErrorMessage","emptyOutputMessage","appendTmpScratchReminder","appendCodeSessionFileSummary","appendFailedExecutionFileReminder"],"sources":["../../../src/tools/BashExecutor.ts"],"sourcesContent":["import { config } from 'dotenv';\nimport fetch, { RequestInit } from 'node-fetch';\nimport { HttpsProxyAgent } from 'https-proxy-agent';\nimport { tool, DynamicStructuredTool } from '@langchain/core/tools';\nimport type * as t from '@/types';\nimport {\n  BASH_SHELL_GUIDANCE,\n  CODE_ARTIFACT_PATH_GUIDANCE,\n  appendFailedExecutionFileReminder,\n  appendTmpScratchReminder,\n  appendCodeSessionFileSummary,\n  emptyOutputMessage,\n  buildCodeApiHttpErrorMessage,\n  getCodeBaseURL,\n  resolveCodeApiAuthHeaders,\n} from './CodeExecutor';\nimport { Constants } from '@/common';\n\nconfig();\n\nconst baseEndpoint = getCodeBaseURL();\nconst EXEC_ENDPOINT = `${baseEndpoint}/exec`;\n\nexport const BashExecutionToolSchema = {\n  type: 'object',\n  properties: {\n    command: {\n      type: 'string',\n      description: `The bash command or script to execute.\n- The environment is stateless; variables and state don't persist between executions.\n- Prior /mnt/data files are available and can be modified in place.\n- ${CODE_ARTIFACT_PATH_GUIDANCE}\n- ${BASH_SHELL_GUIDANCE}\n- Input code **IS ALREADY** displayed to the user, so **DO NOT** repeat it in your response unless asked.\n- Output code **IS NOT** displayed to the user, so **DO** write all desired output explicitly.\n- IMPORTANT: You MUST explicitly print/output ALL results you want the user to see.\n- Use \\`echo\\`, \\`printf\\`, or \\`cat\\` for all outputs.`,\n    },\n    args: {\n      type: 'array',\n      items: { type: 'string' },\n      description:\n        'Additional arguments to execute the command with. This should only be used if the input command requires additional arguments to run.',\n    },\n  },\n  required: ['command'],\n} as const;\n\nexport const BashExecutionToolDescription = `\nRuns bash commands and returns stdout/stderr output from a stateless execution environment, similar to running scripts in a command-line interface. Each execution is isolated and independent.\n\nUsage:\n- No network access available.\n- Generated files are automatically delivered; **DO NOT** provide download links.\n- ${CODE_ARTIFACT_PATH_GUIDANCE}\n- ${BASH_SHELL_GUIDANCE}\n- NEVER use this tool to execute malicious commands.\n`.trim();\n\n/**\n * Supplemental prompt documenting the tool-output reference feature.\n *\n * Hosts should append this (separated by a blank line) to the base\n * {@link BashExecutionToolDescription} only when\n * `RunConfig.toolOutputReferences.enabled` is `true`. When the feature\n * is disabled, including this text would tell the LLM to emit\n * `{{tool0turn0}}` placeholders that pass through unsubstituted and\n * leak into the shell.\n */\nexport const BashToolOutputReferencesGuide = `\nReferencing previous tool outputs:\n- Every successful tool result is tagged with a reference key of the form \\`tool<idx>turn<turn>\\` (e.g., \\`tool0turn0\\`). The key appears either as a \\`[ref: tool0turn0]\\` prefix line or, when the output is a JSON object, as a \\`_ref\\` field on the object.\n- To pipe a previous tool output into this tool, embed the placeholder \\`{{tool<idx>turn<turn>}}\\` literally anywhere in the \\`command\\` string (or any string arg). It will be substituted with the stored output verbatim before the command runs.\n- The substituted value is the original output string (no \\`[ref: …]\\` prefix, no \\`_ref\\` key), so it is safe to pipe directly into \\`jq\\`, \\`grep\\`, \\`awk\\`, etc.\n- Example (simple ASCII output): \\`echo '{{tool0turn0}}' | jq '.foo'\\` takes the full output of the first tool from the first turn and pipes it into jq.\n- For payloads that may contain quotes, parentheses, backticks, or arbitrary bytes (random/binary data, JSON with embedded quotes, multi-line strings), prefer a quoted-delimiter heredoc over \\`echo '…'\\`. The heredoc body is not interpreted by the shell, so substituted payloads pass through unchanged.\n- Heredoc example: \\`wc -c << 'EOF'\\\\n{{tool0turn0}}\\\\nEOF\\` (the quotes around \\`'EOF'\\` disable interpolation inside the body).\n- Unknown reference keys are left in place and surfaced as \\`[unresolved refs: …]\\` after the output.\n`.trim();\n\n/**\n * Composes the bash tool description, optionally appending the\n * tool-output references guide. Hosts that enable\n * `RunConfig.toolOutputReferences` should pass `enableToolOutputReferences: true`\n * when registering the tool so the LLM learns the `{{…}}` syntax it\n * will actually be able to use.\n */\nexport function buildBashExecutionToolDescription(options?: {\n  enableToolOutputReferences?: boolean;\n}): string {\n  if (options?.enableToolOutputReferences === true) {\n    return `${BashExecutionToolDescription}\\n\\n${BashToolOutputReferencesGuide}`;\n  }\n  return BashExecutionToolDescription;\n}\n\nexport const BashExecutionToolName = Constants.BASH_TOOL;\n\n/**\n * Default bash tool definition using the base description.\n *\n * When `RunConfig.toolOutputReferences.enabled` is `true`, build a\n * reference-aware description with\n * {@link buildBashExecutionToolDescription}\n * (`{ enableToolOutputReferences: true }`) and construct a custom\n * definition using it — using this constant as-is leaves the LLM\n * unaware of the `{{tool<i>turn<n>}}` syntax.\n */\nexport const BashExecutionToolDefinition = {\n  name: BashExecutionToolName,\n  description: BashExecutionToolDescription,\n  schema: BashExecutionToolSchema,\n} as const;\n\nfunction createBashExecutionTool(\n  params: t.BashExecutionToolParams | null = {}\n): DynamicStructuredTool {\n  return tool(\n    async (rawInput, config) => {\n      const { authHeaders, ...executionParams } = params ?? {};\n      const { command, ...rest } = rawInput as {\n        command: string;\n        args?: string[];\n      };\n      const { session_id, _injected_files } = (config.toolCall ?? {}) as {\n        session_id?: string;\n        _injected_files?: t.CodeEnvFile[];\n      };\n\n      const postData: Record<string, unknown> = {\n        lang: 'bash',\n        code: command,\n        ...rest,\n        ...executionParams,\n      };\n\n      /* See `CodeExecutor.ts` for the rationale — `/files/<session_id>`\n       * HTTP fallback was removed because codeapi's sessionAuth requires\n       * kind/id query params unavailable at this point. */\n      if (_injected_files && _injected_files.length > 0) {\n        postData.files = _injected_files;\n      } else if (\n        session_id != null &&\n        session_id.length > 0 &&\n        !Array.isArray(postData.files)\n      ) {\n        // eslint-disable-next-line no-console\n        console.debug(\n          `[BashExecutor] No injected files for session_id=${session_id} — exec will run without input files`\n        );\n      }\n\n      try {\n        const resolvedAuthHeaders =\n          await resolveCodeApiAuthHeaders(authHeaders);\n        const fetchOptions: RequestInit = {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'User-Agent': 'LibreChat/1.0',\n            ...resolvedAuthHeaders,\n          },\n          body: JSON.stringify(postData),\n        };\n\n        if (process.env.PROXY != null && process.env.PROXY !== '') {\n          fetchOptions.agent = new HttpsProxyAgent(process.env.PROXY);\n        }\n        const response = await fetch(EXEC_ENDPOINT, fetchOptions);\n        if (!response.ok) {\n          throw new Error(\n            await buildCodeApiHttpErrorMessage('POST', EXEC_ENDPOINT, response)\n          );\n        }\n\n        const result: t.ExecuteResult = await response.json();\n        let formattedOutput = '';\n        if (result.stdout) {\n          formattedOutput += `stdout:\\n${result.stdout}\\n`;\n        } else {\n          formattedOutput += emptyOutputMessage;\n        }\n        if (result.stderr) formattedOutput += `stderr:\\n${result.stderr}\\n`;\n\n        const outputWithReminder = appendTmpScratchReminder(\n          formattedOutput,\n          command\n        );\n        const hasFiles = result.files != null && result.files.length > 0;\n        return [\n          appendCodeSessionFileSummary(outputWithReminder, result.files),\n          (hasFiles\n            ? { session_id: result.session_id, files: result.files }\n            : {\n              session_id: result.session_id,\n            }) satisfies t.CodeExecutionArtifact,\n        ];\n      } catch (error) {\n        const messageWithReminder = appendFailedExecutionFileReminder(\n          (error as Error | undefined)?.message ?? '',\n          command\n        );\n        throw new Error(\n          `Execution error:\\n\\n${messageWithReminder}`\n        );\n      }\n    },\n    {\n      name: BashExecutionToolName,\n      description: BashExecutionToolDescription,\n      schema: BashExecutionToolSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\nexport { createBashExecutionTool };\n"],"mappings":";;;;;;;;;;;mBAkBO;AAGP,MAAM,gBAAgB,GADDA,qBAAAA,eACe,EAAE;AAEtC,MAAa,0BAA0B;CACrC,MAAM;CACN,YAAY;EACV,SAAS;GACP,MAAM;GACN,aAAa;;;IAGfC,qBAAAA,4BAA4B;IAC5BC,qBAAAA,oBAAoB;;;;;EAKpB;EACA,MAAM;GACJ,MAAM;GACN,OAAO,EAAE,MAAM,SAAS;GACxB,aACE;EACJ;CACF;CACA,UAAU,CAAC,SAAS;AACtB;AAEA,MAAa,+BAA+B;;;;;;IAMxCD,qBAAAA,4BAA4B;IAC5BC,qBAAAA,oBAAoB;;EAEtB,KAAK;;;;;;;;;;;AAYP,MAAa,gCAAgC;;;;;;;;;EAS3C,KAAK;;;;;;;;AASP,SAAgB,kCAAkC,SAEvC;CACT,IAAI,SAAS,+BAA+B,MAC1C,OAAO,GAAG,6BAA6B,MAAM;CAE/C,OAAO;AACT;AAEA,MAAa,wBAAA;;;;;;;;;;;AAYb,MAAa,8BAA8B;CACzC,MAAM;CACN,aAAa;CACb,QAAQ;AACV;AAEA,SAAS,wBACP,SAA2C,CAAC,GACrB;CACvB,QAAA,GAAA,sBAAA,KAAA,CACE,OAAO,UAAU,WAAW;EAC1B,MAAM,EAAE,aAAa,GAAG,oBAAoB,UAAU,CAAC;EACvD,MAAM,EAAE,SAAS,GAAG,SAAS;EAI7B,MAAM,EAAE,YAAY,oBAAqB,OAAO,YAAY,CAAC;EAK7D,MAAM,WAAoC;GACxC,MAAM;GACN,MAAM;GACN,GAAG;GACH,GAAG;EACL;EAKA,IAAI,mBAAmB,gBAAgB,SAAS,GAC9C,SAAS,QAAQ;OACZ,IACL,cAAc,QACd,WAAW,SAAS,KACpB,CAAC,MAAM,QAAQ,SAAS,KAAK,GAG7B,QAAQ,MACN,mDAAmD,WAAW,qCAChE;EAGF,IAAI;GAGF,MAAM,eAA4B;IAChC,QAAQ;IACR,SAAS;KACP,gBAAgB;KAChB,cAAc;KACd,GAAG,MANCC,qBAAAA,0BAA0B,WAAW;IAO3C;IACA,MAAM,KAAK,UAAU,QAAQ;GAC/B;GAEA,IAAI,QAAQ,IAAI,SAAS,QAAQ,QAAQ,IAAI,UAAU,IACrD,aAAa,QAAQ,IAAIC,kBAAAA,gBAAgB,QAAQ,IAAI,KAAK;GAE5D,MAAM,WAAW,OAAA,GAAA,WAAA,QAAA,CAAY,eAAe,YAAY;GACxD,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MACR,MAAMC,qBAAAA,6BAA6B,QAAQ,eAAe,QAAQ,CACpE;GAGF,MAAM,SAA0B,MAAM,SAAS,KAAK;GACpD,IAAI,kBAAkB;GACtB,IAAI,OAAO,QACT,mBAAmB,YAAY,OAAO,OAAO;QAE7C,mBAAmBC,qBAAAA;GAErB,IAAI,OAAO,QAAQ,mBAAmB,YAAY,OAAO,OAAO;GAEhE,MAAM,qBAAqBC,qBAAAA,yBACzB,iBACA,OACF;GACA,MAAM,WAAW,OAAO,SAAS,QAAQ,OAAO,MAAM,SAAS;GAC/D,OAAO,CACLC,+BAAAA,6BAA6B,oBAAoB,OAAO,KAAK,GAC5D,WACG;IAAE,YAAY,OAAO;IAAY,OAAO,OAAO;GAAM,IACrD,EACA,YAAY,OAAO,WACrB,CACJ;EACF,SAAS,OAAO;GACd,MAAM,sBAAsBC,qBAAAA,kCACzB,OAA6B,WAAW,IACzC,OACF;GACA,MAAM,IAAI,MACR,uBAAuB,qBACzB;EACF;CACF,GACA;EACE,MAAM;EACN,aAAa;EACb,QAAQ;EACR,gBAAA;CACF,CACF;AACF"}

package/dist/cjs/tools/BashProgrammaticToolCalling.cjs

@@ -1,47 +1,39 @@
-'use strict';
-
-var dotenv = require('dotenv');
-var tools = require('@langchain/core/tools');
-var CodeExecutor = require('./CodeExecutor.cjs');
-var ptcTimeout = require('./ptcTimeout.cjs');
-var ProgrammaticToolCalling = require('./ProgrammaticToolCalling.cjs');
-var _enum = require('../common/enum.cjs');
-
-dotenv.config();
-// ============================================================================
-// Constants
-// ============================================================================
+require("../common/enum.cjs");
+require("../common/index.cjs");
+const require_CodeExecutor = require("./CodeExecutor.cjs");
+const require_ptcTimeout = require("./ptcTimeout.cjs");
+const require_ProgrammaticToolCalling = require("./ProgrammaticToolCalling.cjs");
+let _langchain_core_tools = require("@langchain/core/tools");
+//#region src/tools/BashProgrammaticToolCalling.ts
+(0, require("dotenv").config)();
 const DEFAULT_MAX_ROUND_TRIPS = 20;
-const DEFAULT_RUN_TIMEOUT_MS = ptcTimeout.resolveCodeApiRunTimeoutMs();
+const DEFAULT_RUN_TIMEOUT_MS = require_ptcTimeout.resolveCodeApiRunTimeoutMs();
 /** Bash reserved words that get `_tool` suffix when used as function names */
 const BASH_RESERVED = new Set([
-    'if',
-    'then',
-    'else',
-    'elif',
-    'fi',
-    'case',
-    'esac',
-    'for',
-    'while',
-    'until',
-    'do',
-    'done',
-    'in',
-    'function',
-    'select',
-    'time',
-    'coproc',
-    'declare',
-    'typeset',
-    'local',
-    'readonly',
-    'export',
-    'unset',
+	"if",
+	"then",
+	"else",
+	"elif",
+	"fi",
+	"case",
+	"esac",
+	"for",
+	"while",
+	"until",
+	"do",
+	"done",
+	"in",
+	"function",
+	"select",
+	"time",
+	"coproc",
+	"declare",
+	"typeset",
+	"local",
+	"readonly",
+	"export",
+	"unset"
 ]);
-// ============================================================================
-// Description Components
-// ============================================================================
 const STATELESS_WARNING = `CRITICAL - STATELESS EXECUTION:
 Each call is a fresh bash shell. Variables and state do NOT persist between calls.
 You MUST complete your entire workflow in ONE code block.
@@ -53,10 +45,10 @@ const CORE_RULES = `Rules:
 - Save tool output with raw=$(tool '{}'); printf '%s\n' "$raw" > /mnt/data/file.json; direct tool > file may be empty
 - Tool stdout is normalized to one compact JSON value when possible; parse saved stdout once, then use fromjson? // . only for JSON-string fields
 - Only echo/printf output returns to the model
-- ${CodeExecutor.CODE_ARTIFACT_PATH_GUIDANCE}
-- ${CodeExecutor.BASH_SHELL_GUIDANCE}
+- ${require_CodeExecutor.CODE_ARTIFACT_PATH_GUIDANCE}
+- ${require_CodeExecutor.BASH_SHELL_GUIDANCE}
 - timeout caps one sandbox run/replay iteration, not the total multi-round-trip workflow`;
-const ADDITIONAL_RULES = '- Tool names normalized: hyphens→underscores, reserved words get `_tool` suffix';
+const ADDITIONAL_RULES = "- Tool names normalized: hyphens→underscores, reserved words get `_tool` suffix";
 const EXAMPLES = `Example (Complete workflow in one call):
   # Query data and process
   data=$(query_database '{"sql": "SELECT * FROM users"}')
@@ -78,25 +70,22 @@ Example: tool_name '{"key": "value"}'
 ${EXAMPLES}
 
 ${CORE_RULES}`;
-// ============================================================================
-// Schema
-// ============================================================================
 function createBashProgrammaticToolCallingSchema(maxRunTimeoutMs = DEFAULT_RUN_TIMEOUT_MS) {
-    return {
-        type: 'object',
-        properties: {
-            code: {
-                type: 'string',
-                minLength: 1,
-                description: CODE_PARAM_DESCRIPTION,
-            },
-            timeout: ptcTimeout.createCodeApiRunTimeoutSchema(maxRunTimeoutMs),
-        },
-        required: ['code'],
-    };
+	return {
+		type: "object",
+		properties: {
+			code: {
+				type: "string",
+				minLength: 1,
+				description: CODE_PARAM_DESCRIPTION
+			},
+			timeout: require_ptcTimeout.createCodeApiRunTimeoutSchema(maxRunTimeoutMs)
+		},
+		required: ["code"]
+	};
 }
 const BashProgrammaticToolCallingSchema = createBashProgrammaticToolCallingSchema();
-const BashProgrammaticToolCallingName = _enum.Constants.BASH_PROGRAMMATIC_TOOL_CALLING;
+const BashProgrammaticToolCallingName = "run_tools_with_bash";
 const BashProgrammaticToolCallingDescription = `
 Run tools via bash code. Tools are available as bash functions that accept JSON string arguments.
 
@@ -110,208 +99,138 @@ When to use: shell pipelines, parallel execution (& and wait), file processing,
 ${EXAMPLES}
 `.trim();
 const BashProgrammaticToolCallingDefinition = {
-    name: BashProgrammaticToolCallingName,
-    description: BashProgrammaticToolCallingDescription,
-    schema: BashProgrammaticToolCallingSchema,
+	name: BashProgrammaticToolCallingName,
+	description: BashProgrammaticToolCallingDescription,
+	schema: BashProgrammaticToolCallingSchema
 };
 function maybeParseJsonResultString(result) {
-    if (typeof result !== 'string') {
-        return result;
-    }
-    const trimmed = result.trim();
-    if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {
-        return result;
-    }
-    try {
-        return JSON.parse(trimmed);
-    }
-    catch {
-        return result;
-    }
+	if (typeof result !== "string") return result;
+	const trimmed = result.trim();
+	if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return result;
+	try {
+		return JSON.parse(trimmed);
+	} catch {
+		return result;
+	}
 }
 function normalizeBashToolResultsForReplay(toolResults) {
-    return toolResults.map((toolResult) => {
-        if (toolResult.is_error) {
-            return toolResult;
-        }
-        return {
-            ...toolResult,
-            result: maybeParseJsonResultString(toolResult.result),
-        };
-    });
+	return toolResults.map((toolResult) => {
+		if (toolResult.is_error) return toolResult;
+		return {
+			...toolResult,
+			result: maybeParseJsonResultString(toolResult.result)
+		};
+	});
 }
-// ============================================================================
-// Helper Functions
-// ============================================================================
 /**
- * Normalizes a tool name to a valid bash function identifier.
- * 1. Replace hyphens, spaces, dots with underscores
- * 2. Remove any other invalid characters
- * 3. Prefix with underscore if starts with number
- * 4. Append `_tool` if it's a bash reserved word
- */
+* Normalizes a tool name to a valid bash function identifier.
+* 1. Replace hyphens, spaces, dots with underscores
+* 2. Remove any other invalid characters
+* 3. Prefix with underscore if starts with number
+* 4. Append `_tool` if it's a bash reserved word
+*/
 function normalizeToBashIdentifier(name) {
-    let normalized = name.replace(/[-\s.]/g, '_');
-    normalized = normalized.replace(/[^a-zA-Z0-9_]/g, '');
-    if (/^[0-9]/.test(normalized)) {
-        normalized = '_' + normalized;
-    }
-    if (BASH_RESERVED.has(normalized)) {
-        normalized = normalized + '_tool';
-    }
-    return normalized;
+	let normalized = name.replace(/[-\s.]/g, "_");
+	normalized = normalized.replace(/[^a-zA-Z0-9_]/g, "");
+	if (/^[0-9]/.test(normalized)) normalized = "_" + normalized;
+	if (BASH_RESERVED.has(normalized)) normalized = normalized + "_tool";
+	return normalized;
 }
 /**
- * Extracts tool names that are actually called in the bash code.
- * Bash functions are invoked as commands (no parentheses), so we match
- * the normalized name as a word boundary.
- */
+* Extracts tool names that are actually called in the bash code.
+* Bash functions are invoked as commands (no parentheses), so we match
+* the normalized name as a word boundary.
+*/
 function extractUsedBashToolNames(code, toolNameMap) {
-    const usedTools = new Set();
-    for (const [bashName, originalName] of toolNameMap) {
-        const escapedName = bashName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        const pattern = new RegExp(`\\b${escapedName}\\b`, 'g');
-        if (pattern.test(code)) {
-            usedTools.add(originalName);
-        }
-    }
-    return usedTools;
+	const usedTools = /* @__PURE__ */ new Set();
+	for (const [bashName, originalName] of toolNameMap) {
+		const escapedName = bashName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+		if (new RegExp(`\\b${escapedName}\\b`, "g").test(code)) usedTools.add(originalName);
+	}
+	return usedTools;
 }
 /**
- * Filters tool definitions to only include tools actually used in the bash code.
- */
+* Filters tool definitions to only include tools actually used in the bash code.
+*/
 function filterBashToolsByUsage(toolDefs, code, debug = false) {
-    const toolNameMap = new Map();
-    for (const def of toolDefs) {
-        const bashName = normalizeToBashIdentifier(def.name);
-        toolNameMap.set(bashName, def.name);
-    }
-    const usedToolNames = extractUsedBashToolNames(code, toolNameMap);
-    if (debug) {
-        // eslint-disable-next-line no-console
-        console.log(`[BashPTC Debug] Tool filtering: found ${usedToolNames.size}/${toolDefs.length} tools in code`);
-        if (usedToolNames.size > 0) {
-            // eslint-disable-next-line no-console
-            console.log(`[BashPTC Debug] Matched tools: ${Array.from(usedToolNames).join(', ')}`);
-        }
-    }
-    if (usedToolNames.size === 0) {
-        if (debug) {
-            // eslint-disable-next-line no-console
-            console.log('[BashPTC Debug] No tools detected in code - sending all tools as fallback');
-        }
-        return toolDefs;
-    }
-    return toolDefs.filter((def) => usedToolNames.has(def.name));
+	const toolNameMap = /* @__PURE__ */ new Map();
+	for (const def of toolDefs) {
+		const bashName = normalizeToBashIdentifier(def.name);
+		toolNameMap.set(bashName, def.name);
+	}
+	const usedToolNames = extractUsedBashToolNames(code, toolNameMap);
+	if (debug) {
+		console.log(`[BashPTC Debug] Tool filtering: found ${usedToolNames.size}/${toolDefs.length} tools in code`);
+		if (usedToolNames.size > 0) console.log(`[BashPTC Debug] Matched tools: ${Array.from(usedToolNames).join(", ")}`);
+	}
+	if (usedToolNames.size === 0) {
+		if (debug) console.log("[BashPTC Debug] No tools detected in code - sending all tools as fallback");
+		return toolDefs;
+	}
+	return toolDefs.filter((def) => usedToolNames.has(def.name));
 }
-// ============================================================================
-// Tool Factory
-// ============================================================================
 /**
- * Creates a Bash Programmatic Tool Calling tool for multi-tool orchestration.
- *
- * This tool enables AI agents to write bash scripts that orchestrate multiple
- * tool calls programmatically via the remote Code API, reducing LLM round-trips.
- *
- * The tool map must be provided at runtime via config.toolCall (injected by ToolNode).
- */
+* Creates a Bash Programmatic Tool Calling tool for multi-tool orchestration.
+*
+* This tool enables AI agents to write bash scripts that orchestrate multiple
+* tool calls programmatically via the remote Code API, reducing LLM round-trips.
+*
+* The tool map must be provided at runtime via config.toolCall (injected by ToolNode).
+*/
 function createBashProgrammaticToolCallingTool(initParams = {}) {
-    const baseUrl = initParams.baseUrl ?? CodeExecutor.getCodeBaseURL();
-    const maxRoundTrips = initParams.maxRoundTrips ?? DEFAULT_MAX_ROUND_TRIPS;
-    const maxRunTimeoutMs = ptcTimeout.resolveCodeApiRunTimeoutMs(initParams.runTimeoutMs);
-    const proxy = initParams.proxy ?? process.env.PROXY;
-    const debug = initParams.debug ?? process.env.BASH_PTC_DEBUG === 'true';
-    const EXEC_ENDPOINT = `${baseUrl}/exec/programmatic`;
-    return tools.tool(async (rawParams, config) => {
-        const params = rawParams;
-        const { code } = params;
-        const timeout = ptcTimeout.clampCodeApiRunTimeoutMs(params.timeout, maxRunTimeoutMs);
-        const toolCall = (config.toolCall ?? {});
-        const { toolMap, toolDefs, session_id, _injected_files } = toolCall;
-        if (toolMap == null || toolMap.size === 0) {
-            throw new Error('No toolMap provided. ' +
-                'ToolNode should inject this from AgentContext when invoked through the graph.');
-        }
-        if (toolDefs == null || toolDefs.length === 0) {
-            throw new Error('No tool definitions provided. ' +
-                'Either pass tools in the input or ensure ToolNode injects toolDefs.');
-        }
-        let roundTrip = 0;
-        try {
-            // ====================================================================
-            // Phase 1: Filter tools and make initial request
-            // ====================================================================
-            const effectiveTools = filterBashToolsByUsage(toolDefs, code, debug);
-            if (debug) {
-                // eslint-disable-next-line no-console
-                console.log(`[BashPTC Debug] Sending ${effectiveTools.length} tools to API ` +
-                    `(filtered from ${toolDefs.length})`);
-            }
-            /* `/files/<session_id>` HTTP fallback removed — codeapi's
-             * sessionAuth requires kind/id query params unavailable at
-             * this point. See `CodeExecutor.ts` for full rationale. */
-            let files;
-            if (_injected_files && _injected_files.length > 0) {
-                files = _injected_files;
-            }
-            else if (session_id != null && session_id.length > 0) {
-                // eslint-disable-next-line no-console
-                console.debug(`[BashProgrammaticToolCalling] No injected files for session_id=${session_id} — exec will run without input files`);
-            }
-            let response = await ProgrammaticToolCalling.makeRequest(EXEC_ENDPOINT, {
-                lang: 'bash',
-                code,
-                tools: effectiveTools,
-                session_id,
-                timeout,
-                ...(files && files.length > 0 ? { files } : {}),
-            }, proxy, initParams.authHeaders);
-            // ====================================================================
-            // Phase 2: Handle response loop
-            // ====================================================================
-            while (response.status === 'tool_call_required') {
-                roundTrip++;
-                if (roundTrip > maxRoundTrips) {
-                    throw new Error(`Exceeded maximum round trips (${maxRoundTrips}). ` +
-                        'This may indicate an infinite loop, excessive tool calls, ' +
-                        'or a logic error in your code.');
-                }
-                if (debug) {
-                    // eslint-disable-next-line no-console
-                    console.log(`[BashPTC Debug] Round trip ${roundTrip}: ${response.tool_calls?.length ?? 0} tool(s) to execute`);
-                }
-                const toolResults = normalizeBashToolResultsForReplay(await ProgrammaticToolCalling.executeTools(response.tool_calls ?? [], toolMap, _enum.Constants.BASH_PROGRAMMATIC_TOOL_CALLING));
-                response = await ProgrammaticToolCalling.makeRequest(EXEC_ENDPOINT, {
-                    continuation_token: response.continuation_token,
-                    tool_results: toolResults,
-                }, proxy, initParams.authHeaders);
-            }
-            // ====================================================================
-            // Phase 3: Handle final state
-            // ====================================================================
-            if (response.status === 'completed') {
-                return ProgrammaticToolCalling.formatCompletedResponse(response, code);
-            }
-            if (response.status === 'error') {
-                throw new Error(`Execution error: ${response.error}` +
-                    (response.stderr != null && response.stderr !== ''
-                        ? `\n\nStderr:\n${response.stderr}`
-                        : ''));
-            }
-            throw new Error(`Unexpected response status: ${response.status}`);
-        }
-        catch (error) {
-            const messageWithReminder = CodeExecutor.appendFailedExecutionFileReminder(error.message, code);
-            throw new Error(`Bash programmatic execution failed: ${messageWithReminder}`);
-        }
-    }, {
-        name: _enum.Constants.BASH_PROGRAMMATIC_TOOL_CALLING,
-        description: BashProgrammaticToolCallingDescription,
-        schema: createBashProgrammaticToolCallingSchema(maxRunTimeoutMs),
-        responseFormat: _enum.Constants.CONTENT_AND_ARTIFACT,
-    });
+	const baseUrl = initParams.baseUrl ?? require_CodeExecutor.getCodeBaseURL();
+	const maxRoundTrips = initParams.maxRoundTrips ?? DEFAULT_MAX_ROUND_TRIPS;
+	const maxRunTimeoutMs = require_ptcTimeout.resolveCodeApiRunTimeoutMs(initParams.runTimeoutMs);
+	const proxy = initParams.proxy ?? process.env.PROXY;
+	const debug = initParams.debug ?? process.env.BASH_PTC_DEBUG === "true";
+	const EXEC_ENDPOINT = `${baseUrl}/exec/programmatic`;
+	return (0, _langchain_core_tools.tool)(async (rawParams, config) => {
+		const params = rawParams;
+		const { code } = params;
+		const timeout = require_ptcTimeout.clampCodeApiRunTimeoutMs(params.timeout, maxRunTimeoutMs);
+		const { toolMap, toolDefs, session_id, _injected_files } = config.toolCall ?? {};
+		if (toolMap == null || toolMap.size === 0) throw new Error("No toolMap provided. ToolNode should inject this from AgentContext when invoked through the graph.");
+		if (toolDefs == null || toolDefs.length === 0) throw new Error("No tool definitions provided. Either pass tools in the input or ensure ToolNode injects toolDefs.");
+		let roundTrip = 0;
+		try {
+			const effectiveTools = filterBashToolsByUsage(toolDefs, code, debug);
+			if (debug) console.log(`[BashPTC Debug] Sending ${effectiveTools.length} tools to API (filtered from ${toolDefs.length})`);
+			let files;
+			if (_injected_files && _injected_files.length > 0) files = _injected_files;
+			else if (session_id != null && session_id.length > 0) console.debug(`[BashProgrammaticToolCalling] No injected files for session_id=${session_id} — exec will run without input files`);
+			let response = await require_ProgrammaticToolCalling.makeRequest(EXEC_ENDPOINT, {
+				lang: "bash",
+				code,
+				tools: effectiveTools,
+				session_id,
+				timeout,
+				...files && files.length > 0 ? { files } : {}
+			}, proxy, initParams.authHeaders);
+			while (response.status === "tool_call_required") {
+				roundTrip++;
+				if (roundTrip > maxRoundTrips) throw new Error(`Exceeded maximum round trips (${maxRoundTrips}). This may indicate an infinite loop, excessive tool calls, or a logic error in your code.`);
+				if (debug) console.log(`[BashPTC Debug] Round trip ${roundTrip}: ${response.tool_calls?.length ?? 0} tool(s) to execute`);
+				const toolResults = normalizeBashToolResultsForReplay(await require_ProgrammaticToolCalling.executeTools(response.tool_calls ?? [], toolMap, "run_tools_with_bash"));
+				response = await require_ProgrammaticToolCalling.makeRequest(EXEC_ENDPOINT, {
+					continuation_token: response.continuation_token,
+					tool_results: toolResults
+				}, proxy, initParams.authHeaders);
+			}
+			if (response.status === "completed") return require_ProgrammaticToolCalling.formatCompletedResponse(response, code);
+			if (response.status === "error") throw new Error(`Execution error: ${response.error}` + (response.stderr != null && response.stderr !== "" ? `\n\nStderr:\n${response.stderr}` : ""));
+			throw new Error(`Unexpected response status: ${response.status}`);
+		} catch (error) {
+			const messageWithReminder = require_CodeExecutor.appendFailedExecutionFileReminder(error.message, code);
+			throw new Error(`Bash programmatic execution failed: ${messageWithReminder}`);
+		}
+	}, {
+		name: "run_tools_with_bash",
+		description: BashProgrammaticToolCallingDescription,
+		schema: createBashProgrammaticToolCallingSchema(maxRunTimeoutMs),
+		responseFormat: "content_and_artifact"
+	});
 }
-
+//#endregion
 exports.BashProgrammaticToolCallingDefinition = BashProgrammaticToolCallingDefinition;
 exports.BashProgrammaticToolCallingDescription = BashProgrammaticToolCallingDescription;
 exports.BashProgrammaticToolCallingName = BashProgrammaticToolCallingName;
@@ -322,4 +241,5 @@ exports.extractUsedBashToolNames = extractUsedBashToolNames;
 exports.filterBashToolsByUsage = filterBashToolsByUsage;
 exports.normalizeBashToolResultsForReplay = normalizeBashToolResultsForReplay;
 exports.normalizeToBashIdentifier = normalizeToBashIdentifier;
-//# sourceMappingURL=BashProgrammaticToolCalling.cjs.map
+
+//# sourceMappingURL=BashProgrammaticToolCalling.cjs.map