agentfootprint 1.0.0

package/dist/esm/concepts/FlowChart.js

@@ -0,0 +1,200 @@
+/**
+ * FlowChart — sequential composition of runners as a flowchart.
+ *
+ * The simplest multi-agent pattern: run agents in order, each feeding into the next.
+ * More complex patterns (fan-out, hierarchy, swarm) are user-built with footprintjs
+ * primitives (fork, addDeciderFunction, loopTo).
+ *
+ * Usage:
+ *   const composed = FlowChart.create()
+ *     .agent('researcher', 'Research', researchRunner)
+ *     .agent('writer', 'Write', writerRunner)
+ *     .build();
+ *   const result = await composed.run('Write about AI');
+ */
+import { flowChart as buildFlowChart, FlowChartExecutor, MetricRecorder } from 'footprintjs';
+import { annotateSpecIcons } from './specIcons';
+import { runnerAsStage } from '../stages/runnerAsStage';
+import { RecorderBridge } from '../recorders/v2/RecorderBridge';
+/**
+ * Check if a runner exposes its internal flowChart for subflow composition.
+ * Runners with `toFlowChart()` are mounted as subflows (enables UI drill-down).
+ * Runners without it fall back to `addFunction + runnerAsStage`.
+ */
+function hasToFlowChart(runner) {
+    return typeof runner.toFlowChart === 'function';
+}
+export class FlowChart {
+    agents = [];
+    recorders = [];
+    constructor() { }
+    static create() {
+        return new FlowChart();
+    }
+    /** Add a runner to the flowchart. Runners execute in the order added. */
+    agent(id, name, runner, options) {
+        this.agents.push({
+            id,
+            name,
+            runner,
+            inputMapper: options?.inputMapper,
+            outputMapper: options?.outputMapper,
+        });
+        return this;
+    }
+    /** Attach an AgentRecorder to observe execution events. */
+    recorder(rec) {
+        this.recorders.push(rec);
+        return this;
+    }
+    /** Build the composed flowchart and return a runner. */
+    build() {
+        if (this.agents.length === 0) {
+            throw new Error('FlowChart requires at least one agent');
+        }
+        return new FlowChartRunner([...this.agents], [...this.recorders]);
+    }
+}
+export class FlowChartRunner {
+    agents;
+    recorders;
+    lastExecutor;
+    lastSpec;
+    constructor(agents, recorders = []) {
+        this.agents = agents;
+        this.recorders = recorders;
+    }
+    async run(message, options) {
+        const startTime = Date.now();
+        const bridge = this.recorders.length > 0 ? new RecorderBridge(this.recorders) : null;
+        bridge?.dispatchTurnStart(message);
+        // Seed stage: set input and initialize agent results.
+        // Signal/timeout are passed via executor.run({ signal, timeoutMs }) and
+        // available to stages via scope.$getEnv() — no need to duplicate in scope state.
+        const seedStage = (scope) => {
+            scope.pipelineInput = message;
+            scope.agentResults = [];
+        };
+        // Build flowchart: Seed → Runner1 → Runner2 → ... → RunnerN
+        // Runners with toFlowChart() are mounted as subflows (UI drill-down).
+        // Runners without it fall back to addFunction + runnerAsStage.
+        let builder = buildFlowChart('Seed', seedStage, 'seed');
+        for (const agentConfig of this.agents) {
+            if (hasToFlowChart(agentConfig.runner)) {
+                // Mount as subflow — enables snapshot drill-down via getSubtreeSnapshot.
+                // No outputMapper — results are extracted from subflowResults after execution.
+                builder = builder.addSubFlowChartNext(agentConfig.id, agentConfig.runner.toFlowChart(), agentConfig.name, {
+                    inputMapper: (parentState) => {
+                        const input = agentConfig.inputMapper
+                            ? agentConfig.inputMapper(parentState)
+                            : parentState.result ??
+                                parentState.pipelineInput ??
+                                '';
+                        return { message: input };
+                    },
+                });
+            }
+            else {
+                // Fallback: wrap as a stage function
+                const stage = runnerAsStage(agentConfig);
+                builder = builder.addFunction(agentConfig.name, stage, agentConfig.id);
+            }
+        }
+        this.lastSpec = annotateSpecIcons(builder.toSpec());
+        const chart = builder.build();
+        const executor = new FlowChartExecutor(chart, { enrichSnapshots: true });
+        executor.enableNarrative();
+        executor.attachRecorder(new MetricRecorder('metrics'));
+        try {
+            await executor.run({
+                input: { message },
+                signal: options?.signal,
+                timeoutMs: options?.timeoutMs,
+            });
+        }
+        catch (err) {
+            bridge?.dispatchError('llm', err);
+            throw err;
+        }
+        this.lastExecutor = executor;
+        // Extract results from snapshot.
+        // For subflow-mounted agents, read from subflowResults (child shared state).
+        // For flat-stage agents, read from parent's agentResults.
+        const snapshot = executor.getSnapshot();
+        const state = snapshot?.sharedState ?? {};
+        const subflowResults = snapshot?.subflowResults ?? {};
+        const flatAgentResults = state.agentResults ?? [];
+        const subflowAgentResults = [];
+        for (const agentConfig of this.agents) {
+            const sfResult = subflowResults[agentConfig.id];
+            if (sfResult) {
+                const childState = sfResult.treeContext
+                    ?.globalContext;
+                const childContent = childState ? childState.result ?? '' : '';
+                subflowAgentResults.push({
+                    id: agentConfig.id,
+                    name: agentConfig.name,
+                    content: childContent,
+                    latencyMs: 0, // Individual subflow timing not available from SubflowResult
+                });
+            }
+        }
+        const allAgentResults = [...flatAgentResults, ...subflowAgentResults];
+        const lastSubflowContent = subflowAgentResults.length > 0
+            ? subflowAgentResults[subflowAgentResults.length - 1].content
+            : undefined;
+        const content = state.result ??
+            lastSubflowContent ??
+            (flatAgentResults.length > 0 ? flatAgentResults[flatAgentResults.length - 1].content : '');
+        bridge?.dispatchTurnComplete(content, 0);
+        return {
+            content,
+            agents: allAgentResults,
+            totalLatencyMs: Date.now() - startTime,
+        };
+    }
+    /** Get the flowchart spec (stage graph metadata). */
+    getSpec() {
+        if (!this.lastSpec) {
+            // Build chart structure to capture spec without executing
+            const seedStage = (scope) => {
+                scope.pipelineInput = '';
+                scope.agentResults = [];
+            };
+            let builder = buildFlowChart('Seed', seedStage, 'seed');
+            for (const agentConfig of this.agents) {
+                if (hasToFlowChart(agentConfig.runner)) {
+                    builder = builder.addSubFlowChartNext(agentConfig.id, agentConfig.runner.toFlowChart(), agentConfig.name, {
+                        inputMapper: (parentState) => {
+                            const input = agentConfig.inputMapper
+                                ? agentConfig.inputMapper(parentState)
+                                : parentState.result ??
+                                    parentState.pipelineInput ??
+                                    '';
+                            return { message: input };
+                        },
+                    });
+                }
+                else {
+                    const stage = runnerAsStage(agentConfig);
+                    builder = builder.addFunction(agentConfig.name, stage, agentConfig.id);
+                }
+            }
+            this.lastSpec = annotateSpecIcons(builder.toSpec());
+        }
+        return this.lastSpec;
+    }
+    /** Get the narrative from the last run. */
+    getNarrative() {
+        return this.lastExecutor?.getNarrative() ?? [];
+    }
+    /** Get structured narrative entries from the last run. */
+    getNarrativeEntries() {
+        return this.lastExecutor?.getNarrativeEntries() ?? [];
+    }
+    /** Get the full execution snapshot from the last run. */
+    getSnapshot() {
+        return this.lastExecutor?.getSnapshot();
+    }
+}
+//# sourceMappingURL=FlowChart.js.map

package/dist/esm/concepts/FlowChart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowChart.js","sourceRoot":"","sources":["../../../src/concepts/FlowChart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE;;;;GAIG;AACH,SAAS,cAAc,CACrB,MAAkB;IAElB,OAAO,OAAQ,MAAc,CAAC,WAAW,KAAK,UAAU,CAAC;AAC3D,CAAC;AAED,MAAM,OAAO,SAAS;IACH,MAAM,GAAuB,EAAE,CAAC;IAChC,SAAS,GAAoB,EAAE,CAAC;IAEjD,gBAAuB,CAAC;IAExB,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,SAAS,EAAE,CAAC;IACzB,CAAC;IAED,yEAAyE;IACzE,KAAK,CACH,EAAU,EACV,IAAY,EACZ,MAAkB,EAClB,OAGC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,EAAE;YACF,IAAI;YACJ,MAAM;YACN,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,YAAY,EAAE,OAAO,EAAE,YAAY;SACpC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2DAA2D;IAC3D,QAAQ,CAAC,GAAkB;QACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wDAAwD;IACxD,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,eAAe,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACpE,CAAC;CACF;AAED,MAAM,OAAO,eAAe;IACT,MAAM,CAA8B;IACpC,SAAS,CAAkB;IACpC,YAAY,CAAqB;IACjC,QAAQ,CAAW;IAE3B,YAAY,MAAmC,EAAE,YAA6B,EAAE;QAC9E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CACP,OAAe,EACf,OAAsD;QAEtD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAErF,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAEnC,sDAAsD;QACtD,wEAAwE;QACxE,iFAAiF;QACjF,MAAM,SAAS,GAAG,CAAC,KAAkC,EAAE,EAAE;YACvD,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC;YAC9B,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC;QAC1B,CAAC,CAAC;QAEF,4DAA4D;QAC5D,sEAAsE;QACtE,+DAA+D;QAC/D,IAAI,OAAO,GAAG,cAAc,CAAkB,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAEzE,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,IAAI,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvC,yEAAyE;gBACzE,+EAA+E;gBAC/E,OAAO,GAAG,OAAO,CAAC,mBAAmB,CACnC,WAAW,CAAC,EAAE,EACd,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,EAChC,WAAW,CAAC,IAAI,EAChB;oBACE,WAAW,EAAE,CAAC,WAAoC,EAAE,EAAE;wBACpD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW;4BACnC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC;4BACtC,CAAC,CAAE,WAAW,CAAC,MAAiB;gCAC7B,WAAW,CAAC,aAAwB;gCACrC,EAAE,CAAC;wBACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;oBAC5B,CAAC;iBACF,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,qCAAqC;gBACrC,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;gBACzC,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAE9B,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,KAAK,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,QAAQ,CAAC,eAAe,EAAE,CAAC;QAC3B,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;QAEvD,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,GAAG,CAAC;gBACjB,KAAK,EAAE,EAAE,OAAO,EAAE;gBAClB,MAAM,EAAE,OAAO,EAAE,MAAM;gBACvB,SAAS,EAAE,OAAO,EAAE,SAAS;aAC9B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAClC,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAE7B,iCAAiC;QACjC,6EAA6E;QAC7E,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC;QAC1C,MAAM,cAAc,GAAG,QAAQ,EAAE,cAAc,IAAI,EAAE,CAAC;QAEtD,MAAM,gBAAgB,GAAI,KAAK,CAAC,YAAmC,IAAI,EAAE,CAAC;QAC1E,MAAM,mBAAmB,GAAuB,EAAE,CAAC;QAEnD,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,EAAE,CAAwC,CAAC;YACvF,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,UAAU,GAAI,QAAQ,CAAC,WAAmD;oBAC9E,EAAE,aAAoD,CAAC;gBACzD,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAE,UAAU,CAAC,MAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3E,mBAAmB,CAAC,IAAI,CAAC;oBACvB,EAAE,EAAE,WAAW,CAAC,EAAE;oBAClB,IAAI,EAAE,WAAW,CAAC,IAAI;oBACtB,OAAO,EAAE,YAAY;oBACrB,SAAS,EAAE,CAAC,EAAE,6DAA6D;iBAC5E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,eAAe,GAAG,CAAC,GAAG,gBAAgB,EAAE,GAAG,mBAAmB,CAAC,CAAC;QAEtE,MAAM,kBAAkB,GACtB,mBAAmB,CAAC,MAAM,GAAG,CAAC;YAC5B,CAAC,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO;YAC7D,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,OAAO,GACV,KAAK,CAAC,MAAiB;YACxB,kBAAkB;YAClB,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE7F,MAAM,EAAE,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEzC,OAAO;YACL,OAAO;YACP,MAAM,EAAE,eAAe;YACvB,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACvC,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,0DAA0D;YAC1D,MAAM,SAAS,GAAG,CAAC,KAAkC,EAAE,EAAE;gBACvD,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC;gBACzB,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC;YAC1B,CAAC,CAAC;YACF,IAAI,OAAO,GAAG,cAAc,CAAkB,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACzE,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACtC,IAAI,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvC,OAAO,GAAG,OAAO,CAAC,mBAAmB,CACnC,WAAW,CAAC,EAAE,EACd,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,EAChC,WAAW,CAAC,IAAI,EAChB;wBACE,WAAW,EAAE,CAAC,WAAoC,EAAE,EAAE;4BACpD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW;gCACnC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC;gCACtC,CAAC,CAAE,WAAW,CAAC,MAAiB;oCAC7B,WAAW,CAAC,aAAwB;oCACrC,EAAE,CAAC;4BACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;wBAC5B,CAAC;qBACF,CACF,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;oBACzC,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,2CAA2C;IAC3C,YAAY;QACV,OAAO,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;IAED,0DAA0D;IAC1D,mBAAmB;QACjB,OAAO,IAAI,CAAC,YAAY,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,yDAAyD;IACzD,WAAW;QACT,OAAO,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dist/esm/concepts/LLMCall.js

@@ -0,0 +1,155 @@
+/**
+ * LLMCall — simplest concept: single LLM call, no tools, no loop.
+ *
+ * Flowchart: SystemPrompt → Messages → CallLLM → ParseResponse → Finalize
+ *
+ * Usage:
+ *   const caller = LLMCall.create({ provider: mock([{ content: 'Hi!' }]) })
+ *     .system('You are helpful.')
+ *     .build();
+ *   const result = await caller.run('Hello');
+ */
+import { flowChart, FlowChartExecutor, MetricRecorder } from 'footprintjs';
+import { annotateSpecIcons } from './specIcons';
+import { getTextContent } from '../types/content';
+import { userMessage, systemMessage } from '../types';
+import { createCallLLMStage } from '../stages/callLLM';
+import { parseResponseStage } from '../stages/parseResponse';
+import { finalizeStage } from '../stages/finalize';
+import { lastAssistantMessage } from '../memory';
+import { RecorderBridge } from '../recorders/v2/RecorderBridge';
+import { resolveProvider } from '../adapters/createProvider';
+export class LLMCall {
+    provider;
+    sysPrompt;
+    recorders = [];
+    enableStreaming = false;
+    constructor(options) {
+        this.provider = resolveProvider(options.provider);
+    }
+    static create(options) {
+        return new LLMCall(options);
+    }
+    system(prompt) {
+        this.sysPrompt = prompt;
+        return this;
+    }
+    streaming(enabled) {
+        this.enableStreaming = enabled;
+        return this;
+    }
+    /** Attach an AgentRecorder to observe execution events. */
+    recorder(rec) {
+        this.recorders.push(rec);
+        return this;
+    }
+    build() {
+        return new LLMCallRunner(this.provider, this.sysPrompt, [...this.recorders], this.enableStreaming);
+    }
+}
+export class LLMCallRunner {
+    provider;
+    sysPrompt;
+    recorders;
+    streamingEnabled;
+    lastExecutor;
+    lastSpec;
+    constructor(provider, sysPrompt, recorders = [], streaming = false) {
+        this.provider = provider;
+        this.sysPrompt = sysPrompt;
+        this.recorders = recorders;
+        this.streamingEnabled = streaming;
+    }
+    /** Expose the internal flowChart for subflow composition. */
+    toFlowChart() {
+        return this.buildChart('');
+    }
+    async run(message, options) {
+        const chart = this.buildChart(message);
+        const bridge = this.recorders.length > 0 ? new RecorderBridge(this.recorders) : null;
+        bridge?.dispatchTurnStart(message);
+        const executorOpts = { enrichSnapshots: true };
+        if (options?.onToken && this.streamingEnabled) {
+            executorOpts.streamHandlers = {
+                onToken: (_streamId, token) => options.onToken(token),
+                onStart: () => { },
+                onEnd: () => { },
+            };
+        }
+        const executor = new FlowChartExecutor(chart, executorOpts);
+        executor.enableNarrative();
+        executor.attachRecorder(new MetricRecorder('metrics'));
+        const startMs = Date.now();
+        try {
+            await executor.run({
+                input: { message },
+                signal: options?.signal,
+                timeoutMs: options?.timeoutMs,
+            });
+        }
+        catch (err) {
+            bridge?.dispatchError('llm', err);
+            throw err;
+        }
+        this.lastExecutor = executor;
+        const snapshot = executor.getSnapshot();
+        const state = snapshot?.sharedState ?? {};
+        const messages = state.messages ?? [];
+        const lastAsst = lastAssistantMessage(messages);
+        const content = state.result ?? (lastAsst ? getTextContent(lastAsst.content) : '');
+        // Dispatch LLM call event from the adapter response stored in scope
+        if (bridge) {
+            const response = state.adapterRawResponse;
+            if (response) {
+                bridge.dispatchLLMCall(response, Date.now() - startMs);
+            }
+            bridge.dispatchTurnComplete(content, messages.length);
+        }
+        return { content, messages };
+    }
+    buildChart(message) {
+        const sysPrompt = this.sysPrompt;
+        // API slot: SystemPrompt — set the system instruction
+        const systemPromptStage = (scope) => {
+            if (sysPrompt) {
+                scope.systemPrompt = sysPrompt;
+            }
+        };
+        // API slot: Messages — prepare the conversation messages
+        const messagesStage = (scope) => {
+            const msgs = [];
+            const sp = scope.systemPrompt;
+            if (sp)
+                msgs.push(systemMessage(sp));
+            msgs.push(userMessage(message));
+            scope.messages = msgs;
+        };
+        const callLLM = createCallLLMStage(this.provider);
+        let builder = flowChart('SystemPrompt', systemPromptStage, 'system-prompt')
+            .addFunction('Messages', messagesStage, 'messages');
+        if (this.streamingEnabled) {
+            builder = builder.addStreamingFunction('CallLLM', callLLM, 'call-llm', 'llm-stream');
+        }
+        else {
+            builder = builder.addFunction('CallLLM', callLLM, 'call-llm');
+        }
+        builder = builder
+            .addFunction('ParseResponse', parseResponseStage, 'parse')
+            .addFunction('Finalize', finalizeStage, 'finalize');
+        this.lastSpec = annotateSpecIcons(builder.toSpec());
+        return builder.build();
+    }
+    getSpec() {
+        if (!this.lastSpec) {
+            this.buildChart('');
+        }
+        return this.lastSpec;
+    }
+    getNarrative() {
+        return this.lastExecutor?.getNarrative() ?? [];
+    }
+    getSnapshot() {
+        return this.lastExecutor?.getSnapshot();
+    }
+}
+//# sourceMappingURL=LLMCall.js.map

package/dist/esm/concepts/LLMCall.js.map

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

package/dist/esm/concepts/Parallel.js

@@ -0,0 +1,249 @@
+/**
+ * Parallel — concurrent agent execution with fan-out/fan-in.
+ *
+ * Runs N agents in parallel, each as an isolated subflow. Merges results
+ * via LLM call (default) or custom function.
+ *
+ * Flowchart:
+ *   Seed → [fork]
+ *            ├── agent-A (isolated subflow)
+ *            ├── agent-B (isolated subflow)
+ *            └── agent-C (isolated subflow)
+ *          Merge → Finalize
+ *
+ * Each branch gets its own ExecutionRuntime (isolated scope).
+ * Results flow back through outputMapper (delta pattern).
+ *
+ * Usage:
+ *   const parallel = Parallel.create({ provider })
+ *     .agent('research', researchAgent, 'Research the topic')
+ *     .agent('writing', writingAgent, 'Draft content')
+ *     .mergeWithLLM('Synthesize into a coherent report')
+ *     .build();
+ *   const result = await parallel.run('Write about AI safety');
+ */
+import { flowChart, FlowChartExecutor, MetricRecorder } from 'footprintjs';
+import { userMessage, systemMessage } from '../types';
+import { RecorderBridge } from '../recorders/v2/RecorderBridge';
+import { resolveProvider } from '../adapters/createProvider';
+import { createAgentRenderer } from '../lib/narrative';
+import { annotateSpecIcons } from './specIcons';
+import { createCallLLMStage } from '../stages/callLLM';
+const MAX_BRANCHES = 10;
+// ── Builder ──────────────────────────────────────────────────
+export class Parallel {
+    provider;
+    parallelName;
+    branches = [];
+    mergePrompt;
+    mergeFn;
+    recorders = [];
+    streamingEnabled = false;
+    constructor(options) {
+        this.provider = resolveProvider(options.provider);
+        this.parallelName = options.name ?? 'parallel';
+    }
+    static create(options) {
+        return new Parallel(options);
+    }
+    /** Add an agent branch to run in parallel. */
+    agent(id, runner, description) {
+        if (this.branches.length >= MAX_BRANCHES) {
+            throw new Error(`Parallel: maximum ${MAX_BRANCHES} branches. Got ${this.branches.length + 1}.`);
+        }
+        if (this.branches.some((b) => b.id === id)) {
+            throw new Error(`Parallel: duplicate branch ID '${id}'.`);
+        }
+        this.branches.push({ id, description, runner });
+        return this;
+    }
+    /**
+     * Merge results using an LLM call (default strategy).
+     * The LLM receives all branch results as context and generates a unified response.
+     */
+    mergeWithLLM(prompt) {
+        this.mergePrompt = prompt;
+        this.mergeFn = undefined;
+        return this;
+    }
+    /**
+     * Merge results using a custom function (escape hatch for structured data).
+     */
+    merge(fn) {
+        this.mergeFn = fn;
+        this.mergePrompt = undefined;
+        return this;
+    }
+    streaming(enabled) {
+        this.streamingEnabled = enabled;
+        return this;
+    }
+    recorder(rec) {
+        this.recorders.push(rec);
+        return this;
+    }
+    build() {
+        if (this.branches.length < 2) {
+            throw new Error('Parallel requires at least 2 branches.');
+        }
+        if (!this.mergePrompt && !this.mergeFn) {
+            throw new Error('Parallel requires a merge strategy. Call .mergeWithLLM(prompt) or .merge(fn).');
+        }
+        return new ParallelRunner({
+            provider: this.provider,
+            name: this.parallelName,
+            branches: [...this.branches],
+            mergePrompt: this.mergePrompt,
+            mergeFn: this.mergeFn,
+            streaming: this.streamingEnabled,
+            recorders: [...this.recorders],
+        });
+    }
+}
+export class ParallelRunner {
+    opts;
+    lastExecutor;
+    lastSpec;
+    narrativeRenderer = createAgentRenderer();
+    constructor(options) {
+        this.opts = options;
+    }
+    get name() {
+        return this.opts.name;
+    }
+    /** Build the parallel flowchart. */
+    buildChart(message) {
+        const { provider, branches, mergePrompt, mergeFn } = this.opts;
+        // Seed: initialize message
+        let builder = flowChart('Seed', (scope) => {
+            scope.message = message;
+            scope.branchResults = {};
+            scope.messages = [];
+        }, 'seed', undefined, 'Initialize parallel execution');
+        // Mount each branch as a parallel subflow (fork children with isolated ExecutionRuntime)
+        for (const branch of branches) {
+            const branchChart = this.buildBranchChart(branch);
+            builder = builder.addSubFlowChart(branch.id, branchChart, branch.description, {
+                inputMapper: (parent) => ({
+                    message: parent.message ?? '',
+                }),
+                // applyOutputMapping merges nested keys — return only the new branch delta
+                outputMapper: (sfOutput) => {
+                    const content = String(sfOutput.result ?? sfOutput.content ?? '');
+                    return {
+                        branchResults: {
+                            [branch.id]: { id: branch.id, status: 'fulfilled', content },
+                        },
+                    };
+                },
+            });
+        }
+        // Merge stage — after all branches complete
+        if (mergePrompt) {
+            // LLM merge: feed all branch results to LLM
+            const callLLM = createCallLLMStage(provider);
+            builder = builder
+                .addFunction('FormatMerge', (scope) => {
+                const results = scope.branchResults ?? {};
+                // Format branch results as XML-tagged sections for the LLM
+                // Escape XML special chars to prevent prompt injection via branch content
+                const escapeXml = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+                const sections = Object.values(results)
+                    .map((r) => `<branch id="${escapeXml(r.id)}">\n${escapeXml(r.content)}\n</branch>`)
+                    .join('\n\n');
+                scope.messages = [
+                    systemMessage(`${mergePrompt}\n\nMerge the following parallel results into a coherent response:`),
+                    userMessage(sections),
+                ];
+            }, 'format-merge', 'Format branch results for LLM merge')
+                .addFunction('MergeLLM', callLLM, 'merge-llm', 'LLM synthesizes branch results')
+                .addFunction('ExtractMerge', (scope) => {
+                const raw = scope.$getValue('adapterRawResponse');
+                scope.result = raw?.content ?? '';
+            }, 'extract-merge', 'Extract merged result from LLM response');
+        }
+        else if (mergeFn) {
+            // Function merge
+            const fn = mergeFn;
+            builder = builder.addFunction('Merge', (scope) => {
+                const results = scope.branchResults ?? {};
+                scope.result = fn(results);
+            }, 'merge', 'Merge branch results with custom function');
+        }
+        this.lastSpec = annotateSpecIcons(builder.toSpec());
+        return builder.build();
+    }
+    /** Build a single branch's flowchart. */
+    buildBranchChart(branch) {
+        // Check if runner has its own flowchart (for BTS drill-down)
+        const runner = branch.runner;
+        if (typeof runner.toFlowChart === 'function') {
+            return runner.toFlowChart();
+        }
+        // Fallback: wrap runner.run() in a single-stage flowchart with error capture
+        return flowChart(branch.id, async (scope) => {
+            try {
+                const res = await branch.runner.run(scope.message ?? '');
+                scope.result = res.content;
+            }
+            catch (err) {
+                scope.branchError = err instanceof Error ? err.message : String(err);
+                scope.result = `[Error: ${scope.branchError}]`;
+            }
+        }, `${branch.id}-run`, undefined, branch.description).build();
+    }
+    async run(message, options) {
+        const chart = this.buildChart(message);
+        const bridge = this.opts.recorders.length > 0 ? new RecorderBridge(this.opts.recorders) : null;
+        bridge?.dispatchTurnStart(message);
+        const executorOpts = { enrichSnapshots: true };
+        if (options?.onToken && this.opts.streaming) {
+            executorOpts.streamHandlers = {
+                onToken: (_id, token) => options.onToken(token),
+                onStart: () => { },
+                onEnd: () => { },
+            };
+        }
+        const executor = new FlowChartExecutor(chart, executorOpts);
+        executor.enableNarrative({ renderer: this.narrativeRenderer });
+        executor.attachRecorder(new MetricRecorder('metrics'));
+        try {
+            await executor.run({
+                signal: options?.signal,
+                timeoutMs: options?.timeoutMs,
+            });
+        }
+        catch (err) {
+            this.lastExecutor = executor;
+            bridge?.dispatchError('llm', err);
+            throw err;
+        }
+        this.lastExecutor = executor;
+        const state = executor.getSnapshot()?.sharedState ?? {};
+        const result = state.result ?? '';
+        const branchResults = (state.branchResults ?? {});
+        const messages = state.messages ?? [];
+        bridge?.dispatchTurnComplete(result, messages.length);
+        return {
+            content: result,
+            branches: Object.values(branchResults),
+            messages,
+        };
+    }
+    getNarrative() {
+        return this.lastExecutor?.getNarrative() ?? [];
+    }
+    getNarrativeEntries() {
+        return this.lastExecutor?.getNarrativeEntries() ?? [];
+    }
+    getSnapshot() {
+        return this.lastExecutor?.getSnapshot();
+    }
+    getSpec() {
+        if (!this.lastSpec) {
+            this.buildChart('');
+        }
+        return this.lastSpec;
+    }
+}
+//# sourceMappingURL=Parallel.js.map

package/dist/esm/concepts/Parallel.js.map

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