@namzu/sdk 43.0.0 → 44.0.0

package/dist/agents/budget.d.ts

@@ -1,6 +1,19 @@
-import { TokenBudget } from '../run/token-budget.js';
+import { SessionTokenBudget } from '../store/budget/index.js';
 import type { AgentInput, BaseAgentConfig } from '../types/agent/base.js';
-import type { RunId } from '../types/ids/index.js';
-/** Resolve one authority before a composite agent constructs its scheduler. */
-export declare function resolveAgentBudget(input: AgentInput, config: BaseAgentConfig, runId: RunId): Promise<TokenBudget>;
+import type { SessionId, TurnId } from '../types/ids/index.js';
+/** The turn a composite agent is about to run, which its ledger is keyed by. */
+export interface AgentTurn {
+    readonly sessionId: SessionId;
+    readonly turnId: TurnId;
+}
+/**
+ * Resolve one authority before a composite agent constructs its scheduler.
+ *
+ * An inherited budget (a delegated child's reservation, or a host's) is bound
+ * to this turn with `bindTurn`, so its spend is attributed to the child
+ * session's turn while it stays keyed by the root turn that opened the
+ * ledger. A root turn opens a ledger of its own, keyed by
+ * `(sessionId, turnId)`: a new turn gets a new ledger and its own limit.
+ */
+export declare function resolveAgentBudget(input: AgentInput, config: BaseAgentConfig, turn: AgentTurn): Promise<SessionTokenBudget>;
 //# sourceMappingURL=budget.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/agents/budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAElD,+EAA+E;AAC/E,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,WAAW,CAAC,CA+BtB"}
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/agents/budget.ts"],"names":[],"mappings":"AAEA,OAAO,EAGN,kBAAkB,EAGlB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAE9D,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAsCD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,SAAS,GACb,OAAO,CAAC,kBAAkB,CAAC,CA8B7B"}

package/dist/agents/budget.js

@@ -1,12 +1,54 @@
-import { TokenBudget } from '../run/token-budget.js';
-import { openTokenBudget } from '../store/run/token-budget-disk.js';
-/** Resolve one authority before a composite agent constructs its scheduler. */
-export async function resolveAgentBudget(input, config, runId) {
+import { resolveNamzuHome } from '../session/home.js';
+import { SessionPaths, ensureProject } from '../session/paths.js';
+import { DiskSessionTokenBudgetStore, InMemorySessionTokenBudgetStore, SessionTokenBudget, openSessionTokenBudget, } from '../store/budget/index.js';
+import { InMemorySessionLog } from '../store/session-log/index.js';
+/**
+ * Held per in-memory session log, so every turn of one in-memory session
+ * finds its ledgers in the same place and nothing reaches the disk.
+ */
+const inMemoryLedgers = new WeakMap();
+/**
+ * Where a root turn's ledger lives when the agent was handed none:
+ *
+ * - beside an in-memory session log with no `paths`: in memory, held for
+ *   that log;
+ * - otherwise on disk, at `<session-id>/budgets/<turn-id>.json` in the
+ *   project the config's `paths` (or the working directory under
+ *   `NAMZU_HOME`) names.
+ */
+async function ledgerStore(input, config) {
+    const log = config.sessionLog;
+    if (log instanceof InMemorySessionLog && config.paths === undefined) {
+        let store = inMemoryLedgers.get(log);
+        if (!store) {
+            store = new InMemorySessionTokenBudgetStore();
+            inMemoryLedgers.set(log, store);
+        }
+        return store;
+    }
+    if (config.paths)
+        return new DiskSessionTokenBudgetStore({ paths: config.paths });
+    const home = resolveNamzuHome();
+    const project = await ensureProject({ home, cwd: input.workingDirectory });
+    return new DiskSessionTokenBudgetStore({
+        paths: new SessionPaths({ home, slug: project.slug }),
+    });
+}
+/**
+ * Resolve one authority before a composite agent constructs its scheduler.
+ *
+ * An inherited budget (a delegated child's reservation, or a host's) is bound
+ * to this turn with `bindTurn`, so its spend is attributed to the child
+ * session's turn while it stays keyed by the root turn that opened the
+ * ledger. A root turn opens a ledger of its own, keyed by
+ * `(sessionId, turnId)`: a new turn gets a new ledger and its own limit.
+ */
+export async function resolveAgentBudget(input, config, turn) {
     if (!Number.isSafeInteger(config.tokenBudget) || config.tokenBudget < 0) {
         throw new Error('Agent token budget must be a nonnegative safe integer');
     }
     if (config.budget) {
-        config.budget.bindRun(runId);
+        config.budget.bindTurn(turn.sessionId, turn.turnId);
         if (config.tokenBudget > 0 &&
             (config.budget.limit === 0 || config.tokenBudget < config.budget.limit)) {
             config.budget.narrow(config.tokenBudget);
@@ -14,19 +56,18 @@ export async function resolveAgentBudget(input, config, runId) {
         await config.budget.flush();
         return config.budget;
     }
-    if (config.parentRunId) {
+    if (config.parentSessionId) {
         throw new Error('A delegated agent requires its inherited token budget authority');
     }
-    const { tenantId, projectId, sessionId } = config;
-    const budget = tenantId && projectId && sessionId
-        ? await openTokenBudget({
-            scope: { tenantId, projectId, sessionId, runId },
+    const scope = { rootSessionId: turn.sessionId, rootTurnId: turn.turnId };
+    const budget = config.tenantId && config.projectId && config.sessionId
+        ? await openSessionTokenBudget({
+            scope,
             limit: config.tokenBudget,
-            pathBuilder: config.pathBuilder,
-            workingDirectory: input.workingDirectory,
+            store: await ledgerStore(input, config),
         })
-        : TokenBudget.create(config.tokenBudget, runId);
-    budget.bindRun(runId);
+        : SessionTokenBudget.create(config.tokenBudget, scope);
+    budget.bindTurn(turn.sessionId, turn.turnId);
     await budget.flush();
     return budget;
 }

package/dist/agents/budget.js.map

@@ -1 +1 @@
-{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/agents/budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AAInE,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,KAAiB,EACjB,MAAuB,EACvB,KAAY;IAEZ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IACzE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC5B,IACC,MAAM,CAAC,WAAW,GAAG,CAAC;YACtB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EACtE,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QACzC,CAAC;QACD,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QAC3B,OAAO,MAAM,CAAC,MAAM,CAAA;IACrB,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;IACnF,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAA;IACjD,MAAM,MAAM,GACX,QAAQ,IAAI,SAAS,IAAI,SAAS;QACjC,CAAC,CAAC,MAAM,eAAe,CAAC;YACtB,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE;YAChD,KAAK,EAAE,MAAM,CAAC,WAAW;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;SACxC,CAAC;QACH,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;IACjD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACrB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACpB,OAAO,MAAM,CAAA;AACd,CAAC"}
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/agents/budget.ts"],"names":[],"mappings":"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"}

package/dist/agents/defineAgent.d.ts

@@ -1,5 +1,5 @@
 import type { Agent, AgentCapabilities, AgentInput, AgentType, BaseAgentConfig, BaseAgentResult } from '../types/agent/index.js';
-import type { RunEventListener } from '../types/run/index.js';
+import type { SessionEventListener } from '../types/session/events.js';
 export interface DefineAgentOptions<TConfig extends BaseAgentConfig = BaseAgentConfig, TResult extends BaseAgentResult = BaseAgentResult> {
     type: AgentType;
     id: string;
@@ -8,7 +8,7 @@ export interface DefineAgentOptions<TConfig extends BaseAgentConfig = BaseAgentC
     category: string;
     description: string;
     capabilities?: Partial<AgentCapabilities>;
-    run(input: AgentInput, config: TConfig, listener?: RunEventListener): Promise<TResult>;
+    run(input: AgentInput, config: TConfig, listener?: SessionEventListener): Promise<TResult>;
     cancel?(): Promise<void>;
 }
 export declare function defineAgent<TConfig extends BaseAgentConfig = BaseAgentConfig, TResult extends BaseAgentResult = BaseAgentResult>(options: DefineAgentOptions<TConfig, TResult>): Agent<TConfig, TResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"defineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/defineAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,KAAK,EACL,iBAAiB,EACjB,UAAU,EAEV,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,MAAM,WAAW,kBAAkB,CAClC,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe;IAEjD,IAAI,EAAE,SAAS,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACzC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtF,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,wBAAgB,WAAW,CAC1B,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe,EAChD,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAgCxE"}
+{"version":3,"file":"defineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/defineAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,KAAK,EACL,iBAAiB,EACjB,UAAU,EAEV,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,MAAM,WAAW,kBAAkB,CAClC,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe;IAEjD,IAAI,EAAE,SAAS,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACzC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1F,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,wBAAgB,WAAW,CAC1B,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe,EAChD,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAoCxE"}

package/dist/agents/defineAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineAgent.js","sourceRoot":"","sources":["../../src/agents/defineAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AA2BlE,MAAM,UAAU,WAAW,CAGzB,OAA6C;IAC9C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;IAE7C,MAAM,QAAQ,GAAkB;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,EAAE,GAAG,oBAAoB,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE;KAClE,CAAA;IAED,OAAO;QACN,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ;QAER,KAAK,CAAC,GAAG,CAAC,KAAiB,EAAE,MAAe,EAAE,QAA2B;YACxE,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC5C,CAAC;QAED,KAAK,CAAC,MAAM;YACX,eAAe,CAAC,KAAK,EAAE,CAAA;YACvB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,OAAO,CAAC,MAAM,EAAE,CAAA;YACvB,CAAC;QACF,CAAC;QAED,eAAe;YACd,OAAO,QAAQ,CAAC,YAAY,CAAA;QAC7B,CAAC;KACD,CAAA;AACF,CAAC"}
+{"version":3,"file":"defineAgent.js","sourceRoot":"","sources":["../../src/agents/defineAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AA2BlE,MAAM,UAAU,WAAW,CAGzB,OAA6C;IAC9C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;IAE7C,MAAM,QAAQ,GAAkB;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,EAAE,GAAG,oBAAoB,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE;KAClE,CAAA;IAED,OAAO;QACN,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ;QAER,KAAK,CAAC,GAAG,CACR,KAAiB,EACjB,MAAe,EACf,QAA+B;YAE/B,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC5C,CAAC;QAED,KAAK,CAAC,MAAM;YACX,eAAe,CAAC,KAAK,EAAE,CAAA;YACvB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,OAAO,CAAC,MAAM,EAAE,CAAA;YACvB,CAAC;QACF,CAAC;QAED,eAAe;YACd,OAAO,QAAQ,CAAC,YAAY,CAAA;QAC7B,CAAC;KACD,CAAA;AACF,CAAC"}

package/dist/agents/handle.d.ts

@@ -4,29 +4,27 @@ import { NamzuError } from '../types/errors/index.js';
 import type { TenantId, TopicId } from '../types/ids/index.js';
 import type { Message } from '../types/message/index.js';
 /**
- * The object a host holds between runs.
+ * The object a host holds between turns.
  *
  * There was none. A host could not ask whether the agent was running, and
  * had nowhere to put "when you next run, start with this" — so it either
- * held a steer until it observed a run starting, or carried the text itself
+ * held a steer until it observed a turn starting, or carried the text itself
  * and passed it manually on the next `run()` call.
  *
  * Two delivery targets, each with a stated lifetime, and no silent third
- * state. `steer` reaches the run that is happening; `queueForNextRun`
+ * state. `steer` reaches the turn that is happening; `queueForNextTurn`
  * reaches the one that has not started. `steer` on an idle handle THROWS
  * rather than accepting into a queue nothing will read — that refusal is
  * the design, because the alternative is a host believing it redirected an
  * agent that was not listening.
  */
 /**
- * Whether a run is in flight, as this handle sees it.
+ * Whether a turn is in flight, as this handle sees it.
  *
- * NOT `AgentStatus` — that name is taken by a deprecated alias of
- * `RunExecutionStatus` whose own test records that it never typed an agent
- * and is being removed in the next major. Reusing it here would silently
- * change what a consumer's `AgentStatus` MEANS rather than failing their
- * build, which is the worse of the two outcomes and the one a deprecation
- * window exists to avoid.
+ * NOT `AgentStatus` — that name was a deprecated alias of the execution
+ * status which never typed an agent. Reusing it here would silently change
+ * what a consumer's `AgentStatus` MEANS rather than failing their build,
+ * which is the worse of the two outcomes.
  */
 export type AgentHandleStatus = 'idle' | 'running';
 /** A steer aimed at an agent that is not running. */
@@ -36,15 +34,15 @@ export declare class AgentNotRunningError extends NamzuError {
 export interface AgentHandle {
     readonly status: AgentHandleStatus;
     /**
-     * Hand guidance to the run happening now.
+     * Hand guidance to the turn happening now.
      *
      * Reaches the model at the next turn boundary whether or not a tool is
      * in flight — the channel rides a settled tool result when there is one,
      * and the loop delivers the remainder otherwise.
      */
     steer(text: string): void;
-    /** Leave a message for the run that has not started yet. */
-    queueForNextRun(message: Message): Promise<void>;
+    /** Leave a message for the turn that has not started yet. */
+    queueForNextTurn(message: Message): Promise<void>;
 }
 export interface AgentHandleOptions {
     readonly steering: SteeringChannel;
@@ -65,7 +63,7 @@ export interface AgentHandleOptions {
  */
 export declare function createAgentHandle(options: AgentHandleOptions): AgentHandle;
 /**
- * Add a message to the topic's next-run queue, under compare-and-set.
+ * Add a message to the topic's next-turn queue, under compare-and-set.
  *
  * Read-modify-write against the record's revision, so two hosts queueing
  * for one conversation cannot silently drop each other's message — the

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

@@ -1 +1 @@
-{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../src/agents/handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAExD;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAA;AAElD,qDAAqD;AACrD,qBAAa,oBAAqB,SAAQ,UAAU;;CAWnD;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,4DAA4D;IAC5D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,sEAAsE;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAA;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAA;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CA4B1E;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAM7B"}
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../src/agents/handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAExD;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAA;AAElD,qDAAqD;AACrD,qBAAa,oBAAqB,SAAQ,UAAU;;CAWnD;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,6DAA6D;IAC7D,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,sEAAsE;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAA;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAA;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CA4B1E;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAM7B"}

package/dist/agents/handle.js

@@ -4,7 +4,7 @@ export class AgentNotRunningError extends NamzuError {
     constructor() {
         super({
             code: 'invalid_config',
-            message: 'steer() needs a run in flight — this agent is idle. Use queueForNextRun() to leave a message for the next one.',
+            message: 'steer() needs a turn in flight — this agent is idle. Use queueForNextTurn() to leave a message for the next one.',
             details: {},
             retryable: false,
         });
@@ -25,19 +25,19 @@ export function createAgentHandle(options) {
             return options.isRunning() ? 'running' : 'idle';
         },
         steer(text) {
-            // Refused, not rerouted. Quietly forwarding to `queueForNextRun`
+            // Refused, not rerouted. Quietly forwarding to `queueForNextTurn`
             // would be a host asking to redirect what is happening now and
-            // getting a message delivered minutes later to a different run —
+            // getting a message delivered minutes later to a different turn —
             // which is worse than an error, because nothing says it happened.
             if (!options.isRunning())
                 throw new AgentNotRunningError();
             options.steering.steer(text);
         },
-        async queueForNextRun(message) {
+        async queueForNextTurn(message) {
             if (!options.topicStateStore) {
                 throw new NamzuError({
                     code: 'invalid_config',
-                    message: 'queueForNextRun() needs a topic state store; this handle was built without one, so there is nowhere to leave the message.',
+                    message: 'queueForNextTurn() needs a topic state store; this handle was built without one, so there is nowhere to leave the message.',
                     details: { topicId: options.topicId },
                     retryable: false,
                 });
@@ -47,7 +47,7 @@ export function createAgentHandle(options) {
     };
 }
 /**
- * Add a message to the topic's next-run queue, under compare-and-set.
+ * Add a message to the topic's next-turn queue, under compare-and-set.
  *
  * Read-modify-write against the record's revision, so two hosts queueing
  * for one conversation cannot silently drop each other's message — the

package/dist/agents/handle.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../src/agents/handle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAgCrD,qDAAqD;AACrD,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IACnD;QACC,KAAK,CAAC;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EACN,gHAAgH;YACjH,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,KAAK;SAChB,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACnC,CAAC;CACD;AA0BD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC5D,OAAO;QACN,IAAI,MAAM;YACT,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAA;QAChD,CAAC;QAED,KAAK,CAAC,IAAY;YACjB,iEAAiE;YACjE,+DAA+D;YAC/D,iEAAiE;YACjE,kEAAkE;YAClE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;gBAAE,MAAM,IAAI,oBAAoB,EAAE,CAAA;YAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,OAAgB;YACrC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC9B,MAAM,IAAI,UAAU,CAAC;oBACpB,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EACN,2HAA2H;oBAC5H,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;oBACrC,SAAS,EAAE,KAAK;iBAChB,CAAC,CAAA;YACH,CAAC;YACD,MAAM,mBAAmB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC/F,CAAC;KACD,CAAA;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,KAAsB,EACtB,OAAgB,EAChB,QAAkB,EAClB,OAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IACrD,MAAM,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAC7F,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,CAAC;KAC9B,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,KAAsB,EACtB,OAAgB,EAChB,QAAkB;IAElB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IACrD,MAAM,MAAM,GAAG,KAAK,EAAE,cAAc,IAAI,EAAE,CAAA;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,CAAC,EAAE,CAAC,CAAA;IACxF,OAAO,MAAM,CAAA;AACd,CAAC"}
+{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../src/agents/handle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AA8BrD,qDAAqD;AACrD,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IACnD;QACC,KAAK,CAAC;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EACN,kHAAkH;YACnH,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,KAAK;SAChB,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACnC,CAAC;CACD;AA0BD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC5D,OAAO;QACN,IAAI,MAAM;YACT,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAA;QAChD,CAAC;QAED,KAAK,CAAC,IAAY;YACjB,kEAAkE;YAClE,+DAA+D;YAC/D,kEAAkE;YAClE,kEAAkE;YAClE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;gBAAE,MAAM,IAAI,oBAAoB,EAAE,CAAA;YAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,OAAgB;YACtC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC9B,MAAM,IAAI,UAAU,CAAC;oBACpB,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EACN,4HAA4H;oBAC7H,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;oBACrC,SAAS,EAAE,KAAK;iBAChB,CAAC,CAAA;YACH,CAAC;YACD,MAAM,mBAAmB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC/F,CAAC;KACD,CAAA;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,KAAsB,EACtB,OAAgB,EAChB,QAAkB,EAClB,OAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IACrD,MAAM,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAC7F,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,CAAC;KAC9B,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,KAAsB,EACtB,OAAgB,EAChB,QAAkB;IAElB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IACrD,MAAM,MAAM,GAAG,KAAK,EAAE,cAAc,IAAI,EAAE,CAAA;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,CAAC,EAAE,CAAC,CAAA;IACxF,OAAO,MAAM,CAAA;AACd,CAAC"}

package/dist/agents/lock.js

@@ -6,13 +6,13 @@ export class ConcurrentInvocationError extends Error {
     agentId;
     constructor(agentId) {
         // Names the remedy, because the refusal alone sent readers looking for a
-        // concurrency bug in their own code. An agent instance holds per-run
-        // state — an abort controller and the run id — so two overlapping runs
+        // concurrency bug in their own code. An agent instance holds per-turn
+        // state — an abort controller and the turn id — so two overlapping turns
         // on one shell would cancel each other; the answer is a second shell,
         // not a second attempt. Delegated spawns get one automatically via
-        // `Agent.forRun`, so reaching this from a fan-out means the agent
+        // `Agent.forTurn`, so reaching this from a fan-out means the agent
         // could not be rebuilt and wants `AgentDefinition.createAgent`.
-        super(`Agent ${agentId} is already processing. Concurrent invocations of one instance are not allowed, because its abort controller and run id are instance state and two runs would cancel each other. Run a second instance instead — or, for a delegated spawn, give its AgentDefinition a \`createAgent\` factory so each child gets its own.`);
+        super(`Agent ${agentId} is already processing. Concurrent invocations of one instance are not allowed, because its abort controller and turn id are instance state and two turns would cancel each other. Run a second instance instead — or, for a delegated spawn, give its AgentDefinition a \`createAgent\` factory so each child gets its own.`);
         this.name = 'ConcurrentInvocationError';
         this.agentId = agentId;
     }

package/dist/agents/lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/agents/lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAC1C,OAAO,CAAQ;IAExB,YAAY,OAAe;QAC1B,yEAAyE;QACzE,qEAAqE;QACrE,uEAAuE;QACvE,sEAAsE;QACtE,mEAAmE;QACnE,kEAAkE;QAClE,gEAAgE;QAChE,KAAK,CACJ,SAAS,OAAO,4TAA4T,CAC5U,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IAClB,QAAQ,GAAG,KAAK,CAAA;IAExB;;;OAGG;IACH,OAAO,CAAC,OAAe;QACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAA;QAC7C,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QAEpB,OAAO;YACN,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE;gBACtB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;YACtB,CAAC;SACD,CAAA;IACF,CAAC;IAED;;OAEG;IACH,QAAQ;QACP,OAAO,IAAI,CAAC,QAAQ,CAAA;IACrB,CAAC;CACD"}
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/agents/lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAC1C,OAAO,CAAQ;IAExB,YAAY,OAAe;QAC1B,yEAAyE;QACzE,sEAAsE;QACtE,yEAAyE;QACzE,sEAAsE;QACtE,mEAAmE;QACnE,mEAAmE;QACnE,gEAAgE;QAChE,KAAK,CACJ,SAAS,OAAO,8TAA8T,CAC9U,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IAClB,QAAQ,GAAG,KAAK,CAAA;IAExB;;;OAGG;IACH,OAAO,CAAC,OAAe;QACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAA;QAC7C,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QAEpB,OAAO;YACN,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE;gBACtB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;YACtB,CAAC;SACD,CAAA;IACF,CAAC;IAED;;OAEG;IACH,QAAQ;QACP,OAAO,IAAI,CAAC,QAAQ,CAAA;IACrB,CAAC;CACD"}

package/dist/agents/runAgent.d.ts

@@ -4,13 +4,14 @@ import type { AuthorizationGateConfig } from '../types/authorization/index.js';
 import type { ProjectId, SessionId, TenantId, TopicId } from '../types/ids/index.js';
 import type { Message } from '../types/message/index.js';
 import type { LLMProvider, ReasoningEffort, ThinkingConfig } from '../types/provider/index.js';
-import type { Run, RunEventListener } from '../types/run/index.js';
 import type { SandboxProvider } from '../types/sandbox/index.js';
+import type { SessionEventListener } from '../types/session/events.js';
+import type { Turn } from '../types/session/turn.js';
 import type { Skill } from '../types/skills/index.js';
 import type { StructuredOutputConfig } from '../types/structured-output/index.js';
 import type { ToolRegistryContract } from '../types/tool/index.js';
 /**
- * The session a run belongs to.
+ * The session a turn belongs to.
  *
  * Every field is generated when absent, and the generated values come back on
  * the result so a second turn can be handed the same ones. That pairing is the
@@ -24,12 +25,20 @@ import type { ToolRegistryContract } from '../types/tool/index.js';
  * refused at the first delegation with `Project <id> not found for tenant
  * <id> — spawn rejected`, which is the enforcement site behaving correctly:
  * delegation limits live on the project, and a missing project has no limits
- * to read. A run that has to delegate should be given the id returned by
+ * to read. A turn that has to delegate should be given the id returned by
  * `store.createProject()`.
  */
 export interface AgentIdentity {
     sessionId?: SessionId;
     topicId?: TopicId;
+    /**
+     * Omitted: the project the working directory stands for, read from (or
+     * minted once into) `~/.namzu/projects/<slug>/project.json` by
+     * `ensureProject`, so every turn in one directory shares a Project. A
+     * session held in memory with no `paths` gets a fresh id and writes
+     * nothing. A host whose `paths` name a slug of its own passes the id. The
+     * other three are minted per call when omitted.
+     */
     projectId?: ProjectId;
     tenantId?: TenantId;
 }
@@ -57,7 +66,7 @@ export interface RunAgentOptions extends AgentIdentity {
      *
      * The front door needs its own way to say this, because the registry it
      * was handed — usually the host's, assembled before this call — is not a
-     * place a run can reach. Absent installs the shipped default
+     * place a turn can reach. Absent installs the shipped default
      * ({@link DEFAULT_TOOL_RESULT_GUARDRAILS}: a connected server's result
      * that restates the request is refused). **An empty array is how a caller
      * turns that off**, and it is the reason this option is here at all: a
@@ -67,8 +76,8 @@ export interface RunAgentOptions extends AgentIdentity {
     toolResultGuardrails?: readonly import('../types/guardrail/index.js').ToolResultGuardrailSpec[];
     /** Execute sandbox-aware tools inside this provider's boundary. */
     sandboxProvider?: SandboxProvider;
-    /** What a supplied sandbox is rooted at and its per-run limits. */
-    sandbox?: import('../types/run/config.js').AgentRunConfig['sandbox'];
+    /** What a supplied sandbox is rooted at and its per-turn limits. */
+    sandbox?: import('../types/session/config.js').TurnConfig['sandbox'];
     /** Sandbox teardown wait; defaults to 30 seconds and `0` is unbounded. */
     sandboxTeardownTimeoutMs?: number;
     /**
@@ -76,7 +85,7 @@ export interface RunAgentOptions extends AgentIdentity {
      *
      * The kernel has taken these since it had a prompt builder; this door did
      * not forward them, so a caller who assembled skills — `@namzu/project`
-     * reads a whole `skills/` directory — handed them over and got a run that
+     * reads a whole `skills/` directory — handed them over and got a turn that
      * had never heard of them. Silent, because the `drainQuery` call below was
      * cast, and a cast seam reports nothing when a field goes missing.
      */
@@ -88,7 +97,7 @@ export interface RunAgentOptions extends AgentIdentity {
      * library front door and the wrong one for a host that hands this an agent
      * directory it did not write. The kernel builds a `AuthorizationGate` from
      * this and consults it on every call; without it there is nothing to
-     * consult, so a front-door run is strictly less mediated than a kernel one.
+     * consult, so a front-door turn is strictly less mediated than a kernel one.
      */
     /**
      * @deprecated Renamed to `authorizationGate`. Removed in the next major.
@@ -98,17 +107,21 @@ export interface RunAgentOptions extends AgentIdentity {
     authorizationGate?: AuthorizationGateConfig;
     /** Defaults to the current working directory. */
     workingDirectory?: string;
-    /** Host-owned state layout, independent of the tool working directory. */
-    pathBuilder?: QueryParams['pathBuilder'];
-    /** Optional evidence store; omitted uses the resolved disk layout. */
-    runStore?: QueryParams['runStore'];
+    /** Host-owned state layout (`NAMZU_HOME` and the project slug), independent of the tool working directory. */
+    paths?: QueryParams['paths'];
+    /**
+     * The session log this turn appends to; omitted uses the log in the
+     * resolved layout. An `InMemorySessionLog` keeps the whole session in
+     * memory.
+     */
+    sessionLog?: QueryParams['sessionLog'];
     /** Optional checkpoint store; omitted uses the resolved disk layout. */
     checkpointStore?: QueryParams['checkpointStore'];
     /** Default 16 main-loop iterations; 0 disables the iteration guard. */
     maxIterations?: number;
     /** Default 200,000 cumulative tokens; 0 is unlimited and still metered. */
     tokenBudget?: number;
-    /** Default five minutes; 0 disables the run deadline. */
+    /** Default five minutes; 0 disables the turn deadline. */
     timeoutMs?: number;
     /** Maximum provider-stream silence; defaults to five minutes. `0` disables. */
     streamIdleTimeoutMs?: number;
@@ -126,22 +139,22 @@ export interface RunAgentOptions extends AgentIdentity {
      * structured output throughout and this function never forwarded the
      * config, so the single most convenient way into the kernel was the one way
      * that could not produce a typed answer. Present, the validated value comes
-     * back on {@link RunAgentResult.structuredOutput} and on `run`.
+     * back on {@link RunAgentResult.structuredOutput} and on `turn`.
      */
     structuredOutput?: StructuredOutputConfig;
     /**
      * Extended-thinking request and response-effort level, forwarded on every
      * model call.
      *
-     * These are here because the run config below is assembled by HAND, and a
+     * These are here because the turn config below is assembled by HAND, and a
      * hand-listed literal silently drops whatever nobody remembered to add —
-     * which is precisely what happened. `thinking` shipped on `AgentRunConfig`
+     * which is precisely what happened. `thinking` shipped on the turn config
      * and was reachable only from the raw kernel entry point, because this
      * function, `ReactiveAgent` and `SupervisorAgent` each rebuilt the object
      * from a fixed list. So the capability existed and the front door could not
      * open it.
      *
-     * A live run is what found it: the unit tests passed because they drove the
+     * A live turn is what found it: the unit tests passed because they drove the
      * kernel directly, and a real agent run through this function put no effort
      * on the wire at all.
      */
@@ -150,7 +163,7 @@ export interface RunAgentOptions extends AgentIdentity {
     /** Names the agent in traces and events. Defaults to `Agent`. */
     name?: string;
     signal?: AbortSignal;
-    listener?: RunEventListener;
+    listener?: SessionEventListener;
     /** Live project policy for hosts that discover nested instruction scopes. */
     projectInstructionContext?: ProjectInstructionContext;
 }
@@ -161,15 +174,15 @@ export interface RunAgentResult {
      * The schema-validated answer, when {@link RunAgentOptions.structuredOutput}
      * asked for one and the model produced it.
      *
-     * Mirrors `run.structuredOutput` the way {@link output} mirrors
-     * `run.result` — the whole point of this shape is that the two answers a
-     * run can give are reachable without unpacking the run.
+     * Mirrors `turn.structuredOutput` the way {@link output} mirrors
+     * `turn.result` — the whole point of this shape is that the two answers a
+     * turn can give are reachable without unpacking the turn.
      */
     readonly structuredOutput?: unknown;
-    /** The full run — usage, cost, steps, stop reason, every message. */
-    readonly run: Run;
+    /** The full turn — usage, cost, steps, stop reason, every message. */
+    readonly turn: Turn;
     /**
-     * The identity this run used, with anything generated filled in.
+     * The identity this turn used, with anything generated filled in.
      *
      * Pass it straight back into the next call to continue the same session.
      */
@@ -178,9 +191,9 @@ export interface RunAgentResult {
 /**
  * Defaults chosen to be safe rather than generous.
  *
- * A front door exists so a first run works without a decision, and the cost of
+ * A front door exists so a first turn works without a decision, and the cost of
  * that convenience is that nobody reads these numbers before their first
- * runaway loop. So: a budget that ends a stuck run in seconds rather than
+ * runaway loop. So: a budget that ends a stuck turn in seconds rather than
  * dollars, and an iteration cap that stops a tool-calling loop well before a
  * context window does. Every one is overridable and named on the option.
  */
@@ -192,14 +205,14 @@ export declare const DEFAULT_TIMEOUT_MS = 300000;
  *
  * `drainQuery` is the kernel's real entry point and takes eleven required
  * parameters, four of which are identity fields that throw when missing. That
- * is the correct shape for a kernel — a run with no tenant is a run no auditor
+ * is the correct shape for a kernel — a turn with no tenant is a turn no auditor
  * can attribute — and it is the wrong shape for the first thing anybody
  * writes. The proof was in this repo: the eval suites, the test files and the
  * CLI each hand-assemble the same block, which is what a missing front door
  * looks like from the inside.
  *
  * So this supplies an environment rather than a new engine. It generates the
- * identity a single-tenant local run has no opinion about, defaults the
+ * identity a single-tenant local turn has no opinion about, defaults the
  * budgets, points the working directory at the process's own, and hands back
  * both the answer and the identity it used. Everything it fills in is a normal
  * `drainQuery` parameter; there is no second code path, and a caller who
@@ -224,7 +237,7 @@ export declare const DEFAULT_TIMEOUT_MS = 300000;
  *   provider,
  *   model,
  *   ...first.identity,
- *   prompt: [...first.run.messages, createUserMessage('What is my name?')],
+ *   prompt: [...first.turn.messages, createUserMessage('What is my name?')],
  * })
  * ```
  */

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

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