agentfootprint 1.22.0 → 2.0.1

package/dist/types/scope/AgentScope.d.ts

@@ -1,76 +0,0 @@
-/**
- * AgentScope — typed wrapper over ScopeFacade for agent state.
- *
- * Instead of raw scope.getValue('messages'), use scope.getMessages().
- * All paths come from AGENT_PATHS constants (single source of truth).
- */
-import type { ScopeFacade } from 'footprintjs/advanced';
-import type { Message, AdapterResult, LLMToolDescription, RetrievalResult, AgentResultEntry } from '../types';
-import type { ParsedResponse } from './types';
-/**
- * Well-known scope paths for memory subflow state.
- * Single key: `memory_preparedMessages` is the Messages-slot output.
- */
-export declare const MEMORY_PATHS: {
-    /** Prepared messages after strategy applied (Messages slot output). */
-    readonly PREPARED_MESSAGES: "memory_preparedMessages";
-};
-/** Well-known scope paths for agent state. */
-export declare const AGENT_PATHS: {
-    readonly MESSAGES: "messages";
-    readonly SYSTEM_PROMPT: "systemPrompt";
-    readonly TOOL_DESCRIPTIONS: "toolDescriptions";
-    readonly ADAPTER_RESULT: "adapterResult";
-    readonly PARSED_RESPONSE: "parsedResponse";
-    readonly LOOP_COUNT: "loopCount";
-    readonly MAX_ITERATIONS: "maxIterations";
-    readonly RESULT: "result";
-};
-/** Well-known scope paths for multi-agent pipeline state. */
-export declare const MULTI_AGENT_PATHS: {
-    readonly PIPELINE_INPUT: "pipelineInput";
-    readonly AGENT_RESULTS: "agentResults";
-    readonly RESULT: "result";
-    readonly SIGNAL: "_signal";
-    readonly TIMEOUT_MS: "_timeoutMs";
-};
-/** Well-known scope paths for RAG state. */
-export declare const RAG_PATHS: {
-    readonly RETRIEVAL_QUERY: "retrievalQuery";
-    readonly RETRIEVAL_RESULT: "retrievalResult";
-    readonly CONTEXT_WINDOW: "contextWindow";
-};
-/**
- * Typed accessors for agent state in scope.
- * These are pure functions — no class inheritance needed.
- */
-export declare const AgentScope: {
-    readonly getMessages: (scope: ScopeFacade) => Message[];
-    readonly getSystemPrompt: (scope: ScopeFacade) => string | undefined;
-    readonly getToolDescriptions: (scope: ScopeFacade) => LLMToolDescription[];
-    readonly getAdapterResult: (scope: ScopeFacade) => AdapterResult | undefined;
-    readonly getParsedResponse: (scope: ScopeFacade) => ParsedResponse | undefined;
-    readonly getLoopCount: (scope: ScopeFacade) => number;
-    readonly getMaxIterations: (scope: ScopeFacade) => number;
-    readonly getResult: (scope: ScopeFacade) => string | undefined;
-    readonly setMessages: (scope: ScopeFacade, messages: Message[]) => void;
-    readonly setSystemPrompt: (scope: ScopeFacade, prompt: string) => void;
-    readonly setToolDescriptions: (scope: ScopeFacade, tools: LLMToolDescription[]) => void;
-    readonly setAdapterResult: (scope: ScopeFacade, result: AdapterResult) => void;
-    readonly setParsedResponse: (scope: ScopeFacade, parsed: ParsedResponse) => void;
-    readonly setLoopCount: (scope: ScopeFacade, count: number) => void;
-    readonly setMaxIterations: (scope: ScopeFacade, max: number) => void;
-    readonly setResult: (scope: ScopeFacade, result: string) => void;
-    readonly getRetrievalQuery: (scope: ScopeFacade) => string | undefined;
-    readonly getRetrievalResult: (scope: ScopeFacade) => RetrievalResult | undefined;
-    readonly getContextWindow: (scope: ScopeFacade) => string | undefined;
-    readonly setRetrievalQuery: (scope: ScopeFacade, query: string) => void;
-    readonly setRetrievalResult: (scope: ScopeFacade, result: RetrievalResult) => void;
-    readonly setContextWindow: (scope: ScopeFacade, context: string) => void;
-    readonly getPipelineInput: (scope: ScopeFacade) => string | undefined;
-    readonly getAgentResults: (scope: ScopeFacade) => AgentResultEntry[];
-    readonly setPipelineInput: (scope: ScopeFacade, input: string) => void;
-    readonly setAgentResults: (scope: ScopeFacade, results: AgentResultEntry[]) => void;
-    readonly getPreparedMessages: (scope: ScopeFacade) => Message[];
-};
-//# sourceMappingURL=AgentScope.d.ts.map

package/dist/types/scope/AgentScope.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentScope.d.ts","sourceRoot":"","sources":["../../../src/scope/AgentScope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,uEAAuE;;CAE/D,CAAC;AAEX,8CAA8C;AAC9C,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC;AAEX,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC;AAEX,4CAA4C;AAC5C,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,UAAU;kCAGF,WAAW,KAAG,OAAO,EAAE;sCAKnB,WAAW,KAAG,MAAM,GAAG,SAAS;0CAI5B,WAAW,KAAG,kBAAkB,EAAE;uCAIrC,WAAW,KAAG,aAAa,GAAG,SAAS;wCAItC,WAAW,KAAG,cAAc,GAAG,SAAS;mCAI7C,WAAW,KAAG,MAAM;uCAIhB,WAAW,KAAG,MAAM;gCAI3B,WAAW,KAAG,MAAM,GAAG,SAAS;kCAM9B,WAAW,YAAY,OAAO,EAAE,KAAG,IAAI;sCAInC,WAAW,UAAU,MAAM,KAAG,IAAI;0CAI9B,WAAW,SAAS,kBAAkB,EAAE,KAAG,IAAI;uCAIlD,WAAW,UAAU,aAAa,KAAG,IAAI;wCAIxC,WAAW,UAAU,cAAc,KAAG,IAAI;mCAI/C,WAAW,SAAS,MAAM,KAAG,IAAI;uCAI7B,WAAW,OAAO,MAAM,KAAG,IAAI;gCAItC,WAAW,UAAU,MAAM,KAAG,IAAI;wCAM1B,WAAW,KAAG,MAAM,GAAG,SAAS;yCAI/B,WAAW,KAAG,eAAe,GAAG,SAAS;uCAI3C,WAAW,KAAG,MAAM,GAAG,SAAS;wCAM/B,WAAW,SAAS,MAAM,KAAG,IAAI;yCAIhC,WAAW,UAAU,eAAe,KAAG,IAAI;uCAI7C,WAAW,WAAW,MAAM,KAAG,IAAI;uCAMnC,WAAW,KAAG,MAAM,GAAG,SAAS;sCAIjC,WAAW,KAAG,gBAAgB,EAAE;uCAM/B,WAAW,SAAS,MAAM,KAAG,IAAI;sCAIlC,WAAW,WAAW,gBAAgB,EAAE,KAAG,IAAI;0CAM3C,WAAW,KAAG,OAAO,EAAE;CAG1C,CAAC"}

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

@@ -1,3 +0,0 @@
-export { AgentScope, AGENT_PATHS, RAG_PATHS, MULTI_AGENT_PATHS, MEMORY_PATHS } from './AgentScope';
-export type { ParsedResponse, AgentLoopState, SystemPromptSubflowState, ToolsSubflowState, MessagesSubflowState, RAGState, MultiAgentState, } from './types';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACnG,YAAY,EACV,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EACR,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/types/scope/types.d.ts

@@ -1,182 +0,0 @@
-/**
- * Typed state interfaces for TypedScope<T> in agentfootprint patterns.
- *
- * These replace the AgentScope static helpers + AGENT_PATHS string constants.
- * Each pattern has its own state interface — subflows use narrower slices.
- *
- * Usage:
- *   flowChart<AgentLoopState>('Seed', (scope) => {
- *     scope.messages = [userMessage('hello')];  // typed write
- *     scope.loopCount = 0;                       // typed write
- *   })
- */
-import type { Message, AdapterResult, LLMResponse, LLMToolDescription, ToolCall, RetrievalResult, AgentResultEntry } from '../types';
-import type { LLMInstruction } from '../lib/instructions/types';
-export interface ParsedResponse {
-    readonly hasToolCalls: boolean;
-    readonly toolCalls: ToolCall[];
-    readonly content: string;
-}
-/** Minimal state shared by all patterns that call an LLM. */
-export interface BaseLLMState {
-    messages: Message[];
-    toolDescriptions?: LLMToolDescription[];
-    adapterResult?: AdapterResult;
-    adapterRawResponse?: LLMResponse;
-    parsedResponse?: ParsedResponse;
-    result?: string;
-    [key: string]: unknown;
-}
-/**
- * Well-known scope keys for the agent loop.
- * Used by grounding helpers, narrative renderer, and suppression lists.
- * Single source of truth — no magic strings.
- */
-export declare enum AgentScopeKey {
-    Messages = "messages",
-    SystemPrompt = "systemPrompt",
-    ToolDescriptions = "toolDescriptions",
-    ParsedResponse = "parsedResponse",
-    Result = "result",
-    LoopCount = "loopCount",
-    ToolResultMessages = "toolResultMessages",
-    Decision = "decision",
-    MatchedInstructions = "matchedInstructions",
-    PromptInjections = "promptInjections",
-    ToolInjections = "toolInjections",
-    ResponseRules = "responseRules"
-}
-/** Full state for the agent loop flowchart (buildAgentLoop). */
-export interface AgentLoopState {
-    /** Conversation message history. */
-    messages: Message[];
-    /** Resolved system prompt text. */
-    systemPrompt: string;
-    /** Available tool descriptions for the LLM. */
-    toolDescriptions: LLMToolDescription[];
-    /** Normalized LLM response (discriminated union: final | tools | error). */
-    adapterResult: AdapterResult;
-    /** Raw LLM response for recorders. */
-    adapterRawResponse: LLMResponse;
-    /** Structured parse of LLM response. */
-    parsedResponse: ParsedResponse;
-    /**
-     * Flat mirror of `parsedResponse.hasToolCalls`. Written by ParseResponse
-     * so the RouteResponse decider can use `decide()`'s filter form
-     * (`{ hasToolCalls: { eq: true } }`), producing structured
-     * `{ key, op, threshold, actual, result }` evidence in the commit log
-     * rather than an opaque function-match boolean.
-     */
-    hasToolCalls: boolean;
-    /** Current loop iteration count. */
-    loopCount: number;
-    /** Max loop iterations allowed. */
-    maxIterations: number;
-    /** Final answer text (set when turn finalizes). */
-    result: string;
-    /**
-     * Set by Finalize when the turn ended because `loopCount >= maxIterations`
-     * (safeDecider force-routed to the default branch), rather than because the
-     * LLM chose to stop. Consumers use it to render a distinct "agent gave up"
-     * state instead of an ambiguous empty response.
-     */
-    maxIterationsReached?: boolean;
-    /** Prepared messages after strategy applied (Messages slot output). */
-    memory_preparedMessages: Message[];
-    /**
-     * Hierarchical identity for the memory pipeline. Populated from
-     * `run(message, { identity })` options via a MemorySeed stage when
-     * `memoryPipeline` is configured. Pipeline subflows read this to
-     * scope storage calls.
-     */
-    identity?: import('../memory/identity').MemoryIdentity;
-    /** Turn counter for pipeline provenance (source.turn). Defaults to 1. */
-    turnNumber?: number;
-    /** Budget hint for the picker stage. Defaults to 4000. */
-    contextTokensRemaining?: number;
-    /**
-     * Output of the memory read subflow — formatted system messages that
-     * AssemblePrompt prepends to the LLM prompt.
-     */
-    memoryInjection?: Message[];
-    /**
-     * Messages packaged for the memory write subflow — populated after the
-     * LLM call and Finalize. The write subflow persists these to the store.
-     */
-    newMessages?: Message[];
-    /** Tool resolution summary (e.g. "3 tools: calculator, datetime, search"). */
-    resolvedTools: string;
-    /** System prompt summary (e.g. '38 chars: "You are a helpful..."'). */
-    promptSummary: string;
-    /** LLM call summary (e.g. "claude-sonnet-4 (127in / 45out)"). */
-    llmCall: string;
-    /** Response type summary (e.g. "tool_calls: [calculator]" or "final: ..."). */
-    responseType: string;
-    /** Decision scope — developer-defined state driving instruction activation. */
-    decision?: Record<string, unknown>;
-    /** Prompt injections from matched instructions (Position 1). */
-    promptInjections?: string[];
-    /** Tool description injections from matched instructions (Position 2). */
-    toolInjections?: LLMToolDescription[];
-    /** Tool-result rules from matched instructions (Position 3). */
-    responseRules?: LLMInstruction[];
-    /** Narrative: which instructions matched this iteration. */
-    matchedInstructions?: string;
-    /** User message injected by parent in subflow mode. */
-    message: string;
-}
-/** State for the SystemPrompt slot subflow. */
-export interface SystemPromptSubflowState {
-    messages: Message[];
-    loopCount: number;
-    systemPrompt: string;
-    promptSummary: string;
-    promptDecision?: string;
-    /** Prompt injections from InstructionsToLLM (merged after base prompt). */
-    promptInjections?: string[];
-}
-/** State for the Tools slot subflow. */
-export interface ToolsSubflowState {
-    messages: Message[];
-    loopCount: number;
-    toolDescriptions: LLMToolDescription[];
-    resolvedTools: string;
-    toolDecision?: string;
-    /** Tool description injections from InstructionsToLLM (merged after base tools). */
-    toolInjections?: LLMToolDescription[];
-}
-/** State for the Messages slot subflow. */
-export interface MessagesSubflowState {
-    /** Current messages passed from parent via inputMapper. */
-    currentMessages: Message[];
-    loopCount: number;
-    memory_preparedMessages: Message[];
-}
-/** State for the InstructionsToLLM subflow. */
-export interface InstructionsToLLMState {
-    /** Current decision scope values (from parent via inputMapper). */
-    decision: Record<string, unknown>;
-    /** Output: prompt text fragments to merge into system prompt. */
-    promptInjections: string[];
-    /** Output: tool descriptions to merge into tools list (handler stripped). */
-    toolInjections: LLMToolDescription[];
-    /** Output: tool-result rules for tool execution. */
-    responseRules: LLMInstruction[];
-    /** Output: IDs of instructions that matched (narrative enrichment). */
-    matchedInstructions: string;
-}
-/** State for RAG pattern flowcharts. */
-export interface RAGState extends BaseLLMState {
-    systemPrompt: string;
-    retrievalQuery: string;
-    retrievalResult: RetrievalResult;
-    contextWindow: string;
-    result: string;
-}
-/** State for multi-agent pipeline flowcharts. */
-export interface MultiAgentState {
-    pipelineInput: string;
-    agentResults: AgentResultEntry[];
-    result: string;
-}
-//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -1,17 +0,0 @@
-/**
- * agentfootprint/security — Make agents safe.
- *
- * Tool gating hides tools from the LLM. Permission policies control access.
- * Two layers: resolve-time filtering (LLM never sees blocked tools) + execute-time rejection.
- *
- * @example
- * ```typescript
- * import { gatedTools, PermissionPolicy } from 'agentfootprint/security';
- *
- * const policy = PermissionPolicy.fromRoles({ user: ['search'], admin: ['search', 'delete'] }, 'user');
- * const agent = Agent.create({ provider }).toolProvider(gatedTools(tools, policy.checker())).build();
- * ```
- */
-export { gatedTools, PermissionPolicy } from './providers';
-export type { PermissionChecker, GatedToolsOptions, PermissionPolicyOptions, PermissionChangeEvent, } from './providers';
-//# sourceMappingURL=security.barrel.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"security.barrel.d.ts","sourceRoot":"","sources":["../../src/security.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

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

@@ -1,43 +0,0 @@
-/**
- * agentfootprint/skills — typed, versioned agent skills.
- *
- * A `Skill` is a named procedure the agent can discover via `list_skills`
- * and activate via `read_skill(id)`. Each Skill is a typed bundle of
- * prompt + tools + tool-result rules + metadata, composed over the
- * existing `AgentInstruction` primitive.
- *
- * The pattern Anthropic popularized in the Claude Agent SDK, packaged
- * at `agentfootprint`'s framework layer with two agentfootprint-native
- * advantages over the Agent SDK: cross-provider correctness (recency-
- * first delivery by default) and typed / composable authoring.
- *
- * @example
- * ```ts
- * import { Agent, anthropic } from 'agentfootprint';
- * import { defineSkill, SkillRegistry } from 'agentfootprint/skills';
- *
- * const portTriage = defineSkill<TriageDecision>({
- *   id: 'port-error-triage',
- *   version: '1.0.0',
- *   title: 'Port error triage',
- *   description: 'Investigate interfaces reporting CRC or input errors.',
- *   steps: [
- *     'Fetch interface metrics',
- *     'Pull last 5m of logs',
- *     'Report findings to operator',
- *   ],
- *   tools: [getMetrics, getLogs],
- *   activeWhen: (d) => d.currentSkill === 'port-error-triage',
- * });
- *
- * const registry = new SkillRegistry<TriageDecision>({ surfaceMode: 'auto' });
- * registry.register(portTriage);
- *
- * const agent = Agent.create({ provider: anthropic('claude-sonnet-4-5') })
- *   .skills(registry)
- *   .build();
- * ```
- */
-export { defineSkill, SkillRegistry, renderSkillBody } from './lib/skills';
-export type { Skill, SurfaceMode, ProviderHint, SkillRegistryOptions, AutoActivateOptions, SkillListEntry, GeneratedSkillTools, } from './lib/skills';
-//# sourceMappingURL=skills.barrel.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"skills.barrel.d.ts","sourceRoot":"","sources":["../../src/skills.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3E,YAAY,EACV,KAAK,EACL,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

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

@@ -1,16 +0,0 @@
-/**
- * AugmentPrompt stage — injects retrieved context into messages before
- * the LLM call.
- *
- * Context-engineering emit: after the new system message lands in
- * `messages[]`, fires `agentfootprint.context.rag.chunks` with the FULL
- * picture — chunk count + top score (from the retrieval result) PLUS
- * the role / targetIndex / deltaCount (from the message-array mutation
- * we just performed). One event per RAG injection — Lens uses it to
- * tag the iteration AND update the per-slot accumulated ledger
- * (e.g. "messages now has +1 system from RAG this turn").
- */
-import type { TypedScope } from 'footprintjs';
-import type { RAGState } from '../scope/types';
-export declare function augmentPromptStage(scope: TypedScope<RAGState>): void;
-//# sourceMappingURL=augmentPrompt.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"augmentPrompt.d.ts","sourceRoot":"","sources":["../../../src/stages/augmentPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAmDpE"}

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

@@ -1,8 +0,0 @@
-/**
- * CallLLM stage — sends messages to LLM via adapter, writes AdapterResult to scope.
- */
-import type { TypedScope } from 'footprintjs';
-import type { LLMProvider } from '../types';
-import type { BaseLLMState } from '../scope/types';
-export declare function createCallLLMStage(provider: LLMProvider): (scope: TypedScope<BaseLLMState>) => Promise<void>;
-//# sourceMappingURL=callLLM.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"callLLM.d.ts","sourceRoot":"","sources":["../../../src/stages/callLLM.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,WACjC,WAAW,YAAY,CAAC,mBAU9C"}

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

@@ -1,7 +0,0 @@
-/**
- * Finalize stage — extract the final response from conversation.
- */
-import type { TypedScope } from 'footprintjs';
-import type { BaseLLMState } from '../scope/types';
-export declare function finalizeStage(scope: TypedScope<BaseLLMState>): void;
-//# sourceMappingURL=finalize.d.ts.map

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

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

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

@@ -1,17 +0,0 @@
-/**
- * Shared helpers for agent stages.
- */
-import type { LLMResponse, AdapterResult, ToolCall } from '../types';
-import type { ToolRegistry } from '../tools';
-import type { Message } from '../types';
-/**
- * Normalize an LLMResponse into an AdapterResult discriminated union.
- * Shared by callLLM stage and createAdapterSubflow.
- */
-export declare function normalizeAdapterResponse(response: LLMResponse): AdapterResult;
-/**
- * Execute tool calls and append results to conversation messages.
- * Returns the updated messages array.
- */
-export declare function executeToolCalls(toolCalls: ToolCall[], registry: ToolRegistry, messages: Message[]): Promise<Message[]>;
-//# sourceMappingURL=helpers.d.ts.map

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"}