@anuragpal02/zcl-contracts 0.31.0 → 0.33.0

package/dist/assets.d.ts

@@ -1,6 +1,27 @@
 import { z } from 'zod';
+/**
+ * ⚠️ WIDENING THIS ENUM IS A READER BREAK, NOT AN ADDITIVE CHANGE.
+ *
+ * `z.enum` REJECTS an unrecognised value — it does not strip it the way an object
+ * schema strips an unknown key. zcl-api parses its OWN outbound asset responses
+ * through `assetSchema`, so the moment a row with a new kind exists, every asset-list
+ * response containing it throws — on the API side, and on every client still pinned
+ * to the older contracts version.
+ *
+ * So any new member must be published and picked up by every reader BEFORE a row
+ * carrying it can be written. For `logo` that order was:
+ *   1. publish these contracts
+ *   2. bump + deploy zcl-web-next  (so it can READ a logo row)
+ *   3. bump + deploy zcl-api       (so it can EMIT one)
+ *   4. only then widen `media_assets_kind_check` and open the upload path
+ * Steps 2 and 3 are not interchangeable.
+ *
+ * (A caret on a 0.x range pins the MINOR, so `^0.31.0` never picks up 0.32.0 —
+ * both consumers need their range moved by hand.)
+ */
 export declare const assetKindSchema: z.ZodEnum<{
     reference: "reference";
+    logo: "logo";
     raw_image: "raw_image";
     display_image: "display_image";
     final_image: "final_image";
@@ -15,9 +36,25 @@ export declare const assetStatusSchema: z.ZodEnum<{
     pending_upload: "pending_upload";
     available: "available";
 }>;
+/**
+ * The kinds a USER may upload. Every other member of `assetKindSchema` is produced by
+ * the pipeline and must never be settable from a request body.
+ *
+ * `logo` joins `reference` here for the Guidelines tab. A logo is reference-only —
+ * it is stored, associated with a guideline set and displayed, and is NEVER composed
+ * into any prompt.
+ */
 export declare const uploadableAssetKindSchema: z.ZodEnum<{
     reference: "reference";
+    logo: "logo";
 }>;
+/**
+ * UNCHANGED by the logo work, deliberately. PNG carries an alpha channel, so a
+ * transparent logo needs no new content type at all. SVG is out of v1: it is not an
+ * inert image format (it can carry `<script>`, event handlers and external refs), so
+ * accepting it is a security decision with sanitisation work attached, not a
+ * content-type decision.
+ */
 export declare const assetContentTypeSchema: z.ZodEnum<{
     "image/png": "image/png";
     "image/jpeg": "image/jpeg";
@@ -31,6 +68,7 @@ export declare const assetSchema: z.ZodObject<{
     createdByUserId: z.ZodString;
     kind: z.ZodEnum<{
         reference: "reference";
+        logo: "logo";
         raw_image: "raw_image";
         display_image: "display_image";
         final_image: "final_image";
@@ -61,6 +99,7 @@ export declare const assetSchema: z.ZodObject<{
 export declare const createAssetUploadRequestSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         reference: "reference";
+        logo: "logo";
     }>;
     filename: z.ZodString;
     contentType: z.ZodEnum<{
@@ -85,6 +124,7 @@ export declare const createAssetUploadResponseSchema: z.ZodObject<{
         createdByUserId: z.ZodString;
         kind: z.ZodEnum<{
             reference: "reference";
+            logo: "logo";
             raw_image: "raw_image";
             display_image: "display_image";
             final_image: "final_image";
@@ -131,6 +171,7 @@ export declare const listAssetsResponseSchema: z.ZodObject<{
         createdByUserId: z.ZodString;
         kind: z.ZodEnum<{
             reference: "reference";
+            logo: "logo";
             raw_image: "raw_image";
             display_image: "display_image";
             final_image: "final_image";
@@ -187,6 +228,7 @@ export declare const listWorkspaceAssetsResponseSchema: z.ZodObject<{
         createdByUserId: z.ZodString;
         kind: z.ZodEnum<{
             reference: "reference";
+            logo: "logo";
             raw_image: "raw_image";
             display_image: "display_image";
             final_image: "final_image";
@@ -221,6 +263,8 @@ export declare const listWorkspaceAssetsResponseSchema: z.ZodObject<{
 export type Asset = z.infer<typeof assetSchema>;
 export type AssetKind = z.infer<typeof assetKindSchema>;
 export type AssetStatus = z.infer<typeof assetStatusSchema>;
+/** The kinds a user may upload — currently `reference` and `logo`. */
+export type UploadableAssetKind = z.infer<typeof uploadableAssetKindSchema>;
 export type AssetUpload = z.infer<typeof assetUploadSchema>;
 export type CreateAssetUploadRequest = z.infer<typeof createAssetUploadRequestSchema>;
 export type CreateAssetUploadResponse = z.infer<typeof createAssetUploadResponseSchema>;

package/dist/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,eAAe;;;;;;;;;EAS1B,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;EAA+D,CAAA;AAC7F,eAAO,MAAM,yBAAyB;;EAAwB,CAAA;AAC9D,eAAO,MAAM,sBAAsB;;;;;EAAiE,CAAA;AAEpG,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBtB,CAAA;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;iBAKzC,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG1C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;iBAO3C,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEnC,CAAA;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;iBAIzC,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK5C,CAAA;AAEF,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAC/C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC3D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC3D,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AACrF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AACzF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AACrF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAC3F,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAA"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;EAU1B,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;EAA+D,CAAA;AAE7F;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;;;EAAgC,CAAA;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;EAAiE,CAAA;AAEpG,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBtB,CAAA;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;iBAKzC,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG1C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;iBAO3C,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEnC,CAAA;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;iBAIzC,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK5C,CAAA;AAEF,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAC/C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC3D,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC3D,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AACrF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AACzF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AACrF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAC3F,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAA"}

package/dist/assets.js

@@ -1,7 +1,28 @@
 import { z } from 'zod';
 import { idSchema, isoDateSchema } from './common.js';
+/**
+ * ⚠️ WIDENING THIS ENUM IS A READER BREAK, NOT AN ADDITIVE CHANGE.
+ *
+ * `z.enum` REJECTS an unrecognised value — it does not strip it the way an object
+ * schema strips an unknown key. zcl-api parses its OWN outbound asset responses
+ * through `assetSchema`, so the moment a row with a new kind exists, every asset-list
+ * response containing it throws — on the API side, and on every client still pinned
+ * to the older contracts version.
+ *
+ * So any new member must be published and picked up by every reader BEFORE a row
+ * carrying it can be written. For `logo` that order was:
+ *   1. publish these contracts
+ *   2. bump + deploy zcl-web-next  (so it can READ a logo row)
+ *   3. bump + deploy zcl-api       (so it can EMIT one)
+ *   4. only then widen `media_assets_kind_check` and open the upload path
+ * Steps 2 and 3 are not interchangeable.
+ *
+ * (A caret on a 0.x range pins the MINOR, so `^0.31.0` never picks up 0.32.0 —
+ * both consumers need their range moved by hand.)
+ */
 export const assetKindSchema = z.enum([
     'reference',
+    'logo',
     'raw_image',
     'display_image',
     'final_image',
@@ -11,7 +32,22 @@ export const assetKindSchema = z.enum([
     'export'
 ]);
 export const assetStatusSchema = z.enum(['pending_upload', 'available', 'failed', 'deleted']);
-export const uploadableAssetKindSchema = z.enum(['reference']);
+/**
+ * The kinds a USER may upload. Every other member of `assetKindSchema` is produced by
+ * the pipeline and must never be settable from a request body.
+ *
+ * `logo` joins `reference` here for the Guidelines tab. A logo is reference-only —
+ * it is stored, associated with a guideline set and displayed, and is NEVER composed
+ * into any prompt.
+ */
+export const uploadableAssetKindSchema = z.enum(['reference', 'logo']);
+/**
+ * UNCHANGED by the logo work, deliberately. PNG carries an alpha channel, so a
+ * transparent logo needs no new content type at all. SVG is out of v1: it is not an
+ * inert image format (it can carry `<script>`, event handlers and external refs), so
+ * accepting it is a security decision with sanitisation work attached, not a
+ * content-type decision.
+ */
 export const assetContentTypeSchema = z.enum(['image/png', 'image/jpeg', 'image/webp', 'video/mp4']);
 export const assetSchema = z.object({
     id: idSchema,

package/dist/client.d.ts

@@ -5,9 +5,11 @@ import { type CreditBalanceResponse } from './credits.js';
 import { workspaceMemberSchema, type CreateWorkspaceRequest, type InviteMemberRequest, type InviteMemberResponse, type ListMembersResponse, type UpdateMemberRoleRequest, type UpdateWorkspaceRequest, type Workspace, type WorkspaceMembership } from './workspaces.js';
 import { type Asset, type AssetUpload, type CreateAssetUploadRequest, type CreateAssetUploadResponse, type FinalizeAssetUploadRequest, type ListAssetsResponse, type ListWorkspaceAssetsResponse, type WorkspaceAssetFilter } from './assets.js';
 import { projectRunListResponseSchema, projectRunResponseSchema, type CreateLedMapRequest, type CreateProjectRequest, type CreateProjectRunRequest, type LedMapListResponse, type LedMapResponse, type LedMapUpdateResponse, type LedMapUsageResponse, type ListLedMapsQuery, type ListProjectRunsQuery, type ListProjectsQuery, type Project, type UpdateLedMapMetadataRequest, type UpdateLedMapRequest, type UpdateProjectRequest, type UpdateProjectRunRequest } from './projects.js';
+import { guidelineSetListResponseSchema, guidelineSetResponseSchema, type AttachGuidelineSetLogoRequest, type CreateGuidelineSetRequest, type GuidelineSetLogoListResponse, type GuidelineSetLogoResponse, type UpdateGuidelineSetRequest } from './guidelines.js';
 import { type CreateGenerationJobRequest, type CreatePanelSetRequest, type CreatePanelSetResponse, type CreateSmartVideoRequest, type CreateSmartVideoResponse, type CreateVideoLoopRequest, type CreateVideoUpscaleRequest, type EditGenerationJobRequest, type GenerationJobResponse, type GenerationJobStatus, type GenerationJobType, type ListGenerationJobsResponse } from './generation.js';
 import { type DescribeImageRequest, type DescribeImageResponse } from './assistant.js';
 import { type CreateLoopToolJobRequest, type CreateLoopToolSourceUploadRequest, type CreateLoopToolSourceUploadResponse, type FinalizeLoopToolSourceUploadRequest, type FinalizeLoopToolSourceUploadResponse, type LoopToolJobResponse } from './loop-tools.js';
+import { type CreateFrameBatchRequest, type DeleteFrameResponse, type FrameBatch, type FrameReferenceUpload, type FrameVariant, type ListFramesQuery, type ListFramesResponse } from './frame-iterator.js';
 import { type AdminAdjustCreditsRequest, type AdminAdjustCreditsResponse, type AdminJobDetailResponse, type AdminJobStatus, type AdminMeResponse, type AdminUsageResponse, type AdminUserDetailResponse, type AdminWorkspaceDetailResponse, type ListAdminAuditResponse, type ListAdminJobsResponse, type ListAdminUsersResponse, type ListAdminWorkspacesResponse, type SetPlatformAdminRequest, type SetPlatformAdminResponse, type SetUserDisabledRequest, type SetUserDisabledResponse, type StepUpStartResponse, type StepUpVerifyResponse } from './admin.js';
 type FetchLike = (request: Request) => Promise<Response>;
 export type ZclApiClientOptions = {
@@ -99,6 +101,26 @@ export declare function createZclApiClient(options: ZclApiClientOptions): {
         create(workspaceId: string, projectId: string, input: CreateProjectRunRequest): Promise<z.infer<typeof projectRunResponseSchema>>;
         update(workspaceId: string, projectId: string, runId: string, input: UpdateProjectRunRequest): Promise<z.infer<typeof projectRunResponseSchema>>;
     };
+    /**
+     * Guideline sets. Project-nested on purpose — there is deliberately NO bare
+     * `/guideline-sets/:id` upstream, because the (workspace, project) pair in the path
+     * is what the server authorizes against AND re-filters the row on. A top-level route
+     * would have only the set id to go on.
+     *
+     * There is no `remove`: v1 has no DELETE for a set (a set referenced by creations has
+     * nowhere safe to go). `detachLogo` below deletes an ASSOCIATION row, never an asset.
+     */
+    guidelineSets: {
+        list(workspaceId: string, projectId: string): Promise<z.infer<typeof guidelineSetListResponseSchema>>;
+        get(workspaceId: string, projectId: string, setId: string): Promise<z.infer<typeof guidelineSetResponseSchema>>;
+        create(workspaceId: string, projectId: string, input: CreateGuidelineSetRequest): Promise<z.infer<typeof guidelineSetResponseSchema>>;
+        update(workspaceId: string, projectId: string, setId: string, input: UpdateGuidelineSetRequest): Promise<z.infer<typeof guidelineSetResponseSchema>>;
+        listLogos(workspaceId: string, projectId: string, setId: string): Promise<GuidelineSetLogoListResponse>;
+        attachLogo(workspaceId: string, projectId: string, setId: string, input: AttachGuidelineSetLogoRequest): Promise<GuidelineSetLogoResponse>;
+        detachLogo(workspaceId: string, projectId: string, setId: string, assetId: string): Promise<{
+            data: Record<string, never>;
+        }>;
+    };
     assets: {
         createUpload(workspaceId: string, projectId: string, input: CreateAssetUploadRequest): Promise<CreateAssetUploadResponse>;
         uploadObject(upload: AssetUpload, body: BodyInit): Promise<void>;
@@ -118,6 +140,14 @@ export declare function createZclApiClient(options: ZclApiClientOptions): {
         getJob(workspaceId: string, jobId: string): Promise<LoopToolJobResponse>;
         contentUrl(workspaceId: string, assetId: string): string;
     };
+    frameIterator: {
+        uploadReference(workspaceId: string, file: Blob, filename: string): Promise<FrameReferenceUpload>;
+        createBatch(workspaceId: string, input: CreateFrameBatchRequest, idempotencyKey: string): Promise<FrameBatch>;
+        getBatch(workspaceId: string, batchId: string): Promise<FrameBatch>;
+        listFrames(workspaceId: string, options?: ListFramesQuery): Promise<ListFramesResponse>;
+        download(workspaceId: string, iterationId: string, variant: FrameVariant): Promise<Response>;
+        delete(workspaceId: string, iterationId: string): Promise<DeleteFrameResponse>;
+    };
     credits: {
         get(workspaceId: string): Promise<CreditBalanceResponse>;
     };

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -5,9 +5,11 @@ import { creditBalanceResponseSchema } from './credits.js';
 import { createWorkspaceRequestSchema, inviteMemberRequestSchema, inviteMemberResponseSchema, listMembersResponseSchema, updateMemberRoleRequestSchema, updateWorkspaceRequestSchema, workspaceMemberSchema, workspaceMembershipSchema, workspaceResponseSchema, workspaceSchema } from './workspaces.js';
 import { assetSchema, createAssetUploadRequestSchema, createAssetUploadResponseSchema, finalizeAssetUploadRequestSchema, listAssetsResponseSchema, listWorkspaceAssetsResponseSchema } from './assets.js';
 import { createLedMapRequestSchema, createProjectRequestSchema, createProjectRunRequestSchema, ledMapListResponseSchema, ledMapResponseSchema, ledMapUpdateResponseSchema, ledMapUsageResponseSchema, projectRunListResponseSchema, projectRunResponseSchema, projectSchema, updateLedMapMetadataRequestSchema, updateLedMapRequestSchema, updateProjectRequestSchema, updateProjectRunRequestSchema } from './projects.js';
+import { attachGuidelineSetLogoRequestSchema, createGuidelineSetRequestSchema, guidelineSetListResponseSchema, guidelineSetLogoListResponseSchema, guidelineSetLogoResponseSchema, guidelineSetResponseSchema, updateGuidelineSetRequestSchema } from './guidelines.js';
 import { createGenerationJobRequestSchema, createPanelSetRequestSchema, createPanelSetResponseSchema, createSmartVideoRequestSchema, createSmartVideoResponseSchema, createVideoLoopRequestSchema, createVideoUpscaleRequestSchema, editGenerationJobRequestSchema, generationJobResponseSchema, listGenerationJobsResponseSchema } from './generation.js';
 import { describeImageRequestSchema, describeImageResponseSchema } from './assistant.js';
 import { createLoopToolJobRequestSchema, createLoopToolSourceUploadRequestSchema, createLoopToolSourceUploadResponseSchema, finalizeLoopToolSourceUploadRequestSchema, finalizeLoopToolSourceUploadResponseSchema, loopToolJobResponseSchema } from './loop-tools.js';
+import { createFrameBatchRequestSchema, deleteFrameResponseSchema, frameBatchSchema, frameReferenceUploadSchema, frameVariantSchema, listFramesQuerySchema, listFramesResponseSchema } from './frame-iterator.js';
 import { adminAdjustCreditsRequestSchema, adminAdjustCreditsResponseSchema, adminJobDetailResponseSchema, adminMeResponseSchema, adminUsageResponseSchema, adminUserDetailResponseSchema, adminWorkspaceDetailResponseSchema, listAdminAuditResponseSchema, listAdminJobsResponseSchema, listAdminUsersResponseSchema, listAdminWorkspacesResponseSchema, setPlatformAdminRequestSchema, setPlatformAdminResponseSchema, setUserDisabledRequestSchema, setUserDisabledResponseSchema, stepUpStartResponseSchema, stepUpVerifyRequestSchema, stepUpVerifyResponseSchema } from './admin.js';
 const workspaceListResponseSchema = listResponseSchema(workspaceSchema.extend({
     membership: workspaceMembershipSchema
@@ -79,6 +81,41 @@ export function createZclApiClient(options) {
         }
         return parseResponse(schema, responseBody, response.status);
     }
+    async function requestFormData(path, schema, formData, init = {}) {
+        const headers = new Headers(init.headers);
+        const method = (init.method ?? 'POST').toUpperCase();
+        if (method !== 'GET' && method !== 'HEAD') {
+            headers.set('x-zcl-csrf', '1');
+        }
+        const response = await fetcher(new Request(joinUrl(options.baseUrl, path), {
+            ...init,
+            method,
+            headers,
+            body: formData,
+            credentials: 'include'
+        }));
+        const responseBody = await readJson(response);
+        if (!response.ok) {
+            const error = errorResponseSchema.safeParse(responseBody);
+            if (error.success) {
+                throw new ZclApiError(error.data.error.code, error.data.error.message, response.status, error.data.error.requestId);
+            }
+            throw new ZclApiError('internal_error', 'API request failed', response.status);
+        }
+        return parseResponse(schema, responseBody, response.status);
+    }
+    async function requestDownload(path) {
+        const response = await fetcher(new Request(joinUrl(options.baseUrl, path), { credentials: 'include' }));
+        if (response.ok) {
+            return response;
+        }
+        const responseBody = await readJson(response);
+        const error = errorResponseSchema.safeParse(responseBody);
+        if (error.success) {
+            throw new ZclApiError(error.data.error.code, error.data.error.message, response.status, error.data.error.requestId);
+        }
+        throw new ZclApiError('internal_error', 'API request failed', response.status);
+    }
     return {
         auth: {
             signup(input) {
@@ -294,6 +331,44 @@ export function createZclApiClient(options) {
                 });
             }
         },
+        /**
+         * Guideline sets. Project-nested on purpose — there is deliberately NO bare
+         * `/guideline-sets/:id` upstream, because the (workspace, project) pair in the path
+         * is what the server authorizes against AND re-filters the row on. A top-level route
+         * would have only the set id to go on.
+         *
+         * There is no `remove`: v1 has no DELETE for a set (a set referenced by creations has
+         * nowhere safe to go). `detachLogo` below deletes an ASSOCIATION row, never an asset.
+         */
+        guidelineSets: {
+            list(workspaceId, projectId) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/guideline-sets`, guidelineSetListResponseSchema);
+            },
+            get(workspaceId, projectId, setId) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/guideline-sets/${setId}`, guidelineSetResponseSchema);
+            },
+            create(workspaceId, projectId, input) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/guideline-sets`, guidelineSetResponseSchema, { method: 'POST', body: createGuidelineSetRequestSchema.parse(input) });
+            },
+            // `expectedRevision` is a real compare-and-set in the UPDATE's own WHERE clause
+            // upstream, and a lost race comes back as a 409. Parsing the body here is what makes
+            // a no-op patch fail locally instead of costing a round-trip and a revision bump.
+            update(workspaceId, projectId, setId, input) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/guideline-sets/${setId}`, guidelineSetResponseSchema, { method: 'PATCH', body: updateGuidelineSetRequestSchema.parse(input) });
+            },
+            // ── Logos: reference-only. Nothing here reaches the image model. ──
+            listLogos(workspaceId, projectId, setId) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/guideline-sets/${setId}/logos`, guidelineSetLogoListResponseSchema);
+            },
+            attachLogo(workspaceId, projectId, setId, input) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/guideline-sets/${setId}/logos`, guidelineSetLogoResponseSchema, { method: 'POST', body: attachGuidelineSetLogoRequestSchema.parse(input) });
+            },
+            // Deletes the ASSOCIATION, not the asset. The asset keeps its own lifecycle so a
+            // logo shared by two sets cannot be destroyed by detaching it from one of them.
+            detachLogo(workspaceId, projectId, setId, assetId) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/guideline-sets/${setId}/logos/${assetId}`, z.object({ data: z.object({}) }), { method: 'DELETE' });
+            }
+        },
         assets: {
             createUpload(workspaceId, projectId, input) {
                 return request(`/workspaces/${workspaceId}/projects/${projectId}/assets/uploads`, createAssetUploadResponseSchema, {
@@ -363,6 +438,43 @@ export function createZclApiClient(options) {
                 return joinUrl(options.baseUrl, `/workspaces/${workspaceId}/tools/loop/assets/${assetId}/content`);
             }
         },
+        frameIterator: {
+            uploadReference(workspaceId, file, filename) {
+                const formData = new FormData();
+                formData.append('file', file, filename);
+                return requestFormData(`/workspaces/${workspaceId}/tools/frame-iterator/references`, frameReferenceUploadSchema, formData, { method: 'POST' });
+            },
+            createBatch(workspaceId, input, idempotencyKey) {
+                return request(`/workspaces/${workspaceId}/tools/frame-iterator/batches`, frameBatchSchema, {
+                    method: 'POST',
+                    headers: { 'idempotency-key': idempotencyKey },
+                    body: createFrameBatchRequestSchema.parse(input)
+                });
+            },
+            getBatch(workspaceId, batchId) {
+                return request(`/workspaces/${workspaceId}/tools/frame-iterator/batches/${batchId}`, frameBatchSchema);
+            },
+            listFrames(workspaceId, options = {}) {
+                const queryOptions = listFramesQuerySchema.parse(options);
+                const params = new URLSearchParams();
+                if (queryOptions.limit !== undefined) {
+                    params.set('limit', String(queryOptions.limit));
+                }
+                if (queryOptions.cursor !== undefined) {
+                    params.set('cursor', queryOptions.cursor);
+                }
+                const query = params.toString() ? `?${params.toString()}` : '';
+                return request(`/workspaces/${workspaceId}/tools/frame-iterator/frames${query}`, listFramesResponseSchema);
+            },
+            download(workspaceId, iterationId, variant) {
+                return requestDownload(`/workspaces/${workspaceId}/tools/frame-iterator/frames/${iterationId}/${frameVariantSchema.parse(variant)}`);
+            },
+            delete(workspaceId, iterationId) {
+                return request(`/workspaces/${workspaceId}/tools/frame-iterator/frames/${iterationId}`, deleteFrameResponseSchema, {
+                    method: 'DELETE'
+                });
+            }
+        },
         credits: {
             get(workspaceId) {
                 return request(`/workspaces/${workspaceId}/credits`, creditBalanceResponseSchema);

package/dist/frame-iterator.d.ts

@@ -0,0 +1,421 @@
+import { z } from 'zod';
+export declare const frameMaterialSchema: z.ZodEnum<{
+    custom: "custom";
+    metal: "metal";
+    wood: "wood";
+    neon: "neon";
+    marble: "marble";
+    glass: "glass";
+    fabric: "fabric";
+    organic: "organic";
+}>;
+export declare const frameThicknessSchema: z.ZodEnum<{
+    medium: "medium";
+    thin: "thin";
+    thick: "thick";
+}>;
+export declare const frameShapeSchema: z.ZodEnum<{
+    custom: "custom";
+    organic: "organic";
+    rectangle: "rectangle";
+    rounded: "rounded";
+}>;
+export declare const frameVariantSchema: z.ZodEnum<{
+    green: "green";
+    transparent: "transparent";
+}>;
+export declare const frameIterationStatusSchema: z.ZodEnum<{
+    deleted: "deleted";
+    queued: "queued";
+    running: "running";
+    succeeded: "succeeded";
+    failed: "failed";
+    retry_wait: "retry_wait";
+    deleting: "deleting";
+}>;
+export declare const frameIterationPhaseSchema: z.ZodEnum<{
+    dispatching: "dispatching";
+    generating: "generating";
+    normalizing: "normalizing";
+    deriving_transparency: "deriving_transparency";
+    storing: "storing";
+    finalizing: "finalizing";
+}>;
+export declare const frameFailureCodeSchema: z.ZodEnum<{
+    REFERENCE_INVALID: "REFERENCE_INVALID";
+    REFERENCE_TOO_LARGE: "REFERENCE_TOO_LARGE";
+    REFERENCE_EXPIRED: "REFERENCE_EXPIRED";
+    CHROMA_COLOR_CONFLICT: "CHROMA_COLOR_CONFLICT";
+    INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS";
+    CONTENT_BLOCKED: "CONTENT_BLOCKED";
+    PROVIDER_RETRYING: "PROVIDER_RETRYING";
+    PROVIDER_UNAVAILABLE: "PROVIDER_UNAVAILABLE";
+    PROVIDER_OUTPUT_INVALID: "PROVIDER_OUTPUT_INVALID";
+    OPENING_INVALID: "OPENING_INVALID";
+    OUTPUT_STORAGE_FAILED: "OUTPUT_STORAGE_FAILED";
+    INTERNAL_FAILED: "INTERNAL_FAILED";
+}>;
+/** Whether a #RRGGBB frame colour would conflict with the removable green opening. */
+export declare function isChromaConflictingColor(hex: string): boolean;
+export declare const frameSettingsSchema: z.ZodObject<{
+    color: z.ZodString;
+    material: z.ZodEnum<{
+        custom: "custom";
+        metal: "metal";
+        wood: "wood";
+        neon: "neon";
+        marble: "marble";
+        glass: "glass";
+        fabric: "fabric";
+        organic: "organic";
+    }>;
+    customMaterial: z.ZodOptional<z.ZodString>;
+    thickness: z.ZodEnum<{
+        medium: "medium";
+        thin: "thin";
+        thick: "thick";
+    }>;
+    shape: z.ZodEnum<{
+        custom: "custom";
+        organic: "organic";
+        rectangle: "rectangle";
+        rounded: "rounded";
+    }>;
+    customShape: z.ZodOptional<z.ZodString>;
+    additionalDirection: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const createFrameBatchRequestSchema: z.ZodObject<{
+    referenceUploadId: z.ZodString;
+    iterationCount: z.ZodNumber;
+    settings: z.ZodObject<{
+        color: z.ZodString;
+        material: z.ZodEnum<{
+            custom: "custom";
+            metal: "metal";
+            wood: "wood";
+            neon: "neon";
+            marble: "marble";
+            glass: "glass";
+            fabric: "fabric";
+            organic: "organic";
+        }>;
+        customMaterial: z.ZodOptional<z.ZodString>;
+        thickness: z.ZodEnum<{
+            medium: "medium";
+            thin: "thin";
+            thick: "thick";
+        }>;
+        shape: z.ZodEnum<{
+            custom: "custom";
+            organic: "organic";
+            rectangle: "rectangle";
+            rounded: "rounded";
+        }>;
+        customShape: z.ZodOptional<z.ZodString>;
+        additionalDirection: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const frameReferenceUploadSchema: z.ZodObject<{
+    uploadId: z.ZodString;
+    expiresAt: z.ZodString;
+    original: z.ZodObject<{
+        mimeType: z.ZodEnum<{
+            "image/png": "image/png";
+            "image/jpeg": "image/jpeg";
+            "image/webp": "image/webp";
+        }>;
+        byteSize: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const frameIterationSchema: z.ZodObject<{
+    id: z.ZodString;
+    batchId: z.ZodString;
+    iterationIndex: z.ZodNumber;
+    status: z.ZodEnum<{
+        deleted: "deleted";
+        queued: "queued";
+        running: "running";
+        succeeded: "succeeded";
+        failed: "failed";
+        retry_wait: "retry_wait";
+        deleting: "deleting";
+    }>;
+    phase: z.ZodEnum<{
+        dispatching: "dispatching";
+        generating: "generating";
+        normalizing: "normalizing";
+        deriving_transparency: "deriving_transparency";
+        storing: "storing";
+        finalizing: "finalizing";
+    }>;
+    attemptCount: z.ZodNumber;
+    failureCode: z.ZodNullable<z.ZodEnum<{
+        REFERENCE_INVALID: "REFERENCE_INVALID";
+        REFERENCE_TOO_LARGE: "REFERENCE_TOO_LARGE";
+        REFERENCE_EXPIRED: "REFERENCE_EXPIRED";
+        CHROMA_COLOR_CONFLICT: "CHROMA_COLOR_CONFLICT";
+        INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS";
+        CONTENT_BLOCKED: "CONTENT_BLOCKED";
+        PROVIDER_RETRYING: "PROVIDER_RETRYING";
+        PROVIDER_UNAVAILABLE: "PROVIDER_UNAVAILABLE";
+        PROVIDER_OUTPUT_INVALID: "PROVIDER_OUTPUT_INVALID";
+        OPENING_INVALID: "OPENING_INVALID";
+        OUTPUT_STORAGE_FAILED: "OUTPUT_STORAGE_FAILED";
+        INTERNAL_FAILED: "INTERNAL_FAILED";
+    }>>;
+    settings: z.ZodObject<{
+        color: z.ZodString;
+        material: z.ZodEnum<{
+            custom: "custom";
+            metal: "metal";
+            wood: "wood";
+            neon: "neon";
+            marble: "marble";
+            glass: "glass";
+            fabric: "fabric";
+            organic: "organic";
+        }>;
+        customMaterial: z.ZodOptional<z.ZodString>;
+        thickness: z.ZodEnum<{
+            medium: "medium";
+            thin: "thin";
+            thick: "thick";
+        }>;
+        shape: z.ZodEnum<{
+            custom: "custom";
+            organic: "organic";
+            rectangle: "rectangle";
+            rounded: "rounded";
+        }>;
+        customShape: z.ZodOptional<z.ZodString>;
+        additionalDirection: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    width: z.ZodNullable<z.ZodNumber>;
+    height: z.ZodNullable<z.ZodNumber>;
+    startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    downloads: z.ZodObject<{
+        green: z.ZodBoolean;
+        transparent: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const frameBatchSchema: z.ZodObject<{
+    id: z.ZodString;
+    requestedCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    iterations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        batchId: z.ZodString;
+        iterationIndex: z.ZodNumber;
+        status: z.ZodEnum<{
+            deleted: "deleted";
+            queued: "queued";
+            running: "running";
+            succeeded: "succeeded";
+            failed: "failed";
+            retry_wait: "retry_wait";
+            deleting: "deleting";
+        }>;
+        phase: z.ZodEnum<{
+            dispatching: "dispatching";
+            generating: "generating";
+            normalizing: "normalizing";
+            deriving_transparency: "deriving_transparency";
+            storing: "storing";
+            finalizing: "finalizing";
+        }>;
+        attemptCount: z.ZodNumber;
+        failureCode: z.ZodNullable<z.ZodEnum<{
+            REFERENCE_INVALID: "REFERENCE_INVALID";
+            REFERENCE_TOO_LARGE: "REFERENCE_TOO_LARGE";
+            REFERENCE_EXPIRED: "REFERENCE_EXPIRED";
+            CHROMA_COLOR_CONFLICT: "CHROMA_COLOR_CONFLICT";
+            INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS";
+            CONTENT_BLOCKED: "CONTENT_BLOCKED";
+            PROVIDER_RETRYING: "PROVIDER_RETRYING";
+            PROVIDER_UNAVAILABLE: "PROVIDER_UNAVAILABLE";
+            PROVIDER_OUTPUT_INVALID: "PROVIDER_OUTPUT_INVALID";
+            OPENING_INVALID: "OPENING_INVALID";
+            OUTPUT_STORAGE_FAILED: "OUTPUT_STORAGE_FAILED";
+            INTERNAL_FAILED: "INTERNAL_FAILED";
+        }>>;
+        settings: z.ZodObject<{
+            color: z.ZodString;
+            material: z.ZodEnum<{
+                custom: "custom";
+                metal: "metal";
+                wood: "wood";
+                neon: "neon";
+                marble: "marble";
+                glass: "glass";
+                fabric: "fabric";
+                organic: "organic";
+            }>;
+            customMaterial: z.ZodOptional<z.ZodString>;
+            thickness: z.ZodEnum<{
+                medium: "medium";
+                thin: "thin";
+                thick: "thick";
+            }>;
+            shape: z.ZodEnum<{
+                custom: "custom";
+                organic: "organic";
+                rectangle: "rectangle";
+                rounded: "rounded";
+            }>;
+            customShape: z.ZodOptional<z.ZodString>;
+            additionalDirection: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+        startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        downloads: z.ZodObject<{
+            green: z.ZodBoolean;
+            transparent: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const savedFrameSchema: z.ZodObject<{
+    id: z.ZodString;
+    batchId: z.ZodString;
+    iterationIndex: z.ZodNumber;
+    phase: z.ZodEnum<{
+        dispatching: "dispatching";
+        generating: "generating";
+        normalizing: "normalizing";
+        deriving_transparency: "deriving_transparency";
+        storing: "storing";
+        finalizing: "finalizing";
+    }>;
+    attemptCount: z.ZodNumber;
+    settings: z.ZodObject<{
+        color: z.ZodString;
+        material: z.ZodEnum<{
+            custom: "custom";
+            metal: "metal";
+            wood: "wood";
+            neon: "neon";
+            marble: "marble";
+            glass: "glass";
+            fabric: "fabric";
+            organic: "organic";
+        }>;
+        customMaterial: z.ZodOptional<z.ZodString>;
+        thickness: z.ZodEnum<{
+            medium: "medium";
+            thin: "thin";
+            thick: "thick";
+        }>;
+        shape: z.ZodEnum<{
+            custom: "custom";
+            organic: "organic";
+            rectangle: "rectangle";
+            rounded: "rounded";
+        }>;
+        customShape: z.ZodOptional<z.ZodString>;
+        additionalDirection: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    status: z.ZodLiteral<"succeeded">;
+    failureCode: z.ZodNull;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    downloads: z.ZodObject<{
+        green: z.ZodLiteral<true>;
+        transparent: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const listFramesResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        batchId: z.ZodString;
+        iterationIndex: z.ZodNumber;
+        phase: z.ZodEnum<{
+            dispatching: "dispatching";
+            generating: "generating";
+            normalizing: "normalizing";
+            deriving_transparency: "deriving_transparency";
+            storing: "storing";
+            finalizing: "finalizing";
+        }>;
+        attemptCount: z.ZodNumber;
+        settings: z.ZodObject<{
+            color: z.ZodString;
+            material: z.ZodEnum<{
+                custom: "custom";
+                metal: "metal";
+                wood: "wood";
+                neon: "neon";
+                marble: "marble";
+                glass: "glass";
+                fabric: "fabric";
+                organic: "organic";
+            }>;
+            customMaterial: z.ZodOptional<z.ZodString>;
+            thickness: z.ZodEnum<{
+                medium: "medium";
+                thin: "thin";
+                thick: "thick";
+            }>;
+            shape: z.ZodEnum<{
+                custom: "custom";
+                organic: "organic";
+                rectangle: "rectangle";
+                rounded: "rounded";
+            }>;
+            customShape: z.ZodOptional<z.ZodString>;
+            additionalDirection: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        status: z.ZodLiteral<"succeeded">;
+        failureCode: z.ZodNull;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        downloads: z.ZodObject<{
+            green: z.ZodLiteral<true>;
+            transparent: z.ZodLiteral<true>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const listFramesQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export declare const deleteFrameResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        deleted: "deleted";
+        deleting: "deleting";
+    }>;
+}, z.core.$strict>;
+export type FrameMaterial = z.infer<typeof frameMaterialSchema>;
+export type FrameThickness = z.infer<typeof frameThicknessSchema>;
+export type FrameShape = z.infer<typeof frameShapeSchema>;
+export type FrameVariant = z.infer<typeof frameVariantSchema>;
+export type FrameIterationStatus = z.infer<typeof frameIterationStatusSchema>;
+export type FrameIterationPhase = z.infer<typeof frameIterationPhaseSchema>;
+export type FrameFailureCode = z.infer<typeof frameFailureCodeSchema>;
+export type FrameSettings = z.infer<typeof frameSettingsSchema>;
+export type CreateFrameBatchRequest = z.infer<typeof createFrameBatchRequestSchema>;
+export type FrameReferenceUpload = z.infer<typeof frameReferenceUploadSchema>;
+export type FrameIteration = z.infer<typeof frameIterationSchema>;
+export type FrameBatch = z.infer<typeof frameBatchSchema>;
+export type SavedFrame = z.infer<typeof savedFrameSchema>;
+export type ListFramesResponse = z.infer<typeof listFramesResponseSchema>;
+export type ListFramesQuery = z.infer<typeof listFramesQuerySchema>;
+export type DeleteFrameResponse = z.infer<typeof deleteFrameResponseSchema>;
+//# sourceMappingURL=frame-iterator.d.ts.map

package/dist/frame-iterator.d.ts.map

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

package/dist/frame-iterator.js

@@ -0,0 +1,223 @@
+import { z } from 'zod';
+import { idSchema, isoDateSchema } from './common.js';
+export const frameMaterialSchema = z.enum(['metal', 'wood', 'neon', 'marble', 'glass', 'fabric', 'organic', 'custom']);
+export const frameThicknessSchema = z.enum(['thin', 'medium', 'thick']);
+export const frameShapeSchema = z.enum(['rectangle', 'rounded', 'organic', 'custom']);
+export const frameVariantSchema = z.enum(['green', 'transparent']);
+export const frameIterationStatusSchema = z.enum([
+    'queued',
+    'running',
+    'retry_wait',
+    'succeeded',
+    'failed',
+    'deleting',
+    'deleted'
+]);
+export const frameIterationPhaseSchema = z.enum([
+    'dispatching',
+    'generating',
+    'normalizing',
+    'deriving_transparency',
+    'storing',
+    'finalizing'
+]);
+export const frameFailureCodeSchema = z.enum([
+    'REFERENCE_INVALID',
+    'REFERENCE_TOO_LARGE',
+    'REFERENCE_EXPIRED',
+    'CHROMA_COLOR_CONFLICT',
+    'INSUFFICIENT_CREDITS',
+    'CONTENT_BLOCKED',
+    'PROVIDER_RETRYING',
+    'PROVIDER_UNAVAILABLE',
+    'PROVIDER_OUTPUT_INVALID',
+    'OPENING_INVALID',
+    'OUTPUT_STORAGE_FAILED',
+    'INTERNAL_FAILED'
+]);
+const hexColorSchema = z.string().regex(/^#[0-9A-Fa-f]{6}$/);
+const customDirectionSchema = z.string().trim().min(1).max(120);
+const additionalDirectionSchema = z.string().trim().min(1).max(1000);
+/** Whether a #RRGGBB frame colour would conflict with the removable green opening. */
+export function isChromaConflictingColor(hex) {
+    if (!/^#[0-9A-Fa-f]{6}$/.test(hex)) {
+        return false;
+    }
+    const red = Number.parseInt(hex.slice(1, 3), 16);
+    const green = Number.parseInt(hex.slice(3, 5), 16);
+    const blue = Number.parseInt(hex.slice(5, 7), 16);
+    return green >= 160 && green - red >= 60 && green - blue >= 60;
+}
+export const frameSettingsSchema = z
+    .object({
+    color: hexColorSchema,
+    material: frameMaterialSchema,
+    customMaterial: customDirectionSchema.optional(),
+    thickness: frameThicknessSchema,
+    shape: frameShapeSchema,
+    customShape: customDirectionSchema.optional(),
+    additionalDirection: additionalDirectionSchema.optional()
+})
+    .strict()
+    .superRefine((value, context) => {
+    if (isChromaConflictingColor(value.color)) {
+        context.addIssue({
+            code: 'custom',
+            path: ['color'],
+            message: 'Bright chroma green is reserved for the removable opening'
+        });
+    }
+    if (value.material === 'custom' && value.customMaterial === undefined) {
+        context.addIssue({
+            code: 'custom',
+            path: ['customMaterial'],
+            message: 'Custom material is required when material is custom'
+        });
+    }
+    if (value.material !== 'custom' && value.customMaterial !== undefined) {
+        context.addIssue({
+            code: 'custom',
+            path: ['customMaterial'],
+            message: 'Custom material is only allowed when material is custom'
+        });
+    }
+    if (value.shape === 'custom' && value.customShape === undefined) {
+        context.addIssue({
+            code: 'custom',
+            path: ['customShape'],
+            message: 'Custom shape is required when shape is custom'
+        });
+    }
+    if (value.shape !== 'custom' && value.customShape !== undefined) {
+        context.addIssue({
+            code: 'custom',
+            path: ['customShape'],
+            message: 'Custom shape is only allowed when shape is custom'
+        });
+    }
+});
+export const createFrameBatchRequestSchema = z
+    .object({
+    referenceUploadId: idSchema,
+    iterationCount: z.number().int().min(1).max(4),
+    settings: frameSettingsSchema
+})
+    .strict();
+export const frameReferenceUploadSchema = z
+    .object({
+    uploadId: idSchema,
+    expiresAt: isoDateSchema,
+    original: z
+        .object({
+        mimeType: z.enum(['image/png', 'image/jpeg', 'image/webp']),
+        byteSize: z.number().int().positive(),
+        width: z.number().int().positive(),
+        height: z.number().int().positive()
+    })
+        .strict()
+})
+    .strict();
+const frameDownloadsSchema = z.object({ green: z.boolean(), transparent: z.boolean() }).strict();
+export const frameIterationSchema = z
+    .object({
+    id: idSchema,
+    batchId: idSchema,
+    iterationIndex: z.number().int().min(0).max(3),
+    status: frameIterationStatusSchema,
+    phase: frameIterationPhaseSchema,
+    attemptCount: z.number().int().nonnegative(),
+    failureCode: frameFailureCodeSchema.nullable(),
+    settings: frameSettingsSchema,
+    width: z.number().int().positive().nullable(),
+    height: z.number().int().positive().nullable(),
+    startedAt: isoDateSchema.nullable().optional(),
+    completedAt: isoDateSchema.nullable().optional(),
+    createdAt: isoDateSchema,
+    updatedAt: isoDateSchema,
+    downloads: frameDownloadsSchema
+})
+    .strict()
+    .superRefine((value, context) => {
+    const downloadsAvailable = value.downloads.green || value.downloads.transparent;
+    const hasDimensions = value.width !== null || value.height !== null;
+    if (value.status === 'failed') {
+        if (value.failureCode === null) {
+            context.addIssue({ code: 'custom', path: ['failureCode'], message: 'Failed iterations require a failure code' });
+        }
+        if (hasDimensions) {
+            context.addIssue({ code: 'custom', path: ['width'], message: 'Failed iterations do not expose output dimensions' });
+        }
+        if (downloadsAvailable) {
+            context.addIssue({ code: 'custom', path: ['downloads'], message: 'Failed iterations are not downloadable' });
+        }
+        return;
+    }
+    if (value.status === 'succeeded') {
+        if (value.failureCode !== null) {
+            context.addIssue({ code: 'custom', path: ['failureCode'], message: 'Succeeded iterations do not have a failure code' });
+        }
+        if (value.width === null || value.height === null) {
+            context.addIssue({ code: 'custom', path: ['width'], message: 'Succeeded iterations require output dimensions' });
+        }
+        if (!value.downloads.green || !value.downloads.transparent) {
+            context.addIssue({ code: 'custom', path: ['downloads'], message: 'Succeeded iterations require both downloads' });
+        }
+        return;
+    }
+    if (value.status === 'deleting' || value.status === 'deleted') {
+        if (value.failureCode !== null) {
+            context.addIssue({ code: 'custom', path: ['failureCode'], message: 'Deleted iterations do not have a failure code' });
+        }
+        if (value.width === null || value.height === null) {
+            context.addIssue({ code: 'custom', path: ['width'], message: 'Deleted iterations retain decoded dimensions' });
+        }
+        if (downloadsAvailable) {
+            context.addIssue({ code: 'custom', path: ['downloads'], message: 'Deleted iterations are not downloadable' });
+        }
+        return;
+    }
+    if (value.failureCode !== null) {
+        context.addIssue({ code: 'custom', path: ['failureCode'], message: 'Non-terminal iterations do not have a failure code' });
+    }
+    if (hasDimensions) {
+        context.addIssue({ code: 'custom', path: ['width'], message: 'Non-terminal iterations do not expose output dimensions' });
+    }
+    if (downloadsAvailable) {
+        context.addIssue({ code: 'custom', path: ['downloads'], message: 'Non-terminal iterations are not downloadable' });
+    }
+});
+export const frameBatchSchema = z
+    .object({
+    id: idSchema,
+    requestedCount: z.number().int().min(1).max(4),
+    createdAt: isoDateSchema,
+    iterations: z.array(frameIterationSchema).min(1).max(4)
+})
+    .strict();
+export const savedFrameSchema = frameIterationSchema
+    .safeExtend({
+    status: z.literal('succeeded'),
+    failureCode: z.null(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    downloads: z.object({ green: z.literal(true), transparent: z.literal(true) }).strict()
+})
+    .strict();
+export const listFramesResponseSchema = z
+    .object({
+    items: z.array(savedFrameSchema),
+    nextCursor: z.string().min(1).nullable()
+})
+    .strict();
+export const listFramesQuerySchema = z
+    .object({
+    cursor: z.string().min(1).optional(),
+    limit: z.coerce.number().int().min(1).max(50).optional()
+})
+    .strict();
+export const deleteFrameResponseSchema = z
+    .object({
+    id: idSchema,
+    status: z.enum(['deleting', 'deleted'])
+})
+    .strict();

package/dist/guidelines.d.ts

@@ -75,7 +75,106 @@ export declare const guidelineSetListResponseSchema: z.ZodObject<{
         nextCursor: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+/**
+ * ⚠️ A LOGO IS NEVER SENT TO THE MODEL.
+ *
+ * Nothing above this line changes because of logos, and nothing in the prompt
+ * composer reads them. They live in the guideline set because that is where a brand
+ * lives for a human, not because they steer generation — the Guidelines tab shows
+ * them under "Reference only — not sent to the model" for exactly that reason.
+ *
+ * A logo is an ordinary `media_assets` row of kind `logo`, uploaded through the
+ * unchanged three-step upload flow and then ASSOCIATED with a set. The association
+ * is a join row, so one set can hold several logos (primary, reversed, mono) and
+ * detaching one never destroys the asset.
+ */
+export declare const guidelineSetLogoListResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        workspaceId: z.ZodString;
+        projectId: z.ZodString;
+        createdByUserId: z.ZodString;
+        kind: z.ZodEnum<{
+            reference: "reference";
+            logo: "logo";
+            raw_image: "raw_image";
+            display_image: "display_image";
+            final_image: "final_image";
+            video_preview: "video_preview";
+            video_final: "video_final";
+            panel_video: "panel_video";
+            export: "export";
+        }>;
+        status: z.ZodEnum<{
+            deleted: "deleted";
+            failed: "failed";
+            pending_upload: "pending_upload";
+            available: "available";
+        }>;
+        contentType: z.ZodEnum<{
+            "image/png": "image/png";
+            "image/jpeg": "image/jpeg";
+            "image/webp": "image/webp";
+            "video/mp4": "video/mp4";
+        }>;
+        byteSize: z.ZodNullable<z.ZodNumber>;
+        checksumSha256: z.ZodNullable<z.ZodString>;
+        originalFilename: z.ZodNullable<z.ZodString>;
+        r2Key: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Attach by asset id and nothing else. The workspace and project come from the URL
+ * the caller was already authorized against; a body-supplied tenant would be a second
+ * source of truth for the predicate that is the whole security story here, so any
+ * such key is stripped rather than honoured.
+ */
+export declare const attachGuidelineSetLogoRequestSchema: z.ZodObject<{
+    assetId: z.ZodString;
+}, z.core.$strip>;
+export declare const guidelineSetLogoResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodString;
+        workspaceId: z.ZodString;
+        projectId: z.ZodString;
+        createdByUserId: z.ZodString;
+        kind: z.ZodEnum<{
+            reference: "reference";
+            logo: "logo";
+            raw_image: "raw_image";
+            display_image: "display_image";
+            final_image: "final_image";
+            video_preview: "video_preview";
+            video_final: "video_final";
+            panel_video: "panel_video";
+            export: "export";
+        }>;
+        status: z.ZodEnum<{
+            deleted: "deleted";
+            failed: "failed";
+            pending_upload: "pending_upload";
+            available: "available";
+        }>;
+        contentType: z.ZodEnum<{
+            "image/png": "image/png";
+            "image/jpeg": "image/jpeg";
+            "image/webp": "image/webp";
+            "video/mp4": "video/mp4";
+        }>;
+        byteSize: z.ZodNullable<z.ZodNumber>;
+        checksumSha256: z.ZodNullable<z.ZodString>;
+        originalFilename: z.ZodNullable<z.ZodString>;
+        r2Key: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export type GuidelineSet = z.infer<typeof guidelineSetSchema>;
 export type CreateGuidelineSetRequest = z.input<typeof createGuidelineSetRequestSchema>;
 export type UpdateGuidelineSetRequest = z.infer<typeof updateGuidelineSetRequestSchema>;
+export type GuidelineSetLogoListResponse = z.infer<typeof guidelineSetLogoListResponseSchema>;
+export type AttachGuidelineSetLogoRequest = z.infer<typeof attachGuidelineSetLogoRequestSchema>;
+export type GuidelineSetLogoResponse = z.infer<typeof guidelineSetLogoResponseSchema>;
 //# sourceMappingURL=guidelines.d.ts.map

package/dist/guidelines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidelines.d.ts","sourceRoot":"","sources":["../src/guidelines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAA;AAI9C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;iBAgB7B,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;iBAO1C,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;iBAMzC,CAAA;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;iBAAuC,CAAA;AAC9E,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;iBAAyC,CAAA;AAEpF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA"}
+{"version":3,"file":"guidelines.d.ts","sourceRoot":"","sources":["../src/guidelines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAA;AAI9C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;iBAwB7B,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;iBAO1C,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;iBAMzC,CAAA;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;iBAAuC,CAAA;AAC9E,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;iBAAyC,CAAA;AAMpF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAE7C,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mCAAmC;;iBAE9C,CAAA;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgC,CAAA;AAE3E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA"}

package/dist/guidelines.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { assetSchema } from './assets.js';
 import { apiSuccessSchema, idSchema, isoDateSchema, listResponseSchema } from './common.js';
 /**
  * Hard cap on the free text that is appended to EVERY generation in a project.
@@ -11,7 +12,15 @@ const hexColorSchema = z.string().regex(/^#[0-9a-fA-F]{6}$/, 'Colour must be a #
 export const guidelineSetSchema = z.object({
     id: idSchema,
     workspaceId: idSchema,
-    /** Exactly one of projectId / workspace-level is set; workspace-level lands later. */
+    /**
+     * A set is ALWAYS workspace-scoped and OPTIONALLY also project-scoped.
+     *
+     * (An earlier version of this comment said "exactly one of projectId /
+     * workspace-level is set". The schema never implemented that: `workspace_id` is
+     * NOT NULL and `project_id` is nullable, with no exactly-one CHECK, so the two
+     * COEXIST. `projectId === null` means a workspace-level default — not built in v1,
+     * which is what keeps workspace/project precedence genuinely deferred.)
+     */
     projectId: idSchema.nullable().default(null),
     createdByUserId: idSchema,
     name: z.string().min(1),
@@ -39,3 +48,32 @@ export const updateGuidelineSetRequestSchema = createGuidelineSetRequestSchema
     .refine((patch) => Object.entries(patch).some(([key, value]) => key !== 'expectedRevision' && value !== undefined), { message: 'Patch must change at least one field' });
 export const guidelineSetResponseSchema = apiSuccessSchema(guidelineSetSchema);
 export const guidelineSetListResponseSchema = listResponseSchema(guidelineSetSchema);
+// ---------------------------------------------------------------------------
+// Logos — storage, association and display ONLY
+// ---------------------------------------------------------------------------
+/**
+ * ⚠️ A LOGO IS NEVER SENT TO THE MODEL.
+ *
+ * Nothing above this line changes because of logos, and nothing in the prompt
+ * composer reads them. They live in the guideline set because that is where a brand
+ * lives for a human, not because they steer generation — the Guidelines tab shows
+ * them under "Reference only — not sent to the model" for exactly that reason.
+ *
+ * A logo is an ordinary `media_assets` row of kind `logo`, uploaded through the
+ * unchanged three-step upload flow and then ASSOCIATED with a set. The association
+ * is a join row, so one set can hold several logos (primary, reversed, mono) and
+ * detaching one never destroys the asset.
+ */
+export const guidelineSetLogoListResponseSchema = z.object({
+    items: z.array(assetSchema)
+});
+/**
+ * Attach by asset id and nothing else. The workspace and project come from the URL
+ * the caller was already authorized against; a body-supplied tenant would be a second
+ * source of truth for the predicate that is the whole security story here, so any
+ * such key is stripped rather than honoured.
+ */
+export const attachGuidelineSetLogoRequestSchema = z.object({
+    assetId: idSchema
+});
+export const guidelineSetLogoResponseSchema = apiSuccessSchema(assetSchema);

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './auth.js';
 export * from './client.js';
 export * from './common.js';
 export * from './credits.js';
+export * from './frame-iterator.js';
 export * from './generation.js';
 export * from './guidelines.js';
 export * from './loop-tools.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -5,6 +5,7 @@ export * from './auth.js';
 export * from './client.js';
 export * from './common.js';
 export * from './credits.js';
+export * from './frame-iterator.js';
 export * from './generation.js';
 export * from './guidelines.js';
 export * from './loop-tools.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuragpal02/zcl-contracts",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",