@slopus/happy-agent-client 0.0.0

package/dist/protocol/projects.d.ts

@@ -0,0 +1,377 @@
+/** Projects: a folder registered with the daemon, or a repository it cloned. */
+import { type Static } from "@sinclair/typebox";
+import type { Agent } from "./agents.js";
+/** Where a cloned project came from; `null` for a registered local folder. */
+export declare const remoteSourceSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"github">;
+    repository: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"git">;
+    url: import("@sinclair/typebox").TString;
+}>]>;
+export type RemoteSource = Static<typeof remoteSourceSchema>;
+/**
+ * The project picture.
+ *
+ * The built-in home project — the user's machine outside any repository —
+ * carries `{ kind: "home" }` and has no image bytes to fetch.
+ */
+export declare const projectAvatarSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"image">;
+    source: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"generated">]>;
+    thumbhash: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"home">;
+}>]>;
+export type ProjectAvatar = Static<typeof projectAvatarSchema>;
+export declare const projectSettingsSchema: import("@sinclair/typebox").TObject<{
+    /** Where new workspaces of this project run. */
+    defaultWorkspaceCompute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TLiteral<"host">;
+    }>, import("@sinclair/typebox").TObject<{
+        image: import("@sinclair/typebox").TString;
+        type: import("@sinclair/typebox").TLiteral<"docker">;
+    }>]>;
+}>;
+export type ProjectSettings = Static<typeof projectSettingsSchema>;
+/** The project object. A project is also the root workspace of its tree. */
+export declare const projectSchema: import("@sinclair/typebox").TObject<{
+    /** Ordered top-level agents rooted directly in this project workspace. */
+    agents: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnsafe<Agent>>;
+    archivedAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>;
+    avatar: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"image">;
+        source: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"generated">]>;
+        thumbhash: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"home">;
+    }>]>, import("@sinclair/typebox").TNull]>;
+    compute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        path: import("@sinclair/typebox").TString;
+        type: import("@sinclair/typebox").TLiteral<"host">;
+    }>, import("@sinclair/typebox").TObject<{
+        image: import("@sinclair/typebox").TString;
+        type: import("@sinclair/typebox").TLiteral<"docker">;
+    }>]>;
+    createdAt: import("@sinclair/typebox").TInteger;
+    defaultBranch: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    description: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    /** `null` when the folder is not a Git repository. */
+    git: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        ahead: import("@sinclair/typebox").TInteger;
+        behind: import("@sinclair/typebox").TInteger;
+        branch: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+        detached: import("@sinclair/typebox").TBoolean;
+        head: import("@sinclair/typebox").TString;
+        upstream: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    }>, import("@sinclair/typebox").TNull]>;
+    id: import("@sinclair/typebox").TString;
+    initialization: import("@sinclair/typebox").TObject<{
+        attempt: import("@sinclair/typebox").TInteger;
+        error: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"initializing">, import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"failed">]>;
+    }>;
+    name: import("@sinclair/typebox").TString;
+    /** Where the name came from; a user-chosen name is never derived over. */
+    nameSource: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"folder">, import("@sinclair/typebox").TLiteral<"user">]>;
+    /** An opaque sort key; clients order projects by comparing these strings. */
+    orderKey: import("@sinclair/typebox").TString;
+    remoteSource: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"github">;
+        repository: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"git">;
+        url: import("@sinclair/typebox").TString;
+    }>]>, import("@sinclair/typebox").TNull]>;
+    settings: import("@sinclair/typebox").TObject<{
+        /** Where new workspaces of this project run. */
+        defaultWorkspaceCompute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"host">;
+        }>, import("@sinclair/typebox").TObject<{
+            image: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"docker">;
+        }>]>;
+    }>;
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"archived">]>;
+    updatedAt: import("@sinclair/typebox").TInteger;
+    version: import("@sinclair/typebox").TString;
+    /** Whether child workspaces can be created as Git worktrees. */
+    worktreeSupport: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"supported">, import("@sinclair/typebox").TLiteral<"unsupported">, import("@sinclair/typebox").TLiteral<"unknown">]>;
+    /** Accompanies `worktreeSupport` of `"unsupported"`. */
+    worktreeUnsupportedReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type Project = Static<typeof projectSchema>;
+/** `GET /v0/projects` */
+export declare const projectListResponseSchema: import("@sinclair/typebox").TObject<{
+    projects: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        /** Ordered top-level agents rooted directly in this project workspace. */
+        agents: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnsafe<Agent>>;
+        archivedAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>;
+        avatar: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"image">;
+            source: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"generated">]>;
+            thumbhash: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"home">;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        compute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            path: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"host">;
+        }>, import("@sinclair/typebox").TObject<{
+            image: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"docker">;
+        }>]>;
+        createdAt: import("@sinclair/typebox").TInteger;
+        defaultBranch: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        description: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        /** `null` when the folder is not a Git repository. */
+        git: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            ahead: import("@sinclair/typebox").TInteger;
+            behind: import("@sinclair/typebox").TInteger;
+            branch: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+            detached: import("@sinclair/typebox").TBoolean;
+            head: import("@sinclair/typebox").TString;
+            upstream: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        }>, import("@sinclair/typebox").TNull]>;
+        id: import("@sinclair/typebox").TString;
+        initialization: import("@sinclair/typebox").TObject<{
+            attempt: import("@sinclair/typebox").TInteger;
+            error: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"initializing">, import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"failed">]>;
+        }>;
+        name: import("@sinclair/typebox").TString;
+        /** Where the name came from; a user-chosen name is never derived over. */
+        nameSource: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"folder">, import("@sinclair/typebox").TLiteral<"user">]>;
+        /** An opaque sort key; clients order projects by comparing these strings. */
+        orderKey: import("@sinclair/typebox").TString;
+        remoteSource: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"github">;
+            repository: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"git">;
+            url: import("@sinclair/typebox").TString;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        settings: import("@sinclair/typebox").TObject<{
+            /** Where new workspaces of this project run. */
+            defaultWorkspaceCompute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                type: import("@sinclair/typebox").TLiteral<"host">;
+            }>, import("@sinclair/typebox").TObject<{
+                image: import("@sinclair/typebox").TString;
+                type: import("@sinclair/typebox").TLiteral<"docker">;
+            }>]>;
+        }>;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"archived">]>;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        version: import("@sinclair/typebox").TString;
+        /** Whether child workspaces can be created as Git worktrees. */
+        worktreeSupport: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"supported">, import("@sinclair/typebox").TLiteral<"unsupported">, import("@sinclair/typebox").TLiteral<"unknown">]>;
+        /** Accompanies `worktreeSupport` of `"unsupported"`. */
+        worktreeUnsupportedReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+}>;
+export type ProjectListResponse = Static<typeof projectListResponseSchema>;
+/** Every single-project route answers with this. */
+export declare const projectResponseSchema: import("@sinclair/typebox").TObject<{
+    project: import("@sinclair/typebox").TObject<{
+        /** Ordered top-level agents rooted directly in this project workspace. */
+        agents: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnsafe<Agent>>;
+        archivedAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>;
+        avatar: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"image">;
+            source: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"generated">]>;
+            thumbhash: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"home">;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        compute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            path: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"host">;
+        }>, import("@sinclair/typebox").TObject<{
+            image: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"docker">;
+        }>]>;
+        createdAt: import("@sinclair/typebox").TInteger;
+        defaultBranch: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        description: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        /** `null` when the folder is not a Git repository. */
+        git: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            ahead: import("@sinclair/typebox").TInteger;
+            behind: import("@sinclair/typebox").TInteger;
+            branch: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+            detached: import("@sinclair/typebox").TBoolean;
+            head: import("@sinclair/typebox").TString;
+            upstream: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        }>, import("@sinclair/typebox").TNull]>;
+        id: import("@sinclair/typebox").TString;
+        initialization: import("@sinclair/typebox").TObject<{
+            attempt: import("@sinclair/typebox").TInteger;
+            error: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"initializing">, import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"failed">]>;
+        }>;
+        name: import("@sinclair/typebox").TString;
+        /** Where the name came from; a user-chosen name is never derived over. */
+        nameSource: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"folder">, import("@sinclair/typebox").TLiteral<"user">]>;
+        /** An opaque sort key; clients order projects by comparing these strings. */
+        orderKey: import("@sinclair/typebox").TString;
+        remoteSource: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"github">;
+            repository: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"git">;
+            url: import("@sinclair/typebox").TString;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        settings: import("@sinclair/typebox").TObject<{
+            /** Where new workspaces of this project run. */
+            defaultWorkspaceCompute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                type: import("@sinclair/typebox").TLiteral<"host">;
+            }>, import("@sinclair/typebox").TObject<{
+                image: import("@sinclair/typebox").TString;
+                type: import("@sinclair/typebox").TLiteral<"docker">;
+            }>]>;
+        }>;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"archived">]>;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        version: import("@sinclair/typebox").TString;
+        /** Whether child workspaces can be created as Git worktrees. */
+        worktreeSupport: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"supported">, import("@sinclair/typebox").TLiteral<"unsupported">, import("@sinclair/typebox").TLiteral<"unknown">]>;
+        /** Accompanies `worktreeSupport` of `"unsupported"`. */
+        worktreeUnsupportedReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+}>;
+export type ProjectResponse = Static<typeof projectResponseSchema>;
+/** `PUT /v0/projects/:projectId/settings` */
+export declare const projectSettingsResponseSchema: import("@sinclair/typebox").TObject<{
+    project: import("@sinclair/typebox").TObject<{
+        /** Ordered top-level agents rooted directly in this project workspace. */
+        agents: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnsafe<Agent>>;
+        archivedAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>;
+        avatar: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"image">;
+            source: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"generated">]>;
+            thumbhash: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"home">;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        compute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            path: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"host">;
+        }>, import("@sinclair/typebox").TObject<{
+            image: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"docker">;
+        }>]>;
+        createdAt: import("@sinclair/typebox").TInteger;
+        defaultBranch: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        description: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        /** `null` when the folder is not a Git repository. */
+        git: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            ahead: import("@sinclair/typebox").TInteger;
+            behind: import("@sinclair/typebox").TInteger;
+            branch: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+            detached: import("@sinclair/typebox").TBoolean;
+            head: import("@sinclair/typebox").TString;
+            upstream: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        }>, import("@sinclair/typebox").TNull]>;
+        id: import("@sinclair/typebox").TString;
+        initialization: import("@sinclair/typebox").TObject<{
+            attempt: import("@sinclair/typebox").TInteger;
+            error: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"initializing">, import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"failed">]>;
+        }>;
+        name: import("@sinclair/typebox").TString;
+        /** Where the name came from; a user-chosen name is never derived over. */
+        nameSource: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"folder">, import("@sinclair/typebox").TLiteral<"user">]>;
+        /** An opaque sort key; clients order projects by comparing these strings. */
+        orderKey: import("@sinclair/typebox").TString;
+        remoteSource: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"github">;
+            repository: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            kind: import("@sinclair/typebox").TLiteral<"git">;
+            url: import("@sinclair/typebox").TString;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        settings: import("@sinclair/typebox").TObject<{
+            /** Where new workspaces of this project run. */
+            defaultWorkspaceCompute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                type: import("@sinclair/typebox").TLiteral<"host">;
+            }>, import("@sinclair/typebox").TObject<{
+                image: import("@sinclair/typebox").TString;
+                type: import("@sinclair/typebox").TLiteral<"docker">;
+            }>]>;
+        }>;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"archived">]>;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        version: import("@sinclair/typebox").TString;
+        /** Whether child workspaces can be created as Git worktrees. */
+        worktreeSupport: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"supported">, import("@sinclair/typebox").TLiteral<"unsupported">, import("@sinclair/typebox").TLiteral<"unknown">]>;
+        /** Accompanies `worktreeSupport` of `"unsupported"`. */
+        worktreeUnsupportedReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    settings: import("@sinclair/typebox").TObject<{
+        /** Where new workspaces of this project run. */
+        defaultWorkspaceCompute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"host">;
+        }>, import("@sinclair/typebox").TObject<{
+            image: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"docker">;
+        }>]>;
+    }>;
+}>;
+export type ProjectSettingsResponse = Static<typeof projectSettingsResponseSchema>;
+/** `POST /v0/projects` — registers an existing local folder. */
+export declare const registerProjectRequestSchema: import("@sinclair/typebox").TObject<{
+    /** The folder to register. Must exist and be a directory. */
+    path: import("@sinclair/typebox").TString;
+    /** Optional client-supplied ID, for callers that need it before the answer. */
+    projectId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type RegisterProjectRequest = Static<typeof registerProjectRequestSchema>;
+/** `POST /v0/projects/clone` */
+export declare const cloneProjectRequestSchema: import("@sinclair/typebox").TObject<{
+    /** The folder name for the clone. */
+    name: import("@sinclair/typebox").TString;
+    projectId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** Names the stored credential kind to clone with. */
+    secret: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"github">;
+    }>>;
+    source: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"github">;
+        repository: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"git">;
+        url: import("@sinclair/typebox").TString;
+    }>]>;
+}>;
+export type CloneProjectRequest = Static<typeof cloneProjectRequestSchema>;
+/** `PATCH /v0/projects/:projectId` */
+export declare const renameProjectRequestSchema: import("@sinclair/typebox").TObject<{
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    name: import("@sinclair/typebox").TString;
+}>;
+export type RenameProjectRequest = Static<typeof renameProjectRequestSchema>;
+/** `PUT /v0/projects/:projectId/settings` */
+export declare const replaceProjectSettingsRequestSchema: import("@sinclair/typebox").TObject<{
+    defaultWorkspaceCompute: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TLiteral<"host">;
+    }>, import("@sinclair/typebox").TObject<{
+        image: import("@sinclair/typebox").TString;
+        type: import("@sinclair/typebox").TLiteral<"docker">;
+    }>]>;
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type ReplaceProjectSettingsRequest = Static<typeof replaceProjectSettingsRequestSchema>;
+/** `POST /v0/projects/:projectId/reorder` */
+export declare const reorderProjectRequestSchema: import("@sinclair/typebox").TObject<{
+    /** The project to place this one after, or `null` to move it first. */
+    afterId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type ReorderProjectRequest = Static<typeof reorderProjectRequestSchema>;
+/** `POST /v0/projects/:projectId/archive` */
+export declare const archiveProjectRequestSchema: import("@sinclair/typebox").TObject<{
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type ArchiveProjectRequest = Static<typeof archiveProjectRequestSchema>;
+//# sourceMappingURL=projects.d.ts.map

package/dist/protocol/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../sources/protocol/projects.ts"],"names":[],"mappings":"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"}

package/dist/protocol/projects.js

@@ -0,0 +1,107 @@
+/** Projects: a folder registered with the daemon, or a repository it cloned. */
+import { Type } from "@sinclair/typebox";
+import { computeSchema, computeSelectionSchema, cuid2Schema, gitSummarySchema, initializationStateSchema, mutationIdSchema, Nullable, resourceVersionSchema, timestampSchema, } from "./common.js";
+/** Where a cloned project came from; `null` for a registered local folder. */
+export const remoteSourceSchema = Type.Union([
+    Type.Object({ kind: Type.Literal("github"), repository: Type.String() }),
+    Type.Object({ kind: Type.Literal("git"), url: Type.String() }),
+]);
+/**
+ * The project picture.
+ *
+ * The built-in home project — the user's machine outside any repository —
+ * carries `{ kind: "home" }` and has no image bytes to fetch.
+ */
+export const projectAvatarSchema = Type.Union([
+    Type.Object({
+        kind: Type.Literal("image"),
+        source: Type.Union([Type.Literal("user"), Type.Literal("generated")]),
+        thumbhash: Type.String(),
+    }),
+    Type.Object({ kind: Type.Literal("home") }),
+]);
+export const projectSettingsSchema = Type.Object({
+    /** Where new workspaces of this project run. */
+    defaultWorkspaceCompute: computeSelectionSchema,
+});
+/** The project object. A project is also the root workspace of its tree. */
+export const projectSchema = Type.Object({
+    /** Ordered top-level agents rooted directly in this project workspace. */
+    agents: Type.Array(Type.Unsafe({ type: "object" })),
+    archivedAt: Nullable(timestampSchema),
+    avatar: Nullable(projectAvatarSchema),
+    compute: computeSchema,
+    createdAt: timestampSchema,
+    defaultBranch: Nullable(Type.String()),
+    description: Nullable(Type.String()),
+    /** `null` when the folder is not a Git repository. */
+    git: Nullable(gitSummarySchema),
+    id: cuid2Schema,
+    initialization: initializationStateSchema,
+    name: Type.String(),
+    /** Where the name came from; a user-chosen name is never derived over. */
+    nameSource: Type.Union([Type.Literal("folder"), Type.Literal("user")]),
+    /** An opaque sort key; clients order projects by comparing these strings. */
+    orderKey: Type.String(),
+    remoteSource: Nullable(remoteSourceSchema),
+    settings: projectSettingsSchema,
+    status: Type.Union([Type.Literal("active"), Type.Literal("archived")]),
+    updatedAt: timestampSchema,
+    version: resourceVersionSchema,
+    /** Whether child workspaces can be created as Git worktrees. */
+    worktreeSupport: Type.Union([
+        Type.Literal("supported"),
+        Type.Literal("unsupported"),
+        Type.Literal("unknown"),
+    ]),
+    /** Accompanies `worktreeSupport` of `"unsupported"`. */
+    worktreeUnsupportedReason: Type.Optional(Type.String()),
+});
+/** `GET /v0/projects` */
+export const projectListResponseSchema = Type.Object({ projects: Type.Array(projectSchema) });
+/** Every single-project route answers with this. */
+export const projectResponseSchema = Type.Object({ project: projectSchema });
+/** `PUT /v0/projects/:projectId/settings` */
+export const projectSettingsResponseSchema = Type.Object({
+    project: projectSchema,
+    settings: projectSettingsSchema,
+});
+/** `POST /v0/projects` — registers an existing local folder. */
+export const registerProjectRequestSchema = Type.Object({
+    /** The folder to register. Must exist and be a directory. */
+    path: Type.String(),
+    /** Optional client-supplied ID, for callers that need it before the answer. */
+    projectId: Type.Optional(cuid2Schema),
+    mutationId: Type.Optional(mutationIdSchema),
+});
+/** `POST /v0/projects/clone` */
+export const cloneProjectRequestSchema = Type.Object({
+    /** The folder name for the clone. */
+    name: Type.String(),
+    projectId: Type.Optional(cuid2Schema),
+    mutationId: Type.Optional(mutationIdSchema),
+    /** Names the stored credential kind to clone with. */
+    secret: Type.Optional(Type.Object({ kind: Type.Literal("github") })),
+    source: remoteSourceSchema,
+});
+/** `PATCH /v0/projects/:projectId` */
+export const renameProjectRequestSchema = Type.Object({
+    mutationId: Type.Optional(mutationIdSchema),
+    name: Type.String(),
+});
+/** `PUT /v0/projects/:projectId/settings` */
+export const replaceProjectSettingsRequestSchema = Type.Object({
+    defaultWorkspaceCompute: computeSelectionSchema,
+    mutationId: Type.Optional(mutationIdSchema),
+});
+/** `POST /v0/projects/:projectId/reorder` */
+export const reorderProjectRequestSchema = Type.Object({
+    /** The project to place this one after, or `null` to move it first. */
+    afterId: Nullable(cuid2Schema),
+    mutationId: Type.Optional(mutationIdSchema),
+});
+/** `POST /v0/projects/:projectId/archive` */
+export const archiveProjectRequestSchema = Type.Object({
+    mutationId: Type.Optional(mutationIdSchema),
+});
+//# sourceMappingURL=projects.js.map

package/dist/protocol/projects.js.map

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

package/dist/protocol/questions.d.ts

@@ -0,0 +1,54 @@
+/** Questions: a run that cannot proceed without the person. */
+import type { Cuid2, ResourceVersion, Timestamp } from "./common.js";
+/** One option the person picks from. */
+export interface QuestionOption {
+    label: string;
+    description: string;
+}
+/** One prompt inside a question. */
+export interface QuestionPrompt {
+    id: Cuid2;
+    /** A short label for the prompt. */
+    header: string;
+    question: string;
+    multiSelect: boolean;
+    /** Possibly empty, and then the answer is free text. */
+    options: QuestionOption[];
+}
+/** The question object. An agent has at most one open at a time. */
+export interface Question {
+    id: Cuid2;
+    agentId: Cuid2;
+    /** Whose run is waiting. */
+    runId: Cuid2;
+    /** `"canceled"` means the run stopped needing the answer. */
+    status: "pending" | "answered" | "canceled";
+    /** One or more prompts, answered together. */
+    questions: QuestionPrompt[];
+    /** When the agent proceeds on its own; `null` waits indefinitely. */
+    autoResolveAt: Timestamp | null;
+    /** `null` while pending; a map from prompt ID to the chosen values. */
+    answers: Record<string, string[]> | null;
+    version: ResourceVersion;
+    createdAt: Timestamp;
+    answeredAt: Timestamp | null;
+}
+/** `GET /v0/agents/:agentId/question` — `null` when nothing is pending. */
+export interface PendingQuestionResponse {
+    question: Question | null;
+}
+/** `POST /v0/agents/:agentId/question/:questionId/answer` */
+export interface QuestionResponse {
+    question: Question;
+}
+/** `POST /v0/agents/:agentId/question/:questionId/answer` */
+export interface AnswerQuestionRequest {
+    /**
+     * Each prompt ID mapped to the person's values. A value matching an option
+     * label is a selection; any other string is free text. Every prompt must
+     * receive at least one value.
+     */
+    answers: Record<string, string[]>;
+    mutationId?: string;
+}
+//# sourceMappingURL=questions.d.ts.map

package/dist/protocol/questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../sources/protocol/questions.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErE,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,wDAAwD;IACxD,OAAO,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,KAAK,CAAC;IACf,4BAA4B;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,6DAA6D;IAC7D,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAC5C,8CAA8C;IAC9C,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,qEAAqE;IACrE,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC;CAChC;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC7B;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/protocol/questions.js

@@ -0,0 +1,3 @@
+/** Questions: a run that cannot proceed without the person. */
+export {};
+//# sourceMappingURL=questions.js.map

package/dist/protocol/questions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.js","sourceRoot":"","sources":["../../sources/protocol/questions.ts"],"names":[],"mappings":"AAAA,+DAA+D"}

package/dist/protocol/terminals.d.ts

@@ -0,0 +1,50 @@
+/** Terminals: interactive shells belonging to a workspace, not to any agent. */
+import type { Cuid2, MutationId, ResourceVersion } from "./common.js";
+/**
+ * The terminal object.
+ *
+ * No terminal route carries screen contents: the picture and everything typed
+ * into it travel over the attachment WebSocket.
+ */
+export interface Terminal {
+    id: Cuid2;
+    workspaceId: Cuid2;
+    status: "running" | "exited";
+    /** Set once the terminal exited. */
+    exitCode: number | null;
+    cols: number;
+    rows: number;
+    /** Settled at creation and never changed; it seeds every replica's emulator. */
+    colorScheme: "dark" | "light";
+    /** Changes whenever a new process backs the terminal. */
+    epoch: string;
+    version: ResourceVersion;
+}
+/** `GET /v0/workspaces/:workspaceId/terminals` */
+export interface TerminalListResponse {
+    terminals: Terminal[];
+}
+/** Every single-terminal route answers with this. */
+export interface TerminalResponse {
+    terminal: Terminal;
+}
+/** `POST /v0/workspaces/:workspaceId/terminals` — every field is optional. */
+export interface OpenTerminalRequest {
+    shell?: string;
+    /** What to run instead of an interactive shell; the shell still hosts it. */
+    command?: string;
+    /** Absolute, or relative to the workspace folder; defaults to the folder. */
+    cwd?: string;
+    cols?: number;
+    rows?: number;
+    maxScrollback?: number;
+    colorScheme?: "dark" | "light";
+    mutationId?: MutationId;
+}
+/** `PATCH /v0/workspaces/:workspaceId/terminals/:terminalId` */
+export interface ResizeTerminalRequest {
+    cols: number;
+    rows: number;
+    mutationId?: MutationId;
+}
+//# sourceMappingURL=terminals.d.ts.map

package/dist/protocol/terminals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminals.d.ts","sourceRoot":"","sources":["../../sources/protocol/terminals.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,KAAK,CAAC;IACV,WAAW,EAAE,KAAK,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;CAC5B;AAED,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,QAAQ,EAAE,CAAC;CACzB;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAED,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;CAC3B"}