tianxincode 1.0.45 → 1.0.47

package/README.md

@@ -22,7 +22,7 @@ txcode web
 ```
 
 访问http://localhost:4000 页面 设置里配置模型提供商和模型，然后可以web端交互，也可以ctrl+c 关闭后启动命令行方式
-![配置提供商和模型](https://github.com/joinz2015-boop/txcode/blob/2102880c0cbcaad909aae7f0a00b069538b00189/doc/001.png)
+![配置提供商和模型](https://github.com/joinz2015-boop/txcode/blob/main/docs/001.png)
 
 ```bash
 txcode

package/dist/config/tx.config.d.ts

@@ -3,32 +3,8 @@
  * 此文件定义了 TxCode 项目的全局配置接口和默认配置
  * 主要用于控制应用程序的基本行为，如调试模式和日志记录
  */
-export interface ContextConfig {
-    mode: 'fixed' | 'percentage';
-    maxTokens: number;
-    percentage: number;
-    autoCompact: boolean;
-}
-export interface TxConfig {
-    debug: boolean;
-    log: {
-        enabled: boolean;
-        dir: string;
-        accessLog: string;
-    };
-    maxToolIterations: number;
-    ai: {
-        maxContextTokens: number;
-        context: ContextConfig;
-    };
-    songbing: {
-        platformUrl: string;
-    };
-}
-/**
- * TxCode 默认配置
- * 这是应用程序的默认配置，可以在运行时通过其他方式覆盖
- */
+import type { TxConfig } from '../entity/tx-config.entity.js';
+export type { ContextConfig, TxConfig } from '../entity/tx-config.entity.js';
 declare const config: TxConfig;
 export default config;
 export declare function getSongbingApiBaseUrl(): string;

package/dist/config/tx.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tx.config.d.ts","sourceRoot":"","sources":["../../src/config/tx.config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,CAAC;IAEf,GAAG,EAAE;QACH,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,iBAAiB,EAAE,MAAM,CAAC;IAE1B,EAAE,EAAE;QACF,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,aAAa,CAAC;KACxB,CAAC;IAEF,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;GAGG;AACH,QAAA,MAAM,MAAM,EAAE,QAyBb,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}
+{"version":3,"file":"tx.config.d.ts","sourceRoot":"","sources":["../../src/config/tx.config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAiD7E,QAAA,MAAM,MAAM,EAAE,QAiBb,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/config/tx.config.js

@@ -3,11 +3,30 @@
  * 此文件定义了 TxCode 项目的全局配置接口和默认配置
  * 主要用于控制应用程序的基本行为，如调试模式和日志记录
  */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+function getUserConfigPath() {
+    const home = os.homedir();
+    return path.join(home, '.txcode', 'txcode.json');
+}
+function loadUserConfig() {
+    const configPath = getUserConfigPath();
+    if (!fs.existsSync(configPath))
+        return null;
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * TxCode 默认配置
  * 这是应用程序的默认配置，可以在运行时通过其他方式覆盖
  */
-const config = {
+const defaults = {
     debug: false,
     log: {
         enabled: false,
@@ -16,11 +35,9 @@ const config = {
     },
     maxToolIterations: 50,
     ai: {
-        maxContextTokens: 150000,
         context: {
             mode: 'fixed',
             maxTokens: 150000,
-            //maxTokens: 8000,
             percentage: 0.95,
             autoCompact: true,
         },
@@ -29,6 +46,25 @@ const config = {
         platformUrl: 'https://ai.songbingcloud.com',
     },
 };
+const userConfig = loadUserConfig();
+const config = {
+    debug: defaults.debug,
+    log: {
+        enabled: userConfig?.log?.enabled ?? defaults.log.enabled,
+        dir: defaults.log.dir,
+        accessLog: defaults.log.accessLog,
+    },
+    maxToolIterations: userConfig?.maxToolIterations ?? defaults.maxToolIterations,
+    ai: {
+        context: {
+            mode: defaults.ai.context.mode,
+            maxTokens: userConfig?.ai?.context?.maxTokens ?? defaults.ai.context.maxTokens,
+            percentage: defaults.ai.context.percentage,
+            autoCompact: defaults.ai.context.autoCompact,
+        },
+    },
+    songbing: defaults.songbing,
+};
 export default config;
 export function getSongbingApiBaseUrl() {
     return config.songbing?.platformUrl + '/api/v1';

package/dist/config/tx.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"tx.config.js","sourceRoot":"","sources":["../../src/config/tx.config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8BH;;;GAGG;AACH,MAAM,MAAM,GAAa;IACvB,KAAK,EAAE,KAAK;IAEZ,GAAG,EAAE;QACH,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,KAAK;QACV,SAAS,EAAE,YAAY;KACxB;IAED,iBAAiB,EAAE,EAAE;IAErB,EAAE,EAAE;QACF,gBAAgB,EAAE,MAAM;QACxB,OAAO,EAAE;YACP,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,MAAM;YACjB,kBAAkB;YAClB,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,IAAI;SAClB;KACF;IAEH,QAAQ,EAAE;QACN,WAAW,EAAE,8BAA8B;KAC5C;CACF,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;AAClD,CAAC"}
+{"version":3,"file":"tx.config.js","sourceRoot":"","sources":["../../src/config/tx.config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAIzB,SAAS,iBAAiB;IACxB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,QAAQ,GAAa;IACzB,KAAK,EAAE,KAAK;IAEZ,GAAG,EAAE;QACH,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,KAAK;QACV,SAAS,EAAE,YAAY;KACxB;IAED,iBAAiB,EAAE,EAAE;IAErB,EAAE,EAAE;QACF,OAAO,EAAE;YACP,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,MAAM;YACjB,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,IAAI;SAClB;KACF;IAED,QAAQ,EAAE;QACR,WAAW,EAAE,8BAA8B;KAC5C;CACF,CAAC;AAEF,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;AAEpC,MAAM,MAAM,GAAa;IACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,GAAG,EAAE;QACH,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO;QACzD,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG;QACrB,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS;KAClC;IACD,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,IAAI,QAAQ,CAAC,iBAAiB;IAC9E,EAAE,EAAE;QACF,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI;YAC9B,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS;YAC9E,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU;YAC1C,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW;SAC7C;KACF;IACD,QAAQ,EAAE,QAAQ,CAAC,QAAQ;CAC5B,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;AAClD,CAAC"}

package/dist/core/ai/agents/agent.tool.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Agent 公共工具处理模块
+ *
+ * 设计目标:
+ * - 各 agent 仅声明自己的工具白名单(在各 agent 目录下的 agent_tool.ts)
+ * - 工具加载、过滤、查找、执行等重复逻辑统一收敛到本文件
+ * - Registry 是纯逻辑层,无任何工具常量内嵌
+ *
+ * 兼容点:
+ * - execute() 支持 verboseError(code 模式:工具不存在时附 Available tools 列表)
+ * - buildToolContext() 支持 dream/mem/skill 等写死 sessionId 的需求
+ * - parseToolCalls() 静态方法,统一处理 arguments 字符串/对象兼容
+ */
+import { ToolContext } from '../../tools/tool.types.js';
+import { ProviderToolCall } from '../provider/base.js';
+import { ToolDefinition } from '../ai.types.js';
+export interface AgentToolRegistryOptions {
+    /**
+     * 工具不存在时,错误信息是否附带可用工具列表
+     * - true: "Tool not found: X. Available tools: ..."
+     * - false(默认): "Tool not found: X"
+     */
+    verboseError?: boolean;
+    /**
+     * 是否加载所有工具(忽略 allowedTools)
+     * - 适配 common 模式:不做白名单过滤,把全量工具作为 Function Calling 候选
+     */
+    loadAll?: boolean;
+}
+export interface ExecuteOptions {
+    abortSignal?: AbortSignal;
+}
+export type ToolExecutionResult = {
+    success: boolean;
+    data?: any;
+    error?: string;
+};
+/**
+ * Agent 工具注册器
+ *
+ * 用法:
+ *   const registry = new AgentToolRegistry(CODE_TOOLS, { verboseError: true });
+ *   const tools = await registry.getDefinitions();
+ *   const result = await registry.execute(name, args, ctx);
+ *   const calls = AgentToolRegistry.parseToolCalls(response.toolCalls);
+ */
+export declare class AgentToolRegistry {
+    private allowedTools;
+    private verboseError;
+    private loadAll;
+    private rawToolsMap;
+    private loaded;
+    constructor(allowedTools: ReadonlyArray<string> | null, options?: AgentToolRegistryOptions);
+    /**
+     * lazy 加载:首次访问时从 getProviderTools 加载并按白名单过滤
+     */
+    private ensureLoaded;
+    /**
+     * 取得白名单内(或全量)工具的 OpenAI 形态定义,供 provider.chat 的 `tools` 参数使用
+     */
+    getDefinitions(): Promise<ToolDefinition[]>;
+    /**
+     * 取得所有内置工具的 OpenAI 形态定义(全量),供系统 prompt 中描述使用
+     */
+    getBuiltinDefinitions(): Promise<ToolDefinition[]>;
+    /**
+     * 统一执行入口
+     * - verboseError=true 时,工具不存在时附带 "Available tools: ..." 列表
+     * - 返回 `{ success, data?, error? }`,捕获所有异常,不会向上抛
+     */
+    execute(name: string, args: Record<string, any>, context: ToolContext): Promise<ToolExecutionResult>;
+    /**
+     * 解析 provider 返回的 toolCalls,统一处理 arguments 字符串/对象兼容
+     * - 静态方法,不依赖 Registry 实例状态
+     */
+    static parseToolCalls(rawToolCalls: any[]): ProviderToolCall[];
+    private toOpenAITool;
+}
+/**
+ * 构造工具执行上下文
+ * - sessionId 显式传入(适配 dream/mem/skill 等固定 sessionId 的需求)
+ * - workDir 默认 process.cwd()
+ */
+export declare function buildToolContext(input: {
+    sessionId: string;
+    projectPath?: string;
+}): ToolContext;
+//# sourceMappingURL=agent.tool.d.ts.map

package/dist/core/ai/agents/agent.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.tool.d.ts","sourceRoot":"","sources":["../../../../src/core/ai/agents/agent.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAQ,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,MAAM,CAAkB;gBAG9B,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,EAC1C,OAAO,GAAE,wBAA6B;IAOxC;;OAEG;YACW,YAAY;IAW1B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAKjD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIxD;;;;OAIG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAmB/B;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,gBAAgB,EAAE;IAqB9D,OAAO,CAAC,YAAY;CAUrB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,WAAW,CAKd"}

package/dist/core/ai/agents/agent.tool.js

@@ -0,0 +1,133 @@
+/**
+ * Agent 公共工具处理模块
+ *
+ * 设计目标:
+ * - 各 agent 仅声明自己的工具白名单(在各 agent 目录下的 agent_tool.ts)
+ * - 工具加载、过滤、查找、执行等重复逻辑统一收敛到本文件
+ * - Registry 是纯逻辑层,无任何工具常量内嵌
+ *
+ * 兼容点:
+ * - execute() 支持 verboseError(code 模式:工具不存在时附 Available tools 列表)
+ * - buildToolContext() 支持 dream/mem/skill 等写死 sessionId 的需求
+ * - parseToolCalls() 静态方法,统一处理 arguments 字符串/对象兼容
+ */
+import { getProviderTools } from '../../tools/provider/index.js';
+import { getOpenAITools } from '../../tools/provider/tools.js';
+/**
+ * Agent 工具注册器
+ *
+ * 用法:
+ *   const registry = new AgentToolRegistry(CODE_TOOLS, { verboseError: true });
+ *   const tools = await registry.getDefinitions();
+ *   const result = await registry.execute(name, args, ctx);
+ *   const calls = AgentToolRegistry.parseToolCalls(response.toolCalls);
+ */
+export class AgentToolRegistry {
+    constructor(allowedTools, options = {}) {
+        this.rawToolsMap = new Map();
+        this.loaded = false;
+        this.allowedTools = allowedTools;
+        this.verboseError = options.verboseError ?? false;
+        this.loadAll = options.loadAll ?? false;
+    }
+    /**
+     * lazy 加载:首次访问时从 getProviderTools 加载并按白名单过滤
+     */
+    async ensureLoaded() {
+        if (this.loaded)
+            return;
+        const allTools = await getProviderTools();
+        for (const tool of allTools) {
+            if (this.loadAll || this.allowedTools === null || this.allowedTools.includes(tool.name)) {
+                this.rawToolsMap.set(tool.name, tool);
+            }
+        }
+        this.loaded = true;
+    }
+    /**
+     * 取得白名单内(或全量)工具的 OpenAI 形态定义,供 provider.chat 的 `tools` 参数使用
+     */
+    async getDefinitions() {
+        await this.ensureLoaded();
+        return Array.from(this.rawToolsMap.values()).map(tool => this.toOpenAITool(tool));
+    }
+    /**
+     * 取得所有内置工具的 OpenAI 形态定义(全量),供系统 prompt 中描述使用
+     */
+    async getBuiltinDefinitions() {
+        return await getOpenAITools();
+    }
+    /**
+     * 统一执行入口
+     * - verboseError=true 时,工具不存在时附带 "Available tools: ..." 列表
+     * - 返回 `{ success, data?, error? }`,捕获所有异常,不会向上抛
+     */
+    async execute(name, args, context) {
+        await this.ensureLoaded();
+        try {
+            const tool = this.rawToolsMap.get(name);
+            if (!tool) {
+                const available = Array.from(this.rawToolsMap.keys()).join(', ');
+                const suffix = this.verboseError ? `. Available tools: ${available}` : '';
+                throw new Error(`Tool not found: ${name}${suffix}`);
+            }
+            const result = await tool.execute(args, context);
+            return { success: result.success, data: result.output, error: result.error };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * 解析 provider 返回的 toolCalls,统一处理 arguments 字符串/对象兼容
+     * - 静态方法,不依赖 Registry 实例状态
+     */
+    static parseToolCalls(rawToolCalls) {
+        if (!rawToolCalls || rawToolCalls.length === 0)
+            return [];
+        return rawToolCalls.map((tc) => {
+            let parsedArgs;
+            if (typeof tc.function.arguments === 'string') {
+                try {
+                    parsedArgs = JSON.parse(tc.function.arguments);
+                }
+                catch {
+                    parsedArgs = {};
+                }
+            }
+            else {
+                parsedArgs = tc.function.arguments || {};
+            }
+            return {
+                id: tc.id,
+                name: tc.function.name,
+                arguments: parsedArgs,
+            };
+        });
+    }
+    toOpenAITool(tool) {
+        return {
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+            },
+        };
+    }
+}
+/**
+ * 构造工具执行上下文
+ * - sessionId 显式传入(适配 dream/mem/skill 等固定 sessionId 的需求)
+ * - workDir 默认 process.cwd()
+ */
+export function buildToolContext(input) {
+    return {
+        sessionId: input.sessionId,
+        workDir: input.projectPath || process.cwd(),
+    };
+}
+//# sourceMappingURL=agent.tool.js.map

package/dist/core/ai/agents/agent.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.tool.js","sourceRoot":"","sources":["../../../../src/core/ai/agents/agent.tool.ts"],"names":[],"mappings":"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"}

package/dist/core/ai/agents/caller/agent_tool.d.ts

@@ -0,0 +1,2 @@
+export declare const CALLER_DEFAULT_TOOLS: string[];
+//# sourceMappingURL=agent_tool.d.ts.map

package/dist/core/ai/agents/caller/agent_tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_tool.d.ts","sourceRoot":"","sources":["../../../../../src/core/ai/agents/caller/agent_tool.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,UAShC,CAAA"}

package/dist/core/ai/agents/caller/agent_tool.js

@@ -0,0 +1,11 @@
+export const CALLER_DEFAULT_TOOLS = [
+    'read_file',
+    'write_file',
+    'edit_file',
+    'bash',
+    'glob',
+    'grep',
+    'web_search',
+    'web_fetch',
+];
+//# sourceMappingURL=agent_tool.js.map

package/dist/core/ai/agents/caller/agent_tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_tool.js","sourceRoot":"","sources":["../../../../../src/core/ai/agents/caller/agent_tool.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW;IACX,YAAY;IACZ,WAAW;IACX,MAAM;IACN,MAAM;IACN,MAAM;IACN,YAAY;IACZ,WAAW;CACZ,CAAA"}

package/dist/core/ai/agents/caller/caller.agent.d.ts

@@ -0,0 +1,112 @@
+/**
+ * CallerAgent — 被外部系统调用的 AI Agent
+ *
+ * 与 CodeAgent 关键差异：
+ * - 工具分内置（本地执行）和扩展（HTTP 回调到外部系统）
+ * - 提示词不含 memory-context（caller 不加载项目记忆）
+ * - 不支持 specInjector / hooks
+ * - 扩展工具通过 HTTP POST 到 callbackUrl 执行，默认 30s 超时
+ */
+import { BaseProvider } from '../../ai.types.js';
+import { AIProvider, ProviderRunOptions, ProviderRunResult } from '../../provider/base.js';
+import type { MemoryService } from '../../../../services/memory/memory.service.js';
+import type { SummarizerAgent } from '../summarizer/summarizer.agent.js';
+import type { SessionService } from '../../../../services/session/session.service.js';
+import { ExtendedToolDef } from './types.js';
+/**
+ * 构建 Caller 系统提示词
+ *
+ * 组装顺序：
+ * 1. 角色模板（role.txt）
+ * 2. 外部系统额外提示词（systemPrompt 参数，追加而非替换）
+ * 3. 可用 Skills 列表
+ * 4. 替换 {platform} / {workdir} 占位符
+ */
+export declare function buildCallerPrompt(options?: {
+    platform?: string;
+    workdir?: string;
+    systemPrompt?: string;
+}): Promise<string>;
+export interface CallerAgentConfig {
+    provider: BaseProvider;
+    maxIterations?: number;
+    projectPath?: string;
+    sessionId?: string;
+    memoryService?: MemoryService;
+    summarizer?: SummarizerAgent;
+    sessionService?: SessionService;
+    callbackUrl: string;
+    extendedTools: ExtendedToolDef[];
+    systemPrompt?: string;
+    toolTimeout?: number;
+}
+export declare class CallerAgent implements AIProvider {
+    name: string;
+    keepContext: boolean;
+    /** 内置工具列表：始终可用，本地执行（引用 agent_tool.ts 单一来源） */
+    private builtinTools;
+    /** 扩展工具：init 时由外部系统传入，通过 HTTP 回调执行 */
+    private extendedTools;
+    private callbackUrl;
+    private systemPrompt;
+    private toolTimeout;
+    private provider;
+    private maxIterations;
+    private projectPath?;
+    private sessionId?;
+    private memoryService?;
+    private summarizer?;
+    private sessionService?;
+    private userMessage;
+    /** Function Calling 格式的工具定义（供 AI API 使用） */
+    private providerTools;
+    private providerToolsMap;
+    private toolRegistry;
+    private extendedToolsSet;
+    constructor(config: CallerAgentConfig);
+    /** 返回所有可用工具名（内置 + 扩展） */
+    get tools(): string[];
+    /**
+     * 执行 AI Function Calling 循环
+     *
+     * 流程：
+     * 1. 准备工具定义（内置 + 扩展 → Function Calling 格式）
+     * 2. 构建系统提示词（buildCallerPrompt）
+     * 3. 恢复历史消息
+     * 4. 循环：
+     *    a. 调用 AI API（携带工具列表）
+     *    b. finishReason='stop' → 得到最终回复，退出
+     *    c. finishReason='tool_calls' → 执行工具 → 结果加入消息 → 继续循环
+     *    d. 超过 maxIterations → 返回失败
+     */
+    run(userMessage: string, options?: ProviderRunOptions): Promise<ProviderRunResult>;
+    getType(): string;
+    /**
+     * 执行工具调用
+     *
+     * 路由逻辑：
+     * - 扩展工具 → executeExtendedTool（HTTP POST 到 callbackUrl）
+     * - 内置工具 → 从 rawToolsMap 查找 Tool 对象，调用其 execute 方法
+     * - 未找到 → 返回错误
+     */
+    private executeTool;
+    /**
+     * 执行扩展工具：HTTP POST 到外部系统 callbackUrl
+     *
+     * 请求体：{ toolName, arguments, sessionId }
+     * 响应体：{ success, output?, error? }
+     *
+     * 超时控制：默认 30s（可通过 init 的 toolTimeout 配置）
+     * Abort 传播：外部 abortSignal + 内部超时 timer 双重保障
+     */
+    private executeExtendedTool;
+    /**
+     * 获取合并后的 Function Calling 工具定义
+     * 内置工具从 getProviderTools 过滤，扩展工具直接使用外部传入的定义
+     */
+    private getFilteredTools;
+    /** 将消息写入 memoryService，用于断线重连后恢复上下文 */
+    private addMessage;
+    private pushUserMessage;
+}
+//# sourceMappingURL=caller.agent.d.ts.map

package/dist/core/ai/agents/caller/caller.agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller.agent.d.ts","sourceRoot":"","sources":["../../../../../src/core/ai/agents/caller/caller.agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAkC,MAAM,mBAAmB,CAAA;AAEhF,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EAIlB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAA;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAA;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAiB5C;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,eAAe,EAAE,CAAA;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,qBAAa,WAAY,YAAW,UAAU;IAC5C,IAAI,SAAW;IACf,WAAW,UAAO;IAElB,8CAA8C;IAC9C,OAAO,CAAC,YAAY,CAAsC;IAE1D,sCAAsC;IACtC,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,WAAW,CAAgB;IAEnC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,WAAW,CAAa;IAChC,4CAA4C;IAC5C,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,gBAAgB,CAAyB;gBAErC,MAAM,EAAE,iBAAiB;IAgBrC,yBAAyB;IACzB,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED;;;;;;;;;;;;OAYG;IACG,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC;IAgK7B,OAAO,IAAI,MAAM;IAIjB;;;;;;;OAOG;YACW,WAAW;IAazB;;;;;;;;OAQG;YACW,mBAAmB;IA6CjC;;;OAGG;YACW,gBAAgB;IAe9B,uCAAuC;IACvC,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,eAAe;CAoBxB"}