@intentic/sandbox-contract 1.226.0 → 1.227.0

package/dist/contracts/activity.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/activity.contract.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB;IACzB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACJ,MAAM;;;;;;;;;;;;;;;;;;;;CACT,CAAC"}
+{"version":3,"file":"activity.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/activity.contract.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB;IACzB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUJ,MAAM;;;;;;;;;;;;;;;;;;;;CAQT,CAAC"}

package/dist/contracts/activity.contract.js

@@ -1,7 +1,22 @@
 import { oc } from "@orpc/contract";
 import { ActivityListSchema, ActivityQuerySchema, ActivityStatusSchema } from "../schemas.js";
 export const activityContract = {
-    list: oc.route({ method: "GET", path: "/activity" }).input(ActivityQuerySchema).output(ActivityListSchema),
-    status: oc.route({ method: "GET", path: "/activity/status" }).output(ActivityStatusSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/activity",
+        summary: "What the agent has done out in the world",
+        description: "The audit trail of actions taken on outside services. Read-only on purpose: entries are written by the sandbox alone, which is what makes it a record worth trusting.",
+    })
+        .input(ActivityQuerySchema)
+        .output(ActivityListSchema),
+    status: oc
+        .route({
+        method: "GET",
+        path: "/activity/status",
+        summary: "Whether the audit trail is being kept",
+        description: "Which sources are feeding the record and whether each is working.",
+    })
+        .output(ActivityStatusSchema),
 };
 //# sourceMappingURL=activity.contract.js.map

package/dist/contracts/activity.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.contract.js","sourceRoot":"","sources":["../../src/contracts/activity.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAI9F,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAC1G,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC;CAC7F,CAAC"}
+{"version":3,"file":"activity.contract.js","sourceRoot":"","sources":["../../src/contracts/activity.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAI9F,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,0CAA0C;QACnD,WAAW,EACP,uKAAuK;KAC9K,CAAC;SACD,KAAK,CAAC,mBAAmB,CAAC;SAC1B,MAAM,CAAC,kBAAkB,CAAC;IAC/B,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,uCAAuC;QAChD,WAAW,EAAE,mEAAmE;KACnF,CAAC;SACD,MAAM,CAAC,oBAAoB,CAAC;CACpC,CAAC"}

package/dist/contracts/agent.contract.d.ts

@@ -45,6 +45,7 @@ export declare const agentContract: {
         effort: import("zod").ZodOptional<import("zod").ZodString>;
         thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
         fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
         editorContext: import("zod").ZodOptional<import("zod").ZodObject<{
             file: import("zod").ZodString;
             startLine: import("zod").ZodOptional<import("zod").ZodNumber>;
@@ -231,6 +232,14 @@ export declare const agentContract: {
             kind: "fast_mode";
             state: "cooldown" | "off" | "on";
             reason?: string | undefined;
+        } | {
+            kind: "tier";
+            tier: "fast" | "standard";
+            score: number;
+            rules: string[];
+            model?: string | undefined;
+            routed: boolean;
+            held?: boolean | undefined;
         } | {
             kind: "provider_retry";
             attempt: number;
@@ -409,7 +418,7 @@ export declare const agentContract: {
         } | {
             kind: "error";
             message: string;
-            code?: "agent-busy" | "claude-not-entitled" | "claude-reauth" | "claude-token-refused" | "codex-advisory" | "codex-model-invalid" | "codex-reauth" | "grok-model-invalid" | "provider-outage" | "rate_limit" | "session-not-found" | "subscription-required" | "trial-exhausted" | "trial-model-unavailable" | "trial-unavailable" | "unknown-command" | undefined;
+            code?: "agent-busy" | "claude-not-entitled" | "claude-reauth" | "claude-token-refused" | "codex-advisory" | "codex-model-invalid" | "codex-reauth" | "context-window-too-small" | "grok-model-invalid" | "provider-outage" | "rate_limit" | "session-not-found" | "subscription-required" | "trial-exhausted" | "trial-model-unavailable" | "trial-unavailable" | "unknown-command" | undefined;
             resetsAt?: number | undefined;
             autoResume?: "available" | "scheduled" | undefined;
             outage?: {
@@ -595,6 +604,14 @@ export declare const agentContract: {
             kind: "fast_mode";
             state: "cooldown" | "off" | "on";
             reason?: string | undefined;
+        } | {
+            kind: "tier";
+            tier: "fast" | "standard";
+            score: number;
+            rules: string[];
+            model?: string | undefined;
+            routed: boolean;
+            held?: boolean | undefined;
         } | {
             kind: "provider_retry";
             attempt: number;
@@ -773,7 +790,7 @@ export declare const agentContract: {
         } | {
             kind: "error";
             message: string;
-            code?: "agent-busy" | "claude-not-entitled" | "claude-reauth" | "claude-token-refused" | "codex-advisory" | "codex-model-invalid" | "codex-reauth" | "grok-model-invalid" | "provider-outage" | "rate_limit" | "session-not-found" | "subscription-required" | "trial-exhausted" | "trial-model-unavailable" | "trial-unavailable" | "unknown-command" | undefined;
+            code?: "agent-busy" | "claude-not-entitled" | "claude-reauth" | "claude-token-refused" | "codex-advisory" | "codex-model-invalid" | "codex-reauth" | "context-window-too-small" | "grok-model-invalid" | "provider-outage" | "rate_limit" | "session-not-found" | "subscription-required" | "trial-exhausted" | "trial-model-unavailable" | "trial-unavailable" | "unknown-command" | undefined;
             resetsAt?: number | undefined;
             autoResume?: "available" | "scheduled" | undefined;
             outage?: {

package/dist/contracts/agent.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/agent.contract.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,aAAa;IACtB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACN,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACL,KAAK;;;;;;;;;;;;;IACL,IAAI;;;;;IAIJ,MAAM;;;;;;;IAGN,QAAQ;;;;;;;;;IAIR,QAAQ;;;;;;;;;;;;CACX,CAAC"}
+{"version":3,"file":"agent.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/agent.contract.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,aAAa;IACtB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUN,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUL,KAAK;;;;;;;;;;;;;IAUL,IAAI;;;;;IAYJ,MAAM;;;;;;;IAYN,QAAQ;;;;;;;;;IAaR,QAAQ;;;;;;;;;;;;CASX,CAAC"}

package/dist/contracts/agent.contract.js

@@ -2,13 +2,76 @@ import { eventIterator, oc } from "@orpc/contract";
 import { AgentCommandsQuerySchema, AgentCommandsSchema, AttachFrameSchema } from "../events.js";
 import { AgentReplySchema, AgentTurnSchema, AttachTurnSchema, OkSchema, ProviderRefusalsSchema, RewindResultSchema, RewindTurnSchema, StartedTurnSchema, SteerSchema, StopTurnSchema, } from "../schemas.js";
 export const agentContract = {
-    run: oc.route({ method: "POST", path: "/agent" }).input(AgentTurnSchema).output(StartedTurnSchema),
-    attach: oc.route({ method: "POST", path: "/agent/attach" }).input(AttachTurnSchema).output(eventIterator(AttachFrameSchema)),
-    reply: oc.route({ method: "POST", path: "/agent/reply" }).input(AgentReplySchema).output(OkSchema),
-    steer: oc.route({ method: "POST", path: "/agent/steer" }).input(SteerSchema).output(OkSchema),
-    stop: oc.route({ method: "POST", path: "/agent/stop" }).input(StopTurnSchema).output(OkSchema),
-    rewind: oc.route({ method: "POST", path: "/agent/rewind" }).input(RewindTurnSchema).output(RewindResultSchema),
-    commands: oc.route({ method: "GET", path: "/agent/commands" }).input(AgentCommandsQuerySchema).output(AgentCommandsSchema),
-    refusals: oc.route({ method: "GET", path: "/agent/refusals" }).output(ProviderRefusalsSchema),
+    run: oc
+        .route({
+        method: "POST",
+        path: "/agent",
+        summary: "Say something to an agent",
+        description: "Starts a turn and answers immediately with its id; the work runs inside the sandbox whether or not anybody stays connected. Watch it by attaching. Naming a conversation that does not exist yet opens it.",
+    })
+        .input(AgentTurnSchema)
+        .output(StartedTurnSchema),
+    attach: oc
+        .route({
+        method: "POST",
+        path: "/agent/attach",
+        summary: "Watch a turn happen",
+        description: "Streams everything the agent does: its words, the tools it reaches for, and the answers it gets. Give it the point you have already seen and it replays from there before going live, so a reload loses nothing. The window that started the turn holds no special claim, and any number of watchers on any number of devices see the same thing.",
+    })
+        .input(AttachTurnSchema)
+        .output(eventIterator(AttachFrameSchema)),
+    reply: oc
+        .route({
+        method: "POST",
+        path: "/agent/reply",
+        summary: "Answer a question the agent asked",
+        description: "Un-parks a turn that is waiting on you: approving a plan, choosing between options, or permitting a tool. The turn picks up where it stopped.",
+    })
+        .input(AgentReplySchema)
+        .output(OkSchema),
+    steer: oc
+        .route({
+        method: "POST",
+        path: "/agent/steer",
+        summary: "Interrupt a running turn",
+        description: "Slips a message into a turn already under way, without stopping it. This is how you redirect an agent mid-thought rather than waiting for it to finish being wrong.",
+    })
+        .input(SteerSchema)
+        .output(OkSchema),
+    stop: oc
+        .route({
+        method: "POST",
+        path: "/agent/stop",
+        summary: "Stop a turn now",
+        description: "Cancels the running turn inside the sandbox. Whatever it had already written to disk stays written.",
+    })
+        .input(StopTurnSchema)
+        .output(OkSchema),
+    rewind: oc
+        .route({
+        method: "POST",
+        path: "/agent/rewind",
+        summary: "Go back to an earlier message",
+        description: "Puts the files back as they stood at that point, drops every message after it, and forgets what the model remembered, so the next thing you say starts from there cleanly. Refused while a turn is running, because a restore cannot overwrite files an agent is editing, and refused for a message with no saved state to return to.",
+    })
+        .input(RewindTurnSchema)
+        .output(RewindResultSchema),
+    commands: oc
+        .route({
+        method: "GET",
+        path: "/agent/commands",
+        summary: "Shortcut commands the agent knows",
+        description: "The commands a provider published the last time one of its turns ran, so a composer can offer them before this conversation has run anything. A running turn's own list wins over this one.",
+    })
+        .input(AgentCommandsQuerySchema)
+        .output(AgentCommandsSchema),
+    refusals: oc
+        .route({
+        method: "GET",
+        path: "/agent/refusals",
+        summary: "The last time each provider said no",
+        description: "What each model provider most recently refused and why. Read this alongside an account's usage: the usage says how full it was when last checked, this says whether it has since started turning work away.",
+    })
+        .output(ProviderRefusalsSchema),
 };
 //# sourceMappingURL=agent.contract.js.map

package/dist/contracts/agent.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.contract.js","sourceRoot":"","sources":["../../src/contracts/agent.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EACH,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,cAAc,GACjB,MAAM,eAAe,CAAC;AAOvB,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;IAClG,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC5H,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAClG,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC7F,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAI9F,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAG9G,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAI1H,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC;CAChG,CAAC"}
+{"version":3,"file":"agent.contract.js","sourceRoot":"","sources":["../../src/contracts/agent.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EACH,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,cAAc,GACjB,MAAM,eAAe,CAAC;AAOvB,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,2BAA2B;QACpC,WAAW,EACP,4MAA4M;KACnN,CAAC;SACD,KAAK,CAAC,eAAe,CAAC;SACtB,MAAM,CAAC,iBAAiB,CAAC;IAC9B,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EACP,mVAAmV;KAC1V,CAAC;SACD,KAAK,CAAC,gBAAgB,CAAC;SACvB,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC7C,KAAK,EAAE,EAAE;SACJ,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EACP,+IAA+I;KACtJ,CAAC;SACD,KAAK,CAAC,gBAAgB,CAAC;SACvB,MAAM,CAAC,QAAQ,CAAC;IACrB,KAAK,EAAE,EAAE;SACJ,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,0BAA0B;QACnC,WAAW,EACP,qKAAqK;KAC5K,CAAC;SACD,KAAK,CAAC,WAAW,CAAC;SAClB,MAAM,CAAC,QAAQ,CAAC;IACrB,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,qGAAqG;KACrH,CAAC;SACD,KAAK,CAAC,cAAc,CAAC;SACrB,MAAM,CAAC,QAAQ,CAAC;IAIrB,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,+BAA+B;QACxC,WAAW,EACP,uUAAuU;KAC9U,CAAC;SACD,KAAK,CAAC,gBAAgB,CAAC;SACvB,MAAM,CAAC,kBAAkB,CAAC;IAG/B,QAAQ,EAAE,EAAE;SACP,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EACP,6LAA6L;KACpM,CAAC;SACD,KAAK,CAAC,wBAAwB,CAAC;SAC/B,MAAM,CAAC,mBAAmB,CAAC;IAIhC,QAAQ,EAAE,EAAE;SACP,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,qCAAqC;QAC9C,WAAW,EACP,6MAA6M;KACpN,CAAC;SACD,MAAM,CAAC,sBAAsB,CAAC;CACtC,CAAC"}

package/dist/contracts/agents.contract.d.ts

@@ -27,6 +27,11 @@ export declare const agentsContract: {
             effort: import("zod").ZodOptional<import("zod").ZodString>;
             thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
             fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+                fast: "fast";
+                standard: "standard";
+            }>>;
+            tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
             account: import("zod").ZodOptional<import("zod").ZodString>;
             branch: import("zod").ZodOptional<import("zod").ZodString>;
             autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -183,6 +188,11 @@ export declare const agentsContract: {
             effort: import("zod").ZodOptional<import("zod").ZodString>;
             thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
             fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+                fast: "fast";
+                standard: "standard";
+            }>>;
+            tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
             account: import("zod").ZodOptional<import("zod").ZodString>;
             branch: import("zod").ZodOptional<import("zod").ZodString>;
             autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -326,6 +336,7 @@ export declare const agentsContract: {
             }, import("zod/v4/core").$strip>>;
         }, import("zod/v4/core").$strip>>;
         scanned: import("zod").ZodNumber;
+        indexing: import("zod").ZodBoolean;
     }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
     get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
         id: import("zod").ZodString;
@@ -356,6 +367,11 @@ export declare const agentsContract: {
         effort: import("zod").ZodOptional<import("zod").ZodString>;
         thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
         fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+            fast: "fast";
+            standard: "standard";
+        }>>;
+        tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
         account: import("zod").ZodOptional<import("zod").ZodString>;
         branch: import("zod").ZodOptional<import("zod").ZodString>;
         autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -486,6 +502,9 @@ export declare const agentsContract: {
                 text: import("zod").ZodString;
             }, import("zod/v4/core").$strip>>>;
             placed: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            noticeAction: import("zod").ZodOptional<import("zod").ZodEnum<{
+                tierHold: "tierHold";
+            }>>;
         }, import("zod/v4/core").$strip>>;
         sessionId: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
@@ -525,6 +544,11 @@ export declare const agentsContract: {
         effort: import("zod").ZodOptional<import("zod").ZodString>;
         thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
         fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+            fast: "fast";
+            standard: "standard";
+        }>>;
+        tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
         account: import("zod").ZodOptional<import("zod").ZodString>;
         branch: import("zod").ZodOptional<import("zod").ZodString>;
         autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -665,6 +689,11 @@ export declare const agentsContract: {
         effort: import("zod").ZodOptional<import("zod").ZodString>;
         thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
         fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+            fast: "fast";
+            standard: "standard";
+        }>>;
+        tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
         account: import("zod").ZodOptional<import("zod").ZodString>;
         branch: import("zod").ZodOptional<import("zod").ZodString>;
         autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -805,6 +834,11 @@ export declare const agentsContract: {
         effort: import("zod").ZodOptional<import("zod").ZodString>;
         thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
         fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+            fast: "fast";
+            standard: "standard";
+        }>>;
+        tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
         account: import("zod").ZodOptional<import("zod").ZodString>;
         branch: import("zod").ZodOptional<import("zod").ZodString>;
         autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -944,6 +978,11 @@ export declare const agentsContract: {
         effort: import("zod").ZodOptional<import("zod").ZodString>;
         thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
         fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+            fast: "fast";
+            standard: "standard";
+        }>>;
+        tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
         account: import("zod").ZodOptional<import("zod").ZodString>;
         branch: import("zod").ZodOptional<import("zod").ZodString>;
         autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -1082,6 +1121,11 @@ export declare const agentsContract: {
             effort: import("zod").ZodOptional<import("zod").ZodString>;
             thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
             fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+                fast: "fast";
+                standard: "standard";
+            }>>;
+            tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
             account: import("zod").ZodOptional<import("zod").ZodString>;
             branch: import("zod").ZodOptional<import("zod").ZodString>;
             autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -1322,6 +1366,11 @@ export declare const agentsContract: {
         effort: import("zod").ZodOptional<import("zod").ZodString>;
         thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
         fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+            fast: "fast";
+            standard: "standard";
+        }>>;
+        tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
         account: import("zod").ZodOptional<import("zod").ZodString>;
         branch: import("zod").ZodOptional<import("zod").ZodString>;
         autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -1467,6 +1516,11 @@ export declare const agentsContract: {
             effort: import("zod").ZodOptional<import("zod").ZodString>;
             thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
             fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+                fast: "fast";
+                standard: "standard";
+            }>>;
+            tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
             account: import("zod").ZodOptional<import("zod").ZodString>;
             branch: import("zod").ZodOptional<import("zod").ZodString>;
             autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -1609,6 +1663,11 @@ export declare const agentsContract: {
             effort: import("zod").ZodOptional<import("zod").ZodString>;
             thinking: import("zod").ZodOptional<import("zod").ZodBoolean>;
             fast: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            tier: import("zod").ZodOptional<import("zod").ZodEnum<{
+                fast: "fast";
+                standard: "standard";
+            }>>;
+            tierHold: import("zod").ZodOptional<import("zod").ZodBoolean>;
             account: import("zod").ZodOptional<import("zod").ZodString>;
             branch: import("zod").ZodOptional<import("zod").ZodString>;
             autoLand: import("zod").ZodOptional<import("zod").ZodBoolean>;

package/dist/contracts/agents.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/agents.contract.ts"],"names":[],"mappings":"AAgDA,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACJ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKR,MAAM;;;;;;;;;;;;;;;;IACN,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACH,UAAU;;;;;;;;;;;;;;;;;;;;;;;IAOV,KAAK;;;;;;IACL,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIN,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQR,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIjB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACJ,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACP,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACJ,QAAQ;;;;;;;;;;IACR,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIJ,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACX,OAAO;;;;;IACP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACP,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACT,KAAK;;;CACR,CAAC"}
+{"version":3,"file":"agents.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/agents.contract.ts"],"names":[],"mappings":"AAgDA,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASJ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaR,MAAM;;;;;;;;;;;;;;;;;IAUN,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASH,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBV,KAAK;;;;;;IAUL,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaN,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiBR,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUjB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUJ,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQP,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUJ,QAAQ;;;;;;;;;;IASR,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaJ,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUX,OAAO;;;;;IAUP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUP,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUT,KAAK;;;CASR,CAAC"}

package/dist/contracts/agents.contract.js

@@ -2,27 +2,172 @@ import { oc } from "@orpc/contract";
 import { AgentTranscriptSchema } from "../events.js";
 import { AgentArchiveSchema, AgentAutoLandSchema, AgentChangesSchema, AgentFileDiffQuerySchema, AgentIdSchema, AgentIdsSchema, AgentLandSchema, AgentPlaceSchema, AgentRenameSchema, AgentResumeAfterOutageSchema, AgentSearchQuerySchema, AgentSearchResultSchema, AgentsListSchema, AgentsMovedSchema, AgentsRemovedSchema, AgentSummarySchema, FileDiffSchema, LandResultSchema, OkSchema, } from "../schemas.js";
 export const agentsContract = {
-    list: oc.route({ method: "GET", path: "/agents" }).output(AgentsListSchema),
-    archived: oc.route({ method: "GET", path: "/agents/archived" }).output(AgentsListSchema),
-    search: oc.route({ method: "GET", path: "/agents/search" }).input(AgentSearchQuerySchema).output(AgentSearchResultSchema),
-    get: oc.route({ method: "GET", path: "/agents/{id}" }).input(AgentIdSchema).output(AgentSummarySchema),
-    transcript: oc.route({ method: "GET", path: "/agents/{id}/transcript" }).input(AgentIdSchema).output(AgentTranscriptSchema),
-    place: oc.route({ method: "POST", path: "/agents/{id}/place" }).input(AgentPlaceSchema).output(OkSchema),
-    rename: oc.route({ method: "POST", path: "/agents/{id}/rename" }).input(AgentRenameSchema).output(AgentSummarySchema),
-    autoLand: oc.route({ method: "POST", path: "/agents/{id}/auto-land" }).input(AgentAutoLandSchema).output(AgentSummarySchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/agents",
+        summary: "Every live conversation",
+        description: "The fleet as the board draws it: each conversation with its title, what it is doing, when it last moved and whether anybody has read it since. Archived conversations are not in here.",
+    })
+        .output(AgentsListSchema),
+    archived: oc
+        .route({
+        method: "GET",
+        path: "/agents/archived",
+        summary: "Conversations put away",
+        description: "The same shape as the live fleet, for the conversations somebody has decided are finished. Their work is kept, and any one of them can be brought back.",
+    })
+        .output(AgentsListSchema),
+    search: oc
+        .route({
+        method: "GET",
+        path: "/agents/search",
+        summary: "Find a conversation",
+        description: "Searches the live fleet and the archive together. Both halves on purpose: the board hides finished work by design, and a filter that says it found nothing while the answer sits one click away is simply wrong.",
+    })
+        .input(AgentSearchQuerySchema)
+        .output(AgentSearchResultSchema),
+    get: oc
+        .route({
+        method: "GET",
+        path: "/agents/{id}",
+        summary: "One conversation's card",
+        description: "Everything the board shows for a single conversation: its title, state, working branch, unread marker and timestamps.",
+    })
+        .input(AgentIdSchema)
+        .output(AgentSummarySchema),
+    transcript: oc
+        .route({
+        method: "GET",
+        path: "/agents/{id}/transcript",
+        summary: "The full conversation record",
+        description: "Every message in one conversation, in order, including the tool calls and their results. This is the record the chat replays and the next turn is seeded from.",
+    })
+        .input(AgentIdSchema)
+        .output(AgentTranscriptSchema),
+    place: oc
+        .route({
+        method: "POST",
+        path: "/agents/{id}/place",
+        summary: "Put words in the agent's mouth",
+        description: "Writes a line into the record as though the agent had said it, with no turn behind it and no reply. Human readers see it marked as placed. The next real turn starts fresh from the record, where the line reads as the agent's own. Refused while a turn is running.",
+    })
+        .input(AgentPlaceSchema)
+        .output(OkSchema),
+    rename: oc
+        .route({
+        method: "POST",
+        path: "/agents/{id}/rename",
+        summary: "Retitle a conversation",
+        description: "Sets the title a person chose, replacing the one that was generated. Allowed while the conversation is working, and it does not count as activity.",
+    })
+        .input(AgentRenameSchema)
+        .output(AgentSummarySchema),
+    autoLand: oc
+        .route({
+        method: "POST",
+        path: "/agents/{id}/auto-land",
+        summary: "Whether this conversation merges its work automatically",
+        description: "Overrides the sandbox-wide setting for one conversation; clear it to go back to following the default. Deliberately allowed mid-turn, because the setting is read when the turn finishes, so flipping it while the agent works means exactly hold this piece of work for review.",
+    })
+        .input(AgentAutoLandSchema)
+        .output(AgentSummarySchema),
     resumeAfterOutage: oc
-        .route({ method: "POST", path: "/agents/{id}/resume-after-outage" })
+        .route({
+        method: "POST",
+        path: "/agents/{id}/resume-after-outage",
+        summary: "Whether this conversation retries after a provider outage",
+        description: "Overrides the sandbox-wide setting for one conversation; clear it to follow the default again. This is what the offer shown when a turn dies writes, because the press happens inside one conversation and honestly means finish this piece of work.",
+    })
         .input(AgentResumeAfterOutageSchema)
         .output(AgentSummarySchema),
-    seen: oc.route({ method: "POST", path: "/agents/{id}/seen" }).input(AgentIdSchema).output(AgentSummarySchema),
-    seenAll: oc.route({ method: "POST", path: "/agents/seen" }).output(AgentsListSchema),
-    diff: oc.route({ method: "GET", path: "/agents/{id}/diff" }).input(AgentIdSchema).output(AgentChangesSchema),
-    fileDiff: oc.route({ method: "GET", path: "/agents/{id}/{repo}/file-diff" }).input(AgentFileDiffQuerySchema).output(FileDiffSchema),
-    land: oc.route({ method: "POST", path: "/agents/{id}/land" }).input(AgentLandSchema).output(LandResultSchema),
-    requestLand: oc.route({ method: "POST", path: "/agents/{id}/request-land" }).input(AgentIdSchema).output(AgentSummarySchema),
-    discard: oc.route({ method: "POST", path: "/agents/{id}/discard" }).input(AgentIdSchema).output(OkSchema),
-    archive: oc.route({ method: "POST", path: "/agents/archive" }).input(AgentArchiveSchema).output(AgentsMovedSchema),
-    unarchive: oc.route({ method: "POST", path: "/agents/unarchive" }).input(AgentIdsSchema).output(AgentsMovedSchema),
-    purge: oc.route({ method: "POST", path: "/agents/purge" }).output(AgentsRemovedSchema),
+    seen: oc
+        .route({
+        method: "POST",
+        path: "/agents/{id}/seen",
+        summary: "Mark a conversation read",
+        description: "Stamps the read marker behind the unread badge on one card. Allowed while the conversation is working, and reading never counts as activity.",
+    })
+        .input(AgentIdSchema)
+        .output(AgentSummarySchema),
+    seenAll: oc
+        .route({
+        method: "POST",
+        path: "/agents/seen",
+        summary: "Mark every conversation read",
+        description: "Clears the unread badge across the whole fleet at once, and hands the refreshed list back.",
+    })
+        .output(AgentsListSchema),
+    diff: oc
+        .route({
+        method: "GET",
+        path: "/agents/{id}/diff",
+        summary: "Everything a conversation has changed",
+        description: "One flat set of changed files per repo, measured against where each repo stood when the conversation started, with every file flagged as already merged or not. Not the staged-and-unstaged shape a working copy has, because nobody ever checks this branch out to stage into it.",
+    })
+        .input(AgentIdSchema)
+        .output(AgentChangesSchema),
+    fileDiff: oc
+        .route({
+        method: "GET",
+        path: "/agents/{id}/{repo}/file-diff",
+        summary: "One file's before and after in a conversation's work",
+        description: "Both sides of a single file: what it held when the conversation started and what it holds on its branch now.",
+    })
+        .input(AgentFileDiffQuerySchema)
+        .output(FileDiffSchema),
+    land: oc
+        .route({
+        method: "POST",
+        path: "/agents/{id}/land",
+        summary: "Merge a conversation's work into the workspace",
+        description: "Brings the conversation's branches into the main tree, one repo at a time. A conflict is reported rather than raised and nothing is lost when it fails. Refused while a turn is running, and refused for a conversation that works directly in the shared tree, which has nothing to merge.",
+    })
+        .input(AgentLandSchema)
+        .output(LandResultSchema),
+    requestLand: oc
+        .route({
+        method: "POST",
+        path: "/agents/{id}/request-land",
+        summary: "Ask a maintainer to merge this work",
+        description: "For a collaborator who is not allowed to merge: marks the conversation as waiting for review, with who asked. The request shows on every maintainer's board and clears when somebody merges or discards it.",
+    })
+        .input(AgentIdSchema)
+        .output(AgentSummarySchema),
+    discard: oc
+        .route({
+        method: "POST",
+        path: "/agents/{id}/discard",
+        summary: "Throw a conversation's work away",
+        description: "Deletes the conversation's working copies, its branches and its entry. Nothing is kept. Refused while a turn is running, and refused for a conversation working in the shared tree.",
+    })
+        .input(AgentIdSchema)
+        .output(OkSchema),
+    archive: oc
+        .route({
+        method: "POST",
+        path: "/agents/archive",
+        summary: "Put conversations away",
+        description: "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. It leaves the live fleet and joins the archive. Refused for a conversation that is running.",
+    })
+        .input(AgentArchiveSchema)
+        .output(AgentsMovedSchema),
+    unarchive: oc
+        .route({
+        method: "POST",
+        path: "/agents/unarchive",
+        summary: "Bring conversations back",
+        description: "Returns archived conversations to the live fleet. The next turn picks up a fresh working copy from the branch that was kept.",
+    })
+        .input(AgentIdsSchema)
+        .output(AgentsMovedSchema),
+    purge: oc
+        .route({
+        method: "POST",
+        path: "/agents/purge",
+        summary: "Empty the archive for good",
+        description: "Discards every conversation already in the archive: working copies, branches and entries. The whole archive rather than a chosen few, because the archive is the pile somebody has already decided is over. A teardown that fails on one conversation leaves that one behind instead of taking the rest down with it.",
+    })
+        .output(AgentsRemovedSchema),
 };
 //# sourceMappingURL=agents.contract.js.map

package/dist/contracts/agents.contract.js.map

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

package/dist/contracts/automations.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automations.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/automations.contract.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,mBAAmB;IAC5B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKJ,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACN,UAAU;;;;;;IACV,MAAM;;;;;IAoBN,GAAG;;;;;IACH,WAAW;;;;;;;;;;;;;;;;;;IACX,OAAO;;;;;IACP,MAAM;;;;;CACT,CAAC"}
+{"version":3,"file":"automations.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/automations.contract.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,mBAAmB;IAC5B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYJ,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASN,UAAU;;;;;;IASV,MAAM;;;;;IA4BN,GAAG;;;;;IAUH,WAAW;;;;;;;;;;;;;;;;;;IAQX,OAAO;;;;;IASP,MAAM;;;;;CAST,CAAC"}