@slopus/happy-agent-client 0.0.110 → 0.0.112

package/dist/protocol/spaces.d.ts

@@ -0,0 +1,506 @@
+/** Spaces: each person's sidebar, one ordered list of their work in flat sections. */
+import { type Static } from "@sinclair/typebox";
+/** What a row shows before its title. */
+export declare const spaceIconSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"stem_cell">;
+}>, import("@sinclair/typebox").TObject<{
+    slug: import("@sinclair/typebox").TString;
+    type: import("@sinclair/typebox").TLiteral<"library">;
+}>, import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"image">;
+    url: import("@sinclair/typebox").TString;
+}>]>;
+export type SpaceIcon = Static<typeof spaceIconSchema>;
+/**
+ * What selecting a row opens: nearly always a task; a bot for Happy and other bots; a Surface.
+ * Clients skip a row whose `kind` they do not know.
+ */
+export declare const spaceTargetSchema: import("@sinclair/typebox").TObject<{
+    /** The conversation to show; `null` for a Surface. */
+    agentId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    /** The task, bot, or Surface. */
+    id: import("@sinclair/typebox").TString;
+    kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"surface">]>;
+    /** The conversation's workspace; `null` for a Surface. */
+    workspaceId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+}>;
+export type SpaceTarget = Static<typeof spaceTargetSchema>;
+export declare const spaceVisibilitySchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+export type SpaceVisibility = Static<typeof spaceVisibilitySchema>;
+/**
+ * One row of the sidebar. Happy is an ordinary row whose target is its bot. A task row's tree comes
+ * from the task's agent and workspaces, not from here. Events carry whole rows; keep the copy with
+ * the greater `version`.
+ */
+export declare const spaceSchema: import("@sinclair/typebox").TObject<{
+    createdAt: import("@sinclair/typebox").TInteger;
+    /** `null` until one is chosen. */
+    icon: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TLiteral<"stem_cell">;
+    }>, import("@sinclair/typebox").TObject<{
+        slug: import("@sinclair/typebox").TString;
+        type: import("@sinclair/typebox").TLiteral<"library">;
+    }>, import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TLiteral<"image">;
+        url: import("@sinclair/typebox").TString;
+    }>]>, import("@sinclair/typebox").TNull]>;
+    id: import("@sinclair/typebox").TString;
+    /** Opaque position within its section. */
+    orderKey: import("@sinclair/typebox").TString;
+    /** `pending` while Prioritizing has not placed new work yet. */
+    placement: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"settled">]>;
+    sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    target: import("@sinclair/typebox").TObject<{
+        /** The conversation to show; `null` for a Surface. */
+        agentId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        /** The task, bot, or Surface. */
+        id: import("@sinclair/typebox").TString;
+        kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"surface">]>;
+        /** The conversation's workspace; `null` for a Surface. */
+        workspaceId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    }>;
+    /** `null` while new work has not named itself; clients label it themselves. */
+    title: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    updatedAt: import("@sinclair/typebox").TInteger;
+    /** An integer that grows with every change to the row. */
+    version: import("@sinclair/typebox").TInteger;
+    visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+    /** Whether the target's conversation is running now. */
+    working: import("@sinclair/typebox").TBoolean;
+}>;
+export type Space = Static<typeof spaceSchema>;
+/** A flat section of the sidebar. */
+export declare const spaceSectionSchema: import("@sinclair/typebox").TObject<{
+    /** The person closed the whole section. */
+    collapsed: import("@sinclair/typebox").TBoolean;
+    createdAt: import("@sinclair/typebox").TInteger;
+    id: import("@sinclair/typebox").TString;
+    /** Unique within the person's sidebar, ignoring case. */
+    name: import("@sinclair/typebox").TString;
+    orderKey: import("@sinclair/typebox").TString;
+    /** The person opened the "+k more" tail. */
+    tailExpanded: import("@sinclair/typebox").TBoolean;
+    updatedAt: import("@sinclair/typebox").TInteger;
+    version: import("@sinclair/typebox").TInteger;
+    /** Show only this many rows before "+k more", or all of them when `null`. */
+    visibleCount: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>;
+}>;
+export type SpaceSection = Static<typeof spaceSectionSchema>;
+/** Where a row was, or went, in a batch. */
+export declare const spaceBatchPositionSchema: import("@sinclair/typebox").TObject<{
+    /** Zero-based, among the rows it was listed with. */
+    index: import("@sinclair/typebox").TInteger;
+    sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    sectionName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+}>;
+export type SpaceBatchPosition = Static<typeof spaceBatchPositionSchema>;
+export declare const spaceBatchChangeSchema: import("@sinclair/typebox").TObject<{
+    from: import("@sinclair/typebox").TObject<{
+        /** Zero-based, among the rows it was listed with. */
+        index: import("@sinclair/typebox").TInteger;
+        sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        sectionName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+    }>;
+    spaceId: import("@sinclair/typebox").TString;
+    /** The row's title when the batch applied. */
+    title: import("@sinclair/typebox").TString;
+    to: import("@sinclair/typebox").TObject<{
+        /** Zero-based, among the rows it was listed with. */
+        index: import("@sinclair/typebox").TInteger;
+        sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        sectionName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+    }>;
+}>;
+export type SpaceBatchChange = Static<typeof spaceBatchChangeSchema>;
+/** Prioritizing's changes, applied together at a calm moment. */
+export declare const spaceBatchSchema: import("@sinclair/typebox").TObject<{
+    appliedAt: import("@sinclair/typebox").TInteger;
+    changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        from: import("@sinclair/typebox").TObject<{
+            /** Zero-based, among the rows it was listed with. */
+            index: import("@sinclair/typebox").TInteger;
+            sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            sectionName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+        }>;
+        spaceId: import("@sinclair/typebox").TString;
+        /** The row's title when the batch applied. */
+        title: import("@sinclair/typebox").TString;
+        to: import("@sinclair/typebox").TObject<{
+            /** Zero-based, among the rows it was listed with. */
+            index: import("@sinclair/typebox").TInteger;
+            sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            sectionName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+        }>;
+    }>>;
+    id: import("@sinclair/typebox").TString;
+    /** The one line added to Happy's conversation. */
+    note: import("@sinclair/typebox").TString;
+    /** That line's message ID in Happy's conversation, or `null` when Happy was unavailable. */
+    noteMessageId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+}>;
+export type SpaceBatch = Static<typeof spaceBatchSchema>;
+/** `GET /v0/spaces` */
+export declare const spaceListResponseSchema: import("@sinclair/typebox").TObject<{
+    /** Follow `space.*` events from here. */
+    cursor: import("@sinclair/typebox").TString;
+    sections: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        /** The person closed the whole section. */
+        collapsed: import("@sinclair/typebox").TBoolean;
+        createdAt: import("@sinclair/typebox").TInteger;
+        id: import("@sinclair/typebox").TString;
+        /** Unique within the person's sidebar, ignoring case. */
+        name: import("@sinclair/typebox").TString;
+        orderKey: import("@sinclair/typebox").TString;
+        /** The person opened the "+k more" tail. */
+        tailExpanded: import("@sinclair/typebox").TBoolean;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        version: import("@sinclair/typebox").TInteger;
+        /** Show only this many rows before "+k more", or all of them when `null`. */
+        visibleCount: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>;
+    }>>;
+    spaces: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TInteger;
+        /** `null` until one is chosen. */
+        icon: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"stem_cell">;
+        }>, import("@sinclair/typebox").TObject<{
+            slug: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"library">;
+        }>, import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"image">;
+            url: import("@sinclair/typebox").TString;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        id: import("@sinclair/typebox").TString;
+        /** Opaque position within its section. */
+        orderKey: import("@sinclair/typebox").TString;
+        /** `pending` while Prioritizing has not placed new work yet. */
+        placement: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"settled">]>;
+        sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        target: import("@sinclair/typebox").TObject<{
+            /** The conversation to show; `null` for a Surface. */
+            agentId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            /** The task, bot, or Surface. */
+            id: import("@sinclair/typebox").TString;
+            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"surface">]>;
+            /** The conversation's workspace; `null` for a Surface. */
+            workspaceId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        }>;
+        /** `null` while new work has not named itself; clients label it themselves. */
+        title: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        /** An integer that grows with every change to the row. */
+        version: import("@sinclair/typebox").TInteger;
+        visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+        /** Whether the target's conversation is running now. */
+        working: import("@sinclair/typebox").TBoolean;
+    }>>;
+}>;
+export type SpaceListResponse = Static<typeof spaceListResponseSchema>;
+/** `GET /v0/spaces/batches` — newest first. */
+export declare const spaceBatchListResponseSchema: import("@sinclair/typebox").TObject<{
+    batches: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        appliedAt: import("@sinclair/typebox").TInteger;
+        changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            from: import("@sinclair/typebox").TObject<{
+                /** Zero-based, among the rows it was listed with. */
+                index: import("@sinclair/typebox").TInteger;
+                sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                sectionName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+            }>;
+            spaceId: import("@sinclair/typebox").TString;
+            /** The row's title when the batch applied. */
+            title: import("@sinclair/typebox").TString;
+            to: import("@sinclair/typebox").TObject<{
+                /** Zero-based, among the rows it was listed with. */
+                index: import("@sinclair/typebox").TInteger;
+                sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                sectionName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+            }>;
+        }>>;
+        id: import("@sinclair/typebox").TString;
+        /** The one line added to Happy's conversation. */
+        note: import("@sinclair/typebox").TString;
+        /** That line's message ID in Happy's conversation, or `null` when Happy was unavailable. */
+        noteMessageId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    }>>;
+}>;
+export type SpaceBatchListResponse = Static<typeof spaceBatchListResponseSchema>;
+/** `POST /v0/spaces/stem-cells` — new work, pending under Happy or at the top of a section. */
+export declare const createStemCellRequestSchema: import("@sinclair/typebox").TObject<{
+    /** The retry key: repeating it answers `200` with the existing row and conversation. */
+    id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    sectionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+}>;
+export type CreateStemCellRequest = Static<typeof createStemCellRequestSchema>;
+export declare const createStemCellResponseSchema: import("@sinclair/typebox").TObject<{
+    agent: import("@sinclair/typebox").TRecursive<import("@sinclair/typebox").TObject<{
+        archivedAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>;
+        canSendMessages: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        createdAt: import("@sinclair/typebox").TInteger;
+        id: import("@sinclair/typebox").TString;
+        lastCursor: import("@sinclair/typebox").TString;
+        managedByAnotherAgent: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        orderKey: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        parentAgentId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        pendingQuestionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        processes: import("@sinclair/typebox").TObject<{
+            running: import("@sinclair/typebox").TInteger;
+        }>;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"idle">, import("@sinclair/typebox").TLiteral<"thinking">, import("@sinclair/typebox").TLiteral<"working">, import("@sinclair/typebox").TLiteral<"generating_tools">, import("@sinclair/typebox").TLiteral<"running_tools">]>;
+        subagents: import("@sinclair/typebox").TObject<{
+            running: import("@sinclair/typebox").TInteger;
+            total: import("@sinclair/typebox").TInteger;
+        }>;
+        subtask: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        subtasks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TThis>>;
+        subtaskOrderKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+        title: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        titleStatus: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"idle">, import("@sinclair/typebox").TLiteral<"ready">]>;
+        totalTokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>>;
+        unread: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            reason: import("@sinclair/typebox").TString;
+            since: import("@sinclair/typebox").TInteger;
+        }>, import("@sinclair/typebox").TNull]>;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        userVisible: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        version: import("@sinclair/typebox").TString;
+        wait: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            startedAt: import("@sinclair/typebox").TInteger;
+            dueAt: import("@sinclair/typebox").TInteger;
+        }>, import("@sinclair/typebox").TNull]>>;
+        retrying: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            attempt: import("@sinclair/typebox").TInteger;
+            maxAttempts: import("@sinclair/typebox").TInteger;
+            kind: import("@sinclair/typebox").TString;
+            vendorName: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TNull]>>;
+        workspaceId: import("@sinclair/typebox").TString;
+    }>>;
+    space: import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TInteger;
+        /** `null` until one is chosen. */
+        icon: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"stem_cell">;
+        }>, import("@sinclair/typebox").TObject<{
+            slug: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"library">;
+        }>, import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"image">;
+            url: import("@sinclair/typebox").TString;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        id: import("@sinclair/typebox").TString;
+        /** Opaque position within its section. */
+        orderKey: import("@sinclair/typebox").TString;
+        /** `pending` while Prioritizing has not placed new work yet. */
+        placement: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"settled">]>;
+        sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        target: import("@sinclair/typebox").TObject<{
+            /** The conversation to show; `null` for a Surface. */
+            agentId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            /** The task, bot, or Surface. */
+            id: import("@sinclair/typebox").TString;
+            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"surface">]>;
+            /** The conversation's workspace; `null` for a Surface. */
+            workspaceId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        }>;
+        /** `null` while new work has not named itself; clients label it themselves. */
+        title: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        /** An integer that grows with every change to the row. */
+        version: import("@sinclair/typebox").TInteger;
+        visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+        /** Whether the target's conversation is running now. */
+        working: import("@sinclair/typebox").TBoolean;
+    }>;
+}>;
+export type CreateStemCellResponse = Static<typeof createStemCellResponseSchema>;
+/** The person's authoritative HTML sidebar and live space identities. */
+export declare const spaceSidebarResponseSchema: import("@sinclair/typebox").TObject<{
+    artifactId: import("@sinclair/typebox").TString;
+    version: import("@sinclair/typebox").TInteger;
+    html: import("@sinclair/typebox").TString;
+    spaces: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TInteger;
+        /** `null` until one is chosen. */
+        icon: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"stem_cell">;
+        }>, import("@sinclair/typebox").TObject<{
+            slug: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"library">;
+        }>, import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"image">;
+            url: import("@sinclair/typebox").TString;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        id: import("@sinclair/typebox").TString;
+        /** Opaque position within its section. */
+        orderKey: import("@sinclair/typebox").TString;
+        /** `pending` while Prioritizing has not placed new work yet. */
+        placement: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"settled">]>;
+        sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        target: import("@sinclair/typebox").TObject<{
+            /** The conversation to show; `null` for a Surface. */
+            agentId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            /** The task, bot, or Surface. */
+            id: import("@sinclair/typebox").TString;
+            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"surface">]>;
+            /** The conversation's workspace; `null` for a Surface. */
+            workspaceId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        }>;
+        /** `null` while new work has not named itself; clients label it themselves. */
+        title: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        /** An integer that grows with every change to the row. */
+        version: import("@sinclair/typebox").TInteger;
+        visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+        /** Whether the target's conversation is running now. */
+        working: import("@sinclair/typebox").TBoolean;
+    }>>;
+}>;
+export type SpaceSidebarResponse = Static<typeof spaceSidebarResponseSchema>;
+export declare const updateSpaceSidebarRequestSchema: import("@sinclair/typebox").TObject<{
+    html: import("@sinclair/typebox").TString;
+    baseVersion: import("@sinclair/typebox").TInteger;
+    mutationId: import("@sinclair/typebox").TString;
+}>;
+export type UpdateSpaceSidebarRequest = Static<typeof updateSpaceSidebarRequestSchema>;
+export declare const spaceSidebarObservationsRequestSchema: import("@sinclair/typebox").TObject<{
+    visibleSpaceIds: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    collapsed: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+}>;
+export type SpaceSidebarObservationsRequest = Static<typeof spaceSidebarObservationsRequestSchema>;
+export declare const sidebarDiagnosticSchema: import("@sinclair/typebox").TObject<{
+    message: import("@sinclair/typebox").TString;
+    offset: import("@sinclair/typebox").TInteger;
+}>;
+export type SidebarDiagnostic = Static<typeof sidebarDiagnosticSchema>;
+/**
+ * `PATCH /v0/spaces/:spaceId` — the person's own change to a row, applied at once. At least one
+ * field. Giving `sectionId` moves the row (first in the section unless `afterId` says otherwise);
+ * a moved row becomes `shown` unless `visibility` says otherwise.
+ */
+export declare const updateSpaceRequestSchema: import("@sinclair/typebox").TObject<{
+    /** The row to follow within the section, or `null` to move first. */
+    afterId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    sectionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+    visibility: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>>;
+}>;
+export type UpdateSpaceRequest = Static<typeof updateSpaceRequestSchema>;
+/**
+ * `PATCH /v0/spaces/:spaceId` with `removed` — takes new work nobody wrote in out of the
+ * sidebar and archives its task. Answers `204`, and `409` once its conversation holds a message.
+ */
+export declare const removeSpaceRequestSchema: import("@sinclair/typebox").TObject<{
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    removed: import("@sinclair/typebox").TLiteral<true>;
+}>;
+export type RemoveSpaceRequest = Static<typeof removeSpaceRequestSchema>;
+export declare const spaceResponseSchema: import("@sinclair/typebox").TObject<{
+    space: import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TInteger;
+        /** `null` until one is chosen. */
+        icon: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"stem_cell">;
+        }>, import("@sinclair/typebox").TObject<{
+            slug: import("@sinclair/typebox").TString;
+            type: import("@sinclair/typebox").TLiteral<"library">;
+        }>, import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TLiteral<"image">;
+            url: import("@sinclair/typebox").TString;
+        }>]>, import("@sinclair/typebox").TNull]>;
+        id: import("@sinclair/typebox").TString;
+        /** Opaque position within its section. */
+        orderKey: import("@sinclair/typebox").TString;
+        /** `pending` while Prioritizing has not placed new work yet. */
+        placement: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"settled">]>;
+        sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        target: import("@sinclair/typebox").TObject<{
+            /** The conversation to show; `null` for a Surface. */
+            agentId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            /** The task, bot, or Surface. */
+            id: import("@sinclair/typebox").TString;
+            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"surface">]>;
+            /** The conversation's workspace; `null` for a Surface. */
+            workspaceId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        }>;
+        /** `null` while new work has not named itself; clients label it themselves. */
+        title: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        /** An integer that grows with every change to the row. */
+        version: import("@sinclair/typebox").TInteger;
+        visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+        /** Whether the target's conversation is running now. */
+        working: import("@sinclair/typebox").TBoolean;
+    }>;
+}>;
+export type SpaceResponse = Static<typeof spaceResponseSchema>;
+/** `PATCH /v0/spaces/sections/:sectionId` — the person's own disclosure; at least one flag. */
+export declare const updateSpaceSectionRequestSchema: import("@sinclair/typebox").TObject<{
+    collapsed: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    mutationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    tailExpanded: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export type UpdateSpaceSectionRequest = Static<typeof updateSpaceSectionRequestSchema>;
+export declare const spaceSectionResponseSchema: import("@sinclair/typebox").TObject<{
+    section: import("@sinclair/typebox").TObject<{
+        /** The person closed the whole section. */
+        collapsed: import("@sinclair/typebox").TBoolean;
+        createdAt: import("@sinclair/typebox").TInteger;
+        id: import("@sinclair/typebox").TString;
+        /** Unique within the person's sidebar, ignoring case. */
+        name: import("@sinclair/typebox").TString;
+        orderKey: import("@sinclair/typebox").TString;
+        /** The person opened the "+k more" tail. */
+        tailExpanded: import("@sinclair/typebox").TBoolean;
+        updatedAt: import("@sinclair/typebox").TInteger;
+        version: import("@sinclair/typebox").TInteger;
+        /** Show only this many rows before "+k more", or all of them when `null`. */
+        visibleCount: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>;
+    }>;
+}>;
+export type SpaceSectionResponse = Static<typeof spaceSectionResponseSchema>;
+/** `POST /v0/spaces/attention` — whether a batch may apply now. */
+export declare const spaceAttentionRequestSchema: import("@sinclair/typebox").TObject<{
+    state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"interacting">, import("@sinclair/typebox").TLiteral<"calm">]>;
+}>;
+export type SpaceAttentionRequest = Static<typeof spaceAttentionRequestSchema>;
+export declare const spaceAttentionResponseSchema: import("@sinclair/typebox").TObject<{
+    /** The batch this report applied. */
+    batch: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        appliedAt: import("@sinclair/typebox").TInteger;
+        changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            from: import("@sinclair/typebox").TObject<{
+                /** Zero-based, among the rows it was listed with. */
+                index: import("@sinclair/typebox").TInteger;
+                sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                sectionName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+            }>;
+            spaceId: import("@sinclair/typebox").TString;
+            /** The row's title when the batch applied. */
+            title: import("@sinclair/typebox").TString;
+            to: import("@sinclair/typebox").TObject<{
+                /** Zero-based, among the rows it was listed with. */
+                index: import("@sinclair/typebox").TInteger;
+                sectionId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                sectionName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                visibility: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shown">, import("@sinclair/typebox").TLiteral<"folded">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+            }>;
+        }>>;
+        id: import("@sinclair/typebox").TString;
+        /** The one line added to Happy's conversation. */
+        note: import("@sinclair/typebox").TString;
+        /** That line's message ID in Happy's conversation, or `null` when Happy was unavailable. */
+        noteMessageId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    }>, import("@sinclair/typebox").TNull]>;
+}>;
+export type SpaceAttentionResponse = Static<typeof spaceAttentionResponseSchema>;
+//# sourceMappingURL=spaces.d.ts.map

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

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