@camox/api-contract 0.53.1 → 0.56.0

package/dist/drafts.d.ts

@@ -40,7 +40,7 @@ export declare const DRAFT_SEARCH_PARAM = "camox-draft";
 /** A regular draft is a named set of edits; a development draft backs a dev server. */
 export type DraftKind = "regular" | "development";
 /** How a regular draft ended. */
-export type DraftOutcome = "published" | "discarded";
+export type DraftOutcome = "published" | "deleted";
 /** Who ended a draft, how and when, from its ended-drafts record (ADR 0009, ADR 0011). */
 export type EndedDraft = {
   draftId: string;
@@ -53,7 +53,7 @@ export type EndedDraft = {
 };
 /**
  * The oRPC error code a request naming an ended draft fails with. Its `data` is an `EndedDraft`,
- * so a page can render Live and say who published or discarded the draft.
+ * so a page can render Live and say who published or deleted the draft.
  */
 export declare const DRAFT_ENDED_ERROR_CODE = "DRAFT_ENDED";
 /**

package/dist/drafts.js

@@ -39,7 +39,7 @@ const NO_DEVELOPMENT_DRAFT_ERROR = "NO_DEVELOPMENT_DRAFT";
 const DRAFT_SEARCH_PARAM = "camox-draft";
 /**
 * The oRPC error code a request naming an ended draft fails with. Its `data` is an `EndedDraft`,
-* so a page can render Live and say who published or discarded the draft.
+* so a page can render Live and say who published or deleted the draft.
 */
 const DRAFT_ENDED_ERROR_CODE = "DRAFT_ENDED";
 /**

package/dist/query-keys.d.ts

@@ -61,7 +61,7 @@ export type InvalidationMessage = {
   draftId: string | null;
   targets: QueryKey[];
 };
-/** A draft was published or discarded: its viewers go back to Live. */
+/** A draft was published or deleted: its viewers go back to Live. */
 export type DraftEndedMessage = {
   type: "draftEnded";
 } & EndedDraft;

package/dist/router.d.ts

@@ -6196,10 +6196,10 @@ type MergeOutcome =
  * The working copy of one draft with code, addressed by the draft's ID (`getByName`): a depth-1
  * clone of the draft's branch, held in memory, which the agent's code tools read and write over
  * RPC, through the write line. Every change is saved to its SQLite as it's made, Git's own
- * directory included, so an eviction restores it without cloning again. The SDK's code
- * references are mounted beside the files and never saved, nor committed.
+ * directory included, so an eviction restores it without cloning again. The skills of its `camox`
+ * version are mounted beside the files and never saved, nor committed.
  *
- * It stores nothing until `start` made it, and nothing once `discard` deleted it.
+ * It stores nothing until `start` made it, and nothing once `delete` deleted it.
  */
 declare class DraftCode extends DurableObject<Bindings> {
   #private;
@@ -6313,7 +6313,7 @@ declare class DraftCode extends DurableObject<Bindings> {
    */
   mergeMain(): Promise<MergeOutcome>;
   /** Deletes the draft's branch and everything the working copy stored, as the draft ends. */
-  discard(): Promise<void>;
+  delete(): Promise<void>;
 }
 //#endregion
 //#region ../../apps/api/src/domains/project-creation/workflow.d.ts
@@ -6440,6 +6440,8 @@ type Bindings = {
   PUBLISH_WORKFLOW: Workflow<PublishParams>;
   /** Each revision's build, one archive per revision (`revisionArchiveKey`). */
   REVISION_BUILDS: R2Bucket;
+  /** The skills each `camox` version ships, one object per version (`domains/code/skills.ts`). */
+  SKILLS: R2Bucket;
   /** The dispatch Worker, which loads revisions (`domains/revisions/dispatch.ts`). */
   DISPATCH: Dispatch;
   /** Camox's Cloudflare account, which serves every project's Worker. */
@@ -6688,6 +6690,8 @@ type BaseContext = {
   client: string;
   telemetryDisabled: boolean;
   waitUntil: (promise: Promise<unknown>) => void;
+  /** The API's public origin, which stored files' URLs start with. */
+  apiOrigin?: string;
 };
 //#endregion
 //#region ../../apps/api/src/domains/projects/analytics.d.ts
@@ -7097,6 +7101,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7185,6 +7190,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7271,6 +7277,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7279,10 +7286,10 @@ declare const router: {
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
       organizationSlug: string | null;
       analytics: AnalyticsProviders;
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7301,10 +7308,10 @@ declare const router: {
     }, {
       organizationSlug: string | null;
       analytics: AnalyticsProviders;
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7361,6 +7368,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7369,10 +7377,10 @@ declare const router: {
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
       organizationSlug: string | null;
       analytics: AnalyticsProviders;
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7391,10 +7399,10 @@ declare const router: {
     }, {
       organizationSlug: string | null;
       analytics: AnalyticsProviders;
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7468,6 +7476,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7476,10 +7485,10 @@ declare const router: {
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
       organizationSlug: string | null;
       analytics: AnalyticsProviders;
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7498,10 +7507,10 @@ declare const router: {
     }, {
       organizationSlug: string | null;
       analytics: AnalyticsProviders;
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7558,6 +7567,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7616,6 +7626,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7624,10 +7635,10 @@ declare const router: {
       slug: import("zod").ZodString;
       organizationId: import("zod").ZodString;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7644,10 +7655,10 @@ declare const router: {
       liveScript: string | null;
       updatedAt: number;
     }, {
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7704,6 +7715,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7711,10 +7723,10 @@ declare const router: {
       id: import("zod").ZodNumber;
       name: import("zod").ZodString;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7731,10 +7743,10 @@ declare const router: {
       liveScript: string | null;
       updatedAt: number;
     }, {
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7791,6 +7803,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7853,6 +7866,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -7906,16 +7920,17 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
     }>, import("zod").ZodObject<{
       id: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -7932,10 +7947,10 @@ declare const router: {
       liveScript: string | null;
       updatedAt: number;
     } | undefined, {
-      uuid: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
       id: number;
       name: string;
+      uuid: string;
       slug: string;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
@@ -8600,6 +8615,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -8635,6 +8651,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -8744,6 +8761,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -8779,6 +8797,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -8880,6 +8899,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -8915,6 +8935,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9013,6 +9034,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9048,6 +9070,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9149,6 +9172,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9184,6 +9208,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9281,6 +9306,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9706,6 +9732,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9741,6 +9768,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9859,6 +9887,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9894,6 +9923,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9943,6 +9973,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -9978,6 +10009,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10027,6 +10059,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10062,6 +10095,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10112,6 +10146,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10147,6 +10182,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10195,6 +10231,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10230,6 +10267,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10276,6 +10314,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10324,6 +10363,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10359,6 +10399,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10615,6 +10656,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10650,6 +10692,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10699,6 +10742,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10734,6 +10778,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10781,6 +10826,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10828,6 +10874,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10882,6 +10929,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -10917,6 +10965,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11099,6 +11148,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11134,6 +11184,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11231,6 +11282,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11266,6 +11318,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11363,6 +11416,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11398,6 +11452,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11494,6 +11549,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11529,6 +11585,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11577,6 +11634,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11612,6 +11670,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11707,6 +11766,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11866,6 +11926,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -11901,6 +11962,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12009,6 +12071,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12044,6 +12107,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12139,6 +12203,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12174,6 +12239,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12269,6 +12335,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12304,6 +12371,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12400,6 +12468,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12435,6 +12504,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12527,6 +12597,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12621,6 +12692,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12656,6 +12728,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12791,6 +12864,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12849,6 +12923,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12910,6 +12985,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -12967,6 +13043,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13031,6 +13108,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13150,6 +13228,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13185,6 +13264,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13252,6 +13332,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13287,6 +13368,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13354,6 +13436,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13389,6 +13472,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13700,6 +13784,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13760,6 +13845,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13807,6 +13893,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13853,6 +13940,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13900,6 +13988,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -13990,6 +14079,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -14036,6 +14126,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -14045,7 +14136,7 @@ declare const router: {
       publishAnyway: import("zod").ZodOptional<import("zod").ZodBoolean>;
       revision: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<PublishResult, PublishResult>, Record<never, never>, Record<never, never>>;
-    discard: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("@orpc/server").MergedInitialContext<import("@orpc/server").MergedInitialContext<BaseContext & Record<never, never>, BaseContext, BaseContext>, import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+    delete: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("@orpc/server").MergedInitialContext<import("@orpc/server").MergedInitialContext<BaseContext & Record<never, never>, BaseContext, BaseContext>, import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -14085,6 +14176,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -14135,6 +14227,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -14194,6 +14287,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;
@@ -14242,6 +14336,7 @@ declare const router: {
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
       draft: DraftRequest | null;
       locale: string | undefined;
       publishingDraft: string | undefined;

package/dist/threads.d.ts

@@ -204,6 +204,11 @@ export type ThreadView = LiveThreadHandoff & {
    * turn is building it, or it failed and the agent is fixing it.
    */
   status?: BuildStatus;
+  /**
+   * While a run is going, whether the agent is using its tools, code mode included, rather than
+   * thinking: from writing a call until the model is called again.
+   */
+  usingTools?: true;
 };
 export declare const EMPTY_THREAD_VIEW: ThreadView;
 /**
@@ -214,6 +219,10 @@ export declare const EMPTY_THREAD_VIEW: ThreadView;
 export type ThreadState = LiveThreadHandoff & {
   steps: readonly ThreadStep[];
   running: boolean;
+  /** The model's calls still running, by call id. A tool's own calls aren't the agent's. */
+  toolCalls?: readonly string[];
+  /** Whether the model's latest message makes tool calls: it writes them, then they run. */
+  callingTools?: boolean;
 };
 export declare const EMPTY_THREAD_STATE: ThreadState;
 /** One transcript entry, as far as the studio's view is concerned. */
@@ -321,7 +330,7 @@ export declare const THREAD_ENDED_CLOSE_CODE = 4000;
  * run is over, or a later message started another run after its last model call came back
  * unfinished. While Pi retries a failed call, the run goes on, so the turn shows as working.
  */
-export declare function threadViewOf({ steps, running, ...drafts }: ThreadState): ThreadView;
+export declare function threadViewOf({ steps, running, toolCalls, callingTools, ...drafts }: ThreadState): ThreadView;
 /** Folds one of Pi's agent events into the thread's state. */
 export declare function reduceThreadState(state: ThreadState, event: AgentEvent): ThreadState;
 /** Folds a batch of Pi's agent events into the thread's state. */

package/dist/threads.js

@@ -191,7 +191,7 @@ function threadStepOf(entry) {
 * run is over, or a later message started another run after its last model call came back
 * unfinished. While Pi retries a failed call, the run goes on, so the turn shows as working.
 */
-function threadViewOf({ steps, running, ...drafts }) {
+function threadViewOf({ steps, running, toolCalls = [], callingTools = false, ...drafts }) {
 	const messages = [];
 	let waiting;
 	let unfinished = false;
@@ -273,11 +273,13 @@ function threadViewOf({ steps, running, ...drafts }) {
 		case "unfinished": unfinished = true;
 	}
 	if (!running) fail();
+	const usingTools = running && (callingTools || toolCalls.length > 0);
 	return {
 		...drafts,
 		messages,
 		running,
-		...running && status && { status }
+		...running && status && { status },
+		...usingTools && { usingTools }
 	};
 }
 const append = (state, entry) => {
@@ -294,7 +296,9 @@ function reduceThreadState(state, event) {
 		case "snapshot": return {
 			...state,
 			steps: event.entries.flatMap((entry) => threadStepOf(entry) ?? []),
-			running: event.run !== void 0
+			running: event.run !== void 0,
+			toolCalls: event.tools.flatMap((tool) => tool.status === "done" ? [] : [tool.callId]),
+			callingTools: !!event.generation?.message?.content.some((part) => part.type === "toolCall")
 		};
 		case "run_start": return {
 			...state,
@@ -302,11 +306,30 @@ function reduceThreadState(state, event) {
 		};
 		case "run_end": return {
 			...state,
-			running: false
+			running: false,
+			toolCalls: [],
+			callingTools: false
 		};
+		case "message_start": return event.message.role === "assistant" ? {
+			...state,
+			callingTools: false
+		} : state;
+		case "message_update": return event.changes.some((change) => change.type === "toolcall_start") ? {
+			...state,
+			callingTools: true
+		} : state;
+		case "tool_execution_start":
+			if (event.parentToolCallId !== void 0) return state;
+			return {
+				...state,
+				toolCalls: [...state.toolCalls ?? [], event.toolCallId]
+			};
+		case "tool_execution_end": return append({
+			...state,
+			toolCalls: state.toolCalls?.filter((callId) => callId !== event.toolCallId)
+		}, event.entry);
 		case "message_end":
-		case "entry_appended":
-		case "tool_execution_end": return append(state, event.entry);
+		case "entry_appended": return append(state, event.entry);
 		default: return state;
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camox/api-contract",
-  "version": "0.53.1",
+  "version": "0.56.0",
   "license": "MIT",
   "files": [
     "src",

package/src/drafts.ts

@@ -50,7 +50,7 @@ export const DRAFT_SEARCH_PARAM = "camox-draft";
 export type DraftKind = "regular" | "development";
 
 /** How a regular draft ended. */
-export type DraftOutcome = "published" | "discarded";
+export type DraftOutcome = "published" | "deleted";
 
 /** Who ended a draft, how and when, from its ended-drafts record (ADR 0009, ADR 0011). */
 export type EndedDraft = {
@@ -62,7 +62,7 @@ export type EndedDraft = {
 
 /**
  * The oRPC error code a request naming an ended draft fails with. Its `data` is an `EndedDraft`,
- * so a page can render Live and say who published or discarded the draft.
+ * so a page can render Live and say who published or deleted the draft.
  */
 export const DRAFT_ENDED_ERROR_CODE = "DRAFT_ENDED";
 

package/src/query-keys.ts

@@ -89,7 +89,7 @@ export type InvalidationMessage = {
   targets: QueryKey[];
 };
 
-/** A draft was published or discarded: its viewers go back to Live. */
+/** A draft was published or deleted: its viewers go back to Live. */
 export type DraftEndedMessage = { type: "draftEnded" } & EndedDraft;
 
 /** A draft with code has a new revision, built with Camox's `sdkVersion`. */

package/src/threads.ts

@@ -143,6 +143,11 @@ export type ThreadView = LiveThreadHandoff & {
    * turn is building it, or it failed and the agent is fixing it.
    */
   status?: BuildStatus;
+  /**
+   * While a run is going, whether the agent is using its tools, code mode included, rather than
+   * thinking: from writing a call until the model is called again.
+   */
+  usingTools?: true;
 };
 
 export const EMPTY_THREAD_VIEW: ThreadView = { messages: [], running: false };
@@ -152,7 +157,14 @@ export const EMPTY_THREAD_VIEW: ThreadView = { messages: [], running: false };
  * and whether a run is going. The studio and the tests fold Pi's events into this, and derive
  * the view from it with `threadViewOf`, so a snapshot and the events that led to it show the same.
  */
-export type ThreadState = LiveThreadHandoff & { steps: readonly ThreadStep[]; running: boolean };
+export type ThreadState = LiveThreadHandoff & {
+  steps: readonly ThreadStep[];
+  running: boolean;
+  /** The model's calls still running, by call id. A tool's own calls aren't the agent's. */
+  toolCalls?: readonly string[];
+  /** Whether the model's latest message makes tool calls: it writes them, then they run. */
+  callingTools?: boolean;
+};
 
 export const EMPTY_THREAD_STATE: ThreadState = { steps: [], running: false };
 
@@ -280,7 +292,13 @@ function threadStepOf(entry: EntryRecord): ThreadStep | undefined {
  * run is over, or a later message started another run after its last model call came back
  * unfinished. While Pi retries a failed call, the run goes on, so the turn shows as working.
  */
-export function threadViewOf({ steps, running, ...drafts }: ThreadState): ThreadView {
+export function threadViewOf({
+  steps,
+  running,
+  toolCalls = [],
+  callingTools = false,
+  ...drafts
+}: ThreadState): ThreadView {
   const messages: ThreadMessage[] = [];
   // The latest editor's message of a turn still waiting for the agent's message.
   let waiting: string | undefined;
@@ -353,7 +371,14 @@ export function threadViewOf({ steps, running, ...drafts }: ThreadState): Thread
     }
   }
   if (!running) fail();
-  return { ...drafts, messages, running, ...(running && status && { status }) };
+  const usingTools = running && (callingTools || toolCalls.length > 0);
+  return {
+    ...drafts,
+    messages,
+    running,
+    ...(running && status && { status }),
+    ...(usingTools && { usingTools }),
+  };
 }
 
 const append = (state: ThreadState, entry: EntryRecord | undefined): ThreadState => {
@@ -370,14 +395,33 @@ export function reduceThreadState(state: ThreadState, event: AgentEvent): Thread
         ...state,
         steps: event.entries.flatMap((entry) => threadStepOf(entry) ?? []),
         running: event.run !== undefined,
+        toolCalls: event.tools.flatMap((tool) => (tool.status === "done" ? [] : [tool.callId])),
+        callingTools: !!event.generation?.message?.content.some((part) => part.type === "toolCall"),
       };
     case "run_start":
       return { ...state, running: true };
     case "run_end":
-      return { ...state, running: false };
+      return { ...state, running: false, toolCalls: [], callingTools: false };
+    case "message_start":
+      // The model is called again: it thinks until it writes a tool call.
+      return event.message.role === "assistant" ? { ...state, callingTools: false } : state;
+    case "message_update":
+      return event.changes.some((change) => change.type === "toolcall_start")
+        ? { ...state, callingTools: true }
+        : state;
+    case "tool_execution_start":
+      if (event.parentToolCallId !== undefined) return state;
+      return { ...state, toolCalls: [...(state.toolCalls ?? []), event.toolCallId] };
+    case "tool_execution_end":
+      return append(
+        {
+          ...state,
+          toolCalls: state.toolCalls?.filter((callId) => callId !== event.toolCallId),
+        },
+        event.entry,
+      );
     case "message_end":
     case "entry_appended":
-    case "tool_execution_end":
       return append(state, event.entry);
     default:
       return state;