agentfootprint 1.23.0 → 2.0.1

package/dist/esm/stages/runnerAsStage.js

@@ -1,66 +0,0 @@
-/**
- * runnerAsStage — wraps any RunnerLike as a flowchart stage function.
- *
- * This is the core primitive for multi-agent composition. Any runner
- * (Agent, RAG, LLMCall, or user-built) can become a stage in a pipeline.
- */
-/**
- * Creates a stage function that executes a runner and writes its result to scope.
- *
- * Default behavior:
- * - Input: reads previous agent's output (or pipelineInput for first agent)
- * - Output: writes to 'result' and records agent entry in agentResults
- */
-export function runnerAsStage(config) {
-    return async (scope) => {
-        const state = buildStateSnapshot(scope);
-        // Default: prefer previous agent's result, fall back to pipeline input
-        const input = config.inputMapper
-            ? config.inputMapper(state)
-            : state.result ?? state.pipelineInput ?? '';
-        const startTime = Date.now();
-        const env = scope.$getEnv();
-        const signal = env?.signal;
-        const timeoutMs = env?.timeoutMs;
-        const output = await config.runner.run(input, { signal, timeoutMs });
-        const latencyMs = Date.now() - startTime;
-        // Apply output mapper or default write
-        if (config.outputMapper) {
-            const mapped = config.outputMapper(output, state);
-            for (const [key, value] of Object.entries(mapped)) {
-                scope.$setValue(key, value);
-            }
-        }
-        else {
-            scope.result = output.content;
-        }
-        // Record agent result entry
-        const entry = {
-            id: config.id,
-            name: config.name,
-            content: output.content,
-            latencyMs,
-            narrative: config.runner.getNarrativeEntries?.().map((e) => e.text) ?? undefined,
-        };
-        const existing = scope.agentResults ?? [];
-        scope.agentResults = [...existing, entry];
-    };
-}
-/** Build a plain object snapshot of scope state for mappers. */
-function buildStateSnapshot(scope) {
-    const result = {};
-    // Read well-known keys that mappers might need
-    for (const key of [
-        'pipelineInput',
-        'result',
-        'agentResults',
-        'messages',
-        'systemPrompt',
-    ]) {
-        const val = scope.$getValue(key);
-        if (val !== undefined)
-            result[key] = val;
-    }
-    return result;
-}
-//# sourceMappingURL=runnerAsStage.js.map

package/dist/esm/stages/runnerAsStage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runnerAsStage.js","sourceRoot":"","sources":["../../../src/stages/runnerAsStage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAwB;IACpD,OAAO,KAAK,EAAE,KAAkC,EAAiB,EAAE;QACjE,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACxC,uEAAuE;QACvE,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW;YAC9B,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAE,KAAK,CAAC,MAAiB,IAAK,KAAK,CAAC,aAAwB,IAAI,EAAE,CAAC;QAEtE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC;QAC3B,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,CAAC;QAEjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEzC,uCAAuC;QACvC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAClD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;QAChC,CAAC;QAED,4BAA4B;QAC5B,MAAM,KAAK,GAAqB;YAC9B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS;YACT,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,SAAS;SACjF,CAAC;QAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;QAC1C,KAAK,CAAC,YAAY,GAAG,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,SAAS,kBAAkB,CAAC,KAAkC;IAC5D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,+CAA+C;IAC/C,KAAK,MAAM,GAAG,IAAI;QAChB,eAAe;QACf,QAAQ;QACR,cAAc;QACd,UAAU;QACV,cAAc;KACN,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/stream.barrel.js

@@ -1,18 +0,0 @@
-/**
- * agentfootprint/stream — See agents work in real-time.
- *
- * 9-event discriminated union for CLI/web/mobile consumers.
- * SSEFormatter for Server-Sent Events.
- *
- * @example
- * ```typescript
- * import { SSEFormatter } from 'agentfootprint/stream';
- * import type { AgentStreamEvent } from 'agentfootprint/stream';
- *
- * await agent.run('hello', {
- *   onEvent: (e: AgentStreamEvent) => res.write(SSEFormatter.format(e)),
- * });
- * ```
- */
-export { StreamEmitter, SSEFormatter } from './streaming';
-//# sourceMappingURL=stream.barrel.js.map

package/dist/esm/stream.barrel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.barrel.js","sourceRoot":"","sources":["../../src/stream.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/streaming/EventDispatcher.js

@@ -1,44 +0,0 @@
-export class EventDispatcher {
-    listeners = new Set();
-    /**
-     * Subscribe a handler for the lifetime of the returned unsubscribe
-     * function. Idempotent — adding the same handler twice still only
-     * fires once per event. Safe to call during a run (the dispatcher
-     * uses a snapshot of listeners when dispatching).
-     */
-    observe(handler) {
-        this.listeners.add(handler);
-        return () => {
-            this.listeners.delete(handler);
-        };
-    }
-    /**
-     * Deliver an event to every subscribed handler. Each callback is
-     * wrapped in try/catch so a throwing observer doesn't propagate
-     * into the agent run — matches the existing error-isolation
-     * contract used by `createStreamEventRecorder`.
-     */
-    dispatch(event) {
-        if (this.listeners.size === 0)
-            return;
-        // Snapshot to allow observers to subscribe / unsubscribe during
-        // dispatch without mutating the live set we're iterating over.
-        for (const listener of [...this.listeners]) {
-            try {
-                listener(event);
-            }
-            catch {
-                /* swallow — a broken consumer callback must never crash a run */
-            }
-        }
-    }
-    /** Drop every observer. Used by runner dispose / test teardown. */
-    clear() {
-        this.listeners.clear();
-    }
-    /** Current observer count. Useful for tests + "no-op fast path". */
-    get size() {
-        return this.listeners.size;
-    }
-}
-//# sourceMappingURL=EventDispatcher.js.map

package/dist/esm/streaming/EventDispatcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"EventDispatcher.js","sourceRoot":"","sources":["../../../src/streaming/EventDispatcher.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,eAAe;IACT,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEhE;;;;;OAKG;IACH,OAAO,CAAC,OAAgC;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAuB;QAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACtC,gEAAgE;QAChE,+DAA+D;QAC/D,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,oEAAoE;IACpE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF"}

package/dist/esm/streaming/StreamEmitter.js

@@ -1,43 +0,0 @@
-/**
- * StreamEmitter — dispatches AgentStreamEvents to consumers.
- *
- * Error isolation: handler errors are swallowed — never break the agent pipeline.
- * This is the correct behavior for a push-to-consumer system (same as RecorderBridge).
- */
-export class StreamEmitter {
-    handlers = [];
-    on(handler) {
-        this.handlers.push(handler);
-        return () => {
-            this.handlers = this.handlers.filter((h) => h !== handler);
-        };
-    }
-    emit(event) {
-        for (const handler of this.handlers) {
-            try {
-                handler(event);
-            }
-            catch {
-                // Swallow handler errors — never break the pipeline
-            }
-        }
-    }
-}
-/**
- * SSEFormatter — converts AgentStreamEvent to Server-Sent Events text.
- *
- * @example
- * ```typescript
- * res.write(SSEFormatter.format({ type: 'token', content: 'Hello' }));
- * // event: token\ndata: {"type":"token","content":"Hello"}\n\n
- * ```
- */
-export class SSEFormatter {
-    static format(event) {
-        return `event: ${event.type}\ndata: ${JSON.stringify(event)}\n\n`;
-    }
-    static formatAll(events) {
-        return events.map(SSEFormatter.format).join('');
-    }
-}
-//# sourceMappingURL=StreamEmitter.js.map

package/dist/esm/streaming/StreamEmitter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamEmitter.js","sourceRoot":"","sources":["../../../src/streaming/StreamEmitter.ts"],"names":[],"mappings":"AAwEA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAChB,QAAQ,GAA8B,EAAE,CAAC;IAEjD,EAAE,CAAC,OAAgC;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAuB;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACvB,MAAM,CAAC,MAAM,CAAC,KAAuB;QACnC,OAAO,UAAU,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,MAA0B;QACzC,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/esm/streaming/StreamEventRecorder.js

@@ -1,55 +0,0 @@
-/** Prefix all in-chart stream emits share. */
-export const STREAM_EMIT_PREFIX = 'agentfootprint.stream.';
-/**
- * Build an `EmitRecorder` that forwards `agentfootprint.stream.*` events
- * to the user-provided callback. Errors in the callback are swallowed —
- * matches existing error-isolation behavior so a broken listener can
- * never crash the agent.
- *
- * @param id - Recorder id. Use a stable value per consumer so it's
- *             idempotent on re-attach; default is `'agentfootprint-stream'`.
- * @param handler - User callback. Invoked once per in-chart stream event.
- */
-/** Prefix for context-engineering events (RAG, Memory, Skills, Instructions).
- *  Kept separate from the stream prefix so the two classes of event are
- *  independently namespaced on the emit channel, but both forward through
- *  the same consumer callback — Lens's timeline ingests them uniformly. */
-export const CONTEXT_EMIT_PREFIX = 'agentfootprint.context.';
-export function createStreamEventRecorder(handler, id = 'agentfootprint-stream') {
-    return {
-        id,
-        onEmit(event) {
-            const isStream = event.name.startsWith(STREAM_EMIT_PREFIX);
-            const isContext = event.name.startsWith(CONTEXT_EMIT_PREFIX);
-            if (!isStream && !isContext)
-                return;
-            try {
-                if (isStream) {
-                    // Stream events carry the full AgentStreamEvent shape as payload.
-                    const streamEvent = event.payload;
-                    if (!streamEvent)
-                        return;
-                    handler(streamEvent);
-                }
-                else {
-                    // Context events carry domain-specific payloads. Forward the
-                    // emit event itself so Lens's ingest can switch on event.name
-                    // (e.g. `agentfootprint.context.rag.chunks`) and extract the
-                    // payload. Wrapping keeps AgentStreamEventHandler's signature
-                    // unchanged — consumers that only care about stream events can
-                    // ignore the context.* names naturally.
-                    handler({
-                        type: event.name,
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        payload: event.payload,
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    });
-                }
-            }
-            catch {
-                /* swallow — broken consumer callback must never crash the agent */
-            }
-        },
-    };
-}
-//# sourceMappingURL=StreamEventRecorder.js.map

package/dist/esm/streaming/StreamEventRecorder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamEventRecorder.js","sourceRoot":"","sources":["../../../src/streaming/StreamEventRecorder.ts"],"names":[],"mappings":"AAkCA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAE3D;;;;;;;;;GASG;AACH;;;2EAG2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAE7D,MAAM,UAAU,yBAAyB,CACvC,OAAgC,EAChC,EAAE,GAAG,uBAAuB;IAE5B,OAAO;QACL,EAAE;QACF,MAAM,CAAC,KAAgB;YACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;YAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC7D,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS;gBAAE,OAAO;YACpC,IAAI,CAAC;gBACH,IAAI,QAAQ,EAAE,CAAC;oBACb,kEAAkE;oBAClE,MAAM,WAAW,GAAG,KAAK,CAAC,OAAuC,CAAC;oBAClE,IAAI,CAAC,WAAW;wBAAE,OAAO;oBACzB,OAAO,CAAC,WAAW,CAAC,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,6DAA6D;oBAC7D,8DAA8D;oBAC9D,6DAA6D;oBAC7D,8DAA8D;oBAC9D,+DAA+D;oBAC/D,wCAAwC;oBACxC,OAAO,CAAC;wBACN,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,8DAA8D;wBAC9D,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,8DAA8D;qBACxD,CAAC,CAAC;gBACZ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,mEAAmE;YACrE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/streaming/index.js

@@ -1,4 +0,0 @@
-export { StreamEmitter, SSEFormatter } from './StreamEmitter';
-export { createStreamEventRecorder, STREAM_EMIT_PREFIX } from './StreamEventRecorder';
-export { EventDispatcher } from './EventDispatcher';
-//# sourceMappingURL=index.js.map

package/dist/esm/streaming/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/streaming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO9D,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/subflows/index.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.js.map

package/dist/esm/subflows/index.js.map

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

package/dist/esm/tools/ToolRegistry.js

@@ -1,102 +0,0 @@
-/**
- * ToolRegistry — register, lookup, and format tools for LLM function calling.
- */
-import { zodToJsonSchema, isZodSchema } from './zodToJsonSchema';
-export class ToolRegistry {
-    tools = new Map();
-    /** Register a tool. Throws if ID already registered. */
-    register(tool) {
-        if (this.tools.has(tool.id)) {
-            throw new Error(`ToolRegistry: tool '${tool.id}' already registered`);
-        }
-        this.tools.set(tool.id, tool);
-        return this;
-    }
-    /**
-     * Remove a tool by ID. Silently no-ops when the tool isn't registered
-     * so callers can call safely before a re-registration.
-     *
-     * Intended for builder-layer idempotent replace flows (e.g.
-     * `AgentBuilder.skills(registry)` re-mounting skill tools) — NOT for
-     * runtime tool hot-removal, which would require coordinating with the
-     * LLM's recency window.
-     */
-    unregister(id) {
-        this.tools.delete(id);
-        return this;
-    }
-    /** Get a tool by ID. */
-    get(id) {
-        return this.tools.get(id);
-    }
-    /** Check if a tool is registered. */
-    has(id) {
-        return this.tools.has(id);
-    }
-    /** Get all registered tool IDs. */
-    ids() {
-        return Array.from(this.tools.keys());
-    }
-    /** Get all registered tools. */
-    all() {
-        return Array.from(this.tools.values());
-    }
-    /** Format tools for LLM function calling (OpenAI-compatible schema). */
-    formatForLLM(toolIds) {
-        const tools = toolIds
-            ? toolIds.map((id) => {
-                const tool = this.tools.get(id);
-                if (!tool)
-                    throw new Error(`ToolRegistry: tool '${id}' not found`);
-                return tool;
-            })
-            : this.all();
-        return tools.map((tool) => ({
-            name: tool.id,
-            description: tool.description,
-            inputSchema: tool.inputSchema,
-        }));
-    }
-    /** Number of registered tools. */
-    get size() {
-        return this.tools.size;
-    }
-}
-/**
- * Define a tool inline. Accepts JSON Schema or Zod schema for `inputSchema`.
- *
- * @example JSON Schema
- * ```typescript
- * defineTool({
- *   id: 'search',
- *   description: 'Search the web',
- *   inputSchema: { type: 'object', properties: { query: { type: 'string' } }, required: ['query'] },
- *   handler: async ({ query }) => ({ content: `Results for: ${query}` }),
- * });
- * ```
- *
- * @example Zod schema (auto-converted, no zod dependency in core)
- * ```typescript
- * import { z } from 'zod';
- * defineTool({
- *   id: 'search',
- *   description: 'Search the web',
- *   inputSchema: z.object({ query: z.string().describe('Search query') }),
- *   handler: async ({ query }) => ({ content: `Results for: ${query}` }),
- * });
- * ```
- */
-export function defineTool(tool) {
-    const schema = tool.inputSchema;
-    // Duck-type Zod detection: Zod schemas have ._def and .safeParse.
-    // Convert to JSON Schema eagerly so every downstream consumer of
-    // `ToolDefinition` sees a plain object — no Zod dependency in the
-    // wire path.
-    if (isZodSchema(schema)) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return { ...tool, inputSchema: zodToJsonSchema(schema) };
-    }
-    // Already a plain object — safe to assert the narrow ToolDefinition shape.
-    return tool;
-}
-//# sourceMappingURL=ToolRegistry.js.map

package/dist/esm/tools/ToolRegistry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolRegistry.js","sourceRoot":"","sources":["../../../src/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE3D,wDAAwD;IACxD,QAAQ,CAAC,IAAoB;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,EAAE,sBAAsB,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IACxB,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,qCAAqC;IACrC,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,mCAAmC;IACnC,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,gCAAgC;IAChC,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,wEAAwE;IACxE,YAAY,CAAC,OAAkB;QAC7B,MAAM,KAAK,GAAG,OAAO;YACnB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBACjB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChC,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;gBACnE,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAEf,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,UAAU,CAAC,IAAyB;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;IAEhC,kEAAkE;IAClE,iEAAiE;IACjE,kEAAkE;IAClE,aAAa;IACb,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,8DAA8D;QAC9D,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,MAAa,CAAC,EAAE,CAAC;IAClE,CAAC;IAED,2EAA2E;IAC3E,OAAO,IAAsB,CAAC;AAChC,CAAC"}

package/dist/esm/tools/askHuman.js

@@ -1,63 +0,0 @@
-/**
- * askHuman — Built-in tool that pauses the agent loop for human input.
- *
- * When the LLM calls this tool, the agent loop pauses and creates a checkpoint.
- * The human's response is provided via agent.resume(), which continues the loop
- * with the answer as the tool result.
- *
- * @example
- * ```typescript
- * const agent = Agent.create({ provider })
- *   .system('You are helpful. Use ask_human when you need clarification.')
- *   .tool(askHuman())
- *   .build();
- *
- * const result = await agent.run('Process my refund');
- * if (result.paused) {
- *   console.log(result.pauseData.question); // "What is your order ID?"
- *   const final = await agent.resume('ORD-123');
- * }
- * ```
- */
-/** Marker on ToolResult indicating this is an ask_human pause. Not globally reachable — only importable from this module. */
-export const ASK_HUMAN_MARKER = Symbol('askHuman');
-/** Check if a tool result is an ask_human pause. */
-export function isAskHumanResult(result) {
-    return (typeof result === 'object' &&
-        result !== null &&
-        Object.getOwnPropertySymbols(result).includes(ASK_HUMAN_MARKER) &&
-        result[ASK_HUMAN_MARKER] === true);
-}
-/**
- * Create the ask_human tool definition.
- *
- * @param description - Custom description for the LLM (optional).
- */
-export function askHuman(description) {
-    return {
-        id: 'ask_human',
-        description: description ??
-            'Ask the human user a question. Use this when you need clarification, approval, or any input from the user before proceeding.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                question: {
-                    type: 'string',
-                    description: 'The question to ask the human.',
-                },
-            },
-            required: ['question'],
-        },
-        handler: async (input) => {
-            const question = String(input.question ?? '');
-            // Return a marked result — the tool execution stage detects this and pauses.
-            // The content is a placeholder; it gets replaced with the human's actual response on resume.
-            return {
-                content: `[Waiting for human response to: "${question}"]`,
-                question,
-                [ASK_HUMAN_MARKER]: true,
-            };
-        },
-    };
-}
-//# sourceMappingURL=askHuman.js.map

package/dist/esm/tools/askHuman.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"askHuman.js","sourceRoot":"","sources":["../../../src/tools/askHuman.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,6HAA6H;AAC7H,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AASnD,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC9D,MAA6C,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAC1E,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAoB;IAC3C,OAAO;QACL,EAAE,EAAE,WAAW;QACf,WAAW,EACT,WAAW;YACX,8HAA8H;QAChI,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;QACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAA2B,EAAE;YACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAC9C,6EAA6E;YAC7E,6FAA6F;YAC7F,OAAO;gBACL,OAAO,EAAE,oCAAoC,QAAQ,IAAI;gBACzD,QAAQ;gBACR,CAAC,gBAAgB,CAAC,EAAE,IAAI;aACzB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/tools/index.js

@@ -1,3 +0,0 @@
-export { ToolRegistry, defineTool } from './ToolRegistry';
-export { askHuman } from './askHuman';
-//# sourceMappingURL=index.js.map

package/dist/esm/tools/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/tools/validateInput.js

@@ -1,62 +0,0 @@
-/**
- * validateToolInput — lightweight JSON Schema validation for tool arguments.
- *
- * Validates LLM-provided tool arguments against the tool's inputSchema
- * before calling the handler. Catches malformed arguments early with
- * a clear error message fed back to the LLM.
- *
- * Supports: required fields, type checking (string, number, boolean, object, array).
- * Does NOT support: $ref, oneOf, allOf, pattern, min/max, nested validation.
- * For complex schemas, use a full validator (Ajv) in the handler.
- */
-/**
- * Validate tool arguments against a JSON Schema.
- * Returns { valid: true } or { valid: false, errors: [...] }.
- */
-export function validateToolInput(args, schema) {
-    const errors = [];
-    // Check required fields
-    const required = schema.required;
-    if (Array.isArray(required)) {
-        for (const field of required) {
-            if (args[field] === undefined || args[field] === null) {
-                errors.push({ path: field, message: `Required field '${field}' is missing.` });
-            }
-        }
-    }
-    // Check property types
-    const properties = schema.properties;
-    if (properties) {
-        for (const [key, prop] of Object.entries(properties)) {
-            const value = args[key];
-            if (value === undefined || value === null)
-                continue; // Skip optional missing fields
-            if (prop.type) {
-                const expectedType = prop.type;
-                const actualType = Array.isArray(value) ? 'array' : typeof value;
-                if (expectedType === 'integer') {
-                    if (typeof value !== 'number' || !Number.isInteger(value)) {
-                        errors.push({
-                            path: key,
-                            message: `Expected integer for '${key}', got ${actualType}.`,
-                        });
-                    }
-                }
-                else if (expectedType !== actualType) {
-                    errors.push({
-                        path: key,
-                        message: `Expected ${expectedType} for '${key}', got ${actualType}.`,
-                    });
-                }
-            }
-        }
-    }
-    return { valid: errors.length === 0, errors };
-}
-/**
- * Format validation errors as a string for the LLM tool result.
- */
-export function formatValidationErrors(errors) {
-    return errors.map((e) => `${e.path}: ${e.message}`).join('; ');
-}
-//# sourceMappingURL=validateInput.js.map

package/dist/esm/tools/validateInput.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validateInput.js","sourceRoot":"","sources":["../../../src/tools/validateInput.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAA6B,EAC7B,MAA+B;IAE/B,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAgC,CAAC;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,KAAK,eAAe,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,UAAU,GAAG,MAAM,CAAC,UAA2D,CAAC;IACtF,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS,CAAC,+BAA+B;YAEpF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC;gBAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC;gBAEjE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC1D,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,GAAG;4BACT,OAAO,EAAE,yBAAyB,GAAG,UAAU,UAAU,GAAG;yBAC7D,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;qBAAM,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;oBACvC,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,GAAG;wBACT,OAAO,EAAE,YAAY,YAAY,SAAS,GAAG,UAAU,UAAU,GAAG;qBACrE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAkC;IACvE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC"}

package/dist/esm/tools/zodToJsonSchema.js

@@ -1,66 +0,0 @@
-/**
- * Minimal Zod-to-JSON-Schema converter. Duck-typed — no zod dependency.
- * Handles: object, string, number, boolean, array, enum, optional, default.
- * @internal
- */
-export function zodToJsonSchema(zodSchema) {
-    const def = zodSchema._def;
-    if (!def)
-        return { type: 'object' };
-    switch (def.typeName) {
-        case 'ZodObject': {
-            const shape = zodSchema.shape;
-            const properties = {};
-            const required = [];
-            for (const [key, value] of Object.entries(shape)) {
-                properties[key] = zodToJsonSchema(value);
-                if (value._def?.typeName !== 'ZodOptional') {
-                    required.push(key);
-                }
-            }
-            return {
-                type: 'object',
-                properties,
-                ...(required.length > 0 ? { required } : {}),
-            };
-        }
-        case 'ZodString': {
-            const r = { type: 'string' };
-            if (def.description)
-                r.description = def.description;
-            return r;
-        }
-        case 'ZodNumber': {
-            const r = { type: 'number' };
-            if (def.description)
-                r.description = def.description;
-            return r;
-        }
-        case 'ZodBoolean':
-            return { type: 'boolean' };
-        case 'ZodArray':
-            return { type: 'array', items: zodToJsonSchema(def.type) };
-        case 'ZodEnum':
-            return { type: 'string', enum: def.values };
-        case 'ZodOptional':
-            return zodToJsonSchema(def.innerType);
-        case 'ZodDefault':
-            return zodToJsonSchema(def.innerType);
-        case 'ZodNullable': {
-            const inner = zodToJsonSchema(def.innerType);
-            return { ...inner, nullable: true };
-        }
-        case 'ZodLiteral':
-            return { const: def.value };
-        default:
-            return {};
-    }
-}
-/** Duck-type check: is this a Zod schema? */
-export function isZodSchema(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        typeof value.safeParse === 'function' &&
-        value._def !== undefined);
-}
-//# sourceMappingURL=zodToJsonSchema.js.map

package/dist/esm/tools/zodToJsonSchema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"zodToJsonSchema.js","sourceRoot":"","sources":["../../../src/tools/zodToJsonSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAAc;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEpC,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;YAC9B,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,UAAU,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAY,CAAC,CAAC;gBAChD,IAAK,KAAa,CAAC,IAAI,EAAE,QAAQ,KAAK,aAAa,EAAE,CAAC;oBACpD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU;gBACV,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C,CAAC;QACJ,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,CAAC,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACtD,IAAI,GAAG,CAAC,WAAW;gBAAE,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,CAAC,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACtD,IAAI,GAAG,CAAC,WAAW;gBAAE,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9C,KAAK,aAAa;YAChB,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,YAAY;YACf,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,KAAK,YAAY;YACf,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QAC9B;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAa,CAAC,SAAS,KAAK,UAAU;QAC7C,KAAa,CAAC,IAAI,KAAK,SAAS,CAClC,CAAC;AACJ,CAAC"}

package/dist/esm/types/adapter.js

@@ -1,11 +0,0 @@
-/**
- * Adapter result — discriminated union for provider responses.
- * Adapters normalize any provider's response into one of these shapes.
- */
-/** Well-known scope paths for adapter stages. */
-export const ADAPTER_PATHS = {
-    REQUEST: 'adapterRequest',
-    RESPONSE: 'adapterRawResponse',
-    RESULT: 'adapterResult',
-};
-//# sourceMappingURL=adapter.js.map

package/dist/esm/types/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/types/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgCH,iDAAiD;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,oBAAoB;IAC9B,MAAM,EAAE,eAAe;CACf,CAAC"}

package/dist/esm/types/agent.js

@@ -1,5 +0,0 @@
-/**
- * Agent configuration and result types.
- */
-export {};
-//# sourceMappingURL=agent.js.map

package/dist/esm/types/agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;GAEG"}