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

package/dist/src/api/direct-client.d.ts

@@ -1,4 +1,5 @@
 import { CredentialStoreV2 } from "../auth/credential-store-v2.js";
+import { type AuthGuardLike } from "../core/auth/auth-guard.js";
 type QueryValue = string | number | boolean | readonly (string | number | boolean)[] | undefined;
 export interface DirectRequestOptions {
     query?: Record<string, QueryValue>;
@@ -13,10 +14,16 @@ export declare class DirectApiError extends Error {
 }
 export declare class DirectApiClient {
     private baseUrl;
-    private storeV2;
-    constructor(baseUrl?: string, storeV2?: CredentialStoreV2);
+    private authGuard;
+    constructor(baseUrl?: string, storeV2?: CredentialStoreV2, authGuard?: AuthGuardLike);
     get<T>(path: string, options?: DirectRequestOptions): Promise<T>;
     post<T>(path: string, body?: unknown, options?: DirectRequestOptions): Promise<T>;
+    /**
+     * Start a streaming POST and leave the response body untouched for the
+     * caller. JSON requests use `post`; Creative uses this method for the
+     * Editor-compatible completion stream.
+     */
+    postStream(path: string, body?: unknown, options?: DirectRequestOptions): Promise<Response>;
     delete<T>(path: string, options?: DirectRequestOptions): Promise<T>;
     private request;
     private attachAuthHeaders;

package/dist/src/api/direct-client.js

@@ -1,7 +1,6 @@
-import chalk from "chalk";
 import { CredentialStoreV2 } from "../auth/credential-store-v2.js";
+import { AuthGuard, } from "../core/auth/auth-guard.js";
 import { signApiRequest } from "../core/auth/signature.js";
-import { isCredentialsV2 } from "../core/auth/types.js";
 import { CLI_USER_AGENT, resolveApiBase, resolveEndpoints } from "../utils/config.js";
 import { readEnv } from "./direct-auth.js";
 import { redactSensitiveText } from "../utils/redact.js";
@@ -20,10 +19,10 @@ export class DirectApiError extends Error {
 }
 export class DirectApiClient {
     baseUrl;
-    storeV2;
-    constructor(baseUrl = resolveApiBase(), storeV2 = new CredentialStoreV2()) {
+    authGuard;
+    constructor(baseUrl = resolveApiBase(), storeV2 = new CredentialStoreV2(), authGuard = new AuthGuard({ store: storeV2 })) {
         this.baseUrl = normalizeBaseUrl(baseUrl);
-        this.storeV2 = storeV2;
+        this.authGuard = authGuard;
     }
     async get(path, options) {
         return this.request("GET", path, undefined, options);
@@ -31,6 +30,39 @@ export class DirectApiClient {
     async post(path, body, options) {
         return this.request("POST", path, body, options);
     }
+    /**
+     * Start a streaming POST and leave the response body untouched for the
+     * caller. JSON requests use `post`; Creative uses this method for the
+     * Editor-compatible completion stream.
+     */
+    async postStream(path, body, options = {}) {
+        const url = buildUrl(this.baseUrl, path, options.query);
+        const headers = new Headers({
+            Accept: "text/event-stream",
+            "User-Agent": CLI_USER_AGENT,
+            ...defaultBusinessHeaders(this.baseUrl),
+            ...(options.headers ?? {}),
+        });
+        if (body !== undefined) {
+            headers.set("Content-Type", "application/json");
+        }
+        if (options.auth !== false) {
+            await this.attachAuthHeaders(headers, "POST", url);
+        }
+        const response = await fetch(url.toString(), {
+            method: "POST",
+            headers,
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const parsed = await parseResponse(response);
+            throw new DirectApiError(response.status, parsed, url.toString());
+        }
+        if (!response.body) {
+            throw new DirectApiError(response.status, { message: "流式接口没有返回响应 body" }, url.toString());
+        }
+        return response;
+    }
     async delete(path, options) {
         return this.request("DELETE", path, undefined, options);
     }
@@ -60,20 +92,15 @@ export class DirectApiClient {
         return parsed;
     }
     async attachAuthHeaders(headers, method, url) {
-        const v2 = this.storeV2.read();
-        if (v2 && isCredentialsV2(v2)) {
-            if (!v2.current_org?.id) {
-                throw new Error(chalk.yellow("当前未绑定组织：请先执行 gd-cli org switch\n"));
-            }
-            const { signature, timestamp } = signApiRequest(method, url.pathname, url.searchParams.toString(), v2.sk);
-            headers.set("X-AccessKey", v2.ak);
-            headers.set("X-Signature", signature);
-            headers.set("X-Timestamp", timestamp);
-            headers.set("X-Org-Id", v2.current_org.id);
-            return;
+        const credentials = await this.authGuard.ensure("current-org");
+        if (!credentials?.current_org?.id) {
+            throw new Error("AuthGuard 未返回当前组织凭证。");
         }
-        console.log("");
-        throw new Error(chalk.yellow("先登录并绑定组织：gd-cli auth login\n"));
+        const { signature, timestamp } = signApiRequest(method, url.pathname, url.searchParams.toString(), credentials.sk);
+        headers.set("X-AccessKey", credentials.ak);
+        headers.set("X-Signature", signature);
+        headers.set("X-Timestamp", timestamp);
+        headers.set("X-Org-Id", credentials.current_org.id);
     }
 }
 export function unwrapEnvelope(value) {

package/dist/src/api/hub-client.d.ts

@@ -1,20 +1,23 @@
 import { CredentialStoreV2 } from "../auth/credential-store-v2.js";
+import { type AuthGuardLike } from "../core/auth/auth-guard.js";
 export declare class HubClient {
     private baseUrl;
-    private storeV2;
-    constructor(baseUrl?: string, storeV2?: CredentialStoreV2);
-    get<T>(path: string, options?: {
-        auth?: boolean;
-    }): Promise<T>;
-    post<T>(path: string, body?: unknown, options?: {
-        auth?: boolean;
-    }): Promise<T>;
+    private authGuard;
+    constructor(baseUrl?: string, storeV2?: CredentialStoreV2, authGuard?: AuthGuardLike);
+    get<T>(path: string, options?: HubRequestOptions): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: HubRequestOptions): Promise<T>;
     private request;
     private attachAuthHeaders;
 }
+export interface HubRequestOptions {
+    auth?: boolean;
+    authRequirement?: AuthenticatedRequirement;
+}
+type AuthenticatedRequirement = "credential" | "current-org";
 export declare class ApiError extends Error {
     statusCode: number;
     body: string;
     path: string;
     constructor(statusCode: number, body: string, path: string);
 }
+export {};

package/dist/src/api/hub-client.js

@@ -1,6 +1,6 @@
 import { CredentialStoreV2 } from "../auth/credential-store-v2.js";
 import { resolveApiBase, CLI_USER_AGENT } from "../utils/config.js";
-import { isCredentialsV2 } from "../core/auth/types.js";
+import { AuthGuard, } from "../core/auth/auth-guard.js";
 import { signApiRequest } from "../core/auth/signature.js";
 import { redactSensitiveText } from "../utils/redact.js";
 function collectErrorCodes(err, out) {
@@ -27,10 +27,10 @@ function fetchFailureHint(baseUrl, requestUrl) {
 }
 export class HubClient {
     baseUrl;
-    storeV2;
-    constructor(baseUrl, storeV2) {
+    authGuard;
+    constructor(baseUrl, storeV2 = new CredentialStoreV2(), authGuard = new AuthGuard({ store: storeV2 })) {
         this.baseUrl = baseUrl ?? resolveApiBase();
-        this.storeV2 = storeV2 ?? new CredentialStoreV2();
+        this.authGuard = authGuard;
     }
     async get(path, options) {
         return this.request("GET", path, undefined, options);
@@ -46,7 +46,7 @@ export class HubClient {
         };
         const needsAuth = options?.auth !== false;
         if (needsAuth) {
-            await this.attachAuthHeaders(headers, method, path);
+            await this.attachAuthHeaders(headers, method, path, options?.authRequirement ?? "current-org");
         }
         let response;
         try {
@@ -69,20 +69,19 @@ export class HubClient {
         }
         return response.json();
     }
-    async attachAuthHeaders(headers, method, path) {
-        const v2 = this.storeV2.read();
-        if (v2 && isCredentialsV2(v2)) {
-            const url = new URL(path.replace(/^\//, ""), `${this.baseUrl.replace(/\/$/, "")}/`);
-            const { signature, timestamp } = signApiRequest(method, url.pathname, url.searchParams.toString(), v2.sk);
-            headers["X-AccessKey"] = v2.ak;
-            headers["X-Signature"] = signature;
-            headers["X-Timestamp"] = timestamp;
-            if (v2.current_org?.id) {
-                headers["X-Org-Id"] = v2.current_org.id;
-            }
-            return;
+    async attachAuthHeaders(headers, method, path, requirement) {
+        const credentials = await this.authGuard.ensure(requirement);
+        if (!credentials) {
+            throw new Error("AuthGuard 未返回签名凭证。");
+        }
+        const url = new URL(path.replace(/^\//, ""), `${this.baseUrl.replace(/\/$/, "")}/`);
+        const { signature, timestamp } = signApiRequest(method, url.pathname, url.searchParams.toString(), credentials.sk);
+        headers["X-AccessKey"] = credentials.ak;
+        headers["X-Signature"] = signature;
+        headers["X-Timestamp"] = timestamp;
+        if (requirement === "current-org" && credentials.current_org?.id) {
+            headers["X-Org-Id"] = credentials.current_org.id;
         }
-        throw new Error("AK/SK 模式需要先登录并绑定组织：\n  gd-cli auth login\n  gd-cli org switch --org <org-id>");
     }
 }
 export class ApiError extends Error {

package/dist/src/api/usage-client.d.ts

@@ -1,4 +1,5 @@
 import { CredentialStoreV2 } from "../auth/credential-store-v2.js";
+import { type AuthGuardLike } from "../core/auth/auth-guard.js";
 declare const RIGHTS_OVERVIEW_ENDPOINT = "/trade/rights-overview";
 declare const GAODOU = "GAODOU";
 export interface UsageCredits {
@@ -28,12 +29,11 @@ interface DirectGetClient {
     }): Promise<T>;
 }
 export declare class UsageClient {
-    private store;
-    private client;
-    constructor(store?: CredentialStoreV2, client?: DirectGetClient);
+    private readonly client;
+    private readonly authGuard;
+    constructor(store?: CredentialStoreV2, client?: DirectGetClient, authGuard?: AuthGuardLike);
     getCreditsOverview(): Promise<UsageOverview>;
     private fetchRightsOverview;
-    private readUsableCredentials;
 }
 export declare function normalizeUsageCredits(response: unknown): UsageCredits;
 export {};

package/dist/src/api/usage-client.js

@@ -1,17 +1,21 @@
 import { CredentialStoreV2 } from "../auth/credential-store-v2.js";
+import { AuthGuard, } from "../core/auth/auth-guard.js";
 import { CliUsageError } from "../core/output/cli-error.js";
 import { DirectApiClient, DirectApiError } from "./direct-client.js";
 const RIGHTS_OVERVIEW_ENDPOINT = "/trade/rights-overview";
 const GAODOU = "GAODOU";
 export class UsageClient {
-    store;
     client;
-    constructor(store = new CredentialStoreV2(), client = new DirectApiClient(undefined, store)) {
-        this.store = store;
-        this.client = client;
+    authGuard;
+    constructor(store = new CredentialStoreV2(), client, authGuard = new AuthGuard({ store })) {
+        this.authGuard = authGuard;
+        this.client = client ?? new DirectApiClient(undefined, store, authGuard);
     }
     async getCreditsOverview() {
-        const credentials = this.readUsableCredentials();
+        const credentials = await this.authGuard.ensure("current-org");
+        if (!credentials?.current_org?.id) {
+            throw new Error("AuthGuard 未返回当前组织凭证。");
+        }
         const response = await this.fetchRightsOverview();
         return {
             status: "completed",
@@ -53,50 +57,6 @@ export class UsageClient {
             throw error;
         }
     }
-    readUsableCredentials() {
-        const credentials = this.store.read();
-        if (!credentials) {
-            throw new CliUsageError({
-                code: "AUTH_MISSING",
-                type: "auth",
-                message: "未找到 AK/SK 凭证，请先登录。",
-                hint: "请先登录：gd-cli auth login",
-                retryable: false,
-                next_steps: ["gd-cli auth login"],
-            });
-        }
-        if (this.store.isAkExpired()) {
-            throw new CliUsageError({
-                code: "AUTH_EXPIRED",
-                type: "auth",
-                message: "AK/SK 凭证已过期，请重新登录。",
-                hint: "请重新登录：gd-cli auth login",
-                retryable: false,
-                next_steps: ["gd-cli auth login"],
-            });
-        }
-        if (!credentials.current_org?.id) {
-            throw new CliUsageError({
-                code: "ORG_REQUIRED",
-                type: "auth",
-                message: "当前未绑定组织，无法查询稿豆余额。",
-                hint: "请先切换组织：gd-cli org switch",
-                retryable: false,
-                next_steps: ["gd-cli org list", "gd-cli org switch"],
-            });
-        }
-        if (this.store.isBindExpired()) {
-            throw new CliUsageError({
-                code: "ORG_BIND_EXPIRED",
-                type: "auth",
-                message: "当前组织绑定已过期，无法查询稿豆余额。",
-                hint: "请重新切换组织：gd-cli org switch",
-                retryable: false,
-                next_steps: ["gd-cli org switch"],
-            });
-        }
-        return credentials;
-    }
 }
 export function normalizeUsageCredits(response) {
     const record = findGaodouRecord(response) ?? {};

package/dist/src/auth/credential-store-v2.d.ts

@@ -8,5 +8,4 @@ export declare class CredentialStoreV2 {
     write(credentials: CredentialsV2): void;
     delete(): void;
     isAkExpired(): boolean;
-    isBindExpired(): boolean;
 }

package/dist/src/auth/credential-store-v2.js

@@ -50,10 +50,4 @@ export class CredentialStoreV2 {
             return true;
         return new Date(creds.expires_at) <= new Date();
     }
-    isBindExpired() {
-        const creds = this.read();
-        if (!creds?.current_org?.bind_expires_at)
-            return false;
-        return new Date(creds.current_org.bind_expires_at) <= new Date();
-    }
 }

package/dist/src/commands/auth.js

@@ -3,10 +3,8 @@ import { withErrorHandler } from "../middleware/error-handler.js";
 import { createAuthProvider } from "../core/auth/auth-provider.js";
 import { CredentialStoreV2 } from "../auth/credential-store-v2.js";
 import { resolveEndpoints, isVerbose, isDebug } from "../utils/config.js";
-import { getIO } from "../io.js";
 import { emitJson, wrapEnvelope } from "../core/output/envelope.js";
-import { setStaticHelp } from "../utils/static-help.js";
-import { resolveInvokeOutputFormat } from "../utils/list-output-format.js";
+import { setAuthRequirement } from "../middleware/auth.js";
 const loginAction = withErrorHandler(async (options) => {
     if (isVerbose() || isDebug()) {
         const ep = resolveEndpoints();
@@ -14,36 +12,21 @@ const loginAction = withErrorHandler(async (options) => {
     }
     const provider = await createAuthProvider();
     const result = await provider.login({
-        orgId: options.org,
-        noBrowser: !!options.noBrowser,
-        scope: options.scope,
-        env: options.env,
+        noBrowser: options.browser === false,
     });
-    const io = getIO();
-    if (io.prefersJsonOutput()) {
-        emitJson(wrapEnvelope({
-            mode: provider.mode,
-            logged_in: true,
-            user: result.credentials.user,
-            org: result.org,
-            next_steps: result.org ? [] : ["gd-cli org switch"],
-        }, { command: "auth login" }));
-        return;
-    }
     console.log(chalk.green("\n✓ 授权成功，可以开始使用稿定能力进行创意生产\n"));
     if (!result.org) {
-        console.log(chalk.yellow("  未获取到授权团队，请执行 gd-cli org switch 后再调用 Workflows / Tools / DAM。"));
+        console.log(chalk.yellow("  尚未选择当前组织，请执行 gd-cli org switch 后再调用 Creative / Workflows / DAM。"));
     }
 });
 const statusAction = withErrorHandler(async (_opts, command) => {
     const cmd = command;
-    const format = resolveInvokeOutputFormat(cmd);
-    const io = getIO();
+    const json = cmd.opts().json === true;
     const store = new CredentialStoreV2();
     const creds = store.read();
     const ep = resolveEndpoints();
     if (!creds) {
-        if (io.prefersJsonOutput(format)) {
+        if (json) {
             emitJson(wrapEnvelope({
                 logged_in: false,
                 environment: { active: ep.active_env },
@@ -56,7 +39,7 @@ const statusAction = withErrorHandler(async (_opts, command) => {
         return;
     }
     const payload = buildStatusPayload(creds, store);
-    if (io.prefersJsonOutput(format)) {
+    if (json) {
         emitJson(wrapEnvelope(payload, { command: "auth status" }));
         return;
     }
@@ -66,54 +49,39 @@ const logoutAction = withErrorHandler(async () => {
     const provider = await createAuthProvider();
     await provider.logout();
     new CredentialStoreV2().delete();
-    const io = getIO();
-    if (io.prefersJsonOutput()) {
-        emitJson(wrapEnvelope({ logged_out: true }, { command: "auth logout" }));
-        return;
-    }
     console.log(chalk.green("✓ 已取消授权，可以重新执行 gd-cli auth login 进行授权。\n"));
 });
 export function registerAuthCommand(program) {
     const auth = program
         .command("auth")
         .description("登录、退出、查看登录状态");
-    setStaticHelp(auth, AUTH_HELP);
-    auth
+    const login = auth
         .command("login")
         .description("浏览器/扫码授权登录")
-        .option("--org <org-id>", "登录后直接绑定该组织")
-        .option("--env <env>", "环境标识 cursor / claude / ci")
-        .option("--scope <scope>", "授权范围，逗号分隔")
         .option("--no-browser", "不自动打开浏览器")
         .action(loginAction);
-    auth
+    setAuthRequirement(login, "none");
+    const logout = auth
         .command("logout")
         .description("取消授权")
         .action(logoutAction);
-    auth.command("status").description("查看授权状态").action(statusAction);
+    setAuthRequirement(logout, "none");
+    const status = auth
+        .command("status")
+        .description("查看授权状态")
+        .option("--json", "输出机器可读 JSON")
+        .action(statusAction);
+    setAuthRequirement(status, "none");
 }
-const AUTH_HELP = `
-Usage: gd-cli auth [options] [command]
-
-登录、退出、查看登录状态
-
-Commands:
-  login             浏览器/扫码授权登录
-  logout            取消授权
-  status            查看授权状态
-`;
 function buildStatusPayload(creds, store) {
     const ep = resolveEndpoints();
     const credentialExpired = store.isAkExpired();
-    const orgBindExpired = store.isBindExpired();
     const envMatches = !creds.issued_for_env || creds.issued_for_env === ep.active_env;
     const nextSteps = [];
     if (credentialExpired)
         nextSteps.push("gd-cli auth login");
     if (!creds.current_org?.id)
         nextSteps.push("gd-cli org list", "gd-cli org switch");
-    if (orgBindExpired)
-        nextSteps.push("gd-cli org switch");
     if (!envMatches)
         nextSteps.push("gd-cli auth login");
     const payload = {
@@ -131,8 +99,6 @@ function buildStatusPayload(creds, store) {
             ? {
                 id: creds.current_org.id,
                 name: creds.current_org.name,
-                bind_expires_at: creds.current_org.bind_expires_at ?? null,
-                bind_valid: !orgBindExpired,
             }
             : null,
         credential: {
@@ -170,12 +136,10 @@ function printStatusHuman(payload) {
         console.log(`  用户:      ${account.name ?? account.user_id}`);
     }
     if (organization) {
-        const valid = organization.bind_valid ? "有效" : "已过期";
         console.log(`  当前组织:  ${organization.name} (${organization.id})`);
-        console.log(`  组织绑定:  ${valid}${organization.bind_expires_at ? `，至 ${organization.bind_expires_at}` : ""}`);
     }
     else {
-        console.log(chalk.yellow("  当前组织:  未绑定"));
+        console.log(chalk.yellow("  当前组织:  未选择"));
     }
     console.log(`  凭证:      AK/SK ${credential.ak_preview}，${credential.valid ? "有效" : "已过期"}`);
     console.log(`  过期时间:  ${credential.expires_at}`);

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

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+import { CreativeClient } from "../api/creative-client.js";
+export interface CreativeCommandDeps {
+    createClient?: () => Pick<CreativeClient, "run">;
+    readInput?: (ref: string) => Promise<Record<string, unknown>>;
+}
+export declare function registerCreativeCommand(program: Command, deps?: CreativeCommandDeps): void;
+export declare function runCreative(options: Record<string, unknown>, command: Command, deps?: CreativeCommandDeps): Promise<void>;

package/dist/src/commands/creative.js

@@ -0,0 +1,178 @@
+import chalk from "chalk";
+import { CreativeClient } from "../api/creative-client.js";
+import { CliUsageError } from "../core/output/cli-error.js";
+import { formatOutput } from "../middleware/output.js";
+import { jsonFailureEnvelopeFor, setJsonFailureProjector, } from "../middleware/error-handler.js";
+import { getCreativeExamples, getCreativeSchema, validateCreativeInput, } from "../creative/contract.js";
+import { readJsonInput } from "../utils/input-json.js";
+import { setAuthRequirement } from "../middleware/auth.js";
+const CREATIVE_FAILURE_META = {
+    command: "creative run",
+    schema_version: "creative/v1",
+};
+export function registerCreativeCommand(program, deps = {}) {
+    const creative = program
+        .command("creative")
+        .usage("<command> [options]")
+        .description("通过稿定 Creative 完成图片、视频和文本创作");
+    const run = creative
+        .command("run")
+        .usage("[options]")
+        .description("发起创作、继续已有创作或回答追问")
+        .option("--prompt <text>", "详细描述期望的最终结果")
+        .option("--input <path>", "从 JSON 文件读取完整输入；传 - 表示读取 stdin")
+        .option("--json", "输出机器可读 JSON")
+        .action(async (options, command) => {
+        await runCreative(options, command, deps);
+    });
+    setJsonFailureProjector(run, creativeFailureEnvelope);
+    setAuthRequirement(run, "current-org");
+    const schema = creative
+        .command("schema")
+        .description("查看 Creative 输入与输出 JSON Schema")
+        .option("--json", "输出完整 JSON Schema")
+        .action((_options, command) => {
+        const payload = getCreativeSchema();
+        if (command.opts().json === true) {
+            formatOutput(payload, "json");
+            return;
+        }
+        console.log("Creative 输入: prompt、media、parameters、conversation_id、question_message_id、answers");
+        console.log("Creative 输出: message、outputs，以及连续创作或追问所需的会话信息");
+        console.log("完整 JSON Schema: gd-cli creative schema --json");
+    });
+    setAuthRequirement(schema, "none");
+    const examples = creative
+        .command("examples")
+        .description("查看 Creative 调用示例")
+        .action(() => {
+        const payload = getCreativeExamples();
+        for (const [index, example] of payload.examples.entries()) {
+            console.log(`${index + 1}. ${example.description} (${example.name})`);
+            console.log(`  ${example.command}`);
+            console.log("  请求 JSON:");
+            console.log(indentJson(JSON.stringify(example.input, null, 2), "    "));
+            console.log("");
+        }
+    });
+    setAuthRequirement(examples, "none");
+}
+function indentJson(value, prefix) {
+    return value
+        .split("\n")
+        .map((line) => `${prefix}${line}`)
+        .join("\n");
+}
+export async function runCreative(options, command, deps = {}) {
+    const format = command.opts().json === true ? "json" : "human";
+    try {
+        const input = await resolveCreativeInput(options, deps.readInput ?? readJsonInput);
+        const client = deps.createClient?.() ?? new CreativeClient();
+        const result = await client.run(validateCreativeInput(input));
+        const envelope = {
+            status: "completed",
+            data: result,
+            error: null,
+            meta: CREATIVE_FAILURE_META,
+        };
+        renderCreativeEnvelope(envelope, format);
+    }
+    catch (error) {
+        const envelope = jsonFailureEnvelopeFor(command, error);
+        if (format === "json") {
+            formatOutput(envelope, "json");
+        }
+        else {
+            printCreativeError(envelope.error);
+        }
+        process.exitCode = 1;
+    }
+}
+async function resolveCreativeInput(options, readInput) {
+    const prompt = typeof options.prompt === "string" ? options.prompt : undefined;
+    const inputRef = typeof options.input === "string" ? options.input : undefined;
+    if (prompt !== undefined && inputRef !== undefined) {
+        throw new CliUsageError({
+            code: "PARAM_INVALID",
+            type: "validation",
+            message: "--prompt 与 --input 不能同时使用",
+            hint: "纯文本请求使用 --prompt；包含媒体、parameters 或连续会话信息时使用 --input",
+            retryable: false,
+        });
+    }
+    if (prompt !== undefined)
+        return { prompt };
+    if (inputRef !== undefined)
+        return readInput(inputRef);
+    throw new CliUsageError({
+        code: "PARAM_MISSING",
+        type: "validation",
+        message: "Creative 请求必须提供 --prompt 或 --input",
+        hint: "执行 gd-cli creative --help 查看输入方式",
+        retryable: false,
+    });
+}
+function renderCreativeEnvelope(envelope, format) {
+    if (format === "json") {
+        formatOutput(envelope, "json");
+        return;
+    }
+    if (!envelope.data)
+        return;
+    printCreativeResult(envelope.data, format);
+}
+function printCreativeResult(result, format) {
+    if (result.message)
+        console.log(result.message);
+    for (const output of result.outputs)
+        printCreativeOutput(output, format);
+    if (result.finish_reason === "requires_input" && result.questions) {
+        console.log(chalk.yellow(`\n${result.questions.title || "需要补充信息"}`));
+        for (const question of result.questions.questions) {
+            console.log(`  ${question.question}`);
+            if (question.options.length > 0) {
+                console.log(`    可选: ${question.options.map((option) => option.label).join("、")}`);
+            }
+        }
+        console.log(`\n  conversation_id: ${result.conversation_id}`);
+        if (result.question_message_id) {
+            console.log(`  question_message_id: ${result.question_message_id}`);
+        }
+    }
+}
+function printCreativeOutput(output, _format) {
+    if (output.type === "text") {
+        if (output.text)
+            console.log(output.text);
+        return;
+    }
+    if (output.type === "json") {
+        console.log(JSON.stringify(output.value, null, 2));
+        return;
+    }
+    console.log(`${output.type}: ${output.url}`);
+}
+function printCreativeError(error) {
+    console.error(chalk.red(`Error: ${error.message}`));
+    if (error.code)
+        console.error(`  错误码: ${error.code}`);
+    if (error.hint)
+        console.error(`  说明: ${error.hint}`);
+}
+function creativeFailureEnvelope(error) {
+    return {
+        status: "failed",
+        data: null,
+        error: toCreativeError(error),
+        meta: CREATIVE_FAILURE_META,
+    };
+}
+function toCreativeError(body) {
+    return {
+        code: body.code,
+        type: body.type,
+        message: body.message,
+        ...(body.hint ? { hint: body.hint } : {}),
+        ...(body.retryable !== undefined ? { retryable: body.retryable } : {}),
+    };
+}