@easynet/agent-tool 1.0.0 → 1.0.2

package/dist/api/main.js

@@ -0,0 +1,7 @@
+export { createAgentTools, createLangChainToolsAsync } from '../chunk-TBMWJWQ2.js';
+export { createHttpService, createMCPServer, createMCPServerStreamableHttp, createMCPStreamableHttpHandler, createHttpService as createOpenAPIServer, runMCPServerOverStdio } from '../chunk-QVH6IQKQ.js';
+export { PTCRuntime, createRuntimeFromConfig, createRuntimeFromConfigSync } from '../chunk-Q7KPGWC6.js';
+import '../chunk-AE6FSNGY.js';
+import '../chunk-FR2CXERF.js';
+//# sourceMappingURL=main.js.map
+//# sourceMappingURL=main.js.map

package/dist/api/main.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"main.js"}

package/dist/api/runtimeFromConfig.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Create PTCRuntime + ToolRegistry from config (sync or async).
+ * Registers core/example adapters only when coreTools/exampleTools options are provided.
+ * Use when you need a single runtime for MCP, OpenAPI, and/or LangChain tools.
+ */
+import { ToolRegistry } from "../core/registry/ToolRegistry.js";
+import { PTCRuntime } from "../core/runtime/PTCRuntime.js";
+import type { CoreToolsUserConfig } from "@easynet/agent-tool-builtin-tools";
+import type { ExampleToolsUserConfig } from "@easynet/agent-tool-example-tools";
+export interface CreateRuntimeOptions {
+    /** Path to tool.yaml (optional; used by createAgentTools to filter tool list) */
+    configFilePath?: string;
+    /** Project path for async tool loading (optional; reserved for future use) */
+    projectPath?: string;
+    /** Sandbox / core tools config; when set, core adapter is registered */
+    coreTools?: CoreToolsUserConfig;
+    /** Example tools config; when set, example adapter is registered */
+    exampleTools?: ExampleToolsUserConfig;
+}
+export interface CreateRuntimeResult {
+    runtime: PTCRuntime;
+    registry: ToolRegistry;
+}
+/**
+ * Create runtime and registry synchronously. Registers core/example adapters
+ * only when coreTools/exampleTools are provided (opt-in).
+ */
+export declare function createRuntimeFromConfigSync(options?: CreateRuntimeOptions): CreateRuntimeResult;
+/**
+ * Create runtime and registry asynchronously. When projectPath is set, can load
+ * tools from project (e.g. MCP, skills); for now behaves like sync.
+ */
+export declare function createRuntimeFromConfig(options?: CreateRuntimeOptions): Promise<CreateRuntimeResult>;
+//# sourceMappingURL=runtimeFromConfig.d.ts.map

package/dist/api/runtimeFromConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeFromConfig.d.ts","sourceRoot":"","sources":["../../src/api/runtimeFromConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,oEAAoE;IACpE,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CAuBnG;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

package/dist/canonicalCoreSchemas-CTW6CCFY.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var chunk6F5JHLZ7_cjs = require('./chunk-6F5JHLZ7.cjs');
+
+
+
+Object.defineProperty(exports, "CORE_TOOL_SCHEMAS", {
+  enumerable: true,
+  get: function () { return chunk6F5JHLZ7_cjs.CORE_TOOL_SCHEMAS; }
+});
+Object.defineProperty(exports, "enrichSpecWithCanonicalSchema", {
+  enumerable: true,
+  get: function () { return chunk6F5JHLZ7_cjs.enrichSpecWithCanonicalSchema; }
+});
+Object.defineProperty(exports, "isGenericSchema", {
+  enumerable: true,
+  get: function () { return chunk6F5JHLZ7_cjs.isGenericSchema; }
+});
+//# sourceMappingURL=canonicalCoreSchemas-CTW6CCFY.cjs.map
+//# sourceMappingURL=canonicalCoreSchemas-CTW6CCFY.cjs.map

package/dist/canonicalCoreSchemas-CTW6CCFY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"canonicalCoreSchemas-CTW6CCFY.cjs"}

package/dist/canonicalCoreSchemas-YLHVHYJZ.js

@@ -0,0 +1,3 @@
+export { CORE_TOOL_SCHEMAS, enrichSpecWithCanonicalSchema, isGenericSchema } from './chunk-FR2CXERF.js';
+//# sourceMappingURL=canonicalCoreSchemas-YLHVHYJZ.js.map
+//# sourceMappingURL=canonicalCoreSchemas-YLHVHYJZ.js.map

package/dist/canonicalCoreSchemas-YLHVHYJZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"canonicalCoreSchemas-YLHVHYJZ.js"}

package/dist/{chunk-AXUNV4MK.js → chunk-5SWSNVMI.js}

@@ -1,4 +1,4 @@
-// src/types/ToolSpec.ts
+// src/core/types/ToolSpec.ts
 var DEFAULT_INPUT_SCHEMA = {
   type: "object",
   additionalProperties: true
@@ -24,5 +24,5 @@ function createToolSpec(opts) {
 }
 
 export { DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, createToolSpec };
-//# sourceMappingURL=chunk-AXUNV4MK.js.map
-//# sourceMappingURL=chunk-AXUNV4MK.js.map
+//# sourceMappingURL=chunk-5SWSNVMI.js.map
+//# sourceMappingURL=chunk-5SWSNVMI.js.map

package/dist/chunk-5SWSNVMI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/types/ToolSpec.ts"],"names":[],"mappings":";AAmFO,IAAM,oBAAA,GAA+B;AAAA,EAC1C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AAGO,IAAM,qBAAA,GAAgC;AAAA,EAC3C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AA2BO,SAAS,eAAe,IAAA,EAAuC;AACpE,EAAA,MAAM,UAAA,GAAa,KAAK,UAAA,IAAc,MAAA;AACtC,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,OAAA,EAAS,KAAK,OAAA,IAAW,OAAA;AAAA,IACzB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,aAAa,IAAA,CAAK,WAAA;AAAA,IAClB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,WAAA,EAAa,KAAK,WAAA,IAAe,oBAAA;AAAA,IACjC,YAAA,EAAc,KAAK,YAAA,IAAgB,qBAAA;AAAA,IACnC,cAAc,IAAA,CAAK,YAAA;AAAA,IACnB,WAAW,IAAA,CAAK,SAAA;AAAA,IAChB,KAAA,EAAO,EAAE,IAAA,EAAM,EAAE,YAAW;AAAE,GAChC;AACF","file":"chunk-5SWSNVMI.js","sourcesContent":["/**\n * Unified tool kinds supported by the tools package.\n */\nexport type ToolKind = \"mcp\" | \"langchain\" | \"n8n\" | \"comfyui\" | \"skill\" | \"function\" | \"core\" | \"example\";\n\n/**\n * Capability declarations for tools.\n * Used by PolicyEngine for permission gating.\n */\nexport type Capability =\n  | \"read:web\"\n  | \"read:fs\"\n  | \"write:fs\"\n  | \"read:db\"\n  | \"write:db\"\n  | \"network\"\n  | \"gpu\"\n  | \"workflow\"\n  | \"danger:destructive\"\n  | \"exec\";\n\n/**\n * HITL (Human-in-the-Loop) side-effect classification.\n * Used to gate execution: external_write / destructive require human approval when onApprovalRequired is set.\n */\nexport type HitlSideEffect = \"none\" | \"local_write\" | \"external_write\" | \"destructive\";\n\n/**\n * Cost hints for tools, used by Budget and routing.\n */\nexport interface CostHints {\n  latencyMsP50?: number;\n  latencyMsP95?: number;\n  isAsync?: boolean;\n}\n\n/**\n * Unified tool specification.\n * All tool types (MCP, LangChain, n8n, SKILL) are described by this interface.\n *\n * Safety: each tool declares capabilities (permission gating) and _meta.hitl.sideEffect\n * (HITL approval for external_write/destructive). Caller uses these to decide handling.\n */\nexport interface ToolSpec {\n  /** Globally unique name, recommended format: namespace/name */\n  name: string;\n  /** Semver version */\n  version: string;\n  /** Tool kind determines which adapter handles execution */\n  kind: ToolKind;\n\n  description?: string;\n  tags?: string[];\n\n  /** JSON Schema for input validation */\n  inputSchema: object;\n  /** JSON Schema for output validation */\n  outputSchema: object;\n\n  /** Required capabilities for this tool (safety: PolicyEngine gates by ExecContext.permissions) */\n  capabilities: Capability[];\n  costHints?: CostHints;\n\n  /** HITL and adapter-specific metadata. Adapters may use _meta.sourcePath, _meta.exportName, _meta.projectPath (function), etc. */\n  _meta?: {\n    hitl?: { sideEffect?: HitlSideEffect };\n    /** Function kind: path to source file relative to projectPath */\n    sourcePath?: string;\n    /** Function kind: export name of the handler */\n    exportName?: string;\n    /** Function/skill kind: project root for resolving sourcePath */\n    projectPath?: string;\n  };\n\n  /** Adapter-specific: endpoint URL (MCP/n8n) */\n  endpoint?: string;\n  /** Adapter-specific: resource identifier (workflowId, promptId, etc.) */\n  resourceId?: string;\n  /** Adapter-specific: implementation reference (LangChain Tool instance, skill handler) */\n  impl?: unknown;\n}\n\n/** Default permissive input schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_INPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/** Default permissive output schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_OUTPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/**\n * Minimal options to build a ToolSpec. Use with @effect in JSDoc for HITL sideEffect.\n * Framework fills _meta.hitl.sideEffect from the sideEffect parameter (matches @effect annotation).\n * inputSchema/outputSchema are optional: when omitted, permissive defaults are used (framework supports auto-derived schema at build time in scan/mcp-build).\n */\nexport interface CreateToolSpecOptions {\n  name: string;\n  version?: string;\n  kind: ToolKind;\n  description?: string;\n  tags?: string[];\n  /** Optional: when omitted, DEFAULT_INPUT_SCHEMA is used. Codegen can derive from handler params. */\n  inputSchema?: object;\n  /** Optional: when omitted, DEFAULT_OUTPUT_SCHEMA is used. Codegen can derive from handler return type. */\n  outputSchema?: object;\n  capabilities: Capability[];\n  costHints?: CostHints;\n  /** HITL: from @effect annotation (none | local_write | external_write | destructive). Default \"none\". */\n  sideEffect?: HitlSideEffect;\n}\n\n/**\n * Build a ToolSpec from minimal options. Use @effect in handler JSDoc as annotation; pass same value as sideEffect.\n * When inputSchema/outputSchema are omitted, permissive defaults are used (schema can be auto-derived at build time).\n */\nexport function createToolSpec(opts: CreateToolSpecOptions): ToolSpec {\n  const sideEffect = opts.sideEffect ?? \"none\";\n  return {\n    name: opts.name,\n    version: opts.version ?? \"1.0.0\",\n    kind: opts.kind,\n    description: opts.description,\n    tags: opts.tags,\n    inputSchema: opts.inputSchema ?? DEFAULT_INPUT_SCHEMA,\n    outputSchema: opts.outputSchema ?? DEFAULT_OUTPUT_SCHEMA,\n    capabilities: opts.capabilities,\n    costHints: opts.costHints,\n    _meta: { hitl: { sideEffect } },\n  };\n}\n\n/**\n * Unified adapter interface.\n * Each tool kind has its own invoke path; PTCRuntime looks up adapter by spec.kind and calls adapter.invoke(spec, args, ctx).\n * Implementations: core/example (extensions), mcp (MCPClientAdapter); function/skill/n8n/langchain in-process adapters TBD (see tools/README and ToolTypeHandler).\n */\nexport interface ToolAdapter {\n  kind: ToolKind;\n  /** Optional: supports dynamic tool discovery */\n  listTools?(): Promise<ToolSpec[]>;\n  /** Execute the tool with validated args */\n  invoke(\n    spec: ToolSpec,\n    args: unknown,\n    ctx: import(\"./ToolIntent.js\").ExecContext,\n  ): Promise<{ result: unknown; raw?: unknown }>;\n}\n"]}

package/dist/chunk-6F5JHLZ7.cjs

@@ -0,0 +1,243 @@
+'use strict';
+
+// src/tools/util/canonicalCoreSchemas.ts
+var S = (o) => o;
+var CORE_TOOL_SCHEMAS = {
+  "core/fs.readText": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Path to the file (within sandbox)" },
+        maxBytes: { type: "number", description: "Max bytes to read (optional)" }
+      },
+      required: ["path"],
+      additionalProperties: false
+    }),
+    outputSchema: S({
+      type: "object",
+      properties: {
+        result: {
+          type: "object",
+          properties: {
+            path: { type: "string" },
+            text: { type: "string" },
+            bytes: { type: "number" }
+          }
+        }
+      }
+    })
+  },
+  "core/fs.writeText": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Path to write (within sandbox)" },
+        content: { type: "string", description: "UTF-8 content to write" }
+      },
+      required: ["path", "content"],
+      additionalProperties: false
+    })
+  },
+  "core/fs.listDir": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Directory path (within sandbox)" },
+        maxEntries: { type: "number", description: "Max entries to return (optional)" }
+      },
+      required: ["path"],
+      additionalProperties: false
+    })
+  },
+  "core/fs.searchText": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Path to file or directory" },
+        pattern: { type: "string", description: "Search pattern (regex or literal)" },
+        maxMatches: { type: "number", description: "Max matches (optional)" }
+      },
+      required: ["path", "pattern"],
+      additionalProperties: false
+    })
+  },
+  "core/fs.sha256": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Path to file (within sandbox)" }
+      },
+      required: ["path"],
+      additionalProperties: false
+    })
+  },
+  "core/fs.deletePath": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Path to delete (within sandbox)" }
+      },
+      required: ["path"],
+      additionalProperties: false
+    })
+  },
+  "core/http.fetchText": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to fetch" },
+        headers: { type: "object", additionalProperties: { type: "string" }, description: "Optional request headers" },
+        timeoutMs: { type: "number", description: "Request timeout in ms (optional)" }
+      },
+      required: ["url"],
+      additionalProperties: false
+    })
+  },
+  "core/http.fetchJson": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to fetch" },
+        headers: { type: "object", additionalProperties: { type: "string" } }
+      },
+      required: ["url"],
+      additionalProperties: false
+    })
+  },
+  "core/http.downloadFile": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to download" },
+        destPath: { type: "string", description: "Destination path (within sandbox)" },
+        headers: { type: "object", additionalProperties: { type: "string" } }
+      },
+      required: ["url", "destPath"],
+      additionalProperties: false
+    })
+  },
+  "core/http.head": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL for HEAD request" }
+      },
+      required: ["url"],
+      additionalProperties: false
+    })
+  },
+  "core/http.duckduckgoSearch": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Search query" },
+        maxResults: { type: "number", description: "Max results (optional)" }
+      },
+      required: ["query"],
+      additionalProperties: false
+    })
+  },
+  "core/http.fetchPageMainContent": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        url: { type: "string", description: "Page URL" },
+        maxLength: { type: "number", description: "Max content length (optional)" }
+      },
+      required: ["url"],
+      additionalProperties: false
+    })
+  },
+  "core/util.json.select": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        json: { description: "JSON value (object or string)" },
+        selector: { type: "string", description: "JSONPath or selector" }
+      },
+      required: ["json", "selector"],
+      additionalProperties: false
+    })
+  },
+  "core/util.text.truncate": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        text: { type: "string", description: "Text to truncate" },
+        maxLength: { type: "number", description: "Max length" }
+      },
+      required: ["text", "maxLength"],
+      additionalProperties: false
+    })
+  },
+  "core/util.hash.sha256Text": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        text: { type: "string", description: "Text to hash" }
+      },
+      required: ["text"],
+      additionalProperties: false
+    })
+  },
+  "core/util.time.now": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        timezone: { type: "string", description: "IANA timezone (optional)" }
+      },
+      additionalProperties: false
+    })
+  },
+  "core/util.template.render": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        template: { type: "string", description: "Template string (e.g. Mustache)" },
+        data: { type: "object", description: "Data object for template" }
+      },
+      required: ["template", "data"],
+      additionalProperties: false
+    })
+  },
+  "core/exec.runCommand": {
+    inputSchema: S({
+      type: "object",
+      properties: {
+        command: { type: "string", description: "Command to run" },
+        args: { type: "array", items: { type: "string" }, description: "Arguments (optional)" },
+        cwd: { type: "string", description: "Working directory (optional)" },
+        timeoutMs: { type: "number", description: "Timeout in ms (optional)" }
+      },
+      required: ["command"],
+      additionalProperties: false
+    })
+  }
+};
+function isGenericSchema(schema) {
+  if (schema === null || typeof schema !== "object") return false;
+  const s = schema;
+  if (s.type !== "object") return false;
+  if (s.additionalProperties === true && !s.properties) return true;
+  if (s.properties === void 0 && s.required === void 0) return true;
+  return false;
+}
+function enrichSpecWithCanonicalSchema(spec) {
+  if (spec.kind !== "core") return spec;
+  const canonical = CORE_TOOL_SCHEMAS[spec.name];
+  if (!canonical) return spec;
+  const useInput = isGenericSchema(spec.inputSchema) ? canonical.inputSchema : spec.inputSchema;
+  const useOutput = canonical.outputSchema && isGenericSchema(spec.outputSchema) ? canonical.outputSchema : spec.outputSchema;
+  if (useInput === spec.inputSchema && useOutput === spec.outputSchema) return spec;
+  return {
+    ...spec,
+    inputSchema: useInput,
+    outputSchema: useOutput
+  };
+}
+
+exports.CORE_TOOL_SCHEMAS = CORE_TOOL_SCHEMAS;
+exports.enrichSpecWithCanonicalSchema = enrichSpecWithCanonicalSchema;
+exports.isGenericSchema = isGenericSchema;
+//# sourceMappingURL=chunk-6F5JHLZ7.cjs.map
+//# sourceMappingURL=chunk-6F5JHLZ7.cjs.map

package/dist/chunk-6F5JHLZ7.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/util/canonicalCoreSchemas.ts"],"names":[],"mappings":"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","file":"chunk-6F5JHLZ7.cjs","sourcesContent":["/**\n * Canonical input/output schemas for core (builtin) tools.\n * Used when the builtin package registers specs with generic schema\n * (type: object, additionalProperties: true) so CLI describe and OpenAPI show real schemas.\n */\n\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\n\nconst S = (o: object) => o as Record<string, unknown>;\n\n/** Canonical inputSchema (and optional outputSchema) by tool name (e.g. core/fs.readText). */\nexport const CORE_TOOL_SCHEMAS: Record<\n  string,\n  { inputSchema: object; outputSchema?: object }\n> = {\n  \"core/fs.readText\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", description: \"Path to the file (within sandbox)\" },\n        maxBytes: { type: \"number\", description: \"Max bytes to read (optional)\" },\n      },\n      required: [\"path\"],\n      additionalProperties: false,\n    }),\n    outputSchema: S({\n      type: \"object\",\n      properties: {\n        result: {\n          type: \"object\",\n          properties: {\n            path: { type: \"string\" },\n            text: { type: \"string\" },\n            bytes: { type: \"number\" },\n          },\n        },\n      },\n    }),\n  },\n  \"core/fs.writeText\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", description: \"Path to write (within sandbox)\" },\n        content: { type: \"string\", description: \"UTF-8 content to write\" },\n      },\n      required: [\"path\", \"content\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/fs.listDir\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", description: \"Directory path (within sandbox)\" },\n        maxEntries: { type: \"number\", description: \"Max entries to return (optional)\" },\n      },\n      required: [\"path\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/fs.searchText\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", description: \"Path to file or directory\" },\n        pattern: { type: \"string\", description: \"Search pattern (regex or literal)\" },\n        maxMatches: { type: \"number\", description: \"Max matches (optional)\" },\n      },\n      required: [\"path\", \"pattern\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/fs.sha256\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", description: \"Path to file (within sandbox)\" },\n      },\n      required: [\"path\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/fs.deletePath\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", description: \"Path to delete (within sandbox)\" },\n      },\n      required: [\"path\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/http.fetchText\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        url: { type: \"string\", description: \"URL to fetch\" },\n        headers: { type: \"object\", additionalProperties: { type: \"string\" }, description: \"Optional request headers\" },\n        timeoutMs: { type: \"number\", description: \"Request timeout in ms (optional)\" },\n      },\n      required: [\"url\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/http.fetchJson\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        url: { type: \"string\", description: \"URL to fetch\" },\n        headers: { type: \"object\", additionalProperties: { type: \"string\" } },\n      },\n      required: [\"url\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/http.downloadFile\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        url: { type: \"string\", description: \"URL to download\" },\n        destPath: { type: \"string\", description: \"Destination path (within sandbox)\" },\n        headers: { type: \"object\", additionalProperties: { type: \"string\" } },\n      },\n      required: [\"url\", \"destPath\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/http.head\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        url: { type: \"string\", description: \"URL for HEAD request\" },\n      },\n      required: [\"url\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/http.duckduckgoSearch\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        query: { type: \"string\", description: \"Search query\" },\n        maxResults: { type: \"number\", description: \"Max results (optional)\" },\n      },\n      required: [\"query\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/http.fetchPageMainContent\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        url: { type: \"string\", description: \"Page URL\" },\n        maxLength: { type: \"number\", description: \"Max content length (optional)\" },\n      },\n      required: [\"url\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/util.json.select\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        json: { description: \"JSON value (object or string)\" },\n        selector: { type: \"string\", description: \"JSONPath or selector\" },\n      },\n      required: [\"json\", \"selector\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/util.text.truncate\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        text: { type: \"string\", description: \"Text to truncate\" },\n        maxLength: { type: \"number\", description: \"Max length\" },\n      },\n      required: [\"text\", \"maxLength\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/util.hash.sha256Text\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        text: { type: \"string\", description: \"Text to hash\" },\n      },\n      required: [\"text\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/util.time.now\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        timezone: { type: \"string\", description: \"IANA timezone (optional)\" },\n      },\n      additionalProperties: false,\n    }),\n  },\n  \"core/util.template.render\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        template: { type: \"string\", description: \"Template string (e.g. Mustache)\" },\n        data: { type: \"object\", description: \"Data object for template\" },\n      },\n      required: [\"template\", \"data\"],\n      additionalProperties: false,\n    }),\n  },\n  \"core/exec.runCommand\": {\n    inputSchema: S({\n      type: \"object\",\n      properties: {\n        command: { type: \"string\", description: \"Command to run\" },\n        args: { type: \"array\", items: { type: \"string\" }, description: \"Arguments (optional)\" },\n        cwd: { type: \"string\", description: \"Working directory (optional)\" },\n        timeoutMs: { type: \"number\", description: \"Timeout in ms (optional)\" },\n      },\n      required: [\"command\"],\n      additionalProperties: false,\n    }),\n  },\n};\n\n/** True if schema looks like the generic permissive one. */\nexport function isGenericSchema(schema: unknown): boolean {\n  if (schema === null || typeof schema !== \"object\") return false;\n  const s = schema as Record<string, unknown>;\n  if (s.type !== \"object\") return false;\n  if (s.additionalProperties === true && !s.properties) return true;\n  if (s.properties === undefined && s.required === undefined) return true;\n  return false;\n}\n\n/**\n * If spec is a core tool with generic input/output schema, return spec with canonical schema.\n * Otherwise return spec unchanged.\n */\nexport function enrichSpecWithCanonicalSchema(spec: ToolSpec): ToolSpec {\n  if (spec.kind !== \"core\") return spec;\n  const canonical = CORE_TOOL_SCHEMAS[spec.name];\n  if (!canonical) return spec;\n  const useInput = isGenericSchema(spec.inputSchema) ? canonical.inputSchema : spec.inputSchema;\n  const useOutput =\n    canonical.outputSchema && isGenericSchema(spec.outputSchema)\n      ? canonical.outputSchema\n      : spec.outputSchema;\n  if (useInput === spec.inputSchema && useOutput === spec.outputSchema) return spec;\n  return {\n    ...spec,\n    inputSchema: useInput,\n    outputSchema: useOutput,\n  };\n}\n"]}

package/dist/chunk-AE6FSNGY.js

@@ -0,0 +1,201 @@
+import pRetry from 'p-retry';
+
+// src/core/registry/ToolRegistry.ts
+var ToolRegistry = class {
+  tools = /* @__PURE__ */ new Map();
+  tagIndex = /* @__PURE__ */ new Map();
+  // tag → tool names
+  kindIndex = /* @__PURE__ */ new Map();
+  // kind → tool names
+  /**
+   * Register a single tool spec.
+   * Overwrites if same name already exists.
+   */
+  register(spec) {
+    this.validateSpec(spec);
+    this.tools.set(spec.name, spec);
+    this.indexTool(spec);
+  }
+  /**
+   * Register multiple tool specs at once.
+   */
+  bulkRegister(specs) {
+    for (const spec of specs) {
+      this.register(spec);
+    }
+  }
+  /**
+   * Unregister a tool by name.
+   */
+  unregister(name) {
+    const spec = this.tools.get(name);
+    if (!spec) return false;
+    this.tools.delete(name);
+    this.deindexTool(spec);
+    return true;
+  }
+  /**
+   * Get a tool spec by name.
+   */
+  get(name) {
+    return this.tools.get(name);
+  }
+  /**
+   * Check if a tool exists.
+   */
+  has(name) {
+    return this.tools.has(name);
+  }
+  /**
+   * Search tools by query.
+   */
+  search(query) {
+    let candidates;
+    if (query.kind) {
+      const names = this.kindIndex.get(query.kind);
+      if (!names || names.size === 0) return [];
+      candidates = [...names].map((n) => this.tools.get(n)).filter((s) => s !== void 0);
+    } else {
+      candidates = [...this.tools.values()];
+    }
+    if (query.tags && query.tags.length > 0) {
+      candidates = candidates.filter(
+        (spec) => query.tags.some((tag) => spec.tags?.includes(tag))
+      );
+    }
+    if (query.capabilities && query.capabilities.length > 0) {
+      candidates = candidates.filter(
+        (spec) => query.capabilities.every((cap) => spec.capabilities.includes(cap))
+      );
+    }
+    if (query.text) {
+      const lower = query.text.toLowerCase();
+      candidates = candidates.filter(
+        (spec) => spec.name.toLowerCase().includes(lower) || spec.description?.toLowerCase().includes(lower) || spec.tags?.some((t) => t.toLowerCase().includes(lower))
+      );
+    }
+    return candidates;
+  }
+  /**
+   * List all registered tool names.
+   */
+  list() {
+    return [...this.tools.keys()];
+  }
+  /**
+   * Get count of registered tools.
+   */
+  get size() {
+    return this.tools.size;
+  }
+  /**
+   * Export a snapshot of all registered tools (for debugging/routing).
+   */
+  snapshot() {
+    return [...this.tools.values()];
+  }
+  /**
+   * Clear all registered tools.
+   */
+  clear() {
+    this.tools.clear();
+    this.tagIndex.clear();
+    this.kindIndex.clear();
+  }
+  validateSpec(spec) {
+    if (!spec.name) throw new Error("ToolSpec.name is required");
+    if (!spec.version) throw new Error("ToolSpec.version is required");
+    if (!spec.kind) throw new Error("ToolSpec.kind is required");
+    if (!spec.inputSchema) throw new Error("ToolSpec.inputSchema is required");
+    if (!spec.outputSchema) throw new Error("ToolSpec.outputSchema is required");
+    if (!spec.capabilities) throw new Error("ToolSpec.capabilities is required");
+  }
+  indexTool(spec) {
+    let kindSet = this.kindIndex.get(spec.kind);
+    if (!kindSet) {
+      kindSet = /* @__PURE__ */ new Set();
+      this.kindIndex.set(spec.kind, kindSet);
+    }
+    kindSet.add(spec.name);
+    if (spec.tags) {
+      for (const tag of spec.tags) {
+        let tagSet = this.tagIndex.get(tag);
+        if (!tagSet) {
+          tagSet = /* @__PURE__ */ new Set();
+          this.tagIndex.set(tag, tagSet);
+        }
+        tagSet.add(spec.name);
+      }
+    }
+  }
+  deindexTool(spec) {
+    this.kindIndex.get(spec.kind)?.delete(spec.name);
+    if (spec.tags) {
+      for (const tag of spec.tags) {
+        this.tagIndex.get(tag)?.delete(spec.name);
+      }
+    }
+  }
+};
+var NON_RETRYABLE_ERRORS = /* @__PURE__ */ new Set([
+  "TOOL_NOT_FOUND",
+  "INPUT_SCHEMA_INVALID",
+  "POLICY_DENIED",
+  "HITL_DENIED",
+  "OUTPUT_SCHEMA_INVALID",
+  "PATH_OUTSIDE_SANDBOX",
+  "FILE_TOO_LARGE",
+  "HTTP_DISALLOWED_HOST",
+  "HTTP_TOO_LARGE",
+  "EXEC_INVALID",
+  "EXEC_SPAWN_ERROR",
+  "DUCKDUCKGO_INVALID"
+]);
+function isRetryable(error) {
+  if (error instanceof Error) {
+    const kind = error.kind;
+    if (kind && NON_RETRYABLE_ERRORS.has(kind)) return false;
+  }
+  return true;
+}
+async function withRetry(fn, options = {}) {
+  const {
+    maxRetries = 2,
+    baseDelayMs = 1e3,
+    maxDelayMs = 1e4,
+    jitter = 0.1,
+    shouldRetry,
+    onRetry
+  } = options;
+  if (maxRetries <= 0) {
+    return fn();
+  }
+  const pRetryOptions = {
+    retries: maxRetries,
+    minTimeout: baseDelayMs,
+    maxTimeout: maxDelayMs,
+    randomize: true,
+    factor: 2,
+    onFailedAttempt: (error) => {
+      if (jitter > 0 && error.retriesLeft > 0) ;
+      if (shouldRetry && !shouldRetry(error)) {
+        throw error;
+      }
+      if (!isRetryable(error)) {
+        throw error;
+      }
+      onRetry?.(error, maxRetries - error.retriesLeft);
+    }
+  };
+  return pRetry(fn, pRetryOptions);
+}
+function createTaggedError(kind, message, details) {
+  const error = new Error(message);
+  error.kind = kind;
+  error.details = details;
+  return error;
+}
+
+export { ToolRegistry, createTaggedError, isRetryable, withRetry };
+//# sourceMappingURL=chunk-AE6FSNGY.js.map
+//# sourceMappingURL=chunk-AE6FSNGY.js.map

package/dist/chunk-AE6FSNGY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/registry/ToolRegistry.ts","../src/core/runtime/Retry.ts"],"names":[],"mappings":"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","file":"chunk-AE6FSNGY.js","sourcesContent":["import type { Capability, ToolKind, ToolSpec } from \"../types/ToolSpec.js\";\n\n/**\n * Search query for tools.\n */\nexport interface ToolSearchQuery {\n  /** Text search in name/description/tags */\n  text?: string;\n  /** Filter by tool kind */\n  kind?: ToolKind;\n  /** Filter by required capabilities */\n  capabilities?: Capability[];\n  /** Filter by tags */\n  tags?: string[];\n}\n\n/**\n * Tool Registry: manages tool registration, lookup, and search.\n * Supports both static registration and dynamic discovery via adapters.\n */\nexport class ToolRegistry {\n  private readonly tools = new Map<string, ToolSpec>();\n  private readonly tagIndex = new Map<string, Set<string>>(); // tag → tool names\n  private readonly kindIndex = new Map<ToolKind, Set<string>>(); // kind → tool names\n\n  /**\n   * Register a single tool spec.\n   * Overwrites if same name already exists.\n   */\n  register(spec: ToolSpec): void {\n    this.validateSpec(spec);\n    this.tools.set(spec.name, spec);\n    this.indexTool(spec);\n  }\n\n  /**\n   * Register multiple tool specs at once.\n   */\n  bulkRegister(specs: ToolSpec[]): void {\n    for (const spec of specs) {\n      this.register(spec);\n    }\n  }\n\n  /**\n   * Unregister a tool by name.\n   */\n  unregister(name: string): boolean {\n    const spec = this.tools.get(name);\n    if (!spec) return false;\n    this.tools.delete(name);\n    this.deindexTool(spec);\n    return true;\n  }\n\n  /**\n   * Get a tool spec by name.\n   */\n  get(name: string): ToolSpec | undefined {\n    return this.tools.get(name);\n  }\n\n  /**\n   * Check if a tool exists.\n   */\n  has(name: string): boolean {\n    return this.tools.has(name);\n  }\n\n  /**\n   * Search tools by query.\n   */\n  search(query: ToolSearchQuery): ToolSpec[] {\n    let candidates: ToolSpec[];\n\n    // Start with kind filter if specified (uses index)\n    if (query.kind) {\n      const names = this.kindIndex.get(query.kind);\n      if (!names || names.size === 0) return [];\n      candidates = [...names]\n        .map((n) => this.tools.get(n))\n        .filter((s): s is ToolSpec => s !== undefined);\n    } else {\n      candidates = [...this.tools.values()];\n    }\n\n    // Filter by tags (uses index for initial candidates if no kind filter)\n    if (query.tags && query.tags.length > 0) {\n      candidates = candidates.filter((spec) =>\n        query.tags!.some((tag) => spec.tags?.includes(tag)),\n      );\n    }\n\n    // Filter by capabilities\n    if (query.capabilities && query.capabilities.length > 0) {\n      candidates = candidates.filter((spec) =>\n        query.capabilities!.every((cap) => spec.capabilities.includes(cap)),\n      );\n    }\n\n    // Filter by text (name, description, tags)\n    if (query.text) {\n      const lower = query.text.toLowerCase();\n      candidates = candidates.filter(\n        (spec) =>\n          spec.name.toLowerCase().includes(lower) ||\n          spec.description?.toLowerCase().includes(lower) ||\n          spec.tags?.some((t) => t.toLowerCase().includes(lower)),\n      );\n    }\n\n    return candidates;\n  }\n\n  /**\n   * List all registered tool names.\n   */\n  list(): string[] {\n    return [...this.tools.keys()];\n  }\n\n  /**\n   * Get count of registered tools.\n   */\n  get size(): number {\n    return this.tools.size;\n  }\n\n  /**\n   * Export a snapshot of all registered tools (for debugging/routing).\n   */\n  snapshot(): ToolSpec[] {\n    return [...this.tools.values()];\n  }\n\n  /**\n   * Clear all registered tools.\n   */\n  clear(): void {\n    this.tools.clear();\n    this.tagIndex.clear();\n    this.kindIndex.clear();\n  }\n\n  private validateSpec(spec: ToolSpec): void {\n    if (!spec.name) throw new Error(\"ToolSpec.name is required\");\n    if (!spec.version) throw new Error(\"ToolSpec.version is required\");\n    if (!spec.kind) throw new Error(\"ToolSpec.kind is required\");\n    if (!spec.inputSchema) throw new Error(\"ToolSpec.inputSchema is required\");\n    if (!spec.outputSchema) throw new Error(\"ToolSpec.outputSchema is required\");\n    if (!spec.capabilities) throw new Error(\"ToolSpec.capabilities is required\");\n  }\n\n  private indexTool(spec: ToolSpec): void {\n    // Kind index\n    let kindSet = this.kindIndex.get(spec.kind);\n    if (!kindSet) {\n      kindSet = new Set();\n      this.kindIndex.set(spec.kind, kindSet);\n    }\n    kindSet.add(spec.name);\n\n    // Tag index\n    if (spec.tags) {\n      for (const tag of spec.tags) {\n        let tagSet = this.tagIndex.get(tag);\n        if (!tagSet) {\n          tagSet = new Set();\n          this.tagIndex.set(tag, tagSet);\n        }\n        tagSet.add(spec.name);\n      }\n    }\n  }\n\n  private deindexTool(spec: ToolSpec): void {\n    this.kindIndex.get(spec.kind)?.delete(spec.name);\n    if (spec.tags) {\n      for (const tag of spec.tags) {\n        this.tagIndex.get(tag)?.delete(spec.name);\n      }\n    }\n  }\n}\n","import pRetry, { type Options as PRetryOptions } from \"p-retry\";\n\n/**\n * Retry configuration.\n */\nexport interface RetryOptions {\n  /** Maximum number of retries (default: 2) */\n  maxRetries?: number;\n  /** Base delay in ms for exponential backoff (default: 1000) */\n  baseDelayMs?: number;\n  /** Maximum delay in ms (default: 10000) */\n  maxDelayMs?: number;\n  /** Jitter factor 0-1 (default: 0.1) */\n  jitter?: number;\n  /** Error filter: return true to retry, false to abort */\n  shouldRetry?: (error: Error) => boolean;\n  /** Callback on each retry attempt */\n  onRetry?: (error: Error, attempt: number) => void;\n}\n\n/**\n * Default errors that should NOT be retried (deterministic failures).\n */\nconst NON_RETRYABLE_ERRORS = new Set([\n  \"TOOL_NOT_FOUND\",\n  \"INPUT_SCHEMA_INVALID\",\n  \"POLICY_DENIED\",\n  \"HITL_DENIED\",\n  \"OUTPUT_SCHEMA_INVALID\",\n  \"PATH_OUTSIDE_SANDBOX\",\n  \"FILE_TOO_LARGE\",\n  \"HTTP_DISALLOWED_HOST\",\n  \"HTTP_TOO_LARGE\",\n  \"EXEC_INVALID\",\n  \"EXEC_SPAWN_ERROR\",\n  \"DUCKDUCKGO_INVALID\",\n]);\n\n/**\n * Determine if an error is retryable.\n */\nexport function isRetryable(error: unknown): boolean {\n  if (error instanceof Error) {\n    const kind = (error as Error & { kind?: string }).kind;\n    if (kind && NON_RETRYABLE_ERRORS.has(kind)) return false;\n  }\n  return true;\n}\n\n/**\n * Execute a function with retry logic using exponential backoff.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  options: RetryOptions = {},\n): Promise<T> {\n  const {\n    maxRetries = 2,\n    baseDelayMs = 1000,\n    maxDelayMs = 10_000,\n    jitter = 0.1,\n    shouldRetry,\n    onRetry,\n  } = options;\n\n  if (maxRetries <= 0) {\n    return fn();\n  }\n\n  const pRetryOptions: PRetryOptions = {\n    retries: maxRetries,\n    minTimeout: baseDelayMs,\n    maxTimeout: maxDelayMs,\n    randomize: true,\n    factor: 2,\n    onFailedAttempt: (error) => {\n      // Apply jitter\n      if (jitter > 0 && error.retriesLeft > 0) {\n        // jitterMs calculated but p-retry handles backoff internally\n        void (Math.random() * jitter * baseDelayMs);\n      }\n\n      // Check if should retry\n      if (shouldRetry && !shouldRetry(error)) {\n        throw error; // Abort retry\n      }\n\n      if (!isRetryable(error)) {\n        throw error; // Non-retryable error kind\n      }\n\n      onRetry?.(error, maxRetries - error.retriesLeft);\n    },\n  };\n\n  return pRetry(fn, pRetryOptions);\n}\n\n/**\n * Create a tagged error with a kind field for retry classification.\n */\nexport function createTaggedError(\n  kind: string,\n  message: string,\n  details?: unknown,\n): Error & { kind: string; details?: unknown } {\n  const error = new Error(message) as Error & {\n    kind: string;\n    details?: unknown;\n  };\n  error.kind = kind;\n  error.details = details;\n  return error;\n}\n"]}