agentfootprint 1.0.0

package/dist/types/concepts/FlowChart.d.ts

@@ -0,0 +1,52 @@
+/**
+ * FlowChart — sequential composition of runners as a flowchart.
+ *
+ * The simplest multi-agent pattern: run agents in order, each feeding into the next.
+ * More complex patterns (fan-out, hierarchy, swarm) are user-built with footprintjs
+ * primitives (fork, addDeciderFunction, loopTo).
+ *
+ * Usage:
+ *   const composed = FlowChart.create()
+ *     .agent('researcher', 'Research', researchRunner)
+ *     .agent('writer', 'Write', writerRunner)
+ *     .build();
+ *   const result = await composed.run('Write about AI');
+ */
+import type { AgentStageConfig, TraversalResult } from '../types';
+import type { RunnerLike } from '../types';
+import type { AgentRecorder } from '../core';
+export declare class FlowChart {
+    private readonly agents;
+    private readonly recorders;
+    private constructor();
+    static create(): FlowChart;
+    /** Add a runner to the flowchart. Runners execute in the order added. */
+    agent(id: string, name: string, runner: RunnerLike, options?: {
+        inputMapper?: AgentStageConfig['inputMapper'];
+        outputMapper?: AgentStageConfig['outputMapper'];
+    }): this;
+    /** Attach an AgentRecorder to observe execution events. */
+    recorder(rec: AgentRecorder): this;
+    /** Build the composed flowchart and return a runner. */
+    build(): FlowChartRunner;
+}
+export declare class FlowChartRunner {
+    private readonly agents;
+    private readonly recorders;
+    private lastExecutor?;
+    private lastSpec?;
+    constructor(agents: readonly AgentStageConfig[], recorders?: AgentRecorder[]);
+    run(message: string, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<TraversalResult>;
+    /** Get the flowchart spec (stage graph metadata). */
+    getSpec(): unknown;
+    /** Get the narrative from the last run. */
+    getNarrative(): string[];
+    /** Get structured narrative entries from the last run. */
+    getNarrativeEntries(): import("footprintjs").CombinedNarrativeEntry[];
+    /** Get the full execution snapshot from the last run. */
+    getSnapshot(): import("footprintjs").RuntimeSnapshot | undefined;
+}
+//# sourceMappingURL=FlowChart.d.ts.map

package/dist/types/concepts/FlowChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowChart.d.ts","sourceRoot":"","sources":["../../../src/concepts/FlowChart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAoB,eAAe,EAAE,MAAM,UAAU,CAAC;AAEpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAe7C,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,OAAO;IAEP,MAAM,CAAC,MAAM,IAAI,SAAS;IAI1B,yEAAyE;IACzE,KAAK,CACH,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;QAC9C,YAAY,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;KACjD,GACA,IAAI;IAWP,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKlC,wDAAwD;IACxD,KAAK,IAAI,eAAe;CAMzB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;gBAEf,MAAM,EAAE,SAAS,gBAAgB,EAAE,EAAE,SAAS,GAAE,aAAa,EAAO;IAK1E,GAAG,CACP,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,eAAe,CAAC;IA+G3B,qDAAqD;IACrD,OAAO,IAAI,OAAO;IAmClB,2CAA2C;IAC3C,YAAY,IAAI,MAAM,EAAE;IAIxB,0DAA0D;IAC1D,mBAAmB;IAInB,yDAAyD;IACzD,WAAW;CAGZ"}

package/dist/types/concepts/LLMCall.d.ts

@@ -0,0 +1,56 @@
+/**
+ * LLMCall — simplest concept: single LLM call, no tools, no loop.
+ *
+ * Flowchart: SystemPrompt → Messages → CallLLM → ParseResponse → Finalize
+ *
+ * Usage:
+ *   const caller = LLMCall.create({ provider: mock([{ content: 'Hi!' }]) })
+ *     .system('You are helpful.')
+ *     .build();
+ *   const result = await caller.run('Hello');
+ */
+import type { FlowChart as FlowChartType } from 'footprintjs';
+import type { LLMProvider, Message } from '../types';
+import type { ModelConfig } from '../models';
+import type { AgentRecorder } from '../core';
+export interface LLMCallOptions {
+    /** LLMProvider instance or ModelConfig from anthropic()/openai()/bedrock()/ollama(). */
+    readonly provider: LLMProvider | ModelConfig;
+}
+export declare class LLMCall {
+    private readonly provider;
+    private sysPrompt?;
+    private readonly recorders;
+    private enableStreaming;
+    private constructor();
+    static create(options: LLMCallOptions): LLMCall;
+    system(prompt: string): this;
+    streaming(enabled: boolean): this;
+    /** Attach an AgentRecorder to observe execution events. */
+    recorder(rec: AgentRecorder): this;
+    build(): LLMCallRunner;
+}
+export declare class LLMCallRunner {
+    private readonly provider;
+    private readonly sysPrompt?;
+    private readonly recorders;
+    private readonly streamingEnabled;
+    private lastExecutor?;
+    private lastSpec?;
+    constructor(provider: LLMProvider, sysPrompt?: string, recorders?: AgentRecorder[], streaming?: boolean);
+    /** Expose the internal flowChart for subflow composition. */
+    toFlowChart(): FlowChartType;
+    run(message: string, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+        onToken?: (token: string) => void;
+    }): Promise<{
+        content: string;
+        messages: Message[];
+    }>;
+    private buildChart;
+    getSpec(): unknown;
+    getNarrative(): string[];
+    getSnapshot(): import("footprintjs").RuntimeSnapshot | undefined;
+}
+//# sourceMappingURL=LLMCall.d.ts.map

package/dist/types/concepts/LLMCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMCall.d.ts","sourceRoot":"","sources":["../../../src/concepts/LLMCall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAwC,MAAM,aAAa,CAAC;AAGpG,OAAO,KAAK,EAAE,WAAW,EAAe,OAAO,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQ7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC;CAC9C;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAI/C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKlC,KAAK,IAAI,aAAa;CAGvB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;gBAEf,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,aAAa,EAAO,EAAE,SAAS,UAAQ;IAOzG,6DAA6D;IAC7D,WAAW,IAAI,aAAa;IAItB,GAAG,CACP,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACxF,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAiDpD,OAAO,CAAC,UAAU;IAsClB,OAAO,IAAI,OAAO;IAOlB,YAAY,IAAI,MAAM,EAAE;IAIxB,WAAW;CAGZ"}

package/dist/types/concepts/Parallel.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Parallel — concurrent agent execution with fan-out/fan-in.
+ *
+ * Runs N agents in parallel, each as an isolated subflow. Merges results
+ * via LLM call (default) or custom function.
+ *
+ * Flowchart:
+ *   Seed → [fork]
+ *            ├── agent-A (isolated subflow)
+ *            ├── agent-B (isolated subflow)
+ *            └── agent-C (isolated subflow)
+ *          Merge → Finalize
+ *
+ * Each branch gets its own ExecutionRuntime (isolated scope).
+ * Results flow back through outputMapper (delta pattern).
+ *
+ * Usage:
+ *   const parallel = Parallel.create({ provider })
+ *     .agent('research', researchAgent, 'Research the topic')
+ *     .agent('writing', writingAgent, 'Draft content')
+ *     .mergeWithLLM('Synthesize into a coherent report')
+ *     .build();
+ *   const result = await parallel.run('Write about AI safety');
+ */
+import type { LLMProvider, Message } from '../types';
+import type { ModelConfig } from '../models';
+import type { RunnerLike } from '../types/multiAgent';
+import type { AgentRecorder } from '../core';
+export interface ParallelOptions {
+    /** LLMProvider instance or ModelConfig from anthropic()/openai()/bedrock()/ollama(). */
+    readonly provider: LLMProvider | ModelConfig;
+    readonly name?: string;
+}
+interface BranchDef {
+    readonly id: string;
+    readonly description: string;
+    readonly runner: RunnerLike;
+}
+/** Result from a single parallel branch. */
+export interface BranchResult {
+    readonly id: string;
+    readonly status: 'fulfilled' | 'rejected';
+    readonly content: string;
+    readonly error?: string;
+}
+export interface ParallelResult {
+    /** Final merged content. */
+    readonly content: string;
+    /** Per-branch results. */
+    readonly branches: readonly BranchResult[];
+    /** Full message history (if LLM merge was used). */
+    readonly messages: Message[];
+}
+export declare class Parallel {
+    private readonly provider;
+    private readonly parallelName;
+    private readonly branches;
+    private mergePrompt?;
+    private mergeFn?;
+    private readonly recorders;
+    private streamingEnabled;
+    private constructor();
+    static create(options: ParallelOptions): Parallel;
+    /** Add an agent branch to run in parallel. */
+    agent(id: string, runner: RunnerLike, description: string): this;
+    /**
+     * Merge results using an LLM call (default strategy).
+     * The LLM receives all branch results as context and generates a unified response.
+     */
+    mergeWithLLM(prompt: string): this;
+    /**
+     * Merge results using a custom function (escape hatch for structured data).
+     */
+    merge(fn: (results: Record<string, BranchResult>) => string): this;
+    streaming(enabled: boolean): this;
+    recorder(rec: AgentRecorder): this;
+    build(): ParallelRunner;
+}
+interface ParallelRunnerOptions {
+    readonly provider: LLMProvider;
+    readonly name: string;
+    readonly branches: readonly BranchDef[];
+    readonly mergePrompt?: string;
+    readonly mergeFn?: (results: Record<string, BranchResult>) => string;
+    readonly streaming: boolean;
+    readonly recorders: AgentRecorder[];
+}
+export declare class ParallelRunner {
+    private readonly opts;
+    private lastExecutor?;
+    private lastSpec?;
+    private readonly narrativeRenderer;
+    constructor(options: ParallelRunnerOptions);
+    get name(): string;
+    /** Build the parallel flowchart. */
+    private buildChart;
+    /** Build a single branch's flowchart. */
+    private buildBranchChart;
+    run(message: string, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+        onToken?: (token: string) => void;
+    }): Promise<ParallelResult>;
+    getNarrative(): string[];
+    getNarrativeEntries(): import("footprintjs").CombinedNarrativeEntry[];
+    getSnapshot(): import("footprintjs").RuntimeSnapshot | undefined;
+    getSpec(): unknown;
+}
+export {};
+//# sourceMappingURL=Parallel.d.ts.map

package/dist/types/concepts/Parallel.d.ts.map

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

package/dist/types/concepts/RAG.d.ts

@@ -0,0 +1,71 @@
+/**
+ * RAG — Retrieve-Augment-Generate concept.
+ *
+ * Flowchart: Seed → Retrieve → AugmentPrompt → CallLLM → ParseResponse → Finalize
+ *
+ * Usage:
+ *   const rag = RAG.create({ provider: mock([...]), retriever: mockRetriever([...]) })
+ *     .system('You are helpful.')
+ *     .topK(5)
+ *     .build();
+ *   const result = await rag.run('What is X?');
+ */
+import type { FlowChart as FlowChartType } from 'footprintjs';
+import type { LLMProvider, RetrieverProvider, RetrieveOptions, RAGResult } from '../types';
+import type { ModelConfig } from '../models';
+import type { AgentRecorder } from '../core';
+export interface RAGOptions {
+    /** LLMProvider instance or ModelConfig from anthropic()/openai()/bedrock()/ollama(). */
+    readonly provider: LLMProvider | ModelConfig;
+    readonly retriever: RetrieverProvider;
+}
+export declare class RAG {
+    private readonly provider;
+    private readonly retriever;
+    private sysPrompt?;
+    private retrieveOptions;
+    private readonly recorders;
+    private enableStreaming;
+    private constructor();
+    static create(options: RAGOptions): RAG;
+    /** Set system prompt. */
+    system(prompt: string): this;
+    /** Set number of chunks to retrieve. */
+    topK(n: number): this;
+    /** Set minimum relevance score threshold. */
+    minScore(score: number): this;
+    /** Enable token-by-token streaming for the LLM call. */
+    streaming(enabled: boolean): this;
+    /** Attach an AgentRecorder to observe execution events. */
+    recorder(rec: AgentRecorder): this;
+    /** Build the RAG pipeline and return a runner. */
+    build(): RAGRunner;
+}
+export declare class RAGRunner {
+    private readonly provider;
+    private readonly retriever;
+    private readonly sysPrompt?;
+    private readonly retrieveOptions;
+    private readonly recorders;
+    private lastExecutor?;
+    private lastSpec?;
+    private readonly streamingEnabled;
+    constructor(provider: LLMProvider, retriever: RetrieverProvider, sysPrompt: string | undefined, retrieveOptions: RetrieveOptions, recorders?: AgentRecorder[], streaming?: boolean);
+    /** Expose the internal flowChart for subflow composition. */
+    toFlowChart(): FlowChartType;
+    run(message: string, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+        onToken?: (token: string) => void;
+    }): Promise<RAGResult>;
+    private buildChart;
+    /** Get the flowchart spec (stage graph metadata). */
+    getSpec(): unknown;
+    /** Get the narrative from the last run. */
+    getNarrative(): string[];
+    /** Get structured narrative entries from the last run. */
+    getNarrativeEntries(): import("footprintjs").CombinedNarrativeEntry[];
+    /** Get the full execution snapshot from the last run. */
+    getSnapshot(): import("footprintjs").RuntimeSnapshot | undefined;
+}
+//# sourceMappingURL=RAG.d.ts.map

package/dist/types/concepts/RAG.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RAG.d.ts","sourceRoot":"","sources":["../../../src/concepts/RAG.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAwC,MAAM,aAAa,CAAC;AAGpG,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,eAAe,EAGf,SAAS,EACV,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAW7C,MAAM,WAAW,UAAU;IACzB,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED,qBAAa,GAAG;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG;IAIvC,yBAAyB;IACzB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,wCAAwC;IACxC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,wDAAwD;IACxD,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKlC,kDAAkD;IAClD,KAAK,IAAI,SAAS;CAGnB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;gBAGzC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,eAAe,EAAE,eAAe,EAChC,SAAS,GAAE,aAAa,EAAO,EAC/B,SAAS,UAAQ;IAUnB,6DAA6D;IAC7D,WAAW,IAAI,aAAa;IAItB,GAAG,CACP,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACxF,OAAO,CAAC,SAAS,CAAC;IAuDrB,OAAO,CAAC,UAAU;IAyClB,qDAAqD;IACrD,OAAO,IAAI,OAAO;IAOlB,2CAA2C;IAC3C,YAAY,IAAI,MAAM,EAAE;IAIxB,0DAA0D;IAC1D,mBAAmB;IAInB,yDAAyD;IACzD,WAAW;CAGZ"}

package/dist/types/concepts/Swarm.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Swarm — multi-agent delegation via buildAgentLoop + buildSwarmRouting.
+ *
+ * An orchestrator LLM selects which specialist to invoke. Each specialist
+ * is mounted as a **lazy subflow** — visible in BTS with drill-down.
+ *
+ * Swarm IS an Agent with a different routing strategy:
+ *   Agent:  ... → RouteResponse{tool-calls | final}
+ *   Swarm:  ... → RouteSpecialist{specialist-A | specialist-B | swarm-tools | final}
+ *
+ * Everything upstream (SystemPrompt, Messages, Tools, AssemblePrompt,
+ * CallLLM, ParseResponse) is the same Agent loop infrastructure.
+ *
+ * > "Every feature you add to Agent automatically works in Swarm."
+ */
+import type { LLMProvider } from '../types/llm';
+import type { ModelConfig } from '../models';
+import type { ToolDefinition } from '../types/tools';
+import type { RunnerLike, TraversalResult } from '../types/multiAgent';
+import type { AgentRecorder } from '../core';
+import type { FlowChart as FlowChartType } from 'footprintjs';
+import type { SwarmSpecialist } from '../lib/swarm/buildSwarmRouting';
+import type { Message } from '../types/messages';
+export interface SwarmOptions {
+    /** LLMProvider instance or ModelConfig from anthropic()/openai()/bedrock()/ollama(). */
+    readonly provider: LLMProvider | ModelConfig;
+    readonly name?: string;
+}
+export declare class Swarm {
+    private readonly provider;
+    private readonly swarmName;
+    private systemPromptText?;
+    private readonly specialists;
+    private readonly extraTools;
+    private readonly recorders;
+    private maxIter;
+    private streamingEnabled;
+    private constructor();
+    static create(options: SwarmOptions): Swarm;
+    system(prompt: string): this;
+    /**
+     * Register a specialist agent.
+     *
+     * Each specialist is mounted as a **lazy subflow** — only built when the
+     * orchestrator LLM selects it. Visible in BTS with drill-down.
+     */
+    specialist(id: string, description: string, runner: RunnerLike): this;
+    /** Register a non-specialist tool (calculator, search, etc.) available to the orchestrator. */
+    tool(toolDef: ToolDefinition): this;
+    maxIterations(n: number): this;
+    streaming(enabled: boolean): this;
+    recorder(rec: AgentRecorder): this;
+    build(): SwarmRunner;
+}
+export declare class SwarmRunner {
+    private readonly provider;
+    readonly name: string;
+    private readonly systemPromptText?;
+    private readonly specialists;
+    private readonly extraTools;
+    private readonly maxIter;
+    private readonly streamingEnabled;
+    readonly recorders: AgentRecorder[];
+    private conversationHistory;
+    private lastExecutor?;
+    private lastSpec?;
+    private readonly narrativeRenderer;
+    /** Cached routing config — constructed once, reused across runs. */
+    private readonly routingConfig;
+    /** Cached tool descriptions — constructed once, reused across runs. */
+    private readonly toolDescs;
+    /** Cached system prompt — constructed once, reused across runs. */
+    private readonly fullSystemPrompt;
+    constructor(provider: LLMProvider, name: string, systemPromptText: string | undefined, specialists: readonly SwarmSpecialist[], extraTools: readonly ToolDefinition[], maxIter: number, streaming: boolean, recorders?: AgentRecorder[]);
+    /** Build the system prompt with specialist descriptions appended. */
+    private buildSystemPrompt;
+    /** Build tool descriptions for specialist + extra tools. */
+    private buildToolDescriptions;
+    /** Build AgentLoopConfig — Swarm uses the same loop as Agent with custom routing. */
+    private buildConfig;
+    /** Expose the swarm's internal flowChart for subflow composition. */
+    toFlowChart(): FlowChartType;
+    private buildLoop;
+    run(message: string, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+        onToken?: (token: string) => void;
+    }): Promise<TraversalResult>;
+    /** Get conversation history (for multi-turn). */
+    getMessages(): Message[];
+    /** Reset conversation state for a fresh conversation. */
+    resetConversation(): void;
+    getNarrative(): string[];
+    getNarrativeEntries(): import("footprintjs").CombinedNarrativeEntry[];
+    getSnapshot(): import("footprintjs").RuntimeSnapshot | undefined;
+    getSpec(): unknown;
+}
+//# sourceMappingURL=Swarm.d.ts.map

package/dist/types/concepts/Swarm.d.ts.map

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

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

@@ -0,0 +1,12 @@
+export { Agent, AgentRunner } from '../lib/concepts';
+export type { AgentOptions } from '../lib/concepts';
+export { LLMCall, LLMCallRunner } from './LLMCall';
+export type { LLMCallOptions } from './LLMCall';
+export { RAG, RAGRunner } from './RAG';
+export type { RAGOptions } from './RAG';
+export { FlowChart, FlowChartRunner } from './FlowChart';
+export { Swarm, SwarmRunner } from './Swarm';
+export type { SwarmOptions } from './Swarm';
+export { Parallel, ParallelRunner } from './Parallel';
+export type { ParallelOptions, ParallelResult, BranchResult } from './Parallel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/concepts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/concepts/specIcons.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Annotates a pipeline spec tree with semantic icon hints for visualization.
+ * Icons are matched by stage ID — unknown IDs are left without an icon.
+ * Mutates the spec in-place and returns it for chaining.
+ */
+export interface SpecLike {
+    id?: string;
+    icon?: string;
+    next?: SpecLike;
+    children?: SpecLike[];
+    subflowStructure?: SpecLike;
+}
+export declare function annotateSpecIcons<T extends SpecLike>(spec: T, extraIcons?: Record<string, string>): T;
+//# sourceMappingURL=specIcons.d.ts.map

package/dist/types/concepts/specIcons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specIcons.d.ts","sourceRoot":"","sources":["../../../src/concepts/specIcons.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,QAAQ,CAAC;CAC7B;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,QAAQ,EAClD,IAAI,EAAE,CAAC,EACP,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,CAAC,CAIH"}

package/dist/types/content.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Multi-modal content blocks for LLM messages.
+ * Provider-agnostic — adapters translate to/from provider formats (Anthropic, OpenAI, etc.).
+ *
+ * Design: discriminated union on `type` field, like Anthropic's API.
+ * Every message's `content` is `string | ContentBlock[]` — string for backward compat,
+ * ContentBlock[] for multi-modal (images, tool use, structured results).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getToolUseBlocks = exports.hasToolUseBlocks = exports.contentLength = exports.getTextContent = exports.blockToToolCall = exports.toolCallToBlock = exports.toolResultBlock = exports.toolUseBlock = exports.urlImage = exports.base64Image = exports.imageBlock = exports.textBlock = void 0;
+// ── Factory Functions ───────────────────────────────────────
+function textBlock(text) {
+    return { type: 'text', text };
+}
+exports.textBlock = textBlock;
+function imageBlock(source) {
+    return { type: 'image', source };
+}
+exports.imageBlock = imageBlock;
+function base64Image(mediaType, data) {
+    return { type: 'image', source: { type: 'base64', mediaType, data } };
+}
+exports.base64Image = base64Image;
+function urlImage(url) {
+    return { type: 'image', source: { type: 'url', url } };
+}
+exports.urlImage = urlImage;
+function toolUseBlock(id, name, input) {
+    return { type: 'tool_use', id, name, input };
+}
+exports.toolUseBlock = toolUseBlock;
+function toolResultBlock(toolUseId, content, isError) {
+    return { type: 'tool_result', toolUseId, content, isError };
+}
+exports.toolResultBlock = toolResultBlock;
+// ── ToolCall ↔ ToolUseBlock Conversion ──────────────────────
+/**
+ * Convert a legacy ToolCall (from AssistantMessage.toolCalls) to a ToolUseBlock.
+ * Bridges the two representations: ToolCall uses `arguments`, ToolUseBlock uses `input`.
+ */
+function toolCallToBlock(call) {
+    return { type: 'tool_use', id: call.id, name: call.name, input: call.arguments };
+}
+exports.toolCallToBlock = toolCallToBlock;
+/**
+ * Convert a ToolUseBlock to a legacy ToolCall format.
+ * Bridges the two representations: ToolUseBlock uses `input`, ToolCall uses `arguments`.
+ */
+function blockToToolCall(block) {
+    return { id: block.id, name: block.name, arguments: block.input };
+}
+exports.blockToToolCall = blockToToolCall;
+// ── Content Helpers ─────────────────────────────────────────
+/**
+ * Extract text from message content, regardless of form.
+ * - string → returned as-is
+ * - ContentBlock[] → concatenates all TextBlock.text values
+ *
+ * Use this instead of `msg.content.length` or string operations on content.
+ */
+function getTextContent(content) {
+    if (typeof content === 'string')
+        return content;
+    return content
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('');
+}
+exports.getTextContent = getTextContent;
+/**
+ * Get the character length of message content (for budget calculations).
+ * Handles both string and ContentBlock[] forms.
+ */
+function contentLength(content) {
+    return getTextContent(content).length;
+}
+exports.contentLength = contentLength;
+/**
+ * Check if content contains any tool use blocks.
+ */
+function hasToolUseBlocks(content) {
+    if (typeof content === 'string')
+        return false;
+    return content.some((block) => block.type === 'tool_use');
+}
+exports.hasToolUseBlocks = hasToolUseBlocks;
+/**
+ * Extract tool use blocks from content.
+ */
+function getToolUseBlocks(content) {
+    if (typeof content === 'string')
+        return [];
+    return content.filter((block) => block.type === 'tool_use');
+}
+exports.getToolUseBlocks = getToolUseBlocks;
+//# sourceMappingURL=content.js.map

package/dist/types/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/types/content.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAuEH,+DAA+D;AAE/D,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAFD,8BAEC;AAED,SAAgB,UAAU,CAAC,MAAmB;IAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC;AAFD,gCAEC;AAED,SAAgB,WAAW,CAAC,SAAiB,EAAE,IAAY;IACzD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;AACxE,CAAC;AAFD,kCAEC;AAED,SAAgB,QAAQ,CAAC,GAAW;IAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;AACzD,CAAC;AAFD,4BAEC;AAED,SAAgB,YAAY,CAC1B,EAAU,EACV,IAAY,EACZ,KAA8B;IAE9B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAND,oCAMC;AAED,SAAgB,eAAe,CAC7B,SAAiB,EACjB,OAAgC,EAChC,OAAiB;IAEjB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC;AAND,0CAMC;AAED,+DAA+D;AAE/D;;;GAGG;AACH,SAAgB,eAAe,CAAC,IAI/B;IACC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;AACnF,CAAC;AAND,0CAMC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,KAAmB;IAKjD,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AACpE,CAAC;AAND,0CAMC;AAED,+DAA+D;AAE/D;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,OAAuB;IACpD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,KAAK,EAAsB,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SAC5D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAND,wCAMC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAuB;IACnD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AACxC,CAAC;AAFD,sCAEC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,OAAuB;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AAC5D,CAAC;AAHD,4CAGC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,OAAuB;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAyB,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AACrF,CAAC;AAHD,4CAGC"}

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

@@ -0,0 +1,24 @@
+/**
+ * AgentLoopConfig — everything the core loop needs to run.
+ * Assembled by builders (Agent.create(), etc.).
+ */
+import type { LLMProvider } from '../types/llm';
+import type { PromptProvider, MessageStrategy, ToolProvider } from './providers';
+import type { AgentRecorder } from './recorders';
+export interface AgentLoopConfig {
+    /** Resolves system prompt each turn. */
+    readonly promptProvider: PromptProvider;
+    /** Prepares messages for LLM. */
+    readonly messageStrategy: MessageStrategy;
+    /** Resolves and executes tools. */
+    readonly toolProvider: ToolProvider;
+    /** LLM provider (chat API). */
+    readonly llmProvider: LLMProvider;
+    /** Max tool-loop iterations per turn. */
+    readonly maxIterations: number;
+    /** Passive observers. */
+    readonly recorders: AgentRecorder[];
+    /** Agent name (for narrative/debugging). */
+    readonly name: string;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,iCAAiC;IACjC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,mCAAmC;IACnC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

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

@@ -0,0 +1,15 @@
+/**
+ * core/ — Agent loop interfaces and types.
+ *
+ * The "traversal engine" of agentfootprint. Defines the provider
+ * and recorder interfaces that everything else plugs into.
+ *
+ * Three files:
+ *   providers.ts — active strategies (shape behavior)
+ *   recorders.ts — passive observers (watch behavior)
+ *   config.ts    — loop configuration
+ */
+export type { SlotDecision, PromptProvider, MessageStrategy, ToolProvider, PromptContext, MessageContext, ToolContext, ToolExecutionResult, } from './providers';
+export type { AgentRecorder, AgentPhase, TurnStartEvent, LLMCallEvent, ToolCallEvent, TurnCompleteEvent, AgentErrorEvent, } from './recorders';
+export type { AgentLoopConfig } from './config';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}