@lingxiao-office/sdk 1.0.0

package/dist/tools/ToolMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolMetadata.d.ts","sourceRoot":"","sources":["../../src/tools/ToolMetadata.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE3N,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC;CAC7E;AAOD,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAkH/D,CAAC;AAEH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAE1D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAEnE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,QAAiB,GAAG,OAAO,CAG3F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAEzG;AAED,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAAqD,CAAC;AAC/G,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAAgF,CAAC;AAC5I,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAA0D,CAAC"}

package/dist/tools/ToolMetadata.js

@@ -0,0 +1,139 @@
+const read = (category, extra = {}) => ({ tier: 'read', category, readOnly: true, resultShape: 'json', ...extra });
+const compute = (category, extra = {}) => ({ tier: 'compute', category, readOnly: true, resultShape: 'text', ...extra });
+const write = (category, extra = {}) => ({ tier: 'write', category, modifiesWorkspace: true, resultShape: 'text', ...extra });
+const execute = (category, extra = {}) => ({ tier: 'execute', category, dangerous: true, resultShape: 'text', ...extra });
+export const TOOL_METADATA = Object.freeze({
+    // Session / coordination
+    session_artifacts: read('session', { core: true, parallelSafe: true, leaderParallelSafe: true }),
+    find_tools: read('session', { core: true, parallelSafe: true, leaderParallelSafe: true }),
+    tool_preflight: read('session', { core: true, parallelSafe: true, leaderParallelSafe: true }),
+    parallel_read_batch: read('session', { core: true, parallelSafe: true, leaderParallelSafe: true }),
+    send_message: read('communication', { core: true }),
+    attempt_completion: read('completion', { core: true, resultShape: 'text' }),
+    declare_assumption: read('communication', { core: true, resultShape: 'json' }),
+    // Files / local search
+    file_read: read('file', { core: true, parallelSafe: true, leaderParallelSafe: true, resultShape: 'text' }),
+    list_dir: read('file', { core: true, parallelSafe: true, leaderParallelSafe: true }),
+    glob: read('search', { core: true, parallelSafe: true, leaderParallelSafe: true, resultShape: 'text' }),
+    code_search: read('search', { core: true, parallelSafe: true, leaderParallelSafe: true, resultShape: 'json' }),
+    ast_query: read('search', { core: true, parallelSafe: true, leaderParallelSafe: true, resultShape: 'json' }),
+    structured_patch: write('file', { core: true, requiresReadFirst: true, resultShape: 'json' }),
+    file_create: write('file', { core: true, requiresReadFirst: true }),
+    parse_file: read('office', { resultShape: 'text' }),
+    // Execution / terminal
+    shell: execute('execution', { core: true, resultShape: 'task_handle', nextToolHints: ['get_terminal_output'], privileged: true }),
+    python_exec: execute('execution', { privileged: true }),
+    get_terminal_output: read('execution', { resultShape: 'text' }),
+    terminal_control: execute('execution', { resultShape: 'json', privileged: true }),
+    // Network / browser
+    http_request: execute('network', { requiresNetwork: true, privileged: true, resultShape: 'text' }),
+    web_fetch: compute('network', { requiresNetwork: true, leaderParallelSafe: true, resultShape: 'text' }),
+    web_search: compute('network', { requiresNetwork: true, leaderParallelSafe: true, resultShape: 'text' }),
+    screenshot: compute('browser', { privileged: true, resultShape: 'file' }),
+    visual_contact_sheet: compute('browser', { privileged: true, resultShape: 'file' }),
+    browser_visual_verify: compute('browser', { privileged: true, resultShape: 'file' }),
+    ocr: compute('browser', { privileged: true, resultShape: 'text' }),
+    browser_action: execute('browser', { dangerous: false, privileged: true, resultShape: 'browser_snapshot' }),
+    mcp: execute('network', { dangerous: false, requiresNetwork: true, privileged: true, resultShape: 'json' }),
+    node_repl: execute('execution', { privileged: true, dangerous: true, resultShape: 'json' }),
+    // Memory / work notes — memory_read/write split (P0-1c)
+    memory: write('memory', { dangerous: false, privileged: true, resultShape: 'text' }),
+    memory_read: read('memory', { dangerous: false, privileged: true, resultShape: 'text' }),
+    memory_write: write('memory', { dangerous: false, privileged: true, resultShape: 'text' }),
+    write_work_note: read('communication', { resultShape: 'text' }),
+    read_work_notes: read('communication', { resultShape: 'text' }),
+    request_work_note: read('communication', { resultShape: 'text' }),
+    // Team
+    team_manage: write('team', { dangerous: false, resultShape: 'json' }),
+    team_message: read('team', { resultShape: 'json' }),
+    team_inbox: read('team', { resultShape: 'json' }),
+    // Workflow
+    workflow: write('workflow', { dangerous: false, resultShape: 'json' }),
+    // Blackboard
+    blackboard: write('blackboard', { dangerous: false, resultShape: 'json' }),
+    // Office / artifacts（仅保留验收 runtime 工具；generate_*/edit_*/inspect_* 固定 schema 工具已废弃，改走 JS+shell 自由生成）
+    office_ops: write('office', { dangerous: false, resultShape: 'json' }),
+    // Design asset library
+    design_asset: read('session', { core: true, parallelSafe: true, resultShape: 'json' }),
+    // Security scans (consolidated: bughunt_full_scan covers all sub-scanners via skip* params)
+    bughunt_full_scan: compute('security', { requiresNetwork: true, resultShape: 'json' }),
+    // Git
+    git: execute('git', { privileged: true, resultShape: 'text' }),
+    // Leader-only meta tools (not ToolRegistry tools, but governed by same metadata map)
+    // create_task / define_project_blueprint 不再 leaderParallelSafe：二者通过 nextTaskId() 顺序分配 task_id，
+    // 携带 task_id 分配语义。并行 interleave 会让 blocked_by 引用与 peekNextTaskIds 预测错位（同批依赖解析时序竞争），
+    // 且建对象+DB insert 是同步轻量操作并行无收益。退回顺序执行可保证声明顺序==分配顺序==预测顺序。
+    create_task: write('workflow', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    define_project_blueprint: write('workflow', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    update_task: write('workflow', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    delete_task: write('workflow', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    define_agent_role: write('team', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    delete_agent_role: write('team', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    list_available_roles: read('team', { visibility: 'leader' }),
+    dispatch_agent: write('team', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    dispatch_batch: write('team', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    explore: write('team', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    send_message_to_agent: read('communication', { visibility: 'leader', resultShape: 'json' }),
+    update_task_status: write('workflow', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    force_complete_task: write('team', { visibility: 'leader', dangerous: true, resultShape: 'json' }),
+    retry_agent_llm: write('team', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    nudge_agent: read('communication', { visibility: 'leader', resultShape: 'json' }),
+    compact_agent_context: write('team', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    pause_agent: write('team', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    resume_agent: write('team', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    intervene_agent: read('communication', { visibility: 'leader', resultShape: 'json' }),
+    terminate_agent: write('team', { visibility: 'leader', dangerous: true, resultShape: 'json' }),
+    confirm_intervention: read('team', { visibility: 'leader' }),
+    list_runtime_agents: read('team', { visibility: 'leader' }),
+    check_agent_progress: read('team', { visibility: 'leader' }),
+    ask_user: read('communication', { visibility: 'leader', resultShape: 'json' }),
+    submit_plan: read('communication', { visibility: 'leader', resultShape: 'json' }),
+    plan_create: write('session', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    plan_update: write('session', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    plan_checkpoint: write('session', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    plan_finalize: write('session', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    finish_session: write('session', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    complete_eternal_goal: write('session', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    learn_soul: write('memory', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    request_permission_update: write('session', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    create_download_link: read('file', { visibility: 'leader', resultShape: 'json' }),
+    set_bughunt_dag: write('security', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    upsert_bughunt_finding: write('security', { visibility: 'leader', dangerous: false, resultShape: 'json' }),
+    get_bughunt_ledger: read('security', { visibility: 'leader' }),
+    get_ready_dag_nodes: read('security', { visibility: 'leader' }),
+    verify_finding: write('security', { visibility: 'leader', dangerous: true, resultShape: 'json' }),
+});
+export function getToolMetadata(name) {
+    return TOOL_METADATA[name] ?? {};
+}
+export function getToolCapabilityTier(name) {
+    return getToolMetadata(name).tier ?? null;
+}
+export function isParallelSafeTool(name, scope = 'base') {
+    const meta = getToolMetadata(name);
+    return scope === 'leader' ? Boolean(meta.parallelSafe || meta.leaderParallelSafe) : Boolean(meta.parallelSafe);
+}
+export function isWorkspaceModifyingTool(name) {
+    return Boolean(getToolMetadata(name).modifiesWorkspace);
+}
+export function requiresReadFirst(name) {
+    return Boolean(getToolMetadata(name).requiresReadFirst);
+}
+export function isNetworkToolByMetadata(name) {
+    return Boolean(getToolMetadata(name).requiresNetwork);
+}
+export function isPrivilegedToolByMetadata(name) {
+    const meta = getToolMetadata(name);
+    return Boolean(meta.privileged || meta.dangerous || meta.modifiesWorkspace || meta.requiresNetwork);
+}
+export function isAlwaysAllowedToolByMetadata(name) {
+    const meta = getToolMetadata(name);
+    return Boolean(meta.readOnly && !meta.requiresNetwork && !meta.privileged && !meta.dangerous);
+}
+export function metadataSet(predicate) {
+    return new Set(Object.entries(TOOL_METADATA).filter(([name, meta]) => predicate(meta, name)).map(([name]) => name));
+}
+export const BASE_PARALLEL_SAFE_TOOLS = metadataSet((meta) => Boolean(meta.parallelSafe));
+export const LEADER_PARALLEL_SAFE_TOOLS = metadataSet((meta) => Boolean(meta.parallelSafe || meta.leaderParallelSafe));
+export const FILE_MODIFYING_TOOLS = metadataSet((meta) => Boolean(meta.modifiesWorkspace));
+//# sourceMappingURL=ToolMetadata.js.map

package/dist/tools/ToolMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolMetadata.js","sourceRoot":"","sources":["../../src/tools/ToolMetadata.ts"],"names":[],"mappings":"AAuBA,MAAM,IAAI,GAAG,CAAC,QAAsB,EAAE,QAAsB,EAAE,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AAC7J,MAAM,OAAO,GAAG,CAAC,QAAsB,EAAE,QAAsB,EAAE,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AACnK,MAAM,KAAK,GAAG,CAAC,QAAsB,EAAE,QAAsB,EAAE,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AACxK,MAAM,OAAO,GAAG,CAAC,QAAsB,EAAE,QAAsB,EAAE,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AAEpK,MAAM,CAAC,MAAM,aAAa,GAA2C,MAAM,CAAC,MAAM,CAAC;IACjF,yBAAyB;IAEzB,iBAAiB,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IAChG,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACzF,cAAc,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IAC7F,mBAAmB,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IAClG,YAAY,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnD,kBAAkB,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC3E,kBAAkB,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAE9E,uBAAuB;IACvB,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC1G,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACpF,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACvG,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC9G,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC5G,gBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC7F,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACnE,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAEnD,uBAAuB;IACvB,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,qBAAqB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACjI,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACvD,mBAAmB,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/D,gBAAgB,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAEjF,oBAAoB;IACpB,YAAY,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAClG,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACvG,UAAU,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACxG,UAAU,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACzE,oBAAoB,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACnF,qBAAqB,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACpF,GAAG,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAClE,cAAc,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAC3G,GAAG,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC3G,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAE3F,wDAAwD;IACxD,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACpF,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACxF,YAAY,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC1F,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/D,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/D,iBAAiB,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAEjE,OAAO;IACP,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACrE,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACnD,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAEjD,WAAW;IACX,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtE,aAAa;IACb,UAAU,EAAE,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAE1E,oGAAoG;IACpG,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtE,uBAAuB;IACvB,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtF,4FAA4F;IAC5F,iBAAiB,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtF,MAAM;IACN,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAE9D,qFAAqF;IACrF,+FAA+F;IAC/F,oFAAoF;IACpF,yDAAyD;IACzD,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/F,wBAAwB,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC5G,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/F,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/F,iBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACjG,iBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACjG,oBAAoB,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC5D,cAAc,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC9F,cAAc,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC9F,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACvF,qBAAqB,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC3F,kBAAkB,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtG,mBAAmB,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAClG,eAAe,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAE/F,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACjF,qBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACrG,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC3F,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC5F,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACrF,eAAe,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC9F,oBAAoB,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC5D,mBAAmB,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC3D,oBAAoB,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC5D,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC9E,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACjF,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC9F,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC9F,eAAe,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAClG,aAAa,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAChG,cAAc,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACjG,qBAAqB,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACxG,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC5F,yBAAyB,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC5G,oBAAoB,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACjF,eAAe,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACnG,sBAAsB,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC1G,kBAAkB,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC9D,mBAAmB,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/D,cAAc,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;CAClG,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,QAA2B,MAAM;IAChF,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAwD;IAClF,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACtH,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAwB,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;AAC/G,MAAM,CAAC,MAAM,0BAA0B,GAAwB,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAC5I,MAAM,CAAC,MAAM,oBAAoB,GAAwB,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC"}

package/dist/tools/UserToolFactory.d.ts

@@ -0,0 +1,34 @@
+/**
+ * UserToolFactory — 把用户在 settings.json 里声明的 UserToolSpec
+ * 包装成 ToolRegistry 可注册的 ToolContract。
+ *
+ * 三种 kind：
+ *   - http   → 委托 HttpRequestTool（自带内网拦截）
+ *   - shell  → 委托 ShellTool（自带 ExecutionSandbox + permission）
+ *   - python → 委托 PythonExecTool（自带沙盒 + permission）
+ *
+ * 模板渲染：
+ *   - 仅 `{{name}}` 字面替换，无 eval/Function/嵌套
+ *   - 未提供值时使用 parameter.default
+ *   - required 缺失时执行返回结构化错误
+ */
+import { type ToolContract } from '../contracts/types/Tool.js';
+import type { UserToolSpec } from '../config.js';
+import { ShellTool } from './implementations/Shell.js';
+import { HttpRequestTool } from './implementations/HttpRequestTool.js';
+import { PythonExecTool } from './implementations/PythonExecTool.js';
+/** 把 spec.parameters 转成 OpenAI function 兼容的 JSON Schema */
+export declare function userToolToJsonSchema(spec: UserToolSpec): Record<string, unknown>;
+/** 渲染 string 模板：把 {{name}} 替换为 vars[name] 的字面值 */
+export declare function renderStringTemplate(tpl: string, vars: Record<string, unknown>): string;
+export interface UserToolFactoryDeps {
+    http?: HttpRequestTool;
+    shell?: ShellTool;
+    python?: PythonExecTool;
+}
+/**
+ * 把一个 UserToolSpec 包装成可注册的 ToolContract。
+ * deps 用于注入共享底座（默认每次构造工具时各自 lazy 单例）。
+ */
+export declare function buildUserTool(spec: UserToolSpec, deps?: UserToolFactoryDeps): ToolContract;
+//# sourceMappingURL=UserToolFactory.d.ts.map

package/dist/tools/UserToolFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserToolFactory.d.ts","sourceRoot":"","sources":["../../src/tools/UserToolFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACrG,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAIrE,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBhF;AAoCD,kDAAkD;AAClD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAavF;AAsCD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,YAAY,CA2H1F"}

package/dist/tools/UserToolFactory.js

@@ -0,0 +1,249 @@
+/**
+ * UserToolFactory — 把用户在 settings.json 里声明的 UserToolSpec
+ * 包装成 ToolRegistry 可注册的 ToolContract。
+ *
+ * 三种 kind：
+ *   - http   → 委托 HttpRequestTool（自带内网拦截）
+ *   - shell  → 委托 ShellTool（自带 ExecutionSandbox + permission）
+ *   - python → 委托 PythonExecTool（自带沙盒 + permission）
+ *
+ * 模板渲染：
+ *   - 仅 `{{name}}` 字面替换，无 eval/Function/嵌套
+ *   - 未提供值时使用 parameter.default
+ *   - required 缺失时执行返回结构化错误
+ */
+import { normalizeJsonSchemaForOpenAI } from './Tool.js';
+import { normalizeToolResult } from '../contracts/types/Tool.js';
+import { ShellTool } from './implementations/Shell.js';
+import { HttpRequestTool } from './implementations/HttpRequestTool.js';
+import { PythonExecTool } from './implementations/PythonExecTool.js';
+const PLACEHOLDER_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
+/** 把 spec.parameters 转成 OpenAI function 兼容的 JSON Schema */
+export function userToolToJsonSchema(spec) {
+    const properties = {};
+    const required = [];
+    for (const p of spec.parameters) {
+        const prop = { type: p.type };
+        if (p.description)
+            prop.description = p.description;
+        if (p.default !== undefined)
+            prop.default = p.default;
+        properties[p.name] = prop;
+        if (p.required)
+            required.push(p.name);
+    }
+    return {
+        type: 'object',
+        properties,
+        ...(required.length > 0 ? { required } : {}),
+        additionalProperties: false,
+    };
+}
+/** 套用 spec.parameters 的默认值，并校验 required；失败返回 error */
+function resolveArgs(spec, rawArgs) {
+    const args = rawArgs && typeof rawArgs === 'object' && !Array.isArray(rawArgs)
+        ? { ...rawArgs }
+        : {};
+    const merged = {};
+    const missing = [];
+    for (const p of spec.parameters) {
+        if (p.name in args && args[p.name] !== undefined && args[p.name] !== null) {
+            merged[p.name] = args[p.name];
+        }
+        else if (p.default !== undefined) {
+            merged[p.name] = p.default;
+        }
+        else if (p.required) {
+            missing.push(p.name);
+        }
+    }
+    // 用户传入 spec 没声明的额外字段也保留（便于 LLM 补充）
+    for (const [k, v] of Object.entries(args)) {
+        if (!(k in merged))
+            merged[k] = v;
+    }
+    if (missing.length > 0) {
+        return { ok: false, error: `缺少必填参数：${missing.join(', ')}` };
+    }
+    return { ok: true, values: merged };
+}
+/** 渲染 string 模板：把 {{name}} 替换为 vars[name] 的字面值 */
+export function renderStringTemplate(tpl, vars) {
+    return tpl.replace(PLACEHOLDER_RE, (match, key) => {
+        if (!(key in vars))
+            return match; // 保留未知占位符，便于排错
+        const value = vars[key];
+        if (value === null || value === undefined)
+            return '';
+        if (typeof value === 'string')
+            return value;
+        if (typeof value === 'number' || typeof value === 'boolean')
+            return String(value);
+        try {
+            return JSON.stringify(value);
+        }
+        catch { /* expected: fallback to default */
+            return String(value);
+        }
+    });
+}
+/** 递归渲染 JSON 模板：仅对字符串叶子做 {{name}} 替换；纯字符串模板（"{{x}}"）解出原始类型 */
+function renderJsonTemplate(value, vars) {
+    if (typeof value === 'string') {
+        // 整体匹配单一占位符 → 返回原始类型，不强制转字符串
+        const whole = /^\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}$/.exec(value);
+        if (whole) {
+            const key = whole[1];
+            return key in vars ? vars[key] : value;
+        }
+        return renderStringTemplate(value, vars);
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => renderJsonTemplate(v, vars));
+    }
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = renderJsonTemplate(v, vars);
+        }
+        return out;
+    }
+    return value;
+}
+function renderHeaders(headers, vars) {
+    if (!headers)
+        return undefined;
+    const out = {};
+    for (const [k, v] of Object.entries(headers)) {
+        out[k] = renderStringTemplate(v, vars);
+    }
+    return out;
+}
+/**
+ * 把一个 UserToolSpec 包装成可注册的 ToolContract。
+ * deps 用于注入共享底座（默认每次构造工具时各自 lazy 单例）。
+ */
+export function buildUserTool(spec, deps) {
+    const schemaSpec = spec;
+    const schema = normalizeJsonSchemaForOpenAI((schemaSpec.input_schema ?? schemaSpec.schema ?? userToolToJsonSchema(spec)));
+    let httpDelegate = deps?.http ?? null;
+    let shellDelegate = deps?.shell ?? null;
+    let pythonDelegate = deps?.python ?? null;
+    return {
+        name: spec.name,
+        description: spec.description ?? '',
+        scope: 'worker',
+        getSchema: () => schema,
+        getExecutionTimeoutMs(rawArgs) {
+            switch (spec.kind) {
+                case 'shell': {
+                    if (!spec.shell)
+                        return undefined;
+                    shellDelegate ??= new ShellTool();
+                    const resolved = resolveArgs(spec, rawArgs);
+                    const vars = resolved.ok ? resolved.values : {};
+                    const shellArgs = {
+                        command: renderStringTemplate(spec.shell.command, vars),
+                        is_background: false,
+                    };
+                    if (spec.shell.cwd) {
+                        shellArgs.cwd = renderStringTemplate(spec.shell.cwd, vars);
+                    }
+                    if (typeof spec.shell.timeout_ms === 'number') {
+                        shellArgs.timeout = Math.max(1, Math.ceil(spec.shell.timeout_ms / 1000));
+                    }
+                    return shellDelegate.getExecutionTimeoutMs?.(shellArgs);
+                }
+                case 'http': {
+                    return typeof spec.http?.timeout_ms === 'number'
+                        ? Math.max(1_000, spec.http.timeout_ms + 5_000)
+                        : undefined;
+                }
+                case 'python': {
+                    return typeof spec.python?.timeout_ms === 'number'
+                        ? Math.max(1_000, spec.python.timeout_ms + 5_000)
+                        : undefined;
+                }
+                default:
+                    return undefined;
+            }
+        },
+        async execute(rawArgs, context) {
+            const resolved = resolveArgs(spec, rawArgs);
+            if (!resolved.ok) {
+                return { success: false, data: null, error: resolved.error };
+            }
+            const vars = resolved.values;
+            try {
+                switch (spec.kind) {
+                    case 'http': {
+                        if (!spec.http) {
+                            return { success: false, data: null, error: 'http 工具缺少 http 配置' };
+                        }
+                        httpDelegate ??= new HttpRequestTool();
+                        const httpArgs = {
+                            method: spec.http.method,
+                            url: renderStringTemplate(spec.http.url, vars),
+                        };
+                        if (spec.http.headers) {
+                            httpArgs.headers = renderHeaders(spec.http.headers, vars);
+                        }
+                        if (spec.http.body_template) {
+                            httpArgs.body = renderStringTemplate(spec.http.body_template, vars);
+                        }
+                        if (spec.http.json_template) {
+                            httpArgs.body = renderJsonTemplate(spec.http.json_template, vars);
+                        }
+                        if (typeof spec.http.timeout_ms === 'number') {
+                            httpArgs.timeout = Math.max(1, Math.ceil(spec.http.timeout_ms / 1000));
+                        }
+                        return normalizeToolResult(await httpDelegate.execute(httpArgs, context));
+                    }
+                    case 'shell': {
+                        if (!spec.shell) {
+                            return { success: false, data: null, error: 'shell 工具缺少 shell 配置' };
+                        }
+                        shellDelegate ??= new ShellTool();
+                        const shellArgs = {
+                            command: renderStringTemplate(spec.shell.command, vars),
+                            is_background: false,
+                        };
+                        if (spec.shell.cwd) {
+                            shellArgs.cwd = renderStringTemplate(spec.shell.cwd, vars);
+                        }
+                        if (typeof spec.shell.timeout_ms === 'number') {
+                            shellArgs.timeout = Math.max(1, Math.ceil(spec.shell.timeout_ms / 1000));
+                        }
+                        return normalizeToolResult(await shellDelegate.execute(shellArgs, context));
+                    }
+                    case 'python': {
+                        if (!spec.python) {
+                            return { success: false, data: null, error: 'python 工具缺少 python 配置' };
+                        }
+                        pythonDelegate ??= new PythonExecTool();
+                        const pythonArgs = {
+                            code: renderStringTemplate(spec.python.code, vars),
+                        };
+                        if (typeof spec.python.timeout_ms === 'number') {
+                            pythonArgs.timeout = Math.max(1, Math.ceil(spec.python.timeout_ms / 1000));
+                        }
+                        return normalizeToolResult(await pythonDelegate.execute(pythonArgs, context));
+                    }
+                    default: {
+                        // 类型穷举保护
+                        const _exhaustive = spec.kind;
+                        return { success: false, data: null, error: `未知工具 kind: ${String(_exhaustive)}` };
+                    }
+                }
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    data: null,
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=UserToolFactory.js.map

package/dist/tools/UserToolFactory.js.map

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

package/dist/tools/implementations/AddEdgeTool.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class AddEdgeTool extends Tool {
+    readonly name = "add_edge";
+    readonly description = "\u5728\u77E5\u8BC6\u56FE\u8C31\u7684\u4E24\u4E2A\u8282\u70B9\u4E4B\u95F4\u6DFB\u52A0\u5173\u7CFB\u8FB9\u3002";
+    readonly parameters: z.ZodObject<{
+        from_node_id: z.ZodString;
+        to_node_id: z.ZodString;
+        edge_type: z.ZodEnum<{
+            depends_on: "depends_on";
+            supports: "supports";
+            contradicts: "contradicts";
+            refines: "refines";
+            supersedes: "supersedes";
+            produces: "produces";
+            consumes: "consumes";
+        }>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=AddEdgeTool.d.ts.map

package/dist/tools/implementations/AddEdgeTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddEdgeTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/AddEdgeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAUrE,qBAAa,WAAY,SAAQ,IAAI;IACnC,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,kHAAwB;IAC5C,QAAQ,CAAC,UAAU;;;;;;;;;;;;;sBAAiB;IAE9B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAgCzE"}

package/dist/tools/implementations/AddEdgeTool.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+const AddEdgeSchema = z.object({
+    from_node_id: z.string().describe('源节点 ID'),
+    to_node_id: z.string().describe('目标节点 ID'),
+    edge_type: z.enum(['depends_on', 'supports', 'contradicts', 'refines', 'supersedes', 'produces', 'consumes']).describe('边类型'),
+    metadata: z.record(z.string(), z.string()).optional().describe('附加元数据'),
+});
+export class AddEdgeTool extends Tool {
+    name = 'add_edge';
+    description = '在知识图谱的两个节点之间添加关系边。';
+    parameters = AddEdgeSchema;
+    async execute(args, context) {
+        const params = args;
+        const graph = context?.blackboardGraph;
+        const sessionId = context?.sessionId;
+        if (!graph || !sessionId) {
+            return { success: false, data: null, error: '黑板图未初始化或 sessionId 缺失' };
+        }
+        try {
+            const edge = graph.addEdge({
+                sessionId,
+                fromNodeId: params.from_node_id,
+                toNodeId: params.to_node_id,
+                edgeType: params.edge_type,
+                createdBy: context.taskId ?? context.agentId ?? 'unknown',
+                metadata: params.metadata,
+            });
+            if (edge.id.startsWith('invalid-')) {
+                return { success: false, data: null, error: '添加边失败：源节点或目标节点不存在' };
+            }
+            return {
+                success: true,
+                data: `Edge ${edge.id} 已添加: ${params.from_node_id} --[${params.edge_type}]--> ${params.to_node_id}`,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, data: null, error: `添加边失败: ${msg}` };
+        }
+    }
+}
+//# sourceMappingURL=AddEdgeTool.js.map

package/dist/tools/implementations/AddEdgeTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddEdgeTool.js","sourceRoot":"","sources":["../../../src/tools/implementations/AddEdgeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAqC,MAAM,YAAY,CAAC;AAGrE,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7H,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;CACxE,CAAC,CAAC;AAEH,MAAM,OAAO,WAAY,SAAQ,IAAI;IAC1B,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,oBAAoB,CAAC;IACnC,UAAU,GAAG,aAAa,CAAC;IAEpC,KAAK,CAAC,OAAO,CAAC,IAAa,EAAE,OAAqB;QAChD,MAAM,MAAM,GAAG,IAAqC,CAAC;QACrD,MAAM,KAAK,GAAG,OAAO,EAAE,eAAe,CAAC;QACvC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;QAErC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QACxE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;gBACzB,SAAS;gBACT,UAAU,EAAE,MAAM,CAAC,YAAY;gBAC/B,QAAQ,EAAE,MAAM,CAAC,UAAU;gBAC3B,QAAQ,EAAE,MAAM,CAAC,SAAqB;gBACtC,SAAS,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,SAAS;gBACzD,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;YACpE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,QAAQ,IAAI,CAAC,EAAE,SAAS,MAAM,CAAC,YAAY,OAAO,MAAM,CAAC,SAAS,QAAQ,MAAM,CAAC,UAAU,EAAE;aACpG,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;CACF"}

package/dist/tools/implementations/AstQueryTool.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class AstQueryTool extends Tool {
+    readonly name = "ast_query";
+    readonly description = "\u7528 TypeScript AST \u67E5\u8BE2\u4EE3\u7801\u7ED3\u6784\uFF1Adefinitions\u3001references\u3001public_api\u3001pattern\u3001call_graph\u3001implementors\u3002\u7528\u4E8E\u8BC1\u660E\u4EE3\u7801\u5173\u7CFB\uFF0C\u4E0D\u7528\u81EA\u7136\u8BED\u8A00\u731C\u6D4B\u3002";
+    readonly parameters: z.ZodObject<{
+        action: z.ZodEnum<{
+            pattern: "pattern";
+            definitions: "definitions";
+            references: "references";
+            public_api: "public_api";
+            call_graph: "call_graph";
+            implementors: "implementors";
+        }>;
+        symbol: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        name_pattern: z.ZodOptional<z.ZodString>;
+        kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            function: "function";
+            unknown: "unknown";
+            type: "type";
+            enum: "enum";
+            method: "method";
+            constructor: "constructor";
+            property: "property";
+            class: "class";
+            interface: "interface";
+            variable: "variable";
+            parameter: "parameter";
+        }>>>;
+        max_depth: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    getSchema(): Record<string, unknown>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+    private missingSymbol;
+}
+export default AstQueryTool;
+//# sourceMappingURL=AstQueryTool.d.ts.map

package/dist/tools/implementations/AstQueryTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AstQueryTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/AstQueryTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAmB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AA4CtF,qBAAa,YAAa,SAAQ,IAAI;IACpC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,kRAAkH;IACtI,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAAkB;IAE5B,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIvC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAqFxE,OAAO,CAAC,aAAa;CAStB;AAED,eAAe,YAAY,CAAC"}