agentfootprint 1.22.0 → 2.0.1

package/dist/esm/core-flow/Parallel.js

@@ -0,0 +1,339 @@
+/**
+ * Parallel — fan-out composition: N branches run concurrently, then merge.
+ *
+ * Pattern: Builder (GoF) + Adapter over footprintjs's `addSubFlowChart`
+ *          (fork children).
+ * Role:    core-flow/ layer. All branches receive the same input
+ *          `{ message }`. Each returns a string. A merge step combines
+ *          them: either a pure function OR an LLM.
+ * Emits:   agentfootprint.composition.enter / exit +
+ *          composition.fork_start / branch_complete / merge_end
+ *          (via compositionRecorder).
+ */
+import { FlowChartExecutor, flowChart, } from 'footprintjs';
+import { RunnerBase, makeRunId } from '../core/RunnerBase.js';
+import { ContextRecorder } from '../recorders/core/ContextRecorder.js';
+import { streamRecorder } from '../recorders/core/StreamRecorder.js';
+import { agentRecorder } from '../recorders/core/AgentRecorder.js';
+import { compositionRecorder } from '../recorders/core/CompositionRecorder.js';
+import { typedEmit } from '../recorders/core/typedEmit.js';
+export class Parallel extends RunnerBase {
+    name;
+    id;
+    branches;
+    merge;
+    currentRunContext = {
+        runStartMs: 0,
+        runId: 'pending',
+        compositionPath: [],
+    };
+    constructor(opts, branches, merge) {
+        super();
+        this.name = opts.name ?? 'Parallel';
+        this.id = opts.id ?? 'parallel';
+        if (branches.length < 2) {
+            throw new Error('Parallel: must have at least 2 branches (use Sequence for a single runner)');
+        }
+        this.branches = branches;
+        this.merge = merge;
+    }
+    static create(opts = {}) {
+        return new ParallelBuilder(opts);
+    }
+    toFlowChart() {
+        return this.buildChart();
+    }
+    async run(input, options) {
+        const executor = this.createExecutor();
+        const result = await executor.run({
+            input: { message: input.message },
+            ...(options ?? {}),
+        });
+        return this.finalizeResult(executor, result);
+    }
+    async resume(checkpoint, input, options) {
+        this.emitPauseResume(checkpoint, input);
+        const executor = this.createExecutor();
+        const result = await executor.resume(checkpoint, input, options);
+        return this.finalizeResult(executor, result);
+    }
+    createExecutor() {
+        this.currentRunContext = {
+            runStartMs: Date.now(),
+            runId: makeRunId(),
+            compositionPath: [`Parallel:${this.id}`],
+        };
+        const chart = this.buildChart();
+        const executor = new FlowChartExecutor(chart);
+        const dispatcher = this.getDispatcher();
+        const getRunCtx = () => this.currentRunContext;
+        executor.attachCombinedRecorder(new ContextRecorder({ dispatcher, getRunContext: getRunCtx }));
+        executor.attachCombinedRecorder(streamRecorder({ dispatcher, getRunContext: getRunCtx }));
+        executor.attachCombinedRecorder(agentRecorder({ dispatcher, getRunContext: getRunCtx }));
+        executor.attachCombinedRecorder(compositionRecorder({ dispatcher, getRunContext: getRunCtx }));
+        for (const r of this.attachedRecorders)
+            executor.attachCombinedRecorder(r);
+        return executor;
+    }
+    finalizeResult(executor, result) {
+        const paused = this.detectPause(executor, result);
+        if (paused)
+            return paused;
+        if (result instanceof Error)
+            throw result;
+        if (typeof result === 'string')
+            return result;
+        throw new Error('Parallel: unexpected result shape — expected string');
+    }
+    buildChart() {
+        const branches = this.branches;
+        const merge = this.merge;
+        const compositionId = this.id;
+        const compositionName = this.name;
+        const seed = (scope) => {
+            const args = scope.$getArgs();
+            scope.userMessage = args.message;
+            scope.branchResults = {};
+            typedEmit(scope, 'agentfootprint.composition.enter', {
+                kind: 'Parallel',
+                id: compositionId,
+                name: compositionName,
+                childCount: branches.length,
+            });
+            typedEmit(scope, 'agentfootprint.composition.fork_start', {
+                parentId: compositionId,
+                branches: branches.map((b) => ({ id: b.id, name: b.name })),
+            });
+        };
+        // Root description prefix `Parallel:` is the taxonomy marker — see
+        // FlowchartRecorder.mapTopologyToSteps for the consumer side.
+        let builder = flowChart('Seed', seed, 'seed', undefined, `Parallel: ${branches.length}-way fanout`);
+        // Fork children — each branch is wrapped in a chart that runs the
+        // branch runner in try/catch. The wrapper always succeeds (no error
+        // propagates up), so the outputMapper always fires and records a
+        // typed `BranchOutcome` for the Merge stage to inspect.
+        //
+        // Strict mode (default): Merge throws on any branch failure. Tolerant
+        // mode: Merge passes the full outcomes map to the consumer's merge fn.
+        for (const branch of branches) {
+            builder = builder.addSubFlowChart(branch.id, buildBranchWrapperChart(branch), branch.name, {
+                inputMapper: (parent) => ({ message: parent.userMessage ?? '' }),
+                // The wrapper's terminal stage returns a BranchOutcome. Stash it
+                // under the branch id; shallow-merge across siblings produces
+                // the full outcomes map.
+                outputMapper: (sfOutput) => ({
+                    branchOutcomes: {
+                        [branch.id]: sfOutput,
+                    },
+                }),
+            });
+        }
+        // Merge stage — runs after all fork children complete (join point).
+        const mergeStage = async (scope) => {
+            const outcomes = scope.branchOutcomes ?? {};
+            const failures = Object.entries(outcomes).filter(([, o]) => !o.ok);
+            const isTolerant = merge.kind === 'outcomes-fn';
+            if (failures.length > 0 && !isTolerant) {
+                const details = failures
+                    .map(([id, o]) => `  ${id}: ${o.error}`)
+                    .join('\n');
+                typedEmit(scope, 'agentfootprint.composition.exit', {
+                    kind: 'Parallel',
+                    id: compositionId,
+                    status: 'err',
+                    durationMs: Date.now() - this.currentRunContext.runStartMs,
+                });
+                throw new Error(`Parallel '${compositionId}': ${failures.length} branch(es) failed:\n${details}\n` +
+                    `(use .mergeOutcomesWithFn() for tolerant-mode partial-failure handling)`);
+            }
+            let merged;
+            if (merge.kind === 'fn') {
+                const results = {};
+                for (const [id, o] of Object.entries(outcomes)) {
+                    if (o.ok)
+                        results[id] = o.value;
+                }
+                merged = merge.fn(results);
+            }
+            else if (merge.kind === 'llm') {
+                const results = {};
+                for (const [id, o] of Object.entries(outcomes)) {
+                    if (o.ok)
+                        results[id] = o.value;
+                }
+                merged = await mergeWithLLM(scope, merge.opts, results);
+            }
+            else {
+                merged = merge.fn(outcomes);
+            }
+            typedEmit(scope, 'agentfootprint.composition.merge_end', {
+                parentId: compositionId,
+                strategy: merge.kind === 'outcomes-fn' ? 'fn' : merge.kind,
+                resultSummary: truncate(merged, 80),
+                mergedBranchCount: branches.length,
+            });
+            typedEmit(scope, 'agentfootprint.composition.exit', {
+                kind: 'Parallel',
+                id: compositionId,
+                status: 'ok',
+                durationMs: Date.now() - this.currentRunContext.runStartMs,
+            });
+            return merged;
+        };
+        builder = builder.addFunction('Merge', mergeStage, 'merge', 'Parallel merge');
+        return builder.build();
+    }
+}
+/**
+ * Build a wrapper chart that runs a branch Runner in a try/catch and
+ * emits its events to the Parallel's dispatcher. The chart's terminal
+ * stage returns a `BranchOutcome` — never throws up to the traverser.
+ *
+ * Event forwarding: the branch runner has its own EventDispatcher. We
+ * subscribe to the wildcard `'*'` during run() and re-dispatch each
+ * event on Parallel's dispatcher so consumers who attach listeners at
+ * the Parallel level see the branch's llm/context/agent events.
+ */
+function buildBranchWrapperChart(branch) {
+    const runBranch = async (scope) => {
+        const args = scope.$getArgs();
+        // Forward every branch-runner event via `scope.$emit` so it flows
+        // through footprintjs's emit channel. That channel reaches every
+        // EmitBridge attached to the CURRENT executor — including bridges
+        // belonging to outer compositions when this Parallel is nested
+        // (e.g., `Loop(Parallel(...))`). Forwarding directly to the
+        // Parallel's own dispatcher would be invisible to outer layers.
+        const unsubscribe = branch.runner.on('*', (e) => {
+            // `e.payload` is the typed payload union for the specific event;
+            // $emit accepts `unknown`, so no cast is needed — let it pass
+            // through structurally.
+            scope.$emit(e.type, e.payload);
+        });
+        try {
+            const result = await branch.runner.run({ message: args.message ?? '' });
+            if (typeof result === 'string') {
+                return { ok: true, value: result };
+            }
+            // Paused outcome: surface as "ok" with empty value — pauses from
+            // nested runners aren't failures, but Parallel doesn't yet propagate
+            // them through the merge. Consumers who need pause-inside-Parallel
+            // should set up nested pause handling at their own layer.
+            return { ok: true, value: '' };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+        finally {
+            unsubscribe();
+        }
+    };
+    return flowChart('RunBranch', runBranch, 'run-branch', undefined, `Parallel branch '${branch.id}' — catches failures`).build();
+}
+/** Fluent builder. Requires at least 2 branches + one merge strategy. */
+export class ParallelBuilder {
+    opts;
+    branches = [];
+    merge;
+    seenIds = new Set();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /** Add a branch. All branches run concurrently with the same input. */
+    branch(id, runner, name) {
+        if (this.seenIds.has(id)) {
+            throw new Error(`Parallel.branch(): duplicate branch id '${id}'`);
+        }
+        this.seenIds.add(id);
+        this.branches.push({ id, runner, name: name ?? id });
+        return this;
+    }
+    /**
+     * Merge branch results via a pure function.
+     * `fn` receives `{ [branchId]: string }` and returns the merged string.
+     */
+    mergeWithFn(fn) {
+        if (this.merge !== undefined) {
+            throw new Error('Parallel: merge strategy already set');
+        }
+        this.merge = { kind: 'fn', fn };
+        return this;
+    }
+    /** Merge branch results by feeding them to an LLM for synthesis. */
+    mergeWithLLM(opts) {
+        if (this.merge !== undefined) {
+            throw new Error('Parallel: merge strategy already set');
+        }
+        this.merge = { kind: 'llm', opts };
+        return this;
+    }
+    /**
+     * Tolerant merge — receives `{ [branchId]: BranchOutcome }` including
+     * both successes (`{ ok: true, value }`) and failures (`{ ok: false, error }`).
+     * Parallel does NOT throw on partial failure when this merge variant is
+     * used; the consumer's `fn` decides how to handle it (fall back, surface
+     * a warning, retry at a higher level, etc.).
+     *
+     * Use the default `mergeWithFn` / `mergeWithLLM` variants when you want
+     * a single failing branch to abort the whole Parallel loudly.
+     */
+    mergeOutcomesWithFn(fn) {
+        if (this.merge !== undefined) {
+            throw new Error('Parallel: merge strategy already set');
+        }
+        this.merge = { kind: 'outcomes-fn', fn };
+        return this;
+    }
+    build() {
+        if (this.merge === undefined) {
+            throw new Error('Parallel.build(): no merge strategy — call .mergeWithFn() or .mergeWithLLM() before build()');
+        }
+        return new Parallel(this.opts, this.branches, this.merge);
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────
+async function mergeWithLLM(scope, opts, results) {
+    // XML-escape branch content to avoid prompt-injection via branch output.
+    const sections = Object.entries(results)
+        .map(([id, content]) => `<${id}>${xmlEscape(content)}</${id}>`)
+        .join('\n');
+    const userContent = `${opts.prompt}\n\n${sections}`;
+    const messages = [{ role: 'user', content: userContent }];
+    typedEmit(scope, 'agentfootprint.stream.llm_start', {
+        iteration: 1,
+        provider: opts.provider.name,
+        model: opts.model,
+        systemPromptChars: 0,
+        messagesCount: 1,
+        toolsCount: 0,
+        ...(opts.temperature !== undefined && { temperature: opts.temperature }),
+    });
+    const startMs = Date.now();
+    const response = await opts.provider.complete({
+        messages,
+        model: opts.model,
+        ...(opts.temperature !== undefined && { temperature: opts.temperature }),
+        ...(opts.maxTokens !== undefined && { maxTokens: opts.maxTokens }),
+    });
+    const durationMs = Date.now() - startMs;
+    typedEmit(scope, 'agentfootprint.stream.llm_end', {
+        iteration: 1,
+        content: response.content,
+        toolCallCount: response.toolCalls.length,
+        usage: response.usage,
+        stopReason: response.stopReason,
+        durationMs,
+    });
+    return response.content;
+}
+function xmlEscape(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + '…';
+}
+//# sourceMappingURL=Parallel.js.map

package/dist/esm/core-flow/Parallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Parallel.js","sourceRoot":"","sources":["../../../src/core-flow/Parallel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,iBAAiB,EACjB,SAAS,GAKV,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAwD3D,MAAM,OAAO,QAAS,SAAQ,UAAyC;IAC5D,IAAI,CAAS;IACb,EAAE,CAAS;IACH,QAAQ,CAAyB;IACjC,KAAK,CAAgB;IAE9B,iBAAiB,GAAe;QACtC,UAAU,EAAE,CAAC;QACb,KAAK,EAAE,SAAS;QAChB,eAAe,EAAE,EAAE;KACpB,CAAC;IAEF,YAAY,IAAqB,EAAE,QAAgC,EAAE,KAAoB;QACvF,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC;QACpC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,UAAU,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAwB,EAAE;QACtC,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,GAAG,CACP,KAAoB,EACpB,OAAoB;QAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC;YAChC,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;YACjC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;SACnB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CACV,UAA+B,EAC/B,KAAe,EACf,OAAoB;QAEpB,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,iBAAiB,GAAG;YACvB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,KAAK,EAAE,SAAS,EAAE;YAClB,eAAe,EAAE,CAAC,YAAY,IAAI,CAAC,EAAE,EAAE,CAAC;SACzC,CAAC;QAEF,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE9C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,GAAe,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAE3D,QAAQ,CAAC,sBAAsB,CAAC,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/F,QAAQ,CAAC,sBAAsB,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC1F,QAAQ,CAAC,sBAAsB,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACzF,QAAQ,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/F,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,iBAAiB;YAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAC3E,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,cAAc,CACpB,QAA2B,EAC3B,MAAe;QAEf,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,IAAI,MAAM,YAAY,KAAK;YAAE,MAAM,MAAM,CAAC;QAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAEO,UAAU;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC;QAElC,MAAM,IAAI,GAAG,CAAC,KAAgC,EAAE,EAAE;YAChD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAiB,CAAC;YAC7C,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC;YACjC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC;YACzB,SAAS,CAAC,KAAK,EAAE,kCAAkC,EAAE;gBACnD,IAAI,EAAE,UAAU;gBAChB,EAAE,EAAE,aAAa;gBACjB,IAAI,EAAE,eAAe;gBACrB,UAAU,EAAE,QAAQ,CAAC,MAAM;aAC5B,CAAC,CAAC;YACH,SAAS,CAAC,KAAK,EAAE,uCAAuC,EAAE;gBACxD,QAAQ,EAAE,aAAa;gBACvB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;aAC5D,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,mEAAmE;QACnE,8DAA8D;QAC9D,IAAI,OAAO,GAAG,SAAS,CACrB,MAAM,EACN,IAAI,EACJ,MAAM,EACN,SAAS,EACT,aAAa,QAAQ,CAAC,MAAM,aAAa,CAC1C,CAAC;QAEF,kEAAkE;QAClE,oEAAoE;QACpE,iEAAiE;QACjE,wDAAwD;QACxD,EAAE;QACF,sEAAsE;QACtE,uEAAuE;QACvE,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE;gBACzF,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAG,MAAM,CAAC,WAAsB,IAAI,EAAE,EAAE,CAAC;gBAC5E,iEAAiE;gBACjE,8DAA8D;gBAC9D,yBAAyB;gBACzB,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAC3B,cAAc,EAAE;wBACd,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,QAAyB;qBACvC;iBACF,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAED,oEAAoE;QACpE,MAAM,UAAU,GAAG,KAAK,EAAE,KAAgC,EAAmB,EAAE;YAC7E,MAAM,QAAQ,GAAI,KAAK,CAAC,cAAgD,IAAI,EAAE,CAAC;YAE/E,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;YAChD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACvC,MAAM,OAAO,GAAG,QAAQ;qBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAM,CAAkC,CAAC,KAAK,EAAE,CAAC;qBACzE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,SAAS,CAAC,KAAK,EAAE,iCAAiC,EAAE;oBAClD,IAAI,EAAE,UAAU;oBAChB,EAAE,EAAE,aAAa;oBACjB,MAAM,EAAE,KAAK;oBACb,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU;iBAC3D,CAAC,CAAC;gBACH,MAAM,IAAI,KAAK,CACb,aAAa,aAAa,MAAM,QAAQ,CAAC,MAAM,wBAAwB,OAAO,IAAI;oBAChF,yEAAyE,CAC5E,CAAC;YACJ,CAAC;YAED,IAAI,MAAc,CAAC;YACnB,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACxB,MAAM,OAAO,GAA2B,EAAE,CAAC;gBAC3C,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/C,IAAI,CAAC,CAAC,EAAE;wBAAE,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;gBAClC,CAAC;gBACD,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAChC,MAAM,OAAO,GAA2B,EAAE,CAAC;gBAC3C,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/C,IAAI,CAAC,CAAC,EAAE;wBAAE,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;gBAClC,CAAC;gBACD,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;YACD,SAAS,CAAC,KAAK,EAAE,sCAAsC,EAAE;gBACvD,QAAQ,EAAE,aAAa;gBACvB,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI;gBAC1D,aAAa,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnC,iBAAiB,EAAE,QAAQ,CAAC,MAAM;aACnC,CAAC,CAAC;YACH,SAAS,CAAC,KAAK,EAAE,iCAAiC,EAAE;gBAClD,IAAI,EAAE,UAAU;gBAChB,EAAE,EAAE,aAAa;gBACjB,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU;aAC3D,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QAEF,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAE9E,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,SAAS,uBAAuB,CAAC,MAAmB;IAClD,MAAM,SAAS,GAAG,KAAK,EAAE,KAAgC,EAA0B,EAAE;QACnF,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAuB,CAAC;QACnD,kEAAkE;QAClE,iEAAiE;QACjE,kEAAkE;QAClE,+DAA+D;QAC/D,4DAA4D;QAC5D,gEAAgE;QAChE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;YAC9C,iEAAiE;YACjE,8DAA8D;YAC9D,wBAAwB;YACxB,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YACxE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACrC,CAAC;YACD,iEAAiE;YACjE,qEAAqE;YACrE,mEAAmE;YACnE,0DAA0D;YAC1D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,SAAS,CACd,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,oBAAoB,MAAM,CAAC,EAAE,sBAAsB,CACpD,CAAC,KAAK,EAAE,CAAC;AACZ,CAAC;AAED,yEAAyE;AACzE,MAAM,OAAO,eAAe;IACT,IAAI,CAAkB;IACtB,QAAQ,GAAkB,EAAE,CAAC;IACtC,KAAK,CAA4B;IACxB,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAE7C,YAAY,IAAqB;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,EAAU,EAAE,MAAmB,EAAE,IAAa;QACnD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,EAAW;QACrB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,YAAY,CAAC,IAAyB;QACpC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAmB;QACrC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,yEAAyE;AAEzE,KAAK,UAAU,YAAY,CACzB,KAAgC,EAChC,IAAyB,EACzB,OAAyC;IAEzC,yEAAyE;IACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SAC9D,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,MAAM,OAAO,QAAQ,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAiB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAExE,SAAS,CAAC,KAAK,EAAE,iCAAiC,EAAE;QAClD,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,iBAAiB,EAAE,CAAC;QACpB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;KACzE,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC5C,QAAQ;QACR,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACnE,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;IACxC,SAAS,CAAC,KAAK,EAAE,+BAA+B,EAAE;QAChD,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM;QACxC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,UAAU;KACX,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AACjC,CAAC"}

package/dist/esm/core-flow/Sequence.js

@@ -0,0 +1,189 @@
+/**
+ * Sequence — sequential composition of runners (steps chained one after another).
+ *
+ * Pattern: Builder (GoF) + Adapter over footprintjs's `addSubFlowChartNext`.
+ * Role:    core-flow/ layer — pure control flow, no LLM deps.
+ *          Each step's output becomes the next step's input; default
+ *          mapping is string chaining (step N's return → step N+1's
+ *          `{ message }`). Custom mapping via `.mapBetween(fn)` between
+ *          any two steps.
+ * Emits:   agentfootprint.composition.enter / exit (via compositionRecorder).
+ */
+import { FlowChartExecutor, flowChart, } from 'footprintjs';
+import { RunnerBase, makeRunId } from '../core/RunnerBase.js';
+import { ContextRecorder } from '../recorders/core/ContextRecorder.js';
+import { streamRecorder } from '../recorders/core/StreamRecorder.js';
+import { agentRecorder } from '../recorders/core/AgentRecorder.js';
+import { compositionRecorder } from '../recorders/core/CompositionRecorder.js';
+import { typedEmit } from '../recorders/core/typedEmit.js';
+/** Default string→{message} mapper used between consecutive steps. */
+const defaultMapBetween = (prev) => ({ message: prev });
+export class Sequence extends RunnerBase {
+    name;
+    id;
+    steps;
+    currentRunContext = {
+        runStartMs: 0,
+        runId: 'pending',
+        compositionPath: [],
+    };
+    constructor(opts, steps) {
+        super();
+        this.name = opts.name ?? 'Sequence';
+        this.id = opts.id ?? 'sequence';
+        if (steps.length === 0) {
+            throw new Error('Sequence: must have at least one .step()');
+        }
+        this.steps = steps;
+    }
+    static create(opts = {}) {
+        return new SequenceBuilder(opts);
+    }
+    toFlowChart() {
+        return this.buildChart();
+    }
+    async run(input, options) {
+        const executor = this.createExecutor();
+        const result = await executor.run({
+            input: { message: input.message },
+            ...(options ?? {}),
+        });
+        return this.finalizeResult(executor, result);
+    }
+    async resume(checkpoint, input, options) {
+        this.emitPauseResume(checkpoint, input);
+        const executor = this.createExecutor();
+        const result = await executor.resume(checkpoint, input, options);
+        return this.finalizeResult(executor, result);
+    }
+    createExecutor() {
+        this.currentRunContext = {
+            runStartMs: Date.now(),
+            runId: makeRunId(),
+            compositionPath: [`Sequence:${this.id}`],
+        };
+        const chart = this.buildChart();
+        const executor = new FlowChartExecutor(chart);
+        const dispatcher = this.getDispatcher();
+        const getRunCtx = () => this.currentRunContext;
+        executor.attachCombinedRecorder(new ContextRecorder({ dispatcher, getRunContext: getRunCtx }));
+        executor.attachCombinedRecorder(streamRecorder({ dispatcher, getRunContext: getRunCtx }));
+        executor.attachCombinedRecorder(agentRecorder({ dispatcher, getRunContext: getRunCtx }));
+        executor.attachCombinedRecorder(compositionRecorder({ dispatcher, getRunContext: getRunCtx }));
+        for (const r of this.attachedRecorders)
+            executor.attachCombinedRecorder(r);
+        return executor;
+    }
+    finalizeResult(executor, result) {
+        const paused = this.detectPause(executor, result);
+        if (paused)
+            return paused;
+        if (result instanceof Error)
+            throw result;
+        if (typeof result === 'string')
+            return result;
+        throw new Error('Sequence: unexpected result shape — expected string');
+    }
+    buildChart() {
+        const steps = this.steps;
+        const compositionId = this.id;
+        const compositionName = this.name;
+        const seed = (scope) => {
+            const args = scope.$getArgs();
+            scope.current = args.message;
+            typedEmit(scope, 'agentfootprint.composition.enter', {
+                kind: 'Sequence',
+                id: compositionId,
+                name: compositionName,
+                childCount: steps.length,
+            });
+        };
+        // Root description prefix `Sequence:` is the taxonomy marker —
+        // downstream consumers (Lens, FlowchartRecorder) detect composition
+        // primitives via the `<Kind>:` prefix convention. See
+        // FlowchartRecorder.mapTopologyToSteps for the consumer side.
+        let builder = flowChart('Seed', seed, 'seed', undefined, `Sequence: ${steps.length}-step pipeline`);
+        // Mount each step as a subflow via addSubFlowChartNext. The step's
+        // input comes from parent.current (mapped via mapFromPrev); the
+        // step's return becomes parent.current (via outputMapper).
+        for (const step of steps) {
+            builder = builder.addSubFlowChartNext(`step-${step.id}`, step.runner.toFlowChart(), step.id, {
+                inputMapper: (parent) => step.mapFromPrev(parent.current ?? ''),
+                // `sfOutput` is the subflow's TraversalResult — for Runner-backed
+                // subflows whose last stage returns a string, sfOutput IS that
+                // string. We pipe it into parent.current for the next step's
+                // inputMapper to pick up.
+                outputMapper: (sfOutput) => ({
+                    current: typeof sfOutput === 'string' ? sfOutput : '',
+                }),
+            });
+        }
+        // Final stage: emit composition.exit and return the current string
+        // so executor.run() yields it as the TraversalResult.
+        builder = builder.addFunction('Finalize', (scope) => {
+            const current = scope.current ?? '';
+            typedEmit(scope, 'agentfootprint.composition.exit', {
+                kind: 'Sequence',
+                id: compositionId,
+                status: 'ok',
+                durationMs: Date.now() - this.currentRunContext.runStartMs,
+            });
+            return current;
+        }, 'finalize', 'Sequence finalize');
+        return builder.build();
+    }
+}
+/**
+ * Fluent builder. Reads as natural English:
+ *   Sequence.create().step('a', A).pipeVia(fn).step('b', B).build()
+ *   →  "Sequence: step A, pipe via fn, step B."
+ *
+ * `step(id, runner)` adds a sequential step. `pipeVia(fn)` customises
+ * the transformation of the previous step's output before it feeds the
+ * next step (otherwise the default string-chain mapper is used).
+ */
+export class SequenceBuilder {
+    opts;
+    steps = [];
+    /** Pending pipeVia transformer for the NEXT step (consumed on .step()). */
+    pendingPipe;
+    seenIds = new Set();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /**
+     * Add a step. Runner must accept `{ message: string }` and return `string`.
+     * First step receives the Sequence input; subsequent steps receive the
+     * previous step's output (via the default string-chain mapper, or via
+     * the transformer set by a preceding `.pipeVia(fn)` call).
+     */
+    step(id, runner) {
+        if (this.seenIds.has(id)) {
+            throw new Error(`Sequence.step(): duplicate step id '${id}'`);
+        }
+        this.seenIds.add(id);
+        const mapFromPrev = this.pendingPipe ?? defaultMapBetween;
+        this.pendingPipe = undefined;
+        this.steps.push({ id, runner, mapFromPrev });
+        return this;
+    }
+    /**
+     * Transform the previous step's string output before it reaches the
+     * next step. Consumed once by the next `.step()` call. Default
+     * mapping is `(prev) => ({ message: prev })`.
+     *
+     * Reads as English: `.step('a', A).pipeVia(fn).step('b', B)`
+     * →  "step A, pipe via fn, step B"
+     */
+    pipeVia(fn) {
+        this.pendingPipe = fn;
+        return this;
+    }
+    build() {
+        if (this.pendingPipe !== undefined) {
+            throw new Error('Sequence.build(): .pipeVia() called with no following .step() to consume it');
+        }
+        return new Sequence(this.opts, this.steps);
+    }
+}
+//# sourceMappingURL=Sequence.js.map

package/dist/esm/core-flow/Sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sequence.js","sourceRoot":"","sources":["../../../src/core-flow/Sequence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,iBAAiB,EACjB,SAAS,GAKV,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAe3D,sEAAsE;AACtE,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAuB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAerF,MAAM,OAAO,QAAS,SAAQ,UAAyC;IAC5D,IAAI,CAAS;IACb,EAAE,CAAS;IACH,KAAK,CAAuB;IAErC,iBAAiB,GAAe;QACtC,UAAU,EAAE,CAAC;QACb,KAAK,EAAE,SAAS;QAChB,eAAe,EAAE,EAAE;KACpB,CAAC;IAEF,YAAY,IAAqB,EAAE,KAA2B;QAC5D,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC;QACpC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,UAAU,CAAC;QAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAwB,EAAE;QACtC,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,GAAG,CACP,KAAoB,EACpB,OAAoB;QAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC;YAChC,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;YACjC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;SACnB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CACV,UAA+B,EAC/B,KAAe,EACf,OAAoB;QAEpB,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,iBAAiB,GAAG;YACvB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,KAAK,EAAE,SAAS,EAAE;YAClB,eAAe,EAAE,CAAC,YAAY,IAAI,CAAC,EAAE,EAAE,CAAC;SACzC,CAAC;QAEF,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE9C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,GAAe,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAE3D,QAAQ,CAAC,sBAAsB,CAAC,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/F,QAAQ,CAAC,sBAAsB,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC1F,QAAQ,CAAC,sBAAsB,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACzF,QAAQ,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/F,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,iBAAiB;YAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAC3E,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,cAAc,CACpB,QAA2B,EAC3B,MAAe;QAEf,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,IAAI,MAAM,YAAY,KAAK;YAAE,MAAM,MAAM,CAAC;QAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAEO,UAAU;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC;QAElC,MAAM,IAAI,GAAG,CAAC,KAAgC,EAAE,EAAE;YAChD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAiB,CAAC;YAC7C,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,SAAS,CAAC,KAAK,EAAE,kCAAkC,EAAE;gBACnD,IAAI,EAAE,UAAU;gBAChB,EAAE,EAAE,aAAa;gBACjB,IAAI,EAAE,eAAe;gBACrB,UAAU,EAAE,KAAK,CAAC,MAAM;aACzB,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,+DAA+D;QAC/D,oEAAoE;QACpE,sDAAsD;QACtD,8DAA8D;QAC9D,IAAI,OAAO,GAAG,SAAS,CACrB,MAAM,EACN,IAAI,EACJ,MAAM,EACN,SAAS,EACT,aAAa,KAAK,CAAC,MAAM,gBAAgB,CAC1C,CAAC;QAEF,mEAAmE;QACnE,gEAAgE;QAChE,2DAA2D;QAC3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,QAAQ,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;gBAC3F,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAE,MAAM,CAAC,OAAkB,IAAI,EAAE,CAAC;gBAC3E,kEAAkE;gBAClE,+DAA+D;gBAC/D,6DAA6D;gBAC7D,0BAA0B;gBAC1B,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAC3B,OAAO,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;iBACtD,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAED,mEAAmE;QACnE,sDAAsD;QACtD,OAAO,GAAG,OAAO,CAAC,WAAW,CAC3B,UAAU,EACV,CAAC,KAAgC,EAAE,EAAE;YACnC,MAAM,OAAO,GAAI,KAAK,CAAC,OAAkB,IAAI,EAAE,CAAC;YAChD,SAAS,CAAC,KAAK,EAAE,iCAAiC,EAAE;gBAClD,IAAI,EAAE,UAAU;gBAChB,EAAE,EAAE,aAAa;gBACjB,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU;aAC3D,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC,EACD,UAAU,EACV,mBAAmB,CACpB,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IACT,IAAI,CAAkB;IACtB,KAAK,GAAgB,EAAE,CAAC;IACzC,2EAA2E;IACnE,WAAW,CAAyC;IAC3C,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAE7C,YAAY,IAAqB;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,EAAU,EAAE,MAAiB;QAChC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,iBAAiB,CAAC;QAC1D,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,EAAyC;QAC/C,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF"}