@neta-art/cohub 2.14.1 → 3.0.0

package/dist/chunks/http.d.ts

@@ -1,40 +1,55 @@
+import { a as BoardCreateInput, b as BoardTransaction, g as BoardPlaybackSnapshot, h as BoardPlaybackCommand, l as BoardInspectInput, n as BoardBootstrap, r as BoardCapabilities, x as BoardValidationResult } from "./board.js";
+import { $ as CreateSpacePromptInput, $r as BoardTransactionAppliedEvent$1, Ar as UserSessionsResponse, At as ModelCatalogEntry, Bn as SpaceFsCreateUploadResponse, Cn as SpaceCommerceBuyerProfile, Dn as SpaceCommerceProduct, Dr as UserRulesResponse, En as SpaceCommerceOrder, Er as UserProfile, Et as LabelResourceType, Fn as SpaceDefaultResponse, Gn as SpaceFsMoveInput, Gt as ReferenceDirection, In as SpaceEnvInput, It as PromptTemplateCatalogResponse, J as ClaimReferralResponse, Jt as ReferenceQueryableType, K as CheckpointDiffSummary, Kn as SpaceFsPreparingFile, Kt as ReferenceKind, Ln as SpaceFsCompleteUploadInput, Lt as PublicReferral, Mn as SpaceConfigResponse, Mr as ChannelHealth, Mt as PatchResourceLabelsResponse, Nn as SpaceConfigUpdateResponse, Nt as Permission, On as SpaceCommerceProductBenefitBinding, Pn as SpaceCreateResponse, Qr as BoardPlaybackChangedEvent$1, R as Channel, Rn as SpaceFsCompleteUploadResponse, Rt as PublicUserPageResponse, Si as BillingPayload, Sn as SpaceCommerceBenefit, Sr as SpaceUsageResponse, St as LabelItemsResponse, Tr as TaskRunRecord, Ut as ReferenceAggregateGroupBy, V as CheckpointDiffFileResponse, Wn as SpaceFsFileResponse, Wt as ReferenceAggregateResponse, X as CreateInvitationResponse, Xn as SpaceFsTreeResponse, Xr as GenerationModelDeclaration, Y as CreateInvitationInput, Yn as SpaceFsReadFilesResponse, Yr as GenerationContentBlock, Z as CreateSpaceInput, Zt as ReferralDashboard, a as WebsocketClientOptions, ai as SpacePublicEndpoints, an as SessionMessageResponse, ar as SpaceInvitation, at as CursorPageInfo, bi as Usage, br as SpaceSessionsResponse, cn as SessionRecord, d as BatchUserProfilesResponse, dn as SessionTurnSignedUrlsResponse, dr as SpacePendingDiffSummary, et as CreateSpacePromptResponse, fn as SessionTurnStreamSnapshotResponse, fr as SpacePresenceSnapshot, ft as GlobalSearchResponse, gi as CreateSpaceCompletionInput, gn as SkillCatalogResponse, gr as SpaceRole, hr as SpaceRecord, ht as InvitationDetail, ii as SessionTurnPatchEvent, ir as SpaceFsWriteFileInput, it as CronJobUpdatePatch, jn as SpaceConfigInput, jr as ChannelConfig, jt as PatchResourceLabelsInput, kt as MeResponse, l as AcceptInvitationResponse, ln as SessionTurnIndexResponse, lr as SpaceModListItem, mn as SessionTurnsPaginatedResponse, mr as SpacePublicProfile, mt as GlobalSearchType, ni as RealtimePatchOperation, oi as MessageRecord, on as SessionMessagesPaginatedResponse, pn as SessionTurnWindowResponse, q as CheckpointRecord, qt as ReferenceQueryResponse, r as WebsocketClient, rr as SpaceFsUploadResponse, rt as CronJobRecord, s as WebsocketEventPayload, si as SessionForkRecord, sn as SessionMessagesResponse, sr as SpaceMember, tt as CreateSpaceSessionInput, ui as SessionTurnRecord, un as SessionTurnResponse, ur as SpacePendingDiffFileResponse, vi as SpaceCompletionResult, vn as SpaceAccessPolicy, wr as TaskRunDetailResponse, wt as LabelListItem, xi as ContentBlock, xn as SpaceCheckpointDetailResponse, xt as LabelAssignmentRecord, yi as SpaceCompletionStreamEvent, zn as SpaceFsCreateUploadInput } from "./websocket.js";
 import { n as CohubEnvironment } from "./environment.js";
-import { $ as CheckpointDiffSummary, $n as SpaceFsPreparingFile, $r as ChannelConfig, $t as ReferenceKind, An as SpaceCommerceBuyerProfile, B as CanvasDocumentRecord, Bn as SpaceConfigUpdateResponse, Bt as Permission, Cn as SkillCatalogResponse, Cr as SpaceRole, Dr as SpaceSessionsResponse, Fn as SpaceCommerceProductBenefitBinding, G as Channel, Gn as SpaceFsCompleteUploadResponse, Gt as PublicUserPageResponse, Hn as SpaceDefaultResponse, It as MeResponse, J as CheckpointDiffFileResponse, Kn as SpaceFsCreateUploadInput, Lr as UserSessionsResponse, Lt as ModelCatalogEntry, Mr as TaskRunRecord, Nn as SpaceCommerceOrder, Nr as UserProfile, Nt as LabelResourceType, On as SpaceCheckpointDetailResponse, Ot as LabelAssignmentRecord, Pn as SpaceCommerceProduct, Pr as UserRulesResponse, Qn as SpaceFsMoveInput, Qt as ReferenceDirection, R as CanvasBootstrapResponse, Rn as SpaceConfigInput, Rt as PatchResourceLabelsInput, Sr as SpaceRecord, St as InvitationDetail, Tn as SpaceAccessPolicy, Un as SpaceEnvInput, Ut as PromptTemplateCatalogResponse, Vn as SpaceCreateResponse, W as CanvasTransactionInput, Wn as SpaceFsCompleteUploadInput, Wt as PublicReferral, Xr as GenerationContentBlock, Xt as ReferenceAggregateGroupBy, Zn as SpaceFsFileResponse, Zr as GenerationModelDeclaration, Zt as ReferenceAggregateResponse, _i as BillingPayload, _n as SessionTurnResponse, _r as SpacePendingDiffFileResponse, a as WebsocketClientOptions, bn as SessionTurnWindowResponse, ct as CreateSpaceSessionInput, d as BatchUserProfilesResponse, di as MessageRecord, dr as SpaceFsWriteFileInput, dt as CronJobUpdatePatch, ei as ChannelHealth, en as ReferenceQueryResponse, et as CheckpointRecord, fi as SessionForkRecord, fn as SessionMessageResponse, fr as SpaceInvitation, ft as CursorPageInfo, gi as Usage, gn as SessionTurnIndexResponse, gr as SpaceModListItem, hi as SessionTurnRecord, hn as SessionRecord, in as ReferralDashboard, it as CreateSpaceInput, jr as TaskRunDetailResponse, jt as LabelListItem, kn as SpaceCommerceBenefit, kr as SpaceUsageResponse, kt as LabelItemsResponse, l as AcceptInvitationResponse, li as SessionTurnPatchEvent, mn as SessionMessagesResponse, mr as SpaceMember, nr as SpaceFsReadFilesResponse, nt as CreateInvitationInput, ot as CreateSpacePromptInput, pn as SessionMessagesPaginatedResponse, qn as SpaceFsCreateUploadResponse, r as WebsocketClient, rr as SpaceFsTreeResponse, rt as CreateInvitationResponse, s as WebsocketEventPayload, si as RealtimePatchOperation, st as CreateSpacePromptResponse, tn as ReferenceQueryableType, tt as ClaimReferralResponse, ui as SpacePublicEndpoints, ur as SpaceFsUploadResponse, ut as CronJobRecord, vi as ContentBlock, vn as SessionTurnSignedUrlsResponse, vr as SpacePendingDiffSummary, xn as SessionTurnsPaginatedResponse, xr as SpacePublicProfile, xt as GlobalSearchType, yn as SessionTurnStreamSnapshotResponse, yr as SpacePresenceSnapshot, yt as GlobalSearchResponse, z as CanvasCreateInput, zn as SpaceConfigResponse, zt as PatchResourceLabelsResponse } from "./websocket.js";
 import { a as VoiceInputCreateOptions } from "./voice-input.js";
-//#region ../protocol/dist/provenance.d.ts
-/** Request provenance via X-Cohub-Source-* headers. Never used for authorization. */
-declare const COHUB_SOURCE_HEADER: {
-  readonly space: "X-Cohub-Source-Space";
-  readonly session: "X-Cohub-Source-Session";
-  readonly turn: "X-Cohub-Source-Turn";
-  readonly toolCall: "X-Cohub-Source-Tool-Call";
-  readonly via: "X-Cohub-Source-Via";
+//#region ../protocol/dist/model/status.d.ts
+/** Per-model availability status, derived from periodic probe results. */
+type ModelAvailabilityStatus = "operational" | "degraded" | "outage";
+/**
+ * Aggregated availability for a single model.
+ * All rate fields are percentages (0–100); `null` means no samples in that window.
+ */
+type ModelStatusEntry = {
+  status: ModelAvailabilityStatus;
+  /** 5-minute success rate — drives the selector dot color. Real observed
+   *  traffic (`online`) when available, else the probe self-test window. */
+  successRate5m: number | null;
+  successRate2h: number | null;
+  successRate24h: number | null;
+  /** 1-hour average / P90 response duration in milliseconds. */
+  latencyAvgMs: number | null;
+  latencyP90Ms: number | null;
+  samples1h: number | null;
+  checkedAt: string | null;
+  probeIntervalSeconds: number | null;
+  /** 24-hour history in 15-minute buckets (oldest → newest), or null. */
+  history: Array<{
+    t: string;
+    status: ModelAvailabilityStatus;
+    rate: number | null;
+    samples: number;
+  }> | null;
+  /**
+   * Bar-chart series (oldest → newest), always 96 buckets. Source is real
+   * observed traffic (`online` heartbeats resampled to 5-min buckets) when
+   * available, else the probe self-test `history` (15-min buckets) as a
+   * fallback for models not yet covered by online. Drives the hover card
+   * bar chart; color each bucket via the 6-tier success-rate scale.
+   */
+  heartbeats8h: Array<number | null> | null;
+  /**
+   * Total minutes spanned by `heartbeats8h` (online → 480, history fallback
+   * → 1440). The frontend divides by bucket count for the per-bar age and
+   * the axis label, so the window reads honestly regardless of source.
+   */
+  heartbeatsWindowMinutes: number | null;
 };
-type RequestSourceVia = "cli" | "bash" | "tool" | "api" | "web" | (string & {});
-/** Caller context: via (channel) and optional identity fields. */
-type RequestSource = {
-  spaceId?: string;
-  sessionId?: string;
-  turnId?: string;
-  toolCallId?: string;
-  via?: RequestSourceVia;
+type ModelStatusResponse = {
+  generatedAt: string;
+  overallStatus: ModelAvailabilityStatus | "unknown";
+  /** Keyed by model id. */
+  models: Record<string, ModelStatusEntry>;
 };
-declare const isRequestSourceUuid: (value: unknown) => value is string;
-declare const REQUEST_SOURCE_VIA_MAX_LENGTH = 64;
-declare const isRequestSourceEmpty: (source: RequestSource | null | undefined) => boolean;
-declare const hasRequestSourceIdentity: (source: RequestSource | null | undefined) => boolean;
-/** Drop invalid UUIDs; via-only is valid. */
-declare const normalizeRequestSource: (input: unknown) => RequestSource | null;
-declare const parseRequestSourceFromHeaders: (getHeader: (name: string) => string | null | undefined) => RequestSource | null;
-declare const requestSourceToHeaders: (source: RequestSource | null | undefined) => Record<string, string>;
-/** Read COHUB_* env into a RequestSource. */
-declare const readRequestSourceFromEnv: (env?: Record<string, string | undefined>, defaults?: {
-  via?: RequestSourceVia;
-}) => RequestSource | null;
-declare const resolveRequestSourceChannel: (source: RequestSource | null | undefined, fallback?: string) => string;
-/** Put identity under meta.source; strip body source. Via-only is skipped. */
-declare const mergeRequestSourceIntoMeta: (meta: Record<string, unknown> | null | undefined, headerSource: RequestSource | null | undefined) => Record<string, unknown> | null;
-declare const COHUB_SOURCE_HEADER_NAMES: readonly string[];
 //#endregion
 //#region ../protocol/dist/generation/index.d.ts
 declare const GENERATION_TASK_TYPE: "generation";
@@ -87,73 +102,99 @@ type ListGenerationModelsResponse = {
   models: PublicGenerationDeclaration[];
 };
 //#endregion
-//#region ../protocol/dist/model/completion.d.ts
-type CompletionMessageRole = "user" | "assistant" | "system";
-/** Raw completion message. Reuses session ContentBlock content shape. */
-type CompletionMessage = {
-  role: CompletionMessageRole;
-  content: ContentBlock[];
-};
-type CompletionThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
-type CreateSpaceCompletionInput = {
-  /** Optional provider. Defaults to the first available model provider. */
-  provider?: string | null;
-  /** Optional model id. Defaults to the first available model. */
-  model?: string | null;
-  /**
-   * Optional space-relative markdown/text path used as system prompt.
-   * Omitted/null/empty → empty system prompt.
-   */
-  systemPromptPath?: string | null;
-  /** Full conversation history controlled by the caller. */
-  messages: CompletionMessage[];
-  temperature?: number | null;
-  maxTokens?: number | null;
-  thinkingLevel?: CompletionThinkingLevel | null;
-  /** When true, respond with SSE. Default false (JSON). */
-  stream?: boolean | null;
-};
-type CompletionUsage = Usage;
-type CompletionAssistantMessage = {
-  role: "assistant";
-  content: ContentBlock[];
-  stopReason: "stop" | "length" | "error" | "aborted";
-  errorMessage?: string | null;
+//#region ../protocol/dist/space-config.d.ts
+type WorkspacePreviewKind = "file" | "board" | "port";
+type WorkspacePreviewRef = {
+  kind: WorkspacePreviewKind;
+  key: string;
+};
+type WorkspaceLayoutPresentation = "split" | "focus" | "fullscreen";
+type WorkspaceDefaultLayout = {
+  leftSidebar?: "expanded" | "collapsed";
+  filesColumn?: "visible" | "hidden";
+  fileTree?: "expanded" | "collapsed";
+  preview?: WorkspacePreviewRef;
+  presentation?: WorkspaceLayoutPresentation;
+};
+type NewChatBackgroundBase = {
+  opacity: number;
+  fit: "cover" | "contain" | "fill";
+  position: string;
+};
+type NewChatBackgroundUrlSource = {
+  kind: "url";
+  url: string;
 };
-type SpaceCompletionResult = {
-  completionId: string;
-  provider: string;
-  model: string;
-  systemPromptPath: string | null;
-  message: CompletionAssistantMessage;
-  usage: CompletionUsage | null;
-};
-type SpaceCompletionStreamEvent = {
-  type: "meta";
-  completionId: string;
-  provider: string;
-  model: string;
-  systemPromptPath: string | null;
-} | {
-  type: "delta";
-  text: string;
-} | {
-  type: "thinking_delta";
-  text: string;
-} | {
-  type: "usage";
-  usage: CompletionUsage;
-} | {
-  type: "done";
-  completionId: string;
-  message: CompletionAssistantMessage;
-  usage: CompletionUsage | null;
+type NewChatBackgroundConfig = NewChatBackgroundBase & ({
+  type: "html";
+  source: NewChatBackgroundUrlSource | {
+    kind: "space";
+    path: string;
+  };
 } | {
-  type: "error";
-  code: string;
-  message: string;
-  completionId?: string | null;
+  type: "image" | "video";
+  source: NewChatBackgroundUrlSource;
+});
+type SpaceConfig = {
+  ui?: {
+    newChat?: {
+      background?: NewChatBackgroundConfig;
+    };
+    workspace?: {
+      defaultLayout?: WorkspaceDefaultLayout;
+    };
+  };
+};
+type SpacePreviewSessionCredential = {
+  token: string;
+  expiresIn: number;
 };
+type SpaceStartupResponse = {
+  status: "ready" | "missing" | "invalid" | "preparing";
+  config: SpaceConfig | null;
+  configRaw: string | null;
+  revision: {
+    mtimeMs: number;
+    size: number;
+  } | null;
+  previewSession: SpacePreviewSessionCredential | null;
+  retryAfterMs?: number;
+};
+//#endregion
+//#region ../protocol/dist/provenance.d.ts
+/** Request provenance via X-Cohub-Source-* headers. Never used for authorization. */
+declare const COHUB_SOURCE_HEADER: {
+  readonly space: "X-Cohub-Source-Space";
+  readonly session: "X-Cohub-Source-Session";
+  readonly turn: "X-Cohub-Source-Turn";
+  readonly toolCall: "X-Cohub-Source-Tool-Call";
+  readonly via: "X-Cohub-Source-Via";
+};
+type RequestSourceVia = "cli" | "bash" | "tool" | "api" | "web" | (string & {});
+/** Caller context: via (channel) and optional identity fields. */
+type RequestSource = {
+  spaceId?: string;
+  sessionId?: string;
+  turnId?: string;
+  toolCallId?: string;
+  via?: RequestSourceVia;
+};
+declare const isRequestSourceUuid: (value: unknown) => value is string;
+declare const REQUEST_SOURCE_VIA_MAX_LENGTH = 64;
+declare const isRequestSourceEmpty: (source: RequestSource | null | undefined) => boolean;
+declare const hasRequestSourceIdentity: (source: RequestSource | null | undefined) => boolean;
+/** Drop invalid UUIDs; via-only is valid. */
+declare const normalizeRequestSource: (input: unknown) => RequestSource | null;
+declare const parseRequestSourceFromHeaders: (getHeader: (name: string) => string | null | undefined) => RequestSource | null;
+declare const requestSourceToHeaders: (source: RequestSource | null | undefined) => Record<string, string>;
+/** Read COHUB_* env into a RequestSource. */
+declare const readRequestSourceFromEnv: (env?: Record<string, string | undefined>, defaults?: {
+  via?: RequestSourceVia;
+}) => RequestSource | null;
+declare const resolveRequestSourceChannel: (source: RequestSource | null | undefined, fallback?: string) => string;
+/** Put identity under meta.source; strip body source. Via-only is skipped. */
+declare const mergeRequestSourceIntoMeta: (meta: Record<string, unknown> | null | undefined, headerSource: RequestSource | null | undefined) => Record<string, unknown> | null;
+declare const COHUB_SOURCE_HEADER_NAMES: readonly string[];
 //#endregion
 //#region src/work-runtime.d.ts
 type WorkRuntimeContext = {
@@ -471,6 +512,7 @@ declare class ModelsApi {
   constructor(transport: HttpTransport);
   list(): Promise<ModelsCatalog>;
   listMultimodal(): Promise<ListGenerationModelsResponse>;
+  status(): Promise<ModelStatusResponse>;
 }
 //#endregion
 //#region src/apis/prompts.d.ts
@@ -843,16 +885,26 @@ declare class PublicInviteApi {
 //#endregion
 //#region src/apis/spaces.d.ts
 /**
- * A canvas transaction rejected by the server. `status`/`code` let callers
+ * A board transaction rejected by the server. `status`/`code` let callers
  * distinguish a recoverable version conflict (409 / "VERSION_CONFLICT") from
  * transient failures, so they can rebase and retry instead of surfacing an error.
  */
-declare class CanvasTransactionError extends Error {
+declare class BoardTransactionError extends Error {
   readonly status?: number | undefined;
   readonly code?: string | undefined;
-  constructor(message: string, status?: number | undefined, code?: string | undefined);
+  readonly body?: unknown;
+  constructor(message: string, status?: number | undefined, code?: string | undefined, body?: unknown, options?: ErrorOptions);
   get isVersionConflict(): boolean;
 }
+type BoardTransactionInput = Omit<BoardTransaction, "boardId">;
+type BoardTransactionAppliedEvent = BoardTransactionAppliedEvent$1;
+type BoardPlaybackChangedEvent = BoardPlaybackChangedEvent$1;
+type BoardEventName = "transaction" | "playback";
+type BoardSubscriptionHandlers = {
+  transaction?: (event: BoardTransactionAppliedEvent) => void;
+  playback?: (event: BoardPlaybackChangedEvent) => void;
+  event?: (event: BoardTransactionAppliedEvent | BoardPlaybackChangedEvent) => void;
+};
 type SessionSubscriptionHandlers = {
   patch?: (event: WebsocketEventPayload) => void;
   /** @deprecated Use `session.subscribeGeneration({ state })`. */
@@ -864,7 +916,7 @@ type SessionSubscriptionHandlers = {
   event?: (event: WebsocketEventPayload) => void;
 };
 type SessionEventName = "created" | "updated" | "turn.created" | "turn.patch" | "turn.lifecycle" | "turn.updated" | "turn.finalized" | "turn.error" | "message.persisted";
-type SpaceEventName = SessionEventName | "fs.changed" | "ports.changed" | "presence.updated" | "canvas.tx.applied" | "canvas.tx.ack" | "canvas.tx.error" | "task.created" | "task.updated" | "event";
+type SpaceEventName = SessionEventName | "fs.changed" | "ports.changed" | "presence.updated" | "board.transaction.applied" | "board.playback.changed" | "task.created" | "task.updated" | "event";
 declare class SpacesApi {
   private readonly transport;
   constructor(transport: HttpTransport);
@@ -1323,16 +1375,70 @@ declare class SpaceCommerceApi {
     businessKey: string;
   }>;
 }
-declare class SpaceCanvasApi {
+declare class BoardRealtimeClient {
+  private readonly websocketClient;
+  private readonly spaceId;
+  private readonly boardId;
+  constructor(websocketClient: WebsocketClient | null, spaceId: string, boardId: string);
+  subscribe(handlers: BoardSubscriptionHandlers): () => void;
+  on(type: "transaction", handler: (event: BoardTransactionAppliedEvent) => void): () => void;
+  on(type: "playback", handler: (event: BoardPlaybackChangedEvent) => void): () => void;
+}
+declare class BoardClient {
+  readonly spaceId: string;
+  readonly id: string;
+  readonly realtime: BoardRealtimeClient;
+  private readonly boards;
+  constructor(spaceId: string, id: string, transport: HttpTransport, websocketClient: WebsocketClient | null);
+  inspect(input?: BoardInspectInput, customFetch?: Fetch): Promise<BoardBootstrap>;
+  capabilities(customFetch?: Fetch): Promise<BoardCapabilities>;
+  validate(transaction: BoardTransactionInput): Promise<BoardValidationResult>;
+  apply(transaction: BoardTransactionInput): Promise<BoardBootstrap>;
+  playback(command: BoardPlaybackCommand): Promise<BoardPlaybackSnapshot>;
+  play(command: Omit<Extract<BoardPlaybackCommand, {
+    type: "play";
+  }>, "shared"> & {
+    shared?: true;
+  }): Promise<BoardPlaybackSnapshot>;
+  pause(command: Extract<BoardPlaybackCommand, {
+    type: "pause";
+  }>): Promise<BoardPlaybackSnapshot>;
+  seek(command: Extract<BoardPlaybackCommand, {
+    type: "seek";
+  }>): Promise<BoardPlaybackSnapshot>;
+  stop(command: Extract<BoardPlaybackCommand, {
+    type: "stop";
+  }>): Promise<BoardPlaybackSnapshot>;
+  subscribe(handlers: BoardSubscriptionHandlers): () => void;
+  on(type: "transaction", handler: (event: BoardTransactionAppliedEvent) => void): () => void;
+  on(type: "playback", handler: (event: BoardPlaybackChangedEvent) => void): () => void;
+}
+declare class SpaceBoardsApi {
   private readonly transport;
   private readonly spaceId;
-  constructor(transport: HttpTransport, spaceId: string);
-  create(input: CanvasCreateInput): Promise<CanvasBootstrapResponse>;
-  getByPath(path: string, customFetch?: Fetch): Promise<{
-    document: CanvasDocumentRecord;
-  }>;
-  bootstrap(documentId: string, customFetch?: Fetch): Promise<CanvasBootstrapResponse>;
-  sendTransaction(documentId: string, input: CanvasTransactionInput): Promise<CanvasBootstrapResponse>;
+  private readonly websocketClient;
+  constructor(transport: HttpTransport, spaceId: string, websocketClient: WebsocketClient | null);
+  byId(boardId: string): BoardClient;
+  create(input: BoardCreateInput): Promise<BoardBootstrap>;
+  inspect(boardId: string, input?: BoardInspectInput, customFetch?: Fetch): Promise<BoardBootstrap>;
+  capabilities(boardId: string, customFetch?: Fetch): Promise<BoardCapabilities>;
+  validate(transaction: BoardTransaction): Promise<BoardValidationResult>;
+  apply(transaction: BoardTransaction): Promise<BoardBootstrap>;
+  playback(boardId: string, command: BoardPlaybackCommand): Promise<BoardPlaybackSnapshot>;
+  play(boardId: string, command: Omit<Extract<BoardPlaybackCommand, {
+    type: "play";
+  }>, "shared"> & {
+    shared?: true;
+  }): Promise<BoardPlaybackSnapshot>;
+  pause(boardId: string, command: Extract<BoardPlaybackCommand, {
+    type: "pause";
+  }>): Promise<BoardPlaybackSnapshot>;
+  seek(boardId: string, command: Extract<BoardPlaybackCommand, {
+    type: "seek";
+  }>): Promise<BoardPlaybackSnapshot>;
+  stop(boardId: string, command: Extract<BoardPlaybackCommand, {
+    type: "stop";
+  }>): Promise<BoardPlaybackSnapshot>;
 }
 declare class SpaceCheckpointFilesApi {
   private readonly transport;
@@ -1403,10 +1509,11 @@ declare class SpaceClient {
   readonly sandbox: SpaceSandboxApi;
   readonly invitations: SpaceInvitationsApi;
   readonly labels: SpaceLabelsApi;
-  readonly canvas: SpaceCanvasApi;
+  readonly boards: SpaceBoardsApi;
   readonly commerce: SpaceCommerceApi;
   constructor(id: string, transport: HttpTransport, websocketClient: WebsocketClient | null);
   get(customFetch?: Fetch): Promise<SpaceRecord>;
+  getStartup(customFetch?: Fetch): Promise<SpaceStartupResponse>;
   prompt(input: CreateSpacePromptInput): Promise<CreateSpacePromptResponse>;
   /**
    * Raw LLM completion. Caller fully controls messages and optional system prompt file.
@@ -1428,11 +1535,6 @@ declare class SpaceClient {
   rename(name: string): Promise<{
     space: SpaceRecord;
   }>;
-  sendCanvasTransactionRealtime(documentId: string, input: CanvasTransactionInput): Promise<{
-    document: {
-      version: number;
-    };
-  }>;
   profile(body: {
     description?: string | null;
     avatarUrl?: string | null;
@@ -1445,6 +1547,7 @@ declare class SpaceClient {
   getConfig(): Promise<SpaceConfigResponse>;
   updateConfig(input: SpaceConfigInput): Promise<SpaceConfigUpdateResponse>;
   session(sessionId: string): SessionClient;
+  board(boardId: string): BoardClient;
   updatePresence(meta?: Record<string, unknown> | null): Promise<void>;
   subscribe(handler: (event: WebsocketEventPayload) => void): () => void;
   on(type: SpaceEventName, handler: (event: WebsocketEventPayload) => void): () => void;
@@ -1478,6 +1581,7 @@ declare class UserApi {
   private readonly transportBaseUrl;
   private readonly setStoredAuthToken?;
   private readonly clearStoredAuthToken?;
+  readonly labels: UserLabelsApi;
   constructor(transport: HttpTransport, transportBaseUrl: string, setStoredAuthToken?: ((token: string) => void) | undefined, clearStoredAuthToken?: (() => void) | undefined);
   getMe(options?: Fetch | {
     fetch?: Fetch;
@@ -1503,6 +1607,20 @@ declare class UserApi {
   setAuthToken(token: string): Promise<any>;
   clearAuthToken(): Promise<null>;
 }
+/** User-scoped labels — same label/assignment model as space labels, but private to the viewer. */
+declare class UserLabelsApi {
+  private readonly transport;
+  constructor(transport: HttpTransport);
+  getResourceLabels(resourceType: LabelResourceType, resourceRef: string): Promise<{
+    assignments: LabelAssignmentRecord[];
+  }>;
+  patchResourceLabels(resourceType: LabelResourceType, resourceRef: string, input: {
+    addLabelRefs?: string[];
+    removeLabelRefs?: string[];
+  }): Promise<{
+    assignments: LabelAssignmentRecord[];
+  }>;
+}
 //#endregion
 //#region src/apis/users.d.ts
 declare class UsersApi {
@@ -1792,4 +1910,4 @@ declare class CohubHttpClient {
 }
 declare const createHttpClient: (options?: CohubClientOptions) => CohubHttpClient;
 //#endregion
-export { GenerationStreamSubscriptionHandlers as $, CreateSpaceCompletionInput as $t, ReferralsApi as A, HttpError as At, SpacesApi as B, WorkRuntimeCheckoutStatus as Bt, WorkSessionResponse as C, PromptsApi as Ct, WorkVersionRecord as D, ChannelsApi as Dt, WorkUpdateInput as E, CronJobsApi as Et, SessionEventName as F, ParentBridgeTransport as Ft, GenerationStreamErrorEvent as G, createSlugWorkIdResolver as Gt, PublicInviteApi as H, WorkRuntimeModeConfig as Ht, SessionSubscriptionHandlers as I, PopupBrokerTransport as It, GenerationStreamIntermediateMessage as J, CompletionAssistantMessage as Jt, GenerationStreamEvent as K, createWorkRuntime as Kt, SpaceChannelBindingRecord as L, WorkIdResolver as Lt, UserApi as M, RawHttpResponse as Mt, TasksApi as N, joinApiUrl as Nt, WorkVisibility as O, CohubClientOptions as Ot, CanvasTransactionError as P, sanitizeAccessToken as Pt, GenerationStreamSubscribeOptions as Q, CompletionUsage as Qt, SpaceClient as R, WorkRuntimeApi as Rt, WorkResolveResponse as S, SkillsApi as St, WorkTargetType as T, GenerationsApi as Tt, AssistantMessageCommit as U, WorkRuntimeRequestOptions as Ut, WebSocketConnectionState as V, WorkRuntimeContext as Vt, GenerationStreamCommitEvent as W, WorkRuntimeTransport as Wt, GenerationStreamOutOfSyncEvent as X, CompletionMessageRole as Xt, GenerationStreamLifecycleEvent as Y, CompletionMessage as Yt, GenerationStreamStateEvent as Z, CompletionThinkingLevel as Zt, WorkMeta as _, normalizeRequestSource as _n, PublicAssetPurpose as _t, WorkCommerceCreditConsumeResponse as a, GenerationUsageBilling as an, SessionPatchApplyResult as at, WorkPublicSpaceRecord as b, requestSourceToHeaders as bn, UploadChatImageAttachmentInput as bt, WorkCommerceEntitlementsResponse as c, COHUB_SOURCE_HEADER as cn, SessionPatchStatus as ct, WorkCommercePurchaseResponse as d, RequestSource as dn, ReferenceResourceSelector as dt, SpaceCompletionResult as en, GenerationStreamTurnUpdatedEvent as et, WorkAuthorizeResponse as f, RequestSourceVia as fn, ReferencesApi as ft, WorkGetResponse as g, mergeRequestSourceIntoMeta as gn, PublicAssetMimeType as gt, WorkExtractedPageMeta as h, isRequestSourceUuid as hn, CreatePublicAssetUploadResponse as ht, WorkCommerceCheckoutStatus as i, GenerationTaskResult as in, SessionPatchApplyInput as it, UsersApi as j, HttpTransport as jt, WorksApi as k, Fetch as kt, WorkCommerceOrder as l, COHUB_SOURCE_HEADER_NAMES as ln, createSessionPatchReducer as lt, WorkDetailResponse as m, isRequestSourceEmpty as mn, CreatePublicAssetUploadInput as mt, createHttpClient as n, CreateGenerationTaskRequest as nn, createSessionGenerationStreamClient as nt, WorkCommerceCreditConsumeStatus as o, ListGenerationModelsResponse as on, SessionPatchReducer as ot, WorkCreateInput as p, hasRequestSourceIdentity as pn, SearchApi as pt, GenerationStreamFinalizedEvent as q, resolveWorkTransport as qt, WorkCommerceApi as r, CreateGenerationTaskResponse as rn, parseAssistantMessageCommit as rt, WorkCommerceEntitlement as s, PublicGenerationDeclaration as sn, SessionPatchState as st, CohubHttpClient as t, SpaceCompletionStreamEvent as tn, SessionGenerationStreamClient as tt, WorkCommerceProductResolveResponse as u, REQUEST_SOURCE_VIA_MAX_LENGTH as un, SessionAccessApi as ut, WorkPresentationMeta as v, parseRequestSourceFromHeaders as vn, PublicAssetsApi as vt, WorkStatus as w, ModelsApi as wt, WorkRecord as x, resolveRequestSourceChannel as xn, UploadPublicAssetInput as xt, WorkPublicOwnerRecord as y, readRequestSourceFromEnv as yn, UploadChatAttachmentInput as yt, SpaceEventName as z, WorkRuntimeCheckoutState as zt };
+export { GenerationStreamFinalizedEvent as $, resolveWorkTransport as $t, ReferralsApi as A, ModelsApi as At, BoardTransactionInput as B, sanitizeAccessToken as Bt, WorkSessionResponse as C, PublicAssetPurpose as Ct, WorkVersionRecord as D, UploadPublicAssetInput as Dt, WorkUpdateInput as E, UploadChatImageAttachmentInput as Et, BoardEventName as F, Fetch as Ft, SpaceEventName as G, WorkRuntimeCheckoutState as Gt, SessionSubscriptionHandlers as H, PopupBrokerTransport as Ht, BoardPlaybackChangedEvent as I, HttpError as It, PublicInviteApi as J, WorkRuntimeModeConfig as Jt, SpacesApi as K, WorkRuntimeCheckoutStatus as Kt, BoardSubscriptionHandlers as L, HttpTransport as Lt, UserApi as M, CronJobsApi as Mt, TasksApi as N, ChannelsApi as Nt, WorkVisibility as O, SkillsApi as Ot, BoardClient as P, CohubClientOptions as Pt, GenerationStreamEvent as Q, createWorkRuntime as Qt, BoardTransactionAppliedEvent as R, RawHttpResponse as Rt, WorkResolveResponse as S, ModelStatusResponse as Sn, PublicAssetMimeType as St, WorkTargetType as T, UploadChatAttachmentInput as Tt, SpaceChannelBindingRecord as U, WorkIdResolver as Ut, SessionEventName as V, ParentBridgeTransport as Vt, SpaceClient as W, WorkRuntimeApi as Wt, GenerationStreamCommitEvent as X, WorkRuntimeTransport as Xt, AssistantMessageCommit as Y, WorkRuntimeRequestOptions as Yt, GenerationStreamErrorEvent as Z, createSlugWorkIdResolver as Zt, WorkMeta as _, GenerationTaskResult as _n, ReferenceResourceSelector as _t, WorkCommerceCreditConsumeResponse as a, hasRequestSourceIdentity as an, GenerationStreamSubscriptionHandlers as at, WorkPublicSpaceRecord as b, PublicGenerationDeclaration as bn, CreatePublicAssetUploadInput as bt, WorkCommerceEntitlementsResponse as c, mergeRequestSourceIntoMeta as cn, createSessionGenerationStreamClient as ct, WorkCommercePurchaseResponse as d, readRequestSourceFromEnv as dn, SessionPatchApplyResult as dt, COHUB_SOURCE_HEADER as en, GenerationStreamIntermediateMessage as et, WorkAuthorizeResponse as f, requestSourceToHeaders as fn, SessionPatchReducer as ft, WorkGetResponse as g, CreateGenerationTaskResponse as gn, SessionAccessApi as gt, WorkExtractedPageMeta as h, CreateGenerationTaskRequest as hn, createSessionPatchReducer as ht, WorkCommerceCheckoutStatus as i, RequestSourceVia as in, GenerationStreamSubscribeOptions as it, UsersApi as j, GenerationsApi as jt, WorksApi as k, PromptsApi as kt, WorkCommerceOrder as l, normalizeRequestSource as ln, parseAssistantMessageCommit as lt, WorkDetailResponse as m, SpaceStartupResponse as mn, SessionPatchStatus as mt, createHttpClient as n, REQUEST_SOURCE_VIA_MAX_LENGTH as nn, GenerationStreamOutOfSyncEvent as nt, WorkCommerceCreditConsumeStatus as o, isRequestSourceEmpty as on, GenerationStreamTurnUpdatedEvent as ot, WorkCreateInput as p, resolveRequestSourceChannel as pn, SessionPatchState as pt, WebSocketConnectionState as q, WorkRuntimeContext as qt, WorkCommerceApi as r, RequestSource as rn, GenerationStreamStateEvent as rt, WorkCommerceEntitlement as s, isRequestSourceUuid as sn, SessionGenerationStreamClient as st, CohubHttpClient as t, COHUB_SOURCE_HEADER_NAMES as tn, GenerationStreamLifecycleEvent as tt, WorkCommerceProductResolveResponse as u, parseRequestSourceFromHeaders as un, SessionPatchApplyInput as ut, WorkPresentationMeta as v, GenerationUsageBilling as vn, ReferencesApi as vt, WorkStatus as w, PublicAssetsApi as wt, WorkRecord as x, ModelStatusEntry as xn, CreatePublicAssetUploadResponse as xt, WorkPublicOwnerRecord as y, ListGenerationModelsResponse as yn, SearchApi as yt, BoardTransactionError as z, joinApiUrl as zt };