@namzu/sdk 34.1.0 → 35.0.0

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

@@ -1,7 +1,8 @@
 import type { ContextReducer } from '../../compaction/reducer.js';
-import type { CompactionConfig } from '../../config/runtime.js';
+import { type CompactionConfig } from '../../config/runtime.js';
 import { type ProviderChainMember } from '../../provider/fallback.js';
 import { type ProviderRetryConfig } from '../../provider/retry.js';
+import type { TokenBudget } from '../../run/token-budget.js';
 import type { PathBuilder } from '../../session/workspace/path-builder.js';
 import type { SerializedSpanContext } from '../../telemetry/attributes.js';
 import type { AdvisoryConfig } from '../../types/advisory/index.js';
@@ -10,9 +11,10 @@ import type { AgentContextLevel } from '../../types/agent/factory.js';
 import type { WorkingMemoryProvider } from '../../types/agent/working-memory.js';
 import type { AuthorizationGateConfig } from '../../types/authorization/index.js';
 import type { InputGuardrailSpec, OutputGuardrailSpec } from '../../types/guardrail/index.js';
-import { type CheckpointId, type HITLResumeDecision, type ResumeHandler } from '../../types/hitl/index.js';
-import type { RunId, SessionId, TenantId } from '../../types/ids/index.js';
+import { type HITLResumeDecision, type ResumeHandler } from '../../types/hitl/index.js';
+import type { CheckpointId, RunId, SessionId, TenantId } from '../../types/ids/index.js';
 import type { InvocationState } from '../../types/invocation/index.js';
+import type { MemoryStore } from '../../types/memory/index.js';
 import { type Message } from '../../types/message/index.js';
 import type { AgentPersona } from '../../types/persona/index.js';
 import type { LLMProvider } from '../../types/provider/index.js';
@@ -24,6 +26,7 @@ import type { AgentRunConfig, BeforeStep, PrepareStepChain, Run, RunEvent, RunEv
 import type { PromoteMemory } from '../../types/run/memory-promotion.js';
 import type { RunState } from '../../types/run/state.js';
 import type { RunStore } from '../../types/run/store.js';
+import type { TokenBudgetStore } from '../../types/run/token-budget-store.js';
 import type { SandboxProvider } from '../../types/sandbox/index.js';
 import type { ProjectId, TopicId } from '../../types/session/ids.js';
 import type { Skill } from '../../types/skills/index.js';
@@ -37,8 +40,12 @@ import type { BackgroundJobRegistry } from '../jobs/registry.js';
 import { type ProjectInstructionContext } from './project-instructions.js';
 import type { PromptCache } from './prompt-cache.js';
 import { PendingAnswers, QuestionParkBinding } from './question-park.js';
-import type { SteeringChannel } from './steering.js';
+import { type SteeringChannel } from './steering.js';
 export interface QueryParams {
+    /** One account shared with the task scheduler and descendant runs. */
+    budget?: TokenBudget;
+    /** Canonical tree ledger; defaults to disk beside the root run. */
+    tokenBudgetStore?: TokenBudgetStore;
     /**
      * Notice when the model issues the identical tool call repeatedly, and
      * say so on the next `tool_result`. Defaults on.
@@ -152,6 +159,16 @@ export interface QueryParams {
      * background execution is refused rather than silently bypassing the sandbox.
      */
     backgroundJobs?: BackgroundJobRegistry;
+    /**
+     * Which owner the run's background jobs belong to. Absent, the run id:
+     * jobs are stopped when the run ends. A host that wants a job to
+     * outlive the turn that started it — a dev server started in one turn
+     * and read in the next — passes its session id here and calls
+     * `backgroundJobs.killOwner(sessionId)` when the session ends; the run
+     * then stops nothing at its end and still tells the model when a job
+     * finishes.
+     */
+    backgroundJobOwner?: string;
     /**
      * What else goes in this run's prompt.
      *
@@ -329,6 +346,12 @@ export interface QueryParams {
     agentId: string;
     agentName: string;
     workingDirectory?: string;
+    /**
+     * Directories besides the working directory the file tools may reach,
+     * absolute; a sandboxed run binds each read-write. See
+     * `ToolContext.additionalDirectories`.
+     */
+    additionalDirectories?: readonly string[];
     pricing?: ModelPricing;
     enableActivityTracking?: boolean;
     messages: Message[];
@@ -540,6 +563,14 @@ export interface QueryParams {
     taskRouter?: TaskRouterConfig;
     advisory?: AdvisoryConfig;
     compactionConfig?: CompactionConfig;
+    /**
+     * Where what the run learned is written when it ends: its decisions,
+     * discoveries and failures, as one entry tagged `learning`. Episodic
+     * memory (the working state) dies with the run; this is the bridge to
+     * the semantic store a later run searches. Absent means nothing is
+     * written. A store that fails is logged and never fails the run.
+     */
+    consolidateInto?: MemoryStore;
     /**
      * Optional neutral working-memory seam. When set, the iteration loop
      * re-renders the provider's string into a single pinned leading system

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

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

package/dist/runtime/query/index.js

@@ -2,21 +2,23 @@ import { join } from 'node:path';
 import { AdvisorRegistry, AdvisoryContext, AdvisoryExecutor, TriggerEvaluator, assertBudgetEnforceable, } from '../../advisory/index.js';
 import { drainQueuedMessages } from '../../agents/handle.js';
 import { AuthorizationGate } from '../../authorization/gate.js';
+import { consolidationEntry } from '../../compaction/consolidation.js';
 import { repairToolMessageHistory, toolHistoryRepairChanged, } from '../../compaction/dangling.js';
 import { extractFromUserMessage } from '../../compaction/extractor.js';
 import { WorkingStateManager } from '../../compaction/manager.js';
 import { serializeState as serializeWorkingState } from '../../compaction/serializer.js';
 import { restoreWorkingState, snapshotWorkingState } from '../../compaction/wire.js';
-import { BOOT_EVENT_NAMES } from '../../constants/telemetry/index.js';
+import { CompactionConfigSchema } from '../../config/runtime.js';
 import { TOOL_OUTPUT_DIR_NAME } from '../../constants/tools/index.js';
 import { EmergencySaveManager } from '../../manager/run/emergency.js';
 import { resolveModelPricing } from '../../pricing/index.js';
+import { PromptContributionRegistry } from '../../prompt/contributions.js';
 import { resolveProviderCapabilities } from '../../provider/capabilities.js';
 import { isCallerAbortError } from '../../provider/errors.js';
 import { withProviderFallback, } from '../../provider/fallback.js';
 import { resolveStreamIdleTimeoutMs, withStreamIdleTimeout } from '../../provider/idle-timeout.js';
 import { withProviderRetry } from '../../provider/retry.js';
-import { DefaultFilesystemMigrator, loggingMigrationSink } from '../../session/migration/index.js';
+import { withTokenBudget } from '../../provider/token-budget.js';
 import { resolveAttachments } from '../../store/attachment/index.js';
 import { GENAI, NAMZU, agentRunSpanName, parentContext, serializeSpan, } from '../../telemetry/attributes.js';
 import { recordRunDuration } from '../../telemetry/metrics.js';
@@ -32,9 +34,8 @@ import { cancelCauseOf } from '../../types/run/cancel-cause.js';
 import { resolveRunEventReplay } from '../../types/run/event-cursor.js';
 import { memoryCandidateFor } from '../../types/run/memory-promotion.js';
 import { toErrorMessage } from '../../utils/error.js';
-import { generateRunId } from '../../utils/id.js';
+import { generateCheckpointId, generateRunId } from '../../utils/id.js';
 import { errorAttributes } from '../../utils/log/exception.js';
-import { EVENT_NAME_ATTRIBUTE } from '../../utils/log/types.js';
 import { AUTO_APPROVE_POLICY_NAME, createRunApprovalPolicy } from './approval-policy.js';
 import { CheckpointManager } from './checkpoint.js';
 import { RunContextFactory } from './context.js';
@@ -53,6 +54,8 @@ import { resolveMaxRequestRichContentBytes } from './request-rich-content.js';
 import { ResultAssembler } from './result.js';
 import { applyPendingResume, planCrashResume, planPendingResume, recoverCompletedCalls, unansweredToolCalls, } from './resume-pending.js';
 import { acquireSandbox, resolveSandboxTeardownTimeoutMs, teardownSandbox, } from './sandbox-lifecycle.js';
+import { SteeringBinding } from './steering.js';
+import { resolveQueryBudget } from './token-budget.js';
 import { ToolGrantSet } from './tool-grants.js';
 import { createToolPause } from './tool-pause.js';
 import { ToolingBootstrap } from './tooling.js';
@@ -278,6 +281,7 @@ export async function* query(params) {
     // generating it twice would silently hand the log and the run two
     // different ids.
     const runId = params.runId ?? generateRunId();
+    const budget = await resolveQueryBudget(params, runId, selectedResumeState);
     const log = RunContextFactory.buildLogger({
         agentName: params.agentName,
         runConfig,
@@ -288,40 +292,6 @@ export async function* query(params) {
         projectId: params.projectId,
         tenantId: params.tenantId,
     });
-    // Boot-time filesystem migration (session-hierarchy.md §13.4.1). First
-    // call per process per root actually runs; subsequent calls short-circuit
-    // via the in-memory guard in `context.ts`. Kept here rather than inside
-    // the synchronous `RunContextFactory.build` so the factory signature stays
-    // sync for tests / non-async call sites.
-    //
-    // The migrator built here — not `ensureMigrated`'s own default — is what
-    // turns the migration facts `DefaultFilesystemMigrator` already computes
-    // into a `namzu.migration.completed` record instead of discarding them.
-    // `ensureMigrated`'s default parameter stays
-    // `NOOP_FILESYSTEM_MIGRATION_SINK` (see `context.ts`), so any other path
-    // that reaches `ensureMigrated` keeps today's silent behaviour.
-    const cwdForMigration = params.workingDirectory ?? process.cwd();
-    const migrationRoot = params.pathBuilder?.rootDir() ?? join(cwdForMigration, '.namzu');
-    const migrationResult = await RunContextFactory.ensureMigrated(migrationRoot, new DefaultFilesystemMigrator(loggingMigrationSink(log)));
-    // `loggingMigrationSink` only ever hears about `kind: 'migrated'` — the
-    // only outcome `DefaultFilesystemMigrator` ever hands its sink (see the
-    // module doc on `FilesystemMigrationSink`). The other two are logged
-    // here, straight off the resolved result, rather than by widening
-    // `FilesystemMigrationEvent` to carry them: a wider union would need a
-    // new arm in every exhaustive switch already written over it — a major —
-    // for two outcomes `migrationResult.kind` already fully describes.
-    if (migrationResult.kind !== 'migrated') {
-        log.debug('filesystem migration: nothing to do', {
-            [EVENT_NAME_ATTRIBUTE]: BOOT_EVENT_NAMES.MIGRATION_COMPLETED,
-            // `namzu.migration.*`, matching `loggingMigrationSink` — the OTHER
-            // emitter of this same event name. Two emitters of one event writing
-            // two namespaces for the same fact is precisely the collision the
-            // namespaced-key rule exists to stop, and a per-module derivation is
-            // how it would be reintroduced.
-            'namzu.migration.kind': migrationResult.kind,
-            'namzu.migration.marker_path': migrationResult.markerPath,
-        });
-    }
     // Every model call in the run — the loop's turns, the forced-final
     // summary, advisory and compaction side calls — goes through this one
     // wrapped provider, so the retry policy cannot be bypassed by a code
@@ -353,9 +323,14 @@ export async function* query(params) {
             idleTimeoutMs: streamIdleTimeoutMs,
             log,
         });
+        const metered = withTokenBudget(withIdleBound, budget);
         return params.retry === false
-            ? withIdleBound
-            : withProviderRetry(withIdleBound, { config: params.retry, log });
+            ? metered
+            : withProviderRetry(metered, {
+                config: params.retry,
+                log,
+                canRetry: () => budget.remaining > 0,
+            });
     };
     // Who is serving right now, for the run RECORD rather than for the request.
     //
@@ -372,6 +347,7 @@ export async function* query(params) {
         provider: withRecovery(member.provider),
     })), {
         log,
+        canFallback: () => budget.remaining > 0,
         onSwap: (to) => {
             serving.current = to;
             // `ctx` is declared below and is initialized before anything can
@@ -505,6 +481,7 @@ export async function* query(params) {
         });
     }
     const ctx = RunContextFactory.build({
+        budget,
         ...(topicState ? { topicPermissionMode: topicState.permissionMode } : {}),
         ...(params.permissionModeRef ? { permissionModeRef: params.permissionModeRef } : {}),
         agentId: params.agentId,
@@ -553,13 +530,19 @@ export async function* query(params) {
         },
         emit: (event) => eventTranslator.emitEvent(event),
     });
+    const planApprovalIds = new Map();
     ctx.planManager.setApprovalHandler(async (request) => {
+        let checkpointId = planApprovalIds.get(request.planId);
+        if (!checkpointId) {
+            checkpointId = generateCheckpointId();
+            planApprovalIds.set(request.planId, checkpointId);
+        }
         // `.current.handler`, never a captured `params.resumeHandler`. That
         // capture is what made changing the policy mean ending the run.
         const decision = await approvalPolicy.current.handler({
             type: 'plan_approval',
             runId: ctx.runId,
-            checkpointId: `cp_plan_${request.planId}`,
+            checkpointId,
             plan: {
                 planId: request.planId,
                 title: request.title,
@@ -872,6 +855,9 @@ export async function* query(params) {
         tools: params.tools,
         runId: ctx.runId,
         workingDirectory: ctx.cwd,
+        ...(params.additionalDirectories?.length
+            ? { additionalDirectories: params.additionalDirectories }
+            : {}),
         permissionMode: () => ctx.permissionMode.current,
         env: runConfig.env ?? {},
         abortSignal: ctx.abortController.signal,
@@ -879,6 +865,7 @@ export async function* query(params) {
         invocationState: params.invocationState,
         pluginManager: params.pluginManager,
         ...(params.backgroundJobs ? { backgroundJobs: params.backgroundJobs } : {}),
+        ...(params.backgroundJobOwner ? { backgroundJobOwner: params.backgroundJobOwner } : {}),
         // The `skill` tool's registry. Threaded from the run rather than
         // held by the tool, because a tool that reached for a module-level
         // registry would answer about whatever the last run configured.
@@ -917,11 +904,48 @@ export async function* query(params) {
             pendingAnswers,
         }),
     }, ctx.activityStore, eventTranslator.emitEvent, ctx.log);
+    // A background job's exit reaches the model as a notice on its next tool
+    // result, and the host as an event — without either polling. Subscribed
+    // for the owner the run's jobs are bound to, so a session-owned job that
+    // ends during this run is reported here too.
+    const jobOwner = params.backgroundJobOwner ?? ctx.runId;
+    const jobNotices = params.backgroundJobs ? new SteeringBinding() : undefined;
+    const unsubscribeJobExits = params.backgroundJobs?.onExit((job) => {
+        if (job.owner !== jobOwner)
+            return;
+        const outcome = job.status === 'killed'
+            ? 'was stopped'
+            : `exited with code ${job.exitCode ?? 'unknown'}${job.signal ? ` (${job.signal})` : ''}`;
+        jobNotices?.steer(`Background job ${job.id} (${job.command}) ${outcome}. Read its output with the job tool if you need it.`);
+        void eventTranslator
+            .emitEvent({
+            type: 'background_job_exited',
+            runId: ctx.runId,
+            jobId: job.id,
+            command: job.command,
+            status: job.status === 'killed' ? 'killed' : 'exited',
+            ...(job.exitCode !== undefined ? { exitCode: job.exitCode } : {}),
+            ...(job.signal ? { signal: job.signal } : {}),
+        })
+            .catch(() => { });
+    });
     let workingStateManager;
-    if (params.compactionConfig && params.compactionConfig.strategy !== 'disabled') {
-        workingStateManager = new WorkingStateManager(params.compactionConfig);
+    // Normalised once, defaults applied. A host that passes a partial
+    // object — a strategy and a window, nothing else — used to reach the
+    // phase with `triggerThreshold` undefined, and `usage < undefined` is
+    // false: the pass ran on every iteration and the salience strategy fell
+    // through to the stale-result clearing it exists to replace. The eval
+    // suite that passed exactly that object found it.
+    const compactionConfig = params.compactionConfig
+        ? CompactionConfigSchema.parse(params.compactionConfig)
+        : undefined;
+    if (compactionConfig && compactionConfig.strategy !== 'disabled') {
+        workingStateManager = new WorkingStateManager(compactionConfig);
         toolExecutor.setWorkingStateManager(workingStateManager);
     }
+    // The run's own registry when the host passed none, so a hook's
+    // annotation has somewhere to land.
+    const promptContributions = params.promptContributions ?? new PromptContributionRegistry();
     const promptBuilder = new PromptBuilder({
         systemPrompt: params.systemPrompt,
         persona: params.persona,
@@ -930,7 +954,7 @@ export async function* query(params) {
         tools: params.tools,
         allowedTools: effectiveAllowedTools,
         runtimeContext: params.runtimeContext,
-        ...(params.promptContributions ? { contributions: params.promptContributions } : {}),
+        contributions: promptContributions,
     });
     const guard = new GuardCoordinator({
         tokenBudget: runConfig.tokenBudget,
@@ -974,10 +998,10 @@ export async function* query(params) {
         // explicitly chosen provider/cancellation policy.
         const boundedAdvisors = params.advisory.advisors.map((advisor) => ({
             ...advisor,
-            provider: withStreamIdleTimeout(advisor.provider, {
+            provider: withTokenBudget(withStreamIdleTimeout(advisor.provider, {
                 idleTimeoutMs: streamIdleTimeoutMs,
                 log: ctx.log,
-            }),
+            }), budget),
         }));
         const advisorRegistry = new AdvisorRegistry(boundedAdvisors, params.advisory.defaultAdvisorId);
         // A budget the runtime cannot measure is refused here rather than
@@ -1050,8 +1074,9 @@ export async function* query(params) {
         // question rather than the next run.
         resumeHandler: (request) => approvalPolicy.current.handler(request),
         takeApprovalPolicyChange: () => approvalPolicy.takeUnannouncedChange(),
-        ...(params.promptContributions ? { promptContributions: params.promptContributions } : {}),
+        promptContributions,
         ...(params.steering ? { steering: params.steering } : {}),
+        ...(jobNotices ? { jobNotices } : {}),
         checkpointMgr,
         planManager: ctx.planManager,
         taskGateway: taskScheduler,
@@ -1064,7 +1089,7 @@ export async function* query(params) {
         // run is a claim about work nobody repeated, and a module-level map
         // would leak exactly that way.
         ...(params.repeatCallAdvisory === false ? {} : { repeatCalls: new RepeatCallTracker() }),
-        compactionConfig: params.compactionConfig,
+        compactionConfig,
         ...(params.inboundMessages ? { inboundMessages: params.inboundMessages } : {}),
         ...(params.projectInstructionContext
             ? { projectInstructionContext: params.projectInstructionContext }
@@ -1210,6 +1235,27 @@ export async function* query(params) {
                 'namzu.runtime.permission_mode': ctx.permissionMode.current,
                 'namzu.runtime.resume_from_checkpoint': params.resumeFromCheckpoint ?? null,
             });
+            // The operator's prompt, before the model sees it. A hook may
+            // refuse it — the run ends here, before a prompt is built — or add
+            // to what the model is told; the addition rides the prompt as a
+            // dynamic contribution so every iteration of the run carries it.
+            if (params.pluginManager) {
+                const hookResults = await params.pluginManager.executeHooks('user_prompt_submit', {
+                    runId: ctx.runId,
+                    sessionId: params.sessionId,
+                    prompt: lastUserPrompt(initialMessages),
+                    signal: ctx.abortController.signal,
+                }, eventTranslator.emitEvent);
+                const annotations = applyLifecycleHookResults('user_prompt_submit', hookResults);
+                if (annotations.length > 0) {
+                    promptContributions.replace({
+                        id: 'hooks:user_prompt_submit',
+                        placement: 'dynamic',
+                        render: () => `Context from the operator's hooks:\n\n${annotations.join('\n\n')}`,
+                    });
+                }
+                yield* eventTranslator.drainPending();
+            }
             const contextLevel = params.contextLevel ?? 'full';
             const cacheInput = {
                 systemPrompt: params.systemPrompt,
@@ -1219,7 +1265,7 @@ export async function* query(params) {
                 tools: params.tools,
                 allowedTools: effectiveAllowedTools,
                 runtimeContext: params.runtimeContext,
-                ...(params.promptContributions ? { contributions: params.promptContributions } : {}),
+                contributions: promptContributions,
             };
             const segments = promptCache
                 ? promptCache.getSystemPromptSegmented(cacheInput, contextLevel, params.workingDirectory)
@@ -1263,8 +1309,8 @@ export async function* query(params) {
                 // would drop it and replace it with a summary covering only
                 // what happened after the resume, silently losing the run's
                 // first hour.
-                if (workingStateManager && checkpoint.workingState && params.compactionConfig) {
-                    const revived = restoreWorkingState(checkpoint.workingState, params.compactionConfig);
+                if (workingStateManager && checkpoint.workingState && compactionConfig) {
+                    const revived = restoreWorkingState(checkpoint.workingState, compactionConfig);
                     workingStateManager.replaceState(revived.getState());
                     ctx.log.info('Restored compaction working state from checkpoint', {
                         [NAMZU.RUN_ID]: ctx.runMgr.id,
@@ -1521,6 +1567,9 @@ export async function* query(params) {
                     provider: params.sandboxProvider,
                     config: {
                         ...(rootAtCwd ? { workingDirectory: ctx.cwd } : {}),
+                        ...(rootAtCwd && params.additionalDirectories?.length
+                            ? { additionalDirectories: params.additionalDirectories }
+                            : {}),
                         timeoutMs: runConfig.sandbox?.timeoutMs,
                         memoryLimitMb: runConfig.sandbox?.memoryLimitMb,
                         maxProcesses: runConfig.sandbox?.maxProcesses,
@@ -1666,6 +1715,18 @@ export async function* query(params) {
                 const hookResults = await params.pluginManager.executeHooks('run_end', { runId: ctx.runId, signal: ctx.abortController.signal }, eventTranslator.emitEvent);
                 applyLifecycleHookResults('run_end', hookResults);
                 yield* eventTranslator.drainPending();
+                // A delegated run says so once more, by name, so a hook that
+                // only cares when a subagent finishes need not read parent ids
+                // off every run_end.
+                if (params.parentRunId !== undefined) {
+                    const stopResults = await params.pluginManager.executeHooks('subagent_stop', {
+                        runId: ctx.runId,
+                        parentRunId: params.parentRunId,
+                        signal: ctx.abortController.signal,
+                    }, eventTranslator.emitEvent);
+                    applyLifecycleHookResults('subagent_stop', stopResults);
+                    yield* eventTranslator.drainPending();
+                }
             }
             // Hand the step record to the run before it settles, so the
             // returned `Run` carries it.
@@ -1717,6 +1778,33 @@ export async function* query(params) {
                     ctx.runMgr.setResult(outputVerdict.rewritten);
                 }
             }
+            if (params.consolidateInto && workingStateManager) {
+                const entry = consolidationEntry(workingStateManager.getState(), {
+                    runId: ctx.runId,
+                    at: Date.now(),
+                });
+                if (entry) {
+                    try {
+                        const { entry: saved } = await params.consolidateInto.create(entry);
+                        await eventTranslator.emitEvent({
+                            type: 'memory_consolidated',
+                            runId: ctx.runId,
+                            memoryId: saved.id,
+                            title: entry.title,
+                            decisions: workingStateManager.getState().decisions.length,
+                            discoveries: workingStateManager.getState().discoveries.length,
+                            failures: workingStateManager.getState().failures.length,
+                        });
+                        yield* eventTranslator.drainPending();
+                    }
+                    catch (error) {
+                        ctx.log.warn('consolidation into the memory store failed', {
+                            [NAMZU.RUN_ID]: ctx.runId,
+                            'namzu.memory.error': toErrorMessage(error),
+                        });
+                    }
+                }
+            }
             yield* resultAssembler.completeRun(rootSpan);
         }
         catch (err) {
@@ -1739,7 +1827,10 @@ export async function* query(params) {
             //
             // Awaited, and its failure swallowed. A job that would not die is
             // worth a log line, and is not worth retracting a run's answer.
-            if (params.backgroundJobs) {
+            unsubscribeJobExits?.();
+            // Only jobs bound to this run. Jobs a host bound to its session are
+            // the host's to stop, when the session ends.
+            if (params.backgroundJobs && (params.backgroundJobOwner ?? ctx.runId) === ctx.runId) {
                 try {
                     const stopped = await params.backgroundJobs.killOwner(ctx.runId);
                     if (stopped.length > 0) {
@@ -1819,6 +1910,15 @@ export async function* query(params) {
  * either way — a stale cursor belongs to the client, and must not be able to
  * stop the work.
  */
+/** The text of the newest user turn, which is what a prompt hook is asked about. */
+function lastUserPrompt(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (m?.role === 'user' && typeof m.content === 'string')
+            return m.content;
+    }
+    return '';
+}
 async function* catchUpFromCursor(runMgr, cursor, onEventReplay, generation, onReplayObserverError) {
     const missed = await runMgr.getRunStore().readEvents({ sinceSeq: cursor.sinceSeq });
     const replay = resolveRunEventReplay(cursor, {