@librechat/agents 3.1.66-dev.0 → 3.1.67

package/dist/esm/tools/BashProgrammaticToolCalling.mjs

@@ -1,287 +0,0 @@
-import { config } from 'dotenv';
-import { getEnvironmentVariable } from '@langchain/core/utils/env';
-import { tool } from '@langchain/core/tools';
-import { fetchSessionFiles, makeRequest, executeTools, formatCompletedResponse } from './ProgrammaticToolCalling.mjs';
-import { getCodeBaseURL } from './CodeExecutor.mjs';
-import { Constants, EnvVar } from '../common/enum.mjs';
-
-config();
-// ============================================================================
-// Constants
-// ============================================================================
-const DEFAULT_MAX_ROUND_TRIPS = 20;
-const DEFAULT_TIMEOUT = 60000;
-/** 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',
-]);
-// ============================================================================
-// 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.
-DO NOT split work across multiple calls expecting to reuse variables.`;
-const CORE_RULES = `Rules:
-- EVERYTHING in one call—no state persists between executions
-- Tools are pre-defined as bash functions—DO NOT redefine them
-- Each tool function accepts a JSON string argument
-- Only echo/printf output returns to the model
-- Generated files are automatically available in /mnt/data/ for subsequent executions`;
-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"}')
-  echo "$data" | jq '.[] | .name'
-
-Example (Parallel calls):
-  web_search '{"query": "SF weather"}' > /tmp/sf.txt &
-  web_search '{"query": "NY weather"}' > /tmp/ny.txt &
-  wait
-  echo "SF: $(cat /tmp/sf.txt)"
-  echo "NY: $(cat /tmp/ny.txt)"`;
-const CODE_PARAM_DESCRIPTION = `Bash code that calls tools programmatically. Tools are available as bash functions.
-
-${STATELESS_WARNING}
-
-Each tool function accepts a JSON string as its argument.
-Example: tool_name '{"key": "value"}'
-
-${EXAMPLES}
-
-${CORE_RULES}`;
-// ============================================================================
-// Schema
-// ============================================================================
-const BashProgrammaticToolCallingSchema = {
-    type: 'object',
-    properties: {
-        code: {
-            type: 'string',
-            minLength: 1,
-            description: CODE_PARAM_DESCRIPTION,
-        },
-        timeout: {
-            type: 'integer',
-            minimum: 1000,
-            maximum: 300000,
-            default: DEFAULT_TIMEOUT,
-            description: 'Maximum execution time in milliseconds. Default: 60 seconds. Max: 5 minutes.',
-        },
-    },
-    required: ['code'],
-};
-const BashProgrammaticToolCallingName = Constants.BASH_PROGRAMMATIC_TOOL_CALLING;
-const BashProgrammaticToolCallingDescription = `
-Run tools via bash code. Tools are available as bash functions that accept JSON string arguments.
-
-${STATELESS_WARNING}
-
-${CORE_RULES}
-${ADDITIONAL_RULES}
-
-When to use: shell pipelines, parallel execution (& and wait), file processing, text manipulation.
-
-${EXAMPLES}
-`.trim();
-const BashProgrammaticToolCallingDefinition = {
-    name: BashProgrammaticToolCallingName,
-    description: BashProgrammaticToolCallingDescription,
-    schema: BashProgrammaticToolCallingSchema,
-};
-// ============================================================================
-// 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
- */
-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;
-}
-/**
- * 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;
-}
-/**
- * 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));
-}
-// ============================================================================
-// 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).
- */
-function createBashProgrammaticToolCallingTool(initParams = {}) {
-    const apiKey = initParams[EnvVar.CODE_API_KEY] ??
-        initParams.apiKey ??
-        getEnvironmentVariable(EnvVar.CODE_API_KEY) ??
-        '';
-    if (!apiKey) {
-        throw new Error('No API key provided for bash programmatic tool calling. ' +
-            'Set CODE_API_KEY environment variable or pass apiKey in initParams.');
-    }
-    const baseUrl = initParams.baseUrl ?? getCodeBaseURL();
-    const maxRoundTrips = initParams.maxRoundTrips ?? DEFAULT_MAX_ROUND_TRIPS;
-    const proxy = initParams.proxy ?? process.env.PROXY;
-    const debug = initParams.debug ?? process.env.BASH_PTC_DEBUG === 'true';
-    const EXEC_ENDPOINT = `${baseUrl}/exec/programmatic`;
-    return tool(async (rawParams, config) => {
-        const params = rawParams;
-        const { code, timeout = DEFAULT_TIMEOUT } = params;
-        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 {
-            // ====================================================================
-            // 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})`);
-            }
-            let files;
-            if (_injected_files && _injected_files.length > 0) {
-                files = _injected_files;
-            }
-            else if (session_id != null && session_id.length > 0) {
-                files = await fetchSessionFiles(baseUrl, apiKey, session_id, proxy);
-            }
-            let response = await makeRequest(EXEC_ENDPOINT, apiKey, {
-                lang: 'bash',
-                code,
-                tools: effectiveTools,
-                session_id,
-                timeout,
-                ...(files && files.length > 0 ? { files } : {}),
-            }, proxy);
-            // ====================================================================
-            // 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 = await executeTools(response.tool_calls ?? [], toolMap);
-                response = await makeRequest(EXEC_ENDPOINT, apiKey, {
-                    continuation_token: response.continuation_token,
-                    tool_results: toolResults,
-                }, proxy);
-            }
-            // ====================================================================
-            // Phase 3: Handle final state
-            // ====================================================================
-            if (response.status === 'completed') {
-                return formatCompletedResponse(response);
-            }
-            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) {
-            throw new Error(`Bash programmatic execution failed: ${error.message}`);
-        }
-    }, {
-        name: Constants.BASH_PROGRAMMATIC_TOOL_CALLING,
-        description: BashProgrammaticToolCallingDescription,
-        schema: BashProgrammaticToolCallingSchema,
-        responseFormat: Constants.CONTENT_AND_ARTIFACT,
-    });
-}
-
-export { BashProgrammaticToolCallingDefinition, BashProgrammaticToolCallingDescription, BashProgrammaticToolCallingName, BashProgrammaticToolCallingSchema, createBashProgrammaticToolCallingTool, extractUsedBashToolNames, filterBashToolsByUsage, normalizeToBashIdentifier };
-//# sourceMappingURL=BashProgrammaticToolCalling.mjs.map

package/dist/esm/tools/BashProgrammaticToolCalling.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"BashProgrammaticToolCalling.mjs","sources":["../../../src/tools/BashProgrammaticToolCalling.ts"],"sourcesContent":["import { config } from 'dotenv';\nimport { getEnvironmentVariable } from '@langchain/core/utils/env';\nimport { tool, DynamicStructuredTool } from '@langchain/core/tools';\nimport type { ToolCall } from '@langchain/core/messages/tool';\nimport type * as t from '@/types';\nimport {\n  makeRequest,\n  executeTools,\n  fetchSessionFiles,\n  formatCompletedResponse,\n} from './ProgrammaticToolCalling';\nimport { getCodeBaseURL } from './CodeExecutor';\nimport { EnvVar, Constants } from '@/common';\n\nconfig();\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst DEFAULT_MAX_ROUND_TRIPS = 20;\nconst DEFAULT_TIMEOUT = 60000;\n\n/** Bash reserved words that get `_tool` suffix when used as function names */\nconst BASH_RESERVED = new Set([\n  'if',\n  'then',\n  'else',\n  'elif',\n  'fi',\n  'case',\n  'esac',\n  'for',\n  'while',\n  'until',\n  'do',\n  'done',\n  'in',\n  'function',\n  'select',\n  'time',\n  'coproc',\n  'declare',\n  'typeset',\n  'local',\n  'readonly',\n  'export',\n  'unset',\n]);\n\n// ============================================================================\n// Description Components\n// ============================================================================\n\nconst STATELESS_WARNING = `CRITICAL - STATELESS EXECUTION:\nEach call is a fresh bash shell. Variables and state do NOT persist between calls.\nYou MUST complete your entire workflow in ONE code block.\nDO NOT split work across multiple calls expecting to reuse variables.`;\n\nconst CORE_RULES = `Rules:\n- EVERYTHING in one call—no state persists between executions\n- Tools are pre-defined as bash functions—DO NOT redefine them\n- Each tool function accepts a JSON string argument\n- Only echo/printf output returns to the model\n- Generated files are automatically available in /mnt/data/ for subsequent executions`;\n\nconst ADDITIONAL_RULES =\n  '- Tool names normalized: hyphens→underscores, reserved words get `_tool` suffix';\n\nconst EXAMPLES = `Example (Complete workflow in one call):\n  # Query data and process\n  data=$(query_database '{\"sql\": \"SELECT * FROM users\"}')\n  echo \"$data\" | jq '.[] | .name'\n\nExample (Parallel calls):\n  web_search '{\"query\": \"SF weather\"}' > /tmp/sf.txt &\n  web_search '{\"query\": \"NY weather\"}' > /tmp/ny.txt &\n  wait\n  echo \"SF: $(cat /tmp/sf.txt)\"\n  echo \"NY: $(cat /tmp/ny.txt)\"`;\n\nconst CODE_PARAM_DESCRIPTION = `Bash code that calls tools programmatically. Tools are available as bash functions.\n\n${STATELESS_WARNING}\n\nEach tool function accepts a JSON string as its argument.\nExample: tool_name '{\"key\": \"value\"}'\n\n${EXAMPLES}\n\n${CORE_RULES}`;\n\n// ============================================================================\n// Schema\n// ============================================================================\n\nexport const BashProgrammaticToolCallingSchema = {\n  type: 'object',\n  properties: {\n    code: {\n      type: 'string',\n      minLength: 1,\n      description: CODE_PARAM_DESCRIPTION,\n    },\n    timeout: {\n      type: 'integer',\n      minimum: 1000,\n      maximum: 300000,\n      default: DEFAULT_TIMEOUT,\n      description:\n        'Maximum execution time in milliseconds. Default: 60 seconds. Max: 5 minutes.',\n    },\n  },\n  required: ['code'],\n} as const;\n\nexport const BashProgrammaticToolCallingName =\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING;\n\nexport const BashProgrammaticToolCallingDescription = `\nRun tools via bash code. Tools are available as bash functions that accept JSON string arguments.\n\n${STATELESS_WARNING}\n\n${CORE_RULES}\n${ADDITIONAL_RULES}\n\nWhen to use: shell pipelines, parallel execution (& and wait), file processing, text manipulation.\n\n${EXAMPLES}\n`.trim();\n\nexport const BashProgrammaticToolCallingDefinition = {\n  name: BashProgrammaticToolCallingName,\n  description: BashProgrammaticToolCallingDescription,\n  schema: BashProgrammaticToolCallingSchema,\n} as const;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Normalizes a tool name to a valid bash function identifier.\n * 1. Replace hyphens, spaces, dots with underscores\n * 2. Remove any other invalid characters\n * 3. Prefix with underscore if starts with number\n * 4. Append `_tool` if it's a bash reserved word\n */\nexport function normalizeToBashIdentifier(name: string): string {\n  let normalized = name.replace(/[-\\s.]/g, '_');\n  normalized = normalized.replace(/[^a-zA-Z0-9_]/g, '');\n\n  if (/^[0-9]/.test(normalized)) {\n    normalized = '_' + normalized;\n  }\n\n  if (BASH_RESERVED.has(normalized)) {\n    normalized = normalized + '_tool';\n  }\n\n  return normalized;\n}\n\n/**\n * Extracts tool names that are actually called in the bash code.\n * Bash functions are invoked as commands (no parentheses), so we match\n * the normalized name as a word boundary.\n */\nexport function extractUsedBashToolNames(\n  code: string,\n  toolNameMap: Map<string, string>\n): Set<string> {\n  const usedTools = new Set<string>();\n\n  for (const [bashName, originalName] of toolNameMap) {\n    const escapedName = bashName.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n    const pattern = new RegExp(`\\\\b${escapedName}\\\\b`, 'g');\n\n    if (pattern.test(code)) {\n      usedTools.add(originalName);\n    }\n  }\n\n  return usedTools;\n}\n\n/**\n * Filters tool definitions to only include tools actually used in the bash code.\n */\nexport function filterBashToolsByUsage(\n  toolDefs: t.LCTool[],\n  code: string,\n  debug = false\n): t.LCTool[] {\n  const toolNameMap = new Map<string, string>();\n  for (const def of toolDefs) {\n    const bashName = normalizeToBashIdentifier(def.name);\n    toolNameMap.set(bashName, def.name);\n  }\n\n  const usedToolNames = extractUsedBashToolNames(code, toolNameMap);\n\n  if (debug) {\n    // eslint-disable-next-line no-console\n    console.log(\n      `[BashPTC Debug] Tool filtering: found ${usedToolNames.size}/${toolDefs.length} tools in code`\n    );\n    if (usedToolNames.size > 0) {\n      // eslint-disable-next-line no-console\n      console.log(\n        `[BashPTC Debug] Matched tools: ${Array.from(usedToolNames).join(', ')}`\n      );\n    }\n  }\n\n  if (usedToolNames.size === 0) {\n    if (debug) {\n      // eslint-disable-next-line no-console\n      console.log(\n        '[BashPTC Debug] No tools detected in code - sending all tools as fallback'\n      );\n    }\n    return toolDefs;\n  }\n\n  return toolDefs.filter((def) => usedToolNames.has(def.name));\n}\n\n// ============================================================================\n// Tool Factory\n// ============================================================================\n\n/**\n * Creates a Bash Programmatic Tool Calling tool for multi-tool orchestration.\n *\n * This tool enables AI agents to write bash scripts that orchestrate multiple\n * tool calls programmatically via the remote Code API, reducing LLM round-trips.\n *\n * The tool map must be provided at runtime via config.toolCall (injected by ToolNode).\n */\nexport function createBashProgrammaticToolCallingTool(\n  initParams: t.BashProgrammaticToolCallingParams = {}\n): DynamicStructuredTool {\n  const apiKey =\n    (initParams[EnvVar.CODE_API_KEY] as string | undefined) ??\n    initParams.apiKey ??\n    getEnvironmentVariable(EnvVar.CODE_API_KEY) ??\n    '';\n\n  if (!apiKey) {\n    throw new Error(\n      'No API key provided for bash programmatic tool calling. ' +\n        'Set CODE_API_KEY environment variable or pass apiKey in initParams.'\n    );\n  }\n\n  const baseUrl = initParams.baseUrl ?? getCodeBaseURL();\n  const maxRoundTrips = initParams.maxRoundTrips ?? DEFAULT_MAX_ROUND_TRIPS;\n  const proxy = initParams.proxy ?? process.env.PROXY;\n  const debug = initParams.debug ?? process.env.BASH_PTC_DEBUG === 'true';\n  const EXEC_ENDPOINT = `${baseUrl}/exec/programmatic`;\n\n  return tool(\n    async (rawParams, config) => {\n      const params = rawParams as { code: string; timeout?: number };\n      const { code, timeout = DEFAULT_TIMEOUT } = params;\n\n      const { toolMap, toolDefs, session_id, _injected_files } =\n        (config.toolCall ?? {}) as ToolCall &\n          Partial<t.ProgrammaticCache> & {\n            session_id?: string;\n            _injected_files?: t.CodeEnvFile[];\n          };\n\n      if (toolMap == null || toolMap.size === 0) {\n        throw new Error(\n          'No toolMap provided. ' +\n            'ToolNode should inject this from AgentContext when invoked through the graph.'\n        );\n      }\n\n      if (toolDefs == null || toolDefs.length === 0) {\n        throw new Error(\n          'No tool definitions provided. ' +\n            'Either pass tools in the input or ensure ToolNode injects toolDefs.'\n        );\n      }\n\n      let roundTrip = 0;\n\n      try {\n        // ====================================================================\n        // Phase 1: Filter tools and make initial request\n        // ====================================================================\n\n        const effectiveTools = filterBashToolsByUsage(toolDefs, code, debug);\n\n        if (debug) {\n          // eslint-disable-next-line no-console\n          console.log(\n            `[BashPTC Debug] Sending ${effectiveTools.length} tools to API ` +\n              `(filtered from ${toolDefs.length})`\n          );\n        }\n\n        let files: t.CodeEnvFile[] | undefined;\n        if (_injected_files && _injected_files.length > 0) {\n          files = _injected_files;\n        } else if (session_id != null && session_id.length > 0) {\n          files = await fetchSessionFiles(baseUrl, apiKey, session_id, proxy);\n        }\n\n        let response = await makeRequest(\n          EXEC_ENDPOINT,\n          apiKey,\n          {\n            lang: 'bash',\n            code,\n            tools: effectiveTools,\n            session_id,\n            timeout,\n            ...(files && files.length > 0 ? { files } : {}),\n          },\n          proxy\n        );\n\n        // ====================================================================\n        // Phase 2: Handle response loop\n        // ====================================================================\n\n        while (response.status === 'tool_call_required') {\n          roundTrip++;\n\n          if (roundTrip > maxRoundTrips) {\n            throw new Error(\n              `Exceeded maximum round trips (${maxRoundTrips}). ` +\n                'This may indicate an infinite loop, excessive tool calls, ' +\n                'or a logic error in your code.'\n            );\n          }\n\n          if (debug) {\n            // eslint-disable-next-line no-console\n            console.log(\n              `[BashPTC Debug] Round trip ${roundTrip}: ${response.tool_calls?.length ?? 0} tool(s) to execute`\n            );\n          }\n\n          const toolResults = await executeTools(\n            response.tool_calls ?? [],\n            toolMap\n          );\n\n          response = await makeRequest(\n            EXEC_ENDPOINT,\n            apiKey,\n            {\n              continuation_token: response.continuation_token,\n              tool_results: toolResults,\n            },\n            proxy\n          );\n        }\n\n        // ====================================================================\n        // Phase 3: Handle final state\n        // ====================================================================\n\n        if (response.status === 'completed') {\n          return formatCompletedResponse(response);\n        }\n\n        if (response.status === 'error') {\n          throw new Error(\n            `Execution error: ${response.error}` +\n              (response.stderr != null && response.stderr !== ''\n                ? `\\n\\nStderr:\\n${response.stderr}`\n                : '')\n          );\n        }\n\n        throw new Error(`Unexpected response status: ${response.status}`);\n      } catch (error) {\n        throw new Error(\n          `Bash programmatic execution failed: ${(error as Error).message}`\n        );\n      }\n    },\n    {\n      name: Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n      description: BashProgrammaticToolCallingDescription,\n      schema: BashProgrammaticToolCallingSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/tools/ReadFile.mjs

@@ -1,38 +0,0 @@
-import { Constants } from '../common/enum.mjs';
-
-// src/tools/ReadFile.ts
-const ReadFileToolName = Constants.READ_FILE;
-const ReadFileToolDescription = `Read the contents of a file. Returns text content with line numbers for easy reference.
-
-For skill files, use the path format: {skillName}/{filePath} (e.g. "pdf-analyzer/src/utils.py", "code-review/SKILL.md").
-
-BEHAVIOR:
-- Text files: returned with numbered lines.
-- Images (png, jpeg, gif, webp): returned as visual content the model can see.
-- PDFs: returned as document content.
-- Other binary files: metadata returned with a note to use bash for processing.
-- Large files (>256KB text, >10MB binary): metadata only.
-- SKILL.md: returns the skill's instructions directly.
-
-CONSTRAINTS:
-- Only files from invoked skills or code execution output are accessible.
-- Do not guess file paths. Use paths from the skill documentation or tool output.`;
-const ReadFileToolSchema = {
-    type: 'object',
-    properties: {
-        file_path: {
-            type: 'string',
-            description: 'Path to the file. For skill files: "{skillName}/{path}" (e.g. "pdf-analyzer/src/utils.py"). For code execution output: the path as returned by the execution tool.',
-        },
-    },
-    required: ['file_path'],
-};
-const ReadFileToolDefinition = {
-    name: ReadFileToolName,
-    description: ReadFileToolDescription,
-    parameters: ReadFileToolSchema,
-    responseFormat: 'content_and_artifact',
-};
-
-export { ReadFileToolDefinition, ReadFileToolDescription, ReadFileToolName, ReadFileToolSchema };
-//# sourceMappingURL=ReadFile.mjs.map

package/dist/esm/tools/ReadFile.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReadFile.mjs","sources":["../../../src/tools/ReadFile.ts"],"sourcesContent":["// src/tools/ReadFile.ts\nimport { Constants } from '@/common';\n\nexport const ReadFileToolName = Constants.READ_FILE;\n\nexport const ReadFileToolDescription = `Read the contents of a file. Returns text content with line numbers for easy reference.\n\nFor skill files, use the path format: {skillName}/{filePath} (e.g. \"pdf-analyzer/src/utils.py\", \"code-review/SKILL.md\").\n\nBEHAVIOR:\n- Text files: returned with numbered lines.\n- Images (png, jpeg, gif, webp): returned as visual content the model can see.\n- PDFs: returned as document content.\n- Other binary files: metadata returned with a note to use bash for processing.\n- Large files (>256KB text, >10MB binary): metadata only.\n- SKILL.md: returns the skill's instructions directly.\n\nCONSTRAINTS:\n- Only files from invoked skills or code execution output are accessible.\n- Do not guess file paths. Use paths from the skill documentation or tool output.`;\n\nexport const ReadFileToolSchema = {\n  type: 'object',\n  properties: {\n    file_path: {\n      type: 'string',\n      description:\n        'Path to the file. For skill files: \"{skillName}/{path}\" (e.g. \"pdf-analyzer/src/utils.py\"). For code execution output: the path as returned by the execution tool.',\n    },\n  },\n  required: ['file_path'],\n} as const;\n\nexport const ReadFileToolDefinition = {\n  name: ReadFileToolName,\n  description: ReadFileToolDescription,\n  parameters: ReadFileToolSchema,\n  responseFormat: 'content_and_artifact' as const,\n} as const;\n"],"names":[],"mappings":";;AAAA;AAGO,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEnC,MAAM,uBAAuB,GAAG,CAAA;;;;;;;;;;;;;;;AAgBhC,MAAM,kBAAkB,GAAG;AAChC,IAAA,IAAI,EAAE,QAAQ;AACd,IAAA,UAAU,EAAE;AACV,QAAA,SAAS,EAAE;AACT,YAAA,IAAI,EAAE,QAAQ;AACd,YAAA,WAAW,EACT,oKAAoK;AACvK,SAAA;AACF,KAAA;IACD,QAAQ,EAAE,CAAC,WAAW,CAAC;;AAGlB,MAAM,sBAAsB,GAAG;AACpC,IAAA,IAAI,EAAE,gBAAgB;AACtB,IAAA,WAAW,EAAE,uBAAuB;AACpC,IAAA,UAAU,EAAE,kBAAkB;AAC9B,IAAA,cAAc,EAAE,sBAA+B;;;;;"}

package/dist/esm/tools/SkillTool.mjs

@@ -1,45 +0,0 @@
-import { Constants } from '../common/enum.mjs';
-
-// src/tools/SkillTool.ts
-const SkillToolName = Constants.SKILL_TOOL;
-const SkillToolDescription = `Invoke a skill from the user's library. Skills provide domain-specific instructions loaded into the conversation context, and may also provide files accessible via available tools depending on the runtime environment.
-
-WHEN TO USE:
-- The user's request matches a skill listed in the "Available Skills" section of the system prompt.
-- You MUST invoke the matching skill BEFORE attempting the task yourself.
-
-WHAT HAPPENS:
-- The skill's full instructions are loaded into the conversation as context.
-- Files bundled with the skill may become accessible via available tools.
-- Follow the skill's instructions to complete the task.
-
-CONSTRAINTS:
-- Do not invoke a skill that is already active in this conversation.
-- Skill names come from the catalog only. Do not guess names.`;
-/**
- * JSON Schema for the SkillTool parameters.
- * Single source of truth used by both SkillToolDefinition (LCTool registry)
- * and createSkillTool() (DynamicStructuredTool instance).
- */
-const SkillToolSchema = {
-    type: 'object',
-    properties: {
-        skillName: {
-            type: 'string',
-            description: 'The kebab-case identifier of the skill to invoke (e.g. "financial-analyzer", "meeting-notes"). Must match a name from the "Available Skills" section.',
-        },
-        args: {
-            type: 'string',
-            description: 'Optional freeform arguments string passed to the skill.',
-        },
-    },
-    required: ['skillName'],
-};
-const SkillToolDefinition = {
-    name: SkillToolName,
-    description: SkillToolDescription,
-    parameters: SkillToolSchema,
-};
-
-export { SkillToolDefinition, SkillToolDescription, SkillToolName, SkillToolSchema };
-//# sourceMappingURL=SkillTool.mjs.map

package/dist/esm/tools/SkillTool.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"SkillTool.mjs","sources":["../../../src/tools/SkillTool.ts"],"sourcesContent":["// src/tools/SkillTool.ts\nimport { Constants } from '@/common';\n\nexport const SkillToolName = Constants.SKILL_TOOL;\n\nexport const SkillToolDescription = `Invoke a skill from the user's library. Skills provide domain-specific instructions loaded into the conversation context, and may also provide files accessible via available tools depending on the runtime environment.\n\nWHEN TO USE:\n- The user's request matches a skill listed in the \"Available Skills\" section of the system prompt.\n- You MUST invoke the matching skill BEFORE attempting the task yourself.\n\nWHAT HAPPENS:\n- The skill's full instructions are loaded into the conversation as context.\n- Files bundled with the skill may become accessible via available tools.\n- Follow the skill's instructions to complete the task.\n\nCONSTRAINTS:\n- Do not invoke a skill that is already active in this conversation.\n- Skill names come from the catalog only. Do not guess names.`;\n\n/**\n * JSON Schema for the SkillTool parameters.\n * Single source of truth used by both SkillToolDefinition (LCTool registry)\n * and createSkillTool() (DynamicStructuredTool instance).\n */\nexport const SkillToolSchema = {\n  type: 'object',\n  properties: {\n    skillName: {\n      type: 'string',\n      description:\n        'The kebab-case identifier of the skill to invoke (e.g. \"financial-analyzer\", \"meeting-notes\"). Must match a name from the \"Available Skills\" section.',\n    },\n    args: {\n      type: 'string',\n      description: 'Optional freeform arguments string passed to the skill.',\n    },\n  },\n  required: ['skillName'],\n} as const;\n\nexport const SkillToolDefinition = {\n  name: SkillToolName,\n  description: SkillToolDescription,\n  parameters: SkillToolSchema,\n} as const;\n"],"names":[],"mappings":";;AAAA;AAGO,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC,MAAM,oBAAoB,GAAG,CAAA;;;;;;;;;;;;;;AAepC;;;;AAIG;AACI,MAAM,eAAe,GAAG;AAC7B,IAAA,IAAI,EAAE,QAAQ;AACd,IAAA,UAAU,EAAE;AACV,QAAA,SAAS,EAAE;AACT,YAAA,IAAI,EAAE,QAAQ;AACd,YAAA,WAAW,EACT,uJAAuJ;AAC1J,SAAA;AACD,QAAA,IAAI,EAAE;AACJ,YAAA,IAAI,EAAE,QAAQ;AACd,YAAA,WAAW,EAAE,yDAAyD;AACvE,SAAA;AACF,KAAA;IACD,QAAQ,EAAE,CAAC,WAAW,CAAC;;AAGlB,MAAM,mBAAmB,GAAG;AACjC,IAAA,IAAI,EAAE,aAAa;AACnB,IAAA,WAAW,EAAE,oBAAoB;AACjC,IAAA,UAAU,EAAE,eAAe;;;;;"}

package/dist/esm/tools/skillCatalog.mjs

@@ -1,82 +0,0 @@
-const HEADER = '## Available Skills';
-const DEFAULT_CONTEXT_WINDOW_TOKENS = 200_000;
-const DEFAULT_BUDGET_PERCENT = 0.01;
-const DEFAULT_MAX_ENTRY_CHARS = 250;
-const DEFAULT_MIN_DESC_LENGTH = 20;
-const DEFAULT_CHARS_PER_TOKEN = 4;
-/**
- * Formats a skill catalog for injection into agent context.
- * Uses a truncation ladder: full descriptions, proportional truncation, names-only.
- * Returns empty string for empty input.
- */
-function formatSkillCatalog(skills, opts) {
-    if (skills.length === 0)
-        return '';
-    const contextWindowTokens = opts?.contextWindowTokens ?? DEFAULT_CONTEXT_WINDOW_TOKENS;
-    const budgetPercent = opts?.budgetPercent ?? DEFAULT_BUDGET_PERCENT;
-    const maxEntryChars = Math.max(1, opts?.maxEntryChars ?? DEFAULT_MAX_ENTRY_CHARS);
-    const minDescLength = opts?.minDescLength ?? DEFAULT_MIN_DESC_LENGTH;
-    const charsPerToken = opts?.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN;
-    const budgetChars = Math.floor(contextWindowTokens * budgetPercent * charsPerToken);
-    const capped = skills.map((s) => ({
-        name: s.name,
-        description: s.description.length > maxEntryChars
-            ? s.description.slice(0, maxEntryChars - 1) + '\u2026'
-            : s.description,
-    }));
-    const fullOutput = formatEntries(capped);
-    if (fullOutput.length <= budgetChars)
-        return fullOutput;
-    const headerLen = HEADER.length + 2;
-    const newlineChars = capped.length > 1 ? capped.length - 1 : 0;
-    const availableChars = budgetChars - headerLen - newlineChars;
-    const perEntryOverhead = 4;
-    const nameCharsTotal = capped.reduce((sum, s) => sum + s.name.length + perEntryOverhead, 0);
-    const availableForDescs = availableChars - nameCharsTotal;
-    if (availableForDescs <= 0) {
-        return fitNamesOnly(capped, budgetChars);
-    }
-    const maxDescPerEntry = Math.floor(availableForDescs / capped.length);
-    if (maxDescPerEntry < minDescLength) {
-        return fitNamesOnly(capped, budgetChars);
-    }
-    const truncated = capped.map((s) => ({
-        name: s.name,
-        description: s.description.length > maxDescPerEntry
-            ? s.description.slice(0, maxDescPerEntry - 1) + '\u2026'
-            : s.description,
-    }));
-    const result = formatEntries(truncated);
-    if (result.length <= budgetChars)
-        return result;
-    return fitNamesOnly(capped, budgetChars);
-}
-function formatEntries(entries) {
-    const lines = entries.map((e) => e.description ? `- ${e.name}: ${e.description}` : `- ${e.name}`);
-    return `${HEADER}\n\n${lines.join('\n')}`;
-}
-/** Names-only fallback that drops trailing entries if the list still exceeds budget. */
-function fitNamesOnly(entries, budgetChars) {
-    // Format: "HEADER\n\n- name1\n- name2\n..."
-    // Running sum avoids O(n²) repeated string construction.
-    const prefix = HEADER.length + 2; // "HEADER\n\n"
-    const entryOverhead = 2; // "- "
-    let total = prefix;
-    let fitCount = 0;
-    for (let i = 0; i < entries.length; i++) {
-        const added = (i > 0 ? 1 : 0) + entryOverhead + entries[i].name.length;
-        if (total + added > budgetChars)
-            break;
-        total += added;
-        fitCount = i + 1;
-    }
-    if (fitCount === 0)
-        return '';
-    const namesOnly = entries
-        .slice(0, fitCount)
-        .map((s) => ({ name: s.name, description: '' }));
-    return formatEntries(namesOnly);
-}
-
-export { formatSkillCatalog };
-//# sourceMappingURL=skillCatalog.mjs.map

package/dist/esm/tools/skillCatalog.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"skillCatalog.mjs","sources":["../../../src/tools/skillCatalog.ts"],"sourcesContent":["// src/tools/skillCatalog.ts\nimport type { SkillCatalogEntry } from '@/types';\n\nconst HEADER = '## Available Skills';\nconst DEFAULT_CONTEXT_WINDOW_TOKENS = 200_000;\nconst DEFAULT_BUDGET_PERCENT = 0.01;\nconst DEFAULT_MAX_ENTRY_CHARS = 250;\nconst DEFAULT_MIN_DESC_LENGTH = 20;\nconst DEFAULT_CHARS_PER_TOKEN = 4;\n\nexport type SkillCatalogOptions = {\n  /** Total context window in tokens. Default: 200_000 */\n  contextWindowTokens?: number;\n  /** Fraction of context budget for catalog. Default: 0.01 (1%) */\n  budgetPercent?: number;\n  /** Max chars per entry description. Default: 250 */\n  maxEntryChars?: number;\n  /** Descriptions below this length trigger names-only fallback. Default: 20 */\n  minDescLength?: number;\n  /** Approximate chars per token for budget calculation. Default: 4 */\n  charsPerToken?: number;\n};\n\n/**\n * Formats a skill catalog for injection into agent context.\n * Uses a truncation ladder: full descriptions, proportional truncation, names-only.\n * Returns empty string for empty input.\n */\nexport function formatSkillCatalog(\n  skills: SkillCatalogEntry[],\n  opts?: SkillCatalogOptions\n): string {\n  if (skills.length === 0) return '';\n\n  const contextWindowTokens =\n    opts?.contextWindowTokens ?? DEFAULT_CONTEXT_WINDOW_TOKENS;\n  const budgetPercent = opts?.budgetPercent ?? DEFAULT_BUDGET_PERCENT;\n  const maxEntryChars = Math.max(\n    1,\n    opts?.maxEntryChars ?? DEFAULT_MAX_ENTRY_CHARS\n  );\n  const minDescLength = opts?.minDescLength ?? DEFAULT_MIN_DESC_LENGTH;\n  const charsPerToken = opts?.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN;\n\n  const budgetChars = Math.floor(\n    contextWindowTokens * budgetPercent * charsPerToken\n  );\n\n  const capped = skills.map((s) => ({\n    name: s.name,\n    description:\n      s.description.length > maxEntryChars\n        ? s.description.slice(0, maxEntryChars - 1) + '\\u2026'\n        : s.description,\n  }));\n\n  const fullOutput = formatEntries(capped);\n  if (fullOutput.length <= budgetChars) return fullOutput;\n\n  const headerLen = HEADER.length + 2;\n  const newlineChars = capped.length > 1 ? capped.length - 1 : 0;\n  const availableChars = budgetChars - headerLen - newlineChars;\n  const perEntryOverhead = 4;\n  const nameCharsTotal = capped.reduce(\n    (sum, s) => sum + s.name.length + perEntryOverhead,\n    0\n  );\n  const availableForDescs = availableChars - nameCharsTotal;\n\n  if (availableForDescs <= 0) {\n    return fitNamesOnly(capped, budgetChars);\n  }\n\n  const maxDescPerEntry = Math.floor(availableForDescs / capped.length);\n\n  if (maxDescPerEntry < minDescLength) {\n    return fitNamesOnly(capped, budgetChars);\n  }\n\n  const truncated = capped.map((s) => ({\n    name: s.name,\n    description:\n      s.description.length > maxDescPerEntry\n        ? s.description.slice(0, maxDescPerEntry - 1) + '\\u2026'\n        : s.description,\n  }));\n\n  const result = formatEntries(truncated);\n  if (result.length <= budgetChars) return result;\n  return fitNamesOnly(capped, budgetChars);\n}\n\nfunction formatEntries(\n  entries: { name: string; description: string }[]\n): string {\n  const lines = entries.map((e) =>\n    e.description ? `- ${e.name}: ${e.description}` : `- ${e.name}`\n  );\n  return `${HEADER}\\n\\n${lines.join('\\n')}`;\n}\n\n/** Names-only fallback that drops trailing entries if the list still exceeds budget. */\nfunction fitNamesOnly(\n  entries: { name: string }[],\n  budgetChars: number\n): string {\n  // Format: \"HEADER\\n\\n- name1\\n- name2\\n...\"\n  // Running sum avoids O(n²) repeated string construction.\n  const prefix = HEADER.length + 2; // \"HEADER\\n\\n\"\n  const entryOverhead = 2; // \"- \"\n  let total = prefix;\n  let fitCount = 0;\n\n  for (let i = 0; i < entries.length; i++) {\n    const added = (i > 0 ? 1 : 0) + entryOverhead + entries[i].name.length;\n    if (total + added > budgetChars) break;\n    total += added;\n    fitCount = i + 1;\n  }\n\n  if (fitCount === 0) return '';\n  const namesOnly = entries\n    .slice(0, fitCount)\n    .map((s) => ({ name: s.name, description: '' }));\n  return formatEntries(namesOnly);\n}\n"],"names":[],"mappings":"AAGA,MAAM,MAAM,GAAG,qBAAqB;AACpC,MAAM,6BAA6B,GAAG,OAAO;AAC7C,MAAM,sBAAsB,GAAG,IAAI;AACnC,MAAM,uBAAuB,GAAG,GAAG;AACnC,MAAM,uBAAuB,GAAG,EAAE;AAClC,MAAM,uBAAuB,GAAG,CAAC;AAejC;;;;AAIG;AACG,SAAU,kBAAkB,CAChC,MAA2B,EAC3B,IAA0B,EAAA;AAE1B,IAAA,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;AAElC,IAAA,MAAM,mBAAmB,GACvB,IAAI,EAAE,mBAAmB,IAAI,6BAA6B;AAC5D,IAAA,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,sBAAsB;AACnE,IAAA,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,CAAC,EACD,IAAI,EAAE,aAAa,IAAI,uBAAuB,CAC/C;AACD,IAAA,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,uBAAuB;AACpE,IAAA,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,uBAAuB;AAEpE,IAAA,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,mBAAmB,GAAG,aAAa,GAAG,aAAa,CACpD;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM;QAChC,IAAI,EAAE,CAAC,CAAC,IAAI;AACZ,QAAA,WAAW,EACT,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG;AACrB,cAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,GAAG;cAC5C,CAAC,CAAC,WAAW;AACpB,KAAA,CAAC,CAAC;AAEH,IAAA,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC;AACxC,IAAA,IAAI,UAAU,CAAC,MAAM,IAAI,WAAW;AAAE,QAAA,OAAO,UAAU;AAEvD,IAAA,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;AACnC,IAAA,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC;AAC9D,IAAA,MAAM,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY;IAC7D,MAAM,gBAAgB,GAAG,CAAC;IAC1B,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAClC,CAAC,GAAG,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,EAClD,CAAC,CACF;AACD,IAAA,MAAM,iBAAiB,GAAG,cAAc,GAAG,cAAc;AAEzD,IAAA,IAAI,iBAAiB,IAAI,CAAC,EAAE;AAC1B,QAAA,OAAO,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC;IAC1C;AAEA,IAAA,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;AAErE,IAAA,IAAI,eAAe,GAAG,aAAa,EAAE;AACnC,QAAA,OAAO,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC;IAC1C;IAEA,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM;QACnC,IAAI,EAAE,CAAC,CAAC,IAAI;AACZ,QAAA,WAAW,EACT,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG;AACrB,cAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,GAAG;cAC9C,CAAC,CAAC,WAAW;AACpB,KAAA,CAAC,CAAC;AAEH,IAAA,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC;AACvC,IAAA,IAAI,MAAM,CAAC,MAAM,IAAI,WAAW;AAAE,QAAA,OAAO,MAAM;AAC/C,IAAA,OAAO,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC;AAC1C;AAEA,SAAS,aAAa,CACpB,OAAgD,EAAA;AAEhD,IAAA,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAC1B,CAAC,CAAC,WAAW,GAAG,CAAA,EAAA,EAAK,CAAC,CAAC,IAAI,CAAA,EAAA,EAAK,CAAC,CAAC,WAAW,CAAA,CAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAA,CAAE,CAChE;IACD,OAAO,CAAA,EAAG,MAAM,CAAA,IAAA,EAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;AAC3C;AAEA;AACA,SAAS,YAAY,CACnB,OAA2B,EAC3B,WAAmB,EAAA;;;IAInB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;AACjC,IAAA,MAAM,aAAa,GAAG,CAAC,CAAC;IACxB,IAAI,KAAK,GAAG,MAAM;IAClB,IAAI,QAAQ,GAAG,CAAC;AAEhB,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACvC,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM;AACtE,QAAA,IAAI,KAAK,GAAG,KAAK,GAAG,WAAW;YAAE;QACjC,KAAK,IAAI,KAAK;AACd,QAAA,QAAQ,GAAG,CAAC,GAAG,CAAC;IAClB;IAEA,IAAI,QAAQ,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;IAC7B,MAAM,SAAS,GAAG;AACf,SAAA,KAAK,CAAC,CAAC,EAAE,QAAQ;SACjB,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;AAClD,IAAA,OAAO,aAAa,CAAC,SAAS,CAAC;AACjC;;;;"}

package/dist/types/hooks/HookRegistry.d.ts

@@ -1,56 +0,0 @@
-import type { HookEvent, HookMatcher } from './types';
-/**
- * Run-scoped storage for hook matchers with an additional layer for
- * session-scoped matchers that should be cleaned up between sessions.
- *
- * Hosts construct one registry per `Run` (mirroring how `HandlerRegistry` is
- * scoped) and register global matchers + per-session matchers against it.
- * Registration is strictly additive — nothing in this class mutates a
- * matcher's callbacks or flags after insertion.
- *
- * ## Why `Map<sessionId, MatcherBucket>` and not `Record`
- *
- * LibreChat runs thousands of parallel sessions in one Node process, and
- * hook registration happens inside hot paths (tool loading, agent spawning).
- * A `Record<sessionId, ...>` has to be spread on every insertion, which is
- * O(n) per call and O(n²) total for a batch of parallel registrations. A
- * Map mutates in place, keeping insertions O(1). This mirrors the reasoning
- * Claude Code documents at `utils/hooks/sessionHooks.ts:62`.
- */
-export declare class HookRegistry {
-    private readonly global;
-    private readonly sessions;
-    /**
-     * Register a matcher for the lifetime of this registry (= one Run).
-     * Returns an unregister function that removes the matcher by reference.
-     */
-    register<E extends HookEvent>(event: E, matcher: HookMatcher<E>): () => void;
-    /**
-     * Register a matcher for a specific session. Cleared automatically when
-     * `clearSession(sessionId)` is called, or can be removed directly via the
-     * returned unregister function.
-     */
-    registerSession<E extends HookEvent>(sessionId: string, event: E, matcher: HookMatcher<E>): () => void;
-    /**
-     * Returns all matchers registered for `event`, concatenating global first
-     * and then session-specific (when `sessionId` is supplied). The caller
-     * receives a fresh array, so iterating it is safe even if a matcher is
-     * removed mid-iteration (e.g. via `once: true`).
-     */
-    getMatchers<E extends HookEvent>(event: E, sessionId?: string): HookMatcher<E>[];
-    /**
-     * Removes `matcher` by reference from global storage first, falling back
-     * to the session bucket when `sessionId` is supplied. Used by
-     * `executeHooks` to drop `once: true` matchers after they fire.
-     */
-    removeMatcher<E extends HookEvent>(event: E, matcher: HookMatcher<E>, sessionId?: string): boolean;
-    /**
-     * Drops every session-scoped matcher for `sessionId`. Call this in the
-     * `finally` block around a Run so a `once: true` hook that never fired
-     * cannot leak into the next session on the same registry.
-     */
-    clearSession(sessionId: string): void;
-    /** True if at least one matcher exists for `event` (global + session). */
-    hasHookFor(event: HookEvent, sessionId?: string): boolean;
-    private ensureSessionBucket;
-}