@clipwright/core 0.27.0 → 0.29.0

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

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { facelessSceneAnchor } from '../../faceless-public.js';
+import { workflowBrief, workflowBriefRead } from './workflow-brief.js';
+import { workflowAnchorRead } from './workflow-evidence.js';
+import { workflowDigest, workflowFormat, workflowFormatRead, workflowIssue, workflowIssueRead, workflowLocalId, workflowMethodId, workflowRevision, workflowText } from './workflow-primitives.js';
+export const workflowBeat = z.strictObject({ id: workflowLocalId, role: workflowText(80), anchor: facelessSceneAnchor, required: z.boolean(), visual: workflowText(2000).optional() });
+export const workflowBeatRead = z.looseObject({ id: z.string(), role: z.string(), anchor: workflowAnchorRead, required: z.boolean(), visual: z.string().optional() });
+const binding = z.discriminatedUnion('kind', [
+    z.strictObject({ kind: z.literal('native'), skill: z.enum(['make_ugc', 'make_faceless']), profile: workflowText(80), visual_beats: z.literal('advisory') }),
+    z.strictObject({ kind: z.literal('blocked'), skill: z.literal('make_composition'), profile: workflowText(80), reasons: z.array(workflowIssue).min(1).max(20) }),
+]);
+const descriptorShape = {
+    id: workflowMethodId, version: workflowRevision, content_digest: workflowDigest, authoring_status: z.literal('ready'),
+    title: workflowText(200), purpose: workflowText(2000), required_inputs: z.array(z.enum(['audience', 'message', 'script', 'question', 'product', 'topic', 'assets'])).min(1).max(10),
+    required_features: z.array(workflowText(80)).min(1).max(30),
+    script_rules: z.strictObject({ structure: z.array(workflowText(80)).min(1).max(20), instructions: z.array(workflowText(2000)).min(1).max(20) }),
+    binding, output: z.strictObject({ formats: z.array(workflowFormat).min(1).max(20), timing: workflowText(2000) }),
+    limitations: z.array(workflowText(2000)).min(1).max(30), qa_policy: z.array(workflowText(2000)).min(1).max(30),
+    example: z.strictObject({ brief: workflowBrief, beats: z.array(workflowBeat).min(1).max(100) }),
+};
+export const methodDescriptor = z.strictObject(descriptorShape);
+export const methodDescriptorRead = z.looseObject({ ...descriptorShape,
+    id: z.string(), authoring_status: z.string(), required_inputs: z.array(z.string()), required_features: z.array(z.string()),
+    script_rules: z.looseObject({ structure: z.array(z.string()), instructions: z.array(z.string()) }),
+    binding: z.looseObject({ kind: z.string(), skill: z.string(), profile: z.string(), visual_beats: z.string().optional(), reasons: z.array(workflowIssueRead).optional() }),
+    output: z.looseObject({ formats: z.array(workflowFormatRead), timing: z.string() }), example: z.looseObject({ brief: workflowBriefRead, beats: z.array(workflowBeatRead) }),
+});
+export const executorCapability = z.strictObject({
+    skill: workflowText(80), configured: z.boolean(), qualified: z.boolean(), enabled: z.boolean(), profiles: z.array(workflowText(80)).max(30),
+    features: z.array(workflowText(80)).max(100), formats: z.array(workflowFormat).max(30),
+    field_dispositions: z.record(z.string().max(80), z.enum(['implemented', 'warned', 'rejected', 'stored'])),
+});
+export const capabilityProfile = z.strictObject({ v: z.literal(1), content_digest: workflowDigest.describe('SHA256 computed by the server capability resolver from the effective snapshot; never accept a client-asserted digest.'), executors: z.array(executorCapability).max(20) })
+    .refine(snapshot => new Set(snapshot.executors.map(executor => executor.skill)).size === snapshot.executors.length, 'Executor skills must be unique');
+export const workflowAvailability = z.strictObject({ status: z.enum(['available', 'execution_blocked']), reasons: z.array(workflowIssue).max(100) });
+export const workflowMethodResponse = z.strictObject({ descriptor: methodDescriptor, availability: workflowAvailability, capabilities: capabilityProfile });
+export const workflowMethodSummary = z.strictObject({ descriptor: methodDescriptor.pick({ id: true, version: true, content_digest: true, title: true, purpose: true, binding: true }), availability: workflowAvailability });
+export const workflowCatalogResponse = z.strictObject({ v: z.literal(1), capabilities: capabilityProfile, methods: z.array(workflowMethodSummary).max(100) });
+export const workflowMethodResponseRead = z.looseObject({ descriptor: methodDescriptorRead,
+    availability: z.looseObject({ status: z.string(), reasons: z.array(workflowIssueRead) }),
+    capabilities: z.looseObject({ v: z.number(), content_digest: workflowDigest, executors: z.array(z.looseObject({ skill: z.string(), configured: z.boolean(), qualified: z.boolean(), enabled: z.boolean(), profiles: z.array(z.string()), features: z.array(z.string()), formats: z.array(workflowFormatRead), field_dispositions: z.record(z.string(), z.string()) })) }),
+});
+export const workflowCatalogResponseRead = z.looseObject({ v: z.number(), capabilities: workflowMethodResponseRead.shape.capabilities,
+    methods: z.array(z.looseObject({ descriptor: methodDescriptorRead.pick({ id: true, version: true, content_digest: true, title: true, purpose: true, binding: true }), availability: workflowMethodResponseRead.shape.availability })) });
+//# sourceMappingURL=workflow-catalog.js.map

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

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

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

@@ -0,0 +1,319 @@
+import { z } from 'zod';
+export declare const workflowToolInputs: {
+    list_workflows: z.ZodObject<{}, z.core.$strict>;
+    get_workflow: z.ZodObject<{
+        method_id: z.ZodString;
+    }, z.core.$strict>;
+    prepare_workflow_plan: z.ZodObject<{
+        document: z.ZodObject<{
+            v: z.ZodLiteral<1>;
+            method: 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>;
+            beats: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                role: z.ZodString;
+                anchor: z.ZodUnion<readonly [z.ZodObject<{
+                    startWord: z.ZodNumber;
+                    endWord: z.ZodNumber;
+                }, z.core.$strict>, z.ZodObject<{
+                    quote: z.ZodString;
+                    occurrence: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>]>;
+                required: z.ZodBoolean;
+                visual: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            claims: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                text: z.ZodString;
+                required: z.ZodBoolean;
+                status: z.ZodEnum<{
+                    checked: "checked";
+                    supplied: "supplied";
+                    unresolved: "unresolved";
+                }>;
+                source: z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        capture: "capture";
+                        owner: "owner";
+                        url: "url";
+                    }>;
+                    reference: z.ZodString;
+                    url: z.ZodOptional<z.ZodString>;
+                    observed_at: z.ZodOptional<z.ZodString>;
+                    product_state: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+            assets: z.ZodArray<z.ZodObject<{
+                instance_id: z.ZodString;
+                asset_id: z.ZodString;
+                content_digest: z.ZodString;
+                anchor: z.ZodUnion<readonly [z.ZodObject<{
+                    startWord: z.ZodNumber;
+                    endWord: z.ZodNumber;
+                }, z.core.$strict>, z.ZodObject<{
+                    quote: z.ZodString;
+                    occurrence: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>]>;
+                provenance: z.ZodEnum<{
+                    generated_illustration: "generated_illustration";
+                    owner_supplied: "owner_supplied";
+                    verified_capture: "verified_capture";
+                }>;
+                rights: z.ZodEnum<{
+                    licensed: "licensed";
+                    owner_authorized: "owner_authorized";
+                    unresolved: "unresolved";
+                }>;
+                purpose: z.ZodEnum<{
+                    illustration: "illustration";
+                    product_proof: "product_proof";
+                    ui_proof: "ui_proof";
+                }>;
+                protected_area: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            brief: z.ZodObject<{
+                audience: z.ZodString;
+                message: z.ZodString;
+                script: z.ZodOptional<z.ZodString>;
+                cta: z.ZodOptional<z.ZodString>;
+                question: z.ZodOptional<z.ZodString>;
+                product: z.ZodOptional<z.ZodString>;
+                topic: z.ZodOptional<z.ZodString>;
+                brand_intent: z.ZodOptional<z.ZodString>;
+                required_terms: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    feature: z.ZodString;
+                    required: z.ZodBoolean;
+                }, z.core.$strict>>>;
+                requested_format: z.ZodOptional<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>>;
+                references: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        capture: "capture";
+                        owner: "owner";
+                        url: "url";
+                    }>;
+                    reference: z.ZodString;
+                    url: z.ZodOptional<z.ZodString>;
+                    observed_at: z.ZodOptional<z.ZodString>;
+                    product_state: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                native: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    skill: z.ZodLiteral<"make_ugc">;
+                    input: z.ZodObject<{
+                        script: z.ZodOptional<z.ZodString>;
+                        inserts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            id: z.ZodString;
+                            media_url: z.ZodString;
+                            media_type: z.ZodEnum<{
+                                image: "image";
+                                video: "video";
+                            }>;
+                            anchor: z.ZodUnion<readonly [z.ZodObject<{
+                                startWord: z.ZodNumber;
+                                endWord: z.ZodNumber;
+                            }, z.core.$strict>, z.ZodObject<{
+                                quote: z.ZodString;
+                                occurrence: z.ZodOptional<z.ZodNumber>;
+                            }, z.core.$strict>]>;
+                            cover_words: z.ZodOptional<z.ZodNumber>;
+                            image_motion: z.ZodOptional<z.ZodObject<{
+                                direction: z.ZodEnum<{
+                                    in: "in";
+                                    out: "out";
+                                }>;
+                                amount: z.ZodNumber;
+                            }, z.core.$strict>>;
+                        }, z.core.$strict>>>;
+                        person: z.ZodOptional<z.ZodString>;
+                        actor_id: z.ZodOptional<z.ZodString>;
+                        image: z.ZodOptional<z.ZodString>;
+                        actor_gender: z.ZodOptional<z.ZodEnum<{
+                            female: "female";
+                            male: "male";
+                        }>>;
+                        name: z.ZodOptional<z.ZodString>;
+                        broll_policy: z.ZodOptional<z.ZodEnum<{
+                            anyone: "anyone";
+                            no_actor: "no_actor";
+                            no_people: "no_people";
+                        }>>;
+                        captions: z.ZodDefault<z.ZodBoolean>;
+                        caption_style: z.ZodDefault<z.ZodEnum<{
+                            hormozi: "hormozi";
+                            minimal: "minimal";
+                            tiktok: "tiktok";
+                        }>>;
+                        look: z.ZodDefault<z.ZodEnum<{
+                            commercial: "commercial";
+                            natural: "natural";
+                            raw_iphone: "raw_iphone";
+                        }>>;
+                        aspect_ratio: z.ZodOptional<z.ZodEnum<{
+                            "16:9": "16:9";
+                            "1:1": "1:1";
+                            "9:16": "9:16";
+                        }>>;
+                        resolution: z.ZodOptional<z.ZodEnum<{
+                            "1080p": "1080p";
+                            "4k": "4k";
+                            "720p": "720p";
+                        }>>;
+                        voice: z.ZodOptional<z.ZodString>;
+                        voice_id: z.ZodOptional<z.ZodString>;
+                        tts_model: z.ZodOptional<z.ZodEnum<{
+                            eleven_flash_v2_5: "eleven_flash_v2_5";
+                            eleven_turbo_v2_5: "eleven_turbo_v2_5";
+                            eleven_v3: "eleven_v3";
+                            eleven_v4: "eleven_v4";
+                            "gemini-3.8-flash-tts": "gemini-3.8-flash-tts";
+                        }>>;
+                        background: z.ZodOptional<z.ZodEnum<{
+                            blur: "blur";
+                            contain: "contain";
+                            white: "white";
+                        }>>;
+                        segments: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodObject<{
+                            kind: z.ZodEnum<{
+                                actor: "actor";
+                                media: "media";
+                            }>;
+                            script: z.ZodOptional<z.ZodString>;
+                            media_url: z.ZodOptional<z.ZodString>;
+                            media_type: z.ZodOptional<z.ZodEnum<{
+                                image: "image";
+                                video: "video";
+                            }>>;
+                            duration_seconds: z.ZodOptional<z.ZodNumber>;
+                            image_motion: z.ZodOptional<z.ZodObject<{
+                                direction: z.ZodEnum<{
+                                    in: "in";
+                                    out: "out";
+                                }>;
+                                amount: z.ZodNumber;
+                            }, z.core.$strict>>;
+                        }, z.core.$strict>>, z.ZodArray<z.ZodObject<{
+                            kind: z.ZodEnum<{
+                                actor: "actor";
+                                media: "media";
+                            }>;
+                            script: z.ZodOptional<z.ZodString>;
+                            media_url: z.ZodOptional<z.ZodString>;
+                            media_type: z.ZodOptional<z.ZodEnum<{
+                                image: "image";
+                                video: "video";
+                            }>>;
+                            duration_seconds: z.ZodOptional<z.ZodNumber>;
+                            image_motion: z.ZodOptional<z.ZodObject<{
+                                direction: z.ZodEnum<{
+                                    in: "in";
+                                    out: "out";
+                                }>;
+                                amount: z.ZodNumber;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>>>>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
+                    skill: z.ZodLiteral<"make_faceless">;
+                    input: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        duration_seconds: z.ZodNumber;
+                        style_reference: z.ZodOptional<z.ZodString>;
+                        character_reference: z.ZodOptional<z.ZodString>;
+                        character_details: z.ZodOptional<z.ZodString>;
+                        scene_images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            image_url: z.ZodString;
+                            anchor: z.ZodUnion<readonly [z.ZodObject<{
+                                startWord: z.ZodNumber;
+                                endWord: z.ZodNumber;
+                            }, z.core.$strict>, z.ZodObject<{
+                                quote: z.ZodString;
+                                occurrence: z.ZodOptional<z.ZodNumber>;
+                            }, z.core.$strict>]>;
+                        }, z.core.$strict>>>;
+                        captions: z.ZodDefault<z.ZodBoolean>;
+                        voice: z.ZodOptional<z.ZodString>;
+                        voice_id: z.ZodOptional<z.ZodNever>;
+                        input_mode: z.ZodLiteral<"script">;
+                        script: z.ZodString;
+                    }, z.core.$strict>, z.ZodObject<{
+                        duration_seconds: z.ZodNumber;
+                        style_reference: z.ZodOptional<z.ZodString>;
+                        character_reference: z.ZodOptional<z.ZodString>;
+                        character_details: z.ZodOptional<z.ZodString>;
+                        scene_images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            image_url: z.ZodString;
+                            anchor: z.ZodUnion<readonly [z.ZodObject<{
+                                startWord: z.ZodNumber;
+                                endWord: z.ZodNumber;
+                            }, z.core.$strict>, z.ZodObject<{
+                                quote: z.ZodString;
+                                occurrence: z.ZodOptional<z.ZodNumber>;
+                            }, z.core.$strict>]>;
+                        }, z.core.$strict>>>;
+                        captions: z.ZodDefault<z.ZodBoolean>;
+                        voice: z.ZodOptional<z.ZodString>;
+                        voice_id: z.ZodOptional<z.ZodNever>;
+                        input_mode: z.ZodLiteral<"brief">;
+                        brief: z.ZodString;
+                    }, z.core.$strict>], "input_mode">;
+                }, z.core.$strict>], "skill">>;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        plan_id: z.ZodOptional<z.ZodString>;
+        base_version: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    get_workflow_plan: z.ZodObject<{
+        plan_id: z.ZodString;
+    }, z.core.$strict>;
+    approve_workflow_plan: z.ZodObject<{
+        revision: z.ZodNumber;
+        content_digest: z.ZodString;
+        plan_id: z.ZodString;
+    }, z.core.$strict>;
+    quote_workflow_plan: z.ZodObject<{
+        plan_id: z.ZodString;
+    }, z.core.$strict>;
+    run_workflow_plan: z.ZodObject<{
+        revision: z.ZodNumber;
+        content_digest: z.ZodString;
+        semantic_input_digest: z.ZodString;
+        quote_id: z.ZodString;
+        idempotency_key: z.ZodString;
+        plan_id: z.ZodString;
+    }, z.core.$strict>;
+};
+export declare const WORKFLOW_TOOL_DESCRIPTIONS: {
+    readonly list_workflows: 'List six workflow methods and their current availability. Free and read-only. Four B1 methods use native executors; website-proof-demo and kinetic-launch remain execution_blocked. Availability is not account-specific permission to buy.';
+    readonly get_workflow: 'Read one workflow method by method_id: required inputs, script rules, evidence, limitations and current availability. Free and read-only. Use the returned method and capability digests in a plan.';
+    readonly prepare_workflow_plan: 'Create or save a workflow plan without paying or starting a run. Supply the complete document. Omit both plan_id and base_version to create; supply both to save a revision. The document is strict and bounded to 256000 JSON bytes. Preserve exact accepted narration. After a lost save answer, read and compare the saved document; do not automatically approve or purchase.';
+    readonly get_workflow_plan: 'Read the current account-owned plan, revision, content digest, readiness issues and warnings. Free and read-only. The document is intent; it is not a delivered video or creative acceptance.';
+    readonly approve_workflow_plan: 'Explicitly approve the chosen plan revision and content_digest. Free; it stores approval but starts no run. Read all issues and warnings first. Approval is separate from a quote and a paid launch.';
+    readonly quote_workflow_plan: 'Quote the approved current plan without spending credits. Free and read-only. Show the native price and every warning before requesting a paid launch. The returned quote_id expires and binds the exact revision and semantic input.';
+    readonly run_workflow_plan: 'Start one explicitly approved paid workflow run using the exact revision, content_digest, semantic_input_digest and quote_id from its quote, plus an explicit idempotency_key. Returns immediately with its captured receipt and native run_id; poll get_run. Never auto-approve, auto-quote or invent a new key. If delivery is uncertain, recover with the original request and key; a new key can pay twice. Technical evidence is separate from human creative acceptance.';
+};

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

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { approveWorkflowPlan, saveWorkflowPlan, workflowPlanDocument } from './workflow-plan.js';
+import { launchWorkflow } from './workflow-execution.js';
+import { workflowId, workflowText } from './workflow-primitives.js';
+import { workflowBrief, workflowNativeInput } from './workflow-brief.js';
+import { offeredUgcInputShape } from '../../contract-dispositions.js';
+const [ugc, faceless] = workflowNativeInput.options;
+const offeredShape = Object.fromEntries(Object.keys(offeredUgcInputShape).map(key => [key, ugc.shape.input.shape[key]]));
+const offeredUgc = z.strictObject(offeredShape).superRefine((value, context) => {
+    const parsed = ugc.shape.input.safeParse(value);
+    if (!parsed.success)
+        for (const issue of parsed.error.issues)
+            context.addIssue({ code: z.ZodIssueCode.custom, path: issue.path, message: issue.message });
+});
+const offeredBrief = workflowBrief.safeExtend({ native: z.discriminatedUnion('skill', [ugc.safeExtend({ input: offeredUgc }), faceless]).optional() });
+const offeredDocument = workflowPlanDocument.safeExtend({ brief: offeredBrief });
+export const workflowToolInputs = {
+    list_workflows: z.strictObject({}),
+    get_workflow: z.strictObject({ method_id: workflowText(200) }),
+    prepare_workflow_plan: z.strictObject({ document: offeredDocument, plan_id: workflowId.optional(),
+        base_version: saveWorkflowPlan.shape.base_version.optional() })
+        .refine(value => (value.plan_id === undefined) === (value.base_version === undefined), 'plan_id and base_version must be supplied together'),
+    get_workflow_plan: z.strictObject({ plan_id: workflowId }),
+    approve_workflow_plan: z.strictObject({ plan_id: workflowId, ...approveWorkflowPlan.shape }),
+    quote_workflow_plan: z.strictObject({ plan_id: workflowId }),
+    run_workflow_plan: z.strictObject({ plan_id: workflowId, ...launchWorkflow.shape }),
+};
+export const WORKFLOW_TOOL_DESCRIPTIONS = {
+    list_workflows: 'List six workflow methods and their current availability. Free and read-only. Four B1 methods use native executors; website-proof-demo and kinetic-launch remain execution_blocked. Availability is not account-specific permission to buy.',
+    get_workflow: 'Read one workflow method by method_id: required inputs, script rules, evidence, limitations and current availability. Free and read-only. Use the returned method and capability digests in a plan.',
+    prepare_workflow_plan: 'Create or save a workflow plan without paying or starting a run. Supply the complete document. Omit both plan_id and base_version to create; supply both to save a revision. The document is strict and bounded to 256000 JSON bytes. Preserve exact accepted narration. After a lost save answer, read and compare the saved document; do not automatically approve or purchase.',
+    get_workflow_plan: 'Read the current account-owned plan, revision, content digest, readiness issues and warnings. Free and read-only. The document is intent; it is not a delivered video or creative acceptance.',
+    approve_workflow_plan: 'Explicitly approve the chosen plan revision and content_digest. Free; it stores approval but starts no run. Read all issues and warnings first. Approval is separate from a quote and a paid launch.',
+    quote_workflow_plan: 'Quote the approved current plan without spending credits. Free and read-only. Show the native price and every warning before requesting a paid launch. The returned quote_id expires and binds the exact revision and semantic input.',
+    run_workflow_plan: 'Start one explicitly approved paid workflow run using the exact revision, content_digest, semantic_input_digest and quote_id from its quote, plus an explicit idempotency_key. Returns immediately with its captured receipt and native run_id; poll get_run. Never auto-approve, auto-quote or invent a new key. If delivery is uncertain, recover with the original request and key; a new key can pay twice. Technical evidence is separate from human creative acceptance.',
+};
+//# sourceMappingURL=workflow-client.js.map

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

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

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

@@ -0,0 +1,18 @@
+import { type WorkflowBrief } from './workflow-brief.js';
+import { type WorkflowPlanDocument } from './workflow-plan.js';
+import { type WorkflowReceipt } from './workflow-execution.js';
+export declare class WorkflowBriefDto {
+    readonly value: WorkflowBrief;
+    private constructor();
+    static parse(value: unknown): WorkflowBriefDto;
+}
+export declare class WorkflowPlanDto {
+    readonly value: WorkflowPlanDocument;
+    private constructor();
+    static parse(value: unknown): WorkflowPlanDto;
+}
+export declare class WorkflowExecutionDto {
+    readonly value: WorkflowReceipt;
+    private constructor();
+    static parse(value: unknown): WorkflowExecutionDto;
+}

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

@@ -0,0 +1,25 @@
+import { workflowBrief } from './workflow-brief.js';
+import { workflowPlanDocument } from './workflow-plan.js';
+import { workflowReceipt } from './workflow-execution.js';
+export class WorkflowBriefDto {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    static parse(value) { return new WorkflowBriefDto(workflowBrief.parse(value)); }
+}
+export class WorkflowPlanDto {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    static parse(value) { return new WorkflowPlanDto(workflowPlanDocument.parse(value)); }
+}
+export class WorkflowExecutionDto {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    static parse(value) { return new WorkflowExecutionDto(workflowReceipt.parse(value)); }
+}
+//# sourceMappingURL=workflow-dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-dto.js","sourceRoot":"","sources":["../../../src/contracts/v1/workflow-dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAA6B,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAwB,MAAM,yBAAyB,CAAC;AAEhF,MAAM,OAAO,gBAAgB;IACI,KAAK;IAAlC,YAA6B,KAAoB;qBAApB,KAAK;IAAkB,CAAC;IACrD,MAAM,CAAC,KAAK,CAAC,KAAc,IAAsB,OAAO,IAAI,gBAAgB,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9G;AACD,MAAM,OAAO,eAAe;IACK,KAAK;IAAlC,YAA6B,KAA2B;qBAA3B,KAAK;IAAyB,CAAC;IAC5D,MAAM,CAAC,KAAK,CAAC,KAAc,IAAqB,OAAO,IAAI,eAAe,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CACnH;AACD,MAAM,OAAO,oBAAoB;IACA,KAAK;IAAlC,YAA6B,KAAsB;qBAAtB,KAAK;IAAoB,CAAC;IACvD,MAAM,CAAC,KAAK,CAAC,KAAc,IAA0B,OAAO,IAAI,oBAAoB,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CACxH"}

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

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+export declare const workflowEvidenceSource: z.ZodObject<{
+    kind: z.ZodEnum<{
+        capture: "capture";
+        owner: "owner";
+        url: "url";
+    }>;
+    reference: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    observed_at: z.ZodOptional<z.ZodString>;
+    product_state: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const claimEvidence: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    required: z.ZodBoolean;
+    status: z.ZodEnum<{
+        checked: "checked";
+        supplied: "supplied";
+        unresolved: "unresolved";
+    }>;
+    source: z.ZodObject<{
+        kind: z.ZodEnum<{
+            capture: "capture";
+            owner: "owner";
+            url: "url";
+        }>;
+        reference: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        observed_at: z.ZodOptional<z.ZodString>;
+        product_state: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ClaimEvidence = z.infer<typeof claimEvidence>;
+export declare const claimEvidenceRead: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    required: z.ZodBoolean;
+    status: z.ZodString;
+    source: z.ZodObject<{
+        kind: z.ZodString;
+        reference: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        observed_at: z.ZodOptional<z.ZodString>;
+        product_state: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const workflowAnchorRead: z.ZodUnion<readonly [z.ZodObject<{
+    startWord: z.ZodNumber;
+    endWord: z.ZodNumber;
+}, z.core.$loose>, z.ZodObject<{
+    quote: z.ZodString;
+    occurrence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>]>;
+export declare const protectedProductArea: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>;
+export declare const assetBinding: z.ZodObject<{
+    instance_id: z.ZodString;
+    asset_id: z.ZodString;
+    content_digest: z.ZodString;
+    anchor: z.ZodUnion<readonly [z.ZodObject<{
+        startWord: z.ZodNumber;
+        endWord: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        quote: z.ZodString;
+        occurrence: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>;
+    provenance: z.ZodEnum<{
+        generated_illustration: "generated_illustration";
+        owner_supplied: "owner_supplied";
+        verified_capture: "verified_capture";
+    }>;
+    rights: z.ZodEnum<{
+        licensed: "licensed";
+        owner_authorized: "owner_authorized";
+        unresolved: "unresolved";
+    }>;
+    purpose: z.ZodEnum<{
+        illustration: "illustration";
+        product_proof: "product_proof";
+        ui_proof: "ui_proof";
+    }>;
+    protected_area: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AssetBinding = z.infer<typeof assetBinding>;
+export declare const assetBindingRead: z.ZodObject<{
+    instance_id: z.ZodString;
+    asset_id: z.ZodString;
+    content_digest: z.ZodString;
+    anchor: z.ZodUnion<readonly [z.ZodObject<{
+        startWord: z.ZodNumber;
+        endWord: z.ZodNumber;
+    }, z.core.$loose>, z.ZodObject<{
+        quote: z.ZodString;
+        occurrence: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>]>;
+    provenance: z.ZodString;
+    rights: z.ZodString;
+    purpose: z.ZodString;
+    protected_area: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$loose>>;
+}, z.core.$loose>;

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

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { facelessSceneAnchor } from '../../faceless-public.js';
+import { uploadId } from '../../uploads.js';
+import { MAX_URL_LENGTH } from '../../skills.js';
+import { workflowDigest, workflowLocalId, workflowText } from './workflow-primitives.js';
+export const workflowEvidenceSource = z.strictObject({
+    kind: z.enum(['owner', 'url', 'capture']), reference: workflowText(2000),
+    url: z.string().url().max(MAX_URL_LENGTH).optional(), observed_at: z.string().datetime().optional(), product_state: workflowText(2000).optional(),
+});
+export const claimEvidence = z.strictObject({
+    id: workflowLocalId, text: workflowText(4000), required: z.boolean(), status: z.enum(['supplied', 'checked', 'unresolved']), source: workflowEvidenceSource,
+});
+export const claimEvidenceRead = z.looseObject({
+    id: z.string(), text: z.string(), required: z.boolean(), status: z.string(),
+    source: z.looseObject({ kind: z.string(), reference: z.string(), url: z.string().optional(), observed_at: z.string().optional(), product_state: z.string().optional() }),
+});
+export const workflowAnchorRead = z.union([
+    z.looseObject({ startWord: z.number().int().nonnegative(), endWord: z.number().int().positive() }),
+    z.looseObject({ quote: z.string(), occurrence: z.number().int().nonnegative().optional() }),
+]);
+export const protectedProductArea = z.strictObject({ x: z.number().min(0).lt(1), y: z.number().min(0).lt(1), width: z.number().positive().max(1), height: z.number().positive().max(1) })
+    .refine(area => area.x + area.width <= 1 && area.y + area.height <= 1, 'Protected product area exceeds source bounds');
+export const assetBinding = z.strictObject({
+    instance_id: workflowLocalId, asset_id: uploadId, content_digest: workflowDigest, anchor: facelessSceneAnchor,
+    provenance: z.enum(['owner_supplied', 'generated_illustration', 'verified_capture']), rights: z.enum(['owner_authorized', 'licensed', 'unresolved']),
+    purpose: z.enum(['product_proof', 'illustration', 'ui_proof']), protected_area: protectedProductArea.optional(),
+});
+export const assetBindingRead = z.looseObject({
+    instance_id: z.string(), asset_id: z.string(), content_digest: workflowDigest, anchor: workflowAnchorRead,
+    provenance: z.string(), rights: z.string(), purpose: z.string(),
+    protected_area: z.looseObject({ x: z.number(), y: z.number(), width: z.number(), height: z.number() }).optional(),
+});
+//# sourceMappingURL=workflow-evidence.js.map

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

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