@botbotgo/kit 1.0.104

package/dist/chunk-UUNG3GL3.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+// src/tools/util/canonicalCoreSchemas.ts
+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) {
+  return spec;
+}
+
+exports.enrichSpecWithCanonicalSchema = enrichSpecWithCanonicalSchema;
+exports.isGenericSchema = isGenericSchema;
+//# sourceMappingURL=chunk-UUNG3GL3.cjs.map
+//# sourceMappingURL=chunk-UUNG3GL3.cjs.map

package/dist/chunk-UUNG3GL3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/util/canonicalCoreSchemas.ts"],"names":[],"mappings":";;;AASO,SAAS,gBAAgB,MAAA,EAA0B;AACxD,EAAA,IAAI,MAAA,KAAW,IAAA,IAAQ,OAAO,MAAA,KAAW,UAAU,OAAO,KAAA;AAC1D,EAAA,MAAM,CAAA,GAAI,MAAA;AACV,EAAA,IAAI,CAAA,CAAE,IAAA,KAAS,QAAA,EAAU,OAAO,KAAA;AAChC,EAAA,IAAI,EAAE,oBAAA,KAAyB,IAAA,IAAQ,CAAC,CAAA,CAAE,YAAY,OAAO,IAAA;AAC7D,EAAA,IAAI,EAAE,UAAA,KAAe,MAAA,IAAa,CAAA,CAAE,QAAA,KAAa,QAAW,OAAO,IAAA;AACnE,EAAA,OAAO,KAAA;AACT;AAOO,SAAS,8BAA8B,IAAA,EAA0B;AACtE,EAAA,OAAO,IAAA;AACT","file":"chunk-UUNG3GL3.cjs","sourcesContent":["/**\n * Schema utilities for tool specs.\n * The framework does not hardcode schemas for any specific extension (e.g. builtin);\n * each extension supplies its own inputSchema/outputSchema via manifest or registration.\n */\n\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\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 * Returns the spec unchanged. Previously replaced generic schemas with canonical ones;\n * that list was removed so the framework has no dependency on agent-tool-buildin.\n * Extensions (e.g. builtin) must provide real inputSchema/outputSchema in their manifest.\n */\nexport function enrichSpecWithCanonicalSchema(spec: ToolSpec): ToolSpec {\n  return spec;\n}\n"]}

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

@@ -0,0 +1,68 @@
+import type { Capability, ToolKind, ToolSpec } from "../types/ToolSpec.js";
+/**
+ * Search query for tools.
+ */
+export interface ToolSearchQuery {
+    /** Text search in name/description/tags */
+    text?: string;
+    /** Filter by tool kind */
+    kind?: ToolKind;
+    /** Filter by required capabilities */
+    capabilities?: Capability[];
+    /** Filter by tags */
+    tags?: string[];
+}
+/**
+ * Tool Registry: manages tool registration, lookup, and search.
+ * Supports both static registration and dynamic discovery via adapters.
+ */
+export declare class ToolRegistry {
+    private readonly tools;
+    private readonly tagIndex;
+    private readonly kindIndex;
+    /**
+     * Register a single tool spec.
+     * Overwrites if same name already exists.
+     */
+    register(spec: ToolSpec): void;
+    /**
+     * Register multiple tool specs at once.
+     */
+    bulkRegister(specs: ToolSpec[]): void;
+    /**
+     * Unregister a tool by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a tool spec by name (name is normalized before lookup).
+     */
+    get(name: string): ToolSpec | undefined;
+    /**
+     * Check if a tool exists (name is normalized before lookup).
+     */
+    has(name: string): boolean;
+    /**
+     * Search tools by query.
+     */
+    search(query: ToolSearchQuery): ToolSpec[];
+    /**
+     * List all registered tool names.
+     */
+    list(): string[];
+    /**
+     * Get count of registered tools.
+     */
+    get size(): number;
+    /**
+     * Export a snapshot of all registered tools (for debugging/routing).
+     */
+    snapshot(): ToolSpec[];
+    /**
+     * Clear all registered tools.
+     */
+    clear(): void;
+    private validateSpec;
+    private indexTool;
+    private deindexTool;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

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;AAG3E;;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;IAQ9B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAMrC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASjC;;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

@@ -0,0 +1,63 @@
+import { type CircuitBreakerPolicy, type BulkheadPolicy } from "cockatiel";
+/**
+ * Budget configuration for a tool or global scope.
+ */
+export interface BudgetOptions {
+    /** Default timeout in ms for tool invocations */
+    defaultTimeoutMs?: number;
+    /** Max concurrent invocations per tool */
+    maxConcurrency?: number;
+    /** Rate limit: max calls per window */
+    rateLimit?: {
+        maxCalls: number;
+        windowMs: number;
+    };
+    /** Circuit breaker config */
+    circuitBreaker?: {
+        /** Number of consecutive failures before opening */
+        threshold: number;
+        /** Half-open reset time in ms */
+        halfOpenAfterMs: number;
+    };
+}
+/**
+ * Budget manager that provides timeout, rate limiting, concurrency control,
+ * and circuit breaker per tool.
+ */
+export declare class BudgetManager {
+    private readonly defaultTimeoutMs;
+    private readonly bulkheads;
+    private readonly circuitBreakers;
+    private readonly rateLimiters;
+    private readonly options;
+    constructor(options?: BudgetOptions);
+    /**
+     * Get effective timeout for a tool invocation.
+     */
+    getTimeout(_toolName: string, contextTimeoutMs?: number): number;
+    /**
+     * Check rate limit for a tool. Returns true if allowed.
+     */
+    checkRateLimit(toolName: string): boolean;
+    /**
+     * Get or create a bulkhead (concurrency limiter) for a tool.
+     */
+    getBulkhead(toolName: string): BulkheadPolicy | undefined;
+    /**
+     * Get or create a circuit breaker for a tool.
+     */
+    getCircuitBreaker(toolName: string): CircuitBreakerPolicy | undefined;
+    /**
+     * Execute a function within budget constraints (bulkhead + circuit breaker).
+     */
+    execute<T>(toolName: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Reset all policies for a tool (useful for testing).
+     */
+    reset(toolName: string): void;
+    /**
+     * Reset all policies globally.
+     */
+    resetAll(): void;
+}
+//# sourceMappingURL=Budget.d.ts.map

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

@@ -0,0 +1,19 @@
+import type { ToolSpec } from "../types/ToolSpec.js";
+import type { ExecContext } from "../types/ToolIntent.js";
+import type { Evidence } from "../types/ToolResult.js";
+/**
+ * Options for building evidence from a tool invocation.
+ */
+export interface BuildEvidenceOptions {
+    spec: ToolSpec;
+    args: unknown;
+    result: unknown;
+    raw?: unknown;
+    ctx: ExecContext;
+    durationMs?: number;
+}
+/**
+ * Build evidence records from a tool invocation result.
+ */
+export declare function buildEvidence(options: BuildEvidenceOptions): Evidence[];
+//# sourceMappingURL=Evidence.d.ts.map

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/core/runtime/PTCRuntime.d.ts

@@ -0,0 +1,124 @@
+import type { ToolAdapter, ToolSpec } from "../types/ToolSpec.js";
+import type { ExecContext, ToolIntent } from "../types/ToolIntent.js";
+import type { ToolResult } from "../types/ToolResult.js";
+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 type { PolicyConfig } from "./PolicyEngine.js";
+import type { BudgetOptions } from "./Budget.js";
+/**
+ * PTC Runtime configuration.
+ */
+export interface PTCRuntimeConfig {
+    policy?: PolicyConfig;
+    budget?: BudgetOptions;
+    /** Include raw response in ToolResult (default: true, disable in production) */
+    includeRaw?: boolean;
+    /** Maximum retries if not specified in context (default: 2) */
+    defaultMaxRetries?: number;
+    /** Debug/logging configuration */
+    debug?: DebugOptions;
+    /** HITL: when set, tools with sideEffect external_write/destructive require human approval before execute; callback returns true/void to approve, false to deny */
+    onApprovalRequired?: (spec: import("../types/ToolSpec.js").ToolSpec, args: unknown, ctx: import("../types/ToolIntent.js").ExecContext) => Promise<boolean | void>;
+}
+/**
+ * PTC Runtime: the unified execution kernel for all tool invocations.
+ *
+ * Enforces the mandatory 9-step pipeline:
+ * 1. Resolve (Registry lookup)
+ * 2. Input Validate (AJV)
+ * 3. Defaults Enrich
+ * 4. Policy Gate
+ * 5. Budget check
+ * 6. HITL approval (if onApprovalRequired set and tool sideEffect external_write/destructive)
+ * 7. Execute (adapter.invoke())
+ * 8. Output Validate (AJV)
+ * 9. Evidence Build
+ * 10. Audit & Metrics
+ *
+ * Never throws to callers - always returns ToolResult.
+ */
+export declare class PTCRuntime {
+    private readonly registry;
+    private readonly adapters;
+    private readonly adaptersByToolName;
+    private readonly validator;
+    private readonly policy;
+    private readonly budget;
+    private readonly eventLog;
+    private readonly metrics;
+    private readonly tracing;
+    private readonly config;
+    private readonly logger;
+    constructor(options?: {
+        registry?: ToolRegistry;
+        validator?: SchemaValidator;
+        policy?: PolicyEngine;
+        budget?: BudgetManager;
+        eventLog?: EventLog;
+        metrics?: Metrics;
+        tracing?: Tracing;
+        config?: PTCRuntimeConfig;
+    });
+    /**
+     * Register an adapter for a tool kind.
+     */
+    registerAdapter(adapter: ToolAdapter): void;
+    /**
+     * Bind an adapter to exact tool keys (full package path + tool path).
+     * This avoids collisions when multiple extensions share the same kind.
+     */
+    registerAdapterForTools(toolNames: string[], adapter: ToolAdapter): void;
+    /**
+     * Get an adapter by kind (e.g. "mcp"). Use to set MCP client via adapter.setClient().
+     */
+    getAdapter(kind: string): ToolAdapter | undefined;
+    /**
+     * Get the tool registry.
+     */
+    getRegistry(): ToolRegistry;
+    /**
+     * Get the event log.
+     */
+    getEventLog(): EventLog;
+    /**
+     * Get the metrics collector.
+     */
+    getMetrics(): Metrics;
+    /**
+     * Get the tracing system.
+     */
+    getTracing(): Tracing;
+    /**
+     * Invoke a tool through the PTC pipeline.
+     * Never throws - always returns a structured ToolResult.
+     */
+    invoke(intent: ToolIntent, ctx: ExecContext): Promise<ToolResult>;
+    /**
+     * Search for tools in the registry.
+     */
+    searchTools(query: string, filters?: {
+        kind?: string;
+        capabilities?: string[];
+        tags?: string[];
+    }): ToolSpec[];
+    /**
+     * Get the schema for a tool.
+     */
+    getToolSchema(toolName: string): {
+        input: object;
+        output: object;
+    } | undefined;
+    private getPipelineDeps;
+    private getObservabilityDeps;
+    private beginInvokeSpan;
+    private runInvokePipeline;
+    private buildInvokeSuccessResult;
+    private buildDryRunResult;
+}
+//# sourceMappingURL=PTCRuntime.d.ts.map

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/core/runtime/PTCRuntimeObservability.d.ts

@@ -0,0 +1,26 @@
+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";
+export interface ObservabilityDependencies {
+    eventLog: EventLog;
+    metrics: Metrics;
+    tracing: Tracing;
+    logger: Logger;
+}
+/**
+ * Emit TOOL_CALLED event.
+ */
+export declare function emitToolCalled(intent: ToolIntent, ctx: ExecContext, deps: ObservabilityDependencies): void;
+/**
+ * Record successful tool invocation.
+ */
+export declare function recordSuccess(spec: ToolSpec, durationMs: number, _evidence: Evidence[], spanId: string, deps: ObservabilityDependencies): void;
+/**
+ * Handle error and return ToolResult.
+ */
+export declare function handleError(error: unknown, intent: ToolIntent, ctx: ExecContext, durationMs: number, spanId: string, deps: ObservabilityDependencies): ToolResult;
+//# sourceMappingURL=PTCRuntimeObservability.d.ts.map

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/core/runtime/PTCRuntimePipeline.d.ts

@@ -0,0 +1,69 @@
+import type { ToolSpec } from "../types/ToolSpec.js";
+import type { ExecContext } from "../types/ToolIntent.js";
+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";
+/** 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 {
+    registry: {
+        get(name: string): ToolSpec | undefined;
+        snapshot(): ToolSpec[];
+    };
+    adapters: Map<string, ToolAdapter>;
+    adaptersByToolName: Map<string, ToolAdapter>;
+    validator: SchemaValidator;
+    policy: PolicyEngine;
+    budget: BudgetManager;
+    eventLog: EventLog;
+    metrics: Metrics;
+    tracing: Tracing;
+    logger: Logger;
+    defaultMaxRetries?: number;
+    /** HITL: when set, tools with sideEffect external_write/destructive require human approval before execute */
+    onApprovalRequired?: OnApprovalRequired;
+}
+/**
+ * Pipeline step: Resolve tool from registry (tool name is normalized before lookup).
+ */
+export declare function resolveTool(toolName: string, registry: PipelineDependencies["registry"]): ToolSpec;
+/**
+ * Pipeline step: Normalize common input aliases so LLM typos (e.g. "q" for "query") work.
+ * Uses INPUT_ALIASES and the tool's required keys; no tool name checks.
+ * Runs before validation so schema sees the canonical keys.
+ */
+export declare function normalizeInputAliases(spec: ToolSpec, args: unknown): unknown;
+/**
+ * Pipeline step: Validate input against schema.
+ */
+export declare function validateInput(spec: ToolSpec, args: unknown, validator: SchemaValidator): unknown;
+/**
+ * Pipeline step: Enrich args with defaults from schema.
+ */
+export declare function enrichDefaults(spec: ToolSpec, args: unknown, validator: SchemaValidator): unknown;
+/**
+ * Pipeline step: Enforce policy checks.
+ */
+export declare function enforcePolicy(spec: ToolSpec, args: unknown, ctx: ExecContext, deps: Pick<PipelineDependencies, "policy" | "eventLog" | "metrics" | "tracing">): void;
+/**
+ * Pipeline step: Human-in-the-loop approval for external_write/destructive tools.
+ * When onApprovalRequired is set, waits for callback resolve(true/void) before continuing; resolve(false) or reject throws HITL_DENIED.
+ */
+export declare function requireHumanApproval(spec: ToolSpec, args: unknown, ctx: ExecContext, deps: Pick<PipelineDependencies, "onApprovalRequired" | "eventLog" | "logger">): Promise<void>;
+/**
+ * Pipeline step: Execute tool with budget, retry, and timeout.
+ */
+export declare function executeWithBudget(spec: ToolSpec, args: unknown, ctx: ExecContext, spanId: string, deps: PipelineDependencies): Promise<{
+    result: unknown;
+    raw?: unknown;
+}>;
+/**
+ * Pipeline step: Validate output against schema.
+ */
+export declare function validateOutput(spec: ToolSpec, result: unknown, validator: SchemaValidator): unknown;
+//# sourceMappingURL=PTCRuntimePipeline.d.ts.map

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

@@ -0,0 +1,67 @@
+import type { Capability, ToolSpec } from "../types/ToolSpec.js";
+import type { ExecContext } from "../types/ToolIntent.js";
+/**
+ * Policy configuration for the engine.
+ */
+export interface PolicyConfig {
+    /** File system sandbox paths (allowed write directories) */
+    sandboxPaths?: string[];
+    /** Allowed URL patterns (regex strings) */
+    urlAllowlist?: string[];
+    /** Denied URL patterns (regex strings) */
+    urlDenylist?: string[];
+    /** SQL patterns that are denied (e.g., DROP, TRUNCATE) */
+    deniedSqlPatterns?: string[];
+    /** Network allowed domains */
+    allowedDomains?: string[];
+    /** Whether to require explicit permission for danger:destructive */
+    requireExplicitDangerPermission?: boolean;
+}
+/**
+ * Result of a policy check.
+ */
+export interface PolicyCheckResult {
+    allowed: boolean;
+    reason?: string;
+    missingCapabilities?: Capability[];
+}
+/**
+ * Policy engine for capability gating, parameter security, and access control.
+ */
+export declare class PolicyEngine {
+    private readonly config;
+    constructor(config?: PolicyConfig);
+    /**
+     * Enforce all policy checks. Throws PolicyDeniedError if denied.
+     */
+    enforce(spec: ToolSpec, args: unknown, ctx: ExecContext): void;
+    /**
+     * Check all policies without throwing.
+     */
+    check(spec: ToolSpec, args: unknown, ctx: ExecContext): PolicyCheckResult;
+    /**
+     * Check that context permissions cover tool capabilities.
+     */
+    private checkCapabilities;
+    /**
+     * Check parameter-level security constraints.
+     */
+    private checkParameters;
+    private checkFilePaths;
+    private checkUrls;
+    private checkSql;
+    private checkDomains;
+    /**
+     * Extract string values from args matching given key patterns.
+     */
+    private extractStringValues;
+}
+/**
+ * Error thrown when policy denies execution.
+ */
+export declare class PolicyDeniedError extends Error {
+    readonly missingCapabilities?: Capability[] | undefined;
+    readonly kind = "POLICY_DENIED";
+    constructor(message: string, missingCapabilities?: Capability[] | undefined);
+}
+//# sourceMappingURL=PolicyEngine.d.ts.map

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

@@ -0,0 +1,33 @@
+/**
+ * Retry configuration.
+ */
+export interface RetryOptions {
+    /** Maximum number of retries (default: 2) */
+    maxRetries?: number;
+    /** Base delay in ms for exponential backoff (default: 1000) */
+    baseDelayMs?: number;
+    /** Maximum delay in ms (default: 10000) */
+    maxDelayMs?: number;
+    /** Jitter factor 0-1 (default: 0.1) */
+    jitter?: number;
+    /** Error filter: return true to retry, false to abort */
+    shouldRetry?: (error: Error) => boolean;
+    /** Callback on each retry attempt */
+    onRetry?: (error: Error, attempt: number) => void;
+}
+/**
+ * Determine if an error is retryable.
+ */
+export declare function isRetryable(error: unknown): boolean;
+/**
+ * Execute a function with retry logic using exponential backoff.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Create a tagged error with a kind field for retry classification.
+ */
+export declare function createTaggedError(kind: string, message: string, details?: unknown): Error & {
+    kind: string;
+    details?: unknown;
+};
+//# sourceMappingURL=Retry.d.ts.map

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

@@ -0,0 +1,42 @@
+import { type ErrorObject } from "ajv";
+/**
+ * Schema validation result.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors?: ErrorObject[];
+    data?: unknown;
+}
+/**
+ * AJV-based JSON Schema validator with coercion and default enrichment.
+ */
+export declare class SchemaValidator {
+    private readonly ajv;
+    private readonly cache;
+    constructor();
+    /**
+     * Validate data against a JSON Schema.
+     * Coerces types and applies defaults in-place.
+     */
+    validate(schema: object, data: unknown): ValidationResult;
+    /**
+     * Validate and return coerced data, or throw a descriptive error.
+     */
+    validateOrThrow(schema: object, data: unknown, context: string): unknown;
+    /**
+     * Apply default values from schema to data without full validation.
+     */
+    enrichDefaults(schema: object, data: unknown): unknown;
+    private getOrCompile;
+    /** Ensure schema is AJV-compatible (required = string[], nullable handled via type). */
+    private normalizeSchema;
+    private normalizeSchemaRec;
+}
+/**
+ * Error thrown on schema validation failure.
+ */
+export declare class SchemaValidationError extends Error {
+    readonly errors: ErrorObject[];
+    constructor(message: string, errors: ErrorObject[]);
+}
+//# sourceMappingURL=SchemaValidator.d.ts.map

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/toolObservation.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult } from "../types/ToolResult.js";
+export declare const PTC_FEEDBACK_MARKER = "__PTC_FEEDBACK__:";
+export declare function extractObservationText(value: unknown): string | null;
+export declare function toToolObservationText(result: ToolResult, opts?: {
+    includeFeedbackMarker?: boolean;
+}): string;
+//# sourceMappingURL=toolObservation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolObservation.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/toolObservation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAWvD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASpE;AAOD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,IAAI,GAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,MAAM,CAcR"}