@namzu/sdk 42.0.2 → 44.0.0

package/dist/runtime/query/tool-output-budget.js

@@ -12,7 +12,7 @@ import { digest, spillManifest } from '../../store/evidence/format.js';
  * Nothing capped tool output before this. `read` returned a whole file when
  * `limit` was omitted, `bash` allowed a 100 MB buffer, and the MCP adapter
  * joined every text block uncapped — so a 2 MB lockfile became ~500k tokens
- * in a single `tool_result` and the run died on a provider error with
+ * in a single `tool_result` and the turn died on a provider error with
  * everything lost.
  */
 export const DEFAULT_MAX_TOOL_OUTPUT_CHARS = 40_000;
@@ -134,7 +134,7 @@ export function measureContentBytes(content) {
  * Retention keeps the original while bounding its model-visible preview.
  * The host owns the recovery route and its permissions; a spill path is not
  * proof that workspace read/grep tools can access it. Middle-elision is the
- * fallback for a run with no directory to write to.
+ * fallback for a turn with no directory to write to.
  *
  * The preview keeps head AND tail because the two ends carry different
  * information: the head has the schema/opening of a document, the tail has
@@ -209,7 +209,7 @@ export function applyToolOutputBudget(opts) {
 function spill(dir, toolUseId, content, onError) {
     try {
         // `0o700` on the directory and `0o600` on the file: a spilled output is
-        // routinely the largest and most sensitive thing a run produces — whole
+        // routinely the largest and most sensitive thing a turn produces — whole
         // files, whole command outputs — and the default `0o755`/`0o644` made
         // every one of them world-readable on a shared host.
         //
@@ -253,7 +253,7 @@ function spill(dir, toolUseId, content, onError) {
         // EEXIST is reported as its own sentence rather than folded into the
         // generic message, because the two causes lead to opposite next moves:
         // a stale file from a reused output directory is housekeeping, while
-        // something arriving at a path only this run should know is the case
+        // something arriving at a path only this turn should know is the case
         // the exclusive open exists to refuse, and an operator has to be able
         // to tell them apart from the log line alone.
         const code = err?.code;

package/dist/runtime/query/tool-output-budget.js.map

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

package/dist/runtime/query/tool-pause.d.ts

@@ -1,5 +1,5 @@
 import type { ResumeHandler } from '../../types/hitl/index.js';
-import type { RunId } from '../../types/ids/index.js';
+import type { SessionId, TurnId } from '../../types/ids/index.js';
 import type { RequestToolPause } from '../../types/tool/index.js';
 import type { PendingAnswers, QuestionParkRecorder } from './question-park.js';
 /**
@@ -17,7 +17,7 @@ import type { PendingAnswers, QuestionParkRecorder } from './question-park.js';
  *
  * This is that same machinery behind a function on `ToolContext`. Nothing
  * new is invented: the park is a real checkpoint, the answer routes back
- * on resume, and a pause is inert outside a run that supports one.
+ * on resume, and a pause is inert outside a turn that supports one.
  */
 /**
  * Identity of one pause.
@@ -65,7 +65,8 @@ export declare const pauseId: (toolUseId: string, name: string) => string;
  */
 export declare const isPauseForCall: (pause: string, callId: string) => boolean;
 interface ToolPauseDeps {
-    readonly runId: RunId;
+    readonly sessionId: SessionId;
+    readonly turnId: TurnId;
     readonly toolUseId: string;
     readonly parkHandler: ResumeHandler;
     readonly recorder?: QuestionParkRecorder;

package/dist/runtime/query/tool-pause.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-pause.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/tool-pause.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,aAAa,EAAoB,MAAM,2BAA2B,CAAA;AACpG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,2BAA2B,CAAA;AAEnF,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9E;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,MAAM,EAAE,MAAM,MAAM,KAAG,MAAgC,CAAA;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,OACZ,CAAA;AAEnD,UAAU,aAAa;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAA;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CACxC;AA0BD,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAsDrE"}
+{"version":3,"file":"tool-pause.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/tool-pause.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,aAAa,EAAoB,MAAM,2BAA2B,CAAA;AACpG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,2BAA2B,CAAA;AAEnF,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9E;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,MAAM,EAAE,MAAM,MAAM,KAAG,MAAgC,CAAA;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,OACZ,CAAA;AAEnD,UAAU,aAAa;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAA;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CACxC;AA0BD,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAuDrE"}

package/dist/runtime/query/tool-pause.js

@@ -14,7 +14,7 @@ import { generateCheckpointId } from '../../utils/id.js';
  *
  * This is that same machinery behind a function on `ToolContext`. Nothing
  * new is invented: the park is a real checkpoint, the answer routes back
- * on resume, and a pause is inert outside a run that supports one.
+ * on resume, and a pause is inert outside a turn that supports one.
  */
 /**
  * Identity of one pause.
@@ -86,7 +86,7 @@ const unanswered = (reason) => ({ status: 'unanswered', reason });
 export function createToolPause(deps) {
     return async (request) => {
         const id = pauseId(deps.toolUseId, request.name);
-        // An answer carried in from a resumed run, checked BEFORE parking.
+        // An answer carried in from a resumed turn, checked BEFORE parking.
         // Re-entering the tool is how the answer gets delivered — the batch
         // re-executes — so without this the resume would ask a human
         // something they already answered, or headlessly discard it.
@@ -96,7 +96,8 @@ export function createToolPause(deps) {
         const decision = carried ??
             (await deps.parkHandler({
                 type: 'user_question',
-                runId: deps.runId,
+                sessionId: deps.sessionId,
+                turnId: deps.turnId,
                 // The question retains its correlation id; provider ids and pause
                 // names need not be safe components of a checkpoint storage key.
                 checkpointId: parkedAt ?? generateCheckpointId(),
@@ -111,7 +112,7 @@ export function createToolPause(deps) {
             return unanswered('the pause was resolved without an answer');
         }
         if (decision.questionId !== undefined && decision.questionId !== id) {
-            // Misdirection guard. Host queues are keyed by run, so a stale
+            // Misdirection guard. Host queues are keyed by turn, so a stale
             // client can answer pause N after pause N+1 opened under the same
             // run. Answering the wrong question is worse than not answering.
             return unanswered('the answer was addressed to a different pause');

package/dist/runtime/query/tool-pause.js.map

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

package/dist/runtime/query/tooling.d.ts

@@ -1,26 +1,31 @@
 import type { AuthorizationGate } from '../../authorization/gate.js';
 import type { PluginLifecycleManager } from '../../plugin/lifecycle.js';
 import type { ActivityStore } from '../../store/activity/memory.js';
-import type { RunId } from '../../types/ids/index.js';
+import type { SessionId, TurnId } from '../../types/ids/index.js';
 import type { InvocationState } from '../../types/invocation/index.js';
 import type { PermissionMode } from '../../types/permission/index.js';
-import type { AuditEventInput } from '../../types/run/audit.js';
-import type { RunEvent } from '../../types/run/index.js';
+import type { AuditEventInput } from '../../types/session/audit.js';
+import type { SessionRecord } from '../../types/session/records.js';
 import type { RequestToolPause, SkillRegistryRef, ToolRegistryContract } from '../../types/tool/index.js';
 import type { RepairToolCall } from '../../types/tool/repair.js';
 import type { BackoffPolicy } from '../../utils/backoff.js';
 import type { Logger } from '../../utils/logger.js';
 import type { BackgroundJobRegistry } from '../jobs/registry.js';
 import { ToolExecutor } from './executor.js';
-export type EmitEvent = (event: RunEvent) => Promise<void>;
+import type { EmitEvent } from './events.js';
 export interface ToolingBootstrapConfig {
     fileReadTracker?: import('../../types/tool/index.js').FileReadTracker;
     tools: ToolRegistryContract;
-    runId: RunId;
+    sessionId: SessionId;
+    turnId: TurnId;
     workingDirectory: string;
     /** See `QueryParams.additionalDirectories`. */
     additionalDirectories?: readonly string[];
-    /** A resolver, so an approval inside a run can change it. See the executor. */
+    /** See `QueryParams.outsideRootAccess`. */
+    outsideRootAccess?: 'refuse' | 'review';
+    /** See `QueryParams.sandboxEscape`. */
+    sandboxEscape?: 'refuse' | 'review';
+    /** A resolver, so an approval inside a turn can change it. See the executor. */
     permissionMode: PermissionMode | (() => PermissionMode);
     env: Record<string, string>;
     abortSignal: AbortSignal;
@@ -28,7 +33,7 @@ export interface ToolingBootstrapConfig {
     invocationState?: InvocationState;
     pluginManager?: PluginLifecycleManager;
     toolTimeoutMs?: number;
-    /** Host-owned and shared; the executor binds it to this run. */
+    /** Host-owned and shared; the executor binds it to this turn. */
     backgroundJobs?: BackgroundJobRegistry;
     /** See `QueryParams.backgroundJobOwner`. */
     backgroundJobOwner?: string;
@@ -36,18 +41,18 @@ export interface ToolingBootstrapConfig {
     onJobAwaited?: (id: string) => void;
     /** Where the `skill` tool reads from. */
     skills?: SkillRegistryRef;
-    /** How this run reaches the web. */
+    /** How this turn reaches the web. */
     web?: import('../../types/tool/index.js').ToolContext['web'];
     toolRetryBackoff?: Partial<BackoffPolicy>;
     maxToolConcurrency?: number;
     maxToolCalls?: number;
-    readToolCallBudgetEvents?: () => Promise<readonly RunEvent[]>;
+    readToolCallBudgetRecords?: () => Promise<readonly SessionRecord[]>;
     maxToolOutputChars?: number;
     /** See `QueryParams.toolResultGuardrails`. Absent installs the shipped default; a registry's own win. */
     toolResultGuardrails?: readonly import('../../types/guardrail/index.js').ToolResultGuardrailSpec[];
     retainedToolPreviewChars?: number;
     maxToolContentBytes?: number;
-    captureRunEvidence?: import('../../types/tool/index.js').ToolContext['captureRunEvidence'];
+    captureSessionEvidence?: import('../../types/tool/index.js').ToolContext['captureSessionEvidence'];
     toolOutputDir?: string | (() => string | undefined);
     repairToolCall?: RepairToolCall;
     /** Operator authorization shared with the direct-call review path. */

package/dist/runtime/query/tooling.d.ts.map

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

package/dist/runtime/query/tooling.js

@@ -4,17 +4,20 @@ export class ToolingBootstrap {
         return new ToolExecutor({
             tools: config.tools,
             ...(config.fileReadTracker ? { fileReadTracker: config.fileReadTracker } : {}),
-            runId: config.runId,
+            sessionId: config.sessionId,
+            turnId: config.turnId,
             workingDirectory: config.workingDirectory,
             ...(config.additionalDirectories?.length
                 ? { additionalDirectories: config.additionalDirectories }
                 : {}),
+            ...(config.outsideRootAccess ? { outsideRootAccess: config.outsideRootAccess } : {}),
+            ...(config.sandboxEscape ? { sandboxEscape: config.sandboxEscape } : {}),
             permissionMode: config.permissionMode,
             env: config.env,
             abortSignal: config.abortSignal,
             allowedTools: config.allowedTools,
             invocationState: config.invocationState,
-            captureRunEvidence: config.captureRunEvidence,
+            captureSessionEvidence: config.captureSessionEvidence,
             pluginManager: config.pluginManager,
             ...(config.backgroundJobs ? { backgroundJobs: config.backgroundJobs } : {}),
             ...(config.backgroundJobOwner ? { backgroundJobOwner: config.backgroundJobOwner } : {}),
@@ -26,8 +29,8 @@ export class ToolingBootstrap {
                 ? { toolRetryBackoff: config.toolRetryBackoff }
                 : {}),
             ...(config.maxToolCalls !== undefined ? { maxToolCalls: config.maxToolCalls } : {}),
-            ...(config.readToolCallBudgetEvents
-                ? { readToolCallBudgetEvents: config.readToolCallBudgetEvents }
+            ...(config.readToolCallBudgetRecords
+                ? { readToolCallBudgetRecords: config.readToolCallBudgetRecords }
                 : {}),
             ...(config.maxToolConcurrency !== undefined
                 ? { maxToolConcurrency: config.maxToolConcurrency }

package/dist/runtime/query/tooling.js.map

@@ -1 +1 @@
-{"version":3,"file":"tooling.js","sourceRoot":"","sources":["../../../src/runtime/query/tooling.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tooling.js","sourceRoot":"","sources":["../../../src/runtime/query/tooling.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAsD5C,MAAM,OAAO,gBAAgB;IAC5B,MAAM,CAAC,IAAI,CACV,MAA8B,EAC9B,aAA4B,EAC5B,SAAoB,EACpB,GAAW;QAEX,OAAO,IAAI,YAAY,CACtB;YACC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,GAAG,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM;gBACvC,CAAC,CAAC,EAAE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EAAE;gBACzD,CAAC,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;YACrD,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,GAAG,CAAC,MAAM,CAAC,gBAAgB,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE;gBAC/C,CAAC,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,GAAG,CAAC,MAAM,CAAC,yBAAyB;gBACnC,CAAC,CAAC,EAAE,yBAAyB,EAAE,MAAM,CAAC,yBAAyB,EAAE;gBACjE,CAAC,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,kBAAkB,KAAK,SAAS;gBAC1C,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE;gBACnD,CAAC,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,kBAAkB,KAAK,SAAS;gBAC1C,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE;gBACnD,CAAC,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,oBAAoB,KAAK,SAAS;gBAC5C,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,EAAE;gBACvD,CAAC,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,wBAAwB,KAAK,SAAS;gBAChD,CAAC,CAAC,EAAE,wBAAwB,EAAE,MAAM,CAAC,wBAAwB,EAAE;gBAC/D,CAAC,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,mBAAmB,KAAK,SAAS;gBAC3C,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,EAAE;gBACrD,CAAC,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,GAAG,CAAC,MAAM,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;gBACzC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;gBACjD,CAAC,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1E,EACD,aAAa,EACb,SAAS,EACT,GAAG,CACH,CAAA;IACF,CAAC;CACD"}

package/dist/runtime/query/turn-state.d.ts

@@ -0,0 +1,56 @@
+import type { TurnRecorder } from '../../manager/session/turn-recorder.js';
+import type { SessionCheckpointStore } from '../../store/checkpoint/index.js';
+import type { SessionLog } from '../../store/session-log/index.js';
+import type { CheckpointId, MessageId, ProjectId, SessionId, TenantId, TopicId, TurnId } from '../../types/ids/index.js';
+import type { Message } from '../../types/message/index.js';
+import type { Checkpoint } from '../../types/session/checkpoint.js';
+import { type TurnState } from '../../types/session/turn-state.js';
+/**
+ * Where a turn's durable state lives: the full attribution, so a shared
+ * backend can enforce isolation.
+ */
+export interface TurnStateScope {
+    readonly tenantId: TenantId;
+    readonly projectId: ProjectId;
+    readonly topicId: TopicId;
+    readonly sessionId: SessionId;
+    readonly turnId: TurnId;
+    /** Present on a child session's turn. */
+    readonly parentSessionId?: SessionId;
+    /** Present on a child session's turn. */
+    readonly parentTurnId?: TurnId;
+}
+/**
+ * Snapshot a live turn into a {@link TurnState} a different process can
+ * resume. Every field is copied, not referenced: the caller is about to
+ * serialize it.
+ */
+export declare function captureTurnState(recorder: TurnRecorder, scope: TurnStateScope, extra?: {
+    elapsedMs?: number;
+    checkpoint?: Checkpoint | null;
+}): TurnState;
+/**
+ * Read a turn's state back from its checkpoint and the session log. The
+ * parked checkpoint if there is one, else the newest; `null` when the turn
+ * has none — a turn that never checkpointed left nothing to resume from.
+ *
+ * `status` is `running`: a checkpoint is written mid-flight. Read `pending`
+ * to tell a parked turn from a live one.
+ */
+export declare function loadTurnState(log: SessionLog, store: SessionCheckpointStore, scope: TurnStateScope, checkpointId?: CheckpointId): Promise<TurnState | null>;
+/** {@link loadTurnState}, also returning the checkpoint document it was read from. */
+export declare function loadSelectedTurnState(log: SessionLog, store: SessionCheckpointStore, scope: TurnStateScope, checkpointId?: CheckpointId): Promise<{
+    readonly state: TurnState;
+    readonly checkpoint: Checkpoint;
+} | null>;
+/**
+ * @internal {@link loadSelectedTurnState} plus the record ids of the restored
+ * messages, which a resume in this process adopts so the log keeps one
+ * record per message.
+ */
+export declare function loadSelectedTurnContext(log: SessionLog, store: SessionCheckpointStore, scope: TurnStateScope, checkpointId?: CheckpointId): Promise<{
+    readonly state: TurnState;
+    readonly checkpoint: Checkpoint;
+    readonly messageIds: ReadonlyMap<Message, MessageId>;
+} | null>;
+//# sourceMappingURL=turn-state.d.ts.map

package/dist/runtime/query/turn-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-state.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/turn-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,KAAK,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,MAAM,EACN,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAA;AAGtF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,yCAAyC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAA;IACpC,yCAAyC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,cAAc,EACrB,KAAK,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,GAC5D,SAAS,CA4BX;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAClC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,sBAAsB,EAC7B,KAAK,EAAE,cAAc,EACrB,YAAY,CAAC,EAAE,YAAY,GACzB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAE3B;AAED,sFAAsF;AACtF,wBAAsB,qBAAqB,CAC1C,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,sBAAsB,EAC7B,KAAK,EAAE,cAAc,EACrB,YAAY,CAAC,EAAE,YAAY,GACzB,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAAC,CAGhF;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC5C,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,sBAAsB,EAC7B,KAAK,EAAE,cAAc,EACrB,YAAY,CAAC,EAAE,YAAY,GACzB,OAAO,CAAC;IACV,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;CACpD,GAAG,IAAI,CAAC,CAsCR"}

package/dist/runtime/query/turn-state.js

@@ -0,0 +1,99 @@
+import { TURN_STATE_VERSION } from '../../types/session/turn-state.js';
+import { findPendingCheckpoint, restoreCheckpointContext } from './checkpoint.js';
+/**
+ * Snapshot a live turn into a {@link TurnState} a different process can
+ * resume. Every field is copied, not referenced: the caller is about to
+ * serialize it.
+ */
+export function captureTurnState(recorder, scope, extra) {
+    const turn = recorder.getTurn();
+    const startedAt = turn.startedAt;
+    const binding = recorder.budget?.binding;
+    return {
+        version: TURN_STATE_VERSION,
+        sessionId: scope.sessionId,
+        turnId: recorder.turnId,
+        topicId: scope.topicId,
+        projectId: scope.projectId,
+        tenantId: scope.tenantId,
+        ...(scope.parentSessionId ? { parentSessionId: scope.parentSessionId } : {}),
+        ...(scope.parentTurnId ? { parentTurnId: scope.parentTurnId } : {}),
+        agentId: turn.metadata.agentId,
+        agentName: turn.metadata.agentName,
+        status: recorder.status,
+        ...(recorder.stopReason ? { stopReason: recorder.stopReason } : {}),
+        ...(turn.lastError ? { lastError: turn.lastError } : {}),
+        messages: structuredClone(recorder.messages),
+        tokenUsage: { ...recorder.tokenUsage },
+        costInfo: { ...recorder.costInfo },
+        currentIteration: recorder.currentIteration,
+        startedAt,
+        elapsedMs: extra?.elapsedMs ?? Date.now() - startedAt,
+        ...(extra?.checkpoint ? { checkpointId: extra.checkpoint.checkpointId } : {}),
+        ...(binding ? { budgetBinding: binding } : {}),
+        capturedAt: Date.now(),
+    };
+}
+/**
+ * Read a turn's state back from its checkpoint and the session log. The
+ * parked checkpoint if there is one, else the newest; `null` when the turn
+ * has none — a turn that never checkpointed left nothing to resume from.
+ *
+ * `status` is `running`: a checkpoint is written mid-flight. Read `pending`
+ * to tell a parked turn from a live one.
+ */
+export async function loadTurnState(log, store, scope, checkpointId) {
+    return (await loadSelectedTurnState(log, store, scope, checkpointId))?.state ?? null;
+}
+/** {@link loadTurnState}, also returning the checkpoint document it was read from. */
+export async function loadSelectedTurnState(log, store, scope, checkpointId) {
+    const selected = await loadSelectedTurnContext(log, store, scope, checkpointId);
+    return selected ? { state: selected.state, checkpoint: selected.checkpoint } : null;
+}
+/**
+ * @internal {@link loadSelectedTurnState} plus the record ids of the restored
+ * messages, which a resume in this process adopts so the log keeps one
+ * record per message.
+ */
+export async function loadSelectedTurnContext(log, store, scope, checkpointId) {
+    const storeScope = {
+        tenantId: scope.tenantId,
+        projectId: scope.projectId,
+        sessionId: scope.sessionId,
+        turnId: scope.turnId,
+    };
+    let id = checkpointId;
+    if (id === undefined) {
+        const parked = await findPendingCheckpoint(log, { turnId: scope.turnId });
+        id = parked?.checkpointId ?? (await store.list(storeScope)).at(-1)?.checkpointId;
+    }
+    if (id === undefined)
+        return null;
+    const checkpoint = await store.restore(storeScope, id);
+    if (!checkpoint)
+        return null;
+    const restored = await restoreCheckpointContext(log, checkpoint);
+    const state = {
+        version: TURN_STATE_VERSION,
+        sessionId: scope.sessionId,
+        turnId: scope.turnId,
+        topicId: scope.topicId,
+        projectId: scope.projectId,
+        tenantId: scope.tenantId,
+        ...(scope.parentSessionId ? { parentSessionId: scope.parentSessionId } : {}),
+        ...(scope.parentTurnId ? { parentTurnId: scope.parentTurnId } : {}),
+        status: 'running',
+        messages: restored.messages,
+        tokenUsage: checkpoint.tokenUsage,
+        costInfo: checkpoint.costInfo,
+        currentIteration: checkpoint.guards.iteration,
+        startedAt: Date.parse(checkpoint.turnCreatedAt),
+        elapsedMs: checkpoint.guards.elapsedMs,
+        checkpointId: checkpoint.checkpointId,
+        ...(restored.pending ? { pending: restored.pending } : {}),
+        ...(checkpoint.budget?.binding ? { budgetBinding: checkpoint.budget.binding } : {}),
+        capturedAt: Date.now(),
+    };
+    return { state, checkpoint, messageIds: restored.messageIds };
+}
+//# sourceMappingURL=turn-state.js.map

package/dist/runtime/query/turn-state.js.map

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

package/dist/sandbox/isolation.d.ts

@@ -7,7 +7,7 @@ export declare function missingIsolation(environment: SandboxEnvironment, requir
  *
  * Refusing is the whole point. A security control that is accepted and
  * then silently not applied is worse than one that was never offered: the
- * caller stops looking, and the run proceeds believing it is confined.
+ * caller stops looking, and the turn proceeds believing it is confined.
  */
 export declare function assertIsolation(environment: SandboxEnvironment, required: readonly SandboxIsolationControl[]): void;
 /** Human-readable summary for logs and error messages. */

package/dist/sandbox/isolation.js

@@ -45,13 +45,13 @@ export function missingIsolation(environment, required) {
  *
  * Refusing is the whole point. A security control that is accepted and
  * then silently not applied is worse than one that was never offered: the
- * caller stops looking, and the run proceeds believing it is confined.
+ * caller stops looking, and the turn proceeds believing it is confined.
  */
 export function assertIsolation(environment, required) {
     const missing = missingIsolation(environment, required);
     if (missing.length === 0)
         return;
-    throw new Error(`Sandbox environment "${environment}" cannot enforce ${missing.join(', ')} isolation, which this run requires. Enforced here: ${describeIsolation(environment)}. Run on a host that supports it, or drop the requirement explicitly — it will not be silently downgraded.`);
+    throw new Error(`Sandbox environment "${environment}" cannot enforce ${missing.join(', ')} isolation, which this turn requires. Enforced here: ${describeIsolation(environment)}. Run on a host that supports it, or drop the requirement explicitly — it will not be silently downgraded.`);
 }
 /** Human-readable summary for logs and error messages. */
 export function describeIsolation(environment) {

package/dist/sandbox/isolation.js.map

@@ -1 +1 @@
-{"version":3,"file":"isolation.js","sourceRoot":"","sources":["../../src/sandbox/isolation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAEtE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,wBAAwB,GAAiE;IAC9F,aAAa,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACjE,gBAAgB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACpE,iBAAiB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACtE,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;CAC5D,CAAA;AAED,MAAM,UAAU,WAAW,CAAC,WAA+B;IAC1D,MAAM,MAAM,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAA;IACpD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,MAAM,CAAA;AACd,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAC/B,WAA+B,EAC/B,QAA4C;IAE5C,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IACvC,OAAO,0BAA0B,CAAC,MAAM,CACvC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAC3D,CAAA;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC9B,WAA+B,EAC/B,QAA4C;IAE5C,MAAM,OAAO,GAAG,gBAAgB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEhC,MAAM,IAAI,KAAK,CACd,wBAAwB,WAAW,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,uDAAuD,iBAAiB,CAAC,WAAW,CAAC,4GAA4G,CAC1Q,CAAA;AACF,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,WAA+B;IAChE,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IACvC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAChF,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC/D,CAAC"}
+{"version":3,"file":"isolation.js","sourceRoot":"","sources":["../../src/sandbox/isolation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAEtE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,wBAAwB,GAAiE;IAC9F,aAAa,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACjE,gBAAgB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACpE,iBAAiB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACtE,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;CAC5D,CAAA;AAED,MAAM,UAAU,WAAW,CAAC,WAA+B;IAC1D,MAAM,MAAM,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAA;IACpD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,MAAM,CAAA;AACd,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAC/B,WAA+B,EAC/B,QAA4C;IAE5C,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IACvC,OAAO,0BAA0B,CAAC,MAAM,CACvC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAC3D,CAAA;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC9B,WAA+B,EAC/B,QAA4C;IAE5C,MAAM,OAAO,GAAG,gBAAgB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEhC,MAAM,IAAI,KAAK,CACd,wBAAwB,WAAW,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,wDAAwD,iBAAiB,CAAC,WAAW,CAAC,4GAA4G,CAC3Q,CAAA;AACF,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,WAA+B;IAChE,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IACvC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAChF,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC/D,CAAC"}

package/dist/sandbox/provider/local.d.ts

@@ -21,7 +21,7 @@ export declare function acceptsSandboxSpawnProbe(observation: SpawnProbeObservat
 /**
  * One output stream, accumulated under a byte cap that it reports hitting.
  *
- * The clipping was inline and the flag was not set, so a run whose output
+ * The clipping was inline and the flag was not set, so a turn whose output
  * ran past the cap returned a result that looked whole. The tool layer
  * already renders `stdoutTruncated` when a backend sets it — this one
  * simply never did, which is the silent truncation the contract's own doc
@@ -93,7 +93,7 @@ export declare function buildLimitedSpawn(request: LimitedSpawnRequest): {
 export declare function buildBwrapArgs(sandboxRoot: string, additionalDirectories?: readonly string[]): string[];
 export interface LocalSandboxProviderOptions {
     /**
-     * Controls this run relies on. Construction throws when the detected
+     * Controls this turn relies on. Construction throws when the detected
      * environment cannot enforce one of them, rather than downgrading to
      * whatever the host happens to offer.
      */

package/dist/sandbox/provider/local.js

@@ -104,7 +104,7 @@ function resolveTrustedWrapper(name) {
         }
         catch {
             // Try the next fixed system location. Caller-controlled PATH is not
-            // part of wrapper discovery because it is also configurable per run.
+            // part of wrapper discovery because it is also configurable per turn.
         }
     }
     return undefined;
@@ -112,7 +112,7 @@ function resolveTrustedWrapper(name) {
 /**
  * One output stream, accumulated under a byte cap that it reports hitting.
  *
- * The clipping was inline and the flag was not set, so a run whose output
+ * The clipping was inline and the flag was not set, so a turn whose output
  * ran past the cap returned a result that looked whole. The tool layer
  * already renders `stdoutTruncated` when a backend sets it — this one
  * simply never did, which is the silent truncation the contract's own doc
@@ -279,7 +279,7 @@ export function buildBwrapArgs(sandboxRoot, additionalDirectories = []) {
     const root = canonicalizePath(sandboxRoot);
     const args = [
         '--unshare-all',
-        // The child dies with the parent rather than outliving a killed run.
+        // The child dies with the parent rather than outliving a killed turn.
         // Without it an escaped grandchild keeps the mount namespace alive and
         // the sandbox's temporary root cannot be removed.
         '--die-with-parent',
@@ -311,7 +311,7 @@ export function buildBwrapArgs(sandboxRoot, additionalDirectories = []) {
     }
     args.push('--proc', '/proc', '--dev', '/dev', 
     // A private /tmp, because the sandbox root is where writes belong and a
-    // shared /tmp is a channel between runs.
+    // shared /tmp is a channel between turns.
     '--tmpfs', '/tmp', '--bind', root, root);
     // The host's added directories, read-write at their own paths, so a
     // path the model was given on the host means the same thing inside.
@@ -651,7 +651,7 @@ class LocalSandbox {
         this._status = 'destroyed';
         // A generated temp root belongs to this allocation. A working-directory
         // root belongs to the caller. Conflating those lifetimes turns normal run
-        // teardown into recursive deletion of the project the run just edited.
+        // teardown into recursive deletion of the project the turn just edited.
         if (this.removeRootOnDestroy) {
             await rm(this.rootDir, { recursive: true, force: true });
         }
@@ -924,7 +924,7 @@ export class LocalSandboxProvider {
             // process sees the whole host filesystem, the whole network, and
             // every host process. The host-side controls that do survive (env
             // scrubbed to a safe key set, cwd anchored, the SDK's own file
-            // helpers path-checked) are not process confinement, and a run
+            // helpers path-checked) are not process confinement, and a turn
             // that reads "sandbox created" in its log has every reason to
             // believe otherwise.
             this.log.warn('No isolation available on this host; commands run unconfined', {
@@ -963,7 +963,7 @@ export class LocalSandboxProvider {
             if (!entry.isDirectory()) {
                 throw new Error(`Sandbox workingDirectory is not a directory: ${requested}`);
             }
-            // The caller owns this tree. The sandbox handle may be per run, but the
+            // The caller owns this tree. The sandbox handle may be per turn, but the
             // workspace survives every handle created for the session.
             rootDir = canonicalizePath(requested);
             if (rootDir === parse(rootDir).root) {