@easynet/agent-tool 1.0.0 → 1.0.2

package/dist/chunk-ZNJBRLKN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/registry/ToolRegistry.ts","../src/core/runtime/Retry.ts"],"names":["pRetry"],"mappings":"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","file":"chunk-ZNJBRLKN.cjs","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"]}

package/dist/core/index.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var chunkSOFUWEZ6_cjs = require('../chunk-SOFUWEZ6.cjs');
+
+
+
+Object.defineProperty(exports, "DEFAULT_INPUT_SCHEMA", {
+  enumerable: true,
+  get: function () { return chunkSOFUWEZ6_cjs.DEFAULT_INPUT_SCHEMA; }
+});
+Object.defineProperty(exports, "DEFAULT_OUTPUT_SCHEMA", {
+  enumerable: true,
+  get: function () { return chunkSOFUWEZ6_cjs.DEFAULT_OUTPUT_SCHEMA; }
+});
+Object.defineProperty(exports, "createToolSpec", {
+  enumerable: true,
+  get: function () { return chunkSOFUWEZ6_cjs.createToolSpec; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/core/index.cjs.map

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

package/dist/{core.d.ts → core/index.d.ts}

@@ -1,8 +1,7 @@
 /**
  * Core types and createToolSpec only.
- * Use this entry point from extensions to avoid circular dependency with the main index
- * (which re-exports builtin-tools and example-tools).
+ * Use this entry point from extensions to avoid circular dependency with the main index.
  */
 export type { ToolKind, Capability, HitlSideEffect, CostHints, ToolSpec, CreateToolSpecOptions, } from "./types/ToolSpec.js";
 export { createToolSpec, DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, } from "./types/ToolSpec.js";
-//# sourceMappingURL=core.d.ts.map
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,SAAS,EACT,QAAQ,EACR,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,3 @@
+export { DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, createToolSpec } from '../chunk-5SWSNVMI.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

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

package/dist/core/registry/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/registry/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,sCAAsC;IACtC,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAM9B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAMrC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,EAAE;IA0C1C;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,WAAW;CAQpB"}

package/dist/core/runtime/Budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Budget.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/Budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,6BAA6B;IAC7B,cAAc,CAAC,EAAE;QACf,oDAAoD;QACpD,SAAS,EAAE,MAAM,CAAC;QAClB,iCAAiC;QACjC,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAiCD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2C;IAC3E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,OAAO,GAAE,aAAkB;IAKvC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IAIhE;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAazC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAUzD;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAarE;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBpE;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM7B;;OAEG;IACH,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/core/runtime/Evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Evidence.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/Evidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,WAAW,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,QAAQ,EAAE,CAgDvE"}

package/dist/{runtime → core/runtime}/PTCRuntime.d.ts

@@ -5,10 +5,10 @@ import { ToolRegistry } from "../registry/ToolRegistry.js";
 import { SchemaValidator } from "./SchemaValidator.js";
 import { PolicyEngine } from "./PolicyEngine.js";
 import { BudgetManager } from "./Budget.js";
-import { EventLog } from "../observability/EventLog.js";
-import type { DebugOptions } from "../observability/Logger.js";
-import { Metrics } from "../observability/Metrics.js";
-import { Tracing } from "../observability/Tracing.js";
+import { EventLog } from "../../observability/EventLog.js";
+import type { DebugOptions } from "../../observability/Logger.js";
+import { Metrics } from "../../observability/Metrics.js";
+import { Tracing } from "../../observability/Tracing.js";
 import type { PolicyConfig } from "./PolicyEngine.js";
 import type { BudgetOptions } from "./Budget.js";
 /**

package/dist/core/runtime/PTCRuntime.d.ts.map

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

package/dist/{runtime → core/runtime}/PTCRuntimeObservability.d.ts

@@ -1,10 +1,10 @@
 import type { ToolSpec } from "../types/ToolSpec.js";
 import type { ExecContext, ToolIntent } from "../types/ToolIntent.js";
 import type { Evidence, ToolResult } from "../types/ToolResult.js";
-import { EventLog } from "../observability/EventLog.js";
-import { Metrics } from "../observability/Metrics.js";
-import { Tracing } from "../observability/Tracing.js";
-import type { Logger } from "../observability/Logger.js";
+import { EventLog } from "../../observability/EventLog.js";
+import { Metrics } from "../../observability/Metrics.js";
+import { Tracing } from "../../observability/Tracing.js";
+import type { Logger } from "../../observability/Logger.js";
 export interface ObservabilityDependencies {
     eventLog: EventLog;
     metrics: Metrics;

package/dist/core/runtime/PTCRuntimeObservability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PTCRuntimeObservability.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/PTCRuntimeObservability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKnE,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,yBAAyB,GAC9B,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,yBAAyB,GAC9B,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,yBAAyB,GAC9B,UAAU,CAkDZ"}

package/dist/{runtime → core/runtime}/PTCRuntimePipeline.d.ts

@@ -4,10 +4,10 @@ import type { ToolAdapter } from "../types/ToolSpec.js";
 import { SchemaValidator } from "./SchemaValidator.js";
 import { PolicyEngine } from "./PolicyEngine.js";
 import { BudgetManager } from "./Budget.js";
-import { EventLog } from "../observability/EventLog.js";
-import { Metrics } from "../observability/Metrics.js";
-import { Tracing } from "../observability/Tracing.js";
-import type { Logger } from "../observability/Logger.js";
+import { EventLog } from "../../observability/EventLog.js";
+import { Metrics } from "../../observability/Metrics.js";
+import { Tracing } from "../../observability/Tracing.js";
+import type { Logger } from "../../observability/Logger.js";
 /** Called when tool has sideEffect external_write/destructive; return true/void to approve, false to deny. */
 export type OnApprovalRequired = (spec: ToolSpec, args: unknown, ctx: ExecContext) => Promise<boolean | void>;
 export interface PipelineDependencies {

package/dist/core/runtime/PTCRuntimePipeline.d.ts.map

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

package/dist/core/runtime/PolicyEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyEngine.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/PolicyEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,oEAAoE;IACpE,+BAA+B,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,UAAU,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,GAAE,YAAiB;IAQrC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;IAU9D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,iBAAiB;IAazE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+BzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsCvB,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,YAAY;IAyBpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAqB5B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;aAKxB,mBAAmB,CAAC,EAAE,UAAU,EAAE;IAJpD,SAAgB,IAAI,mBAAmB;gBAGrC,OAAO,EAAE,MAAM,EACC,mBAAmB,CAAC,EAAE,UAAU,EAAE,YAAA;CAKrD"}

package/dist/core/runtime/Retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Retry.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/Retry.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACxC,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAoBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMnD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAyCZ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,GAChB,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAQ7C"}

package/dist/core/runtime/SchemaValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaValidator.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/SchemaValidator.ts"],"names":[],"mappings":"AAAA,OAAY,EAAyB,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAGnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;;IAa7D;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB;IAezD;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAcxE;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO;IAOtD,OAAO,CAAC,YAAY;IAWpB,wFAAwF;IACxF,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,kBAAkB;CAiE3B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,MAAM,EAAE,WAAW,EAAE;gBADrC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,WAAW,EAAE;CAKxC"}

package/dist/core/runtime.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+var chunkZNJBRLKN_cjs = require('../chunk-ZNJBRLKN.cjs');
+
+
+
+Object.defineProperty(exports, "ToolRegistry", {
+  enumerable: true,
+  get: function () { return chunkZNJBRLKN_cjs.ToolRegistry; }
+});
+Object.defineProperty(exports, "createTaggedError", {
+  enumerable: true,
+  get: function () { return chunkZNJBRLKN_cjs.createTaggedError; }
+});
+Object.defineProperty(exports, "isRetryable", {
+  enumerable: true,
+  get: function () { return chunkZNJBRLKN_cjs.isRetryable; }
+});
+Object.defineProperty(exports, "withRetry", {
+  enumerable: true,
+  get: function () { return chunkZNJBRLKN_cjs.withRetry; }
+});
+//# sourceMappingURL=runtime.cjs.map
+//# sourceMappingURL=runtime.cjs.map

package/dist/core/runtime.cjs.map

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

package/dist/core/runtime.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Runtime subpath export for extensions (e.g. @easynet/agent-tool-builtin-tools).
+ * Re-exports createTaggedError, ToolRegistry, ToolSpec, ExecContext, Evidence, etc.
+ */
+export { createTaggedError, withRetry, isRetryable } from "./runtime/Retry.js";
+export type { RetryOptions } from "./runtime/Retry.js";
+export { ToolRegistry } from "./registry/ToolRegistry.js";
+export type { ToolSearchQuery } from "./registry/ToolRegistry.js";
+export type { ToolSpec, ToolAdapter, ToolKind, Capability } from "./types/ToolSpec.js";
+export type { ExecContext, ToolIntent, BudgetConfig } from "./types/ToolIntent.js";
+export type { Evidence, ToolError, ToolResult } from "./types/ToolResult.js";
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/runtime.js

@@ -0,0 +1,3 @@
+export { ToolRegistry, createTaggedError, isRetryable, withRetry } from '../chunk-AE6FSNGY.js';
+//# sourceMappingURL=runtime.js.map
+//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

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

package/dist/core/types/Events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Events.d.ts","sourceRoot":"","sources":["../../../src/core/types/Events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,aAAa,GACb,eAAe,GACf,yBAAyB,GACzB,uBAAuB,GACvB,sBAAsB,GACtB,OAAO,GACP,SAAS,GACT,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,SAAS;IAC3D,IAAI,EAAE,yBAAyB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,SAAS;IACzD,IAAI,EAAE,uBAAuB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,SAAS;IACxD,IAAI,EAAE,sBAAsB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,eAAe,GACf,iBAAiB,GACjB,0BAA0B,GAC1B,wBAAwB,GACxB,uBAAuB,GACvB,UAAU,GACV,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,CAAC"}

package/dist/core/types/ToolIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolIntent.d.ts","sourceRoot":"","sources":["../../../src/core/types/ToolIntent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/{types → core/types}/ToolResult.d.ts

@@ -7,11 +7,16 @@ export interface Evidence {
     summary: string;
     createdAt: string;
 }
+/**
+ * Known error kinds returned by PTC / tools so callers get structured feedback.
+ * Extensions may use createTaggedError(kind, message, details); pipeline maps to ToolError.
+ */
+export type ToolErrorKind = "TOOL_NOT_FOUND" | "INPUT_SCHEMA_INVALID" | "POLICY_DENIED" | "BUDGET_EXCEEDED" | "TIMEOUT" | "UPSTREAM_ERROR" | "OUTPUT_SCHEMA_INVALID" | "PATH_OUTSIDE_SANDBOX" | "FILE_TOO_LARGE" | "HTTP_DISALLOWED_HOST" | "HTTP_TIMEOUT" | "HTTP_TOO_LARGE" | "HITL_DENIED" | "EXEC_INVALID" | "EXEC_SPAWN_ERROR" | "DUCKDUCKGO_INVALID";
 /**
  * Error information in a tool result.
  */
 export interface ToolError {
-    kind?: "TOOL_NOT_FOUND" | "INPUT_SCHEMA_INVALID" | "POLICY_DENIED" | "BUDGET_EXCEEDED" | "TIMEOUT" | "UPSTREAM_ERROR" | "OUTPUT_SCHEMA_INVALID" | "PATH_OUTSIDE_SANDBOX" | "FILE_TOO_LARGE" | "HTTP_DISALLOWED_HOST" | "HTTP_TIMEOUT" | "HTTP_TOO_LARGE";
+    kind?: ToolErrorKind;
     message: string;
     details?: unknown;
 }

package/dist/core/types/ToolResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolResult.d.ts","sourceRoot":"","sources":["../../../src/core/types/ToolResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,sBAAsB,GACtB,eAAe,GACf,iBAAiB,GACjB,SAAS,GACT,gBAAgB,GAChB,uBAAuB,GACvB,sBAAsB,GACtB,gBAAgB,GAChB,sBAAsB,GACtB,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,iEAAiE;IACjE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}

package/dist/{types → core/types}/ToolSpec.d.ts

@@ -1,7 +1,7 @@
 /**
  * Unified tool kinds supported by the tools package.
  */
-export type ToolKind = "mcp" | "langchain" | "n8n" | "comfyui" | "skill" | "core" | "example";
+export type ToolKind = "mcp" | "langchain" | "n8n" | "comfyui" | "skill" | "function" | "core" | "example";
 /**
  * Capability declarations for tools.
  * Used by PolicyEngine for permission gating.
@@ -23,6 +23,9 @@ export interface CostHints {
 /**
  * Unified tool specification.
  * All tool types (MCP, LangChain, n8n, SKILL) are described by this interface.
+ *
+ * Safety: each tool declares capabilities (permission gating) and _meta.hitl.sideEffect
+ * (HITL approval for external_write/destructive). Caller uses these to decide handling.
  */
 export interface ToolSpec {
     /** Globally unique name, recommended format: namespace/name */
@@ -37,14 +40,20 @@ export interface ToolSpec {
     inputSchema: object;
     /** JSON Schema for output validation */
     outputSchema: object;
-    /** Required capabilities for this tool */
+    /** Required capabilities for this tool (safety: PolicyEngine gates by ExecContext.permissions) */
     capabilities: Capability[];
     costHints?: CostHints;
-    /** HITL: side-effect level; when external_write/destructive, runtime may require human approval before execute */
+    /** HITL and adapter-specific metadata. Adapters may use _meta.sourcePath, _meta.exportName, _meta.projectPath (function), etc. */
     _meta?: {
         hitl?: {
             sideEffect?: HitlSideEffect;
         };
+        /** Function kind: path to source file relative to projectPath */
+        sourcePath?: string;
+        /** Function kind: export name of the handler */
+        exportName?: string;
+        /** Function/skill kind: project root for resolving sourcePath */
+        projectPath?: string;
     };
     /** Adapter-specific: endpoint URL (MCP/n8n) */
     endpoint?: string;
@@ -60,7 +69,7 @@ export declare const DEFAULT_OUTPUT_SCHEMA: object;
 /**
  * Minimal options to build a ToolSpec. Use with @effect in JSDoc for HITL sideEffect.
  * Framework fills _meta.hitl.sideEffect from the sideEffect parameter (matches @effect annotation).
- * inputSchema/outputSchema are optional: when omitted, permissive defaults are used (framework supports auto-derived schema at build time in codegen).
+ * inputSchema/outputSchema are optional: when omitted, permissive defaults are used (framework supports auto-derived schema at build time in scan/mcp-build).
  */
 export interface CreateToolSpecOptions {
     name: string;
@@ -84,7 +93,8 @@ export interface CreateToolSpecOptions {
 export declare function createToolSpec(opts: CreateToolSpecOptions): ToolSpec;
 /**
  * Unified adapter interface.
- * Each protocol adapter (MCP, LangChain, n8n, SKILL) implements this.
+ * Each tool kind has its own invoke path; PTCRuntime looks up adapter by spec.kind and calls adapter.invoke(spec, args, ctx).
+ * Implementations: core/example (extensions), mcp (MCPClientAdapter); function/skill/n8n/langchain in-process adapters TBD (see tools/README and ToolTypeHandler).
  */
 export interface ToolAdapter {
     kind: ToolKind;

package/dist/core/types/ToolSpec.d.ts.map

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

package/dist/core/types/ToolTypeHandler.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Generic tool type handler: scan (discover), load (register), invoke (execute).
+ * Each tool kind has its own invoke path; PTCRuntime dispatches by spec.kind to the
+ * registered ToolAdapter for that kind.
+ *
+ * Invoke by kind:
+ * - core:   handler map → runWithBuiltinContext(handler(args)) — CoreAdapter (builtin-tools)
+ * - example: handler map → runWithExampleContext(handler(args)) — ExampleAdapter (example-tools)
+ * - mcp:    client.callTool({ name, arguments }) — MCPClientAdapter (src/tools/mcp)
+ * - function: dynamic import(spec._meta.sourcePath).then(m => m[exportName](args)) — in-repo adapter TBD; MCP build uses getHandler(name)(args)
+ * - skill:  load skill handler from sourcePath, then run — in-repo adapter TBD; MCP build uses skill-invoker
+ * - n8n:    HTTP to webhook or n8n API — in-repo adapter TBD; MCP build uses n8n-invoker
+ * - langchain: spec.impl.invoke(args) (LangChain Tool) — in-repo adapter TBD
+ *
+ * - scan: discover tools from a path. Optional if the kind does not support path-based discovery (e.g. MCP).
+ * - load: register tools into a registry and/or prepare for invoke. Optional if invoke is via external client.
+ * - invoke: execute the tool (same contract as ToolAdapter.invoke). Required.
+ */
+import type { ToolKind, ToolSpec } from "./ToolSpec.js";
+import type { ToolAdapter } from "./ToolSpec.js";
+import type { ExecContext } from "./ToolIntent.js";
+/** Minimal registry interface for load(); avoids circular dependency on ToolRegistry. */
+export interface ToolRegistryLike {
+    register(spec: ToolSpec): void;
+    bulkRegister(specs: ToolSpec[]): void;
+}
+/** Options for scanning a path for tools of a given kind. */
+export interface ToolTypeScanOptions {
+    /** Project or package root path. */
+    projectPath?: string;
+    /** Glob patterns for files (e.g. ["**\/*.ts"]). Used by function kind. */
+    include?: string[];
+    /** Path to tsconfig.json. Used by function kind. */
+    tsconfigPath?: string;
+    /** Kind-specific options (e.g. includeN8n for scan). */
+    [key: string]: unknown;
+}
+/** Result of scanning: unified ToolSpec[] and any errors/warnings. */
+export interface ToolTypeScanResult {
+    specs: ToolSpec[];
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+    warnings?: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/** Options for loading (registering) tools of a given kind. */
+export interface ToolTypeLoadOptions {
+    /** Namespace for registered tool names (e.g. "pkg"). */
+    namespace?: string;
+    /** Kind-specific options. */
+    [key: string]: unknown;
+}
+/** Result of loading: how many registered and any errors. */
+export interface ToolTypeLoadResult {
+    registered: number;
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/**
+ * Generic tool type handler: scan, load, invoke.
+ * Extends ToolAdapter so a handler can be registered with PTCRuntime as the adapter for its kind.
+ */
+export interface ToolTypeHandler extends ToolAdapter {
+    readonly kind: ToolKind;
+    /**
+     * Discover tools from a path. Optional if this kind does not support path-based discovery.
+     */
+    scan?(path: string, options?: ToolTypeScanOptions): Promise<ToolTypeScanResult> | ToolTypeScanResult;
+    /**
+     * Register tools into registry and/or prepare for invoke. Optional if this kind
+     * only supports invoke via an external client (e.g. MCP client already connected).
+     */
+    load?(path: string, registry: ToolRegistryLike, options?: ToolTypeLoadOptions): Promise<ToolTypeLoadResult> | ToolTypeLoadResult;
+    /**
+     * Execute the tool. Same contract as ToolAdapter.invoke.
+     */
+    invoke(spec: ToolSpec, args: unknown, ctx: ExecContext): Promise<{
+        result: unknown;
+        raw?: unknown;
+    }>;
+}
+//# sourceMappingURL=ToolTypeHandler.d.ts.map

package/dist/core/types/ToolTypeHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolTypeHandler.d.ts","sourceRoot":"","sources":["../../../src/core/types/ToolTypeHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;CACvC;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,CACH,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;IAEpD;;;OAGG;IACH,IAAI,CAAC,CACH,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;IAEpD;;OAEG;IACH,MAAM,CACJ,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,WAAW,GACf,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAChD"}

package/dist/{types → core/types}/index.d.ts

@@ -1,6 +1,7 @@
 export type { ToolKind, Capability, CostHints, ToolSpec, ToolAdapter, HitlSideEffect, CreateToolSpecOptions, } from "./ToolSpec.js";
 export { createToolSpec, DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, } from "./ToolSpec.js";
 export type { BudgetConfig, ExecContext, ToolIntent, } from "./ToolIntent.js";
-export type { Evidence, ToolError, ToolResult, } from "./ToolResult.js";
+export type { Evidence, ToolError, ToolErrorKind, ToolResult, } from "./ToolResult.js";
 export type { ToolEventType, ToolEvent, ToolCalledEvent, ToolResultEvent, PolicyDeniedEvent, RetryEvent, JobSubmittedEvent, JobCompletedEvent, JobFailedEvent, AnyToolEvent, } from "./Events.js";
+export type { ToolTypeScanOptions, ToolTypeScanResult, ToolTypeLoadOptions, ToolTypeLoadResult, ToolRegistryLike, ToolTypeHandler, } from "./ToolTypeHandler.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,EACR,WAAW,EACX,cAAc,EACd,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,QAAQ,EACR,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}