gaoding-cli 1.0.0-alpha.7 → 1.0.0-alpha.8

package/dist/src/creative/contract.d.ts

@@ -0,0 +1,1112 @@
+export declare const CREATIVE_SCHEMA_VERSION: "creative/v1";
+export interface CreativeInput {
+    prompt?: string;
+    media?: CreativeMedia[];
+    parameters?: CreativeParameters;
+    conversation_id?: string;
+    last_tool_message_id?: string;
+    answers?: CreativeAnswer[];
+}
+export interface CreativeMedia {
+    source: string;
+    role: "reference" | "first_frame" | "last_frame";
+}
+export interface CreativeParameters {
+    ratio?: string;
+    resolution?: string;
+    duration_seconds?: number;
+}
+export interface CreativeAnswer {
+    question: string;
+    values: string[];
+}
+export interface CreativeQuestionGroup {
+    title: string;
+    questions: Array<{
+        question: string;
+        options: Array<{
+            label: string;
+        }>;
+        allow_multiple: boolean;
+    }>;
+}
+export type CreativeOutput = {
+    type: "text";
+    text: string;
+} | {
+    type: "json";
+    value: unknown;
+} | {
+    type: "image" | "video" | "audio" | "file";
+    url: string;
+    mime_type: string;
+    name?: string;
+    asset_id?: string;
+    width?: number;
+    height?: number;
+    duration_seconds?: number;
+};
+export interface CreativeResult {
+    conversation_id: string;
+    finish_reason: "completed" | "requires_input";
+    message: string;
+    outputs: CreativeOutput[];
+    last_tool_message_id?: string;
+    questions?: CreativeQuestionGroup;
+}
+export interface CreativeError {
+    code: string;
+    type: "validation" | "auth" | "business" | "network" | "unknown";
+    message: string;
+    hint?: string;
+    retryable?: boolean;
+}
+export interface CreativeEnvelope {
+    status: "completed" | "failed";
+    data: CreativeResult | null;
+    error: CreativeError | null;
+    meta: {
+        command: "creative run";
+        schema_version: typeof CREATIVE_SCHEMA_VERSION;
+    };
+}
+export declare const CREATIVE_INPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://www.gaoding.com/cli/schemas/creative-input-v1.json";
+    readonly title: "Creative Input";
+    readonly description: "发起或继续一次稿定 Creative 创作所需的完整输入。";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly prompt: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "详细描述期望的最终结果，包括主体、用途、内容、风格、场景、构图或镜头，以及必须保留和避免的事项。比例、分辨率、时长等可结构化表达的要求，建议通过 parameters 传入。";
+        };
+        readonly media: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly description: "本次创作使用的输入素材；媒体不能脱离 prompt 或 answers 单独提交。";
+            readonly items: {
+                readonly type: "object";
+                readonly description: "一份带有明确用途的输入素材。";
+                readonly additionalProperties: false;
+                readonly required: readonly ["source", "role"];
+                readonly properties: {
+                    readonly source: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "本地文件路径或可访问的 HTTP(S) URL。";
+                    };
+                    readonly role: {
+                        readonly type: "string";
+                        readonly enum: readonly ["reference", "first_frame", "last_frame"];
+                        readonly description: "素材用途；reference 是参考素材，first_frame 和 last_frame 分别是视频首帧和尾帧。CLI 不根据数组顺序、文件名或 prompt 推断。";
+                    };
+                };
+            };
+        };
+        readonly parameters: {
+            readonly type: "object";
+            readonly description: "可选的结构化创作约束。GD Agent 会优先遵循本字段中的约束；存在对应参数时，建议使用本字段，而不是仅在 prompt 中通过文本描述。";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly ratio: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "期望输出媒体的宽高比，例如 1:1、16:9 或 9:16。";
+                };
+                readonly resolution: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "期望输出媒体的分辨率，例如 720p、1080p、2K 或 4K。";
+                };
+                readonly duration_seconds: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly description: "期望生成视频的时长，单位为秒；仅适用于视频创作。";
+                };
+            };
+        };
+        readonly conversation_id: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "继续已有创作或回答追问时使用的会话标识；首次请求和独立的新创作不传。";
+        };
+        readonly last_tool_message_id: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "正在回答或跳过的追问消息标识，原样使用上一次 requires_input 输出中的值。";
+        };
+        readonly answers: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly description: "对上一次 requires_input 输出中一个或多个问题的结构化回答。";
+            readonly items: {
+                readonly type: "object";
+                readonly description: "对一条 GD Agent 追问的回答。";
+                readonly additionalProperties: false;
+                readonly required: readonly ["question", "values"];
+                readonly properties: {
+                    readonly question: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "必须与上一次输出中的 question 文本一致。";
+                    };
+                    readonly values: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly description: "选择项或自定义回答；推荐 options 不是枚举限制。";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly description: "一项非空的选择值或自定义回答。";
+                        };
+                    };
+                };
+            };
+        };
+    };
+    readonly anyOf: readonly [{
+        readonly description: "普通新创作或连续编辑必须提供 prompt。";
+        readonly required: readonly ["prompt"];
+    }, {
+        readonly description: "回答追问时 answers 可以替代 prompt，但必须同时携带两个连续对话标识。";
+        readonly required: readonly ["answers", "conversation_id", "last_tool_message_id"];
+    }];
+    readonly dependentRequired: {
+        readonly answers: readonly ["conversation_id", "last_tool_message_id"];
+        readonly last_tool_message_id: readonly ["conversation_id"];
+    };
+    readonly allOf: readonly [{
+        readonly description: "first_frame 最多出现一次。";
+        readonly properties: {
+            readonly media: {
+                readonly description: "用于检查首帧数量的素材列表。";
+                readonly contains: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly role: {
+                            readonly const: "first_frame";
+                            readonly description: "首帧素材角色。";
+                        };
+                    };
+                    readonly required: readonly ["role"];
+                };
+                readonly minContains: 0;
+                readonly maxContains: 1;
+            };
+        };
+    }, {
+        readonly description: "last_frame 最多出现一次。";
+        readonly properties: {
+            readonly media: {
+                readonly description: "用于检查尾帧数量的素材列表。";
+                readonly contains: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly role: {
+                            readonly const: "last_frame";
+                            readonly description: "尾帧素材角色。";
+                        };
+                    };
+                    readonly required: readonly ["role"];
+                };
+                readonly minContains: 0;
+                readonly maxContains: 1;
+            };
+        };
+    }];
+};
+export declare const CREATIVE_OUTPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://www.gaoding.com/cli/schemas/creative-output-v1.json";
+    readonly title: "Creative Output";
+    readonly description: "creative run 的统一最终输出；中间事件和内部调用过程不属于本 Schema。";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["status", "data", "error", "meta"];
+    readonly properties: {
+        readonly status: {
+            readonly type: "string";
+            readonly enum: readonly ["completed", "failed"];
+            readonly description: "CLI 调用是否成功；requires_input 仍属于 completed。";
+        };
+        readonly data: {
+            readonly description: "status 为 completed 时存在的 Creative 最终结果；failed 时为 null。";
+            readonly oneOf: readonly [{
+                readonly $ref: "#/$defs/result";
+            }, {
+                readonly type: "null";
+            }];
+        };
+        readonly error: {
+            readonly description: "status 为 failed 时存在的结构化错误；completed 时为 null。";
+            readonly oneOf: readonly [{
+                readonly $ref: "#/$defs/error";
+            }, {
+                readonly type: "null";
+            }];
+        };
+        readonly meta: {
+            readonly type: "object";
+            readonly description: "本次输出对应的命令与公共契约版本。";
+            readonly additionalProperties: false;
+            readonly required: readonly ["command", "schema_version"];
+            readonly properties: {
+                readonly command: {
+                    readonly const: "creative run";
+                    readonly description: "产生本 Envelope 的 GD CLI 命令。";
+                };
+                readonly schema_version: {
+                    readonly const: "creative/v1";
+                    readonly description: "Creative 公共契约版本。";
+                };
+            };
+        };
+    };
+    readonly oneOf: readonly [{
+        readonly description: "成功完成或需要使用者继续回答的结果。";
+        readonly properties: {
+            readonly status: {
+                readonly const: "completed";
+                readonly description: "成功状态。";
+            };
+            readonly data: {
+                readonly $ref: "#/$defs/result";
+                readonly description: "Creative 结果。";
+            };
+            readonly error: {
+                readonly type: "null";
+                readonly description: "成功时没有错误。";
+            };
+        };
+    }, {
+        readonly description: "校验、认证、业务或网络失败的结果。";
+        readonly properties: {
+            readonly status: {
+                readonly const: "failed";
+                readonly description: "失败状态。";
+            };
+            readonly data: {
+                readonly type: "null";
+                readonly description: "失败时没有 Creative 结果。";
+            };
+            readonly error: {
+                readonly $ref: "#/$defs/error";
+                readonly description: "结构化失败信息。";
+            };
+        };
+    }];
+    readonly $defs: {
+        readonly result: {
+            readonly type: "object";
+            readonly description: "GD Agent 本轮的最终结果。";
+            readonly additionalProperties: false;
+            readonly required: readonly ["conversation_id", "finish_reason", "message", "outputs"];
+            readonly properties: {
+                readonly conversation_id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "新请求由 GD Agent 创建；连续请求沿用输入值。";
+                };
+                readonly finish_reason: {
+                    readonly type: "string";
+                    readonly enum: readonly ["completed", "requires_input"];
+                    readonly description: "completed 表示本轮完成；requires_input 表示需要继续回答 questions。";
+                };
+                readonly message: {
+                    readonly type: "string";
+                    readonly description: "GD Agent 面向使用者的最终说明。";
+                };
+                readonly outputs: {
+                    readonly type: "array";
+                    readonly description: "本轮最终产出的文本、结构化数据或媒体。";
+                    readonly items: {
+                        readonly $ref: "#/$defs/output";
+                        readonly description: "一项 Creative 最终产出。";
+                    };
+                };
+                readonly last_tool_message_id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "requires_input 时必填，并在下一次请求中原样回传。";
+                };
+                readonly questions: {
+                    readonly $ref: "#/$defs/question_group";
+                    readonly description: "requires_input 时必填的结构化追问。";
+                };
+            };
+            readonly allOf: readonly [{
+                readonly if: {
+                    readonly properties: {
+                        readonly finish_reason: {
+                            readonly const: "requires_input";
+                            readonly description: "需要使用者回答。";
+                        };
+                    };
+                };
+                readonly then: {
+                    readonly required: readonly ["last_tool_message_id", "questions"];
+                };
+                readonly else: {
+                    readonly not: {
+                        readonly anyOf: readonly [{
+                            readonly required: readonly ["last_tool_message_id"];
+                        }, {
+                            readonly required: readonly ["questions"];
+                        }];
+                    };
+                };
+            }];
+        };
+        readonly question_group: {
+            readonly type: "object";
+            readonly description: "GD Agent 在本轮提出的一组问题。";
+            readonly additionalProperties: false;
+            readonly required: readonly ["title", "questions"];
+            readonly properties: {
+                readonly title: {
+                    readonly type: "string";
+                    readonly description: "本组追问的标题。";
+                };
+                readonly questions: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly description: "需要使用者回答的一个或多个问题。";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly description: "一条 GD Agent 追问。";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["question", "options", "allow_multiple"];
+                        readonly properties: {
+                            readonly question: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "问题文本；提交 answers 时原样作为 answers[].question。";
+                            };
+                            readonly options: {
+                                readonly type: "array";
+                                readonly description: "推荐选项，可以为空；label 不是严格枚举。";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly description: "一项推荐回答。";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["label"];
+                                    readonly properties: {
+                                        readonly label: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                            readonly description: "推荐回答的展示文本。";
+                                        };
+                                    };
+                                };
+                            };
+                            readonly allow_multiple: {
+                                readonly type: "boolean";
+                                readonly description: "是否允许为本问题提交多个回答值。";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly output: {
+            readonly description: "文本、JSON、图片、视频、音频或文件结果。";
+            readonly oneOf: readonly [{
+                readonly type: "object";
+                readonly description: "文本结果。";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type", "text"];
+                readonly properties: {
+                    readonly type: {
+                        readonly const: "text";
+                        readonly description: "结果类型。";
+                    };
+                    readonly text: {
+                        readonly type: "string";
+                        readonly description: "文本内容。";
+                    };
+                };
+            }, {
+                readonly type: "object";
+                readonly description: "可机器解析的结构化结果。";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type", "value"];
+                readonly properties: {
+                    readonly type: {
+                        readonly const: "json";
+                        readonly description: "结果类型。";
+                    };
+                    readonly value: {
+                        readonly description: "任意合法 JSON 值。";
+                    };
+                };
+            }, {
+                readonly type: "object";
+                readonly description: "最终媒体或文件结果。";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type", "url", "mime_type"];
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["image", "video", "audio", "file"];
+                        readonly description: "媒体或文件类型。";
+                    };
+                    readonly url: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly pattern: "^https?://";
+                        readonly description: "可访问或下载结果的 HTTP(S) URL。";
+                    };
+                    readonly mime_type: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "结果的 MIME type，例如 image/png 或 video/mp4。";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "建议的展示名或文件名。";
+                    };
+                    readonly asset_id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "结果已进入 DAM 时的素材标识。";
+                    };
+                    readonly width: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly description: "图片或视频的像素宽度。";
+                    };
+                    readonly height: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly description: "图片或视频的像素高度。";
+                    };
+                    readonly duration_seconds: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly description: "视频或音频的时长，单位为秒。";
+                    };
+                };
+            }];
+        };
+        readonly error: {
+            readonly type: "object";
+            readonly description: "Creative 失败时的稳定错误信息。";
+            readonly additionalProperties: false;
+            readonly required: readonly ["code", "type", "message"];
+            readonly properties: {
+                readonly code: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "稳定、可机器判断的错误码。";
+                };
+                readonly type: {
+                    readonly type: "string";
+                    readonly enum: readonly ["validation", "auth", "business", "network", "unknown"];
+                    readonly description: "错误所属类别。";
+                };
+                readonly message: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "面向使用者的错误说明。";
+                };
+                readonly hint: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "可执行的处理建议。";
+                };
+                readonly retryable: {
+                    readonly type: "boolean";
+                    readonly description: "使用相同输入稍后重试是否可能成功。";
+                };
+            };
+        };
+    };
+};
+export declare function getCreativeSchema(): {
+    schema_version: "creative/v1";
+    input_schema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://www.gaoding.com/cli/schemas/creative-input-v1.json";
+        readonly title: "Creative Input";
+        readonly description: "发起或继续一次稿定 Creative 创作所需的完整输入。";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly prompt: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "详细描述期望的最终结果，包括主体、用途、内容、风格、场景、构图或镜头，以及必须保留和避免的事项。比例、分辨率、时长等可结构化表达的要求，建议通过 parameters 传入。";
+            };
+            readonly media: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly description: "本次创作使用的输入素材；媒体不能脱离 prompt 或 answers 单独提交。";
+                readonly items: {
+                    readonly type: "object";
+                    readonly description: "一份带有明确用途的输入素材。";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["source", "role"];
+                    readonly properties: {
+                        readonly source: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly description: "本地文件路径或可访问的 HTTP(S) URL。";
+                        };
+                        readonly role: {
+                            readonly type: "string";
+                            readonly enum: readonly ["reference", "first_frame", "last_frame"];
+                            readonly description: "素材用途；reference 是参考素材，first_frame 和 last_frame 分别是视频首帧和尾帧。CLI 不根据数组顺序、文件名或 prompt 推断。";
+                        };
+                    };
+                };
+            };
+            readonly parameters: {
+                readonly type: "object";
+                readonly description: "可选的结构化创作约束。GD Agent 会优先遵循本字段中的约束；存在对应参数时，建议使用本字段，而不是仅在 prompt 中通过文本描述。";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly ratio: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "期望输出媒体的宽高比，例如 1:1、16:9 或 9:16。";
+                    };
+                    readonly resolution: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "期望输出媒体的分辨率，例如 720p、1080p、2K 或 4K。";
+                    };
+                    readonly duration_seconds: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly description: "期望生成视频的时长，单位为秒；仅适用于视频创作。";
+                    };
+                };
+            };
+            readonly conversation_id: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "继续已有创作或回答追问时使用的会话标识；首次请求和独立的新创作不传。";
+            };
+            readonly last_tool_message_id: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "正在回答或跳过的追问消息标识，原样使用上一次 requires_input 输出中的值。";
+            };
+            readonly answers: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly description: "对上一次 requires_input 输出中一个或多个问题的结构化回答。";
+                readonly items: {
+                    readonly type: "object";
+                    readonly description: "对一条 GD Agent 追问的回答。";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["question", "values"];
+                    readonly properties: {
+                        readonly question: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly description: "必须与上一次输出中的 question 文本一致。";
+                        };
+                        readonly values: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly description: "选择项或自定义回答；推荐 options 不是枚举限制。";
+                            readonly items: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "一项非空的选择值或自定义回答。";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly anyOf: readonly [{
+            readonly description: "普通新创作或连续编辑必须提供 prompt。";
+            readonly required: readonly ["prompt"];
+        }, {
+            readonly description: "回答追问时 answers 可以替代 prompt，但必须同时携带两个连续对话标识。";
+            readonly required: readonly ["answers", "conversation_id", "last_tool_message_id"];
+        }];
+        readonly dependentRequired: {
+            readonly answers: readonly ["conversation_id", "last_tool_message_id"];
+            readonly last_tool_message_id: readonly ["conversation_id"];
+        };
+        readonly allOf: readonly [{
+            readonly description: "first_frame 最多出现一次。";
+            readonly properties: {
+                readonly media: {
+                    readonly description: "用于检查首帧数量的素材列表。";
+                    readonly contains: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly role: {
+                                readonly const: "first_frame";
+                                readonly description: "首帧素材角色。";
+                            };
+                        };
+                        readonly required: readonly ["role"];
+                    };
+                    readonly minContains: 0;
+                    readonly maxContains: 1;
+                };
+            };
+        }, {
+            readonly description: "last_frame 最多出现一次。";
+            readonly properties: {
+                readonly media: {
+                    readonly description: "用于检查尾帧数量的素材列表。";
+                    readonly contains: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly role: {
+                                readonly const: "last_frame";
+                                readonly description: "尾帧素材角色。";
+                            };
+                        };
+                        readonly required: readonly ["role"];
+                    };
+                    readonly minContains: 0;
+                    readonly maxContains: 1;
+                };
+            };
+        }];
+    };
+    output_schema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://www.gaoding.com/cli/schemas/creative-output-v1.json";
+        readonly title: "Creative Output";
+        readonly description: "creative run 的统一最终输出；中间事件和内部调用过程不属于本 Schema。";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["status", "data", "error", "meta"];
+        readonly properties: {
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["completed", "failed"];
+                readonly description: "CLI 调用是否成功；requires_input 仍属于 completed。";
+            };
+            readonly data: {
+                readonly description: "status 为 completed 时存在的 Creative 最终结果；failed 时为 null。";
+                readonly oneOf: readonly [{
+                    readonly $ref: "#/$defs/result";
+                }, {
+                    readonly type: "null";
+                }];
+            };
+            readonly error: {
+                readonly description: "status 为 failed 时存在的结构化错误；completed 时为 null。";
+                readonly oneOf: readonly [{
+                    readonly $ref: "#/$defs/error";
+                }, {
+                    readonly type: "null";
+                }];
+            };
+            readonly meta: {
+                readonly type: "object";
+                readonly description: "本次输出对应的命令与公共契约版本。";
+                readonly additionalProperties: false;
+                readonly required: readonly ["command", "schema_version"];
+                readonly properties: {
+                    readonly command: {
+                        readonly const: "creative run";
+                        readonly description: "产生本 Envelope 的 GD CLI 命令。";
+                    };
+                    readonly schema_version: {
+                        readonly const: "creative/v1";
+                        readonly description: "Creative 公共契约版本。";
+                    };
+                };
+            };
+        };
+        readonly oneOf: readonly [{
+            readonly description: "成功完成或需要使用者继续回答的结果。";
+            readonly properties: {
+                readonly status: {
+                    readonly const: "completed";
+                    readonly description: "成功状态。";
+                };
+                readonly data: {
+                    readonly $ref: "#/$defs/result";
+                    readonly description: "Creative 结果。";
+                };
+                readonly error: {
+                    readonly type: "null";
+                    readonly description: "成功时没有错误。";
+                };
+            };
+        }, {
+            readonly description: "校验、认证、业务或网络失败的结果。";
+            readonly properties: {
+                readonly status: {
+                    readonly const: "failed";
+                    readonly description: "失败状态。";
+                };
+                readonly data: {
+                    readonly type: "null";
+                    readonly description: "失败时没有 Creative 结果。";
+                };
+                readonly error: {
+                    readonly $ref: "#/$defs/error";
+                    readonly description: "结构化失败信息。";
+                };
+            };
+        }];
+        readonly $defs: {
+            readonly result: {
+                readonly type: "object";
+                readonly description: "GD Agent 本轮的最终结果。";
+                readonly additionalProperties: false;
+                readonly required: readonly ["conversation_id", "finish_reason", "message", "outputs"];
+                readonly properties: {
+                    readonly conversation_id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "新请求由 GD Agent 创建；连续请求沿用输入值。";
+                    };
+                    readonly finish_reason: {
+                        readonly type: "string";
+                        readonly enum: readonly ["completed", "requires_input"];
+                        readonly description: "completed 表示本轮完成；requires_input 表示需要继续回答 questions。";
+                    };
+                    readonly message: {
+                        readonly type: "string";
+                        readonly description: "GD Agent 面向使用者的最终说明。";
+                    };
+                    readonly outputs: {
+                        readonly type: "array";
+                        readonly description: "本轮最终产出的文本、结构化数据或媒体。";
+                        readonly items: {
+                            readonly $ref: "#/$defs/output";
+                            readonly description: "一项 Creative 最终产出。";
+                        };
+                    };
+                    readonly last_tool_message_id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "requires_input 时必填，并在下一次请求中原样回传。";
+                    };
+                    readonly questions: {
+                        readonly $ref: "#/$defs/question_group";
+                        readonly description: "requires_input 时必填的结构化追问。";
+                    };
+                };
+                readonly allOf: readonly [{
+                    readonly if: {
+                        readonly properties: {
+                            readonly finish_reason: {
+                                readonly const: "requires_input";
+                                readonly description: "需要使用者回答。";
+                            };
+                        };
+                    };
+                    readonly then: {
+                        readonly required: readonly ["last_tool_message_id", "questions"];
+                    };
+                    readonly else: {
+                        readonly not: {
+                            readonly anyOf: readonly [{
+                                readonly required: readonly ["last_tool_message_id"];
+                            }, {
+                                readonly required: readonly ["questions"];
+                            }];
+                        };
+                    };
+                }];
+            };
+            readonly question_group: {
+                readonly type: "object";
+                readonly description: "GD Agent 在本轮提出的一组问题。";
+                readonly additionalProperties: false;
+                readonly required: readonly ["title", "questions"];
+                readonly properties: {
+                    readonly title: {
+                        readonly type: "string";
+                        readonly description: "本组追问的标题。";
+                    };
+                    readonly questions: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly description: "需要使用者回答的一个或多个问题。";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly description: "一条 GD Agent 追问。";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["question", "options", "allow_multiple"];
+                            readonly properties: {
+                                readonly question: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly description: "问题文本；提交 answers 时原样作为 answers[].question。";
+                                };
+                                readonly options: {
+                                    readonly type: "array";
+                                    readonly description: "推荐选项，可以为空；label 不是严格枚举。";
+                                    readonly items: {
+                                        readonly type: "object";
+                                        readonly description: "一项推荐回答。";
+                                        readonly additionalProperties: false;
+                                        readonly required: readonly ["label"];
+                                        readonly properties: {
+                                            readonly label: {
+                                                readonly type: "string";
+                                                readonly minLength: 1;
+                                                readonly description: "推荐回答的展示文本。";
+                                            };
+                                        };
+                                    };
+                                };
+                                readonly allow_multiple: {
+                                    readonly type: "boolean";
+                                    readonly description: "是否允许为本问题提交多个回答值。";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            readonly output: {
+                readonly description: "文本、JSON、图片、视频、音频或文件结果。";
+                readonly oneOf: readonly [{
+                    readonly type: "object";
+                    readonly description: "文本结果。";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["type", "text"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "text";
+                            readonly description: "结果类型。";
+                        };
+                        readonly text: {
+                            readonly type: "string";
+                            readonly description: "文本内容。";
+                        };
+                    };
+                }, {
+                    readonly type: "object";
+                    readonly description: "可机器解析的结构化结果。";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["type", "value"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "json";
+                            readonly description: "结果类型。";
+                        };
+                        readonly value: {
+                            readonly description: "任意合法 JSON 值。";
+                        };
+                    };
+                }, {
+                    readonly type: "object";
+                    readonly description: "最终媒体或文件结果。";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["type", "url", "mime_type"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["image", "video", "audio", "file"];
+                            readonly description: "媒体或文件类型。";
+                        };
+                        readonly url: {
+                            readonly type: "string";
+                            readonly format: "uri";
+                            readonly pattern: "^https?://";
+                            readonly description: "可访问或下载结果的 HTTP(S) URL。";
+                        };
+                        readonly mime_type: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly description: "结果的 MIME type，例如 image/png 或 video/mp4。";
+                        };
+                        readonly name: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly description: "建议的展示名或文件名。";
+                        };
+                        readonly asset_id: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly description: "结果已进入 DAM 时的素材标识。";
+                        };
+                        readonly width: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                            readonly description: "图片或视频的像素宽度。";
+                        };
+                        readonly height: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                            readonly description: "图片或视频的像素高度。";
+                        };
+                        readonly duration_seconds: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                            readonly description: "视频或音频的时长，单位为秒。";
+                        };
+                    };
+                }];
+            };
+            readonly error: {
+                readonly type: "object";
+                readonly description: "Creative 失败时的稳定错误信息。";
+                readonly additionalProperties: false;
+                readonly required: readonly ["code", "type", "message"];
+                readonly properties: {
+                    readonly code: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "稳定、可机器判断的错误码。";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["validation", "auth", "business", "network", "unknown"];
+                        readonly description: "错误所属类别。";
+                    };
+                    readonly message: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "面向使用者的错误说明。";
+                    };
+                    readonly hint: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "可执行的处理建议。";
+                    };
+                    readonly retryable: {
+                        readonly type: "boolean";
+                        readonly description: "使用相同输入稍后重试是否可能成功。";
+                    };
+                };
+            };
+        };
+    };
+};
+export declare const CREATIVE_EXAMPLES: {
+    readonly examples: readonly [{
+        readonly name: "text_creation";
+        readonly description: "纯文本创作";
+        readonly input: {
+            readonly prompt: "为一款轻量缓震跑鞋写三条电商主图标题，语言简洁有力。";
+        };
+    }, {
+        readonly name: "image_with_reference";
+        readonly description: "使用参考图创作图片";
+        readonly input: {
+            readonly prompt: "以产品为主体生成一张户外晨跑场景广告图，保持鞋款外观和配色。";
+            readonly media: readonly [{
+                readonly source: "./product.png";
+                readonly role: "reference";
+            }];
+            readonly parameters: {
+                readonly ratio: "1:1";
+                readonly resolution: "2K";
+            };
+        };
+    }, {
+        readonly name: "video_with_first_and_last_frames";
+        readonly description: "使用首尾帧创作视频";
+        readonly input: {
+            readonly prompt: "生成从清晨城市街道过渡到终点冲线的运动广告视频，镜头运动自然。";
+            readonly media: readonly [{
+                readonly source: "./first-frame.png";
+                readonly role: "first_frame";
+            }, {
+                readonly source: "./last-frame.png";
+                readonly role: "last_frame";
+            }];
+            readonly parameters: {
+                readonly ratio: "16:9";
+                readonly resolution: "1080p";
+                readonly duration_seconds: 5;
+            };
+        };
+    }, {
+        readonly name: "continue_creation";
+        readonly description: "继续修改已有创作";
+        readonly input: {
+            readonly conversation_id: "conversation_123";
+            readonly prompt: "保留主体和构图，把整体风格调整得更克制，并降低背景饱和度。";
+        };
+    }, {
+        readonly name: "answer_questions";
+        readonly description: "回答 GD Agent 的结构化追问";
+        readonly input: {
+            readonly conversation_id: "conversation_123";
+            readonly last_tool_message_id: "message_456";
+            readonly answers: readonly [{
+                readonly question: "希望采用什么视觉风格？";
+                readonly values: readonly ["极简"];
+            }, {
+                readonly question: "主要投放到哪些渠道？";
+                readonly values: readonly ["电商详情页", "社交媒体"];
+            }];
+        };
+    }];
+};
+export declare function getCreativeExamples(): {
+    readonly examples: readonly [{
+        readonly name: "text_creation";
+        readonly description: "纯文本创作";
+        readonly input: {
+            readonly prompt: "为一款轻量缓震跑鞋写三条电商主图标题，语言简洁有力。";
+        };
+    }, {
+        readonly name: "image_with_reference";
+        readonly description: "使用参考图创作图片";
+        readonly input: {
+            readonly prompt: "以产品为主体生成一张户外晨跑场景广告图，保持鞋款外观和配色。";
+            readonly media: readonly [{
+                readonly source: "./product.png";
+                readonly role: "reference";
+            }];
+            readonly parameters: {
+                readonly ratio: "1:1";
+                readonly resolution: "2K";
+            };
+        };
+    }, {
+        readonly name: "video_with_first_and_last_frames";
+        readonly description: "使用首尾帧创作视频";
+        readonly input: {
+            readonly prompt: "生成从清晨城市街道过渡到终点冲线的运动广告视频，镜头运动自然。";
+            readonly media: readonly [{
+                readonly source: "./first-frame.png";
+                readonly role: "first_frame";
+            }, {
+                readonly source: "./last-frame.png";
+                readonly role: "last_frame";
+            }];
+            readonly parameters: {
+                readonly ratio: "16:9";
+                readonly resolution: "1080p";
+                readonly duration_seconds: 5;
+            };
+        };
+    }, {
+        readonly name: "continue_creation";
+        readonly description: "继续修改已有创作";
+        readonly input: {
+            readonly conversation_id: "conversation_123";
+            readonly prompt: "保留主体和构图，把整体风格调整得更克制，并降低背景饱和度。";
+        };
+    }, {
+        readonly name: "answer_questions";
+        readonly description: "回答 GD Agent 的结构化追问";
+        readonly input: {
+            readonly conversation_id: "conversation_123";
+            readonly last_tool_message_id: "message_456";
+            readonly answers: readonly [{
+                readonly question: "希望采用什么视觉风格？";
+                readonly values: readonly ["极简"];
+            }, {
+                readonly question: "主要投放到哪些渠道？";
+                readonly values: readonly ["电商详情页", "社交媒体"];
+            }];
+        };
+    }];
+};
+export declare function validateCreativeInput(value: unknown): CreativeInput;