@clipwright/core 0.27.0 → 0.29.0

package/dist/contracts/v1/workflow-plan.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { workflowBrief, workflowBriefRead } from './workflow-brief.js';
+import { workflowBeat, workflowBeatRead, workflowMethodResponseRead } from './workflow-catalog.js';
+import { assetBinding, assetBindingRead, claimEvidence, claimEvidenceRead } from './workflow-evidence.js';
+import { isWorkflowTextStorable, workflowDigest, workflowId, workflowIssueRead, workflowMethodPin, workflowMethodPinRead, workflowRevision, workflowText } from './workflow-primitives.js';
+const storableJson = (value) => typeof value === 'string' ? isWorkflowTextStorable(value)
+    : Array.isArray(value) ? value.every(storableJson)
+        : value !== null && typeof value === 'object' ? Object.entries(value).every(([key, child]) => isWorkflowTextStorable(key) && storableJson(child)) : true;
+export const workflowPlanDocument = z.strictObject({
+    v: z.literal(1), method: workflowMethodPin, brief: workflowBrief, beats: z.array(workflowBeat).max(100),
+    claims: z.array(claimEvidence).max(100), assets: z.array(assetBinding).max(30),
+}).refine(document => new Set(document.beats.map(beat => beat.id)).size === document.beats.length, 'Beat IDs must be unique')
+    .refine(storableJson, 'Workflow document contains text that cannot be stored')
+    .refine(document => new Set(document.claims.map(claim => claim.id)).size === document.claims.length, 'Claim IDs must be unique')
+    .refine(document => new TextEncoder().encode(JSON.stringify(document)).length <= WORKFLOW_DOCUMENT_MAX_BYTES, 'Workflow document exceeds the byte limit');
+export const workflowPlanDocumentRead = z.looseObject({ v: z.number(), method: workflowMethodPinRead, brief: workflowBriefRead,
+    beats: z.array(workflowBeatRead), claims: z.array(claimEvidenceRead), assets: z.array(assetBindingRead) });
+export const createWorkflowPlan = z.strictObject({ document: workflowPlanDocument });
+export const saveWorkflowPlan = z.strictObject({ base_version: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER), document: workflowPlanDocument });
+export const approveWorkflowPlan = z.strictObject({ revision: workflowRevision, content_digest: workflowDigest });
+export const workflowPlanRead = z.looseObject({
+    v: z.number(), plan_id: workflowId, account_id: workflowText(200), revision: workflowRevision, content_digest: workflowDigest, document: workflowPlanDocumentRead,
+    status: z.string(), issues: z.array(workflowIssueRead), warnings: z.array(z.string()), approved_at: z.string().datetime().nullable(), created_at: z.string().datetime(),
+    capability_snapshot: workflowMethodResponseRead.shape.capabilities.optional(),
+});
+export const WORKFLOW_DOCUMENT_MAX_BYTES = 256_000;
+export function serializeWorkflowDocument(document) {
+    const json = JSON.stringify(document);
+    return { json, bytes: new TextEncoder().encode(json).length };
+}
+//# sourceMappingURL=workflow-plan.js.map

package/dist/contracts/v1/workflow-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-plan.js","sourceRoot":"","sources":["../../../src/contracts/v1/workflow-plan.ts"],"names":[],"mappings":"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"}

package/dist/contracts/v1/workflow-primitives.d.ts

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+export declare const WORKFLOW_METHOD_IDS: readonly ['ugc-product-intro', 'ugc-faq-answer', 'faceless-explainer', 'product-image-story', 'website-proof-demo', 'kinetic-launch'];
+export declare const workflowMethodId: z.ZodEnum<{
+    "faceless-explainer": "faceless-explainer";
+    "kinetic-launch": "kinetic-launch";
+    "product-image-story": "product-image-story";
+    "ugc-faq-answer": "ugc-faq-answer";
+    "ugc-product-intro": "ugc-product-intro";
+    "website-proof-demo": "website-proof-demo";
+}>;
+export declare const workflowDigest: z.ZodString;
+export declare const workflowId: z.ZodString;
+export declare const workflowRevision: z.ZodNumber;
+export declare const workflowLocalId: z.ZodString;
+export declare const isWorkflowTextStorable: (text: string) => boolean;
+export declare const workflowText: (max: number) => z.ZodString;
+export declare const workflowFormat: z.ZodObject<{
+    aspect_ratio: z.ZodEnum<{
+        "16:9": "16:9";
+        "1:1": "1:1";
+        "9:16": "9:16";
+    }>;
+    resolution: z.ZodEnum<{
+        "1080p": "1080p";
+        "4k": "4k";
+        "720p": "720p";
+    }>;
+}, z.core.$strict>;
+export declare const workflowFormatRead: z.ZodObject<{
+    aspect_ratio: z.ZodString;
+    resolution: z.ZodString;
+}, z.core.$loose>;
+export declare const workflowMethodPin: z.ZodObject<{
+    method_id: z.ZodEnum<{
+        "faceless-explainer": "faceless-explainer";
+        "kinetic-launch": "kinetic-launch";
+        "product-image-story": "product-image-story";
+        "ugc-faq-answer": "ugc-faq-answer";
+        "ugc-product-intro": "ugc-product-intro";
+        "website-proof-demo": "website-proof-demo";
+    }>;
+    version: z.ZodNumber;
+    content_digest: z.ZodString;
+    capability_digest: z.ZodString;
+}, z.core.$strict>;
+export declare const workflowMethodPinRead: z.ZodObject<{
+    method_id: z.ZodString;
+    version: z.ZodNumber;
+    content_digest: z.ZodString;
+    capability_digest: z.ZodString;
+}, z.core.$loose>;
+export type WorkflowMethodPin = z.infer<typeof workflowMethodPin>;
+export declare const workflowIssue: z.ZodObject<{
+    kind: z.ZodString;
+    path: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export type WorkflowIssue = z.infer<typeof workflowIssue>;
+export declare const workflowIssueRead: z.ZodObject<{
+    kind: z.ZodString;
+    path: z.ZodString;
+    message: z.ZodString;
+}, z.core.$loose>;

package/dist/contracts/v1/workflow-primitives.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { ASPECT_RATIOS, RESOLUTIONS } from '../../skills.js';
+export const WORKFLOW_METHOD_IDS = ['ugc-product-intro', 'ugc-faq-answer', 'faceless-explainer', 'product-image-story', 'website-proof-demo', 'kinetic-launch'];
+export const workflowMethodId = z.enum(WORKFLOW_METHOD_IDS);
+export const workflowDigest = z.string().regex(/^[a-f0-9]{64}$/);
+export const workflowId = z.string().regex(/^wfp_[a-zA-Z0-9_-]{1,64}$/);
+export const workflowRevision = z.number().int().positive().safe();
+export const workflowLocalId = z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/);
+const HALF_PAIR = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/;
+export const isWorkflowTextStorable = (text) => !text.includes('\u0000') && !HALF_PAIR.test(text);
+export const workflowText = (max) => z.string().min(1).max(max).refine(text => text.trim().length > 0, 'Text must not be blank')
+    .refine(isWorkflowTextStorable, 'Text contains U+0000 or an unpaired surrogate and cannot be stored');
+export const workflowFormat = z.strictObject({ aspect_ratio: z.enum(ASPECT_RATIOS), resolution: z.enum(RESOLUTIONS) });
+export const workflowFormatRead = z.looseObject({ aspect_ratio: z.string(), resolution: z.string() });
+export const workflowMethodPin = z.strictObject({ method_id: workflowMethodId, version: workflowRevision, content_digest: workflowDigest, capability_digest: workflowDigest });
+export const workflowMethodPinRead = z.looseObject({ method_id: z.string(), version: workflowRevision, content_digest: workflowDigest, capability_digest: workflowDigest });
+export const workflowIssue = z.strictObject({ kind: workflowText(80), path: z.string().max(500), message: workflowText(2000) });
+export const workflowIssueRead = z.looseObject({ kind: z.string(), path: z.string(), message: z.string() });
+//# sourceMappingURL=workflow-primitives.js.map

package/dist/contracts/v1/workflow-primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-primitives.js","sourceRoot":"","sources":["../../../src/contracts/v1/workflow-primitives.ts"],"names":[],"mappings":"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"}