@spacefast/common 0.0.10 → 0.0.12

package/dist/contracts/channels.js

@@ -4,8 +4,7 @@ import { z } from "zod";
 // activity log. No writes, no new storage — promotion stays owned by the
 // publish/version lifecycle. Additive only.
 // One row of the channel list: where each named channel points right now.
-// `currentVersionId` is the live pointer (`channels.versionId`); weighted
-// pointers are not surfaced here yet (live-only at launch).
+// `currentVersionId` is the channel's version pointer (`channels.versionId`).
 export const channelListItemSchema = z.object({
     name: z.string().describe("Channel name; `live` is the default channel."),
     currentVersionId: z

package/dist/contracts/comments.d.ts

@@ -1,16 +1,16 @@
 import { z } from "zod";
-export declare const collaborationModeSchema: z.ZodEnum<{
-    review: "review";
-}>;
 export declare const commentThreadStatusSchema: z.ZodEnum<{
     open: "open";
     archived: "archived";
 }>;
+export declare const COMMENT_SEARCH_QUERY_MAX_LENGTH = 160;
+export declare function normalizeCommentSearchQuery(value: string | undefined): string | undefined;
 export declare const collaborationReviewerLevelSchema: z.ZodEnum<{
     viewer: "viewer";
     commenter: "commenter";
     editor: "editor";
 }>;
+export declare const COMMENT_PAGE_PATH_MAX_LENGTH = 2048;
 export declare const collaborationInvitedReviewerSchema: z.ZodObject<{
     email: z.ZodString;
     level: z.ZodEnum<{
@@ -22,6 +22,7 @@ export declare const collaborationInvitedReviewerSchema: z.ZodObject<{
 export declare const collaborationSettingsSchema: z.ZodObject<{
     anonymousReviewers: z.ZodOptional<z.ZodBoolean>;
     publishedAnonymousCommenters: z.ZodOptional<z.ZodBoolean>;
+    spamFilterEnabled: z.ZodOptional<z.ZodBoolean>;
     invitedReviewers: z.ZodOptional<z.ZodArray<z.ZodObject<{
         email: z.ZodString;
         level: z.ZodEnum<{
@@ -31,24 +32,21 @@ export declare const collaborationSettingsSchema: z.ZodObject<{
         }>;
     }, z.core.$strip>>>;
     publishedComments: z.ZodOptional<z.ZodBoolean>;
-    allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
     notificationPreferences: z.ZodOptional<z.ZodObject<{
         newThreads: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         newReplies: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         statusChanges: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     }, z.core.$strip>>;
-}, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strict>;
 export declare const collaborationSchema: z.ZodObject<{
     spaceId: z.ZodString;
     enabled: z.ZodBoolean;
-    mode: z.ZodEnum<{
-        review: "review";
-    }>;
     castResourceId: z.ZodNullable<z.ZodString>;
     castResourceKey: z.ZodNullable<z.ZodString>;
     settings: z.ZodObject<{
         anonymousReviewers: z.ZodOptional<z.ZodBoolean>;
         publishedAnonymousCommenters: z.ZodOptional<z.ZodBoolean>;
+        spamFilterEnabled: z.ZodOptional<z.ZodBoolean>;
         invitedReviewers: z.ZodOptional<z.ZodArray<z.ZodObject<{
             email: z.ZodString;
             level: z.ZodEnum<{
@@ -58,24 +56,21 @@ export declare const collaborationSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>>>;
         publishedComments: z.ZodOptional<z.ZodBoolean>;
-        allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
         notificationPreferences: z.ZodOptional<z.ZodObject<{
             newThreads: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             newReplies: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             statusChanges: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         }, z.core.$strip>>;
-    }, z.core.$catchall<z.ZodUnknown>>;
+    }, z.core.$strict>;
     createdAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export declare const collaborationUpdateSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
-    mode: z.ZodOptional<z.ZodEnum<{
-        review: "review";
-    }>>;
     settings: z.ZodOptional<z.ZodObject<{
         anonymousReviewers: z.ZodOptional<z.ZodBoolean>;
         publishedAnonymousCommenters: z.ZodOptional<z.ZodBoolean>;
+        spamFilterEnabled: z.ZodOptional<z.ZodBoolean>;
         invitedReviewers: z.ZodOptional<z.ZodArray<z.ZodObject<{
             email: z.ZodString;
             level: z.ZodEnum<{
@@ -85,17 +80,17 @@ export declare const collaborationUpdateSchema: z.ZodObject<{
             }>;
         }, z.core.$strip>>>;
         publishedComments: z.ZodOptional<z.ZodBoolean>;
-        allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
         notificationPreferences: z.ZodOptional<z.ZodObject<{
             newThreads: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             newReplies: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             statusChanges: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         }, z.core.$strip>>;
-    }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
 export declare const collaborationTokenRequestSchema: z.ZodObject<{
     versionId: z.ZodOptional<z.ZodString>;
     pagePath: z.ZodDefault<z.ZodString>;
+    anonymousId: z.ZodOptional<z.ZodString>;
     displayName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const collaborationTokenResponseSchema: z.ZodObject<{
@@ -103,7 +98,7 @@ export declare const collaborationTokenResponseSchema: z.ZodObject<{
     expiresAt: z.ZodString;
     cast: z.ZodObject<{
         resource: z.ZodString;
-        room: z.ZodNullable<z.ZodString>;
+        room: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const collaborationHandoffRequestSchema: z.ZodObject<{
@@ -131,7 +126,6 @@ export declare const realtimeTokenResponseSchema: z.ZodObject<{
     cast: z.ZodObject<{
         resource: z.ZodString;
         room: z.ZodString;
-        loaderUrl: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const noticePublishSchema: z.ZodObject<{
@@ -142,8 +136,8 @@ export declare const noticePublishSchema: z.ZodObject<{
     level: z.ZodDefault<z.ZodEnum<{
         info: "info";
         success: "success";
-        warning: "warning";
         error: "error";
+        warning: "warning";
     }>>;
     payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     durable: z.ZodDefault<z.ZodBoolean>;
@@ -167,6 +161,10 @@ export declare const collabOverlayConfigSchema: z.ZodObject<{
     version: z.ZodObject<{
         id: z.ZodNullable<z.ZodString>;
         current: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    space: z.ZodObject<{
+        live_url: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
     ws_url: z.ZodNullable<z.ZodString>;
     endpoints: z.ZodObject<{
@@ -181,10 +179,24 @@ export declare const collabOverlayConfigSchema: z.ZodObject<{
         notices: z.ZodBoolean;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const COLLAB_VERSION_URLS_MAX_IDS = 50;
+export declare const collabVersionUrlsQuerySchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    versionId: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    ids: z.ZodString;
+}, z.core.$strip>;
+export declare const collabVersionUrlSchema: z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodString;
+    number: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
 export declare const commentAuthorSchema: z.ZodObject<{
     kind: z.ZodNullable<z.ZodString>;
     id: z.ZodNullable<z.ZodString>;
     name: z.ZodNullable<z.ZodString>;
+    color: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export declare const commentTargetSchema: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 export declare const commentThreadSchema: z.ZodObject<{
@@ -199,6 +211,11 @@ export declare const commentThreadSchema: z.ZodObject<{
         open: "open";
         archived: "archived";
     }>;
+    moderationState: z.ZodEnum<{
+        spam: "spam";
+        clear: "clear";
+    }>;
+    heldCommentIds: z.ZodArray<z.ZodString>;
     unread: z.ZodBoolean;
     unreadCount: z.ZodNumber;
     body: z.ZodNullable<z.ZodString>;
@@ -206,6 +223,7 @@ export declare const commentThreadSchema: z.ZodObject<{
         kind: z.ZodNullable<z.ZodString>;
         id: z.ZodNullable<z.ZodString>;
         name: z.ZodNullable<z.ZodString>;
+        color: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     target: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     comments: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -220,8 +238,19 @@ export declare const commentListQuerySchema: z.ZodObject<{
         open: "open";
         archived: "archived";
     }>>;
+    filter: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        spam: "spam";
+        archived: "archived";
+    }>>;
     pagePath: z.ZodOptional<z.ZodString>;
+    q: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    unread: z.ZodOptional<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
 }, z.core.$strip>;
+export declare const commentSpamFeedbackSchema: z.ZodDefault<z.ZodObject<{
+    commentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
 export declare const commentCreateSchema: z.ZodObject<{
     pagePath: z.ZodDefault<z.ZodString>;
     body: z.ZodString;
@@ -232,8 +261,8 @@ export declare const commentScreenshotCreateSchema: z.ZodObject<{
     versionId: z.ZodString;
     pagePath: z.ZodDefault<z.ZodString>;
     contentType: z.ZodEnum<{
-        "image/png": "image/png";
         "image/jpeg": "image/jpeg";
+        "image/png": "image/png";
         "image/webp": "image/webp";
     }>;
     contentBase64: z.ZodString;
@@ -277,6 +306,11 @@ export declare const commentListResponseSchema: z.ZodObject<{
             open: "open";
             archived: "archived";
         }>;
+        moderationState: z.ZodEnum<{
+            spam: "spam";
+            clear: "clear";
+        }>;
+        heldCommentIds: z.ZodArray<z.ZodString>;
         unread: z.ZodBoolean;
         unreadCount: z.ZodNumber;
         body: z.ZodNullable<z.ZodString>;
@@ -284,6 +318,7 @@ export declare const commentListResponseSchema: z.ZodObject<{
             kind: z.ZodNullable<z.ZodString>;
             id: z.ZodNullable<z.ZodString>;
             name: z.ZodNullable<z.ZodString>;
+            color: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
         target: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         comments: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -306,4 +341,5 @@ export type CollaborationInvitedReviewer = z.infer<typeof collaborationInvitedRe
 export type Collaboration = z.infer<typeof collaborationSchema>;
 export type CollaborationUpdate = z.infer<typeof collaborationUpdateSchema>;
 export type CollabOverlayConfig = z.infer<typeof collabOverlayConfigSchema>;
+export type CollabVersionUrl = z.infer<typeof collabVersionUrlSchema>;
 export type CommentThread = z.infer<typeof commentThreadSchema>;

package/dist/contracts/comments.js

@@ -1,15 +1,19 @@
 import { z } from "zod";
 import { CursorPaginationSchema, cursorListQuerySchema } from "./common.js";
-export const collaborationModeSchema = z.enum(["review"]);
 export const commentThreadStatusSchema = z.enum(["open", "archived"]);
+export const COMMENT_SEARCH_QUERY_MAX_LENGTH = 160;
+export function normalizeCommentSearchQuery(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed.slice(0, COMMENT_SEARCH_QUERY_MAX_LENGTH) : undefined;
+}
 // The space access levels capability follows (SPACEFAST-CAST-PLAN D-2). Invited
 // reviewers are space invitees with one of these levels; the on-page overlay and
 // inbox re-evaluate the effective level server-side at join — this is only the
 // stored grant the dashboard manages.
 export const collaborationReviewerLevelSchema = z.enum(["viewer", "commenter", "editor"]);
-// An invited reviewer: a person (by email) granted a level on the space's review
-// surface. Kept in settingsJson so adding/removing reviewers never requires a
-// republish (read from the ETag'd overlay-config, SPACEFAST-CAST-PLAN §4.2).
+export const COMMENT_PAGE_PATH_MAX_LENGTH = 2_048;
+// An invited reviewer: request input projected into the access lane's canonical
+// `cast_reviewer` managed block. It is never mirrored into collaboration settings.
 export const collaborationInvitedReviewerSchema = z.object({
     email: z.string().email(),
     level: collaborationReviewerLevelSchema,
@@ -18,13 +22,13 @@ export const collaborationSettingsSchema = z
     .object({
     anonymousReviewers: z.boolean().optional(),
     publishedAnonymousCommenters: z.boolean().optional(),
+    spamFilterEnabled: z.boolean().optional(),
     invitedReviewers: z.array(collaborationInvitedReviewerSchema).optional(),
     // Whether comments are surfaced on the live/published host (vs preview-only).
     // The published loader (SPACEFAST-CAST-PLAN §4.2) mounts the orb on a live
     // host only when this is true; toggling it never requires a republish — the
     // always-injected inert tag reads behavior from the ETag'd overlay-config.
     publishedComments: z.boolean().optional(),
-    allowedOrigins: z.array(z.string().min(1)).optional(),
     notificationPreferences: z
         .object({
         newThreads: z.boolean().default(true),
@@ -34,11 +38,10 @@ export const collaborationSettingsSchema = z
         .partial()
         .optional(),
 })
-    .catchall(z.unknown());
+    .strict();
 export const collaborationSchema = z.object({
     spaceId: z.string(),
     enabled: z.boolean(),
-    mode: collaborationModeSchema,
     castResourceId: z.string().nullable(),
     castResourceKey: z.string().nullable(),
     settings: collaborationSettingsSchema,
@@ -47,12 +50,12 @@ export const collaborationSchema = z.object({
 });
 export const collaborationUpdateSchema = z.object({
     enabled: z.boolean(),
-    mode: collaborationModeSchema.optional(),
     settings: collaborationSettingsSchema.optional(),
 });
 export const collaborationTokenRequestSchema = z.object({
     versionId: z.string().min(1).optional(),
-    pagePath: z.string().min(1).default("/"),
+    pagePath: z.string().min(1).max(COMMENT_PAGE_PATH_MAX_LENGTH).default("/"),
+    anonymousId: z.string().min(1).max(160).optional(),
     displayName: z.string().min(1).max(120).optional(),
 });
 export const collaborationTokenResponseSchema = z.object({
@@ -60,12 +63,12 @@ export const collaborationTokenResponseSchema = z.object({
     expiresAt: z.string().datetime(),
     cast: z.object({
         resource: z.string(),
-        room: z.string().nullable(),
+        room: z.string(),
     }),
 });
 export const collaborationHandoffRequestSchema = z.object({
     versionId: z.string().min(1),
-    pagePath: z.string().min(1).default("/"),
+    pagePath: z.string().min(1).max(COMMENT_PAGE_PATH_MAX_LENGTH).default("/"),
 });
 export const collaborationHandoffResponseSchema = z.object({
     handoffToken: z.string(),
@@ -85,7 +88,6 @@ export const realtimeTokenResponseSchema = z.object({
     cast: z.object({
         resource: z.string(),
         room: z.string(),
-        loaderUrl: z.string().url(),
     }),
 });
 export const noticePublishSchema = z.object({
@@ -104,7 +106,7 @@ export const noticePublishResponseSchema = z.object({
     broadcast: z.record(z.string(), z.unknown()).nullable(),
 });
 export const collabOverlayConfigQuerySchema = z.object({
-    path: z.string().min(1).optional(),
+    path: z.string().min(1).max(COMMENT_PAGE_PATH_MAX_LENGTH).optional(),
     versionId: z.string().min(1).optional(),
     host: z.string().min(1).optional(),
 });
@@ -118,6 +120,13 @@ export const collabOverlayConfigSchema = z.object({
     version: z.object({
         id: z.string().nullable(),
         current: z.string().nullable(),
+        // The viewed version's immutable URL; null when unknown (live context).
+        url: z.string().nullable(),
+    }),
+    // The space's canonical live/published URL; null when comments-on-live is the
+    // current context (you're already there) or no live URL exists.
+    space: z.object({
+        live_url: z.string().nullable(),
     }),
     ws_url: z.string().nullable(),
     endpoints: z.object({
@@ -132,10 +141,29 @@ export const collabOverlayConfigSchema = z.object({
         notices: z.boolean(),
     }),
 });
+// Cross-version navigation directory (§5 "versions are native"): the SDK asks
+// for the immutable URLs of the version ids present in a room's threads so
+// "Open this comment on v12" is a real link. Gated exactly like the overlay
+// config — disabled comments never leak version URLs.
+export const COLLAB_VERSION_URLS_MAX_IDS = 50;
+export const collabVersionUrlsQuerySchema = collabOverlayConfigQuerySchema.extend({
+    // Comma-separated version ids; the route caps the lookup at
+    // COLLAB_VERSION_URLS_MAX_IDS ids.
+    ids: z.string().min(1).max(4_096),
+});
+export const collabVersionUrlSchema = z.object({
+    id: z.string(),
+    url: z.string(),
+    // number/createdAt let clients order versions by real recency instead of
+    // comparing opaque ids.
+    number: z.number().int().nullable(),
+    createdAt: z.string().nullable(),
+});
 export const commentAuthorSchema = z.object({
     kind: z.string().nullable(),
     id: z.string().nullable(),
     name: z.string().nullable(),
+    color: z.string().max(64).nullable(),
 });
 export const commentTargetSchema = z.record(z.string(), z.unknown()).nullable();
 export const commentThreadSchema = z.object({
@@ -144,9 +172,11 @@ export const commentThreadSchema = z.object({
     spaceId: z.string(),
     versionId: z.string().nullable(),
     channel: z.string().nullable(),
-    pagePath: z.string(),
+    pagePath: z.string().max(COMMENT_PAGE_PATH_MAX_LENGTH),
     url: z.string().nullable(),
     status: commentThreadStatusSchema,
+    moderationState: z.enum(["clear", "spam"]),
+    heldCommentIds: z.array(z.string()),
     unread: z.boolean(),
     unreadCount: z.number().int().min(0),
     body: z.string().nullable(),
@@ -159,17 +189,26 @@ export const commentThreadSchema = z.object({
 export const commentListQuerySchema = cursorListQuerySchema.extend({
     versionId: z.string().optional(),
     status: commentThreadStatusSchema.optional(),
-    pagePath: z.string().optional(),
+    filter: z.enum(["open", "archived", "spam"]).optional(),
+    pagePath: z.string().max(COMMENT_PAGE_PATH_MAX_LENGTH).optional(),
+    q: z.string().trim().max(COMMENT_SEARCH_QUERY_MAX_LENGTH).optional(),
+    author: z.string().trim().max(160).optional(),
+    unread: z.stringbool().optional(),
 });
+export const commentSpamFeedbackSchema = z
+    .object({
+    commentId: z.string().min(1).optional(),
+})
+    .default({});
 export const commentCreateSchema = z.object({
-    pagePath: z.string().min(1).default("/"),
+    pagePath: z.string().min(1).max(COMMENT_PAGE_PATH_MAX_LENGTH).default("/"),
     body: z.string().min(1).max(16_000),
     target: commentTargetSchema.optional(),
     idempotencyKey: z.string().min(1).max(320).optional(),
 });
 export const commentScreenshotCreateSchema = z.object({
     versionId: z.string().min(1),
-    pagePath: z.string().min(1).default("/"),
+    pagePath: z.string().min(1).max(COMMENT_PAGE_PATH_MAX_LENGTH).default("/"),
     contentType: z.enum(["image/png", "image/jpeg", "image/webp"]),
     contentBase64: z.string().min(1),
 });

package/dist/contracts/common.d.ts

@@ -9,8 +9,8 @@ export declare const baseDiagnosticSchema: z.ZodObject<{
     code: z.ZodString;
     severity: z.ZodEnum<{
         info: "info";
-        warning: "warning";
         error: "error";
+        warning: "warning";
     }>;
     message: z.ZodString;
     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -131,6 +131,7 @@ export declare const CursorPaginationSchema: z.ZodObject<{
     nextCursor: z.ZodNullable<z.ZodString>;
     hasMore: z.ZodBoolean;
 }, z.core.$strip>;
+export declare const CURSOR_MAX_LENGTH = 4096;
 export declare const cursorListQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     cursor: z.ZodOptional<z.ZodString>;
@@ -175,8 +176,8 @@ export declare const AsyncOperationSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -219,8 +220,8 @@ export declare function mutationEnvelope<T extends z.ZodType>(data: T): z.ZodObj
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/contracts/common.js

@@ -117,6 +117,7 @@ export const CursorPaginationSchema = z.object({
         .describe("Opaque cursor for the next page; pass as `?cursor=`. Null on the last page."),
     hasMore: z.boolean().describe("Whether another page exists after this one."),
 });
+export const CURSOR_MAX_LENGTH = 4_096;
 // The ONE list query shape (default 20, max 100, opaque cursor, newest-first). Extend with
 // module-specific filters; never redeclare `limit`/`cursor`.
 export const cursorListQuerySchema = z.object({
@@ -130,6 +131,7 @@ export const cursorListQuerySchema = z.object({
     cursor: z
         .string()
         .min(1)
+        .max(CURSOR_MAX_LENGTH)
         .optional()
         .describe("Opaque cursor from a previous page's `pagination.nextCursor`."),
 });

package/dist/contracts/deployments.d.ts

@@ -217,8 +217,8 @@ export declare const DeploymentSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -381,8 +381,8 @@ export declare const deploymentListResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -546,8 +546,8 @@ export declare const deploymentGetResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/contracts/device-auth.d.ts

@@ -75,15 +75,19 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
                     deny: "deny";
                 }>;
                 actions: z.ZodArray<z.ZodEnum<{
+                    "teams:read": "teams:read";
+                    "teams:create": "teams:create";
+                    "spaces:read": "spaces:read";
+                    "spaces:write": "spaces:write";
+                    "domains:read": "domains:read";
+                    "mcp:tools": "mcp:tools";
                     "*": "*";
                     "sites:read": "sites:read";
                     "sites:create": "sites:create";
                     "sites:write": "sites:write";
                     "sites:delete": "sites:delete";
                     "sites:policy.write": "sites:policy.write";
-                    "spaces:read": "spaces:read";
                     "spaces:create": "spaces:create";
-                    "spaces:write": "spaces:write";
                     "spaces:delete": "spaces:delete";
                     "spaces:publish": "spaces:publish";
                     "spaces:transfer": "spaces:transfer";
@@ -93,7 +97,6 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
                     "versions:promote": "versions:promote";
                     "versions:delete": "versions:delete";
                     "versions:download": "versions:download";
-                    "domains:read": "domains:read";
                     "domains:create": "domains:create";
                     "domains:verify": "domains:verify";
                     "domains:assign": "domains:assign";
@@ -106,7 +109,6 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
                     "webhooks:write": "webhooks:write";
                     "builds:read": "builds:read";
                     "builds:create": "builds:create";
-                    "teams:read": "teams:read";
                     "teams:write": "teams:write";
                     "teams:members.write": "teams:members.write";
                     "billing:read": "billing:read";
@@ -114,7 +116,6 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
                     "tokens:read": "tokens:read";
                     "tokens:create": "tokens:create";
                     "tokens:revoke": "tokens:revoke";
-                    "mcp:tools": "mcp:tools";
                     "runtime:manage": "runtime:manage";
                 }>>;
                 resources: z.ZodArray<z.ZodString>;
@@ -122,8 +123,8 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
                     "request.client": z.ZodOptional<z.ZodEnum<{
                         api: "api";
                         dashboard: "dashboard";
-                        cli: "cli";
                         worker: "worker";
+                        cli: "cli";
                     }>>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
@@ -267,15 +268,19 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
                     deny: "deny";
                 }>;
                 actions: z.ZodArray<z.ZodEnum<{
+                    "teams:read": "teams:read";
+                    "teams:create": "teams:create";
+                    "spaces:read": "spaces:read";
+                    "spaces:write": "spaces:write";
+                    "domains:read": "domains:read";
+                    "mcp:tools": "mcp:tools";
                     "*": "*";
                     "sites:read": "sites:read";
                     "sites:create": "sites:create";
                     "sites:write": "sites:write";
                     "sites:delete": "sites:delete";
                     "sites:policy.write": "sites:policy.write";
-                    "spaces:read": "spaces:read";
                     "spaces:create": "spaces:create";
-                    "spaces:write": "spaces:write";
                     "spaces:delete": "spaces:delete";
                     "spaces:publish": "spaces:publish";
                     "spaces:transfer": "spaces:transfer";
@@ -285,7 +290,6 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
                     "versions:promote": "versions:promote";
                     "versions:delete": "versions:delete";
                     "versions:download": "versions:download";
-                    "domains:read": "domains:read";
                     "domains:create": "domains:create";
                     "domains:verify": "domains:verify";
                     "domains:assign": "domains:assign";
@@ -298,7 +302,6 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
                     "webhooks:write": "webhooks:write";
                     "builds:read": "builds:read";
                     "builds:create": "builds:create";
-                    "teams:read": "teams:read";
                     "teams:write": "teams:write";
                     "teams:members.write": "teams:members.write";
                     "billing:read": "billing:read";
@@ -306,7 +309,6 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
                     "tokens:read": "tokens:read";
                     "tokens:create": "tokens:create";
                     "tokens:revoke": "tokens:revoke";
-                    "mcp:tools": "mcp:tools";
                     "runtime:manage": "runtime:manage";
                 }>>;
                 resources: z.ZodArray<z.ZodString>;
@@ -314,8 +316,8 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
                     "request.client": z.ZodOptional<z.ZodEnum<{
                         api: "api";
                         dashboard: "dashboard";
-                        cli: "cli";
                         worker: "worker";
+                        cli: "cli";
                     }>>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;

package/dist/contracts/docs.d.ts

@@ -11,8 +11,8 @@ export declare const docsIndexQuerySchema: z.ZodObject<{
     category: z.ZodOptional<z.ZodEnum<{
         api: "api";
         guide: "guide";
-        cli: "cli";
         error: "error";
+        cli: "cli";
         recipe: "recipe";
         workflow: "workflow";
     }>>;
@@ -30,8 +30,8 @@ export declare const DocsEntrySchema: z.ZodObject<{
     category: z.ZodEnum<{
         api: "api";
         guide: "guide";
-        cli: "cli";
         error: "error";
+        cli: "cli";
         recipe: "recipe";
         workflow: "workflow";
     }>;
@@ -56,8 +56,8 @@ export declare const DocsDocSchema: z.ZodObject<{
     category: z.ZodEnum<{
         api: "api";
         guide: "guide";
-        cli: "cli";
         error: "error";
+        cli: "cli";
         recipe: "recipe";
         workflow: "workflow";
     }>;
@@ -86,8 +86,8 @@ export declare const DocsIndexResponseSchema: z.ZodObject<{
     category: z.ZodNullable<z.ZodEnum<{
         api: "api";
         guide: "guide";
-        cli: "cli";
         error: "error";
+        cli: "cli";
         recipe: "recipe";
         workflow: "workflow";
     }>>;
@@ -99,8 +99,8 @@ export declare const DocsIndexResponseSchema: z.ZodObject<{
         category: z.ZodEnum<{
             api: "api";
             guide: "guide";
-            cli: "cli";
             error: "error";
+            cli: "cli";
             recipe: "recipe";
             workflow: "workflow";
         }>;