@dommaker/harness 0.8.3 → 0.10.0

package/dist/tools/definitions/std/verification/wait-condition.yml

@@ -0,0 +1,107 @@
+# wait-condition.yml - 条件等待
+# ============================================================================
+# 能力类型: verification（工具型）
+# 来源: Superpowers - condition-based-waiting (Technique)
+# 版本: 2026-03-28 (需手动同步)
+# 执行方式: 纯脚本，轮询检查条件
+# 用途: 等待某个条件满足后再继续执行
+# ============================================================================
+
+name: wait-condition
+stage: verify
+description: 等待条件满足后再继续执行，支持轮询检查
+
+input:
+  condition:
+    type: string
+    required: true
+    description: "等待的条件（如 file exists: /path/to/file）"
+    
+  check_command:
+    type: string
+    required: true
+    description: "检查命令（返回 0 表示条件满足）"
+    
+  timeout_seconds:
+    type: number
+    required: false
+    description: 超时时间（秒）
+    default: 300
+    
+  interval_seconds:
+    type: number
+    required: false
+    description: 检查间隔（秒）
+    default: 5
+    
+  repo_path:
+    type: path
+    required: false
+    description: 项目路径（可选）
+    default: "."
+
+output:
+  satisfied:
+    type: boolean
+    description: 条件是否满足
+    
+  elapsed_seconds:
+    type: number
+    description: 已等待时间（秒）
+    
+  check_count:
+    type: number
+    description: 检查次数
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  CONDITION="{{condition}}"
+  CHECK_CMD="{{check_command}}"
+  TIMEOUT="{{timeout_seconds}}"
+  INTERVAL="{{interval_seconds}}"
+  REPO_PATH="{{repo_path}}"
+  
+  cd "$REPO_PATH" 2>/dev/null || true
+  
+  echo "⏳ 等待条件满足"
+  echo "  条件: $CONDITION"
+  echo "  检查命令: $CHECK_CMD"
+  echo "  超时: ${TIMEOUT}s"
+  echo "  间隔: ${INTERVAL}s"
+  echo ""
+  
+  ELAPSED=0
+  CHECK_COUNT=0
+  
+  while [ $ELAPSED -lt $TIMEOUT ]; do
+    CHECK_COUNT=$((CHECK_COUNT + 1))
+    
+    echo "[$CHECK_COUNT] 检查条件... (已等待 ${ELAPSED}s)"
+    
+    if eval "$CHECK_CMD" >/dev/null 2>&1; then
+      echo ""
+      echo "✅ 条件满足！"
+      echo "  已等待: ${ELAPSED}s"
+      echo "  检查次数: $CHECK_COUNT"
+      echo ""
+      echo "SATISFIED=true"
+      echo "ELAPSED=$ELAPSED"
+      echo "CHECK_COUNT=$CHECK_COUNT"
+      exit 0
+    fi
+    
+    sleep $INTERVAL
+    ELAPSED=$((ELAPSED + INTERVAL))
+  done
+  
+  echo ""
+  echo "❌ 条件未满足，已超时"
+  echo "  已等待: ${ELAPSED}s"
+  echo "  检查次数: $CHECK_COUNT"
+  echo ""
+  echo "SATISFIED=false"
+  echo "ELAPSED=$ELAPSED"
+  echo "CHECK_COUNT=$CHECK_COUNT"
+  exit 1

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './registry';
+export * from './core';
+export * from './loader';
+export * from './paths';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./registry"), exports);
+__exportStar(require("./core"), exports);
+__exportStar(require("./loader"), exports);
+__exportStar(require("./paths"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AACzB,0CAAwB"}

package/dist/tools/loader.d.ts

@@ -0,0 +1,21 @@
+import { ToolDefinition } from './types';
+/**
+ * Parse a single YAML file into a ToolDefinition.
+ */
+export declare function parseToolYaml(yamlContent: string, filePath: string, definitionsDir: string): ToolDefinition;
+/**
+ * Load all tool definitions from the definitions directory (core/, std/, ext/).
+ */
+export declare function loadToolsFromDir(definitionsDir: string): ToolDefinition[];
+/**
+ * Load the registry.json and fix absolute paths to relative (from definitions dir).
+ * Filters out workflow entries, keeping only tool entries.
+ */
+export declare function loadRegistry(registryPath: string): Array<{
+    name: string;
+    category: string;
+    type: string;
+    description: string;
+    path: string;
+}>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/tools/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAgB,MAAM,SAAS,CAAC;AAwHvD;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,CAmB3G;AAqBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,EAAE,CAoBzE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAcD"}

package/dist/tools/loader.js

@@ -0,0 +1,199 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseToolYaml = parseToolYaml;
+exports.loadToolsFromDir = loadToolsFromDir;
+exports.loadRegistry = loadRegistry;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+// Maps the type strings found in tool YAMLs to JSON Schema types
+const TYPE_MAP = {
+    string: 'string',
+    path: 'string',
+    integer: 'integer',
+    number: 'number',
+    boolean: 'boolean',
+    array: 'array',
+    object: 'object',
+};
+function buildJsonSchema(params) {
+    const properties = {};
+    const required = [];
+    for (const [key, def] of Object.entries(params)) {
+        const prop = {};
+        const schemaType = TYPE_MAP[def.type ?? 'string'] ?? 'string';
+        prop.type = schemaType;
+        if (def.description)
+            prop.description = def.description;
+        if (def.default !== undefined)
+            prop.default = def.default;
+        if (def.items)
+            prop.items = def.items;
+        if (def.enum)
+            prop.enum = def.enum;
+        properties[key] = prop;
+        if (def.required)
+            required.push(key);
+    }
+    const schema = {
+        type: 'object',
+        properties,
+    };
+    if (required.length > 0)
+        schema.required = required;
+    return schema;
+}
+function normalizeInputs(raw) {
+    // Pattern A: `input` is a map (core/ext tools)
+    if (raw.input && typeof raw.input === 'object' && !Array.isArray(raw.input)) {
+        return raw.input;
+    }
+    // Pattern B: `inputs` is a list (some std tools)
+    if (Array.isArray(raw.inputs)) {
+        const result = {};
+        for (const item of raw.inputs) {
+            if (item.name) {
+                result[item.name] = {
+                    type: item.type,
+                    required: item.required,
+                    description: item.description,
+                    default: item.default,
+                };
+            }
+        }
+        return result;
+    }
+    // Pattern C: `inputs` is a map (some std tools)
+    if (raw.inputs && typeof raw.inputs === 'object' && !Array.isArray(raw.inputs)) {
+        return raw.inputs;
+    }
+    return {};
+}
+function deriveToolId(filePath, definitionsDir) {
+    // Convert file path to ID: definitions/std/quick/implement.yml → std/quick/implement
+    const relative = path.relative(definitionsDir, filePath);
+    const withoutExt = relative.replace(/\.yml$/, '').replace(/\.yaml$/, '');
+    return withoutExt;
+}
+function detectCategory(filePath, definitionsDir) {
+    const relative = path.relative(definitionsDir, filePath);
+    const topDir = relative.split(path.sep)[0];
+    if (topDir === 'core')
+        return 'core';
+    if (topDir === 'ext')
+        return 'ext';
+    return 'std';
+}
+/**
+ * Parse a single YAML file into a ToolDefinition.
+ */
+function parseToolYaml(yamlContent, filePath, definitionsDir) {
+    const raw = yaml.load(yamlContent);
+    const id = raw.id || deriveToolId(filePath, definitionsDir);
+    const name = raw.name || id;
+    const description = raw.description || '';
+    const category = detectCategory(filePath, definitionsDir);
+    const params = normalizeInputs(raw);
+    const parameters = buildJsonSchema(params);
+    const def = {
+        id,
+        name,
+        description,
+        category,
+        parameters,
+    };
+    return def;
+}
+/**
+ * Scan a directory recursively for .yml/.yaml files and return all file paths.
+ */
+function findYamlFiles(dir) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...findYamlFiles(fullPath));
+        }
+        else if (entry.isFile() && (entry.name.endsWith('.yml') || entry.name.endsWith('.yaml'))) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+/**
+ * Load all tool definitions from the definitions directory (core/, std/, ext/).
+ */
+function loadToolsFromDir(definitionsDir) {
+    const tools = [];
+    for (const category of ['core', 'std', 'ext']) {
+        const categoryDir = path.join(definitionsDir, category);
+        const yamlFiles = findYamlFiles(categoryDir);
+        for (const filePath of yamlFiles) {
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const tool = parseToolYaml(content, filePath, definitionsDir);
+                tools.push(tool);
+            }
+            catch (err) {
+                // Skip files that fail to parse
+                console.warn(`[harness] Failed to load tool YAML: ${filePath}`, err);
+            }
+        }
+    }
+    return tools;
+}
+/**
+ * Load the registry.json and fix absolute paths to relative (from definitions dir).
+ * Filters out workflow entries, keeping only tool entries.
+ */
+function loadRegistry(registryPath) {
+    const content = fs.readFileSync(registryPath, 'utf-8');
+    const registry = JSON.parse(content);
+    const definitionsDir = path.dirname(registryPath);
+    if (!Array.isArray(registry.tools))
+        return [];
+    return registry.tools
+        .filter((entry) => entry.type === 'tool')
+        .map((entry) => ({
+        ...entry,
+        // Fix absolute paths to relative (from definitions dir); keep already-relative paths as-is
+        path: path.isAbsolute(entry.path) ? path.relative(definitionsDir, entry.path) : entry.path,
+    }));
+}
+//# sourceMappingURL=loader.js.map

package/dist/tools/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/tools/loader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8HA,sCAmBC;AAwBD,4CAoBC;AAMD,oCAoBC;AAvND,uCAAyB;AACzB,2CAA6B;AAC7B,8CAAgC;AAGhC,iEAAiE;AACjE,MAAM,QAAQ,GAA2B;IACvC,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACjB,CAAC;AAwCF,SAAS,eAAe,CAAC,MAAyI;IAChK,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,QAAQ,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,GAAG,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;QACxD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC1D,IAAI,GAAG,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACtC,IAAI,GAAG,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACnC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACvB,IAAI,GAAG,CAAC,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,MAAM,GAA4B;QACtC,IAAI,EAAE,QAAQ;QACd,UAAU;KACX,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,GAAgB;IACvC,+CAA+C;IAC/C,IAAI,GAAG,CAAC,KAAK,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5E,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,iDAAiD;IACjD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAmG,EAAE,CAAC;QAClH,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBAClB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gDAAgD;IAChD,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/E,OAAO,GAAG,CAAC,MAAwG,CAAC;IACtH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,cAAsB;IAC5D,qFAAqF;IACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACzE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,cAAsB;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACrC,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,WAAmB,EAAE,QAAgB,EAAE,cAAsB;IACzF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAgB,CAAC;IAElD,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAE3C,MAAM,GAAG,GAAmB;QAC1B,EAAE;QACF,IAAI;QACJ,WAAW;QACX,QAAQ;QACR,UAAU;KACX,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAExC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC3F,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,cAAsB;IACrD,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,KAAK,MAAM,QAAQ,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAmB,EAAE,CAAC;QAChE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAE7C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,gCAAgC;gBAChC,OAAO,CAAC,IAAI,CAAC,uCAAuC,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,YAAoB;IAO/C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAElD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE9C,OAAO,QAAQ,CAAC,KAAK;SAClB,MAAM,CAAC,CAAC,KAAwB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SAC3D,GAAG,CAAC,CAAC,KAA0F,EAAE,EAAE,CAAC,CAAC;QACpG,GAAG,KAAK;QACR,2FAA2F;QAC3F,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI;KAC3F,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/tools/paths.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns the absolute path to the bundled tool definitions directory.
+ */
+export declare function getToolsDir(): string;
+/**
+ * Returns the absolute path to the tool registry.json.
+ */
+export declare function getRegistryPath(): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/tools/paths.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/tools/paths.js

@@ -0,0 +1,51 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getToolsDir = getToolsDir;
+exports.getRegistryPath = getRegistryPath;
+const path = __importStar(require("path"));
+/**
+ * Returns the absolute path to the bundled tool definitions directory.
+ */
+function getToolsDir() {
+    return path.join(__dirname, 'definitions');
+}
+/**
+ * Returns the absolute path to the tool registry.json.
+ */
+function getRegistryPath() {
+    return path.join(__dirname, 'definitions', 'registry.json');
+}
+//# sourceMappingURL=paths.js.map

package/dist/tools/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/tools/paths.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,kCAEC;AAKD,0CAEC;AAdD,2CAA6B;AAE7B;;GAEG;AACH,SAAgB,WAAW;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;AAC9D,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 工具注册表
+ *
+ * 工具注册/发现/执行
+ */
+import type { ToolDefinition, ToolCategory, ToolResult } from './types';
+export declare class ToolRegistry {
+    private tools;
+    constructor();
+    /**
+     * 注册工具
+     */
+    register(tool: ToolDefinition): void;
+    /**
+     * 批量注册
+     */
+    registerAll(tools: ToolDefinition[]): void;
+    /**
+     * 获取工具
+     */
+    get(id: string): ToolDefinition | undefined;
+    /**
+     * 获取所有工具
+     */
+    getAll(): ToolDefinition[];
+    /**
+     * 按分类获取
+     */
+    getByCategory(category: ToolCategory): ToolDefinition[];
+    /**
+     * 搜索工具（名称/描述模糊匹配）
+     */
+    search(query: string): ToolDefinition[];
+    /**
+     * 执行工具
+     */
+    execute(id: string, params: Record<string, unknown>): Promise<ToolResult>;
+    /**
+     * 移除工具
+     */
+    remove(id: string): boolean;
+    /**
+     * 工具数量
+     */
+    size(): number;
+    /**
+     * 检查工具是否存在
+     */
+    has(id: string): boolean;
+    /**
+     * 导出为 tool definitions（用于 LLM function calling）
+     */
+    toToolDefinitions(): Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAe,UAAU,EAAE,MAAM,SAAS,CAAC;AAErF,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA8B;;IAM3C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAIpC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAM1C;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,EAAE;IAIvD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IASvC;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IA6B/E;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,iBAAiB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAOvG"}

package/dist/tools/registry.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * 工具注册表
+ *
+ * 工具注册/发现/执行
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+class ToolRegistry {
+    tools;
+    constructor() {
+        this.tools = new Map();
+    }
+    /**
+     * 注册工具
+     */
+    register(tool) {
+        this.tools.set(tool.id, tool);
+    }
+    /**
+     * 批量注册
+     */
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+    }
+    /**
+     * 获取工具
+     */
+    get(id) {
+        return this.tools.get(id);
+    }
+    /**
+     * 获取所有工具
+     */
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * 按分类获取
+     */
+    getByCategory(category) {
+        return this.getAll().filter(t => t.category === category);
+    }
+    /**
+     * 搜索工具（名称/描述模糊匹配）
+     */
+    search(query) {
+        const lower = query.toLowerCase();
+        return this.getAll().filter(t => t.name.toLowerCase().includes(lower) ||
+            t.description.toLowerCase().includes(lower) ||
+            t.id.toLowerCase().includes(lower));
+    }
+    /**
+     * 执行工具
+     */
+    async execute(id, params) {
+        const tool = this.tools.get(id);
+        if (!tool) {
+            return {
+                success: false,
+                output: '',
+                error: `工具未找到: ${id}`,
+            };
+        }
+        if (!tool.handler) {
+            return {
+                success: false,
+                output: '',
+                error: `工具 ${id} 未注册处理函数`,
+            };
+        }
+        try {
+            return await tool.handler(params);
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: `工具执行失败: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    /**
+     * 移除工具
+     */
+    remove(id) {
+        return this.tools.delete(id);
+    }
+    /**
+     * 工具数量
+     */
+    size() {
+        return this.tools.size;
+    }
+    /**
+     * 检查工具是否存在
+     */
+    has(id) {
+        return this.tools.has(id);
+    }
+    /**
+     * 导出为 tool definitions（用于 LLM function calling）
+     */
+    toToolDefinitions() {
+        return this.getAll().map(t => ({
+            name: t.id,
+            description: t.description,
+            parameters: t.parameters,
+        }));
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 工具注册表类型定义
+ */
+export type ToolCategory = 'core' | 'std' | 'ext';
+export interface ToolDefinition {
+    /** 工具唯一 ID */
+    id: string;
+    /** 工具名称 */
+    name: string;
+    /** 工具描述 */
+    description: string;
+    /** 工具分类 */
+    category: ToolCategory;
+    /** 参数 schema (JSON Schema) */
+    parameters: Record<string, unknown>;
+    /** 所需 sandbox 级别 */
+    sandboxLevel?: 1 | 2 | 3 | 4;
+    /** 是否需要确认 */
+    requiresConfirmation?: boolean;
+    /** 速率限制（每分钟） */
+    rateLimit?: number;
+    /** 工具处理函数 */
+    handler?: ToolHandler;
+}
+export type ToolHandler = (params: Record<string, unknown>) => Promise<ToolResult>;
+export interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ToolRegistryConfig {
+    /** 自动注册核心工具 */
+    autoRegisterCore?: boolean;
+    /** 工具搜索路径 */
+    searchPaths?: string[];
+}
+//# sourceMappingURL=types.d.ts.map