@intentic/sandbox-contract 1.310.0 → 1.311.0

package/dist/time/zone.d.ts

@@ -22,6 +22,7 @@ export interface WallRule {
 export declare const cronOptions: (tz: Zone) => {
     timezone: string;
 };
+export declare const nextDayStartIn: (at: number, zone: Zone) => number;
 export declare const sameClock: (a: Zone, b: Zone, at?: number) => boolean;
 export declare const zoneLabel: (rule: Zone, reader: Zone, at?: number) => string | undefined;
 //# sourceMappingURL=zone.d.ts.map

package/dist/time/zone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../../src/time/zone.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAGzD,eAAO,MAAM,GAAG,EAAY,IAAI,CAAC;AASjC,eAAO,MAAM,MAAM,UAAW,MAAM,KAAG,KAAK,IAAI,IAS/C,CAAC;AAGF,eAAO,MAAM,MAAM,UAAW,MAAM,GAAG,SAAS,KAAG,IAAI,GAAG,SAAuE,CAAC;AAIlI,eAAO,MAAM,UAAU,+EAAkG,CAAC;AAM1H,eAAO,MAAM,SAAS,QAAO,IAAgE,CAAC;AAO9F,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE,eAAO,MAAM,cAAc,aAA2E,CAAC;AAGvG,eAAO,MAAM,UAAU,OAAQ,MAAM,QAAQ,IAAI,KAAG,QAC8E,CAAC;AAGnI,eAAO,MAAM,QAAQ,OAAQ,MAAM,KAAG,QAA+D,CAAC;AAStG,eAAO,MAAM,WAAW,OAAQ,MAAM,QAAQ,IAAI,KAAG,MAG5B,CAAC;AAG1B,eAAO,MAAM,UAAU,UAAW,MAAM,GAAG,SAAS,KAAG,QAAQ,GAAG,SAAyG,CAAC;AAO5K,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;CACrB;AAGD,eAAO,MAAM,WAAW,OAAQ,IAAI,KAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAwB,CAAC;AAclF,eAAO,MAAM,SAAS,MAAO,IAAI,KAAK,IAAI,OAAM,MAAM,KAAgB,OAAmE,CAAC;AAM1I,eAAO,MAAM,SAAS,SAAU,IAAI,UAAU,IAAI,OAAM,MAAM,KAAgB,MAAM,GAAG,SAAgF,CAAC"}
+{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../../src/time/zone.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAGzD,eAAO,MAAM,GAAG,EAAY,IAAI,CAAC;AASjC,eAAO,MAAM,MAAM,UAAW,MAAM,KAAG,KAAK,IAAI,IAS/C,CAAC;AAGF,eAAO,MAAM,MAAM,UAAW,MAAM,GAAG,SAAS,KAAG,IAAI,GAAG,SAAuE,CAAC;AAIlI,eAAO,MAAM,UAAU,+EAAkG,CAAC;AAM1H,eAAO,MAAM,SAAS,QAAO,IAAgE,CAAC;AAO9F,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE,eAAO,MAAM,cAAc,aAA2E,CAAC;AAGvG,eAAO,MAAM,UAAU,OAAQ,MAAM,QAAQ,IAAI,KAAG,QAC8E,CAAC;AAGnI,eAAO,MAAM,QAAQ,OAAQ,MAAM,KAAG,QAA+D,CAAC;AAStG,eAAO,MAAM,WAAW,OAAQ,MAAM,QAAQ,IAAI,KAAG,MAG5B,CAAC;AAG1B,eAAO,MAAM,UAAU,UAAW,MAAM,GAAG,SAAS,KAAG,QAAQ,GAAG,SAAyG,CAAC;AAO5K,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;CACrB;AAGD,eAAO,MAAM,WAAW,OAAQ,IAAI,KAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAwB,CAAC;AAclF,eAAO,MAAM,cAAc,OAAQ,MAAM,QAAQ,IAAI,KAAG,MAIvD,CAAC;AAGF,eAAO,MAAM,SAAS,MAAO,IAAI,KAAK,IAAI,OAAM,MAAM,KAAgB,OAAmE,CAAC;AAM1I,eAAO,MAAM,SAAS,SAAU,IAAI,UAAU,IAAI,OAAM,MAAM,KAAgB,MAAM,GAAG,SAAgF,CAAC"}

package/dist/time/zone.js

@@ -30,6 +30,11 @@ const offsetMinutes = (at, zone) => {
     }
     return (match[1] === "-" ? -1 : 1) * (Number(match[2]) * 60 + Number(match[3]));
 };
+export const nextDayStartIn = (at, zone) => {
+    const [year = 0, month = 1, day = 1] = civilDayIn(at, zone).split("-").map(Number);
+    const midnightUtc = Date.UTC(year, month - 1, day + 1);
+    return midnightUtc - offsetMinutes(midnightUtc, zone) * 60_000;
+};
 export const sameClock = (a, b, at = Date.now()) => a === b || offsetMinutes(at, a) === offsetMinutes(at, b);
 export const zoneLabel = (rule, reader, at = Date.now()) => (sameClock(rule, reader, at) ? undefined : rule.replace(/_/g, " "));
 //# sourceMappingURL=zone.js.map

package/dist/time/zone.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentic/sandbox-contract",
-  "version": "1.310.0",
+  "version": "1.311.0",
   "description": "oRPC wire contract for the intentic sandbox daemon, shared by the daemon and its browser client",
   "license": "MIT",
   "type": "module",
@@ -150,6 +150,17 @@
         "default": "./dist/policy/owner-ticket.js"
       }
     },
+    "./front-wire": {
+      "types": "./dist/front/generated/wire.d.ts",
+      "import": {
+        "@intentic/src": "./src/front/generated/wire.ts",
+        "default": "./dist/front/generated/wire.js"
+      },
+      "require": {
+        "@intentic/src": "./src/front/generated/wire.ts",
+        "default": "./dist/front/generated/wire.js"
+      }
+    },
     "./ingress-protocol": {
       "types": "./dist/protocol/ingress-protocol.d.ts",
       "import": {
@@ -240,10 +251,10 @@
     }
   },
   "dependencies": {
-    "@intentic/base": "1.310.0",
-    "@intentic/constants": "1.310.0",
-    "@intentic/extension-manifest": "1.310.0",
-    "@intentic/registry": "1.310.0",
+    "@intentic/base": "1.311.0",
+    "@intentic/constants": "1.311.0",
+    "@intentic/extension-manifest": "1.311.0",
+    "@intentic/registry": "1.311.0",
     "@orpc/contract": "1.14.13",
     "tslib": "2.8.1",
     "zod": "4.5.4"

package/src/contracts/agents.contract.ts

@@ -1,7 +1,6 @@
 import { procedure } from "../protocol/route-meta.js";
 import { AgentToolChildrenSchema, AgentTranscriptSchema } from "../events/transcript.js";
 import {
-    AgentArchiveSchema,
     AgentAssignSchema,
     AgentAutoLandSchema,
     AgentBreakPolicySchema,
@@ -27,6 +26,7 @@ import { AgentsListSchema } from "../schemas/automations.js";
 import { AgentChangesSchema, AgentScratchSchema, AgentHistorySchema } from "../schemas/git/git.js";
 import { FileDiffSchema } from "../schemas/history.js";
 import { OkSchema } from "../schemas/shared.js";
+import { AgentKeepWarmSchema } from "../schemas/keep-warm.js";
 import { ConversationPromptSchema } from "../schemas/system-prompt.js";
 
 // Every registered conversation-agent (AgentSummarySchema); an unknown {id} is NOT_FOUND across this whole family.
@@ -151,6 +151,18 @@ export const agentsContract = {
         .meta({ floor: "collaborator" })
         .input(AgentBreakPolicySchema)
         .output(AgentSummarySchema),
+    // Legal for a workspace conversation too, and only between turns in effect: a turn starting ends the hold.
+    keepWarm: procedure
+        .route({
+            method: "POST",
+            path: "/agents/{id}/keep-warm",
+            summary: "Keep this conversation's prompt cache warm while it sits idle",
+            description:
+                "Re-reads the conversation's cached context shortly before the provider would drop it, until the time asked for, so picking it back up costs a cache read instead of re-sending everything. Each refresh is a forked, unsaved request that adds nothing to the conversation. Stops by itself when the time runs out, when a turn starts, when the account nears its limit, or when the prompt the next turn would send has changed. Refused for a conversation whose cache is already cold or that this sandbox cannot replay. Null stops it.",
+        })
+        .meta({ floor: "collaborator" })
+        .input(AgentKeepWarmSchema)
+        .output(AgentSummarySchema),
     seen: procedure
         .route({
             method: "POST",
@@ -306,7 +318,7 @@ export const agentsContract = {
                 "The gentle counterpart to discarding. Commits whatever the conversation still has in progress onto its own branch, releases its working copy, and keeps the entry and the record. Its scratch is not committed and goes with the copy. It leaves the live fleet and joins the archive. Refused for a conversation that is running.",
         })
         .meta({ floor: "collaborator", guest: true })
-        .input(AgentArchiveSchema)
+        .input(AgentIdsSchema)
         .output(AgentsArchivedSchema),
     unarchive: procedure
         .route({

package/src/events/agent-events.ts

@@ -4,6 +4,7 @@ import { LandConflictSchema } from "../schemas/agents.js";
 import { ContextTrimSchema } from "../schemas/context-trim.js";
 import { RateLimitInfoSchema } from "../schemas/providers/claude-gate.js";
 import { FastModeStateSchema } from "../schemas/providers/fast-mode.js";
+import { PromptCacheOpeningSchema, PromptFingerprintSchema } from "../schemas/keep-warm.js";
 import { AgentReplySchema, UsageWindowSchema } from "../schemas/providers/plan-limits.js";
 import { SubagentKindSchema, SubagentStatusSchema, SubagentVerificationSchema } from "../schemas/terminal.js";
 import { RetryLadderSchema } from "../schemas/turn-break.js";
@@ -50,7 +51,8 @@ export const AgentEventSchema = z.discriminatedUnion("kind", [
     // message to be drawn beside, so this is the only place the reader can learn the turn ran thin.
     ContextTrimSchema.extend({ kind: z.literal("context_trim") }),
     // The SDK's init handshake; carries the model it actually resolved for the turn.
-    z.object({ kind: z.literal("init"), model: z.string() }),
+    // `prompt` names the parts the cache is keyed on, so a later turn can say which of them changed.
+    z.object({ kind: z.literal("init"), model: z.string(), prompt: PromptFingerprintSchema.optional() }),
     // The pre-turn snapshot id, emitted once before the provider stream so the client can offer
     // restore-to-before-this-message. Absent on an isolated turn or when the tree was already clean.
     // `index` is the message's position in the transcript, which the rewind route addresses by; absent on a turn with
@@ -139,7 +141,13 @@ export const AgentEventSchema = z.discriminatedUnion("kind", [
         cacheCreationTokens: z.number().optional(),
         durationMs: z.number().optional(),
         numTurns: z.number().optional(),
+        // The stream's first request only; a sum of frames keeps the first frame's, never adds them.
+        openingCacheReadTokens: z.number().optional(),
+        openingCacheCreationTokens: z.number().optional(),
+        promptFingerprint: z.string().optional(),
     }),
+    // What the turn's first request found in the prompt cache, sent as soon as it is known.
+    PromptCacheOpeningSchema.extend({ kind: z.literal("prompt_cache") }),
     // The provider's live answer to whether this turn may run, pushed mid-turn; drives the rate-limited notice, not the
     // headroom readouts.
     RateLimitInfoSchema.extend({ kind: z.literal("rate_limit_info"), account: z.string().optional() }),

package/src/events/transcript.ts

@@ -311,8 +311,9 @@ export const holdsRequest = (row: TranscriptRequests): boolean => REQUEST_FIELDS
 // Whether a row is holding the turn open on a card nobody has answered.
 export const isAwaitingDecision = (row: TranscriptRequests): boolean => REQUEST_FIELDS.some((field) => row[field]?.status === "pending");
 
-// One change to a run's rows, so a client keeps rows rather than frames. Prose/thinking append to a row; a `tool` card
-// replaces whole by id; everything else replaces its row; `drop` removes a row that opened and never wrote.
+// One change to a run's rows, so a client keeps rows rather than frames. Prose/thinking append to a row or a card; a
+// `tool` card replaces its own fields by id, never its nested calls or thinking, which arrive by their own patches;
+// everything else replaces its row; `drop` removes a row that opened and never wrote.
 export const TranscriptPatchSchema = z.discriminatedUnion("op", [
     z.object({ op: z.literal("append").describe("A new row at the end."), row: TranscriptRowSchema }),
     z.object({ op: z.literal("replace").describe("This row, whole, in place of the one at that index."), index: z.number().int().nonnegative(), row: TranscriptRowSchema }),
@@ -320,7 +321,17 @@ export const TranscriptPatchSchema = z.discriminatedUnion("op", [
     z.object({ op: z.literal("text").describe("More of the agent's prose, onto that row's text."), index: z.number().int().nonnegative(), text: z.string() }),
     z.object({ op: z.literal("thinking").describe("More of the agent's reasoning, onto that row's thinking."), index: z.number().int().nonnegative(), text: z.string() }),
     z.object({
-        op: z.literal("tool").describe("A tool card, whole: new, or the latest state of one already there, matched by id wherever it nests."),
+        op: z.literal("toolThinking").describe("More of a delegated subagent's reasoning, onto the thinking of the card that started it."),
+        index: z.number().int().nonnegative(),
+        id: z.string().describe("The card's id, matched wherever it nests."),
+        text: z.string(),
+    }),
+    z.object({
+        op: z
+            .literal("tool")
+            .describe(
+                "A tool card's own fields: new, or the latest state of one already there, matched by id wherever it nests. Carries no `children` or `thinking`; a card already there keeps its own.",
+            ),
         index: z.number().int().nonnegative(),
         tool: TranscriptToolSchema,
         parent: z.string().optional().describe("The card this one nests under, when it is a delegated subagent's own call."),

package/src/front/generated/wire.ts

@@ -0,0 +1,73 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type Answer = { "answer": "preview", route: PreviewRoute, };
+
+/**
+ * A PEM certificate chain and its PEM private key.
+ */
+export type Certificate = { certificate: string, privateKey: string, };
+
+export type Endpoint = { host: string, port: number, };
+
+/**
+ * Everything Node sends the front.
+ */
+export type FromNode = { "kind": "hello", build: string, pid: number, } | { "kind": "listen", config: ListenConfig, } | { "kind": "certificate", certificate?: Certificate, } | { "kind": "tunnel", tunnel?: TunnelConfig, } | { "kind": "answer", id: number, answer: Answer, } | { "kind": "refused", id: number, message: string, };
+
+/**
+ * Request headers only the front sets on what it forwards to Node; it strips them from everything arriving outside.
+ * Exported as a literal type, so a Node constant naming one that drifts from this spelling fails to compile.
+ */
+export type FrontHeader = "x-intentic-preview" | "x-intentic-preview-unreachable";
+
+/**
+ * Every port the front binds, as Node's config names them; an absent one is not bound.
+ */
+export type ListenConfig = { daemon: Endpoint, preview?: Endpoint, loopback?: Endpoint, 
+/**
+ * The 12-hex id every public hostname ends in; without one, a label's prefix alone classifies it.
+ */
+sandboxId?: string, 
+/**
+ * Origins that may frame a preview besides the preview itself.
+ */
+frameAncestors: Array<string>, 
+/**
+ * A preview path Node answers whatever its host resolves to.
+ */
+previewProbePath: string, };
+
+/**
+ * Where a preview host's requests go, as Node resolved it.
+ */
+export type PreviewRoute = { "to": "upstream", upstream: Upstream, } | { "to": "node" };
+
+/**
+ * A question the front asks Node; the answer carries the same id.
+ */
+export type Question = { "question": "preview", host: string, };
+
+export type Scheme = "http" | "https";
+
+/**
+ * Everything the front sends Node.
+ */
+export type ToNode = { "kind": "ask", id: number, question: Question, } | { "kind": "tunnel", connected: boolean, };
+
+/**
+ * The ingress tunnel's door and the reachability grant it presents there.
+ */
+export type TunnelConfig = { url: string, grant: string, };
+
+/**
+ * A local upstream a preview host relays to.
+ */
+export type Upstream = { host: string, port: number, scheme: Scheme, 
+/**
+ * Rewrites Host and Origin to `localhost:<port>`, for an app that never agreed to its preview name.
+ */
+localhost: boolean, 
+/**
+ * Framed by the editor: `frame-ancestors` is set and `x-frame-options` dropped.
+ */
+frameable: boolean, };

package/src/ids/hostnames.fixture.json

@@ -0,0 +1,20 @@
+[
+    { "host": "preview-web-abcdef012345.sbx.example.test", "sandboxId": "abcdef012345", "panel": "web" },
+    { "host": "preview-my-app-abcdef012345.sbx.example.test:443", "sandboxId": "abcdef012345", "panel": "my-app" },
+    { "host": "preview-shop--web-abcdef012345.example.com", "sandboxId": "abcdef012345", "panel": "shop--web" },
+    { "host": "preview-web-0123456789ab.sbx.example.test", "sandboxId": "abcdef012345" },
+    { "host": "preview--abcdef012345.sbx.example.test", "sandboxId": "abcdef012345" },
+    { "host": "preview-x-abcdef012345.sbx.example.test", "sandboxId": "abcdef012345", "panel": "x" },
+    { "host": "port-1a2b3c4d5e6f-abcdef012345.sbx.example.test:8443", "sandboxId": "abcdef012345", "port": "1a2b3c4d5e6f" },
+    { "host": "public-9f8e7d6c5b4a-abcdef012345.sbx.example.test", "sandboxId": "abcdef012345", "public": "9f8e7d6c5b4a" },
+    { "host": "sandbox-abcdef012345.sbx.example.test", "sandboxId": "abcdef012345" },
+    { "host": "app.example.com", "sandboxId": "abcdef012345" },
+    { "host": "preview-web.localhost:8788", "panel": "web" },
+    { "host": "port-a.localhost", "port": "a" },
+    { "host": "public-z.example.com", "public": "z" },
+    { "host": "preview-.localhost" },
+    { "host": "127.0.0.1:8788" },
+    { "host": "[::1]:8788" },
+    { "host": "" },
+    { "host": "Preview-web-abcdef012345.sbx.example.test", "sandboxId": "abcdef012345" }
+]

package/src/ids/hostnames.test.ts

@@ -1,3 +1,4 @@
+import { readFileSync } from "node:fs";
 import {
     labelHostname,
     panelFromHost,
@@ -8,6 +9,7 @@ import {
     previewHostname,
     previewLabel,
     previewUrl,
+    publicSlotFromHost,
     sandboxHostname,
     sandboxIdFromUrl,
     syncFolder,
@@ -15,6 +17,24 @@ import {
 
 const ID = "abc123def456";
 
+// The cases the front's Rust router is held to as well (_sandbox/front, route.rs), read from the one file both run.
+interface HostCase {
+    readonly host: string;
+    readonly sandboxId?: string;
+    readonly panel?: string;
+    readonly port?: string;
+    readonly public?: string;
+}
+const HOST_CASES = JSON.parse(readFileSync(new URL("./hostnames.fixture.json", import.meta.url), "utf8")) as HostCase[];
+
+test.each(HOST_CASES)("the shared host cases parse as the front parses them: $host", (hostCase) => {
+    expect({
+        panel: panelFromHost(hostCase.host, hostCase.sandboxId),
+        port: portSlotFromHost(hostCase.host, hostCase.sandboxId),
+        public: publicSlotFromHost(hostCase.host, hostCase.sandboxId),
+    }).toEqual({ panel: hostCase.panel, port: hostCase.port, public: hostCase.public });
+});
+
 test("preview and port hostnames round-trip through their Host-header parsers", () => {
     expect(panelFromHost(`${previewHostname("shop--web", ID, "example.com")}:443`, ID)).toBe("shop--web");
     expect(portSlotFromHost(`${portHostname("a", ID, "example.com")}:443`, ID)).toBe("a");

package/src/index.ts

@@ -216,6 +216,7 @@ export * from "./schemas/system-prompt.js";
 export * from "./schemas/system.js";
 export * from "./schemas/terminal.js";
 export * from "./schemas/turn-break.js";
+export * from "./schemas/keep-warm.js";
 export * from "./schemas/providers/usage.js";
 export * from "./schemas/vpn.js";
 export * from "./schemas/webext.js";

package/src/policy/command-run.test.ts

@@ -0,0 +1,35 @@
+import type { CommandRun } from "../schemas/ci.js";
+import { followCommandRun } from "./command-run.js";
+
+const RUNNING: CommandRun = { status: "running", command: "pnpm test", output: "" };
+const PASSED: CommandRun = { status: "passed", command: "pnpm test", output: "ok" };
+
+test("a poll that fails is reported and retried, and the run is still followed to its verdict", async () => {
+    const answers: Array<CommandRun | Error> = [new Error("daemon restarting"), RUNNING, PASSED];
+    const errors: unknown[] = [];
+    const settled = await followCommandRun(
+        async () => {
+            const next = answers.shift();
+            if (next instanceof Error) {
+                throw next;
+            }
+            return next as CommandRun;
+        },
+        { intervalMs: 1, onError: (cause) => errors.push(cause) },
+    );
+    expect(settled).toEqual(PASSED);
+    expect(errors).toEqual([new Error("daemon restarting")]);
+});
+
+test("a throw from onState is the caller's bug and reaches the caller, not a poll failure retried forever", async () => {
+    const errors: unknown[] = [];
+    const following = followCommandRun(async () => RUNNING, {
+        intervalMs: 1,
+        onState: () => {
+            throw new TypeError("state.session is undefined");
+        },
+        onError: (cause) => errors.push(cause),
+    });
+    await expect(following).rejects.toThrow("state.session is undefined");
+    expect(errors).toEqual([]);
+});

package/src/policy/command-run.ts

@@ -10,8 +10,9 @@ export interface FollowRunOptions<R extends CommandRun> {
     readonly signal?: AbortSignal | undefined;
     // Every state read, settled or not, for a surface that draws progress.
     readonly onState?: ((run: R) => void) | undefined;
-    // A poll that failed, not a run that failed: the run is still going, and following continues.
-    readonly onError?: ((cause: unknown) => void) | undefined;
+    // A poll that failed, not a run that failed: the run is still going, and following continues. Required, since a
+    // loop that retries a failing read forever with nobody told looks exactly like a run that is still going.
+    readonly onError: (cause: unknown) => void;
 }
 
 // Follows a run to its verdict: reads state until it is no longer running. The one shared loop, so a dropped poll isn't
@@ -22,14 +23,18 @@ export const followCommandRun = async <R extends CommandRun>(read: () => Promise
         if (signal?.aborted === true) {
             return undefined;
         }
+        // Only the read is a poll that may fail and be retried; a throw from `onState` is the caller's own bug.
+        let run: R | undefined;
         try {
-            const run = await read();
+            run = await read();
+        } catch (cause) {
+            onError(cause);
+        }
+        if (run !== undefined) {
             onState?.(run);
             if (run.status !== "running") {
                 return run;
             }
-        } catch (cause) {
-            onError?.(cause);
         }
         await sleep(intervalMs, { signal });
     }

package/src/protocol/ingress-protocol.test.ts

@@ -148,9 +148,25 @@ const target = createServer((request: IncomingMessage, response: ServerResponse)
 
 const cancelled = gate<string>();
 
+// `/late` holds its handshake until released, so the session can die while the loopback upgrade is still pending.
+const lateArrived = gate();
+const lateReleased = gate();
+let lateTornDown = false;
+
 // Hand-written HTTP/1.1 upgrade carrying the 101 head plus the raw bytes after it. `/refuse` answers instead of
 // upgrading.
 target.on("upgrade", (request: IncomingMessage, socket: Duplex, head: Buffer) => {
+    if ((request.url ?? "") === "/late") {
+        socket.on("error", () => {});
+        socket.on("close", () => (lateTornDown = true));
+        lateArrived.open();
+        void lateReleased.opened.then(() => {
+            if (!socket.destroyed) {
+                socket.write("HTTP/1.1 101 Switching Protocols\r\nUpgrade: websocket\r\nConnection: Upgrade\r\n\r\n");
+            }
+        });
+        return;
+    }
     if ((request.url ?? "") === "/refuse") {
         socket.end("HTTP/1.1 404 Not Found\r\nContent-Type: text/plain\r\nContent-Length: 7\r\n\r\nno dice");
         return;
@@ -179,7 +195,7 @@ target.on("upgrade", (request: IncomingMessage, socket: Duplex, head: Buffer) =>
 // One session; every request is routed through it.
 const front = async (
     targetPort: number,
-): Promise<{ readonly server: Server; readonly poison: (bytes: Buffer) => void; readonly close: () => void }> => {
+): Promise<{ readonly server: Server; readonly poison: (bytes: Buffer) => void; readonly sever: () => void; readonly close: () => void }> => {
     const [edgeSide, daemonSide] = duplexPair();
     const daemon = await serveIngressSession(daemonSide, { targetPort });
     const session = await openIngressSession(edgeSide);
@@ -202,6 +218,8 @@ const front = async (
         server,
         // Writes garbage onto the wire the edge reads, simulating a wedged or corrupted peer.
         poison: (bytes: Buffer) => void daemonSide.write(bytes),
+        // Cuts the tunnel under the daemon, which takes its h2 session and every stream on it down.
+        sever: () => void daemonSide.destroy(),
         close: () => {
             session.close();
             daemon.close();
@@ -439,6 +457,32 @@ test("a browser that gives up cancels the stream all the way to the target", asy
     await expect(cancelled.opened).resolves.toBe("aborted");
 });
 
+// The handshake lands after its stream is gone: answering it throws ERR_HTTP2_INVALID_STREAM from an event callback.
+test("a session that dies mid-handshake tears the loopback upgrade down instead of answering into a dead stream", async () => {
+    const own = await front((target.address() as AddressInfo).port);
+    const ownPort = await listen(own.server);
+    const request = h1Request({
+        host: "127.0.0.1",
+        port: ownPort,
+        path: "/late",
+        headers: { host: HOST, connection: "Upgrade", upgrade: "websocket", "sec-websocket-key": "x" },
+        agent: false,
+    });
+    request.on("error", () => {});
+    request.end();
+    await lateArrived.opened;
+
+    own.sever();
+    await new Promise((resolve) => setTimeout(resolve, 250));
+    lateReleased.open();
+
+    await waitFor(() => expect(lateTornDown).toBe(true));
+    await new Promise((resolve) => setTimeout(resolve, 50));
+    expect(uncaught).toStrictEqual([]);
+    request.destroy();
+    own.close();
+});
+
 test("a tunnel whose target is not listening fails the exchange rather than answering for it", async () => {
     const dead = createServer();
     const deadPort = await listen(dead);

package/src/protocol/ingress-protocol.ts

@@ -10,9 +10,9 @@ import {
 import { type AddressInfo, createServer as createNetServer, connect as netConnect, type Socket } from "node:net";
 import { Duplex } from "node:stream";
 
-// Both ends of the ingress tunnel's h2 session, over any node Duplex, in one file: a wire format with two owners
-// drifts. h2 gives multiplexing and backpressure for free; routing is per h2 stream, since one edge connection can
-// interleave several sandboxes' hosts.
+// Both halves of the ingress tunnel's h2 session over any node Duplex, in one file so the wire has one owner: the edge's,
+// and a daemon half its suites dial (a sandbox runs the Rust one, _sandbox/front tunnel.rs, held to this by its test).
+// Routing is per h2 stream, since one edge connection can interleave several sandboxes' hosts.
 
 // Header hygiene
 
@@ -308,7 +308,7 @@ export const openIngressSession = async (duplex: Duplex): Promise<IngressSession
     };
 };
 
-// The daemon half: an h2 server over the tunnel, onto the loopback listener
+// The daemon half the edge's suites dial: an h2 server over the tunnel, onto a local listener
 
 export interface ServeIngressSessionOptions {
     // The daemon's own listener; every stream lands there as a plain HTTP/1.1 request or upgrade.
@@ -340,6 +340,10 @@ export const serveIngressSession = async (duplex: Duplex, options: ServeIngressS
     server.on("error", () => duplex.destroy());
     server.on("session", (session) => session.setLocalWindowSize(CONNECTION_WINDOW_SIZE));
 
+    // The loopback's answer can outlive its stream when the session dies, and respond/write on a dead stream throws
+    // ERR_HTTP2_INVALID_STREAM from an event callback, where nothing catches it.
+    const gone = (stream: ServerHttp2Stream): boolean => stream.destroyed || stream.closed;
+
     const forwardToLoopback = (stream: ServerHttp2Stream, headers: IncomingHttpHeaders): void => {
         const local = h1Request({
             host: LOOPBACK,
@@ -353,6 +357,10 @@ export const serveIngressSession = async (duplex: Duplex, options: ServeIngressS
         });
         stream.pipe(local);
         local.on("response", (response) => {
+            if (gone(stream)) {
+                response.destroy();
+                return;
+            }
             stream.respond({ [constants.HTTP2_HEADER_STATUS]: response.statusCode ?? 502, ...endToEnd(response.headers) });
             response.pipe(stream);
         });
@@ -364,6 +372,9 @@ export const serveIngressSession = async (duplex: Duplex, options: ServeIngressS
         // means this — on a reset, node fires `aborted` before `finish` and `close`, so a
         // `writableEnded`/`writableFinished` guard there would miss it.
         stream.on("aborted", () => local.destroy());
+        // `aborted` fires only while the stream's writable side is open; `close` covers every other way it dies, and a
+        // request whose answer already completed ignores the destroy.
+        stream.on("close", () => local.destroy());
     };
 
     const spliceUpgrade = (stream: ServerHttp2Stream, headers: IncomingHttpHeaders): void => {
@@ -372,6 +383,10 @@ export const serveIngressSession = async (duplex: Duplex, options: ServeIngressS
         // pool the request path above uses.
         const local = h1Request({ host: LOOPBACK, port: options.targetPort, method: head.method, path: head.path, headers: head.headers, agent: false });
         local.on("upgrade", (response, socket, first) => {
+            if (gone(stream)) {
+                socket.destroy();
+                return;
+            }
             stream.respond({ [constants.HTTP2_HEADER_STATUS]: constants.HTTP_STATUS_OK });
             // Response head written verbatim (see serializeHead), then any bytes already sent past it, then the pipe.
             stream.write(serializeHead(response, NOTHING_DROPPED, []));
@@ -383,11 +398,17 @@ export const serveIngressSession = async (duplex: Duplex, options: ServeIngressS
         // The local server declined to upgrade; its answer goes to the browser with framing that matches the already
         // de-chunked body.
         local.on("response", (response) => {
+            if (gone(stream)) {
+                response.destroy();
+                return;
+            }
             stream.respond({ [constants.HTTP2_HEADER_STATUS]: constants.HTTP_STATUS_OK });
             stream.write(serializeHead(response, DECLINED_UPGRADE_DROP, DECLINED_UPGRADE_ADD));
             response.pipe(stream);
         });
         local.on("error", () => stream.close(constants.NGHTTP2_CONNECT_ERROR));
+        // Before the handshake answers, nothing else ties the loopback request to the stream; once spliced, a no-op.
+        stream.on("close", () => local.destroy());
         // An upgrade request carries no body; the client is waiting on the handshake before it says anything else.
         local.end();
     };

package/src/schemas/agents.ts

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { AgentHarnessSchema, AgentOriginSchema, AgentProviderSchema, ConversationQueueSchema, ForkedFromSchema } from "./agent.js";
 import { LoopStateSchema } from "./loops.js";
 import { LimitPolicySchema, RetryPolicySchema, TurnBreakPolicySchema, TurnBreakSchema } from "./turn-break.js";
+import { KeepWarmSchema } from "./keep-warm.js";
 import { EMOJI_MAX_LENGTH, isSingleEmoji } from "../text/emoji.js";
 // A fleet agent is any conversation with a registry entry, keyed by conversationId. Isolated ones own a git worktree
 // (branch agent/<id>); workspace conversations have none, but both share one status/activity/cost lifecycle.
@@ -329,11 +330,24 @@ export const AgentSummarySchema = z.object({
         .object({
             at: z.number().describe("When its last request touched the provider's prompt cache, in milliseconds."),
             ttlMs: z.number().describe("How long that entry lives from `at`, in milliseconds."),
+            rollsAt: z
+                .number()
+                .optional()
+                .describe(
+                    "When the date written into the agent's prompt next changes, in milliseconds (midnight where the agent runs). Past it the next turn sends a different prompt, so nothing kept before it is read again.",
+                ),
+            keepable: z
+                .boolean()
+                .optional()
+                .describe("Whether this sandbox can keep this cache warm: it holds the last turn's exact request to replay, on a Claude subscription account."),
         })
         .optional()
         .describe(
             "When this conversation's prompt cache was last kept alive and how long it lasts, which together say when picking the conversation up stops being cheap. Absent when the provider publishes nothing to ground it on.",
         ),
+    keepWarm: KeepWarmSchema.optional().describe(
+        "Whether the sandbox is keeping this conversation's prompt cache warm while it sits idle, how that is going, or why it stopped. Absent when nobody asked for it.",
+    ),
     activity: AgentActivitySchema.optional().describe("What it is doing at this moment."),
     // Beside `activity` because both answer "where is it", one in a sentence and one as a fraction. Live while a turn
     // runs, and left standing after it, so a settled card still says how far the work got.
@@ -517,13 +531,6 @@ export const AgentToolChildrenQuerySchema = AgentIdSchema.extend({
     toolId: z.string().min(1).describe("Which tool call, by the id its card carries."),
 });
 // Absent `ids` archives every archivable finished agent (the lane's "Clear"); unarchive always names its own ids.
-export const AgentArchiveSchema = z.object({
-    ids: z
-        .array(z.string().min(1))
-        .max(500)
-        .optional()
-        .describe("Which conversations to put away. Leave it out for every finished one that can be archived right now."),
-});
 export const AgentIdsSchema = z.object({ ids: z.array(z.string().min(1)).min(1).max(500).describe("Which conversations.") });
 // What actually moved, not the roster afterward: two archives finishing at once would otherwise let a slower snapshot
 // resurrect what a faster one just filed away. Whole summaries, since the receiving surfaces (archive list, detail

package/src/schemas/capabilities.ts

@@ -354,6 +354,12 @@ export const CapabilityStatusSchema = z.object({
     state: CapabilityStateSchema.describe("Whether it is live, still coming up, broken, or switched off."),
     detail: z.string().optional().describe("What is wrong, in words a person can act on."),
     code: z.string().optional().describe("A short marker for that reason, for anything deciding what to do about it."),
+    settling: z
+        .boolean()
+        .optional()
+        .describe(
+            "True while something under way will move this on its own: a start, a download, a pairing code waiting to be typed. Absent when only a person can move it, or a pushed change will say when it moved.",
+        ),
 });
 export type CapabilityStatus = z.infer<typeof CapabilityStatusSchema>;
 // The list row: manifest entry plus live status, secrets never returned. `secrets` names which config keys hold a