@xiaohhhh1/canvas-agent 0.4.67 → 0.4.68

package/dist/workflow/manager.d.ts

@@ -1,6 +1,7 @@
 import type { AgentEmit } from "../agent/types.js";
 import { type CanvasAgentConfig } from "../config.js";
 export declare const FLOW_C_CODEX_TURN_TIMEOUT_MS: number;
+export declare const FLOW_C_SELECTED_BLUEPRINT_PROMPT_MAX_CHARS = 36000;
 type ScriptStatus = "queued" | "running" | "complete" | "error" | "expired";
 type DownloadStatus = "waiting" | "running" | "complete" | "error" | "expired";
 type ScriptRecord = {
@@ -60,6 +61,8 @@ type SelectedCandidate = {
     ordinal: number;
     productIndex: number;
     learnedTemplateId?: string | null;
+    learnedTemplateSource?: Record<string, unknown> | null;
+    productIdentityProfile?: Record<string, unknown>;
     executionBlueprint?: string;
     templateMatch?: Record<string, unknown>;
     retimingInstruction?: string;
@@ -82,7 +85,7 @@ type SelectedCandidate = {
     creativeFingerprint: Record<string, string>;
     fingerprintKey?: string;
     selectionScore?: number;
-    selectionBreakdown?: Record<string, number>;
+    selectionBreakdown?: Record<string, unknown>;
     selectionMode?: string;
 };
 type ScriptTask = {
@@ -314,6 +317,9 @@ export declare function terminalScriptChunkError(results: Array<{
 export declare function scriptCreativeReplanOrdinals(results: unknown[]): number[];
 export declare function creativeReplanOrdinals(error: unknown): number[];
 export declare function recordCreativeReplanAttempts(attempts: Map<number, number>, ordinals: number[], limit?: number): void;
+export declare function isFlowCPromptPayloadTooLarge(error: unknown): error is Error & {
+    code: "FLOW_C_PROMPT_PAYLOAD_TOO_LARGE";
+};
 export declare function scriptChunkPrompt(id: string, task: ScriptTask, ordinals: number[]): string;
 export declare function creativeCandidatePrompt(id: string, task: ScriptTask, ordinals: number[]): string;
 export declare function selectedBlueprintPromptPayload(values: SelectedCandidate[]): {
@@ -321,34 +327,13 @@ export declare function selectedBlueprintPromptPayload(values: SelectedCandidate
         blueprintRef: string;
         executionBlueprint: string;
     }[];
-    selectedCandidates: {
-        blueprintRef: string;
+    productAdaptations: Record<string, unknown>[];
+    ordinalBindings: {
         ordinal: number;
         productIndex: number;
-        learnedTemplateId?: string | null;
-        templateMatch?: Record<string, unknown>;
-        retimingInstruction?: string;
-        visualPremise: string;
-        mutationAxes: string[];
-        culturalAnchors: Array<Record<string, unknown>>;
-        spectacleEscalation: string;
-        productProofAction: string;
-        purchaseReason: string;
-        truthBoundary: string;
-        riskFlags: string[];
-        firstFrame: string;
-        firstFrameFocus: string;
-        visualContrast: string;
-        sensoryTexture: string;
-        motionPeak: string;
-        compositionLighting: string;
-        localNativeDetail: string;
-        antiFlatness: string;
-        creativeFingerprint: Record<string, string>;
-        fingerprintKey?: string;
-        selectionScore?: number;
-        selectionBreakdown?: Record<string, number>;
-        selectionMode?: string;
+        blueprintRef: string | null;
+        adaptationRef: string;
+        variationSeed: string;
     }[];
 };
 /**

package/dist/workflow/manager.js

@@ -14,6 +14,7 @@ import { FLOW_C_CREATIVE_CANDIDATE_CONTRACT_VERSION, flowCCreativeCandidateOutpu
 import { flowCScriptOutputSchema, parseFlowCScriptOutput } from "./script-output.js";
 const STATE_FILE = path.join(CONFIG_DIR, "workflow-state.json");
 export const FLOW_C_CODEX_TURN_TIMEOUT_MS = 8 * 60 * 1000;
+export const FLOW_C_SELECTED_BLUEPRINT_PROMPT_MAX_CHARS = 36_000;
 /** 本机持久化的 Flow C 控制器：脚本交给本机 Codex，视频直接落盘。 */
 export class WorkflowManager {
     config;
@@ -377,7 +378,16 @@ export class WorkflowManager {
         }
     }
     async runCandidateChunk(id, task, ordinals, cwd) {
-        const result = await runCodexWorkflowTurn(creativeCandidatePrompt(id, task, ordinals), this.emit, {
+        let prompt;
+        try {
+            prompt = creativeCandidatePrompt(id, task, ordinals);
+        }
+        catch (error) {
+            if (isFlowCPromptPayloadTooLarge(error))
+                return { error: error.message, terminal: false };
+            throw error;
+        }
+        const result = await runCodexWorkflowTurn(prompt, this.emit, {
             cwd,
             permissionMode: "full",
             timeoutMs: FLOW_C_CODEX_TURN_TIMEOUT_MS,
@@ -403,7 +413,16 @@ export class WorkflowManager {
     /** 一个 chunk 使用独立线程；解析与中心持久化失败不会影响并行 lane。 */
     async runScriptChunk(id, task, ordinals, cwd) {
         const durationSeconds = Number(task.duration_seconds || 10);
-        const result = await runCodexWorkflowTurn(scriptChunkPrompt(id, task, ordinals), this.emit, {
+        let prompt;
+        try {
+            prompt = scriptChunkPrompt(id, task, ordinals);
+        }
+        catch (error) {
+            if (isFlowCPromptPayloadTooLarge(error))
+                return { error: error.message, terminal: false };
+            throw error;
+        }
+        const result = await runCodexWorkflowTurn(prompt, this.emit, {
             cwd,
             permissionMode: "full",
             timeoutMs: FLOW_C_CODEX_TURN_TIMEOUT_MS,
@@ -630,10 +649,21 @@ export function recordCreativeReplanAttempts(attempts, ordinals, limit = 3) {
 }
 class ExpiredCapabilityError extends Error {
 }
+class FlowCPromptPayloadTooLargeError extends Error {
+    code = "FLOW_C_PROMPT_PAYLOAD_TOO_LARGE";
+    constructor(label, actual, limit) {
+        super(`${label}为 ${actual} 字符，超过单个模型回合上限 ${limit}；本机将缩小脚本子批，单条仍超限时会明确暂停。`);
+        this.name = "FlowCPromptPayloadTooLargeError";
+    }
+}
+export function isFlowCPromptPayloadTooLarge(error) {
+    return Boolean(error && typeof error === "object" && error.code === "FLOW_C_PROMPT_PAYLOAD_TOO_LARGE");
+}
 export function scriptChunkPrompt(id, task, ordinals) {
     const duration = Number(task.duration_seconds || 10);
     const layoutVersion = task.storyboard_layout_version || task.storyboardLayoutVersion || "director-table-scripted-v1";
     const products = relevantProductInputs(task, ordinals);
+    const productFacts = scriptPromptProductFacts(products);
     const selected = selectedCandidatesForOrdinals(task, ordinals);
     if (selected.size !== ordinals.length)
         throw new Error("中心尚未为当前 ordinal 完成创意选题");
@@ -641,17 +671,18 @@ export function scriptChunkPrompt(id, task, ordinals) {
         ? "每条只输出 openingState 和一个完整 0–10 秒 segment，不生成 masterScript。"
         : `每条只输出 openingState 和 ${duration / 10} 个各自 0–10 秒的 segments；Agent 会确定性合成 masterScript，不得重复输出总稿，也不得写 10–20 或 20–30 全局时轴。`;
     return `你正在后台完成 Flow C 脚本交接 ${id}，只写 ordinal：${ordinals.join(", ")}；映射：${scriptProductAssignments(task.product_quantities, ordinals)}。
-目标市场：${task.market}。商品事实：${compactJson(products, 12_000)}
-中心已按人工商品/类目标注完成模板匹配；下面每个 ordinal 通过 blueprintRef 引用一次反推后持久化的 executionBlueprint，是唯一结构权威。相同蓝图只传一次，直接把它换成当前商品执行，不要生成候选、重新选题或重新评分：
-${compactJson(selectedBlueprintPromptPayload([...selected.values()]), 36_000)}
+目标市场：${task.market}。商品事实：${compactJson(productFacts, 12_000, "当前脚本子批的商品事实")}
+中心已完成当前 ordinal 的创意选择。executionBlueprints 只保存一次共享爆款详细蓝图；productAdaptations 只保存一次每个不同的当前商品执行卡；ordinalBindings 只用 blueprintRef/adaptationRef 和 variationSeed 映射到具体脚本。存在 blueprintRef 时，对应 executionBlueprint 是唯一结构权威；没有 blueprintRef 时，对应 productAdaptation 是现存普通 Flow C 候选或用户框架的唯一执行权威。相同蓝图可供同一商品整批复用，直接替换成当前商品执行，不要生成候选、重新选题或重新评分：
+${compactJson(selectedBlueprintPromptPayload([...selected.values()]), FLOW_C_SELECTED_BLUEPRINT_PROMPT_MAX_CHARS, "当前脚本子批的共享蓝图与商品适配")}
 ${durationRules}
 写作要求：
-1. visualHook、conflict、escalation/turn、productIntervention、visibleProof、purchaseReason、callbackMotivation 与所有 shots 必须执行选中卡的 visualPremise、firstFrame、spectacleEscalation、productProofAction、purchaseReason、truthBoundary 以及七项视觉执行字段；不得扩大功效、稀释构图或换成普通模板。productProofAction 必须同时写清一个真实动作及其镜头内可见结果；purchaseReason 只解释该结果为何值得目标用户购买，不能变成泛泛 CTA。
+1. visualHook、conflict、escalation/turn、productIntervention、visibleProof、purchaseReason、callbackMotivation 与所有 shots 必须执行选中卡的 visualPremise、firstFrame、spectacleEscalation、productProofAction、purchaseReason、truthBoundary 以及七项视觉执行字段；保留爆款的因果时间线、节拍比例、镜头/剪辑节奏、动作压力、证明方式和购买逻辑，只替换原商品、人物、来源身份、文案及目标市场口播，不得稀释构图或换成普通模板。productProofAction 必须同时写清一个真实动作及其镜头内可见结果；purchaseReason 只解释该结果为何值得目标用户购买，不能变成泛泛 CTA。
 2. 每条生成一份稳定 voiceProfile；每段只写简短 voiceCue。口播必须是目标市场 ${task.market} 的自然原生语言、偏快但清晰；导演说明统一用简洁制作英文。
 3. 每段永远是独立 0–10 秒，含 1–8 个按剧情需要决定的 shots、准确 voiceover、onScreenText、evidence、soundBgm、emotionalNote 与 endingState；模型不要输出 continuity 或 continuityMode。
 4. shot.visual 要直接写出主体位置、景别、光线、材质、动作峰值和当地自然环境，并保留真实皮肤、细发、布料/商品微纹理和实景混合光；禁止塑料蜡感、静态举产品、品牌广告片、电视购物或伪造工厂/销量/来源。
 5. 20/30 秒的后一段剧情承接前段 endingState，但每段仍只使用自己的局部 0–10 秒执行内容。
 6. 不要输出 creativePlan、executionBindings 或 masterScript；这些字段由 Agent 从选中蓝图确定性回填/合成，避免重复 token 和脆弱的文字绑定校验。若 selectionMode=user-framework，用户原框架的开头、事件顺序、核心剧情和结尾仍是最高权威。
+7. 商品身份只由当前商品标题、大概类目和按顺序提供的原商品图决定：第1张是主SKU身份图，后续图片只是同一SKU补充视角。任何爆款源商品、首帧、故事板或上一段尾帧都不得改变商品颜色、款式、结构、比例、材质、包装、标识位置、部件、配件和实际套装数量；修正身份时不得降低动作、运镜、节奏、景深、真实感或画质。
 固定使用 GPT-5.6 Terra 中等推理。storyboardLayoutVersion=${layoutVersion} 仅由中心管理。只返回当前结构化 jobs，不调用工具、不创建任何图片或视频任务。`;
 }
 export function creativeCandidatePrompt(id, task, ordinals) {
@@ -659,9 +690,9 @@ export function creativeCandidatePrompt(id, task, ordinals) {
     const styleCards = relevantStyleCards(task.reference_style_cards || [], products, task.market).map(compactReferenceStyleCard).filter(Boolean).slice(0, 6);
     const ledger = (task.creative_fingerprint_ledger || []).slice(-60);
     return `Flow C creative-candidate stage for handoff ${id}. Set contractVersion exactly to ${FLOW_C_CREATIVE_CANDIDATE_CONTRACT_VERSION}. Return exactly one group for each ordinal: ${ordinals.join(", ")}; mapping: ${scriptProductAssignments(task.product_quantities, ordinals)}.
-Market: ${task.market}. Target output duration: ${Number(task.duration_seconds || 10)} seconds. Product facts: ${compactJson(products, 12_000)}
-Optional learned style abstractions: ${compactJson(styleCards, 5_000)}
-Already accepted fingerprint ledger: ${compactJson(ledger, 8_000)}
+Market: ${task.market}. Target output duration: ${Number(task.duration_seconds || 10)} seconds. Product facts: ${compactJson(products, 12_000, "candidate product facts")}
+Optional learned style abstractions: ${compactJsonArray(styleCards, 5_000, "candidate style cards", "first")}
+Already accepted fingerprint ledger: ${compactJsonArray(ledger, 8_000, "candidate fingerprint ledger", "last")}
 For each ordinal return exactly 6 short, auditable candidate cards. These are visible structured alternatives, not hidden reasoning. Vary the overall creative skeleton through open dimensions such as relationship/identity, scene mismatch, scale/quantity, group reaction, viewpoint, sensory texture and proof action; do not rotate a fixed template list.
 Set learnedTemplateId to the id of one supplied learned-video-structure card when its product/market fit is credible; otherwise set it to null. A fitting learned template has priority over free ideation. Preserve its hook-to-proof-to-purchase-reason causal structure, but re-time it to the current target duration instead of stretching, truncating or copying the source timeline. The template is model-neutral evidence: never output Seedance wording or source-specific people, dialogue, wardrobe, set or exact shots. The same learnedTemplateId may be used for multiple ordinals when useful, but each adapted candidate must still have truthful product-specific content, native VO intent and a meaningfully changed opening/proof execution. If the product has a non-empty user-authored creativeBrief, this candidate stage is bypassed entirely and no learned template may influence the script.
 Every card must be surprising but physically filmable and product-relevant. productProofAction must state one truthful intended-use action and the observable result that remains visible in the same scene. purchaseReason must state one concrete reason the supported result matters to a real target buyer; it is not a generic CTA and must not invent price, discount, scarcity, sales, inventory or unsupported quantified performance. productProofAction, purchaseReason and truthBoundary must follow supplied facts. For food, baby, medical/efficacy and personal-hygiene products, reject unhygienic display, fear marketing, dangerous use and unsupported promises.
@@ -702,6 +733,16 @@ function relevantProductInputs(task, ordinals) {
         return products;
     return [{ productIndex: -1, title: "Server compatibility fallback", quantity: ordinals.length, creativeBrief: String(task.instructions || "").slice(0, 4_000) }];
 }
+function scriptPromptProductFacts(products) {
+    return products.map((product) => ({
+        productIndex: product.productIndex,
+        title: product.title,
+        category: product.category || "",
+        quantity: product.quantity,
+        sellingForm: product.sellingForm || "",
+        productImageUrlsInExactOrder: product.productImageUrlsInExactOrder || [],
+    }));
+}
 function selectedCandidateOrdinals(task) {
     return [...new Set((task.selected_candidates || []).map((candidate) => Number(candidate.ordinal)).filter(Number.isInteger))].sort((left, right) => left - right);
 }
@@ -711,17 +752,63 @@ function selectedCandidatesForOrdinals(task, ordinals) {
 }
 export function selectedBlueprintPromptPayload(values) {
     const blueprints = new Map();
-    const selectedCandidates = values.map((candidate) => {
-        const blueprint = String(candidate.executionBlueprint || "").trim().slice(0, 8_000);
-        const blueprintRef = String(candidate.learnedTemplateId || candidate.fingerprintKey || `ordinal-${candidate.ordinal}`);
-        if (blueprint && !blueprints.has(blueprintRef))
-            blueprints.set(blueprintRef, blueprint);
-        const { executionBlueprint: _executionBlueprint, ...compactCandidate } = candidate;
-        return { ...compactCandidate, blueprintRef };
+    const blueprintRefByContent = new Map();
+    const adaptations = new Map();
+    const ordinalBindings = values.map((candidate) => {
+        const blueprint = String(candidate.executionBlueprint || "").trim();
+        let blueprintRef = null;
+        if (blueprint) {
+            blueprintRef = blueprintRefByContent.get(blueprint) || null;
+            if (!blueprintRef) {
+                const requestedRef = String(candidate.learnedTemplateId || `blueprint-${createHash("sha256").update(blueprint).digest("hex").slice(0, 16)}`);
+                const existing = blueprints.get(requestedRef);
+                blueprintRef = existing && existing.executionBlueprint !== blueprint
+                    ? `${requestedRef}-${createHash("sha256").update(blueprint).digest("hex").slice(0, 12)}`
+                    : requestedRef;
+                blueprints.set(blueprintRef, { blueprintRef, executionBlueprint: blueprint });
+                blueprintRefByContent.set(blueprint, blueprintRef);
+            }
+        }
+        const adaptation = {
+            productIndex: candidate.productIndex,
+            blueprintRef,
+            selectionMode: candidate.selectionMode || null,
+            templateMatch: candidate.templateMatch || null,
+            retimingInstruction: candidate.retimingInstruction || null,
+            productIdentityProfile: candidate.productIdentityProfile || null,
+            visualPremise: candidate.visualPremise,
+            mutationAxes: candidate.mutationAxes,
+            culturalAnchors: candidate.culturalAnchors,
+            spectacleEscalation: candidate.spectacleEscalation,
+            productProofAction: candidate.productProofAction,
+            purchaseReason: candidate.purchaseReason,
+            truthBoundary: candidate.truthBoundary,
+            riskFlags: candidate.riskFlags,
+            firstFrame: candidate.firstFrame,
+            firstFrameFocus: candidate.firstFrameFocus,
+            visualContrast: candidate.visualContrast,
+            sensoryTexture: candidate.sensoryTexture,
+            motionPeak: candidate.motionPeak,
+            compositionLighting: candidate.compositionLighting,
+            localNativeDetail: candidate.localNativeDetail,
+            antiFlatness: candidate.antiFlatness,
+        };
+        const signature = JSON.stringify(adaptation);
+        const adaptationRef = `product-${candidate.productIndex}-${createHash("sha256").update(signature).digest("hex").slice(0, 16)}`;
+        if (!adaptations.has(adaptationRef))
+            adaptations.set(adaptationRef, { adaptationRef, ...adaptation });
+        return {
+            ordinal: candidate.ordinal,
+            productIndex: candidate.productIndex,
+            blueprintRef,
+            adaptationRef,
+            variationSeed: candidate.fingerprintKey || `ordinal-${candidate.ordinal}`,
+        };
     });
     return {
-        executionBlueprints: [...blueprints].map(([blueprintRef, executionBlueprint]) => ({ blueprintRef, executionBlueprint })),
-        selectedCandidates,
+        executionBlueprints: [...blueprints.values()],
+        productAdaptations: [...adaptations.values()],
+        ordinalBindings,
     };
 }
 function selectedCandidatePlan(value) {
@@ -730,6 +817,8 @@ function selectedCandidatePlan(value) {
     return {
         visualPremise: value.visualPremise,
         learnedTemplateId: value.learnedTemplateId || null,
+        learnedTemplateSource: value.learnedTemplateSource || null,
+        productIdentityProfile: value.productIdentityProfile || {},
         mutationAxes: value.mutationAxes,
         culturalAnchors: value.culturalAnchors,
         spectacleEscalation: value.spectacleEscalation,
@@ -786,8 +875,22 @@ export function immediateScriptOrdinals(task, receivedOrdinals, candidateOrdinal
     const received = new Set(receivedOrdinals);
     return candidateOrdinals.filter((ordinal) => selected.has(ordinal) && !received.has(ordinal));
 }
-function compactJson(value, limit) {
-    return JSON.stringify(value).slice(0, limit);
+function compactJson(value, limit, label = "prompt JSON") {
+    const serialized = JSON.stringify(value);
+    if (serialized.length > limit)
+        throw new FlowCPromptPayloadTooLargeError(label, serialized.length, limit);
+    return serialized;
+}
+/** Drop only complete optional array entries so the prompt always receives valid JSON. */
+function compactJsonArray(value, limit, label, keep) {
+    const items = [...value];
+    while (items.length > 1 && JSON.stringify(items).length > limit) {
+        if (keep === "last")
+            items.shift();
+        else
+            items.pop();
+    }
+    return compactJson(items, limit, label);
 }
 function scriptProductAssignments(productQuantities, ordinals) {
     const assignments = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaohhhh1/canvas-agent",
-  "version": "0.4.67",
+  "version": "0.4.68",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",