@namzu/sdk 43.0.0 → 44.1.0

package/dist/agents/AbstractAgent.js

@@ -1,9 +1,9 @@
 import { EMPTY_TOKEN_USAGE } from '../constants/limits.js';
 import { GENAI, NAMZU } from '../constants/telemetry/index.js';
-import { RunCancelled } from '../types/run/cancel-cause.js';
+import { TurnCancelled } from '../types/session/cancel-cause.js';
 import { ZERO_COST } from '../utils/cost.js';
 import { toErrorMessage } from '../utils/error.js';
-import { generateRunId } from '../utils/id.js';
+import { generateSessionId, generateTurnId } from '../utils/id.js';
 import { SCOPE_ATTRIBUTE } from '../utils/log/types.js';
 import { resolveLogger } from '../utils/logger.js';
 import { InvocationLock } from './lock.js';
@@ -11,11 +11,11 @@ export class AbstractAgent {
     metadata;
     log;
     /**
-     * The logger bound at construction, before any run id exists. `this.log`
-     * is rebound to a CHILD of this on every `bindRun` call — never the other
-     * way — so `forRun()` (which builds a fresh shell from `this.metadata`)
+     * The logger bound at construction, before any turn exists. `this.log`
+     * is rebound to a CHILD of this on every `bindTurn` call — never the other
+     * way — so `forTurn()` (which builds a fresh shell from `this.metadata`)
      * can hand the new instance the same base identity without also handing
-     * it a stale run id from whichever run happened to be live last.
+     * it a stale turn id from whichever turn happened to be live last.
      */
     baseLog;
     abortController;
@@ -26,12 +26,14 @@ export class AbstractAgent {
      * IN-FLIGHT ONLY, and deliberately: a settled entry kept around would
      * turn deduplication into caching, and caching an agent's answer is a
      * decision about staleness that only the host can make. A retry that
-     * arrives after the first finished runs again, which is the honest
+     * arrives after the first finished turns again, which is the honest
      * behaviour — the world may have moved.
      */
     inflightByKey = new Map();
     agentManager;
-    currentRunId;
+    /** The session this instance is running a turn of, once `bindTurn` recorded it. */
+    currentSessionId;
+    currentTurnId;
     constructor(metadata, log) {
         this.metadata = metadata;
         this.abortController = new AbortController();
@@ -44,31 +46,31 @@ export class AbstractAgent {
         this.log = this.baseLog;
     }
     /**
-     * A fresh shell of this agent, for a run that must not share one.
+     * A fresh shell of this agent, for a turn that must not share one.
      *
-     * See {@link Agent.forRun}. An agent is a shell around metadata — every
-     * per-run decision arrives in `config` and `input` — so a second instance
-     * costs one object and gives the run its own abort controller and run id,
+     * See {@link Agent.forTurn}. An agent is a shell around metadata — every
+     * per-turn decision arrives in `config` and `input` — so a second instance
+     * costs one object and gives the turn its own abort controller and turn id,
      * which is precisely what the invocation lock is protecting.
      *
      * Rebuilt from `this.constructor` and `this.metadata`, which covers every
      * agent in this package: they all take metadata and nothing else. A
      * subclass with a different constructor signature will throw here, and the
      * answer to that is `this` — the caller then shares the shell and gets the
-     * existing refusal on a concurrent run, which is the behaviour before this
+     * existing refusal on a concurrent turn, which is the behaviour before this
      * existed. Losing parallelism is a worse outcome than not having it; losing
-     * the run is not on the table.
+     * the turn is not on the table.
      *
      * A host whose agent needs real construction arguments supplies
      * `AgentDefinition.createAgent` instead, which wins over this.
      */
-    forRun() {
+    forTurn() {
         try {
             const Ctor = this.constructor;
             return new Ctor(this.metadata, this.baseLog);
         }
         catch (err) {
-            this.log.warn('Could not build a per-run shell; concurrent runs of this agent will still be refused', {
+            this.log.warn('Could not build a per-turn shell; concurrent turns of this agent will still be refused', {
                 [GENAI.AGENT_ID]: this.metadata.id,
                 'exception.message': err instanceof Error ? err.message : String(err),
             });
@@ -101,11 +103,11 @@ export class AbstractAgent {
      * invocations of one agent instance were not prevented at all, and the
      * error type that announces the refusal could never be thrown.
      *
-     * They genuinely are unsafe. `abortController` and `currentRunId` are
-     * INSTANCE state: two overlapping runs share one abort controller, so
-     * cancelling either kills both, and the second clobbers the first's run
-     * id, so `cancel()` afterwards cancels the wrong run. Neither failure
-     * announces itself — the first run simply stops, or the wrong one does.
+     * They genuinely are unsafe. `abortController` and `currentSessionId` are
+     * INSTANCE state: two overlapping turns share one abort controller, so
+     * cancelling either kills both, and the second clobbers the first's
+     * session, so `cancel()` afterwards cancels the wrong children. Neither failure
+     * announces itself — the first turn simply stops, or the wrong one does.
      *
      * A host that wants parallelism constructs a second instance, which is
      * cheap; sharing one was never the supported shape, it merely was not
@@ -126,7 +128,7 @@ export class AbstractAgent {
      *
      * The failure this exists for: a caller sends a request, the connection
      * drops, the caller retries. Without a key the retry is a second full
-     * run — a second set of model calls, and a second set of whatever the
+     * turn — a second set of model calls, and a second set of whatever the
      * tools did. The invocation lock alone does not help, because refusing
      * the retry with an error is not what the caller wanted either; they
      * wanted the answer.
@@ -157,7 +159,7 @@ export class AbstractAgent {
         }
         finally {
             // Cleared on settle, success or failure: keeping it would make the
-            // next retry a cache read rather than a fresh run.
+            // next retry a cache read rather than a fresh turn.
             this.inflightByKey.delete(key);
         }
     }
@@ -167,51 +169,63 @@ export class AbstractAgent {
      * operator's behalf is not — and a default would attribute every
      * unlabelled cancellation to a person who did not press anything.
      *
-     * Children get `'parent'` regardless of what stopped this run: from a
+     * Children get `'parent'` regardless of what stopped this turn: from a
      * child's side, the fact is that its parent went away.
      */
     async cancel(cause) {
-        this.abortController.abort(cause ? new RunCancelled(cause) : undefined);
-        if (this.agentManager && this.currentRunId) {
-            this.agentManager.cancelAll(this.currentRunId);
+        this.abortController.abort(cause ? new TurnCancelled(cause) : undefined);
+        if (this.agentManager && this.currentSessionId) {
+            this.agentManager.cancelAll(this.currentSessionId);
         }
     }
     getCapabilities() {
         return this.metadata.capabilities;
     }
-    createRunId() {
-        return generateRunId();
+    /** A fresh id for the turn this invocation runs. */
+    createTurnId() {
+        return generateTurnId();
     }
     /**
-     * Rebind this instance's logger to a specific run, so every record
-     * `this.log` writes for the DURATION of that run carries `namzu.run.id` —
-     * and every record after the NEXT call carries that run's id, not this
-     * one.
+     * The session this invocation's turn belongs to: the config's, or a new
+     * one when the host named none (a one-shot agent is a one-turn session).
+     */
+    resolveSessionId(configured) {
+        return configured ?? generateSessionId();
+    }
+    /**
+     * Rebind this instance's logger to a specific turn, so every record
+     * `this.log` writes for the DURATION of that turn carries `namzu.turn.id`
+     * and the session id — and every record after the NEXT call carries that
+     * turn's ids, not this one's.
      *
      * Constructor-time binding was the bug this exists to fix: an agent
-     * constructed once and invoked twice (`forRun` aside — a host is free to
-     * reuse one instance across sequential runs, and every concrete `run()`
+     * constructed once and invoked twice (`forTurn` aside — a host is free to
+     * reuse one instance across sequential turns, and every concrete `run()`
      * takes fresh `input`/`config` precisely to allow it) held ONE logger for
-     * its whole lifetime, so a warning from run two carried run one's id, or
+     * its whole lifetime, so a warning from turn two carried turn one's id, or
      * none. Every concrete `run()` implementation calls this before touching
-     * `this.log`, right after resolving the run's id — see `RouterAgent`,
+     * `this.log`, right after resolving the turn's id — see `RouterAgent`,
      * `PipelineAgent`, `SupervisorAgent` and `ReactiveAgent`.
      *
-     * `log` lets a per-run override (`BaseAgentConfig.logger`, a host setting
+     * `log` lets a per-turn override (`BaseAgentConfig.logger`, a host setting
      * on ONE call to `.run()`) win over the agent's construction-time base,
      * without reconstructing the agent to get it.
      *
-     * Also the one place `currentRunId` is actually assigned. It was declared
-     * and read by `cancel()` but never written — a run could never be
-     * cancelled by id because nothing ever recorded which run was current.
+     * Also the one place `currentSessionId` is assigned, which is what
+     * `cancel()` reads to cancel this session's delegated children.
      */
-    bindRun(runId, log) {
-        this.currentRunId = runId;
-        this.log = (log ?? this.baseLog).child({ [NAMZU.RUN_ID]: runId });
+    bindTurn(sessionId, turnId, log) {
+        this.currentSessionId = sessionId;
+        this.currentTurnId = turnId;
+        this.log = (log ?? this.baseLog).child({
+            [GENAI.CONVERSATION_ID]: sessionId,
+            [NAMZU.TURN_ID]: turnId,
+        });
     }
-    createEmptyResult(runId, startTime) {
+    createEmptyResult(sessionId, turnId, startTime) {
         return {
-            runId,
+            sessionId,
+            turnId,
             status: 'idle',
             usage: { ...EMPTY_TOKEN_USAGE },
             cost: { ...ZERO_COST },

package/dist/agents/AbstractAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractAgent.js","sourceRoot":"","sources":["../../src/agents/AbstractAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAA;AAY9D,OAAO,EAAoB,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAe,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE1C,MAAM,OAAgB,aAAa;IAMzB,QAAQ,CAAe;IACtB,GAAG,CAAQ;IACrB;;;;;;OAMG;IACc,OAAO,CAAQ;IACtB,eAAe,CAAiB;IACzB,cAAc,CAAgB;IAE/C;;;;;;;;OAQG;IACc,aAAa,GAAG,IAAI,GAAG,EAA4B,CAAA;IAE1D,YAAY,CAAuB;IAEnC,YAAY,CAAQ;IAE9B,YAAY,QAAuB,EAAE,GAAY;QAChD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;QAC5C,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,EAAE,CAAA;QAC1C,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YACvC,CAAC,eAAe,CAAC,EAAE,QAAQ;YAC3B,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,IAAI;YACjC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE;SAC7B,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAA;IACxB,CAAC;IAID;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM;QACL,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,IAAI,CAAC,WAGT,CAAA;YACT,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,IAAI,CACZ,sFAAsF,EACtF;gBACC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAClC,mBAAmB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACrE,CACD,CAAA;YACD,OAAO,IAAI,CAAA;QACZ,CAAC;IACF,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACO,qBAAqB;QAC9B,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACrD,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACO,KAAK,CAAC,mBAAmB,CAAI,IAAsB;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAA;QACzC,IAAI,CAAC;YACJ,OAAO,MAAM,IAAI,EAAE,CAAA;QACpB,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;QACvB,CAAC;IACF,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACO,KAAK,CAAC,mBAAmB,CAClC,GAAuB,EACvB,IAAsB;QAEtB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;YAAE,OAAO,IAAI,EAAE,CAAA;QAElD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sDAAsD,EAAE;gBACrE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAClC,8BAA8B,EAAE,GAAG;aACnC,CAAC,CAAA;YACF,OAAO,QAAsB,CAAA;QAC9B,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,EAAE,CAAA;QACtB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACpC,IAAI,CAAC;YACJ,OAAO,MAAM,OAAO,CAAA;QACrB,CAAC;gBAAS,CAAC;YACV,mEAAmE;YACnE,mDAAmD;YACnD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC/B,CAAC;IACF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,KAAmB;QAC/B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAEvE,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5C,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC/C,CAAC;IACF,CAAC;IAED,eAAe;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAA;IAClC,CAAC;IAES,WAAW;QACpB,OAAO,aAAa,EAAE,CAAA;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACO,OAAO,CAAC,KAAY,EAAE,GAAY;QAC3C,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QACzB,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAClE,CAAC;IAES,iBAAiB,CAAC,KAAY,EAAE,SAAiB;QAC1D,OAAO;YACN,KAAK;YACL,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,EAAE,GAAG,iBAAiB,EAAE;YAC/B,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;YACtB,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,QAAQ,EAAE,EAAE;SACZ,CAAA;IACF,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,KAAe,EAAE,QAA2B;QACrE,IAAI,CAAC,QAAQ;YAAE,OAAM;QACrB,IAAI,CAAC;YACJ,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,sBAAsB,EAAE;gBACtC,mBAAmB,EAAE,cAAc,CAAC,GAAG,CAAC;aACxC,CAAC,CAAA;QACH,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"AbstractAgent.js","sourceRoot":"","sources":["../../src/agents/AbstractAgent.ts"],"names":[],"mappings":"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"}

package/dist/agents/PipelineAgent.d.ts

@@ -26,22 +26,22 @@
  * That is the bar a reopen has to clear.
  */
 import type { AgentInput, AgentMetadata, PipelineAgentConfig, PipelineAgentResult } from '../types/agent/index.js';
-import type { RunEventListener } from '../types/run/index.js';
+import type { SessionEventListener } from '../types/session/events.js';
 import type { Logger } from '../utils/logger.js';
 import { AbstractAgent } from './AbstractAgent.js';
 export declare class PipelineAgent extends AbstractAgent<PipelineAgentConfig, PipelineAgentResult> {
     readonly type: "pipeline";
     constructor(metadata: Omit<AgentMetadata, 'type' | 'capabilities'>, log?: Logger);
     /**
-     * One run at a time per instance.
+     * One turn at a time per instance.
      *
-     * `abortController` and `currentRunId` are instance state, so two
-     * overlapping runs share one abort controller — cancelling either kills
-     * both — and the second clobbers the first's run id, so a later
-     * `cancel()` cancels the wrong run. Neither failure announces itself.
+     * `abortController` and `currentSessionId` are instance state, so two
+     * overlapping turns share one abort controller — cancelling either kills
+     * both — and the second clobbers the first's session, so a later
+     * `cancel()` cancels the wrong children. Neither failure announces itself.
      * A host that wants parallelism constructs a second instance.
      */
-    run(input: AgentInput, config: PipelineAgentConfig, listener?: RunEventListener): Promise<PipelineAgentResult>;
+    run(input: AgentInput, config: PipelineAgentConfig, listener?: SessionEventListener): Promise<PipelineAgentResult>;
     private runExclusive;
 }
 //# sourceMappingURL=PipelineAgent.d.ts.map

package/dist/agents/PipelineAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PipelineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/PipelineAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EAGnB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,qBAAa,aAAc,SAAQ,aAAa,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;gBAEvB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAgBhF;;;;;;;;OAQG;IACG,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,mBAAmB,CAAC;YAMjB,YAAY;CA2J1B"}
+{"version":3,"file":"PipelineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/PipelineAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EAGnB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAgB,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAKpF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,qBAAa,aAAc,SAAQ,aAAa,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;gBAEvB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAgBhF;;;;;;;;OAQG;IACG,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;YAMjB,YAAY;CA+L1B"}

package/dist/agents/PipelineAgent.js

@@ -28,6 +28,7 @@
 import { withTokenBudget } from '../provider/token-budget.js';
 import { ZERO_COST } from '../utils/cost.js';
 import { toErrorMessage } from '../utils/error.js';
+import { generateMessageId } from '../utils/id.js';
 import { AbstractAgent } from './AbstractAgent.js';
 import { resolveAgentBudget } from './budget.js';
 export class PipelineAgent extends AbstractAgent {
@@ -45,12 +46,12 @@ export class PipelineAgent extends AbstractAgent {
         }, log);
     }
     /**
-     * One run at a time per instance.
+     * One turn at a time per instance.
      *
-     * `abortController` and `currentRunId` are instance state, so two
-     * overlapping runs share one abort controller — cancelling either kills
-     * both — and the second clobbers the first's run id, so a later
-     * `cancel()` cancels the wrong run. Neither failure announces itself.
+     * `abortController` and `currentSessionId` are instance state, so two
+     * overlapping turns share one abort controller — cancelling either kills
+     * both — and the second clobbers the first's session, so a later
+     * `cancel()` cancels the wrong children. Neither failure announces itself.
      * A host that wants parallelism constructs a second instance.
      */
     async run(input, config, listener) {
@@ -58,18 +59,29 @@ export class PipelineAgent extends AbstractAgent {
     }
     async runExclusive(input, config, listener) {
         if (config.sandbox) {
-            throw new Error('PipelineAgent cannot enforce a run-level sandbox around developer-authored step callbacks. Configure confinement inside each step or use a tool-running agent.');
+            throw new Error('PipelineAgent cannot enforce a turn-level sandbox around developer-authored step callbacks. Configure confinement inside each step or use a tool-running agent.');
         }
         const startTime = Date.now();
-        const runId = this.createRunId();
-        this.bindRun(runId, config.logger);
-        const budget = await resolveAgentBudget(input, config, runId);
+        const sessionId = this.resolveSessionId(config.sessionId);
+        const turnId = this.createTurnId();
+        this.bindTurn(sessionId, turnId, config.logger);
+        const budget = await resolveAgentBudget(input, config, { sessionId, turnId });
+        const settlement = (status, iterations) => ({
+            status,
+            iterations,
+            usage: budget.ownUsage,
+            cost: { ...ZERO_COST, unpricedTokens: budget.ownTokens },
+            durationMs: Date.now() - startTime,
+            resultSource: 'model',
+            abandonedTaskIds: [],
+            abandonedJobIds: [],
+        });
         const provider = config.provider ? withTokenBudget(config.provider, budget) : undefined;
         try {
             const stepResults = [];
             const previousResults = new Map();
             let completedSteps = 0;
-            await this.emitEvent({ type: 'run_started', runId }, listener);
+            await this.emitEvent(turnStarted(sessionId, turnId, config, budget), listener);
             let currentInput = input.messages
                 .filter((m) => m.role === 'user')
                 .map((m) => m.content)
@@ -88,9 +100,10 @@ export class PipelineAgent extends AbstractAgent {
                     });
                     continue;
                 }
-                await this.emitEvent({ type: 'iteration_started', runId, iteration: i + 1 }, listener);
+                await this.emitEvent({ type: 'iteration_started', sessionId, turnId, iteration: i + 1 }, listener);
                 const context = {
-                    runId,
+                    sessionId,
+                    turnId,
                     stepIndex: i,
                     totalSteps: config.steps.length,
                     previousResults,
@@ -135,13 +148,16 @@ export class PipelineAgent extends AbstractAgent {
                     }
                     if (!config.continueOnError) {
                         await this.emitEvent({
-                            type: 'run_failed',
-                            runId,
+                            type: 'turn_failed',
+                            sessionId,
+                            turnId,
                             error: errorMsg,
                             budget: budget.summary(),
+                            settlement: settlement('failed', i + 1),
                         }, listener);
                         return {
-                            runId,
+                            sessionId,
+                            turnId,
                             status: 'failed',
                             stopReason: 'error',
                             usage: budget.ownUsage,
@@ -160,14 +176,31 @@ export class PipelineAgent extends AbstractAgent {
             }
             const finalStatus = completedSteps === config.steps.length ? 'completed' : 'failed';
             const lastOutput = stepResults[stepResults.length - 1]?.output;
-            await this.emitEvent({
-                type: 'run_completed',
-                budget: budget.summary(),
-                runId,
-                result: typeof lastOutput === 'string' ? lastOutput : JSON.stringify(lastOutput),
-            }, listener);
+            const result = typeof lastOutput === 'string' ? lastOutput : JSON.stringify(lastOutput);
+            // A pipeline that finished with failed steps (under `continueOnError`)
+            // did not complete its turn, so it settles as `turn_failed`: the
+            // terminal verdict is the event type (spec §2.10).
+            await this.emitEvent(finalStatus === 'completed'
+                ? {
+                    type: 'turn_completed',
+                    sessionId,
+                    turnId,
+                    budget: budget.summary(),
+                    result,
+                    stopReason: 'end_turn',
+                    settlement: settlement('completed', config.steps.length),
+                }
+                : {
+                    type: 'turn_failed',
+                    sessionId,
+                    turnId,
+                    budget: budget.summary(),
+                    error: `${config.steps.length - completedSteps} of ${config.steps.length} pipeline steps failed`,
+                    settlement: settlement('failed', config.steps.length),
+                }, listener);
             return {
-                runId,
+                sessionId,
+                turnId,
                 status: finalStatus,
                 stopReason: 'end_turn',
                 usage: budget.ownUsage,
@@ -176,7 +209,7 @@ export class PipelineAgent extends AbstractAgent {
                 iterations: config.steps.length,
                 durationMs: Date.now() - startTime,
                 messages: input.messages,
-                result: typeof lastOutput === 'string' ? lastOutput : JSON.stringify(lastOutput),
+                result,
                 stepResults,
                 completedSteps,
                 totalSteps: config.steps.length,
@@ -188,4 +221,23 @@ export class PipelineAgent extends AbstractAgent {
         }
     }
 }
+/**
+ * The turn a pipeline runs, announced the way `query()` announces one. The
+ * user message id names the input the steps were handed; nothing is written
+ * to a session log, because the steps are callbacks, not model calls.
+ */
+function turnStarted(sessionId, turnId, config, budget) {
+    return {
+        type: 'turn_started',
+        sessionId,
+        turnId,
+        userMessageId: generateMessageId(),
+        config: {
+            model: config.model,
+            tokenBudget: config.tokenBudget,
+            timeoutMs: config.timeoutMs,
+        },
+        ...(budget.binding ? { budget: budget.binding } : {}),
+    };
+}
 //# sourceMappingURL=PipelineAgent.js.map

package/dist/agents/PipelineAgent.js.map

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

package/dist/agents/ReactiveAgent.d.ts

@@ -1,20 +1,20 @@
 import type { AgentInput, AgentMetadata, ReactiveAgentConfig, ReactiveAgentResult } from '../types/agent/index.js';
-import type { RunEventListener } from '../types/run/index.js';
+import type { SessionEventListener } from '../types/session/events.js';
 import type { Logger } from '../utils/logger.js';
 import { AbstractAgent } from './AbstractAgent.js';
 export declare class ReactiveAgent extends AbstractAgent<ReactiveAgentConfig, ReactiveAgentResult> {
     readonly type: "reactive";
     constructor(metadata: Omit<AgentMetadata, 'type' | 'capabilities'>, log?: Logger);
     /**
-     * One run at a time per instance.
+     * One turn at a time per instance.
      *
-     * `abortController` and `currentRunId` are instance state, so two
-     * overlapping runs share one abort controller — cancelling either kills
-     * both — and the second clobbers the first's run id, so a later
-     * `cancel()` cancels the wrong run. Neither failure announces itself.
+     * `abortController` and `currentSessionId` are instance state, so two
+     * overlapping turns share one abort controller — cancelling either kills
+     * both — and the second clobbers the first's session, so a later
+     * `cancel()` cancels the wrong children. Neither failure announces itself.
      * A host that wants parallelism constructs a second instance.
      */
-    run(input: AgentInput, config: ReactiveAgentConfig, listener?: RunEventListener): Promise<ReactiveAgentResult>;
+    run(input: AgentInput, config: ReactiveAgentConfig, listener?: SessionEventListener): Promise<ReactiveAgentResult>;
     private runExclusive;
     cancel(): Promise<void>;
 }

package/dist/agents/ReactiveAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactiveAgent.d.ts","sourceRoot":"","sources":["../../src/agents/ReactiveAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,qBAAa,aAAc,SAAQ,aAAa,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;gBAEvB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAgBhF;;;;;;;;OAQG;IACG,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,mBAAmB,CAAC;YAMjB,YAAY;IA8JX,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}
+{"version":3,"file":"ReactiveAgent.d.ts","sourceRoot":"","sources":["../../src/agents/ReactiveAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,qBAAa,aAAc,SAAQ,aAAa,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;gBAEvB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAgBhF;;;;;;;;OAQG;IACG,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;YAMjB,YAAY;IAoKX,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}

package/dist/agents/ReactiveAgent.js

@@ -15,12 +15,12 @@ export class ReactiveAgent extends AbstractAgent {
         }, log);
     }
     /**
-     * One run at a time per instance.
+     * One turn at a time per instance.
      *
-     * `abortController` and `currentRunId` are instance state, so two
-     * overlapping runs share one abort controller — cancelling either kills
-     * both — and the second clobbers the first's run id, so a later
-     * `cancel()` cancels the wrong run. Neither failure announces itself.
+     * `abortController` and `currentSessionId` are instance state, so two
+     * overlapping turns share one abort controller — cancelling either kills
+     * both — and the second clobbers the first's session, so a later
+     * `cancel()` cancels the wrong children. Neither failure announces itself.
      * A host that wants parallelism constructs a second instance.
      */
     async run(input, config, listener) {
@@ -28,12 +28,12 @@ export class ReactiveAgent extends AbstractAgent {
     }
     async runExclusive(input, config, listener) {
         const startTime = Date.now();
-        const runId = this.createRunId();
-        this.bindRun(runId, config.logger);
         if (!config.sessionId || !config.topicId || !config.projectId || !config.tenantId) {
             throw new Error('ReactiveAgent requires sessionId, topicId, projectId, and tenantId in config (session-hierarchy.md §12.1).');
         }
-        const run = await drainQuery({
+        const turnId = this.createTurnId();
+        this.bindTurn(config.sessionId, turnId, config.logger);
+        const turn = await drainQuery({
             systemPrompt: config.systemPrompt,
             persona: config.persona,
             skills: config.skills,
@@ -50,6 +50,8 @@ export class ReactiveAgent extends AbstractAgent {
             ...(config.sandboxTeardownTimeoutMs !== undefined
                 ? { sandboxTeardownTimeoutMs: config.sandboxTeardownTimeoutMs }
                 : {}),
+            ...(config.outsideRootAccess ? { outsideRootAccess: config.outsideRootAccess } : {}),
+            ...(config.sandboxEscape ? { sandboxEscape: config.sandboxEscape } : {}),
             // Working-memory / compaction seam (optional; absent => unchanged run path).
             ...(config.compactionConfig ? { compactionConfig: config.compactionConfig } : {}),
             ...(config.workingMemoryProvider
@@ -63,7 +65,6 @@ export class ReactiveAgent extends AbstractAgent {
             // feature that does not exist for them.
             ...(config.resumeHandler ? { resumeHandler: config.resumeHandler } : {}),
             ...(config.retry !== undefined ? { retry: config.retry } : {}),
-            ...(config.emergencySave !== undefined ? { emergencySave: config.emergencySave } : {}),
             ...(config.toolTimeoutMs !== undefined ? { toolTimeoutMs: config.toolTimeoutMs } : {}),
             ...(config.toolRetryBackoff !== undefined
                 ? { toolRetryBackoff: config.toolRetryBackoff }
@@ -99,9 +100,12 @@ export class ReactiveAgent extends AbstractAgent {
             ...(config.inputGuardrails ? { inputGuardrails: config.inputGuardrails } : {}),
             ...(config.outputGuardrails ? { outputGuardrails: config.outputGuardrails } : {}),
             ...(config.checkpointStore ? { checkpointStore: config.checkpointStore } : {}),
-            ...(config.pathBuilder ? { pathBuilder: config.pathBuilder } : {}),
+            ...(config.paths ? { paths: config.paths } : {}),
+            // Forwarded so a session log in memory keeps the whole session
+            // there; dropped here, the turn would build a disk log instead.
+            ...(config.sessionLog ? { sessionLog: config.sessionLog } : {}),
             ...(config.parentSpan ? { parentSpan: config.parentSpan } : {}),
-            runConfig: {
+            turnConfig: {
                 model: config.model,
                 ...(config.webSearch ? { webSearch: config.webSearch } : {}),
                 tokenBudget: config.tokenBudget,
@@ -116,6 +120,7 @@ export class ReactiveAgent extends AbstractAgent {
                 maxIterations: config.maxIterations,
                 temperature: config.temperature,
                 maxResponseTokens: config.maxResponseTokens,
+                ...(config.pruneKeepLast !== undefined ? { pruneKeepLast: config.pruneKeepLast } : {}),
                 costLimitUsd: config.costLimitUsd,
                 permissionMode: config.permissionMode,
                 env: config.env,
@@ -133,8 +138,9 @@ export class ReactiveAgent extends AbstractAgent {
             topicId: config.topicId,
             projectId: config.projectId,
             tenantId: config.tenantId,
-            runId,
-            parentRunId: config.parentRunId,
+            turnId,
+            ...(config.parentSessionId ? { parentSessionId: config.parentSessionId } : {}),
+            ...(config.parentTurnId ? { parentTurnId: config.parentTurnId } : {}),
             depth: config.depth,
             contextLevel: config.contextLevel,
             messages: input.messages,
@@ -146,7 +152,7 @@ export class ReactiveAgent extends AbstractAgent {
             invocationState: config.invocationState,
         }, listener);
         let toolCallCount = 0;
-        for (const msg of run.messages) {
+        for (const msg of turn.messages) {
             if (msg.role === 'assistant') {
                 const assistantMsg = msg;
                 if (assistantMsg.toolCalls) {
@@ -155,18 +161,19 @@ export class ReactiveAgent extends AbstractAgent {
             }
         }
         return {
-            runId: run.id,
-            status: run.status,
-            stopReason: run.stopReason,
-            usage: run.tokenUsage,
-            ...(run.budget ? { budget: run.budget } : {}),
-            cost: run.costInfo,
-            iterations: run.currentIteration,
+            sessionId: turn.sessionId,
+            turnId: turn.id,
+            status: turn.status,
+            stopReason: turn.stopReason,
+            usage: turn.tokenUsage,
+            ...(turn.budget ? { budget: turn.budget } : {}),
+            cost: turn.costInfo,
+            iterations: turn.currentIteration,
             durationMs: Date.now() - startTime,
-            messages: run.messages,
-            result: run.result,
-            structuredOutput: run.structuredOutput,
-            lastError: run.lastError,
+            messages: turn.messages,
+            result: turn.result,
+            structuredOutput: turn.structuredOutput,
+            lastError: turn.lastError,
             toolCallCount,
         };
     }