agentfootprint 13.0.0 → 14.0.0

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

@@ -9,16 +9,12 @@
  *          any two steps.
  * Emits:   agentfootprint.composition.enter / exit (via compositionRecorder).
  */
-import { FlowChartExecutor, flowChart, } from 'footprintjs';
-import { RunnerBase, makeRunId, underRunSignal } from '../core/RunnerBase.js';
+import { flowChart } from 'footprintjs';
+import { RunnerBase } from '../core/RunnerBase.js';
 import { normalizeRunInput } from '../core/runInput.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';
 import { composedInput, readsMessageFromIfAny } from '../core/messageFrom.js';
-import { adoptParentRun, parentRunIn, readsParentRun, closeParentRun, openParentRun, reopenParentRun, withParentRun, } from '../core/memberRun.js';
+import { parentRunIn, readsParentRun, withParentRun } from '../core/memberRun.js';
 import { requestOf } from '../core/requestOfRun.js';
 import { adoptMemberRedaction } from '../redaction/declared.js';
 import { carryVerdict, childOutcome, raiseChildVerdict } from './childOutcome.js';
@@ -29,11 +25,6 @@ export class Sequence extends RunnerBase {
     id;
     steps;
     opts;
-    currentRunContext = {
-        runStartMs: 0,
-        runId: 'pending',
-        compositionPath: [],
-    };
     constructor(opts, steps) {
         super();
         this.opts = opts;
@@ -52,7 +43,11 @@ export class Sequence extends RunnerBase {
         // It hands the run it serves to its members (`core/memberRun.ts`).
         readsParentRun(this);
         // Eager chart construction — see `RunnerBase.initChart` JSDoc.
-        this.initChart(() => this.buildChart());
+        this.initChart(() => this.buildChart(), {
+            runnerId: this.id,
+            compositionPath: [`Sequence:${this.id}`],
+            initialize: () => ({}),
+        });
     }
     static create(opts = {}) {
         return new SequenceBuilder(opts);
@@ -82,71 +77,28 @@ export class Sequence extends RunnerBase {
         };
     }
     async run(input, options) {
-        // The incoming request, refused here — before anything moves — when
-        // requestContext() did not build it.
-        const request = requestOf(options, 'Sequence.run');
-        const runInput = normalizeRunInput(input, 'Sequence.run');
-        const executor = this.createExecutor();
-        this.lastExecutor = executor;
-        // The run every member serves — built once, here, from THIS run's id.
-        const parentRun = openParentRun(this.currentRunContext.runId, runInput.identity, 'Sequence.run', request);
-        try {
-            const result = await underRunSignal(options, (engine) => executor.run({
-                input: { message: runInput.message, parentRun: parentRun.link },
-                ...(engine ?? {}),
-            }));
-            return this.finalizeResult(executor, result);
-        }
-        finally {
-            // Released when the run returns — finished, failed or paused (a resume re-opens it).
-            closeParentRun(parentRun);
-        }
+        return this.runExecution().withRun(async (invocation) => {
+            const request = requestOf(options, 'Sequence.run');
+            const runInput = normalizeRunInput(input, 'Sequence.run');
+            this.prepareCompositionRun(invocation, runInput.identity, request, 'Sequence.run');
+            const prepared = this.compositionRunSetup(invocation);
+            const result = await invocation.execute({ kind: 'run', options: { ...options, input: { message: runInput.message } } }, prepared.setup, prepared.binding);
+            return this.finalizeResult(invocation, result);
+        });
     }
     async resume(checkpoint, input, options) {
-        // The incoming request, and the paused run its members serve (re-opened
-        // from the checkpoint's own record) — both refused before anything moves.
-        const request = requestOf(options, 'Sequence.resume');
-        const parentRun = reopenParentRun(checkpoint.sharedState, 'Sequence.resume', request);
-        try {
-            // The leg's policy — the paused run's marks — goes to ITS executor, never via the instance.
+        this.noteResumeTakenUp(checkpoint);
+        return this.runExecution().withRun(async (invocation) => {
+            const request = requestOf(options, 'Sequence.resume');
+            this.prepareCompositionResume(invocation, checkpoint, request, 'Sequence.resume');
             const resumeLeg = this.emitPauseResume(checkpoint, input);
-            const executor = this.createExecutor(resumeLeg);
-            this.lastExecutor = executor;
-            const result = await underRunSignal(options, (engine) => executor.resume(checkpoint, input, engine));
-            return this.finalizeResult(executor, result);
-        }
-        finally {
-            closeParentRun(parentRun);
-        }
-    }
-    createExecutor(resumeLeg) {
-        this.currentRunContext = {
-            runStartMs: Date.now(),
-            runId: makeRunId(),
-            compositionPath: [`Sequence:${this.id}`],
-        };
-        // THIS run's context, captured: a run that overlaps it on this instance
-        // never restamps its events, so each is served under its own run's policy.
-        const runContext = this.currentRunContext;
-        const getRunCtx = () => runContext;
-        // The run's redaction (`src/redaction/`): every policy a step declared —
-        // the steps run inside THIS executor, so this run's one rule covers them.
-        const redaction = this.openRunRedaction(resumeLeg, getRunCtx);
-        // Reuse the cached chart built at constructor time.
-        const spec = this.getSpec();
-        const executor = new FlowChartExecutor(spec, { scopeFactory: redaction.scopeFactoryFor(spec) });
-        redaction.applyTo(executor);
-        const dispatcher = this.getDispatcher();
-        executor.attachCombinedRecorder(new ContextRecorder({ dispatcher, getRunContext: getRunCtx, realWrites: redaction }));
-        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;
+            const prepared = this.compositionRunSetup(invocation, resumeLeg);
+            const result = await invocation.execute({ kind: 'resume', mode: 'fresh', checkpoint, input, options }, prepared.setup, prepared.binding);
+            return this.finalizeResult(invocation, result);
+        });
     }
-    finalizeResult(executor, result) {
-        const paused = this.detectPause(executor, result);
+    finalizeResult(invocation, result) {
+        const paused = this.detectPause(invocation, result);
         if (paused)
             return paused;
         if (result instanceof Error)
@@ -162,7 +114,7 @@ export class Sequence extends RunnerBase {
         const seed = (scope) => {
             const args = scope.$getArgs();
             scope.current = args.message;
-            adoptParentRun(scope, args, 'Sequence');
+            this.enterComposition(scope, args, 'Sequence');
             typedEmit(scope, 'agentfootprint.composition.enter', {
                 kind: 'Sequence',
                 id: compositionId,
@@ -225,7 +177,7 @@ export class Sequence extends RunnerBase {
                 id: compositionId,
                 name: compositionName,
                 status: 'ok',
-                durationMs: Date.now() - this.currentRunContext.runStartMs,
+                durationMs: Date.now() - this.runExecution().forScope(scope).context.runStartMs,
             });
             return current;
         }, 'finalize', 'Sequence finalize');

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

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

package/dist/esm/core-flow/Workflow.d.ts

@@ -103,11 +103,9 @@ export declare class Workflow<TIn extends object = object, TOut = unknown> exten
     readonly id: string;
     private readonly steps;
     private readonly opts;
-    private currentRunContext;
     constructor(steps: readonly AnyStep[], opts?: WorkflowOptions);
     run(input: TIn, options?: RunOptions): Promise<TOut | RunnerPauseOutcome>;
     resume(checkpoint: FlowchartCheckpoint, input?: unknown, options?: RunOptions): Promise<TOut | RunnerPauseOutcome>;
-    private createExecutor;
     private finalizeResult;
     private buildChart;
 }

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

@@ -62,17 +62,13 @@
  * workflow(parse, reply); // ✗ compile error: Ticket is not { refundUsd }
  * ```
  */
-import { FlowChartExecutor, flowChart, } from 'footprintjs';
+import { flowChart, } from 'footprintjs';
 import { composedInput, readsMessageFromIfAny } from '../core/messageFrom.js';
 import { adoptMemberRedaction } from '../redaction/declared.js';
-import { RunnerBase, makeRunId, underRunSignal } from '../core/RunnerBase.js';
-import { agentRecorder } from '../recorders/core/AgentRecorder.js';
-import { compositionRecorder } from '../recorders/core/CompositionRecorder.js';
-import { ContextRecorder } from '../recorders/core/ContextRecorder.js';
-import { streamRecorder } from '../recorders/core/StreamRecorder.js';
+import { RunnerBase } from '../core/RunnerBase.js';
 import { typedEmit } from '../recorders/core/typedEmit.js';
 import { carryVerdict, childOutcome, raiseChildVerdict } from './childOutcome.js';
-import { adoptParentRun, parentRunIn, readsParentRun, closeParentRun, openParentRun, reopenParentRun, withParentRun, } from '../core/memberRun.js';
+import { parentRunIn, readsParentRun, withParentRun } from '../core/memberRun.js';
 import { requestOf } from '../core/requestOfRun.js';
 /**
  * Hand the previous step's value to the next step as its input args.
@@ -101,11 +97,6 @@ export class Workflow extends RunnerBase {
     id;
     steps;
     opts;
-    currentRunContext = {
-        runStartMs: 0,
-        runId: 'pending',
-        compositionPath: [],
-    };
     constructor(steps, opts = {}) {
         super();
         if (steps.length === 0) {
@@ -123,73 +114,34 @@ export class Workflow extends RunnerBase {
         // It hands the run it serves to its members (`core/memberRun.ts`).
         readsParentRun(this);
         // Eager chart construction — see `RunnerBase.initChart` JSDoc.
-        this.initChart(() => this.buildChart());
+        this.initChart(() => this.buildChart(), {
+            runnerId: this.id,
+            compositionPath: [`Workflow:${this.id}`],
+            initialize: () => ({}),
+        });
     }
     async run(input, options) {
-        // The incoming request, refused here — before anything moves — when
-        // requestContext() did not build it.
-        const request = requestOf(options, 'Workflow.run');
-        const executor = this.createExecutor();
-        this.lastExecutor = executor;
-        // The run every step serves — the caller's identity when the input names
-        // one (`input.identity`, as `AgentInput` does), else this run's own
-        // conversation (`core/memberRun.ts`).
-        const parentRun = openParentRun(this.currentRunContext.runId, input?.identity, 'Workflow.run', request);
-        try {
-            const result = await underRunSignal(options, (engine) => executor.run({
-                input: { ...input, parentRun: parentRun.link },
-                ...(engine ?? {}),
-            }));
-            return this.finalizeResult(executor, result);
-        }
-        finally {
-            // Released when the run returns — finished, failed or paused (a resume re-opens it).
-            closeParentRun(parentRun);
-        }
+        return this.runExecution().withRun(async (invocation) => {
+            const request = requestOf(options, 'Workflow.run');
+            this.prepareCompositionRun(invocation, input?.identity, request, 'Workflow.run');
+            const prepared = this.compositionRunSetup(invocation);
+            const result = await invocation.execute({ kind: 'run', options: { ...options, input: { ...input } } }, prepared.setup, prepared.binding);
+            return this.finalizeResult(invocation, result);
+        });
     }
     async resume(checkpoint, input, options) {
-        // The incoming request, and the paused run its members serve (re-opened
-        // from the checkpoint's own record) — both refused before anything moves.
-        const request = requestOf(options, 'Workflow.resume');
-        const parentRun = reopenParentRun(checkpoint.sharedState, 'Workflow.resume', request);
-        try {
-            // The leg's policy — the paused run's marks — goes to ITS executor, never via the instance.
+        this.noteResumeTakenUp(checkpoint);
+        return this.runExecution().withRun(async (invocation) => {
+            const request = requestOf(options, 'Workflow.resume');
+            this.prepareCompositionResume(invocation, checkpoint, request, 'Workflow.resume');
             const resumeLeg = this.emitPauseResume(checkpoint, input);
-            const executor = this.createExecutor(resumeLeg);
-            this.lastExecutor = executor;
-            const result = await underRunSignal(options, (engine) => executor.resume(checkpoint, input, engine));
-            return this.finalizeResult(executor, result);
-        }
-        finally {
-            closeParentRun(parentRun);
-        }
-    }
-    createExecutor(resumeLeg) {
-        this.currentRunContext = {
-            runStartMs: Date.now(),
-            runId: makeRunId(),
-            compositionPath: [`Workflow:${this.id}`],
-        };
-        // THIS run's context, captured: a run that overlaps it on this instance
-        // never restamps its events, so each is served under its own run's policy.
-        const runContext = this.currentRunContext;
-        const getRunCtx = () => runContext;
-        // The run's redaction (`src/redaction/`): every policy a step declared.
-        const redaction = this.openRunRedaction(resumeLeg, getRunCtx);
-        const spec = this.getSpec();
-        const executor = new FlowChartExecutor(spec, { scopeFactory: redaction.scopeFactoryFor(spec) });
-        redaction.applyTo(executor);
-        const dispatcher = this.getDispatcher();
-        executor.attachCombinedRecorder(new ContextRecorder({ dispatcher, getRunContext: getRunCtx, realWrites: redaction }));
-        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;
+            const prepared = this.compositionRunSetup(invocation, resumeLeg);
+            const result = await invocation.execute({ kind: 'resume', mode: 'fresh', checkpoint, input, options }, prepared.setup, prepared.binding);
+            return this.finalizeResult(invocation, result);
+        });
     }
-    finalizeResult(executor, result) {
-        const paused = this.detectPause(executor, result);
+    finalizeResult(invocation, result) {
+        const paused = this.detectPause(invocation, result);
         if (paused)
             return paused;
         if (result instanceof Error)
@@ -205,7 +157,7 @@ export class Workflow extends RunnerBase {
             // re-wrapping; that is the whole point of the typed chain. The run it
             // serves is kept apart and handed to EVERY step (`core/memberRun.ts`).
             const { parentRun: _run, ...args } = scope.$getArgs();
-            adoptParentRun(scope, { parentRun: _run }, 'Workflow');
+            this.enterComposition(scope, { parentRun: _run }, 'Workflow');
             scope.current = args;
             typedEmit(scope, 'agentfootprint.composition.enter', {
                 kind: 'Sequence',
@@ -259,7 +211,7 @@ export class Workflow extends RunnerBase {
                 id: compositionId,
                 name: compositionName,
                 status: 'ok',
-                durationMs: Date.now() - this.currentRunContext.runStartMs,
+                durationMs: Date.now() - this.runExecution().forScope(scope).context.runStartMs,
             });
             return scope.current;
         }, 'finalize', 'Workflow finalize');

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

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

package/dist/esm/events/dispatcher.d.ts

@@ -181,7 +181,7 @@ export declare class EventDispatcher {
     useRunIdRecogniser(namesARun: (runId: string) => boolean): void;
     /**
      * Install what this run's events are served as. Called by the runner when a
-     * run opens (`RunnerBase · openRunRedaction`) and before a resume's reply.
+     * run opens (`prepareRunRedaction`) and before a resume's reply.
      *
      * @param serving  the run's serving — every run has one: covered by a
      *                 policy, or positively none (the identity, which still
@@ -193,7 +193,7 @@ export declare class EventDispatcher {
     /**
      * Dispatch a fact the runner files about ONE run after its executor returned
      * (its pause request) — served under THAT run's serving
-     * (`runRedaction.ts` · `servingOfExecutor`), never the run in force now: on
+     * (`RunnerInvocation.value.redaction.serving`), never the run in force now: on
      * an instance whose runs overlap, the last run opened is another run. A fact
      * whose run has no serving (`undefined` — an executor no run of this library
      * opened) is refused: served as the placeholder. The real-value path

package/dist/esm/events/dispatcher.js

@@ -242,7 +242,7 @@ export class EventDispatcher {
     }
     /**
      * Install what this run's events are served as. Called by the runner when a
-     * run opens (`RunnerBase · openRunRedaction`) and before a resume's reply.
+     * run opens (`prepareRunRedaction`) and before a resume's reply.
      *
      * @param serving  the run's serving — every run has one: covered by a
      *                 policy, or positively none (the identity, which still
@@ -264,7 +264,7 @@ export class EventDispatcher {
     /**
      * Dispatch a fact the runner files about ONE run after its executor returned
      * (its pause request) — served under THAT run's serving
-     * (`runRedaction.ts` · `servingOfExecutor`), never the run in force now: on
+     * (`RunnerInvocation.value.redaction.serving`), never the run in force now: on
      * an instance whose runs overlap, the last run opened is another run. A fact
      * whose run has no serving (`undefined` — an executor no run of this library
      * opened) is refused: served as the placeholder. The real-value path

package/dist/esm/events/payloads/access.d.ts

@@ -0,0 +1,88 @@
+import type { PermissionCapability, ToolCallEventIdentity } from './dependencyTypes.js';
+export interface PermissionCheckPayload extends Partial<ToolCallEventIdentity> {
+    /** 9.11.0 — the shared vocabulary, so the event cannot drift from the
+     *  request. `'skill_read'` joined it when skill activation became something
+     *  a policy can refuse. */
+    readonly capability: PermissionCapability;
+    readonly actor: string;
+    readonly target?: string;
+    readonly result: 'allow' | 'deny' | 'halt' | 'gate_open';
+    readonly policyEngine?: 'opa' | 'cerbos' | 'custom';
+    readonly policyRuleId?: string;
+    readonly rationale?: string;
+    /** v2.12 — telemetry tag carried through from PermissionDecision.reason. */
+    readonly reason?: string;
+}
+export interface PermissionGateOpenedPayload {
+    readonly gateId: string;
+    readonly openedBy: string;
+    readonly expiresAt?: number;
+}
+/** A tool's declared credential is being resolved before invocation. */
+export interface CredentialRequestedPayload extends Partial<ToolCallEventIdentity> {
+    readonly service: string;
+    readonly mode?: 'machine' | 'user';
+}
+/** A credential was issued. Carries the `kind` only — NEVER the token/secret. */
+export interface CredentialAcquiredPayload extends Partial<ToolCallEventIdentity> {
+    readonly service: string;
+    readonly kind: string;
+    readonly expiresAt?: number;
+}
+/** 3-legged consent is required (the tool is not run until the user authorizes).
+ *  Carries `sessionId` for correlation, NOT the authorization URL. */
+export interface CredentialAuthorizationRequiredPayload extends Partial<ToolCallEventIdentity> {
+    readonly service: string;
+    readonly sessionId: string;
+}
+/**
+ * Credential resolution failed — the provider threw, so the tool is not run
+ * (fail-closed: never half-authed).
+ *
+ * **Never carries the credential, the token, or the authorization URL.** See
+ * the security contract on `CredentialProvider`: `reason` is the provider's own
+ * thrown message, so a provider must scrub secrets before throwing.
+ *
+ * `tool` and `errorClass` were added in 9.4.0, for the operator watching a
+ * dashboard rather than reading a transcript. Without the tool name this event
+ * says a service failed but not what stopped working; without the class every
+ * distinct failure is one undifferentiated string. Both are optional because
+ * neither is always knowable: `tool` is absent when the resolution was not made
+ * on a tool's behalf, and `errorClass` is absent when what was thrown was not
+ * an `Error`.
+ */
+export interface CredentialFailedPayload extends Partial<ToolCallEventIdentity> {
+    /** The service id the tool declared (or asked for), never the credential. */
+    readonly service: string;
+    /** The provider's thrown message. */
+    readonly reason: string;
+    /** The tool whose call needed it — the thing that actually stopped working. */
+    readonly tool?: string;
+    /** Constructor name of what was thrown (e.g. `'TypeError'`, `'TimeoutError'`)
+     *  — the routable half of the failure, so alerts do not have to parse prose. */
+    readonly errorClass?: string;
+}
+export interface PermissionGateClosedPayload {
+    readonly gateId: string;
+    readonly reason: string;
+}
+/**
+ * Emitted (v2.12) when a `PermissionChecker.check()` returns
+ * `{ result: 'halt', ... }`. Pairs with the typed `PolicyHaltError`
+ * thrown by `Agent.run()` — the event is the OBSERVABILITY signal,
+ * the error is the RUNTIME signal. Both carry the same `reason` for
+ * routing (e.g. `'security:exfiltration'` → PagerDuty).
+ *
+ * Fires AFTER the synthetic tool_result has been written to scope.history
+ * but BEFORE the run terminates, so observability adapters see the
+ * halt while the conversation history is consistent for downstream
+ * audit/replay.
+ */
+export interface PermissionHaltPayload extends Partial<ToolCallEventIdentity> {
+    readonly checkerId?: string;
+    readonly target: string;
+    readonly reason: string;
+    readonly tellLLM?: string;
+    readonly iteration: number;
+    readonly sequenceLength: number;
+}

package/dist/esm/events/payloads/access.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=access.js.map

package/dist/esm/events/payloads/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../../../../src/events/payloads/access.ts"],"names":[],"mappings":""}