agentfootprint 10.3.1 → 10.5.0

package/dist/esm/core/agent/types.d.ts

@@ -1432,17 +1432,27 @@ export interface AgentState {
      * Where `runIdentity` came from, when it came from somewhere other than the
      * caller (9.10.0).
      *
-     * Present ONLY as `'session'`, and only when the run carried a
-     * `sessionId` and no identity at all — the one derivation this library
-     * makes. Absent means the identity is either the caller's own or the
-     * per-run default, which is what every release before 9.10.0 committed, so
-     * a run that is not session-bound writes exactly the keys it always did.
+     * `'session'` when the run carried a `sessionId` and no identity at all;
+     * `'composition'` when the agent ran as a composition member whose run named
+     * none, so its namespace is that run's own `{ conversationId: runId }`
+     * (`core/memberRun.ts`). Absent means the identity is either the caller's
+     * own or the per-run default, which is what every release before 9.10.0
+     * committed, so a run that is neither writes exactly the keys it always did.
      *
      * It is a fact about the RECORD, not a dial: nothing reads it to decide
      * anything. It exists so a trace can be asked "did anyone actually name this
      * namespace?" and answer honestly.
      */
-    runIdentitySource?: 'session';
+    runIdentitySource?: 'session' | 'composition';
+    /**
+     * The run this agent serves as a composition MEMBER (`core/memberRun.ts`) —
+     * the composition's run id and the identity its caller named, if any.
+     * Written by seed ONLY on a member's run, where it is the source of the
+     * facts the member's tools are handed (`ctx.runId`, `ctx.identity`): the
+     * instance's own fields describe some other run. Absent on the agent's own
+     * runs, which commit exactly the keys they always did.
+     */
+    memberRun?: import('../memberRun.js').ParentRunRecord;
     /**
      * The session this run served — written by seed on a session-bound run;
      * `null` on a run a caller named an identity for that has no session (the
@@ -1558,6 +1568,16 @@ export interface AgentState {
     answerValidation?: import('../../answer-validation/index.js').AnswerValidationReport;
     /** Refusal carrier: prevents final capture, history, memory and token delivery. */
     answerValidationBlocked?: boolean;
+    /**
+     * This run's tool calls — name, call id, outcome; never arguments or
+     * results — the ledger `answerValidation` hands a check as
+     * `context.toolCalls`. Written beside every `stream.tool_end` bracket, and
+     * ONLY on an agent with `answerValidation` (`ToolCallsHandlerDeps.toolCallLedger`),
+     * so every other agent commits exactly the keys it always did. Run state:
+     * seed starts a fresh, empty one on every run; a pause carries it to the
+     * resumed leg.
+     */
+    toolCallLedger?: import('../../answer-validation/toolLedger.js').ToolCallLedger;
     /** Set only at the final capture after a validation report was accepted. */
     answerValidationCommitted?: boolean;
     /** In-flight hand-off from the Route decider (which judges the answer and

package/dist/esm/core/agent/window/strategies/summarizeOldest.js

@@ -26,6 +26,7 @@ import { resolveCompactionOptions } from '../options.js';
 import { indexRange } from '../removal.js';
 import { buildSummaryMessage, isCompactedSummary, runSummarizer } from '../summarize.js';
 import { windowChars } from '../turns.js';
+import { throwIfAborted } from '../../../../lib/abort.js';
 /** `WindowRecord.strategy` written by every record this strategy files. */
 export const SUMMARIZE_OLDEST = 'summarize-oldest';
 /**
@@ -152,6 +153,9 @@ export function summarizeOldest(options) {
                 };
             }
             catch (err) {
+                // A cancelled run is not a broken summarizer: the abort leaves as
+                // itself, with no refusal filed and no warning (lib/abort.ts).
+                throwIfAborted(input.signal);
                 return {
                     ...unchanged([
                         { reason: 'summarizer-failed', turnIndex: plan.from, messageIndex: spanStart },

package/dist/esm/core/agent/window/strategies/summarizeOldest.js.map

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

package/dist/esm/core/agent/window/summarize.js

@@ -25,6 +25,7 @@
  * Emits:   N/A (the stage emits; this file only builds and calls).
  */
 import { COMPACTED_FRAME_PREFIX } from '../../../lib/saidByPerson.js';
+import { callUnder } from '../../../lib/abort.js';
 // The marker and its recognizer live in the leaf both this file and the
 // injection engine can import — a rule author has to be able to apply the same
 // rule the window applies (9.84.0). The label below is still ours.
@@ -153,12 +154,14 @@ export function buildSummaryMessage(summary, facts) {
  * instance.
  */
 export async function runSummarizer(provider, model, span, signal) {
-    const response = await provider.complete({
+    // The run's signal rides the request and bounds the wait; an answer that
+    // lands after it is refused rather than folded in (lib/abort.ts · callUnder).
+    const request = {
         systemPrompt: SUMMARIZER_SYSTEM_PROMPT,
         messages: [{ role: 'user', content: renderTranscript(span) }],
         model,
-        ...(signal !== undefined && { signal }),
-    });
+    };
+    const response = await callUnder(request, signal, (wired) => provider.complete(wired));
     return { text: response.content, usage: response.usage };
 }
 //# sourceMappingURL=summarize.js.map

package/dist/esm/core/agent/window/summarize.js.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../../../../src/core/agent/window/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,wEAAwE;AACxE,+EAA+E;AAC/E,mEAAmE;AACnE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAE1F,kFAAkF;AAClF,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAC3C,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,wFAAwF;IACxF,kCAAkC;IAClC,EAAE;IACF,kCAAkC,eAAe,QAAQ,gBAAgB,sBAAsB;IAC/F,8FAA8F;IAC9F,6FAA6F;IAC7F,EAAE;IACF,4FAA4F;IAC5F,6FAA6F;IAC7F,gGAAgG;IAChG,yEAAyE;CAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,+EAA+E;AAC/E,SAAS,aAAa,CAAC,GAAe;IACpC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1F,MAAM,IAAI,GACR,GAAG,CAAC,IAAI,KAAK,MAAM;QACjB,CAAC,CAAC,eAAe,GAAG,CAAC,QAAQ,IAAI,SAAS,GAAG;QAC7C,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAC9C,CAAC,CAAC,qBAAqB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC1C,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACf,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,QAA+B;IAC9D,OAAO,CAAC,eAAe,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,MAA2B;IACpD,OAAO,MAAM,KAAK,cAAc;QAC9B,CAAC,CAAC,uFAAuF;YACrF,aAAa;QACjB,CAAC,CAAC,mFAAmF;YACjF,+BAA+B,CAAC;AACxC,CAAC;AAED,4CAA4C;AAC5C,4IAA4I;AAC5I,2FAA2F;AAC3F,mFAAmF;AACnF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,KAYC;IAED,MAAM,KAAK,GACT,GAAG,sBAAsB,MAAM,KAAK,CAAC,kBAAkB,kCAAkC;QACzF,mCAAmC,KAAK,CAAC,SAAS,0CAA0C;QAC5F,cAAc,KAAK,CAAC,KAAK,gEAAgE;QACzF,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;IACxC,MAAM,OAAO,GAAG,GAAG,KAAK,OAAO,OAAO,EAAE,CAAC;IACzC,yEAAyE;IACzE,2EAA2E;IAC3E,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;IACzC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAqB,EACrB,KAAa,EACb,IAA2B,EAC3B,MAA+B;IAE/B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC;QACvC,YAAY,EAAE,wBAAwB;QACtC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,KAAK;QACL,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;KACxC,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../../../../src/core/agent/window/summarize.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,153 @@
+/**
+ * memberRun — WHO a composition member runs for: the run that mounted it.
+ *
+ * ── The defect this closes ───────────────────────────────────────────────────
+ * A composition (`Sequence`, `Parallel`, `Conditional`, `Loop`, `Workflow`,
+ * `Graph`) mounts each member's chart in ITS OWN executor; the member's
+ * `run()` never runs. So a member agent's per-run facts — the memory
+ * namespace, a tool's `ctx.identity`, `ctx.runId` — were read off the member
+ * INSTANCE, which every run of the composition shares: `'pending'` for an
+ * instance never run on its own (one memory for every user of the
+ * composition), or the last direct run's caller (another person's identity).
+ *
+ * ── The rule ─────────────────────────────────────────────────────────────────
+ * The run decides, and only the engine can name it. The OUTERMOST
+ * composition's `run()` OPENS one run — the identity its caller named, or
+ * none, and that run's own id — in this module's private registry, and hands
+ * its members only an unguessable LINK to it (`withParentRun`), nesting
+ * included. A member agent looks the run up by that link (`stages/seed.ts`):
+ * the caller's identity when one was named, else the run's own per-run
+ * conversation `{ conversationId: runId }` — never a value its instance
+ * holds, and never a run-shaped value it was handed: a `parentRun` that is not
+ * a live link is refused by name (`ParentRunRefusedError`). A member mounted
+ * where no run reaches it is refused too (`MemberIdentityError`).
+ *
+ * Per-run args are the carrier because they are the one thing two overlapping
+ * runs of one composition cannot share.
+ *
+ * Pattern: value object + pure helpers. Role: core, run identity.
+ */
+import type { MemoryIdentity } from '../memory/identity/types.js';
+import type { RequestContext } from '../identity/requestContext.js';
+/** The state key a runner keeps the run it serves under. */
+export declare const MEMBER_RUN_KEY = "memberRun";
+/** The run a member is mounted in. */
+export interface ParentRun {
+    /** The outermost run's id — the member's `ctx.runId`, and its conversation when no identity was named. */
+    readonly runId: string;
+    /** The identity the outermost run's caller named, if any. */
+    readonly identity?: MemoryIdentity;
+}
+/**
+ * A run as a runner's state records it: the run, and the LINK that names it in
+ * this module's registry. Only the link travels to members; what a member runs
+ * for is looked up here, never read off what it was handed.
+ */
+export interface ParentRunRecord extends ParentRun {
+    readonly link: string;
+}
+/**
+ * A `parentRun` that is not a live link this module issued — forged, copied
+ * from another run, or a run already over. Refused, never used.
+ */
+export declare class ParentRunRefusedError extends Error {
+    readonly code: "ERR_PARENT_RUN_REFUSED";
+    constructor(door: string);
+}
+/**
+ * Open the run a top-level composition run hands its members, and register it.
+ * Close it with {@link closeParentRun} when the run returns (finished or paused).
+ *
+ * @throws TypeError (from `assertIdentityShape`) when `identity` is not one.
+ */
+export declare function openParentRun(runId: string, identity: MemoryIdentity | undefined, door: string, request?: RequestContext): ParentRunRecord;
+/**
+ * Re-open, for a resumed leg, the run a paused composition was running — read
+ * off the checkpoint's own state (the checkpoint is the record of that run; a
+ * host keeps it server-side or signs it, as for every resume). `undefined`
+ * when the paused run recorded none.
+ */
+export declare function reopenParentRun(sharedState: unknown, door: string, request?: RequestContext): ParentRunRecord | undefined;
+/** Release a run this module opened (`openParentRun` / `reopenParentRun`). */
+export declare function closeParentRun(record: ParentRunRecord | undefined): void;
+/**
+ * The request a live link's run serves, or `undefined` — for a dead link, a
+ * value that is not a link, or a run opened without one.
+ */
+export declare function requestOfLink(link: unknown): RequestContext | undefined;
+/**
+ * The request a member's stage serves, read from the stage's own input: the
+ * request of the run its `parentRun` link names. A member with no link (a
+ * chart a caller built and runs itself) serves NO request — never the
+ * request of whatever run its instance is in elsewhere.
+ */
+export declare function memberRequestIn(scope: object): RequestContext | undefined;
+/**
+ * A resume names a request while the run it resumes is still open under
+ * another — its members would serve two requests. Refused before anything runs.
+ */
+export declare class ResumeRequestConflictError extends Error {
+    readonly code: "ERR_RESUME_REQUEST_CONFLICT";
+    constructor(door: string);
+}
+/** The run a live link names, or `undefined`. */
+export declare function runOfLink(link: unknown): ParentRun | undefined;
+/**
+ * The run a runner was handed in its input, looked up by its link; `undefined`
+ * when the input carries none.
+ *
+ * @throws ParentRunRefusedError when a `parentRun` is present but is not a live
+ *   link — a member never runs under a run it cannot prove.
+ */
+export declare function resolveParentRun(args: unknown, door: string): ParentRunRecord | undefined;
+/**
+ * Register a runner that reads `parentRun` from its input — `Agent` and the
+ * compositions call this in their constructors. Every other runner is handed
+ * the input it always was, byte for byte.
+ */
+export declare function readsParentRun(runner: object): void;
+/**
+ * A member's input with the LINK of the run it is mounted in — what every
+ * composition's input mapper returns — for a runner that reads it; the input
+ * unchanged for any other runner, or when there is no run to hand down.
+ */
+export declare function withParentRun<I extends object>(input: I, record: ParentRunRecord | undefined, runner: object): I | (I & {
+    readonly parentRun: string;
+});
+/**
+ * A composition's seed: resolve the link it was handed — its own `run()`
+ * opened one; a parent composition's mapper hands one down — and keep the run
+ * in its state, under {@link MEMBER_RUN_KEY}, for its input mappers to hand on
+ * (a run's input is not part of the state an input mapper reads). Written only
+ * when there is one.
+ *
+ * @throws ParentRunRefusedError for a link that is not live.
+ */
+export declare function adoptParentRun(scope: object, args: unknown, door: string): void;
+/** The run a runner's state carries (`adoptParentRun`, or an agent's seed), for its input mappers. */
+export declare function parentRunIn(state: unknown): ParentRunRecord | undefined;
+/**
+ * What an inner mount of a member agent is handed of its run: the link, or —
+ * for a chart a caller built — the identity it was given. Nothing on the
+ * agent's own runs.
+ */
+export declare function memberRunArg(record: unknown): {
+    readonly parentRun?: string;
+    readonly memberIdentity?: MemoryIdentity;
+};
+/**
+ * The identity a member's stage runs for, read from the stage's own input:
+ * the run its link names, else the identity a caller-built chart handed it.
+ */
+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;
+/**
+ * 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`
+ * arrived in its input. Refused rather than run under its instance's last run.
+ */
+export declare class MemberIdentityError extends Error {
+    readonly code: "ERR_MEMBER_NO_IDENTITY";
+    constructor();
+}

package/dist/esm/core/memberRun.js

@@ -0,0 +1,273 @@
+/**
+ * memberRun — WHO a composition member runs for: the run that mounted it.
+ *
+ * ── The defect this closes ───────────────────────────────────────────────────
+ * A composition (`Sequence`, `Parallel`, `Conditional`, `Loop`, `Workflow`,
+ * `Graph`) mounts each member's chart in ITS OWN executor; the member's
+ * `run()` never runs. So a member agent's per-run facts — the memory
+ * namespace, a tool's `ctx.identity`, `ctx.runId` — were read off the member
+ * INSTANCE, which every run of the composition shares: `'pending'` for an
+ * instance never run on its own (one memory for every user of the
+ * composition), or the last direct run's caller (another person's identity).
+ *
+ * ── The rule ─────────────────────────────────────────────────────────────────
+ * The run decides, and only the engine can name it. The OUTERMOST
+ * composition's `run()` OPENS one run — the identity its caller named, or
+ * none, and that run's own id — in this module's private registry, and hands
+ * its members only an unguessable LINK to it (`withParentRun`), nesting
+ * included. A member agent looks the run up by that link (`stages/seed.ts`):
+ * the caller's identity when one was named, else the run's own per-run
+ * conversation `{ conversationId: runId }` — never a value its instance
+ * holds, and never a run-shaped value it was handed: a `parentRun` that is not
+ * a live link is refused by name (`ParentRunRefusedError`). A member mounted
+ * where no run reaches it is refused too (`MemberIdentityError`).
+ *
+ * Per-run args are the carrier because they are the one thing two overlapping
+ * runs of one composition cannot share.
+ *
+ * Pattern: value object + pure helpers. Role: core, run identity.
+ */
+import { assertIdentityShape } from './agent/callerIdentity.js';
+/** The state key a runner keeps the run it serves under. */
+export const MEMBER_RUN_KEY = 'memberRun';
+// ── The brand: a module-private registry of the runs a composition opened ──
+//
+// A member is handed a LINK, an unguessable token, never a run. The run it
+// names lives here, where only `openParentRun` / `reopenParentRun` can put it
+// — so nothing outside this module (an option, an input, a mapper, a state
+// key, a model's or a tool's output) can make a member run for someone: a
+// `parentRun` that is not a live link is refused by name. A token rather than
+// an object brand, because a member's input is copied on its way in, and a
+// copy keeps a string but not an object's identity.
+const live = new Map();
+/**
+ * A `parentRun` that is not a live link this module issued — forged, copied
+ * from another run, or a run already over. Refused, never used.
+ */
+export class ParentRunRefusedError extends Error {
+    code = 'ERR_PARENT_RUN_REFUSED';
+    constructor(door) {
+        super(`${door}: \`parentRun\` is not a run this process opened — it is refused. Only a ` +
+            'composition’s own run() hands its members their run; one built anywhere else (an ' +
+            'option, an input mapper, a model’s or a tool’s output) could name another person.');
+        this.name = 'ParentRunRefusedError';
+    }
+}
+/**
+ * Open the run a top-level composition run hands its members, and register it.
+ * Close it with {@link closeParentRun} when the run returns (finished or paused).
+ *
+ * @throws TypeError (from `assertIdentityShape`) when `identity` is not one.
+ */
+export function openParentRun(runId, identity, door, request) {
+    assertIdentityShape(identity, door);
+    const run = {
+        runId,
+        ...(identity !== undefined && { identity: copyIdentity(identity) }),
+    };
+    const link = globalThis.crypto.randomUUID();
+    // The request stays HERE, beside the run, and never on the record: the
+    // record is written to the runner's state, and state is the record.
+    live.set(link, { run, holders: 1, ...(request !== undefined && { request }) });
+    return { link, ...run };
+}
+/**
+ * Re-open, for a resumed leg, the run a paused composition was running — read
+ * off the checkpoint's own state (the checkpoint is the record of that run; a
+ * host keeps it server-side or signs it, as for every resume). `undefined`
+ * when the paused run recorded none.
+ */
+export function reopenParentRun(sharedState, door, request) {
+    if (sharedState === null || typeof sharedState !== 'object')
+        return undefined;
+    const raw = sharedState[MEMBER_RUN_KEY];
+    if (raw === undefined)
+        return undefined;
+    const { link, runId, identity } = (raw ?? {});
+    if (typeof link !== 'string' || link === '' || typeof runId !== 'string' || runId === '') {
+        throw new ParentRunRefusedError(door);
+    }
+    assertIdentityShape(identity, door);
+    const run = {
+        runId,
+        ...(identity !== undefined && { identity: copyIdentity(identity) }),
+    };
+    const held = live.get(link);
+    if (held !== undefined) {
+        // The run is still open elsewhere. Its members already serve ONE request;
+        // a resume naming another would hand them a second — refused, not merged.
+        if (held.request !== request)
+            throw new ResumeRequestConflictError(door);
+        held.holders++;
+    }
+    else
+        live.set(link, { run, holders: 1, ...(request !== undefined && { request }) });
+    return { link, ...(held?.run ?? run) };
+}
+/** Release a run this module opened (`openParentRun` / `reopenParentRun`). */
+export function closeParentRun(record) {
+    if (record === undefined)
+        return;
+    const held = live.get(record.link);
+    if (held === undefined)
+        return;
+    if (--held.holders <= 0)
+        live.delete(record.link);
+}
+/**
+ * The request a live link's run serves, or `undefined` — for a dead link, a
+ * value that is not a link, or a run opened without one.
+ */
+export function requestOfLink(link) {
+    return typeof link === 'string' ? live.get(link)?.request : undefined;
+}
+/**
+ * The request a member's stage serves, read from the stage's own input: the
+ * request of the run its `parentRun` link names. A member with no link (a
+ * chart a caller built and runs itself) serves NO request — never the
+ * request of whatever run its instance is in elsewhere.
+ */
+export function memberRequestIn(scope) {
+    const getArgs = scope.$getArgs;
+    const args = (typeof getArgs === 'function' ? getArgs.call(scope) : undefined);
+    return requestOfLink(args?.parentRun);
+}
+/**
+ * A resume names a request while the run it resumes is still open under
+ * another — its members would serve two requests. Refused before anything runs.
+ */
+export class ResumeRequestConflictError extends Error {
+    code = 'ERR_RESUME_REQUEST_CONFLICT';
+    constructor(door) {
+        super(`${door}: the paused run is still open and serves another request — a resume cannot hand its ` +
+            'members a second one. Resume it once the open leg has returned.');
+        this.name = 'ResumeRequestConflictError';
+    }
+}
+/** The run a live link names, or `undefined`. */
+export function runOfLink(link) {
+    return typeof link === 'string' ? live.get(link)?.run : undefined;
+}
+/**
+ * The run a runner was handed in its input, looked up by its link; `undefined`
+ * when the input carries none.
+ *
+ * @throws ParentRunRefusedError when a `parentRun` is present but is not a live
+ *   link — a member never runs under a run it cannot prove.
+ */
+export function resolveParentRun(args, door) {
+    if (args === null || typeof args !== 'object')
+        return undefined;
+    const link = args.parentRun;
+    if (link === undefined)
+        return undefined;
+    const run = runOfLink(link);
+    if (run === undefined)
+        throw new ParentRunRefusedError(door);
+    return { link: link, ...run };
+}
+/** The runners that read `parentRun` — an Agent, and every composition (which hands it on). */
+const readers = new WeakSet();
+/**
+ * Register a runner that reads `parentRun` from its input — `Agent` and the
+ * compositions call this in their constructors. Every other runner is handed
+ * the input it always was, byte for byte.
+ */
+export function readsParentRun(runner) {
+    readers.add(runner);
+}
+/**
+ * A member's input with the LINK of the run it is mounted in — what every
+ * composition's input mapper returns — for a runner that reads it; the input
+ * unchanged for any other runner, or when there is no run to hand down.
+ */
+export function withParentRun(input, record, runner) {
+    if (!readers.has(runner))
+        return input;
+    if (record !== undefined)
+        return { ...input, parentRun: record.link };
+    // No run to hand down: a `parentRun` already in the input came from a mapper
+    // or an earlier step's data, not from this module — a link is a key to its
+    // run's identity and request, so one that arrived that way is dropped.
+    if (!Object.hasOwn(input, 'parentRun'))
+        return input;
+    const { parentRun: _dropped, ...rest } = input;
+    void _dropped;
+    return rest;
+}
+/**
+ * A composition's seed: resolve the link it was handed — its own `run()`
+ * opened one; a parent composition's mapper hands one down — and keep the run
+ * in its state, under {@link MEMBER_RUN_KEY}, for its input mappers to hand on
+ * (a run's input is not part of the state an input mapper reads). Written only
+ * when there is one.
+ *
+ * @throws ParentRunRefusedError for a link that is not live.
+ */
+export function adoptParentRun(scope, args, door) {
+    const record = resolveParentRun(args, door);
+    if (record !== undefined)
+        scope[MEMBER_RUN_KEY] = record;
+}
+/** The run a runner's state carries (`adoptParentRun`, or an agent's seed), for its input mappers. */
+export function parentRunIn(state) {
+    if (state === null || typeof state !== 'object')
+        return undefined;
+    return state[MEMBER_RUN_KEY];
+}
+/**
+ * What an inner mount of a member agent is handed of its run: the link, or —
+ * for a chart a caller built — the identity it was given. Nothing on the
+ * agent's own runs.
+ */
+export function memberRunArg(record) {
+    if (record === null || typeof record !== 'object')
+        return {};
+    const { link, identity } = record;
+    if (typeof link === 'string' && link !== '')
+        return { parentRun: link };
+    return identity !== undefined ? { memberIdentity: identity } : {};
+}
+/**
+ * The identity a member's stage runs for, read from the stage's own input:
+ * the run its link names, else the identity a caller-built chart handed it.
+ */
+export function memberIdentityIn(scope) {
+    const getArgs = scope.$getArgs;
+    const args = (typeof getArgs === 'function' ? getArgs.call(scope) : undefined);
+    if (args?.parentRun !== undefined) {
+        // A link decides alone: a dead one names nobody — never the input's own
+        // `identity`, which on a workflow or graph step can be an earlier step's data.
+        return runOfLink(args.parentRun)?.identity;
+    }
+    return args?.memberIdentity ?? args?.identity;
+}
+/** The memory namespace a member runs under: the named identity, else the run's own conversation. */
+export function memberIdentityOf(parentRun) {
+    return parentRun.identity ?? { conversationId: parentRun.runId };
+}
+function copyIdentity(identity) {
+    return {
+        ...(identity.conversationId !== undefined && { conversationId: identity.conversationId }),
+        ...(identity.tenant !== undefined && { tenant: identity.tenant }),
+        ...(identity.principal !== undefined && { principal: identity.principal }),
+    };
+}
+/**
+ * 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`
+ * arrived in its input. Refused rather than run under its instance's last run.
+ */
+export class MemberIdentityError extends Error {
+    code = 'ERR_MEMBER_NO_IDENTITY';
+    constructor() {
+        super('Agent: this agent is running inside another runner’s chart and no identity reached it ' +
+            '— no `parentRun` from a composition and no `identity` in its input. It is refused ' +
+            'rather than run under its instance’s last run, which may be another user’s, or under ' +
+            'a placeholder every run would share. Mount it through a composition (Sequence, ' +
+            'Parallel, Conditional, Loop, Workflow, Graph), which hands it the run it serves, or ' +
+            'return `identity` from your inputMapper.');
+        this.name = 'MemberIdentityError';
+    }
+}
+//# sourceMappingURL=memberRun.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * requestOfRun — the ONE reader of a runner's `options.request`.
+ *
+ * Every runner's `run()` / `resume()` reads the incoming request here, at its
+ * door and before anything moves: a value `requestContext()` did not build is
+ * refused by name. What it returns goes to exactly two places — the agent's
+ * own run (`Agent.runRequest`) or the run a composition opens for its members
+ * (`memberRun.ts · openParentRun`). It is never written to state, and the
+ * engine is handed the options without it (`RunnerBase · runSignalOf`).
+ *
+ * Pattern: guard + accessor. Role: core, run input.
+ */
+import { type RequestContext } from '../identity/requestContext.js';
+/**
+ * The sealed request a runner's options carry, or `undefined`.
+ *
+ * @throws TypeError (naming `door`) when `request` is not a sealed request.
+ */
+export declare function requestOf(options: {
+    readonly request?: unknown;
+} | undefined, door: string): RequestContext | undefined;

package/dist/esm/core/requestOfRun.js

@@ -0,0 +1,24 @@
+/**
+ * requestOfRun — the ONE reader of a runner's `options.request`.
+ *
+ * Every runner's `run()` / `resume()` reads the incoming request here, at its
+ * door and before anything moves: a value `requestContext()` did not build is
+ * refused by name. What it returns goes to exactly two places — the agent's
+ * own run (`Agent.runRequest`) or the run a composition opens for its members
+ * (`memberRun.ts · openParentRun`). It is never written to state, and the
+ * engine is handed the options without it (`RunnerBase · runSignalOf`).
+ *
+ * Pattern: guard + accessor. Role: core, run input.
+ */
+import { assertRequestContext } from '../identity/requestContext.js';
+/**
+ * The sealed request a runner's options carry, or `undefined`.
+ *
+ * @throws TypeError (naming `door`) when `request` is not a sealed request.
+ */
+export function requestOf(options, door) {
+    const request = options?.request;
+    assertRequestContext(request, door);
+    return request;
+}
+//# sourceMappingURL=requestOfRun.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"requestOfRun.js","sourceRoot":"","sources":["../../../src/core/requestOfRun.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAuB,MAAM,+BAA+B,CAAC;AAE1F;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,OAAmD,EACnD,IAAY;IAEZ,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IACjC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,OAAO,OAAqC,CAAC;AAC/C,CAAC"}