@spacefast/common 0.0.11 → 0.0.13

package/dist/contracts/comments.js

@@ -1,30 +1,96 @@
 import { z } from "zod";
+import { accessRoleSchema } from "./access.js";
 import { CursorPaginationSchema, cursorListQuerySchema } from "./common.js";
-export const collaborationModeSchema = z.enum(["review"]);
 export const commentThreadStatusSchema = z.enum(["open", "archived"]);
-// 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 collaborationInvitedReviewerSchema = z.object({
-    email: z.string().email(),
-    level: collaborationReviewerLevelSchema,
+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;
+}
+export const COMMENT_PAGE_PATH_MAX_LENGTH = 2_048;
+const COMMENT_CAPABILITIES = ["page.view", "comments.read", "comments.write"];
+export const commentCapabilitiesSchema = z
+    .array(z.enum(COMMENT_CAPABILITIES))
+    .min(2)
+    .max(3)
+    .refine((capabilities) => new Set(capabilities).size === capabilities.length, {
+    message: "comment capabilities must be unique",
+})
+    .superRefine((capabilities, context) => {
+    if (capabilities.includes("comments.write") && !capabilities.includes("comments.read")) {
+        context.addIssue({
+            code: "custom",
+            message: "comments.write requires comments.read",
+        });
+    }
+    if (capabilities.includes("comments.read") && !capabilities.includes("page.view")) {
+        context.addIssue({
+            code: "custom",
+            message: "comments.read requires page.view",
+        });
+    }
+});
+export const collaborationGuestProjectionSchema = z.object({
+    anonymousId: z.string().min(8).max(160),
+    name: z.string().trim().min(1).max(160),
+    namedByUser: z.boolean(),
+    grantId: z.string().min(1).max(128),
+    admittedBy: z.union([
+        z.literal("anyone"),
+        z.templateLiteral(["link:", z.string().regex(/^[A-Za-z0-9_.-]+$/)]),
+        z.templateLiteral(["password:", z.string().regex(/^[A-Za-z0-9_.-]+$/)]),
+    ]),
+    emailVerified: z.boolean().default(false),
+    capabilities: commentCapabilitiesSchema,
+});
+export const collaborationTicketClaimsSchema = z
+    .object({
+    sub: z.string().min(1),
+    email: z.string().email().optional(),
+    role: accessRoleSchema,
+    actorKind: z.enum(["user", "guest"]),
+    capabilities: commentCapabilitiesSchema,
+    anonymousId: z.string().min(8).max(160).optional(),
+    namedByUser: z.boolean().optional(),
+    admittedBy: z
+        .union([
+        z.literal("anyone"),
+        z.templateLiteral(["link:", z.string().regex(/^[A-Za-z0-9_.-]+$/)]),
+        z.templateLiteral(["password:", z.string().regex(/^[A-Za-z0-9_.-]+$/)]),
+    ])
+        .optional(),
+    emailVerified: z.boolean().optional(),
+    room: z.string().min(1).max(4_096),
+    scope: z.string().min(1).max(COMMENT_PAGE_PATH_MAX_LENGTH),
+    surface: z.enum(["published", "preview"]),
+    nonce: z.string().min(1).max(160),
+    iat: z.number().int(),
+    nbf: z.number().int(),
+    exp: z.number().int(),
+    iss: z.literal("spacefast-api"),
+    aud: z.string().min(1),
+})
+    .superRefine((claims, context) => {
+    if (claims.actorKind !== "guest")
+        return;
+    for (const field of ["anonymousId", "namedByUser", "admittedBy", "emailVerified"]) {
+        if (claims[field] === undefined) {
+            context.addIssue({
+                code: "custom",
+                path: [field],
+                message: `${field} is required for a guest ticket`,
+            });
+        }
+    }
 });
 export const collaborationSettingsSchema = z
     .object({
-    anonymousReviewers: z.boolean().optional(),
-    publishedAnonymousCommenters: z.boolean().optional(),
-    invitedReviewers: z.array(collaborationInvitedReviewerSchema).optional(),
+    spamFilterEnabled: z.boolean().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 +100,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,34 +112,22 @@ export const collaborationSchema = z.object({
 });
 export const collaborationUpdateSchema = z.object({
     enabled: z.boolean(),
-    mode: collaborationModeSchema.optional(),
     settings: collaborationSettingsSchema.optional(),
 });
-export const collaborationTokenRequestSchema = z.object({
+export const commentsTicketRequestSchema = z.object({
+    spaceId: z.string().min(1),
+    pagePath: z.string().min(1).max(COMMENT_PAGE_PATH_MAX_LENGTH).default("/"),
+    origin: z.string().url(),
     versionId: z.string().min(1).optional(),
-    pagePath: z.string().min(1).default("/"),
-    displayName: z.string().min(1).max(120).optional(),
 });
-export const collaborationTokenResponseSchema = z.object({
+export const commentsTicketResponseSchema = z.object({
     token: z.string(),
     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("/"),
-});
-export const collaborationHandoffResponseSchema = z.object({
-    handoffToken: z.string(),
-    expiresAt: z.string().datetime(),
-    url: z.string().url().nullable(),
-});
-export const collaborationHandoffExchangeSchema = z.object({
-    handoffToken: z.string().min(16),
-});
 export const realtimeTokenRequestSchema = z.object({
     versionId: z.string().optional(),
     scope: z.enum(["space", "version"]).default("space"),
@@ -85,7 +138,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,38 +156,33 @@ 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(),
 });
-// Snake case is intentional: the injected Collab SDK consumes this alongside
-// Cast's snake-case join payload without a remapping layer.
+// Customer pages receive launcher state only. Room ids, Cast endpoints, resource
+// keys, tickets, and platform session state never cross the customer-origin
+// boundary.
 export const collabOverlayConfigSchema = z.object({
     enabled: z.boolean(),
-    anonymous_commenters: z.boolean(),
-    resource_key: z.string().nullable(),
-    room_key: z.string().nullable(),
-    version: z.object({
-        id: z.string().nullable(),
-        current: z.string().nullable(),
-    }),
-    ws_url: z.string().nullable(),
-    endpoints: z.object({
-        token: z.string().url(),
-        handoff_exchange: z.string().url(),
-        auth_bridge: z.string().url(),
-        screenshots: z.string().url(),
-    }),
-    features: z.object({
-        drawing: z.boolean(),
-        capture: z.boolean(),
-        notices: z.boolean(),
-    }),
+    surface_url: z.string().url().nullable(),
+});
+// Cross-version navigation directory: the platform Comments page asks for the
+// immutable URLs of version ids present in a room's threads.
+export const COLLAB_VERSION_URLS_MAX_IDS = 50;
+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 +191,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 +208,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/countries.js

@@ -1,10 +1,5 @@
-// ISO 3166-1 alpha-2 country codes — the vocabulary of the firewall card's
-// country section (contracts/access.ts `firewallCountriesSchema`, access-plan
-// §5.6). The rule `match.country` is an exact-equality matcher against the
-// edge-supplied country header, so "allow only these countries" compiles to
-// one deny/challenge rule per code in the COMPLEMENT of this list — which is
-// why the list itself is a contract: the compiler and the projection must
-// agree on the universe.
+// ISO 3166-1 alpha-2 country codes used by Grant network constraints. The
+// runtime compares them with the edge-supplied country header.
 //
 // Officially assigned codes only (no exceptionally-reserved / user-assigned
 // ranges). Display names are a UI concern (`Intl.DisplayNames`), never stored.

package/dist/contracts/data-source-routes.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const dataSourceListItemSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"wordpress">;
+    url: z.ZodString;
+    name: z.ZodString;
+    default: z.ZodBoolean;
+}, z.core.$strict>;
+export type DataSourceListItem = z.infer<typeof dataSourceListItemSchema>;
+export declare const dataSourceListResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        dataSources: z.ZodArray<z.ZodObject<{
+            kind: z.ZodLiteral<"wordpress">;
+            url: z.ZodString;
+            name: z.ZodString;
+            default: z.ZodBoolean;
+        }, z.core.$strict>>;
+        defaultDataSource: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DataSourceListResponse = z.infer<typeof dataSourceListResponseSchema>;

package/dist/contracts/data-source-routes.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { dataEnvelope } from "./common.js";
+import { dataSourceNameSchema, wordpressDataSourceSchema } from "./space-config.js";
+export const dataSourceListItemSchema = wordpressDataSourceSchema
+    .extend({
+    name: dataSourceNameSchema,
+    default: z.boolean().describe("True for the effective default source."),
+})
+    .strict();
+export const dataSourceListResponseSchema = dataEnvelope(z.object({
+    dataSources: z.array(dataSourceListItemSchema),
+    defaultDataSource: dataSourceNameSchema
+        .nullable()
+        .describe("Configured default source, or the first source in bytewise name order; null when no sources are configured."),
+}));

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,20 @@ 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";
+                    "spaces:rename": "spaces:rename";
+                    "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 +98,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";
@@ -105,8 +109,8 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
                     "webhooks:read": "webhooks:read";
                     "webhooks:write": "webhooks:write";
                     "builds:read": "builds:read";
+                    "builds:trigger": "builds:trigger";
                     "builds:create": "builds:create";
-                    "teams:read": "teams:read";
                     "teams:write": "teams:write";
                     "teams:members.write": "teams:members.write";
                     "billing:read": "billing:read";
@@ -114,7 +118,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 +125,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 +270,20 @@ 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";
+                    "spaces:rename": "spaces:rename";
+                    "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 +293,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";
@@ -297,8 +304,8 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
                     "webhooks:read": "webhooks:read";
                     "webhooks:write": "webhooks:write";
                     "builds:read": "builds:read";
+                    "builds:trigger": "builds:trigger";
                     "builds:create": "builds:create";
-                    "teams:read": "teams:read";
                     "teams:write": "teams:write";
                     "teams:members.write": "teams:members.write";
                     "billing:read": "billing:read";
@@ -306,7 +313,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 +320,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>>;
@@ -351,8 +357,8 @@ export declare const AgentHandoffListQuerySchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AgentHandoffListQuery = z.infer<typeof AgentHandoffListQuerySchema>;
 export declare const AgentHandoffStatusSchema: z.ZodEnum<{
-    pending: "pending";
     revoked: "revoked";
+    pending: "pending";
     redeemed: "redeemed";
 }>;
 export declare const AgentHandoffSummarySchema: z.ZodObject<{
@@ -366,8 +372,8 @@ export declare const AgentHandoffSummarySchema: z.ZodObject<{
         codex: "codex";
     }>;
     status: z.ZodEnum<{
-        pending: "pending";
         revoked: "revoked";
+        pending: "pending";
         redeemed: "redeemed";
     }>;
     createdAt: z.ZodString;
@@ -387,8 +393,8 @@ export declare const AgentHandoffListResponseSchema: z.ZodArray<z.ZodObject<{
         codex: "codex";
     }>;
     status: z.ZodEnum<{
-        pending: "pending";
         revoked: "revoked";
+        pending: "pending";
         redeemed: "redeemed";
     }>;
     createdAt: z.ZodString;

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";
         }>;