@camox/api-contract 0.58.0 → 0.59.0

package/dist/router.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import "@orpc/server";
 import "@camox/api-contract/projects";
-import { DraftKind, EndedDraft, PublishAbortReason } from "@camox/api-contract/drafts";
+import { EndedDraft, PublishAbortReason } from "@camox/api-contract/drafts";
 import "effect";
 import "drizzle-orm";
 import "drizzle-orm/sqlite-core";
@@ -11,9 +11,9 @@ import { ThreadSender } from "@camox/api-contract/threads";
 import { PiHarness, PiHarnessOptions } from "agents/harness/pi";
 import { CapabilityStartContext, Lifecycle } from "agents/lifecycle";
 import { WebSockets } from "agents/websockets";
+import { FileErrorCode } from "@earendil-works/pi-durable/env";
 import "@camox/ai-tools";
 import "@earendil-works/pi-durable";
-import { FileErrorCode } from "@earendil-works/pi-durable/env";
 import { CiParams, CloudflareArtifacts } from "@cloudflare/ci";
 import "@cloudflare/ci/worker";
 import { PosthogRegion } from "@camox/api-contract/analytics";
@@ -1306,14 +1306,11 @@ type GeneratedValues = {
 //#region ../../apps/api/src/domains/drafts/scope.d.ts
 /**
  * The draft a request names, before it is checked: a draft's id, where `create` asks for a
- * missing regular draft to be created with it, or the caller's development draft in the
- * project the request acts on (ADR 0011).
+ * missing draft to be created with it (ADR 0011).
  */
 type DraftRequest = {
   id: string;
   create: boolean;
-} | {
-  development: true;
 };
 //#endregion
 //#region ../../apps/api/src/domains/drafts/overlay.d.ts
@@ -1422,6 +1419,25 @@ declare function createDb(d1: D1Database): import("drizzle-orm/d1").DrizzleD1Dat
       }, {}, {
         length: undefined;
       }>;
+      customDomain: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "custom_domain";
+        tableName: "projects";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
       name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
         name: "name";
         tableName: "projects";
@@ -1687,6 +1703,23 @@ declare function createDb(d1: D1Database): import("drizzle-orm/d1").DrizzleD1Dat
       }, {}, {
         length: number | undefined;
       }>;
+      codeOutsideCamox: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "code_outside_camox";
+        tableName: "projects";
+        dataType: "boolean";
+        columnType: "SQLiteBoolean";
+        data: boolean;
+        driverParam: number;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {}>;
       createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
         name: "created_at";
         tableName: "projects";
@@ -1764,26 +1797,6 @@ declare function createDb(d1: D1Database): import("drizzle-orm/d1").DrizzleD1Dat
         identity: undefined;
         generated: undefined;
       }, {}, {}>;
-      kind: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-        name: "kind";
-        tableName: "drafts";
-        dataType: "string";
-        columnType: "SQLiteText";
-        data: import("@camox/api-contract/drafts").DraftKind;
-        driverParam: string;
-        notNull: true;
-        hasDefault: false;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: [string, ...string[]];
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-      }, {}, {
-        length: undefined;
-        $type: import("@camox/api-contract/drafts").DraftKind;
-      }>;
       name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
         name: "name";
         tableName: "drafts";
@@ -6014,189 +6027,6 @@ declare class EdgeCachePurger extends DurableObject<Bindings> {
 //#region ../../apps/api/src/lib/edge-cache-purges.d.ts
 type EdgeCachePurgerNamespace = DurableObjectNamespace<EdgeCachePurger>;
 //#endregion
-//#region ../../apps/api/src/domains/revisions/merge.d.ts
-/** How a merge of `main` into a draft ended. */
-type MergeEnd =
-/** The draft holds the current `main`, or will once its changes are committed. */
-"upToDate" |
-/** A merge revision landed, built, and the draft previews it. */
-"merged" |
-/** The merge clashed: it's left for Camox's reconcile turn (`DraftCode.clash`), to start. */
-"clashed" |
-/** This move of `main` clashed already: Camox's reconcile turn had its one try. */
-"clashedBefore";
-//#endregion
-//#region ../../apps/api/src/domains/agent/service.d.ts
-type ToolExecutionResponse = {
-  ok: true;
-  result: unknown;
-} | {
-  ok: false;
-  error: {
-    code: string;
-    message: string;
-    details?: unknown;
-  };
-};
-//#endregion
-//#region ../../apps/api/src/domains/threads/tools.d.ts
-/**
- * What a thread belongs to: its project, its draft once it has one, and for a Live thread, the
- * editor who owns it.
- */
-declare const threadIdentitySchema: z.ZodObject<{
-  projectId: z.ZodNumber;
-  draftId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-  ownerId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-type ThreadIdentity = z.infer<typeof threadIdentitySchema>;
-//#endregion
-//#region ../../apps/api/src/durable-objects/thread.d.ts
-/**
- * How the API opens a draft's thread with no studio connected (`Thread.open`): what it belongs
- * to, the API's public origin, the Brief from Camox, and the messages the editor sent, oldest
- * first, each with the operation id it was sent with.
- */
-type ThreadOpening = {
-  identity: ThreadIdentity;
-  apiOrigin: string;
-  brief: string;
-  editor: ThreadSender;
-  messages: {
-    operationId: string;
-    text: string;
-  }[];
-};
-/**
- * Cloudflare's `PiHarness`, leaving Pi closed when the object starts until `started` holds: Pi
- * creates its tables as it opens, and a thread nobody messaged has no run to resume.
- */
-declare class UntilStartedPiHarness extends PiHarness {
-  #private;
-  constructor(started: () => Promise<boolean>, options: PiHarnessOptions);
-  onStart(context: CapabilityStartContext): Promise<void>;
-}
-/**
- * One thread with Camox's agent, addressed by the thread's own id. Pi Durable runs the agent
- * through Cloudflare's `PiHarness`, so a run is saved at every step and carries on with no client
- * connected (ADR 0018).
- *
- * The API authorizes every connection before forwarding it here, naming the sender in
- * `THREAD_SENDER_HEADER`. Each socket gets a snapshot of Pi's agent events, then a batch per
- * commit; it sends editors' messages and can ask to resync.
- *
- * The thread starts with its first message: until then, connecting stores nothing, so opening a
- * draft leaves no thread behind.
- */
-declare class Thread extends DurableObject<Bindings> {
-  #private;
-  readonly harness: UntilStartedPiHarness;
-  readonly webSockets: WebSockets;
-  readonly lifecycle: Lifecycle<object, object>;
-  /**
-   * Builds the code of the draft `draftId`, the thread's, in its build queue, as a publish of a
-   * head revision whose build is gone asks: the head's tree finds its revision, built again.
-   */
-  buildForPublish(draftId: string): Promise<BuildResult | null>;
-  /**
-   * Merges the current `main` into the thread's draft, when it has code, as a push to `main`
-   * asks: right away when the agent is idle, or else right after its turn's last commit, before
-   * the next message (`#onYield`). Nothing of it shows in the thread.
-   */
-  mergeMain(): Promise<MergeEnd | "afterTheTurn" | "noCode">;
-  /**
-   * Builds the code of the thread's draft, as the end of a turn would on its last try, when
-   * Camox's infrastructure failed the last build: changes that don't build are committed as a
-   * revision that isn't built, which blocks publishing. Nothing of it shows in the thread. A
-   * failure on Camox's side again owes the next retry. `busy` while the agent's turn runs: its
-   * end builds.
-   */
-  retryBuild(): Promise<"built" | "failed" | "busy" | "noCode">;
-  /**
-   * Lifecycle's alarm, which wakes Pi's runs, unless the thread ended: an alarm already on its
-   * way when it did would look for the jobs its storage no longer has.
-   */
-  alarm(): Promise<void>;
-  /** Gives sockets that outlived the last isolate a new watch and a fresh snapshot. */
-  onStart(): Promise<void>;
-  /**
-   * Shows every socket on a Live thread where the drafts its cards name stand now, as the API
-   * asks once one of them is renamed or ends (ADR 0025). Nothing of it goes in the transcript.
-   */
-  showDrafts(): Promise<void>;
-  /**
-   * Opens the thread from the API, with no studio connected, as a Live thread handing a request
-   * off to a draft does (ADR 0025): records what it belongs to and the API's origin, adds the
-   * Brief, which the model reads and studios show as from Camox, then the editor's messages
-   * under their name, and starts the agent's run, which acts as that editor. Every message but
-   * the last goes in before the run, the last starting it, so the model reads them all on its
-   * first call. Repeating it changes nothing.
-   */
-  open({ identity, apiOrigin, brief, editor, messages }: ThreadOpening): Promise<void>;
-  /**
-   * Adds Camox's `note` that the draft `draftId`, which this Live thread started, ended, at the
-   * end of the conversation: right away when the thread is idle, or else at the next break of
-   * the run going, as Pi places a write the model reads. Only the model reads it, and it asks the
-   * model nothing: nothing earlier, nor the system prompt, changes (ADR 0025). Repeating it adds
-   * nothing.
-   */
-  noteDraftEnded({ draftId, note }: {
-    draftId: string;
-    note: string;
-  }): Promise<void>;
-  /**
-   * Ends the thread with its draft, wiping everything it stored, since Pi can't delete a
-   * conversation yet: the run going stops, and studios still open on it see an empty thread
-   * before their sockets close. The sandbox's object for the thread stores nothing.
-   *
-   * Its draft no longer names it, and a development draft, which stays open, gets a new thread,
-   * but a socket the API forwarded just before may still reach it. So the thread keeps the
-   * record that it ended, and turns away every socket and message after, as its alarm does
-   * nothing: nothing opens Pi again. The object isn't reset, which would fail whatever reached
-   * it next.
-   */
-  end(): Promise<void>;
-}
-//#endregion
-//#region ../../apps/api/src/domains/code/main-copy.d.ts
-/** A file of a project's code: its content, or where a symlink points. */
-type CodeFile = {
-  path: string;
-  content: Uint8Array;
-} | {
-  path: string;
-  symlink: string;
-};
-//#endregion
-//#region ../../apps/api/src/durable-objects/project-code.d.ts
-/** What `snapshot` answers: the files only when the caller doesn't already have that commit. */
-type MainSnapshot = {
-  commit: string;
-  files?: CodeFile[];
-};
-/**
- * A read-only copy of one project's `main`, addressed by its Project ID, which names its repo.
- * The agent reads the website's code from it on Live, and in a draft without code. A push to
- * `main` refreshes it (the release Workflow), and a copy that was never made is made on its first
- * read. It keeps the files in its SQLite, so an eviction doesn't clone again; Git's own directory
- * isn't kept.
- */
-declare class ProjectCode extends DurableObject<Bindings> {
-  #private;
-  constructor(ctx: DurableObjectState, env: Bindings);
-  /**
-   * Makes the copy match `main`, unless it already holds `commit`, the commit a push moved `main`
-   * to. Returns the commit it holds. One refresh at a time.
-   */
-  refresh(commit?: string): Promise<string>;
-  /** Deletes the copy, as its project is deleted. */
-  discard(): Promise<void>;
-  /** The commit of `main` the copy holds, without making it if it never was. */
-  commit(): Promise<string | undefined>;
-  /** The copy, made first if it never was; only its commit when it's `known`. */
-  snapshot(known?: string): Promise<MainSnapshot>;
-}
-//#endregion
 //#region ../../apps/api/src/domains/code/remote-env.d.ts
 /** The operations sent as they are: every argument but the context is plain data. */
 declare const SENT: ["absolutePath", "joinPath", "readTextFile", "readTextLines", "readBinaryFile", "writeFile", "appendFile", "truncateFile", "flushFile", "renameFile", "fileInfo", "listDir", "canonicalPath", "exists", "createDir", "remove"];
@@ -6225,7 +6055,19 @@ type EnvAnswer = {
   };
 };
 //#endregion
+//#region ../../apps/api/src/lib/timing.d.ts
+/** What a span's line says beside its name and duration. Undefined fields are left out. */
+type SpanFields = Record<string, string | number | boolean | null | undefined>;
+//#endregion
 //#region ../../apps/api/src/durable-objects/draft-code.d.ts
+/** A revision of the draft whose build goes up as its publish script. */
+type PublishUpload = {
+  /** The project's Project ID. */
+  project: string;
+  revision: string;
+  /** Its build in `REVISION_BUILDS`. */
+  archiveKey: string;
+};
 /** A commit `prepareCommit` made, not on the branch yet. */
 type PreparedCommit = {
   commit: string;
@@ -6319,83 +6161,382 @@ declare class DraftCode extends DurableObject<Bindings> {
    * clashed: unless the files still hold a merge no commit landed.
    */
   settleClash(): Promise<void>;
+  /**
+   * Uploads the build of the draft's revision `revision` as the draft's publish script, ahead of
+   * its publish, unless the script holds it already: its publish then only checks it's there
+   * (`uploadForPublish`). Nothing once a publish took the script, until that publish ends, nor
+   * once the draft ended. A draft that ended during the upload, deleted, loses the script.
+   */
+  prepareUpload(toUpload: PublishUpload): Promise<void>;
+  /**
+   * The draft's publish script holding the build of `revision`, which the publish `instanceId`
+   * ships, taking it: no upload ahead replaces it until that publish ends. Uploads it unless the
+   * script holds it already, as the upload ahead left it. Returns its name, and whether this
+   * uploaded it.
+   */
+  uploadForPublish(toUpload: PublishUpload, instanceId: string, span?: SpanFields): Promise<{
+    script: string;
+    uploaded: boolean;
+  }>;
   /** Records that a build of the draft's code started, or ended. */
   markBuilding(building: boolean): Promise<void>;
   /**
    * Whether a build of the draft's code is going (see `BUILD_GOING_FOR_AT_MOST_MS`), or owed:
    * Camox's infrastructure failed the last one, and Camox retries it.
    */
-  building(): Promise<boolean>;
+  building(): Promise<boolean>;
+  /**
+   * Records that the thread `threadId` couldn't build the draft's code because of Camox's own
+   * infrastructure, and has it retry later (`alarm`), each retry waiting longer.
+   */
+  oweBuild({ threadId }: {
+    threadId: string;
+  }): Promise<void>;
+  /** Forgets the build Camox owed the draft, once one ended without Camox's failing. */
+  settleOwedBuild(): Promise<void>;
+  /** Retries the build Camox owes the draft, in its thread's build queue, until one lands. */
+  alarm(): Promise<void>;
+  /**
+   * Makes the draft's branch and working copy, from `commit` of `main` in the project's repo
+   * `repo`, unless they were made already. Returns the commit the branch forked from.
+   */
+  start({ repo, commit }: {
+    repo: string;
+    commit: string;
+  }): Promise<string>;
+  /** Runs one operation of the agent's environment on the working copy, and saves what it changed. */
+  call(call: EnvCall): Promise<EnvAnswer>;
+  /**
+   * The files that have merge conflict markers, as a merge of `main` that conflicts leaves them:
+   * only files the branch's head doesn't hold as they are, since no commit holds markers.
+   */
+  conflicts(): Promise<string[]>;
+  /**
+   * The working copy's files that installing its dependencies reads, as a tar archive, with its
+   * lockfile: what its sandbox needs to install ahead of a build, which `prepareCommit` would
+   * give only once it staged and committed every change.
+   */
+  installFiles(): Promise<Pick<PreparedCommit, "files" | "lockfile">>;
+  /**
+   * Stages the working copy's every change and makes, without moving the branch, the commit it
+   * would be: `message` on top of the branch's head. Returns the commit and its tree, with the
+   * tree's files as a tar archive, which a build streams into its sandbox, and the lockfile.
+   * Neither Git's directory nor the references mounted beside the files are in the tree.
+   */
+  prepareCommit({ message }: {
+    message: string;
+  }): Promise<PreparedCommit>;
+  /**
+   * Adds a member's pushed commits to the working copy, without moving the branch: the objects of
+   * `pack`, a bundle's packfile, which may build on the objects of `prerequisites`, commits of
+   * `main` fetched for it when the working copy doesn't hold them. A build then commits the
+   * pushed head (`commit`, with `checkout`).
+   */
+  receive({ pack, prerequisites }: {
+    pack: Uint8Array;
+    prerequisites: string[];
+  }): Promise<void>;
+  /**
+   * Moves the draft's branch to `commit`, which `prepareCommit` made, or a member pushed on top
+   * of the branch's head, and pushes it. A commit of the tree the branch's head already has, such
+   * as one prepared again after the push of the first, leaves the head as it is. With
+   * `checkout`, for a commit made beside the files, the files take its tree. A member's pushed
+   * head names `mergedMain`, the newest commit of `main` it holds, which the draft's next merge of
+   * `main` merges from. Returns the branch's head and its parents.
+   */
+  commit({ commit, checkout, mergedMain }: {
+    commit: string;
+    checkout?: boolean;
+    mergedMain?: string;
+  }): Promise<{
+    commit: string;
+    parents: string[];
+  }>;
+  /** Whether `commit` is the branch's head or one of its descendants: it includes the head. */
+  includesHead(commit: string): Promise<boolean>;
+  /**
+   * Pushes the draft's code to `main` as one squashed commit, as a publish lands: the tree of
+   * `commit`, a revision on the branch, with the current tip of `main` as its only parent. A
+   * `main` that already has that tree, as after a retried push that landed, is left as it is.
+   * Returns the commit `main` points to.
+   */
+  publishToMain({ commit, message }: {
+    commit: string;
+    message: string;
+  }): Promise<string>;
+  /**
+   * Merges the current `main` into the branch, without moving it: fetches `main` shallowly, its
+   * history down to the `main` commit the branch last merged or forked from, which is then the
+   * merge base, and merges it into the branch's head. A clean merge is returned as a merge commit
+   * whose parents are the head and `main`, for a build to commit (`commit`): the files stay as
+   * they are until then. A merge that conflicts changes nothing either.
+   *
+   * It waits while the files have changes no commit holds, and doesn't merge again a move of
+   * `main` that clashed. Files holding the merge of an earlier `main` that Camox's reconcile
+   * turn didn't fix (`merging`) are put back to the branch's head first, to merge this one.
+   */
+  mergeMain(): Promise<MergeOutcome>;
+  /** Deletes the draft's branch and everything the working copy stored, as the draft ends. */
+  delete(): Promise<void>;
+}
+//#endregion
+//#region ../../apps/api/src/domains/code-pushes/checks.d.ts
+/** Why a push was refused: each reason is a stable code the CLI and its users can rely on. */
+type PushRefusalReason =
+/** What was sent isn't a Git bundle of one branch's commits. */
+"invalidBundle" |
+/** The pushed tree changes a platform-owned file, which only Upgrades change. */
+"platformFile" |
+/** The pushed tree adds or changes a file under `src/` that isn't TypeScript or CSS. */
+"notCode" |
+/** `main` changed a platform-owned file since the branch last merged it. */
+"mergeMainFirst" |
+/** The branch starts from a commit that was never on `main`. */
+"baseNotOnMain" |
+/** The branch doesn't merge cleanly with the current `main`. */
+"conflictsWithMain" |
+/** The pushed head doesn't build. */
+"doesNotBuild" |
+/** The pushed head doesn't include the draft's current head. */
+"pullDraftFirst" |
+/** The draft the push names was published or deleted. */
+"draftEnded";
+type PushRefusal = {
+  reason: PushRefusalReason;
+  message: string;
+  data?: Record<string, unknown>;
+};
+/** A push that passed the checks: its head, as a commit to build, and what landing it needs. */
+type CheckedPush = {
+  /** The pushed head, as a commit to build. */
+  prepared: PreparedCommit;
+  /**
+   * The commits of `main` or of the draft's branch the pushed commits build on: the bundle's
+   * prerequisites.
+   */
+  prerequisites: string[];
+  /** The newest commit of `main` the pushed head holds, which a draft it opens forks from. */
+  base: string;
+  pack: Uint8Array;
+  /** The subject of each pushed commit, oldest first. */
+  subjects: string[];
+};
+//#endregion
+//#region ../../apps/api/src/domains/code-pushes/land.d.ts
+/** A push that passed its checks, as the draft it lands on receives it. */
+type CheckedLanding = CheckedPush & {
+  /** The project's Project ID, which names its repo. */
+  repo: string;
+};
+/** Whether the push landed, with its head's build, or why it was refused. */
+type Landing = {
+  refused: PushRefusal;
+} | {
+  result: BuildResult;
+};
+//#endregion
+//#region ../../apps/api/src/domains/revisions/merge.d.ts
+/** How a merge of `main` into a draft ended. */
+type MergeEnd =
+/** The draft holds the current `main`, or will once its changes are committed. */
+"upToDate" |
+/** A merge revision landed, built, and the draft previews it. */
+"merged" |
+/** The merge clashed: it's left for Camox's reconcile turn (`DraftCode.clash`), to start. */
+"clashed" |
+/** This move of `main` clashed already: Camox's reconcile turn had its one try. */
+"clashedBefore";
+//#endregion
+//#region ../../apps/api/src/domains/agent/service.d.ts
+type ToolExecutionResponse = {
+  ok: true;
+  result: unknown;
+} | {
+  ok: false;
+  error: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
+};
+//#endregion
+//#region ../../apps/api/src/domains/threads/tools.d.ts
+/**
+ * What a thread belongs to: its project, its draft once it has one, and for a Live thread, the
+ * editor who owns it.
+ */
+declare const threadIdentitySchema: z.ZodObject<{
+  projectId: z.ZodNumber;
+  draftId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  ownerId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type ThreadIdentity = z.infer<typeof threadIdentitySchema>;
+//#endregion
+//#region ../../apps/api/src/durable-objects/thread.d.ts
+/**
+ * How the API opens a draft's thread with no studio connected (`Thread.open`): what it belongs
+ * to, the API's public origin, the Brief from Camox, and the messages the editor sent, oldest
+ * first, each with the operation id it was sent with.
+ */
+type ThreadOpening = {
+  identity: ThreadIdentity;
+  apiOrigin: string;
+  brief: string;
+  editor: ThreadSender;
+  messages: {
+    operationId: string;
+    text: string;
+  }[];
+};
+/**
+ * Cloudflare's `PiHarness`, leaving Pi closed when the object starts until `started` holds: Pi
+ * creates its tables as it opens, and a thread nobody messaged has no run to resume.
+ */
+declare class UntilStartedPiHarness extends PiHarness {
+  #private;
+  constructor(started: () => Promise<boolean>, options: PiHarnessOptions);
+  onStart(context: CapabilityStartContext): Promise<void>;
+}
+/**
+ * One thread with Camox's agent, addressed by the thread's own id. Pi Durable runs the agent
+ * through Cloudflare's `PiHarness`, so a run is saved at every step and carries on with no client
+ * connected (ADR 0018).
+ *
+ * The API authorizes every connection before forwarding it here, naming the sender in
+ * `THREAD_SENDER_HEADER`. Each socket gets a snapshot of Pi's agent events, then a batch per
+ * commit; it sends editors' messages and can ask to resync.
+ *
+ * The thread starts with its first message: until then, connecting stores nothing, so opening a
+ * draft leaves no thread behind.
+ */
+declare class Thread extends DurableObject<Bindings> {
+  #private;
+  readonly harness: UntilStartedPiHarness;
+  readonly webSockets: WebSockets;
+  readonly lifecycle: Lifecycle<object, object>;
+  /**
+   * Builds the code of the draft `draftId`, the thread's, in its build queue, as a publish of a
+   * head revision whose build is gone asks: the head's tree finds its revision, built again.
+   */
+  buildForPublish(draftId: string): Promise<BuildResult | null>;
+  /**
+   * Lands a member's checked push `push` on the thread's draft, in its build queue, as `pusher`
+   * pushed it (ADR 0026): once the agent's turn going, if any, made its last commit, and before
+   * the next message. Starts the thread, if nobody messaged it yet, so Camox's merges of `main`
+   * reach the draft. `waiting` hears that the push waits for the turn. A push that landed adds
+   * its entry to the thread: the agent reads it, and doesn't answer it.
+   */
+  landPush(push: CheckedLanding & {
+    identity: ThreadIdentity;
+    pusher: ThreadSender;
+  }, waiting?: () => Promise<void> | void): Promise<Landing>;
   /**
-   * Records that the thread `threadId` couldn't build the draft's code because of Camox's own
-   * infrastructure, and has it retry later (`alarm`), each retry waiting longer.
+   * Adds the entry of a member's push that landed on the thread's draft, starting the thread if
+   * nobody messaged it yet: who pushed, their commits, and how the pushed head built. The model
+   * reads it as context; it starts no turn.
    */
-  oweBuild({ threadId }: {
-    threadId: string;
+  notePush(push: {
+    identity: ThreadIdentity;
+    pusher: ThreadSender;
+    subjects: string[];
+    result: BuildResult;
   }): Promise<void>;
-  /** Forgets the build Camox owed the draft, once one ended without Camox's failing. */
-  settleOwedBuild(): Promise<void>;
-  /** Retries the build Camox owes the draft, in its thread's build queue, until one lands. */
-  alarm(): Promise<void>;
   /**
-   * Makes the draft's branch and working copy, from `commit` of `main` in the project's repo
-   * `repo`, unless they were made already. Returns the commit the branch forked from.
+   * Merges the current `main` into the thread's draft, when it has code, as a push to `main`
+   * asks: right away when the agent is idle, or else right after its turn's last commit, before
+   * the next message (`#onYield`). Nothing of it shows in the thread.
    */
-  start({ repo, commit }: {
-    repo: string;
-    commit: string;
-  }): Promise<string>;
-  /** Runs one operation of the agent's environment on the working copy, and saves what it changed. */
-  call(call: EnvCall): Promise<EnvAnswer>;
+  mergeMain(): Promise<MergeEnd | "afterTheTurn" | "noCode">;
   /**
-   * The files that have merge conflict markers, as a merge of `main` that conflicts leaves them:
-   * only files the branch's head doesn't hold as they are, since no commit holds markers.
+   * Builds the code of the thread's draft, as the end of a turn would on its last try, when
+   * Camox's infrastructure failed the last build: changes that don't build are committed as a
+   * revision that isn't built, which blocks publishing. Nothing of it shows in the thread. A
+   * failure on Camox's side again owes the next retry. `busy` while the agent's turn runs: its
+   * end builds.
    */
-  conflicts(): Promise<string[]>;
+  retryBuild(): Promise<"built" | "failed" | "busy" | "noCode">;
   /**
-   * Stages the working copy's every change and makes, without moving the branch, the commit it
-   * would be: `message` on top of the branch's head. Returns the commit and its tree, with the
-   * tree's files as a tar archive, which a build streams into its sandbox, and the lockfile.
-   * Neither Git's directory nor the references mounted beside the files are in the tree.
+   * Lifecycle's alarm, which wakes Pi's runs, unless the thread ended: an alarm already on its
+   * way when it did would look for the jobs its storage no longer has.
    */
-  prepareCommit({ message }: {
-    message: string;
-  }): Promise<PreparedCommit>;
+  alarm(): Promise<void>;
+  /** Gives sockets that outlived the last isolate a new watch and a fresh snapshot. */
+  onStart(): Promise<void>;
   /**
-   * Moves the draft's branch to `commit`, which `prepareCommit` made, and pushes it. A commit of
-   * the tree the branch's head already has, such as one prepared again after the push of the
-   * first, leaves the head as it is. Returns the branch's head and its parents.
+   * Shows every socket on a Live thread where the drafts its cards name stand now, as the API
+   * asks once one of them is renamed or ends (ADR 0025). Nothing of it goes in the transcript.
    */
-  commit({ commit }: {
-    commit: string;
-  }): Promise<{
-    commit: string;
-    parents: string[];
-  }>;
+  showDrafts(): Promise<void>;
   /**
-   * Pushes the draft's code to `main` as one squashed commit, as a publish lands: the tree of
-   * `commit`, a revision on the branch, with the current tip of `main` as its only parent. A
-   * `main` that already has that tree, as after a retried push that landed, is left as it is.
-   * Returns the commit `main` points to.
+   * Opens the thread from the API, with no studio connected, as a Live thread handing a request
+   * off to a draft does (ADR 0025): records what it belongs to and the API's origin, adds the
+   * Brief, which the model reads and studios show as from Camox, then the editor's messages
+   * under their name, and starts the agent's run, which acts as that editor. Every message but
+   * the last goes in before the run, the last starting it, so the model reads them all on its
+   * first call. Repeating it changes nothing.
    */
-  publishToMain({ commit, message }: {
-    commit: string;
-    message: string;
-  }): Promise<string>;
+  open({ identity, apiOrigin, brief, editor, messages }: ThreadOpening): Promise<void>;
   /**
-   * Merges the current `main` into the branch, without moving it: fetches `main` shallowly, its
-   * history down to the `main` commit the branch last merged or forked from, which is then the
-   * merge base, and merges it into the branch's head. A clean merge is returned as a merge commit
-   * whose parents are the head and `main`, for a build to commit (`commit`): the files stay as
-   * they are until then. A merge that conflicts changes nothing either.
+   * Adds Camox's `note` that the draft `draftId`, which this Live thread started, ended, at the
+   * end of the conversation: right away when the thread is idle, or else at the next break of
+   * the run going, as Pi places a write the model reads. Only the model reads it, and it asks the
+   * model nothing: nothing earlier, nor the system prompt, changes (ADR 0025). Repeating it adds
+   * nothing.
+   */
+  noteDraftEnded({ draftId, note }: {
+    draftId: string;
+    note: string;
+  }): Promise<void>;
+  /**
+   * Ends the thread with its draft, wiping everything it stored, since Pi can't delete a
+   * conversation yet: the run going stops, and studios still open on it see an empty thread
+   * before their sockets close. The sandbox's object for the thread stores nothing.
    *
-   * It waits while the files have changes no commit holds, and doesn't merge again a move of
-   * `main` that clashed. Files holding the merge of an earlier `main` that Camox's reconcile
-   * turn didn't fix (`merging`) are put back to the branch's head first, to merge this one.
+   * Its draft is gone, but a socket the API forwarded just before may still reach it. So the thread keeps the
+   * record that it ended, and turns away every socket and message after, as its alarm does
+   * nothing: nothing opens Pi again. The object isn't reset, which would fail whatever reached
+   * it next.
    */
-  mergeMain(): Promise<MergeOutcome>;
-  /** Deletes the draft's branch and everything the working copy stored, as the draft ends. */
-  delete(): Promise<void>;
+  end(): Promise<void>;
+}
+//#endregion
+//#region ../../apps/api/src/domains/code/main-copy.d.ts
+/** A file of a project's code: its content, or where a symlink points. */
+type CodeFile = {
+  path: string;
+  content: Uint8Array;
+} | {
+  path: string;
+  symlink: string;
+};
+//#endregion
+//#region ../../apps/api/src/durable-objects/project-code.d.ts
+/** What `snapshot` answers: the files only when the caller doesn't already have that commit. */
+type MainSnapshot = {
+  commit: string;
+  files?: CodeFile[];
+};
+/**
+ * A read-only copy of one project's `main`, addressed by its Project ID, which names its repo.
+ * The agent reads the website's code from it on Live, and in a draft without code. A push to
+ * `main` refreshes it (the release Workflow), and a copy that was never made is made on its first
+ * read. It keeps the files in its SQLite, so an eviction doesn't clone again; Git's own directory
+ * isn't kept.
+ */
+declare class ProjectCode extends DurableObject<Bindings> {
+  #private;
+  constructor(ctx: DurableObjectState, env: Bindings);
+  /**
+   * Makes the copy match `main`, unless it already holds `commit`, the commit a push moved `main`
+   * to. Returns the commit it holds. One refresh at a time.
+   */
+  refresh(commit?: string): Promise<string>;
+  /** Deletes the copy, as its project is deleted. */
+  discard(): Promise<void>;
+  /** The commit of `main` the copy holds, without making it if it never was. */
+  commit(): Promise<string | undefined>;
+  /** The copy, made first if it never was; only its commit when it's `known`. */
+  snapshot(known?: string): Promise<MainSnapshot>;
 }
 //#endregion
 //#region ../../apps/api/src/domains/project-creation/workflow.d.ts
@@ -6460,22 +6601,30 @@ type RevisionToLoad = {
 };
 /** Dispatch's `CamoxRevisions` entrypoint. */
 type Dispatch = {
-  /** A revision's Definition Set, as its build's entrypoint gives it: JSON, not yet checked. */
-  readDefinitionSet(revision: RevisionToLoad): Promise<unknown>;
   /**
-   * Readies a revision before its draft's viewers are told of it: dispatch serves its client
-   * assets from then on, and has loaded and rendered it once. Says how many client assets it
-   * stored and how long that and the render took, for the API's timing logs (none from a
-   * dispatch older than that).
+   * Readies a revision before its draft's viewers are told of it, reading its build once:
+   * dispatch serves its client assets from then on, and has loaded and rendered it once. Returns
+   * its Definition Set (JSON, not yet checked), with what each part took, for the API's timing
+   * logs.
    */
-  prewarm(revision: RevisionToLoad): Promise<PrewarmTimings | void>;
+  prepare(revision: RevisionToLoad): Promise<PreparedRevision>;
 };
-/** What a prewarm took. Mirrored in apps/dispatch/src/revisions.ts: keep the two in sync. */
-type PrewarmTimings = {
+/**
+ * What preparing a revision took: reading its build, then, at once, storing its client assets
+ * (how many) and reading its Definition Set, then the first render. Mirrored in
+ * apps/dispatch/src/revisions.ts: keep the two in sync.
+ */
+type PrepareTimings = {
   assets: number;
+  readMs: number;
   assetsMs: number;
+  definitionSetMs: number;
   renderMs: number;
 };
+/** A prepared revision's Definition Set, with what preparing it took. */
+type PreparedRevision = PrepareTimings & {
+  definitionSet: unknown;
+};
 //#endregion
 //#region ../../apps/api/src/types.d.ts
 type Bindings = {
@@ -6506,7 +6655,10 @@ type Bindings = {
   /** The sandbox Worker's Durable Object running code mode scripts, one per thread (ADR 0018). */
   CODEMODE_SANDBOX: DurableObjectNamespace<import("@earendil-works/pi-codemode/cloudflare").CodemodeSandboxDurableObject>;
   FILES_BUCKET: R2Bucket;
-  /** Project Slug → Project ID: which project each `<slug>.camox.site` host serves. */
+  /**
+   * Project Slug or Custom Domain → Project ID: which project each `<slug>.camox.site` host and
+   * Custom Domain serves (apps/dispatch/README.md).
+   */
   PROJECT_SLUGS: KVNamespace;
   MEDIA?: MediaBinding;
   /** The `projects` Cloudflare Artifacts namespace: every project's repo, and the Template's. */
@@ -6942,7 +7094,6 @@ type Person = {
 //#region ../../apps/api/src/domains/drafts/list.d.ts
 type DraftSummary = {
   id: string;
-  kind: DraftKind;
   name: string | null;
   createdBy: Person;
   createdAt: number;
@@ -7035,8 +7186,8 @@ type Owner = {
   name: string;
   title: string;
 } | null;
-/** What a preview can mention: an entity drafts hold, a definition (ADR 0006), or its code. */
-type SubjectKind = EntityKind | "definition" | "code";
+/** What a preview can mention: an entity drafts hold, or its code. */
+type SubjectKind = EntityKind | "code";
 /** An entity as people know it. */
 type Subject = {
   entity: SubjectKind;
@@ -7092,7 +7243,7 @@ type LostChange = Subject & InLocale & {
   reason: (typeof LOSS_REASONS)[number];
 };
 /** What a blocker or warning is about. */
-declare const PROBLEM_CODES: readonly ["definitionsDiffer", "codeDoesNotBuild", "codeDoesNotTypeCheck", "codeDoesNotMerge", "emptyRequiredFile", "missingFile", "missingFileBytes", "unacceptedFileType", "duplicatePath", "duplicateRecordPageValue", "emptyRequiredReference", "danglingReference", "danglingPageLink", "wrongKindValue", "missingMetaTitle", "metaTitlePending", "localePrefixTaken", "duplicateLocale", "removedInUse"];
+declare const PROBLEM_CODES: readonly ["codeDoesNotBuild", "codeDoesNotTypeCheck", "codeDoesNotMerge", "emptyRequiredFile", "missingFile", "missingFileBytes", "unacceptedFileType", "duplicatePath", "duplicateRecordPageValue", "emptyRequiredReference", "danglingReference", "danglingPageLink", "wrongKindValue", "missingMetaTitle", "metaTitlePending", "localePrefixTaken", "duplicateLocale", "removedInUse"];
 /** A blocker, or the same problem already on Live as a warning, naming what to fix. */
 type Problem = Subject & InLocale & ProblemPlace & {
   code: (typeof PROBLEM_CODES)[number];
@@ -7121,8 +7272,7 @@ type PublishPreview = {
 };
 /**
  * What publishing did: nothing, for an empty draft, which publishing leaves as is; or how the
- * draft ended, also when an earlier attempt ended it (null for a development draft, which stays
- * open, emptied).
+ * draft ended, also when an earlier attempt ended it.
  */
 type PublishResult = {
   empty: true;
@@ -7137,6 +7287,16 @@ type PublishResult = {
   publishing: true;
 };
 //#endregion
+//#region ../../apps/api/src/domains/code-pushes/service.d.ts
+/** Where a push stands, as it streams to the CLI while the push goes. */
+type PushStep =
+/** Its commits are checked against `main` and the draft. */
+"checking" |
+/** It waits for the agent's turn going in the draft to end. */
+"waiting" |
+/** Its head builds. */
+"building";
+//#endregion
 //#region ../../apps/api/src/router.d.ts
 declare const router: {
   projects: {
@@ -7191,6 +7351,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       name: string;
       deployToken: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
@@ -7205,6 +7366,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       createdAt: number;
       updatedAt: number;
     }[], {
@@ -7212,6 +7374,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       name: string;
       deployToken: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
@@ -7226,6 +7389,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       createdAt: number;
       updatedAt: number;
     }[]>, Record<never, never>, Record<never, never>>;
@@ -7279,6 +7443,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       name: string;
       deployToken: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
@@ -7293,12 +7458,14 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       createdAt: number;
       updatedAt: number;
     }, {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       name: string;
       deployToken: string;
       status: import("@camox/api-contract/projects").ProjectStatus;
@@ -7313,6 +7480,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       createdAt: number;
       updatedAt: number;
     }>, Record<never, never>, Record<never, never>>;
@@ -7370,6 +7538,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7383,6 +7552,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }, {
       organizationSlug: string | null;
@@ -7392,6 +7562,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7405,6 +7576,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }>, Record<never, never>, Record<never, never>>;
     getByUuid: 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>>, {
@@ -7461,6 +7633,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7474,6 +7647,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }, {
       organizationSlug: string | null;
@@ -7483,6 +7657,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7496,6 +7671,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }>, Record<never, never>, Record<never, never>>;
     getSummary: import("@orpc/server").DecoratedProcedure<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>>, {
@@ -7569,6 +7745,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7582,6 +7759,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }, {
       organizationSlug: string | null;
@@ -7591,6 +7769,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7604,6 +7783,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }>, Record<never, never>, Record<never, never>>;
     checkSlugAvailability: 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>>, {
@@ -7719,6 +7899,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7732,6 +7913,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }, {
       name: string;
@@ -7739,6 +7921,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7752,6 +7935,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }>, Record<never, never>, Record<never, never>>;
     update: 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>>, {
@@ -7807,6 +7991,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7820,6 +8005,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }, {
       name: string;
@@ -7827,6 +8013,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -7840,6 +8027,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     }>, Record<never, never>, Record<never, never>>;
     updateAnalytics: 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>>, {
@@ -7959,6 +8147,63 @@ declare const router: {
       socialProfiles: string[];
       updatedAt: number;
     }>, Record<never, never>, Record<never, never>>;
+    createCodeReadToken: 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;
+    }>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+    }>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+    }>, {
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      };
+      session: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined;
+        userAgent?: string | null | undefined;
+        activeOrganizationId?: string | null | undefined;
+        studio?: boolean | null | undefined;
+      };
+      db: Database;
+      env: Bindings;
+      headers: Headers;
+      client: string;
+      telemetryDisabled: boolean;
+      waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+    }>, import("zod").ZodObject<{
+      projectUuid: import("zod").ZodUUID;
+    }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
+      remote: any;
+      token: any;
+      expiresAt: any;
+      projectSlug: string;
+    }, {
+      remote: any;
+      token: any;
+      expiresAt: any;
+      projectSlug: string;
+    }>, Record<never, never>, 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;
@@ -8011,6 +8256,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -8024,6 +8270,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     } | undefined, {
       name: string;
@@ -8031,6 +8278,7 @@ declare const router: {
       id: number;
       uuid: string;
       slug: string;
+      customDomain: string | null;
       deployToken: string;
       setupStep: import("@camox/api-contract/projects").ProjectSetupStep | null;
       createdAt: number;
@@ -8044,6 +8292,7 @@ declare const router: {
       publishPushInstanceId: string | null;
       publishPushRequestedAt: number | null;
       liveScript: string | null;
+      codeOutsideCamox: boolean;
       updatedAt: number;
     } | undefined>, Record<never, never>, Record<never, never>>;
   };
@@ -8099,7 +8348,6 @@ declare const router: {
         afterBlockIds: string[];
       } | null;
       blocks: (Omit<{
-        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -8107,6 +8355,7 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
+        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -8206,7 +8455,6 @@ declare const router: {
         afterBlockIds: string[];
       } | null;
       blocks: (Omit<{
-        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -8214,6 +8462,7 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
+        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -9456,7 +9705,6 @@ declare const router: {
       id: import("zod").ZodUUID;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
       block: Omit<{
-        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -9464,6 +9712,7 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
+        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -9519,7 +9768,6 @@ declare const router: {
       files: FileView[];
     }, {
       block: Omit<{
-        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -9527,6 +9775,7 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
+        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -9656,7 +9905,6 @@ declare const router: {
       type: import("zod").ZodString;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
       block: Omit<{
-        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -9664,6 +9912,7 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
+        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -9719,7 +9968,6 @@ declare const router: {
       files: FileView[];
     } | null, {
       block: Omit<{
-        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -9727,6 +9975,7 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
+        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -9880,7 +10129,6 @@ declare const router: {
         position: import("zod").ZodString;
       }, import("zod/v4/core").$strip>>>;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<Omit<{
-      type: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
@@ -9888,6 +10136,7 @@ declare const router: {
       locale: string;
       pageId: string | null;
       layoutId: string | null;
+      type: string;
       content: unknown;
       createdAt: number;
       updatedAt: number;
@@ -9909,7 +10158,6 @@ declare const router: {
     } & {
       warnings?: string[];
     }, Omit<{
-      type: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
@@ -9917,6 +10165,7 @@ declare const router: {
       locale: string;
       pageId: string | null;
       layoutId: string | null;
+      type: string;
       content: unknown;
       createdAt: number;
       updatedAt: number;
@@ -10524,7 +10773,6 @@ declare const router: {
         afterBlockIds: string[];
       };
       blocks: (Omit<{
-        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -10532,6 +10780,7 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
+        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -10603,7 +10852,6 @@ declare const router: {
         afterBlockIds: string[];
       };
       blocks: (Omit<{
-        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -10611,6 +10859,7 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
+        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -13595,8 +13844,7 @@ declare const router: {
       locale: string | undefined;
       publishingDraft: string | undefined;
     }>, import("zod").ZodObject<{
-      deployToken: import("zod").ZodOptional<import("zod").ZodString>;
-      autoCreate: import("zod").ZodBoolean;
+      deployToken: import("zod").ZodString;
       definitionSet: import("zod").ZodObject<{
         blocks: import("zod").ZodArray<import("zod").ZodObject<{
           blockId: import("zod").ZodString;
@@ -13787,7 +14035,6 @@ declare const router: {
       }, import("zod/v4/core").$strip>;
       projectUuid: import("zod").ZodUUID;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
-      draftCreated: boolean;
       blocks: {
         count: number;
         deletedDefinitionTypes: string[];
@@ -13816,7 +14063,6 @@ declare const router: {
         blockCount: number;
       } | null;
     }, {
-      draftCreated: boolean;
       blocks: {
         count: number;
         deletedDefinitionTypes: string[];
@@ -14500,6 +14746,76 @@ declare const router: {
       patrollers: import("@camox/api-contract/patrol").PatrollerView[];
     }>, Record<never, never>, Record<never, never>>;
   };
+  code: {
+    push: 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;
+    }>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+    }>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+    }>, {
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      };
+      session: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined;
+        userAgent?: string | null | undefined;
+        activeOrganizationId?: string | null | undefined;
+        studio?: boolean | null | undefined;
+      };
+      db: Database;
+      env: Bindings;
+      headers: Headers;
+      client: string;
+      telemetryDisabled: boolean;
+      waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string | undefined;
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+    }>, import("zod").ZodObject<{
+      projectUuid: import("zod").ZodUUID;
+      branch: import("zod").ZodString;
+      draftId: import("zod").ZodOptional<import("zod").ZodString>;
+      bundle: import("zod").ZodInstanceOf<Blob>;
+    }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<AsyncGenerator<{
+      type: "progress";
+      step: PushStep;
+    } | {
+      draftId: string;
+      result: BuildResult;
+      studioUrl: string;
+      type: "pushed";
+      step?: undefined;
+    }, void, unknown>, AsyncGenerator<{
+      type: "progress";
+      step: PushStep;
+    } | {
+      draftId: string;
+      result: BuildResult;
+      studioUrl: string;
+      type: "pushed";
+      step?: undefined;
+    }, void, unknown>>, Record<never, never>, Record<never, never>>;
+  };
 };
 type Router = typeof router;
 //#endregion