@neta-art/cohub 2.7.1 → 2.8.0

package/dist/chunks/websocket.d.ts

@@ -46,6 +46,24 @@ type ContentBlock = {
   _meta?: ContentBlockMeta;
 };
 //#endregion
+//#region ../protocol/src/billing.d.ts
+/**
+ * Standard billing payload attached under the `billing` key of any response
+ * or realtime event that involves a billing gate. Present on 402 error bodies
+ * (blocked / not entitled), on success responses carrying a soft debt warning,
+ * and on realtime error events. `conversion` always drives the shared upgrade
+ * UI; balance fields appear only for balance-based gates.
+ *
+ * `conversion` is intentionally `unknown` here to keep the protocol layer free
+ * of a billing dependency — clients validate it against `BillingConversionIntent`.
+ */
+type BillingPayload = {
+  conversion: unknown;
+  status?: "blocked" | "allowed_with_debt";
+  netUsd?: number;
+  hardNegativeLimitUsd?: number;
+};
+//#endregion
 //#region ../protocol/src/core/usage.d.ts
 type Usage = {
   input?: number;
@@ -168,7 +186,7 @@ type SessionTurnSegmentRecord = {
   toSequence: number | null;
   createdAt: string;
 };
-type SessionBindingRecord = {
+type SessionBindingRecord$1 = {
   id: string;
   spaceId: string;
   spaceSessionId: string;
@@ -188,7 +206,7 @@ type SessionUserProfile = {
   displayName: string;
   avatarUrl: string | null;
 };
-type SessionRecord = {
+type SessionRecord$1 = {
   id: string;
   spaceId: string;
   userUuid: string | null;
@@ -376,7 +394,7 @@ type SystemSubscribeErrorEvent = {
     }>;
   };
 };
-type RealtimeSessionRecord = Pick<SessionRecord, "id" | "spaceId" | "userUuid" | "title" | "source" | "status" | "externalSessionId" | "latestMessageText" | "lastMessageAt" | "lastMessageId" | "createdAt" | "updatedAt">;
+type RealtimeSessionRecord = Pick<SessionRecord$1, "id" | "spaceId" | "userUuid" | "title" | "source" | "status" | "externalSessionId" | "latestMessageText" | "lastMessageAt" | "lastMessageId" | "createdAt" | "updatedAt">;
 type SessionCreatedEvent = {
   id: string;
   timestamp: number;
@@ -429,6 +447,7 @@ type SessionRequestErrorEvent = {
     code?: string;
     message: string;
     clientMessageId?: string | null;
+    billing?: BillingPayload | null;
   };
 };
 type RealtimePatchOperation = {
@@ -600,7 +619,7 @@ type SpacePortsChangedEvent = {
   sessionId?: string | null;
   payload: SpacePortsChangedPayload;
 };
-type SpacePresenceUser = {
+type SpacePresenceUser$1 = {
   userId: string;
   connectionCount: number;
   lastSeenAt: string;
@@ -613,9 +632,9 @@ type SpacePresenceUser = {
     avatarUrl: string | null;
   };
 };
-type SpacePresenceSnapshot = {
+type SpacePresenceSnapshot$1 = {
   spaceId: string;
-  users: SpacePresenceUser[];
+  users: SpacePresenceUser$1[];
   updatedAt: string;
 };
 type SpacePresenceUpdatedEvent = {
@@ -626,7 +645,7 @@ type SpacePresenceUpdatedEvent = {
   requestId?: string | null;
   spaceId: string;
   sessionId?: string | null;
-  payload: SpacePresenceSnapshot;
+  payload: SpacePresenceSnapshot$1;
 };
 type CanvasTransactionAppliedEvent = {
   id: string;
@@ -734,6 +753,1571 @@ type LabelAssignmentsUpdatedEvent = {
 };
 type RealtimeServerEvent = SystemReadyEvent | SystemAuthOkEvent | SystemRequestErrorEvent | SystemPongEvent | SystemAckOkEvent | SystemSubscribeOkEvent | SystemSubscribeErrorEvent | SessionCreatedEvent | SessionUpdatedEvent | SessionRequestAcceptedEvent | SessionRequestErrorEvent | SessionTurnCreatedEvent | SessionTurnPatchEvent | SessionTurnErrorEvent | SessionTurnLifecycleEvent | SessionTurnUpdatedEvent | SessionTurnFinalizedEvent | SessionTurnNotifyEvent | SessionMessagePersistedEvent | SpaceFsChangedEvent | SpacePortsChangedEvent | SpacePresenceUpdatedEvent | CanvasTransactionAppliedEvent | CanvasTransactionAckEvent | CanvasTransactionErrorEvent | TaskCreatedEvent | TaskUpdatedEvent | LabelAssignmentsUpdatedEvent;
 //#endregion
+//#region ../protocol/src/gateway/types.d.ts
+type ChannelModelConfig = {
+  provider: string;
+  id: string;
+};
+type BaseChannelConfig = {
+  model?: ChannelModelConfig | null;
+};
+type DiscordChannelConfig = BaseChannelConfig & {
+  inbound?: {
+    requireMentionInGuild?: boolean;
+  };
+  outbound?: {
+    showThinking?: boolean;
+    showToolCalls?: boolean;
+  };
+};
+type FeishuChannelConfig = BaseChannelConfig & {
+  brand?: "feishu" | "lark";
+  inbound?: {
+    requireMentionInGroup?: boolean;
+  };
+  outbound?: {
+    renderMode?: "card" | "post";
+    showThinking?: boolean;
+    showToolCalls?: boolean;
+  };
+};
+type WeChatChannelConfig = BaseChannelConfig & {
+  outbound?: {
+    showIntermediateStatus?: boolean;
+  };
+};
+type QQChannelConfig = BaseChannelConfig & {
+  inbound?: {
+    requireMentionInGroup?: boolean;
+  };
+  outbound?: {
+    markdownSupport?: boolean;
+  };
+};
+type ChannelConfig = DiscordChannelConfig | FeishuChannelConfig | WeChatChannelConfig | QQChannelConfig | (BaseChannelConfig & Record<string, unknown>);
+/** Runtime connection health for a bound gateway channel (space_channel id). */
+type ChannelRuntimeState = "unbound" | "connecting" | "ready" | "degraded" | "error" | "stopped";
+type ChannelHealthReasonCode = "invalid_credentials" | "auth_failed" | "network" | "permission" | "provider_error" | "unknown";
+type ChannelHealth = {
+  state: ChannelRuntimeState;
+  reasonCode?: ChannelHealthReasonCode | null;
+  message?: string | null;
+  detail?: string | null;
+  lastReadyAt?: string | null;
+  lastErrorAt?: string | null;
+  lastInboundAt?: string | null;
+  lastOutboundAt?: string | null;
+  nodeId?: string | null;
+  updatedAt: string;
+  meta?: Record<string, string> | null;
+};
+//#endregion
+//#region ../../node_modules/.pnpm/@neta-art+generation@0.1.12/node_modules/@neta-art/generation/dist/builtins-H7pH9ppJ.d.ts
+//#region src/types.d.ts
+declare const MODEL_SCHEMA: "neta.generation.model.v1";
+type GenerationSource = {
+  type: "url";
+  url: string;
+} | {
+  type: "base64";
+  mediaType: string;
+  data: string;
+};
+type GenerationContentBlockMeta = Record<string, unknown>;
+type GenerationContentBlock = {
+  type: "text";
+  text: string;
+  meta?: GenerationContentBlockMeta;
+} | {
+  type: "image";
+  source: GenerationSource;
+  meta?: GenerationContentBlockMeta;
+} | {
+  type: "video";
+  source: GenerationSource;
+  meta?: GenerationContentBlockMeta;
+} | {
+  type: "audio";
+  source: GenerationSource;
+  meta?: GenerationContentBlockMeta;
+};
+type GenerationResult = {
+  content: GenerationContentBlock[];
+  requestId?: string;
+  cost?: number;
+};
+type GenerationContentSpec = {
+  type: "text" | "image" | "video" | "audio";
+  required?: boolean;
+  min?: number;
+  max?: number;
+  sources?: Array<GenerationSource["type"]>;
+  roles?: string[];
+  roleRequired?: boolean;
+  merge?: "newline" | "space" | "concat";
+  meta?: Record<string, unknown>;
+  description?: string;
+};
+type GenerationParameterSpec = {
+  type: "string";
+  optional?: boolean;
+  default?: string;
+  enum?: string[];
+  description?: string;
+  examples?: string[];
+} | {
+  type: "number";
+  optional?: boolean;
+  default?: number;
+  min?: number;
+  max?: number;
+  description?: string;
+  examples?: number[];
+} | {
+  type: "integer";
+  optional?: boolean;
+  default?: number;
+  min?: number;
+  max?: number;
+  description?: string;
+  examples?: number[];
+} | {
+  type: "boolean";
+  optional?: boolean;
+  default?: boolean;
+  description?: string;
+  examples?: boolean[];
+};
+type GenerationMetaFieldSpec = GenerationParameterSpec | {
+  type: "object";
+  optional?: boolean;
+  description?: string;
+};
+type GenerationMetaTaskVariantSpec = {
+  description?: string;
+  required?: string[];
+  requiredContent?: Array<GenerationContentSpec["type"]>;
+  sendTask?: boolean;
+};
+type GenerationMetaSpec = {
+  fields?: Record<string, GenerationMetaFieldSpec>;
+  taskField?: string;
+  taskVariants?: Record<string, GenerationMetaTaskVariantSpec>;
+};
+type GenerationModelDeclaration = {
+  schema: typeof MODEL_SCHEMA;
+  model: string;
+  title?: string;
+  description?: string;
+  allowUnknownParameters?: boolean;
+  adapter: {
+    type: string;
+  } & Record<string, unknown>;
+  content: {
+    input: GenerationContentSpec[];
+  };
+  parameters?: Record<string, GenerationParameterSpec>;
+  meta?: GenerationMetaSpec;
+  examples?: Array<{
+    title?: string;
+    request: GenerateRequest;
+  }>;
+};
+type GenerateRequest = {
+  model: string;
+  content: GenerationContentBlock[];
+  parameters?: Record<string, unknown>;
+  meta?: Record<string, unknown>; /** @deprecated Use meta. */
+  metadata?: Record<string, unknown>;
+  apiKey?: string;
+  baseUrl?: string;
+};
+//#endregion
+//#region ../protocol/src/generation/policy.d.ts
+type GenerationPolicy = {
+  version: 1;
+  mode: "auto" | "limited";
+  models?: GenerationModelPolicy[];
+};
+type GenerationModelPolicy = {
+  model: string;
+  /**
+   * Generic constraints keyed by generation declaration parameter name.
+   * Missing parameters are not restricted by policy.
+   */
+  parameters?: Record<string, GenerationParameterConstraint>;
+};
+type GenerationParameterConstraint = {
+  kind: "enum";
+  values: Array<string | number | boolean>;
+} | {
+  kind: "number";
+  min?: number;
+  max?: number;
+  values?: number[];
+} | {
+  kind: "integer";
+  min?: number;
+  max?: number;
+  values?: number[];
+} | {
+  kind: "boolean";
+  value?: boolean;
+};
+declare class GenerationPolicyError extends Error {
+  constructor(message: string);
+}
+type EnvLike = Record<string, string | undefined>;
+type PublicDeclaration = Omit<GenerationModelDeclaration, "adapter">;
+declare function normalizeGenerationPolicy(value: unknown): GenerationPolicy | null;
+declare function encodeGenerationPolicy(policy: GenerationPolicy): string;
+declare function decodeGenerationPolicy(value: string): GenerationPolicy | null;
+declare function parseGenerationPolicyFromEnv(env: EnvLike): GenerationPolicy | null;
+declare function getAllowedGenerationModelIds(policy: GenerationPolicy | null): string[] | null;
+declare function findGenerationModelPolicy(policy: GenerationPolicy | null, model: string): GenerationModelPolicy | null;
+declare function assertGenerationRequestAllowedByPolicy(input: {
+  policy: GenerationPolicy | null;
+  model: string;
+  parameters?: Record<string, unknown>;
+}): void;
+declare function filterGenerationDeclarationsByPolicy<T extends PublicDeclaration>(declarations: T[], policy: GenerationPolicy | null): T[];
+//#endregion
+//#region ../protocol/src/generation/index.d.ts
+declare const GENERATION_TASK_TYPE: "generation";
+type CreateGenerationTaskRequest = {
+  spaceId: string;
+  sessionId?: string | null;
+  turnId?: string | null;
+  model: string;
+  content: GenerationContentBlock[];
+  parameters?: Record<string, unknown>;
+  meta?: Record<string, unknown>;
+};
+type CreateGenerationTaskResponse = {
+  taskRunId: string;
+  taskType: typeof GENERATION_TASK_TYPE;
+  status: "pending";
+  billing?: BillingPayload | null;
+};
+/**
+ * Final generation task payload stored on the task run.
+ *
+ * - `output` is the generated content blocks (SDK `GenerationResult.content`)
+ * - `requestId` maps to the provider response body's top-level `request_id`
+ * - `cost` maps to the official request price in `usage.cost`
+ * - `billing` records post-success credit consumption (when attempted)
+ * - `meta` is the request meta (including Cohub context such as taskRunId/spaceId)
+ */
+type GenerationUsageBilling = {
+  amountUsd: number;
+  usageType: string;
+  status: "recorded" | "overage" | "skipped";
+  reason?: string | null;
+};
+type GenerationTaskResult = {
+  model: string;
+  output: GenerationContentBlock[];
+  requestId?: string;
+  cost?: number; /** Post-success usage charge metadata. Distinct from gate `billing` on create. */
+  billing?: GenerationUsageBilling | null;
+  meta?: Record<string, unknown>;
+};
+type PublicGenerationDeclaration = Omit<GenerationModelDeclaration, "adapter">;
+type ListGenerationModelsResponse = {
+  models: PublicGenerationDeclaration[];
+};
+//#endregion
+//#region src/types.d.ts
+type ApiError = {
+  message: string;
+};
+type UserProfile = {
+  userUuid: string;
+  logtoUserId?: string;
+  username: string | null;
+  displayName: string;
+  avatarUrl: string | null;
+  syncedAt?: string;
+};
+type PublicUserProfile = {
+  userUuid: string;
+  username: string | null;
+  displayName: string;
+  avatarUrl: string | null;
+};
+type BatchUserProfilesResponse = {
+  profiles: Record<string, PublicUserProfile>;
+  missingUserUuids: string[];
+};
+type SpacePresenceUser = {
+  userId: string;
+  connectionCount: number;
+  lastSeenAt: string;
+  meta: Record<string, unknown> | null;
+  metas: Record<string, unknown>[];
+  profile: PublicUserProfile;
+};
+type SpacePresenceSnapshot = {
+  spaceId: string;
+  users: SpacePresenceUser[];
+  updatedAt: string;
+};
+type MeResponse = {
+  uuid: string;
+  profile: UserProfile;
+  email: string | null;
+};
+type BillingPluginStatus = {
+  provider: "disabled" | "talesofai";
+  configured: boolean;
+  reason?: string;
+};
+type BillingCreditUnit = {
+  tokenType: string;
+  displayCurrency: "USD";
+  displayUnit: string;
+  unitToUsd: number;
+  unitsPerUsd: number;
+  usdDecimalPlaces: number;
+};
+type BillingCreditGrantStatus = {
+  id: string;
+  tokenType: string;
+  benefitKey: string | null;
+  benefitName: string | null;
+  grantKind: string | null;
+  sourceType: string | null;
+  sourceId: string | null;
+  status: string;
+  availableNow: boolean | null;
+  unavailableReasons: string[];
+  remainingAmount: number;
+  remainingAmountUsd: number;
+  originalAmount: number | null;
+  originalAmountUsd: number | null;
+  consumedAmount: number | null;
+  consumedAmountUsd: number | null;
+  usageConsumedAmount: number | null;
+  usageConsumedAmountUsd: number | null;
+  settledOverageAmount: number | null;
+  settledOverageAmountUsd: number | null;
+  consumedPercent: number | null;
+  effectiveAt: string | null;
+  expiresAt: string | null;
+  daysRemaining: number | null;
+  createdAt: string;
+};
+type BillingCreditExpiryGroup = {
+  key: "expired" | "lt_7d" | "lt_30d" | "gte_30d" | "never";
+  remainingAmountUsd: number;
+  grants: BillingCreditGrantStatus[];
+};
+type BillingCreditStatus = {
+  netUsd: number;
+  groups: BillingCreditExpiryGroup[];
+};
+type BillingProductKind = "plan" | "addon";
+type BillingProductBillingInterval = "monthly" | "quarterly" | "yearly" | "one_time" | "other";
+type BillingProductPricing = {
+  amountMinor: number;
+  amountUsd: number;
+  compareAtAmountMinor: number | null;
+  compareAtAmountUsd: number | null;
+  discountLabel: string | null;
+  discountRate: number | null;
+};
+type BillingProductDisplay = {
+  description: string | null;
+  benefits: string[];
+  creditsAmount: number | null;
+  validity: string | null;
+  creditBenefits: BillingProductCreditBenefit[];
+};
+type BillingProductCreditBenefit = {
+  key: string;
+  name: string;
+  tokenType: string;
+  grantKind: string;
+  scope: string;
+  cycleAmount: number;
+  cycleAmountUsd: number;
+  periodAmount: number;
+  periodAmountUsd: number;
+  expiresInDays: number | null;
+};
+type BillingCatalogProduct = {
+  id: string;
+  key: string;
+  name: string;
+  description: string | null;
+  status: string;
+  visibility: string;
+  billingType: string;
+  billingPeriod: string;
+  billingIntervalCount: number;
+  currency: string;
+  kind: BillingProductKind;
+  interval: BillingProductBillingInterval;
+  pricing: BillingProductPricing;
+  display: BillingProductDisplay;
+  isDefaultPlan: boolean;
+};
+type SpaceCommerceFeatureBenefit = {
+  key: string;
+  name: string;
+  description: string | null;
+  status: string;
+  type: "feature";
+  config: {
+    type: "feature";
+    metadata: Record<string, string | number | boolean>;
+  };
+};
+type SpaceCommerceCreditsBenefit = {
+  key: string;
+  name: string;
+  description: string | null;
+  status: string;
+  type: "credits";
+  config: {
+    type: "credits";
+    amount: number;
+    expiresInDays: number | null;
+  };
+};
+type SpaceCommerceBenefit = SpaceCommerceFeatureBenefit | SpaceCommerceCreditsBenefit;
+type SpaceCommerceProductCreditBenefit = {
+  key: string;
+  name: string;
+  amount: number;
+  expiresInDays: number | null;
+};
+type SpaceCommerceProduct = {
+  id: string;
+  key: string;
+  name: string;
+  description: string | null;
+  status: string;
+  visibility: string;
+  billingType: string;
+  billingPeriod: string;
+  billingIntervalCount: number;
+  currency: string;
+  kind: "addon";
+  interval: "one_time";
+  pricing: {
+    amountMinor: number;
+    amountUsd: number;
+    compareAtAmountMinor: number | null;
+    compareAtAmountUsd: number | null;
+    discountLabel: string | null;
+    discountRate: number | null;
+  };
+  display: {
+    description: string | null;
+    benefits: string[];
+    creditsAmount: number | null;
+    validity: string | null;
+    creditBenefits: SpaceCommerceProductCreditBenefit[];
+  };
+  isDefaultPlan: boolean;
+};
+type SpaceCommerceProductBenefitBinding = {
+  id: string | null;
+  productKey: string;
+  benefitKey: string;
+  createdAt: string | null;
+};
+type SpaceCommerceBuyerProfile = {
+  displayName: string;
+  avatarUrl: string | null;
+};
+type SpaceCommerceOrder = {
+  id: string;
+  productKeySnapshot: string;
+  productNameSnapshot: string;
+  status: string;
+  amountSnapshot: number;
+  paidAmountSnapshot: number;
+  createdAt: string;
+  paidAt: string | null;
+  buyerProfile: SpaceCommerceBuyerProfile | null;
+};
+type BillingSubscriptionSummary = {
+  id: string;
+  productKey: string | null;
+  productName: string | null;
+  status: string;
+  currentPeriodStart: string | null;
+  currentPeriodEnd: string | null;
+  cancelAtPeriodEnd: boolean;
+};
+type BillingPaymentStatus = {
+  available: boolean;
+  reason: string | null;
+};
+type BillingCatalog = {
+  userId: string;
+  billing: BillingPluginStatus;
+  payment: BillingPaymentStatus;
+  products: BillingCatalogProduct[];
+  plans: BillingCatalogProduct[];
+  addons: BillingCatalogProduct[];
+  currentSubscriptions: BillingSubscriptionSummary[];
+  hasActiveSubscription: boolean;
+  defaultPlanProductKey: string | null;
+};
+type BillingHistoryPagination = {
+  hasMore: boolean;
+  nextPage: number | null;
+};
+type BillingCheckoutActionState = {
+  canPay: boolean;
+  checkoutUrl: string | null;
+  checkoutUsable: boolean;
+  canCancelCheckout: boolean;
+  canCancelAutoRenew: boolean;
+  unavailableReason: string | null;
+};
+type BillingSubscriptionHistoryStatus = {
+  id: string;
+  externalUserId: string;
+  productKey: string;
+  productName: string;
+  status: string;
+  amountMinor: number;
+  amountUsd: number;
+  paidAmountMinor: number;
+  paidAmountUsd: number;
+  currency: string;
+  billingPeriod: string;
+  billingIntervalCount: number;
+  currentPeriodStart: string | null;
+  currentPeriodEnd: string | null;
+  cancelAtPeriodEnd: boolean;
+  canceledAt: string | null;
+  checkoutExpiresAt: string | null;
+  checkoutCanceledAt: string | null;
+  checkoutExpiredAt: string | null;
+  paymentConflictedAt: string | null;
+  endedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+  providerStatus: string | null;
+  providerTerminal: boolean;
+  checkoutStatus: string | null;
+  actions: BillingCheckoutActionState;
+};
+type BillingSubscriptionHistoryList = {
+  userId: string;
+  billing: BillingPluginStatus;
+  page: number;
+  limit: number;
+  items: BillingSubscriptionHistoryStatus[];
+  pagination: BillingHistoryPagination;
+};
+type BillingCheckoutResult = {
+  userId: string;
+  billing: BillingPluginStatus;
+  payment: BillingPaymentStatus;
+  productKey: string;
+  checkoutUrl: string | null;
+  checkoutUsable: boolean;
+  message: string | null;
+  orderId: string | null;
+  subscriptionId: string | null;
+  reused: boolean;
+};
+type BillingRedemptionResult = {
+  userId: string;
+  billing: BillingPluginStatus;
+  redeemed: boolean;
+  message: string | null;
+  redemptionRecordId: string | null;
+  itemCount: number;
+};
+type BillingConversionIntent = {
+  level: "soft" | "hard";
+  reason: "negative_balance" | "negative_balance_limit_exceeded" | "feature_not_entitled";
+  audience: "free" | "paid" | "unknown";
+  preferredOfferKind: "plan" | "upgrade" | "addon" | "mixed";
+  title: string;
+  message: string;
+  primaryAction: {
+    label: string;
+    action: "open_billing_conversion";
+  };
+  source: string;
+};
+/**
+ * Standard `billing` payload on 402 error bodies and soft-warning success
+ * responses. `conversion` drives the shared upgrade UI.
+ */
+type BillingResponsePayload = {
+  conversion: BillingConversionIntent;
+  status?: "blocked" | "allowed_with_debt";
+  netUsd?: number;
+  hardNegativeLimitUsd?: number;
+};
+type BillingBalanceActivityKind = "grant" | "usage" | "refund" | "expire" | "revoke" | "adjust";
+type BillingBalanceActivityStatus = "covered" | "overage" | "partial" | null;
+type BillingBalanceActivity = {
+  id: string;
+  kind: BillingBalanceActivityKind;
+  tokenType: string;
+  title: string;
+  description: string | null;
+  sourceType: string | null;
+  sourceId: string | null;
+  operationId: string | null;
+  amountUsd: number;
+  status: BillingBalanceActivityStatus;
+  createdAt: string;
+};
+type BillingBalanceActivityList = {
+  userId: string;
+  billing: BillingPluginStatus;
+  tokenType: string;
+  unit: BillingCreditUnit;
+  page: number;
+  limit: number;
+  items: BillingBalanceActivity[];
+  pagination: BillingHistoryPagination;
+};
+type UserRulesResponse = {
+  content: string;
+  updatedAt: string | null;
+  source: "config-space";
+  path: string;
+};
+type SpaceFsEntry = {
+  name: string;
+  path: string;
+  type: "file" | "dir" | "symlink";
+  size: number;
+  mimeType: string | null;
+  mtimeMs: number;
+};
+type SpaceFsTreeResponse = {
+  path: string;
+  entries: SpaceFsEntry[];
+};
+type SpaceFsFileKind = "text" | "binary";
+type SpaceFsEncoding = "utf-8" | "base64";
+type SpaceFsFileResponse = {
+  path: string;
+  name: string;
+  size: number;
+  mimeType: string | null;
+  mtimeMs: number;
+  kind: SpaceFsFileKind;
+  encoding: SpaceFsEncoding;
+  content: string;
+  delivery?: "inline" | "url";
+  url?: string;
+};
+type SpaceFsReadFilesInput = {
+  paths: string[];
+};
+type SpaceFsReadFilesError = {
+  path: string;
+  code: string;
+  message: string;
+  status: number;
+};
+type SpaceFsPreparingFile = {
+  path: string;
+  name: string;
+  size: number;
+  mimeType: string | null;
+  mtimeMs: number;
+  retryAfterMs: number;
+};
+type SpaceFsReadFilesResponse = {
+  files: SpaceFsFileResponse[];
+  preparing?: SpaceFsPreparingFile[];
+  errors: SpaceFsReadFilesError[];
+};
+type SpaceFsWriteFileInput = {
+  path: string;
+  content: string;
+  encoding: SpaceFsEncoding;
+};
+type SpaceFsMoveInput = {
+  fromPath: string;
+  toPath: string;
+};
+type SpaceFsUploadEntry = {
+  path: string;
+  name: string;
+  size: number;
+  mimeType: string | null;
+  mtimeMs: number;
+};
+type SpaceFsUploadError = {
+  name: string;
+  code: "file_too_large" | "name_invalid" | "path_invalid" | "write_failed" | "object_missing";
+  message: string;
+};
+type SpaceFsUploadResponse = {
+  uploaded: SpaceFsUploadEntry[];
+  errors: SpaceFsUploadError[];
+};
+type SpaceFsUploadPlanEntryInput = {
+  id: string;
+  name: string;
+  relativePath: string;
+  size: number;
+  mimeType?: string | null;
+  lastModified?: number;
+};
+type SpaceFsUploadDestination = {
+  kind: "workspace";
+  targetDir?: string;
+} | {
+  kind: "sandbox_tmp";
+  sessionId: string;
+};
+type SpaceFsCreateUploadInput = {
+  destination: SpaceFsUploadDestination;
+  entries: SpaceFsUploadPlanEntryInput[];
+};
+type SpaceFsUploadPlanEntry = {
+  id: string;
+  objectKey: string;
+  uploadUrl: string;
+  headers?: Record<string, string>;
+};
+type SpaceFsCreateUploadResponse = {
+  uploadId: string;
+  expiresAt: string;
+  entries: SpaceFsUploadPlanEntry[];
+};
+type SpaceFsCompleteUploadInput = {
+  entries: Array<{
+    id: string;
+    etag?: string | null;
+  }>;
+};
+type SpaceFsCompleteUploadResponse = {
+  ok: true;
+  uploaded: SpaceFsUploadEntry[];
+};
+type SpaceFsUploadProgress = {
+  phase: "queued" | "importing" | "done" | "failed";
+  totalFiles: number;
+  importedFiles: number;
+  totalBytes: number;
+  importedBytes: number;
+  currentPath?: string;
+  errors: SpaceFsUploadError[];
+};
+type SessionBindingRecord = SessionBindingRecord$1;
+type SessionRecord = SessionRecord$1 & {
+  bindings?: SessionBindingRecord[];
+  totalMessages?: number;
+  totalToolCalls?: number;
+  totalInputTokens?: number;
+  totalOutputTokens?: number;
+  totalCost?: string | number | null;
+};
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+type JsonObject = {
+  [key: string]: JsonValue;
+};
+type SpaceSandboxAutoDestroyPolicy = {
+  mode: "idle";
+  ttlSeconds: number;
+} | {
+  mode: "never";
+};
+type SpaceSandboxProvider = "cloud" | "local";
+type SandboxSpecId = "standard" | "boost" | "ultra";
+type SpaceSandboxConfig = {
+  provider?: SpaceSandboxProvider;
+  autoDestroy: SpaceSandboxAutoDestroyPolicy;
+  spec?: SandboxSpecId;
+  appliedSpec?: SandboxSpecId | null;
+  specPendingRestart?: boolean;
+  allowedSpec?: SandboxSpecId;
+  specs?: Record<string, unknown>;
+};
+type SpaceConfig = {
+  sandbox?: SpaceSandboxConfig;
+};
+type SpacePublicProfile = {
+  avatarUrl: string | null;
+};
+type SpaceMeta = JsonObject & {
+  config?: SpaceConfig;
+  extraEnv?: SpaceEnvInput[];
+  publicProfile?: Partial<SpacePublicProfile> | null;
+};
+type SpaceRecord = {
+  id: string;
+  userUuid: string;
+  name: string | null;
+  slug: string | null;
+  description: string | null;
+  storageRepoName?: string | null;
+  baseCheckpointId?: string | null;
+  headCheckpointId?: string | null;
+  title: string | null;
+  status: string | null;
+  meta: SpaceMeta | null;
+  publicProfile?: SpacePublicProfile;
+  createdAt: string;
+  updatedAt: string;
+  lastActivityAt?: string | null;
+  channels?: {
+    id: string;
+    name: string | null;
+    provider: string;
+    status: string;
+  }[];
+  access?: SpaceAccess;
+  accessLevel?: "minimal";
+  ownerProfile?: Pick<UserProfile, "userUuid" | "username" | "displayName" | "avatarUrl"> | null;
+};
+type SpaceBootstrapSource = {
+  type: "blank";
+} | {
+  type: "git_repo";
+  repoUrl?: string;
+  ref?: string | null;
+} | {
+  type: "checkpoint";
+  checkpointId: string;
+};
+type SpaceConfigInput = {
+  sandbox?: {
+    provider?: SpaceSandboxProvider;
+    autoDestroy?: SpaceSandboxAutoDestroyPolicy;
+    spec?: SandboxSpecId;
+  };
+};
+type CreateSpaceModInput = {
+  modSpaceId: string;
+  name?: string | null;
+  mountSlug?: string | null;
+  enabled?: boolean;
+};
+type CreateSpaceInput = {
+  name?: string;
+  slug?: string | null;
+  description?: string | null;
+  source?: string;
+  extraEnv?: SpaceEnvInput[];
+  channelBindings?: SpaceChannelBindingInput[];
+  mods?: CreateSpaceModInput[];
+  bootstrapSource?: SpaceBootstrapSource;
+  config?: SpaceConfigInput;
+};
+type SpaceConfigResponse = {
+  config: Required<Pick<SpaceConfig, "sandbox">>;
+};
+type SpaceConfigUpdateResponse = {
+  space: SpaceRecord;
+  sandbox?: {
+    resized?: boolean;
+    applying?: boolean;
+    pendingRestart?: boolean;
+    appliedSpec?: SandboxSpecId;
+    skipped?: boolean;
+    message?: string;
+  };
+};
+type CanvasDocumentRecord = {
+  id: string;
+  spaceId: string;
+  filePath: string;
+  title: string;
+  version: number;
+  meta?: Record<string, unknown> | null;
+  createdAt: string | null;
+  updatedAt: string | null;
+  deletedAt?: string | null;
+};
+type CanvasNodeRecord = {
+  documentId: string;
+  nodeId: string;
+  type: string;
+  parentId?: string | null;
+  orderKey?: string | null;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  rotation: number;
+  refKind?: string | null;
+  refPath?: string | null;
+  refUrl?: string | null;
+  view: Record<string, unknown>;
+  style: Record<string, unknown>;
+  animation: Record<string, unknown>;
+  data: Record<string, unknown>;
+  version: number;
+  createdAt: string | null;
+  updatedAt: string | null;
+  deletedAt?: string | null;
+};
+type CanvasNodeInput = Omit<CanvasNodeRecord, "documentId" | "version" | "createdAt" | "updatedAt" | "deletedAt">;
+type CanvasSemanticOp = {
+  opId?: string;
+  type: "node.create" | "node.patch" | "node.delete";
+  payload: Record<string, unknown>;
+  inverse?: Record<string, unknown>;
+};
+type CanvasTransactionInput = {
+  txId: string;
+  baseVersion?: number | null;
+  clientId?: string | null;
+  undoGroupId?: string | null;
+  ops: CanvasSemanticOp[];
+};
+type CanvasCreateInput = {
+  path: string;
+  title?: string;
+  nodes?: CanvasNodeInput[];
+};
+type CanvasBootstrapResponse = {
+  document: CanvasDocumentRecord;
+  nodes: CanvasNodeRecord[];
+};
+type SpaceCreateResponse = {
+  space: SpaceRecord;
+  taskRunId: string;
+};
+type SpaceDefaultResponse = {
+  space: SpaceRecord | null;
+};
+type SpaceListItem = SpaceRecord;
+type SessionMessagesResponse = {
+  session: SessionRecord;
+  messages: MessageRecord[];
+};
+type SessionMessageResponse = {
+  session: SessionRecord;
+  message: MessageRecord;
+};
+type SessionMessagesPaginatedResponse = {
+  session: SessionRecord;
+  messages: MessageRecord[];
+  hasMore: boolean;
+  nextCursor: number | undefined;
+};
+type SessionTurnsPaginatedResponse = {
+  session: SessionRecord;
+  turns: SessionTurnRecord[];
+  hasMore: boolean;
+  nextCursor: number | undefined;
+};
+type SessionTurnIndexResponse = {
+  session: SessionRecord;
+  turns: SessionTurnIndexItem[];
+  hasMore: boolean;
+  nextCursor: number | undefined;
+};
+type SessionTurnWindowResponse = {
+  session: SessionRecord;
+  turns: SessionTurnRecord[];
+  hasMoreOlder: boolean;
+  hasMoreNewer: boolean;
+  oldestCursor: number | undefined;
+  newestCursor: number | undefined;
+  anchorSequence: number | undefined;
+};
+type SessionTurnResponse = {
+  session: SessionRecord;
+  turn: SessionTurnRecord;
+  billing?: BillingResponsePayload | null;
+};
+type SessionTurnSignedUrlsResponse = {
+  urls: Record<string, string>;
+};
+type SessionTurnStreamSnapshotResponse = {
+  snapshot: {
+    version: 2;
+    spaceId: string;
+    sessionId: string;
+    turnId: string | null;
+    anchorUserMessageId: string | null;
+    seq: number;
+    current: {
+      messageId: string | null;
+      messageOrdinal: number | null;
+      content: ContentBlock[];
+      appendPath: string | null;
+    };
+    intermediateMessages: Array<{
+      messageId: string | null;
+      messageOrdinal: number | null;
+      content: ContentBlock[];
+      id?: string;
+      sessionId?: string;
+      role?: "user" | "assistant" | "system";
+      text?: string | null;
+      provider?: string | null;
+      model?: string | null;
+      stopReason?: string | null;
+      errorMessage?: string | null;
+      usage?: Usage | null;
+      toolCallsObjectKey?: string | null;
+      meta?: Record<string, unknown> | null;
+      createdAt?: string;
+    }>;
+    lifecycle?: {
+      phase: "llm_call_started";
+      llmRound: number;
+      provider: string | null;
+      model: string | null;
+      at: string;
+    } | null;
+    updatedAt: number;
+  } | null;
+};
+type ModelCatalogEntry = {
+  provider: string;
+  id: string;
+  model: Record<string, unknown>;
+};
+type PromptTemplateCatalogEntry = {
+  name: string;
+  description: string;
+  argumentHint?: string;
+  category?: string;
+  scope: "platform" | "mod" | "user" | "project";
+};
+type PromptTemplateCatalogResponse = {
+  prompts: PromptTemplateCatalogEntry[];
+};
+type Channel = {
+  id: string;
+  userUuid: string;
+  provider: string;
+  name: string;
+  status: string;
+  createdAt: string;
+  updatedAt: string;
+  boundSpace: {
+    id: string;
+    title: string | null;
+    status: string;
+  } | null;
+  health?: ChannelHealth | null;
+};
+type SpaceEnvInput = {
+  name: string;
+  value: string;
+};
+type SpaceChannelBindingInput = {
+  channelId: string;
+  config?: ChannelConfig | null;
+};
+type GlobalSearchType = "turn" | "session" | "space" | "label";
+type GlobalSearchResult = {
+  type: GlobalSearchType;
+  id: string;
+  spaceId: string;
+  sessionId: string | null;
+  turnId: string | null;
+  sequence: number | null;
+  title: string;
+  excerpt?: string | null;
+  spaceName?: string | null;
+  sessionTitle?: string | null;
+  ownerProfile?: Pick<UserProfile, "userUuid" | "username" | "displayName" | "avatarUrl"> | null;
+  spaceProfile?: SpacePublicProfile | null;
+  matchedField: "userText" | "title" | "name" | "description" | "labelName" | "labelItemContent";
+  href: string;
+  score: number;
+  textScore: number;
+  recencyScore: number;
+  typePriorityScore: number;
+  membershipPriorityScore?: number;
+  labelRef?: string | null;
+  labelName?: string | null;
+  labelResourceType?: LabelResourceType | null;
+  labelResourceRef?: string | null;
+  updatedAt: string | null;
+  source: "remote";
+};
+type GlobalSearchResponse = {
+  items: GlobalSearchResult[];
+  query: string;
+  source: "remote";
+  degraded?: boolean;
+};
+type CreateSpaceSessionInput = {
+  title?: string | null;
+  source?: string | null;
+  labelRefs?: string[];
+};
+type SpaceSessionsResponse = {
+  sessions: SessionRecord[];
+  forks?: Array<SessionForkRecord & {
+    firstUserTextAfterFork?: string | null;
+    parentTitle?: string | null;
+  }>;
+  pageInfo?: {
+    hasMore: boolean;
+    nextCursor: string | null;
+  };
+};
+type PromptAccessMode = "read_only" | "full_access";
+type CreateSpacePromptInput = {
+  sessionId?: string | null;
+  title?: string | null;
+  source?: string | null;
+  content: ContentBlock[];
+  model?: string | null;
+  provider?: string | null;
+  clientMessageId?: string | null;
+  generationPolicy?: GenerationPolicy | null;
+  intent?: "followup" | "steer" | "compact" | null;
+  accessMode?: PromptAccessMode | null;
+  env?: Record<string, string> | null;
+  labelRefs?: string[];
+  schedule?: {
+    mode?: "immediate";
+  } | {
+    mode: "delay";
+    delayMs: number;
+  } | {
+    mode: "at";
+    sendAt: string;
+  } | {
+    mode: "repeat";
+    cronExpression: string;
+    timezone: string;
+  };
+};
+type CreateSpacePromptResponse = (SessionTurnResponse & {
+  mode: "immediate";
+}) | {
+  mode: "delay" | "at";
+  taskRunId: string;
+  scheduledAt: string;
+  sessionId: string | null;
+} | {
+  mode: "repeat";
+  cronJobId: string;
+  nextRunAt: string;
+  timezone: string;
+  sessionId: string | null;
+};
+type CronJobPayload = Record<string, unknown>;
+type SendMessageCronJobPayload = CronJobPayload & {
+  content: ContentBlock[];
+  clientMessageId?: string;
+  generationPolicy?: unknown;
+  intent?: "followup" | "steer" | string;
+  accessMode?: "read_only" | "full_access";
+  env?: Record<string, string> | null;
+  source?: string;
+  sessionId?: string;
+  title?: string;
+  model?: string;
+  provider?: string;
+  labelIds?: string[];
+};
+type CronJobUpdatePatch<TPayload extends CronJobPayload = CronJobPayload> = {
+  title?: string;
+  payload?: TPayload;
+  cronExpression?: string;
+  timezone?: string;
+  enabled?: boolean;
+};
+type CursorPageInfo = {
+  hasMore: boolean;
+  nextCursor: string | null;
+};
+type CronJobRecord<TPayload extends CronJobPayload = CronJobPayload> = {
+  id: string;
+  userUuid: string;
+  userProfile?: UserProfile;
+  title: string;
+  taskType: string;
+  payload: TPayload;
+  cronExpression: string;
+  timezone: string;
+  bullJobKey: string;
+  spaceId: string | null;
+  sessionId: string | null;
+  enabled: boolean;
+  createdAt: string;
+  updatedAt: string;
+};
+type TaskRunDetailResponse = {
+  run: TaskRunRecord;
+  progress: unknown;
+};
+type TaskRunRecord = {
+  id: string;
+  jobId: string;
+  cronJobId: string | null;
+  taskType: string;
+  status: "pending" | "running" | "completed" | "failed";
+  payload: unknown;
+  result: unknown;
+  errorMessage: string | null;
+  attemptCount: number;
+  spaceId: string | null;
+  sessionId: string | null;
+  turnId: string | null;
+  userUuid: string | null;
+  userProfile?: UserProfile;
+  scheduledAt: string | null;
+  startedAt: string | null;
+  finishedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+type CheckpointRecord = {
+  id: string;
+  spaceId: string;
+  commitHash: string;
+  description: string;
+  parentCheckpointId: string | null;
+  rootCheckpointId?: string | null;
+  forkCount: number;
+  saveVersion?: number;
+  meta?: Record<string, unknown> | null;
+  createdAt: string;
+};
+type SpaceCheckpointDetailResponse = {
+  checkpoint: CheckpointRecord;
+};
+type CheckpointDiffStatus = "A" | "M" | "D" | "R" | "C" | "T";
+type CheckpointDiffStats = {
+  changedFileCount: number;
+  addedFileCount: number;
+  modifiedFileCount: number;
+  deletedFileCount: number;
+  renamedFileCount: number;
+  copiedFileCount: number;
+  additions: number;
+  deletions: number;
+};
+type CheckpointDiffFile = {
+  status: CheckpointDiffStatus;
+  path: string;
+  oldPath?: string | null;
+  additions: number | null;
+  deletions: number | null;
+  binary: boolean;
+  asset: boolean;
+};
+type CheckpointDiffDelivery = "inline" | "url";
+type CheckpointDiffSummary = {
+  baseCheckpointId: string | null;
+  baseCommitHash: string | null;
+  headCheckpointId: string;
+  headCommitHash: string;
+  files: CheckpointDiffFile[];
+  truncated: boolean;
+  stats: CheckpointDiffStats;
+  delivery?: CheckpointDiffDelivery;
+  url?: string;
+  precomputed?: boolean;
+};
+type CheckpointDiffPatchKind = "text" | "binary" | "asset" | "too_large" | "unavailable";
+type CheckpointDiffPatchLine = {
+  type: "context" | "add" | "del" | "hunk" | "meta";
+  text: string;
+};
+type CheckpointDiffFileResponse = {
+  path: string;
+  oldPath?: string | null;
+  status: CheckpointDiffStatus | null;
+  kind: CheckpointDiffPatchKind;
+  binary: boolean;
+  asset: boolean;
+  additions: number | null;
+  deletions: number | null;
+  oldSize?: number | null;
+  newSize?: number | null;
+  truncated: boolean;
+  lines: CheckpointDiffPatchLine[];
+  delivery?: CheckpointDiffDelivery;
+  url?: string;
+  precomputed?: boolean;
+};
+type SpacePendingDiffSummary = {
+  baseCheckpointId: string | null;
+  files: CheckpointDiffFile[];
+  truncated: boolean;
+  incomplete: boolean;
+  stats: CheckpointDiffStats;
+};
+type SpacePendingDiffFileResponse = CheckpointDiffFileResponse & {
+  baseCheckpointId: string | null;
+};
+type SpaceRole = "host" | "builder" | "guest";
+type SpaceMember = {
+  userId: string;
+  role: SpaceRole;
+  profile: UserProfile;
+  createdAt: string;
+  updatedAt: string;
+};
+type LabelScopeType = "space" | "user" | "org";
+type LabelSource = "user" | "system";
+type LabelResourceType = "session" | "checkpoint" | "file";
+type LabelRecord = {
+  id: string;
+  scopeType: LabelScopeType;
+  scopeId: string;
+  name: string;
+  slug: string;
+  parentId: string | null;
+  depth: number;
+  source: LabelSource;
+  systemKey: string | null;
+  rank: number;
+  createdBy: string | null;
+  createdAt: string | null;
+  updatedAt: string | null;
+};
+type LabelListItem = LabelRecord & {
+  children?: LabelListItem[];
+};
+type LabelAssignmentRecord = {
+  id: string;
+  labelId: string;
+  scopeType: LabelScopeType;
+  scopeId: string;
+  resourceType: LabelResourceType;
+  resourceRef: string;
+  rank: number | null;
+  source: LabelSource;
+  createdBy: string | null;
+  meta: Record<string, unknown> | null;
+  createdAt: string | null;
+  updatedAt: string | null;
+};
+type LabelAssignmentListItem = LabelAssignmentRecord & {
+  href: string;
+  resource: {
+    title: string;
+    subtitle: string | null;
+    status: string | null;
+  } | null;
+};
+type LabelAssignmentPageInfo = {
+  hasMore: boolean;
+  nextCursor: string | null;
+};
+/** Optional hydrated session previews for label item pages (avoids N+1 session detail fetches). */
+type LabelItemsSessionFork = SessionForkRecord & {
+  firstUserTextAfterFork?: string | null;
+  parentTitle?: string | null;
+};
+type LabelItemsResponse = {
+  items: LabelAssignmentListItem[];
+  pageInfo: LabelAssignmentPageInfo; /** Hydrated sessions for this page (optional for older servers). */
+  sessions?: SessionRecord[]; /** Fork edges for page sessions (optional for older servers). */
+  forks?: LabelItemsSessionFork[];
+};
+type PatchResourceLabelsInput = {
+  addLabelRefs?: string[];
+  removeLabelRefs?: string[];
+};
+type ResourceLabelsResponse = {
+  labels: LabelListItem[];
+  assignments: LabelAssignmentRecord[];
+};
+type PatchResourceLabelsResponse = ResourceLabelsResponse & {
+  changed: boolean;
+};
+type SpaceModListItem = {
+  id: string;
+  spaceId: string;
+  modSpaceId: string;
+  name: string | null;
+  mountSlug: string;
+  mountPath: string;
+  enabled: boolean;
+  sortOrder: number;
+  createdBy: string;
+  createdAt: string | null;
+  updatedAt: string | null;
+  modSpaceName: string | null;
+  modSpaceDescription: string | null;
+};
+/**
+ * Public-safe DTO for Explore spaces.
+ * Only contains fields safe for unauthenticated product rendering.
+ */
+type ExploreSpaceItem = {
+  id: string;
+  slug: string | null;
+  title: string;
+  summary: string | null;
+  spaceUrl: string;
+  avatarUrl: string | null;
+  avatarAlt: string | null;
+  ownerDisplayName: string | null;
+  ownerAvatarUrl: string | null;
+  category: string | null;
+  tags: string[];
+  saveCount: number;
+  pinCount: number;
+  forkCount: number;
+  updatedAt: string | null;
+  accessLabel: "public" | "sign-in-required" | "unknown";
+  latestSaveLabel: string | null;
+};
+type ExploreSection = {
+  key: string;
+  title: string | null;
+  subtitle: string | null;
+  description: string | null;
+  spaces: ExploreSpaceItem[];
+};
+type ExploreSpacesResponse = {
+  sections: ExploreSection[];
+  spaces: ExploreSpaceItem[];
+};
+type Permission = "space.view" | "space.edit" | "space.label.view" | "space.label.manage" | "space.label.assign" | "session.view" | "session.edit" | "session.prompt.readonly" | "session.prompt.fullaccess" | "generation.create" | "file.view" | "file.view.filtered" | "file.edit" | "checkpoint.view" | "checkpoint.edit" | "member.view" | "member.manage" | "channel.view" | "channel.manage" | "cronjob.view" | "cronjob.manage" | "taskrun.view" | "sandbox.view" | "sandbox.manage" | "mod.view" | "mod.manage" | "user.space.list" | "user.session.list" | "user.usage.read";
+type SpaceAccess = {
+  role: SpaceRole | null;
+  permissions: Permission[];
+};
+type SpaceAccessPolicy = {
+  signed_in_user: SpaceRole | null;
+  anonymous_user: SpaceRole | null;
+};
+type SpaceUsageHourlyStat = {
+  bucketStartAt: string;
+  totalTokens: number;
+  inputTokens: number;
+  outputTokens: number;
+  cacheReadTokens: number;
+  cacheWriteTokens: number;
+  costInput: number;
+  costOutput: number;
+  costCacheRead: number;
+  costCacheWrite: number;
+  costTotal: number;
+  requestCount: number;
+  successCount: number;
+  errorCount: number;
+  models: string[];
+};
+type SpaceUsageSummary = {
+  totalTokens: number;
+  inputTokens: number;
+  outputTokens: number;
+  cacheReadTokens: number;
+  cacheWriteTokens: number;
+  costInput: number;
+  costOutput: number;
+  costCacheRead: number;
+  costCacheWrite: number;
+  costTotal: number;
+  requestCount: number;
+  successCount: number;
+  errorCount: number;
+};
+type GenerationUsageHourlyStat = {
+  bucketStartAt: Date | string;
+  costTotal: number;
+  requestCount: number;
+  successCount: number;
+  errorCount: number;
+  models: string[];
+  usageTypes: string[];
+};
+type GenerationUsageSummary = {
+  costTotal: number;
+  requestCount: number;
+  successCount: number;
+  errorCount: number;
+};
+type GenerationUsageBlock = {
+  hourly: GenerationUsageHourlyStat[];
+  summary: GenerationUsageSummary;
+};
+type SpaceUsageResponse = {
+  hourly: SpaceUsageHourlyStat[];
+  summary: SpaceUsageSummary; /** Multimodal generation rollups (image / video / music). Optional for older servers. */
+  generation?: GenerationUsageBlock;
+  days: number;
+};
+type SpaceInvitation = {
+  token: string;
+  role: SpaceRole;
+  status: "active" | "revoked" | "exhausted";
+  useCount: number;
+  maxUses: number | null;
+  createdAt: string | null;
+  expiresInSeconds: number | null;
+};
+type CreateInvitationInput = {
+  role?: SpaceRole;
+  ttlSeconds?: number;
+  maxUses?: number;
+};
+type CreateInvitationResponse = {
+  token: string;
+  role: SpaceRole;
+  expiresAt: string;
+  maxUses: number | null;
+};
+type InvitationDetail = {
+  token: string;
+  spaceId: string;
+  spaceName: string;
+  role: SpaceRole;
+  expiresInSeconds: number | null;
+};
+type AcceptInvitationResponse = {
+  ok: true;
+  spaceId: string;
+  spaceName: string;
+  role: SpaceRole;
+};
+type ReferenceResourceType = "space" | "session" | "checkpoint" | "user" | "file" | "tool";
+/**
+ * Resource types usable as a query `source`. Only these have an owning space to
+ * authorize against; user/file/tool appear only as reference targets.
+ */
+type ReferenceQueryableType = "space" | "session" | "checkpoint";
+type ReferenceKind = "session_fork" | "space_fork" | "checkpoint_fork" | "mention" | "tool_call" | "mod" | "participant";
+type ReferenceDirection = "out" | "in" | "both";
+type ReferenceRecord = {
+  kind: ReferenceKind;
+  sourceType: ReferenceResourceType;
+  sourceId: string;
+  sourceTurnId: string | null;
+  targetType: ReferenceResourceType;
+  targetId: string;
+  spaceId: string;
+  sessionId: string | null;
+  count: number;
+  createdAt: string;
+  updatedAt: string;
+  meta: Record<string, unknown> | null;
+};
+type ReferenceQueryResponse = {
+  source: string;
+  direction: ReferenceDirection;
+  references: ReferenceRecord[];
+};
+type ReferenceAggregateGroupBy = "kind" | "targetType" | "sourceType" | "day";
+type ReferenceAggregateGroup = {
+  group: string;
+  references: number;
+  total: number;
+};
+type ReferenceAggregateResponse = {
+  space: string;
+  groupBy: ReferenceAggregateGroupBy;
+  groups: ReferenceAggregateGroup[];
+};
+//#endregion
 //#region src/websocket.d.ts
 type WebsocketEventPayload = ChannelEnvelope;
 type WebSocketLike = {
@@ -806,6 +2390,7 @@ type WebsocketClientEvents = {
     sessionId?: string | null;
     spaceId?: string | null;
     clientMessageId?: string | null;
+    billing?: BillingResponsePayload | null;
   };
   subscribed: {
     rooms: RealtimeRoom[];
@@ -909,4 +2494,4 @@ declare class WebsocketClient {
 }
 declare const createWebsocketClient: (options?: WebsocketClientOptions) => WebsocketClient;
 //#endregion
-export { ContentBlock as C, Usage as S, SessionForkRecord as _, WebsocketClientOptions as a, SessionTurnIndexItem as b, createWebsocketClient as c, RealtimePatchOperation as d, RealtimeServerEvent as f, SessionBindingRecord as g, MessageRecord as h, WebsocketClientEvents as i, ChannelEnvelope as l, SpacePublicEndpoints as m, WebSocketLike as n, WebsocketClientState as o, SessionTurnPatchEvent as p, WebsocketClient as r, WebsocketEventPayload as s, WebSocketConstructor as t, LabelAssignmentsUpdatedEvent as u, SessionRecord as v, SessionTurnRecord as x, SessionTurnSegmentRecord as y };
+export { CheckpointDiffSummary as $, SpaceFsUploadResponse as $n, RealtimeServerEvent as $r, ResourceLabelsResponse as $t, BillingProductDisplay as A, SpaceCreateResponse as An, GenerationModelPolicy as Ar, LabelListItem as At, CanvasDocumentRecord as B, SpaceFsFileResponse as Bn, normalizeGenerationPolicy as Br, PromptAccessMode as Bt, BillingCreditStatus as C, SpaceCommerceProduct as Cn, UserRulesResponse as Cr, JsonPrimitive as Ct, BillingPluginStatus as D, SpaceConfigInput as Dn, GenerationUsageBilling as Dr, LabelAssignmentRecord as Dt, BillingPaymentStatus as E, SpaceConfig as En, GenerationTaskResult as Er, LabelAssignmentPageInfo as Et, BillingSubscriptionHistoryList as F, SpaceFsCreateUploadInput as Fn, decodeGenerationPolicy as Fr, MeResponse as Ft, Channel as G, SpaceFsReadFilesResponse as Gn, ChannelHealth as Gr, ReferenceAggregateGroupBy as Gt, CanvasNodeRecord as H, SpaceFsPreparingFile as Hn, GenerationContentBlock as Hr, PromptTemplateCatalogResponse as Ht, BillingSubscriptionHistoryStatus as I, SpaceFsCreateUploadResponse as In, encodeGenerationPolicy as Ir, ModelCatalogEntry as It, CheckpointDiffFileResponse as J, SpaceFsUploadEntry as Jn, DiscordChannelConfig as Jr, ReferenceKind as Jt, CheckpointDiffDelivery as K, SpaceFsTreeResponse as Kn, ChannelHealthReasonCode as Kr, ReferenceAggregateResponse as Kt, BillingSubscriptionSummary as L, SpaceFsEncoding as Ln, filterGenerationDeclarationsByPolicy as Lr, PatchResourceLabelsInput as Lt, BillingProductPricing as M, SpaceEnvInput as Mn, GenerationPolicy as Mr, LabelResourceType as Mt, BillingRedemptionResult as N, SpaceFsCompleteUploadInput as Nn, GenerationPolicyError as Nr, LabelScopeType as Nt, BillingProductBillingInterval as O, SpaceConfigResponse as On, ListGenerationModelsResponse as Or, LabelItemsResponse as Ot, BillingResponsePayload as P, SpaceFsCompleteUploadResponse as Pn, assertGenerationRequestAllowedByPolicy as Pr, LabelSource as Pt, CheckpointDiffStatus as Q, SpaceFsUploadProgress as Qn, RealtimePatchOperation as Qr, ReferenceResourceType as Qt, CanvasBootstrapResponse as R, SpaceFsEntry as Rn, findGenerationModelPolicy as Rr, PatchResourceLabelsResponse as Rt, BillingCreditGrantStatus as S, SpaceCommerceOrder as Sn, UserProfile as Sr, JsonObject as St, BillingHistoryPagination as T, SpaceCommerceProductCreditBenefit as Tn, CreateGenerationTaskResponse as Tr, LabelAssignmentListItem as Tt, CanvasSemanticOp as U, SpaceFsReadFilesError as Un, GenerationResult as Ur, PublicUserProfile as Ut, CanvasNodeInput as V, SpaceFsMoveInput as Vn, parseGenerationPolicyFromEnv as Vr, PromptTemplateCatalogEntry as Vt, CanvasTransactionInput as W, SpaceFsReadFilesInput as Wn, ChannelConfig as Wr, ReferenceAggregateGroup as Wt, CheckpointDiffPatchLine as X, SpaceFsUploadPlanEntry as Xn, ChannelEnvelope as Xr, ReferenceQueryableType as Xt, CheckpointDiffPatchKind as Y, SpaceFsUploadError as Yn, FeishuChannelConfig as Yr, ReferenceQueryResponse as Yt, CheckpointDiffStats as Z, SpaceFsUploadPlanEntryInput as Zn, LabelAssignmentsUpdatedEvent as Zr, ReferenceRecord as Zt, BillingCatalogProduct as _, SpaceCheckpointDetailResponse as _n, SpaceUsageHourlyStat as _r, GenerationUsageSummary as _t, WebsocketClientOptions as a, SessionTurnIndexItem as ai, SessionMessagesResponse as an, SpaceModListItem as ar, CreateSpacePromptInput as at, BillingConversionIntent as b, SpaceCommerceCreditsBenefit as bn, TaskRunDetailResponse as br, GlobalSearchType as bt, createWebsocketClient as c, ContentBlock as ci, SessionTurnResponse as cn, SpacePresenceSnapshot as cr, CronJobPayload as ct, BatchUserProfilesResponse as d, SessionTurnWindowResponse as dn, SpaceRecord as dr, CursorPageInfo as dt, SessionTurnPatchEvent as ei, SandboxSpecId as en, SpaceFsWriteFileInput as er, CheckpointRecord as et, BillingBalanceActivity as f, SessionTurnsPaginatedResponse as fn, SpaceRole as fr, ExploreSection as ft, BillingCatalog as g, SpaceChannelBindingInput as gn, SpaceSessionsResponse as gr, GenerationUsageHourlyStat as gt, BillingBalanceActivityStatus as h, SpaceBootstrapSource as hn, SpaceSandboxProvider as hr, GenerationUsageBlock as ht, WebsocketClientEvents as i, SessionTurnSegmentRecord as ii, SessionMessagesPaginatedResponse as in, SpaceMeta as ir, CreateSpaceModInput as it, BillingProductKind as j, SpaceDefaultResponse as jn, GenerationParameterConstraint as jr, LabelRecord as jt, BillingProductCreditBenefit as k, SpaceConfigUpdateResponse as kn, PublicGenerationDeclaration as kr, LabelItemsSessionFork as kt, AcceptInvitationResponse as l, SessionTurnSignedUrlsResponse as ln, SpacePresenceUser as lr, CronJobRecord as lt, BillingBalanceActivityList as m, SpaceAccessPolicy as mn, SpaceSandboxConfig as mr, ExploreSpacesResponse as mt, WebSocketLike as n, MessageRecord as ni, SessionBindingRecord as nn, SpaceListItem as nr, CreateInvitationResponse as nt, WebsocketClientState as o, SessionTurnRecord as oi, SessionRecord as on, SpacePendingDiffFileResponse as or, CreateSpacePromptResponse as ot, BillingBalanceActivityKind as p, SpaceAccess as pn, SpaceSandboxAutoDestroyPolicy as pr, ExploreSpaceItem as pt, CheckpointDiffFile as q, SpaceFsUploadDestination as qn, ChannelRuntimeState as qr, ReferenceDirection as qt, WebsocketClient as r, SessionForkRecord as ri, SessionMessageResponse as rn, SpaceMember as rr, CreateSpaceInput as rt, WebsocketEventPayload as s, Usage as si, SessionTurnIndexResponse as sn, SpacePendingDiffSummary as sr, CreateSpaceSessionInput as st, WebSocketConstructor as t, SpacePublicEndpoints as ti, SendMessageCronJobPayload as tn, SpaceInvitation as tr, CreateInvitationInput as tt, ApiError as u, SessionTurnStreamSnapshotResponse as un, SpacePublicProfile as ur, CronJobUpdatePatch as ut, BillingCheckoutActionState as v, SpaceCommerceBenefit as vn, SpaceUsageResponse as vr, GlobalSearchResponse as vt, BillingCreditUnit as w, SpaceCommerceProductBenefitBinding as wn, CreateGenerationTaskRequest as wr, JsonValue as wt, BillingCreditExpiryGroup as x, SpaceCommerceFeatureBenefit as xn, TaskRunRecord as xr, InvitationDetail as xt, BillingCheckoutResult as y, SpaceCommerceBuyerProfile as yn, SpaceUsageSummary as yr, GlobalSearchResult as yt, CanvasCreateInput as z, SpaceFsFileKind as zn, getAllowedGenerationModelIds as zr, Permission as zt };