agentfootprint 1.22.0 → 2.0.1

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

@@ -0,0 +1,232 @@
+/**
+ * Conditional — routing composition: evaluates branches in order, runs the first match.
+ *
+ * Pattern: Builder (GoF) + Adapter over footprintjs's `addDeciderFunction`.
+ * Role:    core-flow/ layer. Picks exactly ONE branch based on a predicate
+ *          (sync function of input) OR an LLM decision. Chosen branch
+ *          receives `{ message }` and returns a string.
+ * Emits:   agentfootprint.composition.enter / exit +
+ *          composition.route_decided (via compositionRecorder).
+ *
+ * v1 of this primitive supports `.when(id, predicate, runner)` + `.otherwise(id, runner)`.
+ * LLM-gated routing (`.whenLLM(id, prompt, runner)`) lands in Phase 5.
+ */
+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 Conditional extends RunnerBase {
+    name;
+    id;
+    branches;
+    fallbackId;
+    currentRunContext = {
+        runStartMs: 0,
+        runId: 'pending',
+        compositionPath: [],
+    };
+    constructor(opts, branches, fallbackId) {
+        super();
+        this.name = opts.name ?? 'Conditional';
+        this.id = opts.id ?? 'conditional';
+        if (branches.length < 2) {
+            throw new Error('Conditional: must have at least one .when() branch plus an .otherwise()');
+        }
+        this.branches = branches;
+        this.fallbackId = fallbackId;
+    }
+    static create(opts = {}) {
+        return new ConditionalBuilder(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: [`Conditional:${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('Conditional: unexpected result shape — expected string');
+    }
+    buildChart() {
+        const branches = this.branches;
+        const fallbackId = this.fallbackId;
+        const compositionId = this.id;
+        const compositionName = this.name;
+        const seed = (scope) => {
+            const args = scope.$getArgs();
+            scope.userMessage = args.message;
+            typedEmit(scope, 'agentfootprint.composition.enter', {
+                kind: 'Conditional',
+                id: compositionId,
+                name: compositionName,
+                childCount: branches.length,
+            });
+        };
+        /**
+         * Decider — pure sync function returning the chosen branch id.
+         * Fires composition.route_decided event with rationale so consumers
+         * can explain WHY the route was picked.
+         */
+        const decider = (scope) => {
+            const input = {
+                message: scope.userMessage ?? '',
+            };
+            let chosen = fallbackId;
+            let rationale = `no .when() predicate matched — fell through to ${fallbackId}`;
+            for (const b of branches) {
+                if (b.predicate === undefined)
+                    continue; // skip the fallback
+                if (b.predicate(input)) {
+                    chosen = b.id;
+                    rationale = `predicate for '${b.id}' returned true`;
+                    break;
+                }
+            }
+            typedEmit(scope, 'agentfootprint.composition.route_decided', {
+                conditionalId: compositionId,
+                chosen,
+                rationale,
+            });
+            return chosen;
+        };
+        // Root description prefix `Conditional:` is the taxonomy marker —
+        // see FlowchartRecorder.mapTopologyToSteps for the consumer side.
+        const base = flowChart('Seed', seed, 'seed', undefined, `Conditional: ${branches.length}-branch routing`);
+        let decList = base.addDeciderFunction('Route', decider, 'route', 'Conditional branch selection');
+        for (const b of branches) {
+            decList = decList.addSubFlowChartBranch(b.id, b.runner.toFlowChart(), b.name, {
+                inputMapper: (parent) => ({ message: parent.userMessage ?? '' }),
+                // Branch's string return becomes sfOutput; propagate to parent
+                // as `result` for the Finalize stage to read.
+                outputMapper: (sfOutput) => ({
+                    result: typeof sfOutput === 'string' ? sfOutput : '',
+                }),
+            });
+        }
+        let builder = decList.setDefault(fallbackId).end();
+        // After the decider + chosen branch returns, emit composition.exit
+        // and pass the branch's result as the executor's TraversalResult.
+        builder = builder.addFunction('Finalize', (scope) => {
+            // The chosen branch's return is carried as the previous stage's
+            // output. We read `scope.__branchResult` which the decider chain
+            // writes via outputMapper? Actually footprintjs threads the
+            // branch output as the NEXT stage's input argument — but we're
+            // using `addFunction` which gets the SAME scope.
+            //
+            // Easier: each branch writes `scope.result`, and Finalize reads it.
+            // But we don't control branch internals. Instead, read from the
+            // stage chain's most-recent return via the executor.
+            //
+            // Pragmatic approach: return an empty string here and rely on
+            // the decider branch being the LAST stage in its arm. Actually
+            // that doesn't work either — decider WITH branches means each
+            // branch IS a subflow, and THIS `Finalize` runs AFTER the branch
+            // joins. What we want is the BRANCH's return.
+            //
+            // footprintjs behavior: stages chained after a decider receive
+            // the chosen branch's subflow result via their first-arg.
+            // Unfortunately `addFunction` receives only scope, not the
+            // result.
+            //
+            // Solution: have each branch's outputMapper write scope.result,
+            // then read it here.
+            typedEmit(scope, 'agentfootprint.composition.exit', {
+                kind: 'Conditional',
+                id: compositionId,
+                status: 'ok',
+                durationMs: Date.now() - this.currentRunContext.runStartMs,
+            });
+            return scope.result ?? '';
+        }, 'finalize', 'Conditional finalize');
+        return builder.build();
+    }
+}
+/**
+ * Fluent builder. Branches evaluate in registration order; first matching
+ * predicate wins. `.otherwise()` is the mandatory fallback.
+ */
+export class ConditionalBuilder {
+    opts;
+    branches = [];
+    fallbackRegistered = false;
+    fallbackId = '';
+    seenIds = new Set();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /**
+     * Register a predicate-gated branch. `predicate` is a pure sync function
+     * of the Conditional's input; if it returns true, the corresponding
+     * runner executes. Branches evaluate in registration order.
+     */
+    when(id, predicate, runner, name) {
+        if (this.seenIds.has(id)) {
+            throw new Error(`Conditional.when(): duplicate branch id '${id}'`);
+        }
+        this.seenIds.add(id);
+        this.branches.push({ id, runner, predicate, name: name ?? id });
+        return this;
+    }
+    /**
+     * Register the fallback branch. Exactly ONE must be registered before build().
+     */
+    otherwise(id, runner, name) {
+        if (this.fallbackRegistered) {
+            throw new Error('Conditional.otherwise(): already registered');
+        }
+        if (this.seenIds.has(id)) {
+            throw new Error(`Conditional.otherwise(): duplicate branch id '${id}'`);
+        }
+        this.seenIds.add(id);
+        this.branches.push({ id, runner, name: name ?? id });
+        this.fallbackId = id;
+        this.fallbackRegistered = true;
+        return this;
+    }
+    build() {
+        if (!this.fallbackRegistered) {
+            throw new Error('Conditional.build(): missing .otherwise() — every Conditional needs a fallback branch');
+        }
+        return new Conditional(this.opts, this.branches, this.fallbackId);
+    }
+}
+//# sourceMappingURL=Conditional.js.map

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

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

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

@@ -0,0 +1,259 @@
+/**
+ * Loop — iteration composition: runs a body runner repeatedly until exit.
+ *
+ * Pattern: Builder (GoF) + Adapter over footprintjs's `loopTo` + `$break`.
+ * Role:    core-flow/ layer. Enables Reflection, Self-Refine, Debate,
+ *          Reflexion, Constitutional AI, and any pattern needing
+ *          iterative refinement of a composition output.
+ * Emits:   agentfootprint.composition.enter / exit +
+ *          composition.iteration_start / iteration_exit
+ *          (via compositionRecorder).
+ *
+ * Budget guard is MANDATORY. You must set at least one of:
+ *   - maxIterations (default 10 if only .body() is set)
+ *   - maxWallclockMs
+ * Hard ceiling of 500 iterations prevents runaway loops even if a guard
+ * misfires; exceeding it throws.
+ */
+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';
+const HARD_ITERATION_CAP = 500;
+export class Loop extends RunnerBase {
+    name;
+    id;
+    body;
+    maxIterations;
+    maxWallclockMs;
+    until;
+    currentRunContext = {
+        runStartMs: 0,
+        runId: 'pending',
+        compositionPath: [],
+    };
+    constructor(opts, body, config) {
+        super();
+        this.name = opts.name ?? 'Loop';
+        this.id = opts.id ?? 'loop';
+        this.body = body;
+        this.maxIterations = clampIterations(config.maxIterations);
+        this.maxWallclockMs = config.maxWallclockMs;
+        this.until = config.until;
+    }
+    static create(opts = {}) {
+        return new LoopBuilder(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: [`Loop:${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('Loop: unexpected result shape — expected string');
+    }
+    buildChart() {
+        const body = this.body;
+        const maxIterations = this.maxIterations;
+        const maxWallclockMs = this.maxWallclockMs;
+        const until = this.until;
+        const compositionId = this.id;
+        const compositionName = this.name;
+        const seed = (scope) => {
+            const args = scope.$getArgs();
+            scope.current = args.message;
+            scope.iteration = 0;
+            scope.startMs = Date.now();
+            typedEmit(scope, 'agentfootprint.composition.enter', {
+                kind: 'Loop',
+                id: compositionId,
+                name: compositionName,
+                childCount: 1,
+            });
+        };
+        const iterationStart = (scope) => {
+            const next = (scope.iteration ?? 0) + 1;
+            scope.iteration = next;
+            typedEmit(scope, 'agentfootprint.composition.iteration_start', {
+                loopId: compositionId,
+                iteration: next,
+            });
+        };
+        /**
+         * Guard stage — runs AFTER the body subflow completes each iteration.
+         * Checks exit conditions; when any fires, emits iteration_exit with
+         * the reason + $break terminates the loop.
+         */
+        const guard = (scope) => {
+            const iteration = scope.iteration;
+            const latestOutput = scope.current ?? '';
+            const startMs = scope.startMs;
+            let exitReason;
+            if (iteration >= maxIterations) {
+                exitReason = 'budget';
+            }
+            else if (maxWallclockMs !== undefined && Date.now() - startMs >= maxWallclockMs) {
+                exitReason = 'budget';
+            }
+            else if (iteration >= HARD_ITERATION_CAP) {
+                exitReason = 'budget';
+            }
+            else if (until !== undefined && until({ iteration, latestOutput, startMs })) {
+                exitReason = 'guard_false';
+            }
+            if (exitReason !== undefined) {
+                typedEmit(scope, 'agentfootprint.composition.iteration_exit', {
+                    loopId: compositionId,
+                    iteration,
+                    reason: exitReason,
+                });
+                typedEmit(scope, 'agentfootprint.composition.exit', {
+                    kind: 'Loop',
+                    id: compositionId,
+                    status: exitReason === 'budget' ? 'budget_exhausted' : 'ok',
+                    durationMs: Date.now() - this.currentRunContext.runStartMs,
+                });
+                // $break stops the flow BEFORE loopTo fires. The latest string
+                // output is returned as the executor's TraversalResult.
+                scope.$break();
+                return latestOutput;
+            }
+            // Continue looping: emit "body_complete" for the completed iteration
+            // before the loopTo takes us back. Next iteration's iterationStart
+            // emits iteration_start again.
+            typedEmit(scope, 'agentfootprint.composition.iteration_exit', {
+                loopId: compositionId,
+                iteration,
+                reason: 'body_complete',
+            });
+            return latestOutput;
+        };
+        // Root description prefix `Loop:` is the taxonomy marker — see
+        // FlowchartRecorder.mapTopologyToSteps for the consumer side.
+        return flowChart('Seed', seed, 'seed', undefined, 'Loop: iterated body')
+            .addFunction('IterationStart', iterationStart, 'iteration-start', 'Loop iteration marker')
+            .addSubFlowChartNext('body', body.toFlowChart(), 'body', {
+            inputMapper: (parent) => ({ message: parent.current ?? '' }),
+            // Body's string return becomes next iteration's input via `current`.
+            outputMapper: (sfOutput) => ({
+                current: typeof sfOutput === 'string' ? sfOutput : '',
+            }),
+        })
+            .addFunction('Guard', guard, 'guard', 'Loop exit-condition guard')
+            .loopTo('iteration-start')
+            .build();
+    }
+}
+/**
+ * Fluent builder. Reads as natural English:
+ *   Loop.create().repeat(runner).times(10).forAtMost(30_000).until(fn).build()
+ *   →  "Loop: repeat runner, up to 10 times, for at most 30 seconds, until fn."
+ *
+ * Enforces a body runner is supplied before .build(). Default budget is
+ * 10 iterations (hard ceiling 500). Any of .times / .forAtMost / .until
+ * can fire to exit the loop.
+ */
+export class LoopBuilder {
+    opts;
+    _body;
+    _maxIterations;
+    _maxWallclockMs;
+    _until;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /**
+     * The runner that executes each iteration. Required.
+     * Each iteration's output string becomes the next iteration's input `{ message }`.
+     */
+    repeat(runner) {
+        if (this._body !== undefined) {
+            throw new Error('Loop.repeat(): already set');
+        }
+        this._body = runner;
+        return this;
+    }
+    /**
+     * Maximum iteration count. Default 10 if only `.repeat()` is called.
+     * Hard ceiling 500 — larger values are clamped.
+     */
+    times(n) {
+        this._maxIterations = n;
+        return this;
+    }
+    /**
+     * Wall-clock time budget in milliseconds. The loop exits at the next
+     * guard check after this elapses.
+     */
+    forAtMost(ms) {
+        this._maxWallclockMs = ms;
+        return this;
+    }
+    /**
+     * Exit predicate evaluated after each iteration. Return `true` to exit.
+     * Receives `{ iteration, latestOutput, startMs }`.
+     */
+    until(guard) {
+        this._until = guard;
+        return this;
+    }
+    build() {
+        if (this._body === undefined) {
+            throw new Error('Loop.build(): .repeat(runner) is required');
+        }
+        const maxIterations = this._maxIterations ?? 10;
+        return new Loop(this.opts, this._body, {
+            maxIterations,
+            ...(this._maxWallclockMs !== undefined && { maxWallclockMs: this._maxWallclockMs }),
+            ...(this._until !== undefined && { until: this._until }),
+        });
+    }
+}
+function clampIterations(n) {
+    if (!Number.isFinite(n) || !Number.isInteger(n) || n < 1)
+        return 1;
+    if (n > HARD_ITERATION_CAP)
+        return HARD_ITERATION_CAP;
+    return n;
+}
+//# sourceMappingURL=Loop.js.map

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

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