agentfootprint 1.0.0

package/dist/esm/lib/slots/messages/buildMessagesSubflow.js

@@ -0,0 +1,108 @@
+/**
+ * Messages slot — builds a subflow that prepares conversation history.
+ *
+ * Always a subflow because:
+ *   - Config determines complexity: 1 stage (in-memory) or 3 stages (persistent)
+ *   - Parent chart never changes when memory backend grows
+ *   - BehindTheScenes drill-down shows exactly how messages were prepared
+ *
+ * State key convention (typed via MessagesSubflowState):
+ *   Input:  `currentMessages` — set by inputMapper from parent's `messages`
+ *   Output: `memory_preparedMessages` — read by outputMapper, copied to parent's `messages`
+ *   Output: `memory_storedHistory` — (persistent only) for CommitMemory reconstruction
+ *
+ * In-memory mode (no store):
+ *   [ApplyStrategy]
+ *
+ * Persistent mode (with store):
+ *   [LoadHistory → ApplyStrategy → TrackPrepared]
+ */
+import { flowChart } from 'footprintjs';
+import { findLastUserMessage, extractTextContent } from '../helpers';
+/**
+ * Build a MessageContext from scope state.
+ */
+function buildMessageContext(scope, messages) {
+    const loopCount = scope.loopCount ?? 0;
+    const lastUserMsg = findLastUserMessage(messages);
+    const message = lastUserMsg ? extractTextContent(lastUserMsg) : '';
+    return {
+        message,
+        turnNumber: loopCount,
+        loopIteration: loopCount,
+        signal: scope.$getEnv()?.signal,
+    };
+}
+/**
+ * Build the Messages slot subflow from config.
+ *
+ * Mount with:
+ * ```typescript
+ * builder.addSubFlowChartNext('sf-messages', buildMessagesSubflow(config), 'Messages', {
+ *   inputMapper: (parent) => ({
+ *     currentMessages: parent.messages ?? [],
+ *     loopCount: parent.loopCount ?? 0,
+ *   }),
+ *   outputMapper: (sfOutput) => ({
+ *     memory_preparedMessages: sfOutput.memory_preparedMessages,
+ *     memory_storedHistory: sfOutput.memory_storedHistory,
+ *   }),
+ * })
+ * ```
+ */
+export function buildMessagesSubflow(config) {
+    if (!config.strategy) {
+        throw new Error('MessagesSlotConfig: strategy is required');
+    }
+    if (config.store && !config.conversationId) {
+        throw new Error('MessagesSlotConfig: conversationId is required when store is provided');
+    }
+    if (config.store && config.conversationId) {
+        return buildPersistentSubflow(config.strategy, config.store, config.conversationId);
+    }
+    return buildInMemorySubflow(config.strategy);
+}
+/**
+ * In-memory mode: single stage that applies strategy to currentMessages.
+ * Writes result to memory_preparedMessages (outputMapper copies to parent's messages).
+ */
+function buildInMemorySubflow(strategy) {
+    return flowChart('ApplyStrategy', async (scope) => {
+        const messages = scope.currentMessages ?? [];
+        const ctx = buildMessageContext(scope, messages);
+        const decision = await strategy.prepare(messages, ctx);
+        scope.memory_preparedMessages = decision.value;
+    }, 'apply-strategy', undefined, 'Apply message strategy to conversation history').build();
+}
+/**
+ * Persistent mode: load from store → apply strategy → track for CommitMemory.
+ * No non-null assertions — store and conversationId are guaranteed by caller.
+ */
+function buildPersistentSubflow(strategy, store, conversationId) {
+    return flowChart('LoadHistory', async (scope) => {
+        // Stage 1: Load stored history + merge with current turn messages
+        const currentMessages = scope.currentMessages ?? [];
+        const stored = (await store.load(conversationId)) ?? [];
+        const merged = stored.length > 0
+            ? [...stored, ...currentMessages]
+            : currentMessages;
+        // Track full merged history for CommitMemory reconstruction
+        scope.memory_storedHistory = merged;
+    }, 'load-history', undefined, 'Load conversation history from store')
+        .addFunction('ApplyStrategy', async (scope) => {
+        // Stage 2: Apply the message strategy (window, trim, summarize)
+        const merged = scope.memory_storedHistory ?? [];
+        const ctx = buildMessageContext(scope, merged);
+        const decision = await strategy.prepare(merged, ctx);
+        scope.memory_preparedMessages = decision.value;
+    }, 'apply-strategy', 'Apply message strategy to history')
+        .addFunction('TrackPrepared', (scope) => {
+        // Stage 3: Narrative checkpoint (values already in scope for CommitMemory)
+        const stored = scope.memory_storedHistory ?? [];
+        const prepared = scope.memory_preparedMessages ?? [];
+        void stored.length;
+        void prepared.length;
+    }, 'track-prepared', 'Track prepared messages for commit')
+        .build();
+}
+//# sourceMappingURL=buildMessagesSubflow.js.map

package/dist/esm/lib/slots/messages/buildMessagesSubflow.js.map

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

package/dist/esm/lib/slots/messages/index.js

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

package/dist/esm/lib/slots/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/slots/messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/esm/lib/slots/messages/types.js

@@ -0,0 +1,10 @@
+/**
+ * Messages slot types.
+ *
+ * The Messages slot prepares the conversation history before each LLM call.
+ * Always mounted as a subflow — config determines internal stages:
+ *   - Simple (no store): 1 stage [ApplyStrategy]
+ *   - Persistent (with store): 3 stages [LoadHistory → ApplyStrategy → TrackPrepared]
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/lib/slots/messages/types.js.map

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

package/dist/esm/lib/slots/system-prompt/buildSystemPromptSubflow.js

@@ -0,0 +1,64 @@
+/**
+ * SystemPrompt slot — builds a subflow that resolves the system prompt.
+ *
+ * Always a subflow (never a plain stage) because:
+ *   - Subflow with 1 stage = zero overhead, but gives drill-down + narrative for free
+ *   - Config determines internal stages (1 for static, 3+ for RAG-augmented)
+ *   - Parent chart never changes when strategy complexity grows
+ *
+ * The subflow writes the resolved prompt to scope.systemPrompt.
+ * Providers are trusted — they receive raw message history and their output is
+ * stored as-is. Sanitization is the provider's responsibility.
+ *
+ * Flowchart:
+ *   [ResolvePrompt]  (single stage for simple providers)
+ */
+import { flowChart } from 'footprintjs';
+import { findLastUserMessage, extractTextContent } from '../helpers';
+/**
+ * Build a PromptContext from the current scope state.
+ */
+function buildPromptContext(scope) {
+    const messages = scope.messages ?? [];
+    const loopCount = scope.loopCount ?? 0;
+    const lastUserMsg = findLastUserMessage(messages);
+    const message = lastUserMsg ? extractTextContent(lastUserMsg) : '';
+    return {
+        message,
+        turnNumber: loopCount,
+        history: messages,
+        signal: scope.$getEnv()?.signal,
+    };
+}
+/**
+ * Build the SystemPrompt slot subflow from config.
+ *
+ * Returns a FlowChart that can be mounted with addSubFlowChartNext:
+ * ```typescript
+ * builder.addSubFlowChartNext('sf-system-prompt', buildSystemPromptSubflow(config), 'SystemPrompt', { ... })
+ * ```
+ */
+export function buildSystemPromptSubflow(config) {
+    if (!config.provider) {
+        throw new Error('SystemPromptSlotConfig: provider is required');
+    }
+    return flowChart('ResolvePrompt', async (scope) => {
+        const ctx = buildPromptContext(scope);
+        const decision = await config.provider.resolve(ctx);
+        // Merge prompt injections from InstructionsToLLM (if any)
+        const injections = scope.promptInjections;
+        const basePrompt = decision.value;
+        const fullPrompt = injections?.length
+            ? [basePrompt, ...injections].join('\n\n')
+            : basePrompt;
+        scope.systemPrompt = fullPrompt;
+        // Narrative enrichment — decision + prompt preview for BTS visibility
+        scope.promptDecision = decision.chosen !== 'static'
+            ? `${decision.chosen}${decision.rationale ? ` (${decision.rationale})` : ''}`
+            : undefined;
+        const injectionNote = injections?.length ? ` (+${injections.length} instruction injections)` : '';
+        const preview = fullPrompt.length > 60 ? fullPrompt.slice(0, 60) + '...' : fullPrompt;
+        scope.promptSummary = `${fullPrompt.length} chars: "${preview}"${injectionNote}`;
+    }, 'resolve-prompt', undefined, 'Resolve the system prompt using the configured provider strategy').build();
+}
+//# sourceMappingURL=buildSystemPromptSubflow.js.map

package/dist/esm/lib/slots/system-prompt/buildSystemPromptSubflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSystemPromptSubflow.js","sourceRoot":"","sources":["../../../../../src/lib/slots/system-prompt/buildSystemPromptSubflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrE;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAA2C;IACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;IAEvC,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnE,OAAO;QACL,OAAO;QACP,UAAU,EAAE,SAAS;QACrB,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM;KAChC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAA8B;IACrE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,SAAS,CACd,eAAe,EACf,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEpD,0DAA0D;QAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAAC;QAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC;QAClC,MAAM,UAAU,GAAG,UAAU,EAAE,MAAM;YACnC,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YAC1C,CAAC,CAAC,UAAU,CAAC;QAEf,KAAK,CAAC,YAAY,GAAG,UAAU,CAAC;QAEhC,sEAAsE;QACtE,KAAK,CAAC,cAAc,GAAG,QAAQ,CAAC,MAAM,KAAK,QAAQ;YACjD,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7E,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,aAAa,GAAG,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;QACtF,KAAK,CAAC,aAAa,GAAG,GAAG,UAAU,CAAC,MAAM,YAAY,OAAO,IAAI,aAAa,EAAE,CAAC;IACnF,CAAC,EACD,gBAAgB,EAChB,SAAS,EACT,kEAAkE,CACnE,CAAC,KAAK,EAAE,CAAC;AACZ,CAAC"}

package/dist/esm/lib/slots/system-prompt/index.js

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

package/dist/esm/lib/slots/system-prompt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/slots/system-prompt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/esm/lib/slots/system-prompt/types.js

@@ -0,0 +1,9 @@
+/**
+ * SystemPrompt slot types.
+ *
+ * The SystemPrompt slot resolves the system prompt string before each LLM call.
+ * It is always mounted as a subflow — even for a static string, the subflow
+ * has one stage. Config determines what stages go inside.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/lib/slots/system-prompt/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/lib/slots/system-prompt/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/esm/lib/slots/tools/buildToolsSubflow.js

@@ -0,0 +1,67 @@
+/**
+ * Tools slot — builds a subflow that resolves available tools.
+ *
+ * Always a subflow because:
+ *   - Config determines complexity: 1 stage (static) or 2+ (gated/dynamic)
+ *   - Parent chart never changes when tool resolution grows
+ *   - BehindTheScenes shows exactly which tools were resolved and why
+ *
+ * Providers are trusted — their output is stored as-is.
+ * Providers receive raw message history for context-dependent resolution.
+ *
+ * Flowchart:
+ *   [ResolveTools]  (single stage — ToolProvider.resolve() handles all complexity)
+ */
+import { flowChart } from 'footprintjs';
+import { findLastUserMessage, extractTextContent } from '../helpers';
+/**
+ * Build a ToolContext from the current scope state.
+ */
+function buildToolContext(scope) {
+    const messages = scope.messages ?? [];
+    const loopCount = scope.loopCount ?? 0;
+    const lastUserMsg = findLastUserMessage(messages);
+    const message = lastUserMsg ? extractTextContent(lastUserMsg) : '';
+    return {
+        message,
+        turnNumber: loopCount,
+        loopIteration: loopCount,
+        messages,
+        signal: scope.$getEnv()?.signal,
+    };
+}
+/**
+ * Build the Tools slot subflow from config.
+ *
+ * Returns a FlowChart mountable with addSubFlowChartNext.
+ */
+export function buildToolsSubflow(config) {
+    if (!config.provider) {
+        throw new Error('ToolsSlotConfig: provider is required');
+    }
+    return flowChart('ResolveTools', async (scope) => {
+        const ctx = buildToolContext(scope);
+        const decision = await config.provider.resolve(ctx);
+        // Merge tool injections from InstructionsToLLM (if any)
+        // Deduplicate by name — base tools take precedence over injected.
+        // Note: dedup compares injected `name` (converted from ToolDefinition.id)
+        // against base tool `name`. Works when base ToolProvider uses id as name.
+        const injections = scope.toolInjections;
+        const baseNames = new Set(decision.value.map((t) => t.name));
+        const newTools = injections?.length
+            ? injections.filter((t) => !baseNames.has(t.name))
+            : [];
+        const allTools = newTools.length
+            ? [...decision.value, ...newTools]
+            : decision.value;
+        scope.toolDescriptions = allTools;
+        // Narrative enrichment — decision + tool summary for BTS visibility
+        scope.toolDecision = decision.chosen !== 'static'
+            ? `${decision.chosen}${decision.rationale ? ` (${decision.rationale})` : ''}`
+            : undefined;
+        const injectionNote = newTools.length > 0 ? ` (+${newTools.length} from instructions)` : '';
+        const names = allTools.map((t) => t.name ?? '?');
+        scope.resolvedTools = `${allTools.length} tools: ${names.join(', ')}${injectionNote}`;
+    }, 'resolve-tools', undefined, 'Resolve available tools using the configured provider strategy').build();
+}
+//# sourceMappingURL=buildToolsSubflow.js.map

package/dist/esm/lib/slots/tools/buildToolsSubflow.js.map

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

package/dist/esm/lib/slots/tools/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/slots/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/lib/slots/tools/types.js

@@ -0,0 +1,11 @@
+/**
+ * Tools slot types.
+ *
+ * The Tools slot resolves available tools before each LLM call.
+ * Always mounted as a subflow — config determines internal stages:
+ *   - Fixed set: 1 stage [ResolveTools]
+ *   - Gated: 2 stages [CheckPermissions → ResolveTools]
+ *   - Dynamic: 2 stages [ClassifyContext → ResolveTools]
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/lib/slots/tools/types.js.map

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

package/dist/esm/lib/swarm/buildSwarmRouting.js

@@ -0,0 +1,207 @@
+/**
+ * buildSwarmRouting — Creates a RoutingConfig for Swarm specialist routing.
+ *
+ * Used by the Swarm builder to plug into buildAgentLoop. The Swarm routing
+ * replaces the default Agent routing (tool-calls | final) with specialist
+ * routing (specialist-A | specialist-B | swarm-tools | final).
+ *
+ * Each specialist is mounted as a lazy subflow branch — only built when selected.
+ * Extra tools (non-specialist) get an inline function branch.
+ *
+ * **First-match dispatch:** Iterates toolCalls to find the first specialist or
+ * extra tool match. That branch runs; remaining specialist calls get synthetic
+ * "deferred" tool-results so the LLM sees a response for every tool_call ID.
+ * Extra tools are all executed in one pass by the swarm-tools subflow.
+ */
+import { flowChart } from 'footprintjs';
+import { toolResultMessage } from '../../types';
+import { getTextContent } from '../../types/content';
+import { lastAssistantMessage } from '../../memory';
+/** Type guard: does the runner expose toFlowChart() for subflow composition? */
+function hasFlowChart(runner) {
+    return typeof runner.toFlowChart === 'function';
+}
+// ── Builder ──────────────────────────────────────────────────
+/**
+ * Build a RoutingConfig for Swarm specialist routing.
+ *
+ * Replaces the entire `buildSwarmLoop` — this function produces
+ * just the routing strategy. The loop itself is built by `buildAgentLoop`.
+ */
+export function buildSwarmRouting(config) {
+    const { specialists, extraTools } = config;
+    let fallbackIdCounter = 0; // Per-routing instance, not module-level
+    const specialistIds = new Set(specialists.map((s) => s.id));
+    const extraToolIds = new Set((extraTools ?? []).map((t) => t.id));
+    // Validate: no specialist ID collides with extra tool ID
+    for (const t of extraTools ?? []) {
+        if (specialistIds.has(t.id)) {
+            throw new Error(`Extra tool '${t.id}' collides with specialist ID. Use a different tool ID.`);
+        }
+    }
+    // ── Decider ──────────────────────────────────────────────
+    const MAX_MESSAGE_LEN = 100_000; // 100KB — prevents LLM-controlled DoS
+    const decider = (scope, _breakFn, _streamCb) => {
+        const parsed = scope.parsedResponse;
+        if (!parsed?.hasToolCalls || !parsed.toolCalls?.length)
+            return 'final';
+        // Find the first specialist or extra tool call (first-match semantics)
+        let matchedIndex = -1;
+        let matchedBranch = 'final';
+        for (let i = 0; i < parsed.toolCalls.length; i++) {
+            const toolCall = parsed.toolCalls[i];
+            const toolName = toolCall.name;
+            if (specialistIds.has(toolName)) {
+                const args = toolCall.arguments;
+                const rawMsg = args?.message;
+                const msg = typeof rawMsg === 'string' ? rawMsg : '';
+                scope.specialistMessage = msg.length > MAX_MESSAGE_LEN ? msg.slice(0, MAX_MESSAGE_LEN) : msg;
+                scope.specialistToolCallId = toolCall.id;
+                matchedIndex = i;
+                matchedBranch = toolName;
+                break;
+            }
+            if (extraToolIds.has(toolName)) {
+                scope.specialistToolCallId = toolCall.id;
+                matchedIndex = i;
+                matchedBranch = 'swarm-tools';
+                break;
+            }
+        }
+        // Inject synthetic tool-results for non-dispatched tool calls.
+        // LLMs expect every tool_call ID to have a matching tool_result.
+        const skipped = [];
+        for (let i = 0; i < parsed.toolCalls.length; i++) {
+            if (i === matchedIndex)
+                continue;
+            const tc = parsed.toolCalls[i];
+            if (specialistIds.has(tc.name)) {
+                skipped.push({ content: 'Deferred — will be handled in next iteration.', toolCallId: tc.id });
+            }
+            else if (!extraToolIds.has(tc.name)) {
+                skipped.push({ content: `Unknown tool: ${String(tc.name).slice(0, 100)}`, toolCallId: tc.id });
+            }
+            // Extra tools in swarm-tools branch are handled by the subflow
+        }
+        if (skipped.length > 0) {
+            scope.skippedToolResults = skipped;
+        }
+        if (matchedIndex === -1) {
+            const unknownNames = parsed.toolCalls.map((tc) => String(tc.name).slice(0, 50)).join(', ');
+            scope.routingWarning = `Unknown tool(s): ${unknownNames}`;
+            return 'final';
+        }
+        return matchedBranch;
+    };
+    // ── Branches ─────────────────────────────────────────────
+    const branches = [];
+    // Specialist branches — each as a lazy subflow (cached)
+    for (const specialist of specialists) {
+        let cachedChart;
+        branches.push({
+            id: specialist.id,
+            kind: 'lazy-subflow',
+            name: specialist.id,
+            factory: () => {
+                if (cachedChart)
+                    return cachedChart;
+                // Use specialist's own flowchart if available (for BTS drill-down)
+                if (hasFlowChart(specialist.runner)) {
+                    cachedChart = specialist.runner.toFlowChart();
+                    return cachedChart;
+                }
+                // Fallback: wrap runner.run() in a single-stage flowchart
+                cachedChart = flowChart(specialist.id, async (scope) => {
+                    const res = await specialist.runner.run(scope.message ?? '');
+                    scope.result = res.content;
+                }, `${specialist.id}-run`, undefined, `Execute ${specialist.id} specialist`).build();
+                return cachedChart;
+            },
+            mount: {
+                inputMapper: (parent) => ({
+                    message: parent.specialistMessage ?? '',
+                }),
+                outputMapper: (sfOutput, parentScope) => {
+                    const resultContent = String(sfOutput.result ?? sfOutput.content ?? '');
+                    const toolCallId = String(parentScope.specialistToolCallId ?? `specialist-${++fallbackIdCounter}`);
+                    const preview = resultContent.length > 120 ? resultContent.slice(0, 120) + '...' : resultContent;
+                    // Include synthetic results for skipped tool calls (LLMs expect every call to have a result)
+                    const skipped = (parentScope.skippedToolResults ?? []);
+                    const skippedMessages = skipped.map((s) => toolResultMessage(s.content, s.toolCallId));
+                    return {
+                        messages: [toolResultMessage(resultContent, toolCallId), ...skippedMessages],
+                        loopCount: (parentScope.loopCount ?? 0) + 1,
+                        specialistResult: preview,
+                        invokedSpecialists: [specialist.id],
+                    };
+                },
+            },
+        });
+    }
+    // Swarm-tools branch — executes ALL extra tool calls from the response.
+    // Uses a subflow so narrative/recorders see tool execution as structured events.
+    if (extraTools && extraTools.length > 0) {
+        const toolMap = new Map(extraTools.map((t) => [t.id, t]));
+        const swarmToolSubflow = flowChart('ExecuteSwarmTools', async (scope) => {
+            const parsed = scope.parsedResponse;
+            const toolCalls = parsed?.toolCalls ?? [];
+            const results = [];
+            // Execute ALL extra tool calls sequentially
+            for (const toolCall of toolCalls) {
+                const tool = toolMap.get(toolCall.name);
+                if (!tool)
+                    continue; // skip specialist calls and unknowns
+                try {
+                    const result = await tool.handler(toolCall.arguments);
+                    results.push({ content: result.content, toolCallId: toolCall.id });
+                }
+                catch (err) {
+                    const errMsg = err instanceof Error ? err.message : String(err);
+                    results.push({ content: `Error: ${errMsg}`, toolCallId: toolCall.id });
+                }
+            }
+            scope.toolResults = results;
+        }, 'execute-swarm-tools', undefined, 'Execute all non-specialist tool calls').build();
+        branches.push({
+            id: 'swarm-tools',
+            kind: 'subflow',
+            name: 'ExecuteSwarmTools',
+            chart: swarmToolSubflow,
+            mount: {
+                inputMapper: (parent) => ({
+                    parsedResponse: parent.parsedResponse,
+                }),
+                outputMapper: (sfOutput, parentScope) => {
+                    const results = (sfOutput.toolResults ?? []);
+                    // Delta: return all tool result messages for array concat
+                    return {
+                        messages: results.map((r) => toolResultMessage(r.content, r.toolCallId)),
+                        loopCount: (parentScope.loopCount ?? 0) + 1,
+                    };
+                },
+            },
+        });
+    }
+    // Final branch
+    branches.push({
+        id: 'final',
+        kind: 'fn',
+        name: 'Finalize',
+        fn: (scope, breakFn) => {
+            const messages = scope.messages ?? [];
+            const lastAsst = lastAssistantMessage(messages);
+            scope.result = (lastAsst ? getTextContent(lastAsst.content) : scope.parsedResponse?.content) ?? '';
+            breakFn();
+        },
+        description: 'Extract final answer and stop the swarm loop',
+    });
+    return {
+        deciderName: 'RouteSpecialist',
+        deciderId: 'route-specialist',
+        deciderDescription: 'Route to the specialist the LLM selected, or finalize',
+        decider,
+        branches,
+        defaultBranch: 'final',
+    };
+}
+//# sourceMappingURL=buildSwarmRouting.js.map

package/dist/esm/lib/swarm/buildSwarmRouting.js.map

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

package/dist/esm/lib/swarm/index.js

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

package/dist/esm/lib/swarm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/swarm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/memory/conversationHelpers.js

@@ -0,0 +1,56 @@
+/**
+ * Pure functions for conversation message management.
+ * No state — just transformations on message arrays.
+ */
+import { contentLength, hasToolCalls, toolResultMessage } from '../types';
+/** Append a message to the conversation. Returns new array. */
+export function appendMessage(messages, message) {
+    return [...messages, message];
+}
+/** Get the last message in the conversation. */
+export function lastMessage(messages) {
+    return messages[messages.length - 1];
+}
+/** Get the last assistant message. */
+export function lastAssistantMessage(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        if (messages[i].role === 'assistant')
+            return messages[i];
+    }
+    return undefined;
+}
+/** Check if the last assistant message has tool calls. */
+export function lastMessageHasToolCalls(messages) {
+    const last = lastAssistantMessage(messages);
+    return last ? hasToolCalls(last) : false;
+}
+/** Sliding window: keep last N messages (always keep system message). */
+export function slidingWindow(messages, windowSize) {
+    if (messages.length <= windowSize)
+        return messages;
+    const system = messages.filter((m) => m.role === 'system');
+    const rest = messages.filter((m) => m.role !== 'system');
+    const kept = rest.slice(-windowSize);
+    return [...system, ...kept];
+}
+/** Truncate messages to fit within a character budget (rough token proxy). */
+export function truncateToCharBudget(messages, maxChars) {
+    const system = messages.filter((m) => m.role === 'system');
+    const rest = messages.filter((m) => m.role !== 'system');
+    let totalChars = system.reduce((sum, m) => sum + contentLength(m.content), 0);
+    const kept = [];
+    // Walk backwards, keep most recent messages first
+    for (let i = rest.length - 1; i >= 0; i--) {
+        const msgChars = contentLength(rest[i].content);
+        if (totalChars + msgChars > maxChars)
+            break;
+        totalChars += msgChars;
+        kept.unshift(rest[i]);
+    }
+    return [...system, ...kept];
+}
+/** Create tool result messages from a map of tool call ID → result. */
+export function createToolResults(results) {
+    return results.map((r) => toolResultMessage(r.content, r.toolCallId));
+}
+//# sourceMappingURL=conversationHelpers.js.map

package/dist/esm/memory/conversationHelpers.js.map

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

package/dist/esm/memory/index.js

@@ -0,0 +1,2 @@
+export { appendMessage, lastMessage, lastAssistantMessage, lastMessageHasToolCalls, slidingWindow, truncateToCharBudget, createToolResults, } from './conversationHelpers';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}

package/dist/esm/models/index.js

@@ -0,0 +1,3 @@
+export { anthropic, openai, ollama, bedrock } from './providers';
+export { DEFAULT_PRICING, lookupPricing } from './pricing';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}