agentfootprint 1.23.0 → 2.1.0

package/dist/types/stages/helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/stages/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,CAgB7E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,OAAO,EAAE,GAClB,OAAO,CAAC,OAAO,EAAE,CAAC,CA4BpB"}

package/dist/types/stages/index.d.ts

@@ -1,8 +0,0 @@
-export { createCallLLMStage } from './callLLM';
-export { parseResponseStage } from './parseResponse';
-export { finalizeStage } from './finalize';
-export { normalizeAdapterResponse, executeToolCalls } from './helpers';
-export { createRetrieveStage } from './retrieve';
-export { augmentPromptStage } from './augmentPrompt';
-export { runnerAsStage } from './runnerAsStage';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/stages/parseResponse.d.ts

@@ -1,8 +0,0 @@
-/**
- * ParseResponse stage — extract ParsedResponse from AdapterResult.
- * Also appends assistant message to conversation history.
- */
-import type { TypedScope } from 'footprintjs';
-import type { BaseLLMState } from '../scope/types';
-export declare function parseResponseStage(scope: TypedScope<BaseLLMState>): void;
-//# sourceMappingURL=parseResponse.d.ts.map

package/dist/types/stages/parseResponse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseResponse.d.ts","sourceRoot":"","sources":["../../../src/stages/parseResponse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,GAAG,IAAI,CAyBxE"}

package/dist/types/stages/retrieve.d.ts

@@ -1,14 +0,0 @@
-/**
- * Retrieve stage — calls retriever provider, writes RetrievalResult to scope.
- *
- * Context-engineering emit: after retrieval, fires
- * `agentfootprint.context.rag.chunks` so Lens can tag the Agent's
- * Messages slot with "🔍 N chunks — top score X.XX" on the iteration
- * that received the injection. This is the teaching surface: students
- * see *what* RAG added to the prompt, not just that RAG "ran".
- */
-import type { TypedScope } from 'footprintjs';
-import type { RetrieverProvider, RetrieveOptions } from '../types';
-import type { RAGState } from '../scope/types';
-export declare function createRetrieveStage(retriever: RetrieverProvider, options?: RetrieveOptions): (scope: TypedScope<RAGState>) => Promise<void>;
-//# sourceMappingURL=retrieve.d.ts.map

package/dist/types/stages/retrieve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../../../src/stages/retrieve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,eAAe,WACpE,WAAW,QAAQ,CAAC,mBAkB1C"}

package/dist/types/stages/runnerAsStage.d.ts

@@ -1,18 +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.
- */
-import type { TypedScope } from 'footprintjs';
-import type { AgentStageConfig } from '../types';
-import type { MultiAgentState } from '../scope/types';
-/**
- * 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 declare function runnerAsStage(config: AgentStageConfig): (scope: TypedScope<MultiAgentState>) => Promise<void>;
-//# sourceMappingURL=runnerAsStage.d.ts.map

package/dist/types/stages/runnerAsStage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runnerAsStage.d.ts","sourceRoot":"","sources":["../../../src/stages/runnerAsStage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,WAC/B,WAAW,eAAe,CAAC,KAAG,QAAQ,IAAI,CAAC,CAsCjE"}

package/dist/types/stream.barrel.d.ts

@@ -1,19 +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';
-export type { AgentStreamEvent, AgentStreamEventHandler, StreamEvent, StreamEventHandler, } from './streaming';
-//# sourceMappingURL=stream.barrel.d.ts.map

package/dist/types/stream.barrel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.barrel.d.ts","sourceRoot":"","sources":["../../src/stream.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/types/streaming/EventDispatcher.d.ts

@@ -1,42 +0,0 @@
-/**
- * EventDispatcher — persistent observer list for a runner.
- *
- * Every runner (Agent, LLMCall, RAG, Swarm, FlowChart, Parallel,
- * Conditional) holds one of these. Consumers subscribe via
- * `runner.observe(handler)` and the dispatcher calls each observer
- * for every AgentStreamEvent that flows through the run.
- *
- * The dispatcher itself is cheap to hold (empty Set + 2 methods).
- * Dispatching to observers error-isolates each callback: a broken
- * consumer callback can NEVER crash the agent run.
- *
- * Bridges to footprintjs's emit channel via `createStreamEventRecorder`:
- * the runner attaches the recorder to its executor once, and the
- * recorder calls `dispatcher.dispatch(event)` for every in-chart
- * stream event. Turn-level events (`turn_start` / `turn_end`) fire
- * directly via `dispatcher.dispatch(...)` from the runner before and
- * after `executor.run()`.
- */
-import type { AgentStreamEvent, AgentStreamEventHandler } from './StreamEmitter';
-export declare class EventDispatcher {
-    private readonly listeners;
-    /**
-     * 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: AgentStreamEventHandler): () => void;
-    /**
-     * 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: AgentStreamEvent): void;
-    /** Drop every observer. Used by runner dispose / test teardown. */
-    clear(): void;
-    /** Current observer count. Useful for tests + "no-op fast path". */
-    get size(): number;
-}
-//# sourceMappingURL=EventDispatcher.d.ts.map

package/dist/types/streaming/EventDispatcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EventDispatcher.d.ts","sourceRoot":"","sources":["../../../src/streaming/EventDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAEhE;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAOrD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAavC,mEAAmE;IACnE,KAAK,IAAI,IAAI;IAIb,oEAAoE;IACpE,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/types/streaming/StreamEmitter.d.ts

@@ -1,113 +0,0 @@
-import type { AgentPhase } from '../core';
-/**
- * AgentStreamEvent — real-time events emitted during agent execution.
- *
- * The framework emits these. The consumer renders them (CLI, web, mobile).
- * Events fire regardless of streaming mode — only `token` and `thinking`
- * require `.streaming(true)`. Tool and turn lifecycle events always fire.
- *
- * @example
- * ```typescript
- * agent.run('hello', {
- *   onEvent: (event) => {
- *     switch (event.type) {
- *       case 'token': process.stdout.write(event.content); break;
- *       case 'tool_start': console.log(`Running ${event.toolName}...`); break;
- *       case 'tool_end': console.log(`Done (${event.latencyMs}ms)`); break;
- *     }
- *   },
- * });
- * ```
- */
-export type AgentStreamEvent = {
-    type: 'turn_start';
-    userMessage: string;
-} | {
-    type: 'llm_start';
-    iteration: number;
-} | {
-    type: 'thinking';
-    content: string;
-} | {
-    type: 'token';
-    content: string;
-} | {
-    type: 'llm_end';
-    iteration: number;
-    toolCallCount: number;
-    content: string;
-    model?: string;
-    latencyMs: number;
-    /** Token accounting reported by the provider. Forwarded verbatim
-     *  so consumers (Lens, billing, analytics) can tally without
-     *  having to subscribe to the richer `agentfootprint.llm.response`
-     *  event. */
-    usage?: {
-        inputTokens?: number;
-        outputTokens?: number;
-    };
-    /** Provider's stop-reason / finish-reason string
-     *  (e.g. "end_turn", "tool_use", "max_tokens"). */
-    stopReason?: string;
-} | {
-    type: 'tool_start';
-    toolName: string;
-    toolCallId: string;
-    args: Record<string, unknown>;
-} | {
-    type: 'tool_end';
-    toolName: string;
-    toolCallId: string;
-    /** Raw tool result — may contain PII. Apply your own redaction before logging/displaying. */
-    result: string;
-    error?: boolean;
-    latencyMs: number;
-} | {
-    type: 'turn_end';
-    content: string;
-    iterations: number;
-    paused?: boolean;
-    /**
-     * Why the turn ended. Absent when the LLM chose to stop normally.
-     *   - 'maxIterations': safeDecider force-finalized at the iteration cap.
-     *   - 'paused':        the agent paused for human input (ask_human). Paired
-     *                      with `paused: true`; the `reason` variant lets
-     *                      consumers switch on a single field instead of two.
-     * Future reasons can be added without breaking consumers (optional field).
-     */
-    reason?: 'maxIterations' | 'paused';
-} | {
-    type: 'error';
-    phase: AgentPhase;
-    message: string;
-};
-export type AgentStreamEventHandler = (event: AgentStreamEvent) => void;
-/**
- * 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 declare class StreamEmitter {
-    private handlers;
-    on(handler: AgentStreamEventHandler): () => void;
-    emit(event: AgentStreamEvent): void;
-}
-/**
- * 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 declare class SSEFormatter {
-    static format(event: AgentStreamEvent): string;
-    static formatAll(events: AgentStreamEvent[]): string;
-}
-/** @deprecated Use AgentStreamEvent instead. */
-export type StreamEvent = AgentStreamEvent;
-/** @deprecated Use AgentStreamEventHandler instead. */
-export type StreamEventHandler = AgentStreamEventHandler;
-//# sourceMappingURL=StreamEmitter.d.ts.map

package/dist/types/streaming/StreamEmitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamEmitter.d.ts","sourceRoot":"","sources":["../../../src/streaming/StreamEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB;;;iBAGa;IACb,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD;uDACmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC3F;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,QAAQ,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAExE;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAiC;IAEjD,EAAE,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAOhD,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;CASpC;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAI9C,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM;CAGrD;AAGD,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAC3C,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,CAAC"}

package/dist/types/streaming/StreamEventRecorder.d.ts

@@ -1,52 +0,0 @@
-/**
- * StreamEventRecorder — internal plumbing that translates stream events
- * emitted on the footprintjs emit channel into the public
- * `AgentStreamEventHandler` callback shape.
- *
- * Why: agentfootprint's public API surface offers
- * `agent.run(msg, { onEvent })` — a single callback for LLM / tool /
- * turn lifecycle events. Internally those events originate in stages
- * that should NOT close over per-run callbacks (closures in stage code
- * prevent chart caching). The footprintjs-inventor answer for
- * "per-run observer that reaches every stage at every depth" is the
- * recorder system — specifically the emit channel for structured events.
- *
- * Stages emit with a uniform name scheme:
- *
- *   `agentfootprint.stream.llm_start`
- *   `agentfootprint.stream.llm_end`
- *   `agentfootprint.stream.token`
- *   `agentfootprint.stream.thinking`
- *   `agentfootprint.stream.tool_start`
- *   `agentfootprint.stream.tool_end`
- *
- * with the full `AgentStreamEvent` object as the payload. This recorder
- * reads the payload and forwards to the user's callback — zero closure
- * capture inside stages, chart becomes a pure declarative structure.
- *
- * Turn-level events (`turn_start`, `turn_end`) are NOT emitted — they
- * fire from `AgentRunner` before / after `executor.run()`, outside any
- * chart execution. `AgentRunner` dispatches those directly to the
- * caller's handler.
- */
-import type { EmitRecorder } from 'footprintjs';
-import type { AgentStreamEventHandler } from './StreamEmitter';
-/** Prefix all in-chart stream emits share. */
-export declare 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 declare const CONTEXT_EMIT_PREFIX = "agentfootprint.context.";
-export declare function createStreamEventRecorder(handler: AgentStreamEventHandler, id?: string): EmitRecorder;
-//# sourceMappingURL=StreamEventRecorder.d.ts.map

package/dist/types/streaming/StreamEventRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamEventRecorder.d.ts","sourceRoot":"","sources":["../../../src/streaming/StreamEventRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAE3D;;;;;;;;;GASG;AACH;;;2EAG2E;AAC3E,eAAO,MAAM,mBAAmB,4BAA4B,CAAC;AAE7D,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,uBAAuB,EAChC,EAAE,SAA0B,GAC3B,YAAY,CAgCd"}

package/dist/types/streaming/index.d.ts

@@ -1,5 +0,0 @@
-export { StreamEmitter, SSEFormatter } from './StreamEmitter';
-export type { AgentStreamEvent, AgentStreamEventHandler, StreamEvent, StreamEventHandler, } from './StreamEmitter';
-export { createStreamEventRecorder, STREAM_EMIT_PREFIX } from './StreamEventRecorder';
-export { EventDispatcher } from './EventDispatcher';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/streaming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/subflows/index.d.ts

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

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

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

package/dist/types/tools/ToolRegistry.d.ts

@@ -1,57 +0,0 @@
-/**
- * ToolRegistry — register, lookup, and format tools for LLM function calling.
- */
-import type { ToolDefinition, ToolDefinitionInput, LLMToolDescription } from '../types';
-export declare class ToolRegistry {
-    private readonly tools;
-    /** Register a tool. Throws if ID already registered. */
-    register(tool: ToolDefinition): 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: string): this;
-    /** Get a tool by ID. */
-    get(id: string): ToolDefinition | undefined;
-    /** Check if a tool is registered. */
-    has(id: string): boolean;
-    /** Get all registered tool IDs. */
-    ids(): string[];
-    /** Get all registered tools. */
-    all(): ToolDefinition[];
-    /** Format tools for LLM function calling (OpenAI-compatible schema). */
-    formatForLLM(toolIds?: string[]): LLMToolDescription[];
-    /** Number of registered tools. */
-    get size(): number;
-}
-/**
- * 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 declare function defineTool(tool: ToolDefinitionInput): ToolDefinition;
-//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/types/tools/ToolRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGxF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAQpC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B,wBAAwB;IACxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C,qCAAqC;IACrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,mCAAmC;IACnC,GAAG,IAAI,MAAM,EAAE;IAIf,gCAAgC;IAChC,GAAG,IAAI,cAAc,EAAE;IAIvB,wEAAwE;IACxE,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE;IAgBtD,kCAAkC;IAClC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,cAAc,CAcpE"}

package/dist/types/tools/askHuman.d.ts

@@ -1,39 +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');
- * }
- * ```
- */
-import type { ToolDefinition, ToolResult } from '../types/tools';
-/** Marker on ToolResult indicating this is an ask_human pause. Not globally reachable — only importable from this module. */
-export declare const ASK_HUMAN_MARKER: unique symbol;
-export interface AskHumanResult extends ToolResult {
-    /** @internal Marker for pause detection in tool execution stage. */
-    readonly [ASK_HUMAN_MARKER]: true;
-    /** The question asked by the LLM. */
-    readonly question: string;
-}
-/** Check if a tool result is an ask_human pause. */
-export declare function isAskHumanResult(result: ToolResult): result is AskHumanResult;
-/**
- * Create the ask_human tool definition.
- *
- * @param description - Custom description for the LLM (optional).
- */
-export declare function askHuman(description?: string): ToolDefinition;
-//# sourceMappingURL=askHuman.d.ts.map

package/dist/types/tools/askHuman.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"askHuman.d.ts","sourceRoot":"","sources":["../../../src/tools/askHuman.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjE,6HAA6H;AAC7H,eAAO,MAAM,gBAAgB,eAAqB,CAAC;AAEnD,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,oEAAoE;IACpE,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC;IAClC,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI,cAAc,CAO7E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,CA2B7D"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","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/types/tools/validateInput.d.ts

@@ -1,29 +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.
- */
-export interface ValidationError {
-    readonly path: string;
-    readonly message: string;
-}
-export interface ValidationResult {
-    readonly valid: boolean;
-    readonly errors: readonly ValidationError[];
-}
-/**
- * Validate tool arguments against a JSON Schema.
- * Returns { valid: true } or { valid: false, errors: [...] }.
- */
-export declare function validateToolInput(args: Record<string, unknown>, schema: Record<string, unknown>): ValidationResult;
-/**
- * Format validation errors as a string for the LLM tool result.
- */
-export declare function formatValidationErrors(errors: readonly ValidationError[]): string;
-//# sourceMappingURL=validateInput.d.ts.map

package/dist/types/tools/validateInput.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validateInput.d.ts","sourceRoot":"","sources":["../../../src/tools/validateInput.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB,CA0ClB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAEjF"}

package/dist/types/tools/zodToJsonSchema.d.ts

@@ -1,9 +0,0 @@
-/**
- * Minimal Zod-to-JSON-Schema converter. Duck-typed — no zod dependency.
- * Handles: object, string, number, boolean, array, enum, optional, default.
- * @internal
- */
-export declare function zodToJsonSchema(zodSchema: any): Record<string, unknown>;
-/** Duck-type check: is this a Zod schema? */
-export declare function isZodSchema(value: unknown): boolean;
-//# sourceMappingURL=zodToJsonSchema.d.ts.map

package/dist/types/tools/zodToJsonSchema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zodToJsonSchema.d.ts","sourceRoot":"","sources":["../../../src/tools/zodToJsonSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDvE;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOnD"}

package/dist/types/tools.js

@@ -1,6 +0,0 @@
-"use strict";
-/**
- * Tool definitions for agent function calling.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

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

package/dist/types/types/adapter.d.ts

@@ -1,36 +0,0 @@
-/**
- * Adapter result — discriminated union for provider responses.
- * Adapters normalize any provider's response into one of these shapes.
- */
-import type { ToolCall, TokenUsage } from './index';
-/** LLM returned a final text response. */
-export interface AdapterFinalResult {
-    readonly type: 'final';
-    readonly content: string;
-    readonly usage?: TokenUsage;
-    readonly model?: string;
-}
-/** LLM requested tool calls. */
-export interface AdapterToolResult {
-    readonly type: 'tools';
-    readonly content: string;
-    readonly toolCalls: ToolCall[];
-    readonly usage?: TokenUsage;
-    readonly model?: string;
-}
-/** LLM call failed. */
-export interface AdapterErrorResult {
-    readonly type: 'error';
-    readonly code: string;
-    readonly message: string;
-    readonly retryable: boolean;
-    readonly originalError?: unknown;
-}
-export type AdapterResult = AdapterFinalResult | AdapterToolResult | AdapterErrorResult;
-/** Well-known scope paths for adapter stages. */
-export declare const ADAPTER_PATHS: {
-    readonly REQUEST: "adapterRequest";
-    readonly RESPONSE: "adapterRawResponse";
-    readonly RESULT: "adapterResult";
-};
-//# sourceMappingURL=adapter.d.ts.map

package/dist/types/types/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/types/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpD,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uBAAuB;AACvB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAExF,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;CAIhB,CAAC"}

package/dist/types/types/agent.d.ts

@@ -1,44 +0,0 @@
-/**
- * Agent configuration and result types.
- */
-import type { FlowChart } from 'footprintjs';
-import type { Message } from './messages';
-export interface AgentConfig {
-    readonly name: string;
-    readonly systemPrompt?: string;
-    readonly maxIterations: number;
-    readonly toolIds: string[];
-}
-export interface AgentBuildResult {
-    readonly flowChart: FlowChart<unknown, unknown>;
-    readonly name: string;
-    readonly config: AgentConfig;
-}
-export interface AgentResult {
-    readonly content: string;
-    readonly messages: Message[];
-    readonly iterations: number;
-    /** True when the agent paused (ask_human tool). Call agent.resume() to continue. */
-    readonly paused?: boolean;
-    /** Pause data from ask_human (question + toolCallId). */
-    readonly pauseData?: {
-        question: string;
-        toolCallId: string;
-    };
-    /**
-     * True when the turn ended because the agent hit its iteration cap
-     * (safeDecider force-routed to Finalize). The LLM did not choose to stop —
-     * it was cut off. Render a distinct state so users understand the loop
-     * didn't complete normally.
-     */
-    readonly maxIterationsReached?: boolean;
-}
-export interface AgentRunOptions {
-    /** User message to send. */
-    readonly message: string;
-    /** Abort signal for cancellation. */
-    readonly signal?: AbortSignal;
-    /** Timeout in milliseconds. */
-    readonly timeoutMs?: number;
-}
-//# sourceMappingURL=agent.d.ts.map

package/dist/types/types/agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}