agentfootprint 1.22.0 → 2.0.1

package/dist/esm/scope/AgentScope.js.map

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

package/dist/esm/scope/index.js

@@ -1,2 +0,0 @@
-export { AgentScope, AGENT_PATHS, RAG_PATHS, MULTI_AGENT_PATHS, MEMORY_PATHS } from './AgentScope';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/scope/types.js

@@ -1,37 +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
- *   })
- */
-// ── Agent Loop State ─────────────────────────────────────────
-/**
- * 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 var AgentScopeKey;
-(function (AgentScopeKey) {
-    // Core state
-    AgentScopeKey["Messages"] = "messages";
-    AgentScopeKey["SystemPrompt"] = "systemPrompt";
-    AgentScopeKey["ToolDescriptions"] = "toolDescriptions";
-    AgentScopeKey["ParsedResponse"] = "parsedResponse";
-    AgentScopeKey["Result"] = "result";
-    AgentScopeKey["LoopCount"] = "loopCount";
-    // Tool execution
-    AgentScopeKey["ToolResultMessages"] = "toolResultMessages";
-    // Decision / Instructions
-    AgentScopeKey["Decision"] = "decision";
-    AgentScopeKey["MatchedInstructions"] = "matchedInstructions";
-    AgentScopeKey["PromptInjections"] = "promptInjections";
-    AgentScopeKey["ToolInjections"] = "toolInjections";
-    AgentScopeKey["ResponseRules"] = "responseRules";
-})(AgentScopeKey || (AgentScopeKey = {}));
-//# sourceMappingURL=types.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/scope/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoCH,gEAAgE;AAEhE;;;;GAIG;AACH,MAAM,CAAN,IAAY,aAkBX;AAlBD,WAAY,aAAa;IACvB,aAAa;IACb,sCAAqB,CAAA;IACrB,8CAA6B,CAAA;IAC7B,sDAAqC,CAAA;IACrC,kDAAiC,CAAA;IACjC,kCAAiB,CAAA;IACjB,wCAAuB,CAAA;IAEvB,iBAAiB;IACjB,0DAAyC,CAAA;IAEzC,0BAA0B;IAC1B,sCAAqB,CAAA;IACrB,4DAA2C,CAAA;IAC3C,sDAAqC,CAAA;IACrC,kDAAiC,CAAA;IACjC,gDAA+B,CAAA;AACjC,CAAC,EAlBW,aAAa,KAAb,aAAa,QAkBxB"}

package/dist/esm/security.barrel.js

@@ -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';
-// PermissionRecorder lives in agentfootprint/observe (it's a recorder, not a security primitive)
-//# sourceMappingURL=security.barrel.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"security.barrel.js","sourceRoot":"","sources":["../../src/security.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAO3D,iGAAiG"}

package/dist/esm/skills.barrel.js

@@ -1,42 +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';
-//# sourceMappingURL=skills.barrel.js.map

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

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

package/dist/esm/stages/augmentPrompt.js

@@ -1,61 +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 { systemMessage } from '../types';
-export function augmentPromptStage(scope) {
-    const result = scope.retrievalResult;
-    // Graceful degradation: if retrieval returned nothing, skip context injection.
-    // LLM proceeds with user query only — useful in hybrid pipelines where retrieval is optional.
-    if (!result || result.chunks.length === 0)
-        return;
-    // Format chunks into numbered context block
-    const context = result.chunks.map((c, i) => `[${i + 1}] ${c.content}`).join('\n\n');
-    scope.contextWindow = context;
-    // Inject context into messages
-    const messages = scope.messages ?? [];
-    const contextMsg = systemMessage(`Use the following context to answer the user's question:\n\n${context}`);
-    // Insert after system prompt if present, otherwise at front.
-    const sysIdx = messages.findIndex((m) => m.role === 'system');
-    let targetIndex;
-    if (sysIdx >= 0) {
-        const updated = [...messages];
-        targetIndex = sysIdx + 1;
-        updated.splice(targetIndex, 0, contextMsg);
-        scope.messages = updated;
-    }
-    else {
-        targetIndex = 0;
-        scope.messages = [contextMsg, ...messages];
-    }
-    // Emit the enriched context-engineering event. Slot tells Lens which
-    // Agent slot to tag (Messages); role + deltaCount surface the actual
-    // wire-level shape (a 2nd `system`-role message); targetIndex pinpoints
-    // where in the array it landed (for the "Inspect messages" drill-down).
-    // Guard $emit — bare scope stubs in tests don't have it.
-    if (typeof scope.$emit === 'function') {
-        scope.$emit('agentfootprint.context.rag.chunks', {
-            slot: 'messages',
-            role: 'system',
-            targetIndex,
-            deltaCount: { system: 1 },
-            chunkCount: result.chunks.length,
-            topScore: result.chunks[0]?.score,
-            // Defensive: only pass text previews + scores, not full chunk bodies —
-            // keeps emit-channel payloads small for the consumer callback path.
-            preview: result.chunks.slice(0, 3).map((c) => ({
-                score: c.score,
-                textPreview: (c.content ?? '').slice(0, 120),
-            })),
-        });
-    }
-}
-//# sourceMappingURL=augmentPrompt.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"augmentPrompt.js","sourceRoot":"","sources":["../../../src/stages/augmentPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,UAAU,kBAAkB,CAAC,KAA2B;IAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC;IACrC,+EAA+E;IAC/E,8FAA8F;IAC9F,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAElD,4CAA4C;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEpF,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC;IAE9B,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,aAAa,CAC9B,+DAA+D,OAAO,EAAE,CACzE,CAAC;IAEF,6DAA6D;IAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC9D,IAAI,WAAmB,CAAC;IACxB,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC9B,WAAW,GAAG,MAAM,GAAG,CAAC,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QAC3C,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,CAAC,CAAC;QAChB,KAAK,CAAC,QAAQ,GAAG,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,qEAAqE;IACrE,qEAAqE;IACrE,wEAAwE;IACxE,wEAAwE;IACxE,yDAAyD;IACzD,IAAI,OAAQ,KAAwC,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC1E,KAAK,CAAC,KAAK,CAAC,mCAAmC,EAAE;YAC/C,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAiB;YACvB,WAAW;YACX,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;YACzB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;YAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK;YACjC,uEAAuE;YACvE,oEAAoE;YACpE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7C,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aAC7C,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/esm/stages/callLLM.js

@@ -1,15 +0,0 @@
-/**
- * CallLLM stage — sends messages to LLM via adapter, writes AdapterResult to scope.
- */
-import { normalizeAdapterResponse } from './helpers';
-export function createCallLLMStage(provider) {
-    return async (scope) => {
-        const messages = scope.messages ?? [];
-        const tools = scope.toolDescriptions ?? [];
-        const options = tools.length > 0 ? { tools } : undefined;
-        const response = await provider.chat(messages, options);
-        scope.adapterRawResponse = response;
-        scope.adapterResult = normalizeAdapterResponse(response);
-    };
-}
-//# sourceMappingURL=callLLM.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"callLLM.js","sourceRoot":"","sources":["../../../src/stages/callLLM.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,UAAU,kBAAkB,CAAC,QAAqB;IACtD,OAAO,KAAK,EAAE,KAA+B,EAAE,EAAE;QAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC;QAE3C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAExD,KAAK,CAAC,kBAAkB,GAAG,QAAQ,CAAC;QACpC,KAAK,CAAC,aAAa,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/stages/finalize.js

@@ -1,12 +0,0 @@
-/**
- * Finalize stage — extract the final response from conversation.
- */
-import { getTextContent } from '../types/content';
-import { lastAssistantMessage } from '../memory';
-export function finalizeStage(scope) {
-    const messages = scope.messages ?? [];
-    const lastAsst = lastAssistantMessage(messages);
-    const result = lastAsst ? getTextContent(lastAsst.content) : '';
-    scope.result = result;
-}
-//# sourceMappingURL=finalize.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"finalize.js","sourceRoot":"","sources":["../../../src/stages/finalize.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,UAAU,aAAa,CAAC,KAA+B;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;AACxB,CAAC"}

package/dist/esm/stages/helpers.js

@@ -1,58 +0,0 @@
-/**
- * Shared helpers for agent stages.
- */
-import { toolResultMessage } from '../types';
-import { appendMessage } from '../memory';
-/**
- * Normalize an LLMResponse into an AdapterResult discriminated union.
- * Shared by callLLM stage and createAdapterSubflow.
- */
-export function normalizeAdapterResponse(response) {
-    if (response.toolCalls && response.toolCalls.length > 0) {
-        return {
-            type: 'tools',
-            content: response.content ?? '',
-            toolCalls: response.toolCalls,
-            usage: response.usage,
-            model: response.model,
-        };
-    }
-    return {
-        type: 'final',
-        content: response.content,
-        usage: response.usage,
-        model: response.model,
-    };
-}
-/**
- * Execute tool calls and append results to conversation messages.
- * Returns the updated messages array.
- */
-export async function executeToolCalls(toolCalls, registry, messages) {
-    let msgs = messages;
-    for (const toolCall of toolCalls) {
-        const tool = registry.get(toolCall.name);
-        let resultContent;
-        if (!tool) {
-            resultContent = JSON.stringify({
-                error: true,
-                message: `Tool '${toolCall.name}' not found`,
-            });
-        }
-        else {
-            try {
-                const result = await tool.handler(toolCall.arguments);
-                resultContent = result.content;
-            }
-            catch (err) {
-                resultContent = JSON.stringify({
-                    error: true,
-                    message: err instanceof Error ? err.message : String(err),
-                });
-            }
-        }
-        msgs = appendMessage(msgs, toolResultMessage(resultContent, toolCall.id));
-    }
-    return msgs;
-}
-//# sourceMappingURL=helpers.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/stages/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAqB;IAC5D,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;YAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAqB,EACrB,QAAsB,EACtB,QAAmB;IAEnB,IAAI,IAAI,GAAG,QAAQ,CAAC;IAEpB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,aAAqB,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC7B,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,SAAS,QAAQ,CAAC,IAAI,aAAa;aAC7C,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACtD,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;YACjC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;oBAC7B,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,iBAAiB,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/esm/stages/index.js

@@ -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.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","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/esm/stages/parseResponse.js

@@ -1,25 +0,0 @@
-/**
- * ParseResponse stage — extract ParsedResponse from AdapterResult.
- * Also appends assistant message to conversation history.
- */
-import { assistantMessage } from '../types';
-import { appendMessage } from '../memory';
-export function parseResponseStage(scope) {
-    const result = scope.adapterResult;
-    if (!result) {
-        throw new Error('ParseResponse: no adapter result in scope');
-    }
-    if (result.type === 'error') {
-        throw new Error(`LLM call failed: [${result.code}] ${result.message}`);
-    }
-    const parsed = {
-        hasToolCalls: result.type === 'tools',
-        toolCalls: result.type === 'tools' ? result.toolCalls : [],
-        content: result.content,
-    };
-    scope.parsedResponse = parsed;
-    const messages = scope.messages ?? [];
-    const asstMsg = assistantMessage(result.content, result.type === 'tools' ? result.toolCalls : undefined);
-    scope.messages = appendMessage(messages, asstMsg);
-}
-//# sourceMappingURL=parseResponse.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"parseResponse.js","sourceRoot":"","sources":["../../../src/stages/parseResponse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,kBAAkB,CAAC,KAA+B;IAChE,MAAM,MAAM,GAAG,KAAK,CAAC,aAA0C,CAAC;IAEhE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,MAAM,GAAG;QACb,YAAY,EAAE,MAAM,CAAC,IAAI,KAAK,OAAO;QACrC,SAAS,EAAE,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;QAC1D,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;IAEF,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC;IAE9B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,gBAAgB,CAC9B,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACvD,CAAC;IACF,KAAK,CAAC,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC"}

package/dist/esm/stages/retrieve.js

@@ -1,28 +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 { getTextContent } from '../types/content';
-export function createRetrieveStage(retriever, options) {
-    return async (scope) => {
-        // Use explicit retrieval query if set, otherwise last user message
-        const lastUserContent = (scope.messages ?? []).filter((m) => m.role === 'user').pop()?.content;
-        const query = scope.retrievalQuery ?? (lastUserContent ? getTextContent(lastUserContent) : '');
-        const result = await retriever.retrieve(query, options);
-        // Write to scope — recorders observe this
-        scope.retrievalResult = result;
-        // Note: the context-engineering emit fires from augmentPrompt (the
-        // stage that actually injects the system message), not here. Reason:
-        // augmentPrompt has access to the final `messages[]` AND the role +
-        // targetIndex of the injected message — full picture in one event.
-        // Retrieve's job is just to fetch + write the result; emitting here
-        // would force consumers to correlate two events to learn what
-        // ultimately landed in the prompt.
-    };
-}
-//# sourceMappingURL=retrieve.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"retrieve.js","sourceRoot":"","sources":["../../../src/stages/retrieve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,UAAU,mBAAmB,CAAC,SAA4B,EAAE,OAAyB;IACzF,OAAO,KAAK,EAAE,KAA2B,EAAE,EAAE;QAC3C,mEAAmE;QACnE,MAAM,eAAe,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC;QAC/F,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE/F,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAExD,0CAA0C;QAC1C,KAAK,CAAC,eAAe,GAAG,MAAM,CAAC;QAE/B,mEAAmE;QACnE,qEAAqE;QACrE,oEAAoE;QACpE,mEAAmE;QACnE,oEAAoE;QACpE,8DAA8D;QAC9D,mCAAmC;IACrC,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/stages/runnerAsStage.js

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

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

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

package/dist/esm/stream.barrel.js

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

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

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

package/dist/esm/streaming/EventDispatcher.js

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

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

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

package/dist/esm/streaming/StreamEmitter.js

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

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

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

package/dist/esm/streaming/StreamEventRecorder.js

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

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

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

package/dist/esm/streaming/index.js

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