@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/contract/projects.d.ts

@@ -5,18 +5,48 @@ import { z } from 'zod';
  *
  * Node-free by construction (see README rule 1) — `zod` and nothing else.
  */
+/** One task state a project webhook sends deliveries for (hearsay-tools/cezarion#1356). */
+export declare const webhookTriggerSchema: z.ZodEnum<{
+    cancelled: "cancelled";
+    done: "done";
+    failed: "failed";
+    "needs-you": "needs-you";
+    running: "running";
+    "waiting-ci": "waiting-ci";
+    "waiting-other": "waiting-other";
+    "waiting-timer": "waiting-timer";
+    "waiting-workers": "waiting-workers";
+}>;
 /**
- * One `GET /api/v1/projects` registry entry (multi-project spec, step 1.6).
- *
- * Unlike health's id+name pairs this carries the absolute `root`: the registry routes are
- * same-origin, the CORS-open health route is not, and that difference is the reason the two
- * project shapes are deliberately NOT the same type.
- *
- * Deliberately a CLOSED object even though the server's persistence schema
- * (`src/workspace/config.ts`, `workspaceProjectSchema.passthrough()`) keeps unknown keys in the
- * file: passthrough is a durability promise about `~/.cezar/config.json`, not a promise that the
- * API answers arbitrary keys. Modelling it as a loose object here would also be unprovable — see
- * the note on the index signature in `src/server/contract-parity.workspace.test.ts`.
+ * One project webhook as it leaves the server (hearsay-tools/cezarion#1576). The token is
+ * write-only: the wire says only whether one is set. `tasks` turns task notifications on: runs
+ * with `notify` on POST here when they enter a state in `triggers` (absent means
+ * `DEFAULT_WEBHOOK_TRIGGERS`, `[]` none). `agent` lets agents in the project send reports here.
+ */
+export declare const projectWebhookSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+    tokenSet: z.ZodBoolean;
+    tasks: z.ZodBoolean;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        "needs-you": "needs-you";
+        running: "running";
+        "waiting-ci": "waiting-ci";
+        "waiting-other": "waiting-other";
+        "waiting-timer": "waiting-timer";
+        "waiting-workers": "waiting-workers";
+    }>>>;
+    agent: z.ZodBoolean;
+}, z.core.$strip>;
+export type ProjectWebhook = z.infer<typeof projectWebhookSchema>;
+/**
+ * Closed registry response including absolute root. Keep it distinct from CORS-open health’s
+ * id/name pairs. Storage passthrough does not widen the wire contract.
  */
 export declare const projectListEntrySchema: z.ZodObject<{
     id: z.ZodString;
@@ -41,7 +71,38 @@ export declare const projectListEntrySchema: z.ZodObject<{
     webhook: z.ZodOptional<z.ZodObject<{
         url: z.ZodString;
         tokenSet: z.ZodBoolean;
+        triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            "needs-you": "needs-you";
+            running: "running";
+            "waiting-ci": "waiting-ci";
+            "waiting-other": "waiting-other";
+            "waiting-timer": "waiting-timer";
+            "waiting-workers": "waiting-workers";
+        }>>>;
     }, z.core.$strip>>;
+    webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+        tokenSet: z.ZodBoolean;
+        tasks: z.ZodBoolean;
+        triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            "needs-you": "needs-you";
+            running: "running";
+            "waiting-ci": "waiting-ci";
+            "waiting-other": "waiting-other";
+            "waiting-timer": "waiting-timer";
+            "waiting-workers": "waiting-workers";
+        }>>>;
+        agent: z.ZodBoolean;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type ProjectListEntry = z.infer<typeof projectListEntrySchema>;
 /** `GET /api/v1/projects` — the workspace registry. Workspace-level: never 404s, never scoped.
@@ -71,7 +132,38 @@ export declare const projectsResponseSchema: z.ZodObject<{
         webhook: z.ZodOptional<z.ZodObject<{
             url: z.ZodString;
             tokenSet: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
         }, z.core.$strip>>;
+        webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+            tasks: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
+            agent: z.ZodBoolean;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
     bootProject: z.ZodString;
     projectsDir: z.ZodString;
@@ -106,7 +198,38 @@ export declare const registerProjectResponseSchema: z.ZodObject<{
         webhook: z.ZodOptional<z.ZodObject<{
             url: z.ZodString;
             tokenSet: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
         }, z.core.$strip>>;
+        webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+            tasks: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
+            agent: z.ZodBoolean;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -149,26 +272,230 @@ export declare const updateProjectResponseSchema: z.ZodObject<{
         webhook: z.ZodOptional<z.ZodObject<{
             url: z.ZodString;
             tokenSet: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
         }, z.core.$strip>>;
+        webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+            tasks: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
+            agent: z.ZodBoolean;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type UpdateProjectResponse = z.infer<typeof updateProjectResponseSchema>;
-/** Bounds for one tag and for a project's tag list. Named because three places must agree: this
- *  schema, the registry schema that must never `.catch` away a value this accepts
- *  (`workspaceProjectSchema` in the service), and the settings editor that refuses input early. */
-export declare const PROJECT_TAG_MAX_LENGTH = 32;
-export declare const PROJECT_TAGS_MAX = 20;
-/** Bounds shared by the PATCH body and the registry schema, so a stored value can never be
- *  degraded away by the next load's `.catch`. */
-export declare const PROJECT_WEBHOOK_URL_MAX_LENGTH = 2048;
-export declare const PROJECT_WEBHOOK_TOKEN_MAX_LENGTH = 1024;
 /** An `http(s)` URL. Anything else (`file:`, `javascript:`) is refused before it is stored. */
 export declare const projectWebhookUrlSchema: z.ZodPipe<z.ZodString, z.ZodURL>;
 export declare const projectWebhookInputSchema: z.ZodObject<{
     url: z.ZodPipe<z.ZodString, z.ZodURL>;
     token: z.ZodOptional<z.ZodString>;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        "needs-you": "needs-you";
+        running: "running";
+        "waiting-ci": "waiting-ci";
+        "waiting-other": "waiting-other";
+        "waiting-timer": "waiting-timer";
+        "waiting-workers": "waiting-workers";
+    }>>>;
 }, z.core.$strip>;
 export type ProjectWebhookInput = z.infer<typeof projectWebhookInputSchema>;
+export declare const projectWebhookNameSchema: z.ZodString;
+/** `POST /api/v1/projects/:projectId/webhooks` (hearsay-tools/cezarion#1576). `tasks` and `agent`
+ *  default to off; an omitted `triggers` stores none, which means the default selection. */
+export declare const createProjectWebhookInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    url: z.ZodPipe<z.ZodString, z.ZodURL>;
+    token: z.ZodOptional<z.ZodString>;
+    tasks: z.ZodOptional<z.ZodBoolean>;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        "needs-you": "needs-you";
+        running: "running";
+        "waiting-ci": "waiting-ci";
+        "waiting-other": "waiting-other";
+        "waiting-timer": "waiting-timer";
+        "waiting-workers": "waiting-workers";
+    }>>>;
+    agent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CreateProjectWebhookInput = z.infer<typeof createProjectWebhookInputSchema>;
+/** `PATCH /api/v1/projects/:projectId/webhooks/:webhookId`: each key applies only when named. An
+ *  omitted `token` keeps the stored one and `''` clears it; `''` clears the description too. */
+export declare const updateProjectWebhookInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodURL>>;
+    token: z.ZodOptional<z.ZodString>;
+    tasks: z.ZodOptional<z.ZodBoolean>;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        "needs-you": "needs-you";
+        running: "running";
+        "waiting-ci": "waiting-ci";
+        "waiting-other": "waiting-other";
+        "waiting-timer": "waiting-timer";
+        "waiting-workers": "waiting-workers";
+    }>>>;
+    agent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type UpdateProjectWebhookInput = z.infer<typeof updateProjectWebhookInputSchema>;
+export declare const projectWebhookParamsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    webhookId: z.ZodString;
+}, z.core.$strip>;
+/** The create and edit answer: the whole project entry, and the webhook the request touched. */
+export declare const projectWebhookResponseSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        root: z.ZodString;
+        addedAt: z.ZodString;
+        lastOpenedAt: z.ZodString;
+        source: z.ZodEnum<{
+            checkout: "checkout";
+            local: "local";
+        }>;
+        status: z.ZodEnum<{
+            missing: "missing";
+            "not-git": "not-git";
+            ok: "ok";
+        }>;
+        branch: z.ZodOptional<z.ZodString>;
+        forge: z.ZodOptional<z.ZodLiteral<"github">>;
+        repoUrl: z.ZodOptional<z.ZodString>;
+        maxParallel: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        webhook: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
+        }, z.core.$strip>>;
+        webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+            tasks: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
+            agent: z.ZodBoolean;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    webhook: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+        tokenSet: z.ZodBoolean;
+        tasks: z.ZodBoolean;
+        triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            "needs-you": "needs-you";
+            running: "running";
+            "waiting-ci": "waiting-ci";
+            "waiting-other": "waiting-other";
+            "waiting-timer": "waiting-timer";
+            "waiting-workers": "waiting-workers";
+        }>>>;
+        agent: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ProjectWebhookResponse = z.infer<typeof projectWebhookResponseSchema>;
+/** One webhook an agent may send reports to: what it is for, never where it points. */
+export declare const agentWebhookSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AgentWebhook = z.infer<typeof agentWebhookSchema>;
+/** `GET /api/v1/projects/:projectId/agent-webhooks` — the webhooks exposed to agents. */
+export declare const agentWebhooksResponseSchema: z.ZodObject<{
+    webhooks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentWebhooksResponse = z.infer<typeof agentWebhooksResponseSchema>;
+export declare const agentWebhookParamsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    webhook: z.ZodString;
+}, z.core.$strip>;
+/** `POST /api/v1/projects/:projectId/agent-webhooks/:webhook` — one `agent.report` delivery.
+ *  `message` is Markdown; `data` is any JSON object the receiving service understands. */
+export declare const sendAgentReportInputSchema: z.ZodObject<{
+    runId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type SendAgentReportInput = z.infer<typeof sendAgentReportInputSchema>;
+export declare const sendAgentReportResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    webhook: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    deliveryId: z.ZodString;
+    attempts: z.ZodNumber;
+    status: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SendAgentReportResponse = z.infer<typeof sendAgentReportResponseSchema>;
 /** `POST /api/v1/projects/:projectId/webhook/test` (#589) — one `task.test` delivery, sent now
  *  with the same timeout the real deliveries use. `status` is the endpoint's HTTP status. */
 export declare const testProjectWebhookResponseSchema: z.ZodObject<{
@@ -204,6 +531,17 @@ export declare const updateProjectInputSchema: z.ZodObject<{
     webhook: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         url: z.ZodPipe<z.ZodString, z.ZodURL>;
         token: z.ZodOptional<z.ZodString>;
+        triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            "needs-you": "needs-you";
+            running: "running";
+            "waiting-ci": "waiting-ci";
+            "waiting-other": "waiting-other";
+            "waiting-timer": "waiting-timer";
+            "waiting-workers": "waiting-workers";
+        }>>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type UpdateProjectInput = z.infer<typeof updateProjectInputSchema>;
@@ -219,6 +557,112 @@ export declare const checkoutProjectInputSchema: z.ZodObject<{
     checkoutId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CheckoutProjectInput = z.infer<typeof checkoutProjectInputSchema>;
+/**
+ * `POST /api/v1/projects/create` (spec 2026-10-15-create-new-project, a port of
+ * open-mercato/cezar#1402) — a fresh git repo at `<projectsDir>/<name>`. `github` present ⇒ also
+ * a new GitHub repository under `owner`, which is ALWAYS private: there is deliberately no
+ * visibility field, and one must never be added. `template` (`owner/repo` or a GitHub URL)
+ * generates the repository from a template instead of starting empty. Progress arrives as
+ * `checkout-progress`, keyed by `checkoutId`, like the clone flow.
+ */
+export declare const createProjectInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    github: z.ZodOptional<z.ZodObject<{
+        owner: z.ZodString;
+        template: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    checkoutId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateProjectInput = z.infer<typeof createProjectInputSchema>;
+/** The registered project, plus `warning` when the GitHub repository was created but a later step
+ *  (remote, credentials, push) did not finish. The local project is kept and registered; the
+ *  warning names the repository and the command that finishes the job. */
+export declare const createProjectResponseSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        root: z.ZodString;
+        addedAt: z.ZodString;
+        lastOpenedAt: z.ZodString;
+        source: z.ZodEnum<{
+            checkout: "checkout";
+            local: "local";
+        }>;
+        status: z.ZodEnum<{
+            missing: "missing";
+            "not-git": "not-git";
+            ok: "ok";
+        }>;
+        branch: z.ZodOptional<z.ZodString>;
+        forge: z.ZodOptional<z.ZodLiteral<"github">>;
+        repoUrl: z.ZodOptional<z.ZodString>;
+        maxParallel: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        webhook: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
+        }, z.core.$strip>>;
+        webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+            tasks: z.ZodBoolean;
+            triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                "needs-you": "needs-you";
+                running: "running";
+                "waiting-ci": "waiting-ci";
+                "waiting-other": "waiting-other";
+                "waiting-timer": "waiting-timer";
+                "waiting-workers": "waiting-workers";
+            }>>>;
+            agent: z.ZodBoolean;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    error: z.ZodOptional<z.ZodString>;
+    warning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateProjectResponse = z.infer<typeof createProjectResponseSchema>;
+/** One account a new repository may belong to: the signed-in user first (`personal: true`), then
+ *  their organisations. `avatarUrl`/`description` are absent when GitHub gives none. */
+export declare const githubOwnerSchema: z.ZodObject<{
+    login: z.ZodString;
+    personal: z.ZodBoolean;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GithubOwner = z.infer<typeof githubOwnerSchema>;
+/** `GET /api/v1/projects/github-owners` — the accounts a new repository may belong to. Never an
+ *  error: no `gh`, an unauthenticated one, or a hosted cockpit answers `available: false` with the
+ *  reason. */
+export declare const githubOwnersResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    available: z.ZodLiteral<true>;
+    owners: z.ZodArray<z.ZodObject<{
+        login: z.ZodString;
+        personal: z.ZodBoolean;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    available: z.ZodLiteral<false>;
+    reason: z.ZodString;
+}, z.core.$strip>], "available">;
+export type GithubOwnersResponse = z.infer<typeof githubOwnersResponseSchema>;
 /** One directory in a `GET /api/v1/fs/browse` listing (multi-project spec, step 4.1). `path` is
  *  absolute — same-origin route, like `ProjectListEntry.root`. */
 export declare const fsBrowseDirSchema: z.ZodObject<{
@@ -248,3 +692,25 @@ export declare const launchKeyResponseSchema: z.ZodObject<{
     key: z.ZodString;
 }, z.core.$strip>;
 export type LaunchKeyResponse = z.infer<typeof launchKeyResponseSchema>;
+export declare const checkoutProgressParamsSchema: z.ZodObject<{
+    checkoutId: z.ZodString;
+}, z.core.$strip>;
+export declare const checkoutProgressResponseSchema: z.ZodObject<{
+    progress: z.ZodNullable<z.ZodObject<{
+        checkoutId: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        phase: z.ZodEnum<{
+            cloning: "cloning";
+            done: "done";
+            error: "error";
+        }>;
+        line: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CheckoutProgressResponse = z.infer<typeof checkoutProgressResponseSchema>;
+/** Register an existing folder; validation precedes registry writes. */
+export declare const registerProjectInputSchema: z.ZodObject<{
+    root: z.ZodString;
+}, z.core.$strip>;

package/dist/contract/provider-requests.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+export declare const providerConnectSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        cursor: "cursor";
+        omp: "omp";
+        opencode: "opencode";
+        pi: "pi";
+    }>;
+    profileId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Agent-account bodies (spec 2026-07-29-agent-profiles). Bounds mirror `agentProfileSchema` in
+ *  src/workspace/config.ts exactly, so a value these accept can never be degraded away by the
+ *  next load's `.catch`. The id is allocated server-side and is never a request field. */
+export declare const createAgentProfileSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        cursor: "cursor";
+        omp: "omp";
+        opencode: "opencode";
+        pi: "pi";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+    configDir: z.ZodString;
+}, z.core.$strict>;
+/** `POST …/agent-profiles/:id/open` — a catalog id (or `folder`) plus an optional open target. */
+export declare const openAgentAccountFileSchema: z.ZodObject<{
+    file: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const updateAgentProfileSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    configDir: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** `PUT …/agent-profiles/selection` — which account a project uses for one provider. `null`
+ *  clears it back to the discovered account. */
+export declare const selectAgentProfileSchema: z.ZodObject<{
+    projectId: z.ZodNullable<z.ZodString>;
+    provider: z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        cursor: "cursor";
+        omp: "omp";
+        opencode: "opencode";
+        pi: "pi";
+    }>;
+    profileId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const providerParamSchema: z.ZodEnum<{
+    claude: "claude";
+    codex: "codex";
+    cursor: "cursor";
+    omp: "omp";
+    opencode: "opencode";
+    pi: "pi";
+}>;
+export declare const providerEnabledSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const providerRetrySchema: z.ZodObject<{
+    authFailureId: z.ZodString;
+}, z.core.$strict>;
+export declare const providerRouteParamsSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        cursor: "cursor";
+        omp: "omp";
+        opencode: "opencode";
+        pi: "pi";
+    }>;
+}, z.core.$strip>;
+export declare const agentProfileRouteParamsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;