agentfootprint 13.0.0 → 14.0.0

package/dist/esm/core/conversation.js

@@ -3,10 +3,9 @@
  *
  * Pattern: teaching refusal at a boundary (the shape `runInput` uses for a
  *          caller's message, applied to a caller's TIMING).
- * Role:    core/ layer. An `Agent` keeps the last run's executor, run context,
- *          answer and pause on ITSELF — that is what makes `checkpoint()`,
- *          `getLastSnapshot()` and `followUp()` possible at all. Those fields
- *          have exactly one owner at a time, and until 9.2.0 nothing said so.
+ * Role:    core/ layer. The native lifecycle owns execution and selected views;
+ *          the domain guards keep questions and named conversation identity
+ *          consistent at its public entry points.
  * Emits:   N/A — these fire before a run starts.
  *
  * ## Why these are refusals and not warnings
@@ -37,43 +36,11 @@
  * has fixed before.
  */
 /**
- * Thrown when `run()` / `resume()` is called on a runner that is already
- * running.
- *
- * One instance answers one turn at a time. To run two turns at once, build two
- * agents — a chart is built once per instance and instances are cheap — or put
- * the turns behind `standingAgent({ onConcurrentInvoke: 'enqueue' })`, which
- * queues them.
- *
- * @example
- * ```ts
- * // Refused: both would write the same instance's last-run state.
- * await Promise.all([agent.run({ message: 'a' }), agent.run({ message: 'b' })]);
- *
- * // Fine: two instances, two sets of state.
- * await Promise.all([agentA.run({ message: 'a' }), agentB.run({ message: 'b' })]);
- * ```
+ * One shared native refusal class across logical runners and raw executors.
+ * Migration: runnerId replaces agentId; activeRunId is absent during setup
+ * before native origin exists. Match code ERR_RUN_IN_FLIGHT across formats.
  */
-export class RunInFlightError extends Error {
-    code = 'ERR_RUN_IN_FLIGHT';
-    /** The runner that is busy, by its configured id. */
-    agentId;
-    /** The run already in flight, so a log line can be joined to its trace. */
-    activeRunId;
-    constructor(door, agentId, activeRunId) {
-        super(`${door}: this agent is already running (run '${activeRunId}'). One instance answers one ` +
-            `turn at a time — its last executor, run context, answer and pause all live on the ` +
-            `instance, so two overlapping runs would each finish having overwritten the other's. ` +
-            `Both would return a plausible answer and checkpoint() would then hand back whichever ` +
-            `finished last, which is why this is refused rather than left to look like it worked. ` +
-            `Await the run in flight, build a second Agent for the second turn (charts are ` +
-            `built per instance and instances are cheap), or serve the agent through ` +
-            `standingAgent({ onConcurrentInvoke: 'enqueue' }) to queue turns behind each other.`);
-        this.name = 'RunInFlightError';
-        this.agentId = agentId;
-        this.activeRunId = activeRunId;
-    }
-}
+export { RunInFlightError } from 'footprintjs';
 /**
  * Thrown when a new message is sent to an agent whose last run PAUSED to ask a
  * person something, and that question has not been answered.
@@ -98,7 +65,7 @@ export class PendingQuestionError extends Error {
             `${asked} raised the question and nothing has answered it.${quoted} Answer it with ` +
             `agent.resume(outcome.checkpoint, decision) — that continues the paused run from where ` +
             `it stopped, with no earlier tool re-executed. If the question really is being dropped, ` +
-            `call agent.abandonPause() first and then run() again: a pending question that a later ` +
+            `await agent.abandonPause() first and then run() again: a pending question that a later ` +
             `message silently discards is a consent gate anyone can walk around.`);
         this.name = 'PendingQuestionError';
         if (pending.toolName !== undefined)
@@ -133,12 +100,12 @@ export class PendingQuestionError extends Error {
  */
 export class ResumeIdentityConflictError extends Error {
     code = 'ERR_SESSION_OWNERSHIP_CONFLICT';
-    constructor() {
-        super('Agent.resume: the identity passed to resume() is not the one the paused run was for. ' +
-            "A resumed run keeps the paused run's memory namespace and credentials, so it cannot " +
-            'also run as somebody else. Resume with the identity the paused run was started with ' +
-            "(or none, and the checkpoint's is used), or start a new run for the other person. " +
-            'Neither identity appears in this message on purpose.');
+    constructor(operation = 'resume') {
+        super(operation === 'session'
+            ? 'Agent.resume: the supplied sessionId must match the paused transport session. No state moved.'
+            : operation === 'followUp'
+                ? 'Agent.followUp: the supplied identity differs from the selected conversation. Use a separate instance or start an explicit new conversation. No state moved.'
+                : 'Agent.resume: the supplied identity differs from the paused conversation. Resume with its original identity or start a new conversation. Neither identity is included in this message.');
         this.name = 'ResumeIdentityConflictError';
     }
 }

package/dist/esm/core/conversation.js.map

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

package/dist/esm/core/memberRun.d.ts

@@ -142,6 +142,7 @@ export declare function memberRunArg(record: unknown): {
 export declare function memberIdentityIn(scope: object): MemoryIdentity | undefined;
 /** The memory namespace a member runs under: the named identity, else the run's own conversation. */
 export declare function memberIdentityOf(parentRun: ParentRun): MemoryIdentity;
+export declare function copyIdentity(identity: MemoryIdentity): MemoryIdentity;
 /**
  * A member mounted where no run reaches it — another runner's executor is
  * running this agent's chart, and neither a `parentRun` nor an `identity`

package/dist/esm/core/memberRun.js

@@ -246,7 +246,7 @@ export function memberIdentityIn(scope) {
 export function memberIdentityOf(parentRun) {
     return parentRun.identity ?? { conversationId: parentRun.runId };
 }
-function copyIdentity(identity) {
+export function copyIdentity(identity) {
     return {
         ...(identity.conversationId !== undefined && { conversationId: identity.conversationId }),
         ...(identity.tenant !== undefined && { tenant: identity.tenant }),

package/dist/esm/core/memberRun.js.map

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

package/dist/esm/core/pause.d.ts

@@ -302,11 +302,11 @@ export type ResumeDecisionRefusal = 'no-request' | 'request-not-recorded' | 'oth
  * (`checkInApproved({ request, by })`), and a resume holds the decision to it:
  * the same request, the same call, once.
  *
- * Every refusal but `'already-answered'` is decided before anything moves on
- * an agent's own `resume()`; the checkpoint is unchanged and can be answered
- * with the right decision. `'already-answered'` — and every refusal of a
- * composition's nested agent — is decided where the decision is used, inside
- * the resumed run and still before the tool. See {@link ResumeDecisionRefusal}.
+ * An Agent refuses invalid decision shape and checkpoint binding before native execution.
+ * Known issued-ledger replays and witnessed local closes can also refuse there.
+ * Opaque-ledger refusals, spend races and nested decisions occur inside execution,
+ * still before the tool. An unchanged checkpoint does not prove no execution began;
+ * selected readers follow the actual leg. See {@link ResumeDecisionRefusal}.
  *
  * **It names no request id** — not in its message, not on a field — and a
  * host sends its message as the refusal's body. A refusal that named the

package/dist/esm/core/pause.js

@@ -239,11 +239,11 @@ export class DecisionRequiredError extends Error {
  * (`checkInApproved({ request, by })`), and a resume holds the decision to it:
  * the same request, the same call, once.
  *
- * Every refusal but `'already-answered'` is decided before anything moves on
- * an agent's own `resume()`; the checkpoint is unchanged and can be answered
- * with the right decision. `'already-answered'` — and every refusal of a
- * composition's nested agent — is decided where the decision is used, inside
- * the resumed run and still before the tool. See {@link ResumeDecisionRefusal}.
+ * An Agent refuses invalid decision shape and checkpoint binding before native execution.
+ * Known issued-ledger replays and witnessed local closes can also refuse there.
+ * Opaque-ledger refusals, spend races and nested decisions occur inside execution,
+ * still before the tool. An unchanged checkpoint does not prove no execution began;
+ * selected readers follow the actual leg. See {@link ResumeDecisionRefusal}.
  *
  * **It names no request id** — not in its message, not on a field — and a
  * host sends its message as the refusal's body. A refusal that named the

package/dist/esm/core/pauseRecord.d.ts

@@ -0,0 +1,13 @@
+import type { FlowchartCheckpoint } from 'footprintjs';
+import type { FixedPauseReason } from '../events/payloads.js';
+/** The reason a pause request names when its pause carries none — typed, so a
+ *  redacted record keeps it as the library's own words (`FixedPauseReason`). */
+export declare const DEFAULT_PAUSE_REASON: FixedPauseReason;
+/**
+ * Where a pause happened, as the SEGMENT list every other event carries
+ * (`buildEventMeta`) — so a reader finds the owner of `pause.request` and
+ * `pause.resume` the way it finds every event's. The checkpoint's own list is
+ * footprintjs's resume cursor, one cumulative mount id per level
+ * (`['step-p', 'step-p/x']`); its last entry names the whole path.
+ */
+export declare function pauseSegments(checkpoint: FlowchartCheckpoint): readonly string[];

package/dist/esm/core/pauseRecord.js

@@ -0,0 +1,19 @@
+import { parseSubflowPath } from '../bridge/eventMeta.js';
+/** The reason a pause request names when its pause carries none — typed, so a
+ *  redacted record keeps it as the library's own words (`FixedPauseReason`). */
+export const DEFAULT_PAUSE_REASON = 'stage requested pause';
+/**
+ * Where a pause happened, as the SEGMENT list every other event carries
+ * (`buildEventMeta`) — so a reader finds the owner of `pause.request` and
+ * `pause.resume` the way it finds every event's. The checkpoint's own list is
+ * footprintjs's resume cursor, one cumulative mount id per level
+ * (`['step-p', 'step-p/x']`); its last entry names the whole path.
+ */
+export function pauseSegments(checkpoint) {
+    // Read defensively: `resume()` builds `pause.resume` BEFORE the engine
+    // validates the checkpoint, and a hostile one must still fail there, by name.
+    const cursor = checkpoint.subflowPath;
+    const last = Array.isArray(cursor) ? cursor[cursor.length - 1] : undefined;
+    return typeof last === 'string' ? parseSubflowPath(last) : [];
+}
+//# sourceMappingURL=pauseRecord.js.map

package/dist/esm/core/pauseRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pauseRecord.js","sourceRoot":"","sources":["../../../src/core/pauseRecord.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;gFACgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAqB,uBAAuB,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,UAA+B;IAC3D,uEAAuE;IACvE,8EAA8E;IAC9E,MAAM,MAAM,GAAY,UAAU,CAAC,WAAW,CAAC;IAC/C,MAAM,IAAI,GAAY,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC"}

package/dist/esm/core/runEntry.d.ts

@@ -0,0 +1,8 @@
+import type { RunEntry } from 'footprintjs';
+/**
+ * AF providers read the stage environment. Native deliberately keeps that
+ * environment absent/empty for a caller-only signal; AF explicitly forwards
+ * it here. Native still owns composition, deadlines and listener cleanup.
+ * Read caller option fields and own environment getters once under admission.
+ */
+export declare function nativeEntryFor(entry: RunEntry): RunEntry;

package/dist/esm/core/runEntry.js

@@ -0,0 +1,26 @@
+/**
+ * AF providers read the stage environment. Native deliberately keeps that
+ * environment absent/empty for a caller-only signal; AF explicitly forwards
+ * it here. Native still owns composition, deadlines and listener cleanup.
+ * Read caller option fields and own environment getters once under admission.
+ */
+export function nativeEntryFor(entry) {
+    const source = entry.options;
+    if (source === undefined)
+        return entry;
+    const signal = source.signal;
+    const env = source.env;
+    const snapshot = signal === undefined ? undefined : { ...env };
+    const options = {
+        signal,
+        env: snapshot === undefined ? env : { ...snapshot, signal: snapshot.signal ?? signal },
+        timeoutMs: source.timeoutMs,
+        deadline: source.deadline,
+        maxDepth: source.maxDepth,
+        maxIterations: source.maxIterations,
+    };
+    return entry.kind === 'run'
+        ? { ...entry, options: { ...options, input: entry.options?.input } }
+        : { ...entry, options };
+}
+//# sourceMappingURL=runEntry.js.map

package/dist/esm/core/runEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runEntry.js","sourceRoot":"","sources":["../../../src/core/runEntry.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,MAAM,QAAQ,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;IAC/D,MAAM,OAAO,GAAe;QAC1B,MAAM;QACN,GAAG,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,MAAM,EAAE;QACtF,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK;QACzB,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACpE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC"}

package/dist/esm/core/runnerCoreValues.d.ts

@@ -0,0 +1,16 @@
+import type { RedactionPolicy } from 'footprintjs';
+import type { RunRedaction } from '../redaction/runRedaction.js';
+import type { PrivateRecordFields } from '../redaction/privateFields.js';
+import type { MemoryIdentity } from '../memory/identity/types.js';
+import type { RequestContext } from '../identity/requestContext.js';
+import type { ParentRunRecord } from './memberRun.js';
+export interface RunnerCoreValues {
+    /** Private policy/serving for this execution; never tracked chart state. */
+    redaction?: RunRedaction;
+    privateFields?: PrivateRecordFields;
+    /** Conservative native marks remain record-only, never caller-policy provenance. */
+    recordMarks?: RedactionPolicy;
+    parentIdentity?: MemoryIdentity;
+    parentRequest?: RequestContext;
+    parentRun?: ParentRunRecord;
+}

package/dist/esm/core/runnerCoreValues.js

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

package/dist/esm/core/runnerCoreValues.js.map

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

package/dist/esm/core/runnerExecution.d.ts

@@ -0,0 +1,71 @@
+import { type ComponentRun, type ComponentSetup, type FlowChart, type FlowChartExecutorOptions, type OwnedRun, type RunEntry, type RunLifecycle, type RunSetup, type RunView, type ScopeFactory } from 'footprintjs';
+import type { RunContext } from '../bridge/eventMeta.js';
+/** Domain metadata only. The execution engine is the sole run-id and clock authority. */
+export type RunnerMetadata = Omit<RunContext, 'runId' | 'runStartMs'>;
+export type RunnerEntry = {
+    readonly kind: 'run';
+} | {
+    readonly kind: 'resume';
+    readonly mode: 'same' | 'fresh';
+};
+export type RunnerComponentInstaller<T> = (component: ComponentRun, value: T, entry: RunnerEntry | undefined) => ComponentSetup;
+interface LegMetadata {
+    readonly metadata: RunnerMetadata;
+    readonly entry: RunnerEntry;
+    readonly bindScope?: (scope: unknown, context: Parameters<ScopeFactory>[0]) => void;
+}
+export interface RunnerInvocation<T> {
+    readonly value: T;
+    readonly run: OwnedRun;
+    /** Captured for this admission; never follows a later active/latest selection. */
+    readonly view: RunView;
+    readonly previous: RunnerSelection<T> | undefined;
+    context(): RunContext;
+    execute(entry: RunEntry, setup?: RunSetup, binding?: {
+        readonly metadata?: RunnerMetadata;
+        readonly bindScope?: LegMetadata['bindScope'];
+    }): ReturnType<OwnedRun['execute']>;
+}
+export interface RunnerScopeValues<T> {
+    /** Live native retirement, captured for this scope rather than a selected run. */
+    readonly retired: boolean;
+    readonly value: T;
+    readonly context: RunContext;
+    readonly own: boolean;
+}
+export interface RunnerSelection<T> {
+    readonly value: T;
+    readonly context: RunContext;
+    readonly view: RunView;
+}
+/**
+ * A stable chart stage over an explicit native scope port. The dependency
+ * closure is captured before callbacks or awaits and never reads a selected run.
+ */
+export declare function bindRunnerStage<T, S extends object, A extends unknown[], R>(forScope: (scope: S) => RunnerScopeValues<T>, bind: (run: RunnerScopeValues<T>) => (scope: S, ...args: A) => R): (scope: S, ...args: A) => R;
+/**
+ * AgentFootprint's domain adapter over the native lifecycle. It adds metadata
+ * and private domain values; all ownership, scope banks, continuations and
+ * active/latest selection remain the footprintjs implementation.
+ */
+export declare class RunnerExecution<T> {
+    private readonly defaults;
+    private readonly initialize;
+    private readonly lifecycle;
+    private readonly values;
+    private readonly metadata;
+    private readonly byOrigin;
+    private readonly metadataByOrigin;
+    constructor(chart: FlowChart, defaults: {
+        readonly runnerId: string;
+        readonly compositionPath: readonly string[];
+    }, initialize: () => T, options?: FlowChartExecutorOptions, installComponent?: RunnerComponentInstaller<T>);
+    withRun<R>(body: (invocation: RunnerInvocation<T>) => R | Promise<R>): Promise<R>;
+    /** One component's values, including internal charts; independent mounts do not share. */
+    forScope(scope: unknown): RunnerScopeValues<T>;
+    /** Reads exactly the native-selected execution, including the in-progress run. */
+    selected(): RunnerSelection<T> | undefined;
+    view(): RunView | undefined;
+    continuation(): ReturnType<RunLifecycle['continuation']>;
+}
+export {};

package/dist/esm/core/runnerExecution.js

@@ -0,0 +1,170 @@
+import { createRunLifecycle, } from 'footprintjs';
+import { createTypedScopeFactory } from 'footprintjs/advanced';
+import { nativeEntryFor } from './runEntry.js';
+/**
+ * A stable chart stage over an explicit native scope port. The dependency
+ * closure is captured before callbacks or awaits and never reads a selected run.
+ */
+export function bindRunnerStage(forScope, bind) {
+    return (scope, ...args) => bind(forScope(scope))(scope, ...args);
+}
+/**
+ * Metadata carried by the actual executor's scope factory. A mounted runner
+ * reads the host facts of THAT scope, never its own instance's latest run.
+ * This map has no admission, continuation, active/latest pointer or state bank.
+ */
+const hostContexts = new WeakMap();
+function metadataOf(metadata) {
+    const { compositionPath, traceId, correlationId, turnIndex, iterIndex, sessionId, principal, tenant, } = metadata;
+    return Object.freeze({
+        compositionPath: Object.freeze([...compositionPath]),
+        ...(traceId !== undefined && { traceId }),
+        ...(correlationId !== undefined && { correlationId }),
+        ...(turnIndex !== undefined && { turnIndex }),
+        ...(iterIndex !== undefined && { iterIndex }),
+        ...(sessionId !== undefined && { sessionId }),
+        ...(principal !== undefined && { principal }),
+        ...(tenant !== undefined && { tenant }),
+    });
+}
+function contextOf(origin, metadata) {
+    return Object.freeze({
+        ...metadataOf(metadata),
+        runId: origin.runId,
+        runStartMs: origin.startedAtMs,
+    });
+}
+/**
+ * AgentFootprint's domain adapter over the native lifecycle. It adds metadata
+ * and private domain values; all ownership, scope banks, continuations and
+ * active/latest selection remain the footprintjs implementation.
+ */
+export class RunnerExecution {
+    defaults;
+    initialize;
+    lifecycle;
+    values;
+    metadata;
+    byOrigin = new WeakMap();
+    metadataByOrigin = new WeakMap();
+    constructor(chart, defaults, initialize, options, installComponent) {
+        this.defaults = defaults;
+        this.initialize = initialize;
+        this.defaults = Object.freeze({
+            ...defaults,
+            compositionPath: Object.freeze([...defaults.compositionPath]),
+        });
+        const base = options?.scopeFactory ?? chart.scopeFactory ?? createTypedScopeFactory();
+        this.lifecycle = createRunLifecycle(chart, {
+            runnerId: defaults.runnerId,
+            componentSetup: (component) => {
+                const values = component.local(this.values, () => ({
+                    value: this.initialize(),
+                    own: false,
+                }));
+                const leg = component.read(this.metadata);
+                return (installComponent?.(component, values.value, values.own && leg.present ? leg.value.entry : undefined) ?? {});
+            },
+            executorOptions: {
+                ...options,
+                scopeFactory: (context, stage, readOnly, env) => {
+                    const scope = base(context, stage, readOnly, env);
+                    if (scope !== null && typeof scope === 'object') {
+                        const bound = this.lifecycle.forScope(scope);
+                        const leg = bound.read(this.metadata);
+                        const metadata = leg.present ? leg.value.metadata : this.defaults;
+                        hostContexts.set(scope, contextOf(bound.origin, metadata));
+                        if (leg.present)
+                            leg.value.bindScope?.(scope, context);
+                    }
+                    return scope;
+                },
+            },
+        });
+        this.values = this.lifecycle.slot('component');
+        this.metadata = this.lifecycle.slot('leg');
+    }
+    withRun(body) {
+        const prior = { previous: this.selected() };
+        return this.lifecycle.withRun(async (run) => {
+            const view = this.lifecycle.view();
+            if (view === undefined)
+                throw new TypeError('The admitted native execution has no view');
+            // Initialization, including any callback it invokes, is under native admission.
+            const values = { value: this.initialize(), own: true };
+            run.set(this.values, values);
+            let metadata = metadataOf(this.defaults);
+            const invocation = {
+                value: values.value,
+                run,
+                view,
+                get previous() {
+                    return prior.previous;
+                },
+                context: () => {
+                    if (run.origin === undefined)
+                        throw new TypeError('The native run has no admitted origin yet');
+                    return contextOf(run.origin, metadata);
+                },
+                execute: (entry, setup, binding) => {
+                    metadata = metadataOf(binding?.metadata ?? this.defaults);
+                    return run.execute(nativeEntryFor(entry), {
+                        ...setup,
+                        onOrigin: (cells, origin) => {
+                            cells.set(this.metadata, {
+                                metadata,
+                                entry: entry.kind === 'run' ? { kind: 'run' } : { kind: 'resume', mode: entry.mode },
+                                bindScope: binding?.bindScope,
+                            });
+                            this.byOrigin.set(origin, values);
+                            this.metadataByOrigin.set(origin, metadata);
+                            return setup?.onOrigin?.(cells, origin);
+                        },
+                    });
+                },
+            };
+            try {
+                return await body(invocation);
+            }
+            finally {
+                prior.previous = undefined;
+            }
+        });
+    }
+    /** One component's values, including internal charts; independent mounts do not share. */
+    forScope(scope) {
+        const bound = this.lifecycle.forScope(scope);
+        const values = bound.local(this.values, () => ({ value: this.initialize(), own: false }));
+        const host = scope !== null && typeof scope === 'object' ? hostContexts.get(scope) : undefined;
+        const metadata = host === undefined
+            ? this.defaults
+            : { ...host, compositionPath: [...host.compositionPath, ...this.defaults.compositionPath] };
+        const ownMetadata = bound.read(this.metadata);
+        return {
+            ...values,
+            get retired() {
+                return bound.retired;
+            },
+            context: contextOf(bound.origin, ownMetadata.present ? ownMetadata.value.metadata : metadata),
+        };
+    }
+    /** Reads exactly the native-selected execution, including the in-progress run. */
+    selected() {
+        const view = this.lifecycle.view();
+        const origin = view?.origin;
+        if (view === undefined || origin === undefined)
+            return undefined;
+        const values = this.byOrigin.get(origin);
+        const metadata = this.metadataByOrigin.get(origin);
+        if (values === undefined || metadata === undefined)
+            return undefined;
+        return { value: values.value, context: contextOf(origin, metadata), view };
+    }
+    view() {
+        return this.lifecycle.view();
+    }
+    continuation() {
+        return this.lifecycle.continuation();
+    }
+}
+//# sourceMappingURL=runnerExecution.js.map

package/dist/esm/core/runnerExecution.js.map

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

package/dist/esm/core/runnerLive.d.ts

@@ -26,9 +26,30 @@
  * consumer wires up — an exporter, a recorder, a sink — can turn them into a
  * record. The registry is weak: a runner that is collected takes its taps along.
  */
-import type { RuntimeSnapshot } from 'footprintjs';
+import type { RuntimeSnapshot, FlowchartCheckpoint, RunView, CombinedRecorder } from 'footprintjs';
+import type { RunnerPauseOutcome } from './pause.js';
+import type { AgentInput } from './agent/types.js';
+import type { AgentRunOptions } from './Agent.js';
+import type { AgentRunCheckpoint } from './runCheckpoint.js';
 import type { AgentfootprintEvent } from '../events/registry.js';
 import type { Unsubscribe } from '../events/dispatcher.js';
+/** Private occurrence ownership; never serialized into a checkpoint or exposed on Runner. */
+export interface PauseOwnership {
+    release(): void;
+    abandon(): Promise<void>;
+}
+/** Captured inside one invocation, before its lease ends or a host awaits. */
+export interface HostedTurn {
+    readonly output: unknown;
+    readonly conversation: AgentRunCheckpoint | undefined;
+    readonly ownership: PauseOwnership | undefined;
+}
+/** The invocation a host admitted, independent of the runner's selected view. */
+export interface HostedInvocation {
+    readonly view: RunView;
+    runId(): string | undefined;
+}
+export type BindHostedInvocation = (invocation: HostedInvocation) => CombinedRecorder | undefined;
 /** What the library reads live from a runner. */
 export interface RunnerLive {
     /** Subscribe to every event as its producer made it — never served. */
@@ -37,6 +58,16 @@ export interface RunnerLive {
     liveState(): Readonly<Record<string, unknown>> | undefined;
     /** The current (or last) run's snapshot, live and unserved. */
     liveSnapshot(): RuntimeSnapshot | undefined;
+    /** Agent-only execution port; never follows a later selected run. */
+    readonly turn?: {
+        run(input: AgentInput | string, options?: AgentRunOptions, bind?: BindHostedInvocation): Promise<HostedTurn>;
+        resume(checkpoint: FlowchartCheckpoint, input?: unknown, options?: AgentRunOptions, bind?: BindHostedInvocation): Promise<HostedTurn>;
+    };
+    /** Agent-only host ownership transfer, captured synchronously from an actual result. */
+    readonly pause?: {
+        capture(outcome: RunnerPauseOutcome): PauseOwnership | undefined;
+        abandon(checkpoint: FlowchartCheckpoint): Promise<void>;
+    };
 }
 /** Register `runner`'s live taps — `RunnerBase` does, once per runner. Returns them. */
 export declare function registerRunnerLive(runner: object, live: RunnerLive): RunnerLive;

package/dist/esm/core/runnerLive.js.map

@@ -1 +1 @@
-{"version":3,"file":"runnerLive.js","sourceRoot":"","sources":["../../../src/core/runnerLive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAiBH,MAAM,IAAI,GAAG,IAAI,OAAO,EAAsB,CAAC;AAE/C,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAgB;IACjE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"runnerLive.js","sourceRoot":"","sources":["../../../src/core/runnerLive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA6DH,MAAM,IAAI,GAAG,IAAI,OAAO,EAAsB,CAAC;AAE/C,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAgB;IACjE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/dist/esm/core/slots/buildThinkingSubflow.d.ts

@@ -32,7 +32,7 @@ import type { ThinkingHandler } from '../../thinking/types.js';
  *   4. On success: writes `scope.thinkingBlocks` + emits `stream.thinking_end`
  *   5. On throw: writes empty array + emits `agent.thinking_parse_failed`
  *
- * The result on `scope.thinkingBlocks` is read by toolCalls.ts and
+ * The result on `scope.thinkingBlocks` is read by toolCalls/batch/dispatchContext.ts and
  * prepareFinal.ts when constructing the assistant message for
  * `scope.history` — that's where the Anthropic signature round-trip
  * actually flows from.