agentfootprint 1.0.0

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

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * 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]
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/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/lib/slots/system-prompt/buildSystemPromptSubflow.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSystemPromptSubflow = void 0;
+const footprintjs_1 = require("footprintjs");
+const helpers_1 = require("../helpers");
+/**
+ * Build a PromptContext from the current scope state.
+ */
+function buildPromptContext(scope) {
+    const messages = scope.messages ?? [];
+    const loopCount = scope.loopCount ?? 0;
+    const lastUserMsg = (0, helpers_1.findLastUserMessage)(messages);
+    const message = lastUserMsg ? (0, helpers_1.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', { ... })
+ * ```
+ */
+function buildSystemPromptSubflow(config) {
+    if (!config.provider) {
+        throw new Error('SystemPromptSlotConfig: provider is required');
+    }
+    return (0, footprintjs_1.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();
+}
+exports.buildSystemPromptSubflow = buildSystemPromptSubflow;
+//# sourceMappingURL=buildSystemPromptSubflow.js.map

package/dist/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,6CAAwC;AAIxC,wCAAqE;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,IAAA,6BAAmB,EAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,IAAA,4BAAkB,EAAC,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,SAAgB,wBAAwB,CAAC,MAA8B;IACrE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAA,uBAAS,EACd,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;AAhCD,4DAgCC"}

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

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSystemPromptSubflow = void 0;
+var buildSystemPromptSubflow_1 = require("./buildSystemPromptSubflow");
+Object.defineProperty(exports, "buildSystemPromptSubflow", { enumerable: true, get: function () { return buildSystemPromptSubflow_1.buildSystemPromptSubflow; } });
+//# sourceMappingURL=index.js.map

package/dist/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,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA"}

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

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/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/lib/slots/tools/buildToolsSubflow.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildToolsSubflow = void 0;
+const footprintjs_1 = require("footprintjs");
+const helpers_1 = require("../helpers");
+/**
+ * Build a ToolContext from the current scope state.
+ */
+function buildToolContext(scope) {
+    const messages = scope.messages ?? [];
+    const loopCount = scope.loopCount ?? 0;
+    const lastUserMsg = (0, helpers_1.findLastUserMessage)(messages);
+    const message = lastUserMsg ? (0, helpers_1.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.
+ */
+function buildToolsSubflow(config) {
+    if (!config.provider) {
+        throw new Error('ToolsSlotConfig: provider is required');
+    }
+    return (0, footprintjs_1.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();
+}
+exports.buildToolsSubflow = buildToolsSubflow;
+//# sourceMappingURL=buildToolsSubflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildToolsSubflow.js","sourceRoot":"","sources":["../../../../src/lib/slots/tools/buildToolsSubflow.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,6CAAwC;AAIxC,wCAAqE;AAGrE;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAoC;IAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;IAEvC,MAAM,WAAW,GAAG,IAAA,6BAAmB,EAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,IAAA,4BAAkB,EAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnE,OAAO;QACL,OAAO;QACP,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,SAAS;QACxB,QAAQ;QACR,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM;KAChC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,MAAuB;IACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,IAAA,uBAAS,EACd,cAAc,EACd,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEpD,wDAAwD;QACxD,kEAAkE;QAClE,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,UAAU,EAAE,MAAM;YACjC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM;YAC9B,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC;YAClC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAEnB,KAAK,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QAElC,oEAAoE;QACpE,KAAK,CAAC,YAAY,GAAG,QAAQ,CAAC,MAAM,KAAK,QAAQ;YAC/C,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,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;QACjD,KAAK,CAAC,aAAa,GAAG,GAAG,QAAQ,CAAC,MAAM,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC;IACxF,CAAC,EACD,eAAe,EACf,SAAS,EACT,gEAAgE,CACjE,CAAC,KAAK,EAAE,CAAC;AACZ,CAAC;AAtCD,8CAsCC"}

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

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildToolsSubflow = void 0;
+var buildToolsSubflow_1 = require("./buildToolsSubflow");
+Object.defineProperty(exports, "buildToolsSubflow", { enumerable: true, get: function () { return buildToolsSubflow_1.buildToolsSubflow; } });
+//# sourceMappingURL=index.js.map

package/dist/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,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}

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

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * 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]
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/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/lib/swarm/buildSwarmRouting.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSwarmRouting = void 0;
+const footprintjs_1 = require("footprintjs");
+const types_1 = require("../../types");
+const content_1 = require("../../types/content");
+const memory_1 = require("../../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`.
+ */
+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 = (0, footprintjs_1.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) => (0, types_1.toolResultMessage)(s.content, s.toolCallId));
+                    return {
+                        messages: [(0, types_1.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 = (0, footprintjs_1.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) => (0, types_1.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 = (0, memory_1.lastAssistantMessage)(messages);
+            scope.result = (lastAsst ? (0, content_1.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',
+    };
+}
+exports.buildSwarmRouting = buildSwarmRouting;
+//# sourceMappingURL=buildSwarmRouting.js.map

package/dist/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/lib/swarm/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSwarmRouting = void 0;
+var buildSwarmRouting_1 = require("./buildSwarmRouting");
+Object.defineProperty(exports, "buildSwarmRouting", { enumerable: true, get: function () { return buildSwarmRouting_1.buildSwarmRouting; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/swarm/index.ts"],"names":[],"mappings":";;;AAAA,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}

package/dist/memory/conversationHelpers.js

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

package/dist/memory/conversationHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationHelpers.js","sourceRoot":"","sources":["../../src/memory/conversationHelpers.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,oCAA0E;AAE1E,+DAA+D;AAC/D,SAAgB,aAAa,CAAC,QAAmB,EAAE,OAAgB;IACjE,OAAO,CAAC,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAC;AAChC,CAAC;AAFD,sCAEC;AAED,gDAAgD;AAChD,SAAgB,WAAW,CAAC,QAAmB;IAC7C,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAFD,kCAEC;AAED,sCAAsC;AACtC,SAAgB,oBAAoB,CAAC,QAAmB;IACtD,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,QAAQ,CAAC,CAAC,CAAqB,CAAC;IAC/E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AALD,oDAKC;AAED,0DAA0D;AAC1D,SAAgB,uBAAuB,CAAC,QAAmB;IACzD,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAA,oBAAY,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3C,CAAC;AAHD,0DAGC;AAED,yEAAyE;AACzE,SAAgB,aAAa,CAAC,QAAmB,EAAE,UAAkB;IACnE,IAAI,QAAQ,CAAC,MAAM,IAAI,UAAU;QAAE,OAAO,QAAQ,CAAC;IAEnD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;IAErC,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AAC9B,CAAC;AARD,sCAQC;AAED,8EAA8E;AAC9E,SAAgB,oBAAoB,CAAC,QAAmB,EAAE,QAAgB;IACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAEzD,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAA,qBAAa,EAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAc,EAAE,CAAC;IAE3B,kDAAkD;IAClD,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAA,qBAAa,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,UAAU,GAAG,QAAQ,GAAG,QAAQ;YAAE,MAAM;QAC5C,UAAU,IAAI,QAAQ,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AAC9B,CAAC;AAhBD,oDAgBC;AAED,uEAAuE;AACvE,SAAgB,iBAAiB,CAC/B,OAAuD;IAEvD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,yBAAiB,EAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AACxE,CAAC;AAJD,8CAIC"}

package/dist/memory/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createToolResults = exports.truncateToCharBudget = exports.slidingWindow = exports.lastMessageHasToolCalls = exports.lastAssistantMessage = exports.lastMessage = exports.appendMessage = void 0;
+var conversationHelpers_1 = require("./conversationHelpers");
+Object.defineProperty(exports, "appendMessage", { enumerable: true, get: function () { return conversationHelpers_1.appendMessage; } });
+Object.defineProperty(exports, "lastMessage", { enumerable: true, get: function () { return conversationHelpers_1.lastMessage; } });
+Object.defineProperty(exports, "lastAssistantMessage", { enumerable: true, get: function () { return conversationHelpers_1.lastAssistantMessage; } });
+Object.defineProperty(exports, "lastMessageHasToolCalls", { enumerable: true, get: function () { return conversationHelpers_1.lastMessageHasToolCalls; } });
+Object.defineProperty(exports, "slidingWindow", { enumerable: true, get: function () { return conversationHelpers_1.slidingWindow; } });
+Object.defineProperty(exports, "truncateToCharBudget", { enumerable: true, get: function () { return conversationHelpers_1.truncateToCharBudget; } });
+Object.defineProperty(exports, "createToolResults", { enumerable: true, get: function () { return conversationHelpers_1.createToolResults; } });
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":";;;AAAA,6DAQ+B;AAP7B,oHAAA,aAAa,OAAA;AACb,kHAAA,WAAW,OAAA;AACX,2HAAA,oBAAoB,OAAA;AACpB,8HAAA,uBAAuB,OAAA;AACvB,oHAAA,aAAa,OAAA;AACb,2HAAA,oBAAoB,OAAA;AACpB,wHAAA,iBAAiB,OAAA"}

package/dist/models/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookupPricing = exports.DEFAULT_PRICING = exports.bedrock = exports.ollama = exports.openai = exports.anthropic = void 0;
+var providers_1 = require("./providers");
+Object.defineProperty(exports, "anthropic", { enumerable: true, get: function () { return providers_1.anthropic; } });
+Object.defineProperty(exports, "openai", { enumerable: true, get: function () { return providers_1.openai; } });
+Object.defineProperty(exports, "ollama", { enumerable: true, get: function () { return providers_1.ollama; } });
+Object.defineProperty(exports, "bedrock", { enumerable: true, get: function () { return providers_1.bedrock; } });
+var pricing_1 = require("./pricing");
+Object.defineProperty(exports, "DEFAULT_PRICING", { enumerable: true, get: function () { return pricing_1.DEFAULT_PRICING; } });
+Object.defineProperty(exports, "lookupPricing", { enumerable: true, get: function () { return pricing_1.lookupPricing; } });
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":";;;AACA,yCAAiE;AAAxD,sGAAA,SAAS,OAAA;AAAE,mGAAA,MAAM,OAAA;AAAE,mGAAA,MAAM,OAAA;AAAE,oGAAA,OAAO,OAAA;AAC3C,qCAA2D;AAAlD,0GAAA,eAAe,OAAA;AAAE,wGAAA,aAAa,OAAA"}

package/dist/models/pricing.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Default pricing tables per model (USD per 1M tokens).
+ * Used by CostRecorder for automatic cost calculation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookupPricing = exports.DEFAULT_PRICING = void 0;
+exports.DEFAULT_PRICING = {
+    // Anthropic
+    'claude-opus-4-20250514': { input: 15, output: 75 },
+    'claude-sonnet-4-20250514': { input: 3, output: 15 },
+    'claude-haiku-4-5-20251001': { input: 0.8, output: 4 },
+    // OpenAI
+    'gpt-4o': { input: 2.5, output: 10 },
+    'gpt-4o-mini': { input: 0.15, output: 0.6 },
+    'gpt-4-turbo': { input: 10, output: 30 },
+    o1: { input: 15, output: 60 },
+    'o1-mini': { input: 3, output: 12 },
+    // Google
+    'gemini-2.0-flash': { input: 0.1, output: 0.4 },
+    'gemini-1.5-pro': { input: 1.25, output: 5 },
+};
+function lookupPricing(modelId) {
+    return exports.DEFAULT_PRICING[modelId];
+}
+exports.lookupPricing = lookupPricing;
+//# sourceMappingURL=pricing.js.map

package/dist/models/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/models/pricing.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIU,QAAA,eAAe,GAAiC;IAC3D,YAAY;IACZ,wBAAwB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACnD,0BAA0B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IACpD,2BAA2B,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE;IAEtD,SAAS;IACT,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;IACpC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAC3C,aAAa,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACxC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IAC7B,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAEnC,SAAS;IACT,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IAC/C,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE;CAC7C,CAAC;AAEF,SAAgB,aAAa,CAAC,OAAe;IAC3C,OAAO,uBAAe,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAFD,sCAEC"}