gaoding-cli 1.0.0-alpha.5

package/dist/src/commands/workflows.js

@@ -0,0 +1,398 @@
+import { AppRunner } from "../api/app-runner.js";
+import { withErrorHandler } from "../middleware/error-handler.js";
+import { formatOutput, rowsForAppList } from "../middleware/output.js";
+import { resolveInvokeOutputFormat, resolveListOutputFormat, } from "../utils/list-output-format.js";
+import { resolveAppActivityLabel } from "../utils/tool-display.js";
+import { createSpinner } from "../utils/spinner.js";
+import { appendAppRunQuickExample } from "../utils/help-verify.js";
+import { writeAppDeliverables } from "../utils/write-app-deliverables.js";
+import { emitJson, wrapEnvelope, shouldEmitEnvelope } from "../core/output/envelope.js";
+import { DIRECT_APPS, resolveAppSpec, } from "../registry/direct-registry.js";
+import { buildWorkflowExamples, buildWorkflowSchema, buildManifest, rowsForManifest, } from "../registry/agent-contracts.js";
+import { applySetEntries, collectArg, readJsonInput } from "../utils/input-json.js";
+import { setStaticHelp } from "../utils/static-help.js";
+import { printCapabilityExamples, printCapabilitySchema, } from "../utils/capability-presenter.js";
+import { capabilityMetadata } from "../utils/capability-metadata.js";
+import { assertReferenceImageAvailable, firstReferenceImage, } from "../utils/reference-image.js";
+import { buildEcommerceInputGuidance } from "../utils/ecommerce-input-guidance.js";
+import { resolveSafeOutputDir } from "../utils/output-path.js";
+const INTERNAL_OPTS = new Set([
+    "outputDir",
+    "save",
+    "async",
+    "timeout",
+    "dryRun",
+    "set",
+    "asset",
+]);
+export function registerWorkflowsCommand(program) {
+    const apps = program
+        .command("workflows")
+        .usage("<command> [options]")
+        .description("完整创意场景 Workflows")
+        .configureHelp({ showGlobalOptions: true });
+    setStaticHelp(apps, WORKFLOWS_HELP);
+    apps
+        .command("list")
+        .alias("ls")
+        .description("列出内置 Workflows")
+        .action(withErrorHandler(async (_options, command) => {
+        const cmd = command;
+        const publicItems = DIRECT_APPS.map(toPublicAppPayload);
+        const format = resolveListOutputFormat(cmd);
+        if (shouldEmitEnvelope(format)) {
+            emitJson(wrapEnvelope({ workflows: publicItems }, { command: "workflows ls" }));
+        }
+        else if (format === "json") {
+            formatOutput(publicItems, format);
+        }
+        else {
+            formatOutput(rowsForAppList(publicItems), format);
+        }
+    }));
+    apps
+        .command("info <workflow-id>")
+        .description("查看 Workflow 详情")
+        .action(withErrorHandler(async (appId, _opts, command) => {
+        const cmd = command;
+        const detail = resolveAppSpec(String(appId));
+        if (!detail)
+            throw new Error(`未找到应用: ${String(appId)}`);
+        const payload = toPublicAppPayload(detail);
+        const format = cmd.parent?.parent?.opts().format ?? "json";
+        if (shouldEmitEnvelope(format)) {
+            emitJson(wrapEnvelope(payload, { command: "workflows info", workflow_id: appId }));
+        }
+        else {
+            formatOutput(payload, format);
+        }
+    }));
+    apps
+        .command("schema <workflow-id>")
+        .description("查看 Workflow 输入/输出 JSON Schema")
+        .action(withErrorHandler(async (appId, _opts, command) => {
+        const cmd = command;
+        const payload = buildWorkflowSchema(String(appId));
+        const format = resolveListOutputFormat(cmd);
+        if (format === "json") {
+            formatOutput(payload, "json");
+        }
+        else {
+            printCapabilitySchema(payload);
+        }
+    }));
+    apps
+        .command("examples <workflow-id>")
+        .description("查看 Workflow 调用示例")
+        .action(withErrorHandler(async (appId, _opts, command) => {
+        const cmd = command;
+        const payload = buildWorkflowExamples(String(appId));
+        const format = resolveListOutputFormat(cmd);
+        if (format === "json") {
+            formatOutput(payload, "json");
+        }
+        else {
+            printCapabilityExamples(payload);
+        }
+    }));
+    apps
+        .command("manifest")
+        .description("输出 Workflows 机器可读能力清单")
+        .action((_opts, command) => {
+        const manifest = buildManifest("workflows");
+        const format = resolveListOutputFormat(command);
+        formatOutput(format === "json" ? manifest : rowsForManifest(manifest), format);
+    });
+    const callCmd = apps
+        .command("run <workflow-id> [input]")
+        .usage("<workflow-id> [input] [options]")
+        .description("运行 Workflow（场景编排）")
+        .option("--image <path>", "输入图片路径")
+        .option("--images <paths>", "多张图片（逗号分隔）")
+        .option("--prompt <text>", "文字描述 / brief")
+        .option("--brief <text>", "同 --prompt")
+        .option("--platforms <list>", "目标平台（逗号分隔）")
+        .option("--style <style>", "风格")
+        .option("--ratio <ratio>", "画面比例")
+        .option("--ratios <list>", "多比例输出列表，如 16:9,1:1,4:5")
+        .option("--copy-mode <mode>", "文案模式: auto / render-text / layout-copy / no-text / ask")
+        .option("--model <code-or-name>", "生图模型 code / 名称 / auto")
+        .option("--duration <value>", "视频时长参数")
+        .option("--input <path>", "从 JSON 文件读取输入；非 .json 文件作为 Workflow input 参数")
+        .option("--set <key=value>", "直接传入单个字段，可重复", collectArg)
+        .option("--asset <id-or-url>", "传入 DAM asset_id 或 CDN URL，可重复", collectArg)
+        .option("--assets-dir <dir>", "商品图片目录")
+        .option("--count <n>", "目标产出数量", parseInt)
+        .option("--concurrency <n>", "并发数", parseInt)
+        .option("--dry-run", "只输出计划，不实际调用业务接口", false)
+        .option("--save <dir>", "同 --output-dir")
+        .option("-o, --output-dir <dir>", "结果输出目录", "./output")
+        .option("--allow-sensitive-path", "确认上传默认受保护的本地路径", false)
+        .option("--async", "异步模式", false)
+        .option("--timeout <seconds>", "同步等待超时", "600")
+        .allowUnknownOption(true)
+        .allowExcessArguments(false);
+    callCmd.action(withErrorHandler(async (appId, input, options, command) => {
+        await runAppCall(appId, input, options, command);
+    }));
+    appendAppRunQuickExample(callCmd, "gd-cli workflows run");
+    callCmd.addHelpText("afterAll", WORKFLOW_RUN_HELP);
+}
+export async function runAppCall(appId, inputRef, opts, cmd) {
+    const spec = resolveAppSpec(appId);
+    if (!spec)
+        throw new Error(`未找到应用: ${appId}`);
+    const inputOption = optionalString(opts.input);
+    const inputOptionIsJson = inputOption ? shouldReadJsonInput(inputOption) : false;
+    const inputArgIsJson = inputRef ? shouldReadJsonInput(inputRef) : false;
+    let params = {};
+    if (inputArgIsJson && inputRef) {
+        params = { ...params, ...(await readJsonInput(inputRef)) };
+    }
+    if (inputOptionIsJson && inputOption) {
+        params = { ...params, ...(await readJsonInput(inputOption)) };
+    }
+    params = {
+        ...params,
+        ...extractAppParams(cmd, opts, { skipInput: inputOptionIsJson }),
+    };
+    if (inputRef && !inputArgIsJson)
+        params.input = inputRef;
+    applySetEntries(params, opts.set);
+    applyAssetEntries(params, opts.asset);
+    if (opts.save)
+        opts.outputDir = opts.save;
+    if (opts.dryRun) {
+        const payload = buildAppDryRunPlan(spec.id, params, opts);
+        const format = resolveInvokeOutputFormat(cmd);
+        if (shouldEmitEnvelope(format)) {
+            emitJson(wrapEnvelope(payload, { command: "workflows run", workflow_id: spec.id }));
+        }
+        else {
+            formatOutput(payload, format);
+        }
+        return;
+    }
+    if (!opts.async) {
+        resolveSafeOutputDir(String(opts.outputDir ?? "./output"));
+    }
+    assertAppReferenceImageAvailable(spec, params);
+    const label = await resolveAppActivityLabel(spec.id);
+    const spinner = createSpinner(`${label} · 处理中…`);
+    if (process.stderr.isTTY)
+        spinner.start();
+    const runner = new AppRunner();
+    let result;
+    try {
+        result = await runner.run(spec.id, params, {
+            async: !!opts.async,
+            timeout: parseInt(String(opts.timeout)),
+            outputDir: opts.outputDir,
+            concurrency: typeof opts.concurrency === "number" ? opts.concurrency : undefined,
+            onStepStart: (step) => {
+                if (process.stderr.isTTY)
+                    spinner.text = `${label} · ${step.step_name}…`;
+            },
+            onStepComplete: (step, stepResult) => {
+                const url = stepResultUrl(stepResult);
+                if (process.stderr.isTTY) {
+                    spinner.text = `${label} · ${step.status === "failed" ? "失败" : "已完成"} ${step.step_name}`;
+                }
+                if (step.status === "completed" && url) {
+                    if (process.stderr.isTTY) {
+                        spinner.stop();
+                    }
+                    console.error(`已生成 ${step.step_name}: ${url}`);
+                    if (process.stderr.isTTY) {
+                        spinner.start(`${label} · 继续处理…`);
+                    }
+                }
+                else if (!process.stderr.isTTY && step.status === "failed") {
+                    console.error(`步骤失败 ${step.step_name}`);
+                }
+                else if (!process.stderr.isTTY && step.status === "completed") {
+                    console.error(`步骤完成 ${step.step_name}`);
+                }
+            },
+        });
+    }
+    catch (error) {
+        if (process.stderr.isTTY)
+            spinner.fail(`${label} · 失败`);
+        throw error;
+    }
+    if (result.status === "completed" && result.outputs && !opts.async) {
+        try {
+            const pack = await writeAppDeliverables({
+                appId: spec.id,
+                taskId: result.task_id,
+                outputs: result.outputs,
+                outputDir: opts.outputDir,
+                activityLabel: label,
+            });
+            result = {
+                ...result,
+                deliverable_dir: pack.dir,
+                deliverable_zip: pack.zipPath,
+                deliverable_readme: pack.readmePath,
+            };
+        }
+        catch (packErr) {
+            console.error(`警告: 交付物打包失败: ${packErr instanceof Error ? packErr.message : String(packErr)}`);
+        }
+    }
+    if (process.stderr.isTTY) {
+        if (result.status === "completed")
+            spinner.succeed(`${label} · 已完成`);
+        else if (result.status === "failed")
+            spinner.fail(`${label} · 失败`);
+        else
+            spinner.stop();
+    }
+    const format = resolveInvokeOutputFormat(cmd);
+    if (shouldEmitEnvelope(format)) {
+        emitJson(wrapEnvelope(result, { command: "workflows run", workflow_id: spec.id }));
+    }
+    else {
+        formatOutput(result, format, { activityLabel: label });
+    }
+}
+function buildAppDryRunPlan(appId, params, opts) {
+    const spec = resolveAppSpec(appId);
+    if (!spec)
+        throw new Error(`未找到应用: ${appId}`);
+    const inputGuidance = buildEcommerceInputGuidance({
+        appId: spec.id,
+        brief: params.brief ?? params.prompt,
+        hasReferenceImage: !appNeedsReferenceImage(spec) || Boolean(firstReferenceImage(params.image ?? params.images)),
+    });
+    return {
+        workflow: spec.id,
+        dry_run: true,
+        description: spec.description,
+        inputs: params,
+        required_tools: spec.required_tools,
+        asset_operations: spec.asset_operations ?? [],
+        outputs: spec.outputs ?? ["manifest.json", "README.md", "assets/"],
+        estimated_duration: spec.estimated_duration,
+        supports_batch: spec.supports_batch ?? false,
+        reference_image_policy: appNeedsReferenceImage(spec)
+            ? "required-original-image"
+            : "optional",
+        clarification_required: inputGuidance.clarification_required,
+        input_guidance: inputGuidance,
+        next_command: buildNextAppCommand(spec.id, params, opts),
+    };
+}
+function assertAppReferenceImageAvailable(spec, params) {
+    if (!appNeedsReferenceImage(spec))
+        return;
+    assertReferenceImageAvailable(params.image ?? params.images, {
+        context: `${spec.id} / ${spec.name}`,
+    });
+}
+function appNeedsReferenceImage(spec) {
+    return Boolean(spec.input?.some((param) => param.name === "image" && param.required));
+}
+function stepResultUrl(stepResult) {
+    if (!stepResult || typeof stepResult !== "object")
+        return "";
+    const outputs = stepResult.outputs;
+    if (!outputs || typeof outputs !== "object")
+        return "";
+    const url = outputs.url;
+    return typeof url === "string" ? url : "";
+}
+function buildNextAppCommand(appId, params, opts) {
+    const pieces = ["gd-cli", "workflows", "run", appId];
+    for (const [key, value] of Object.entries({ ...params, ...opts })) {
+        if (INTERNAL_OPTS.has(key) || value === undefined || value === false)
+            continue;
+        pieces.push(`--${kebabCase(key)}`, quoteShell(String(value)));
+    }
+    return pieces.join(" ");
+}
+function kebabCase(key) {
+    return key.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`).replace(/_/g, "-");
+}
+function quoteShell(value) {
+    return /^[\w./:=,-]+$/.test(value) ? value : `"${value.replace(/"/g, '\\"')}"`;
+}
+function extractAppParams(command, opts, options = {}) {
+    const params = {};
+    for (const [key, value] of Object.entries(opts)) {
+        if (key === "input" && options.skipInput)
+            continue;
+        if (!INTERNAL_OPTS.has(key) && value !== undefined && value !== false) {
+            params[key] = value;
+        }
+    }
+    const rawArgs = command.args.slice(1);
+    for (let i = 0; i < rawArgs.length; i += 2) {
+        if (rawArgs[i]?.startsWith("--")) {
+            params[rawArgs[i].replace(/^--/, "")] = rawArgs[i + 1];
+        }
+    }
+    return params;
+}
+function shouldReadJsonInput(value) {
+    return value === "-" || /\.json$/i.test(value);
+}
+function optionalString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function applyAssetEntries(target, entries) {
+    if (!Array.isArray(entries) || entries.length === 0)
+        return;
+    const assets = entries.map(String).filter(Boolean);
+    if (assets.length === 0)
+        return;
+    target.assets = assets;
+    if (!target.image && assets.length === 1)
+        target.image = assets[0];
+    if (!target.images && assets.length > 1)
+        target.images = assets;
+}
+function toPublicAppPayload(app) {
+    return {
+        ...app,
+        ...capabilityMetadata("app", app.id),
+        canonical_command: `gd-cli workflows run ${app.id}`,
+        schema_command: `gd-cli workflows schema ${app.id} --format json`,
+        examples_command: `gd-cli workflows examples ${app.id} --format json`,
+    };
+}
+const WORKFLOWS_HELP = `
+gd-cli workflows <command> [options]
+
+用于运行完整业务场景，例如商品图库素材包、详情页/A+模块素材包、小红书种草图文包。
+一个 Workflow 通常会编排多个 Tools，并输出一组可交付物料。
+
+常用命令:
+  list/ls                   列出内置 Workflows
+  info <workflow-id>        查看 Workflow 详情
+  run <workflow-id>         运行 Workflow，适合 Agent / 脚本
+  manifest                  输出 Workflows 能力清单
+  schema <workflow-id>      查看 Workflow 输入/输出 Schema
+  examples <workflow-id>    查看 Workflow 调用示例
+
+示例:
+  gd-cli workflows list
+  gd-cli workflows info listing-gallery
+  gd-cli workflows schema pdp-a-plus
+  gd-cli workflows run social-seeding-pack --input brief.json --format json
+`;
+const WORKFLOW_RUN_HELP = `
+
+JSON 输入:
+  gd-cli workflows run listing-gallery --input brief.json --format json
+  cat brief.json | gd-cli workflows run social-seeding-pack - --format json
+  gd-cli workflows run campaign-kv-pack --set brief="城市跑鞋新品 Campaign" --set image=./sku.png --format json
+
+说明:
+  --input <file> 传入 .json 时作为参数对象读取；其他文件类型会作为 Workflow 的 input 字段。
+  --dry-run 只校验输入和执行计划，不真正生成。
+`;

package/dist/src/core/auth/auth-provider.d.ts

@@ -0,0 +1,8 @@
+import type { LoginOptions, LoginResult, AuthMode } from "./types.js";
+export interface AuthProvider {
+    readonly mode: AuthMode;
+    login(options: LoginOptions): Promise<LoginResult>;
+    logout(): Promise<void>;
+}
+export declare function resolveAuthMode(): AuthMode;
+export declare function createAuthProvider(): Promise<AuthProvider>;

package/dist/src/core/auth/auth-provider.js

@@ -0,0 +1,12 @@
+export function resolveAuthMode() {
+    const m = (process.env.GD_AUTH_MODE ?? process.env.GDHUB_AUTH_MODE)?.toLowerCase();
+    if (!m || m === "device" || m === "oauth" || m === "device-flow" || m === "aksk") {
+        return "aksk";
+    }
+    throw new Error("仅支持 AK/SK 认证模式，请执行：gd-cli auth login");
+}
+export async function createAuthProvider() {
+    resolveAuthMode();
+    const { DeviceOAuthAuthProvider } = await import("./device-oauth-provider.js");
+    return new DeviceOAuthAuthProvider();
+}

package/dist/src/core/auth/device-oauth-provider.d.ts

@@ -0,0 +1,12 @@
+import type { AuthProvider } from "./auth-provider.js";
+import type { LoginOptions, LoginResult } from "./types.js";
+/**
+ * SSO OAuth 2.0 Device Authorization Flow，登录后保存 AK/SK。
+ */
+export declare class DeviceOAuthAuthProvider implements AuthProvider {
+    readonly mode: "aksk";
+    private sso;
+    login(options: LoginOptions): Promise<LoginResult>;
+    logout(): Promise<void>;
+}
+export { signBindOrg, signApiRequest, canonicalQuery } from "./signature.js";

package/dist/src/core/auth/device-oauth-provider.js

@@ -0,0 +1,124 @@
+import { CredentialStoreV2 } from "../../auth/credential-store-v2.js";
+import { SsoClient } from "../../api/sso-client.js";
+import { openBrowser } from "../../utils/open-browser.js";
+import { createSpinner } from "../../utils/spinner.js";
+import { GDHUB_CLI_CLIENT_ID, DEFAULT_SCOPE, } from "../../utils/config.js";
+import { getIO } from "../../io.js";
+import { emitAuthEvent, printAuthQrAndLink, } from "../../tty/auth-presenter.js";
+import { OrgManager } from "./org-manager.js";
+import chalk from "chalk";
+import { resolveActiveEnv } from "../../utils/endpoints.js";
+/**
+ * SSO OAuth 2.0 Device Authorization Flow，登录后保存 AK/SK。
+ */
+export class DeviceOAuthAuthProvider {
+    mode = "aksk";
+    sso = new SsoClient();
+    async login(options) {
+        const store = new CredentialStoreV2();
+        if (store.read() && !process.env.GD_AUTH_FORCE) {
+            throw Error(chalk.yellow("已存在授权凭证！如需重新授权，请先 gd-cli auth logout 再执行 gd-cli auth login。 \n"));
+        }
+        const authResp = await this.sso.deviceAuthorization();
+        const uri = authResp.verification_uri_complete;
+        const io = getIO();
+        if (io.isInteractiveAuth()) {
+            await printAuthQrAndLink(uri);
+            // console.log(`  ${chalk.dim("verification_uri:")} ${authResp.verification_uri}`);
+            console.log(`授权码有效期约 ${authResp.expires_in}s，轮询间隔 ${authResp.interval}s`);
+            if (!options.noBrowser)
+                await openBrowser(uri).catch(() => undefined);
+        }
+        else {
+            emitAuthEvent({
+                type: "device_authorization",
+                verification_uri_complete: uri,
+                device_code: authResp.device_code,
+                expires_in: authResp.expires_in,
+                interval: authResp.interval,
+                user_action_required: "open_authorization_url",
+                agent_message_template: `请点击完成稿定授权：<${uri}>。我会保持授权命令运行，等你完成后继续。`,
+            });
+        }
+        const spinner = io.stderrIsTTY ? createSpinner("等待浏览器授权…\n") : null;
+        spinner?.start();
+        const token = await this.sso.pollDeviceToken(authResp.device_code, authResp.interval, authResp.expires_in, () => {
+            if (!io.isInteractiveAuth()) {
+                emitAuthEvent({ type: "authorization_pending" });
+            }
+        });
+        spinner?.succeed("SSO 授权成功，已获取权限");
+        let user;
+        let authorizedOrgId = cleanString(token.orgId);
+        try {
+            const identity = await this.sso.getIdentity(token.ak);
+            user = {
+                id: String(identity.userId),
+                name: String(identity.userId),
+            };
+            authorizedOrgId = cleanString(identity.orgId) ?? authorizedOrgId;
+            if (!io.isInteractiveAuth()) {
+                emitAuthEvent({
+                    type: "authorization_success",
+                    ak_preview: `${token.ak.slice(0, 8)}***`,
+                    user_id: identity.userId,
+                    bound_org_id: authorizedOrgId,
+                });
+            }
+        }
+        catch {
+            if (!io.isInteractiveAuth()) {
+                emitAuthEvent({ type: "authorization_success" });
+            }
+        }
+        const creds = {
+            version: 2,
+            provider: "gdhub",
+            client_id: GDHUB_CLI_CLIENT_ID,
+            ak: token.ak,
+            sk: token.sk,
+            scope: normalizeScope(token.scope),
+            expires_at: token.expires_at,
+            issued_for_env: resolveActiveEnv(),
+            user,
+            created_at: new Date().toISOString(),
+        };
+        store.write(creds);
+        const orgMgr = new OrgManager(store);
+        let org;
+        if (options.orgId) {
+            org = await orgMgr.switchOrg(options.orgId);
+        }
+        else if (authorizedOrgId) {
+            org = await orgMgr.bindAuthorizedOrg(authorizedOrgId);
+        }
+        else {
+            emitAuthEvent({
+                type: "org_not_bound",
+                message: "授权成功，但授权结果未返回组织 ID。请执行 gd-cli org switch 绑定团队。",
+            });
+        }
+        if (org) {
+            emitAuthEvent({ type: "bind_org_success", org });
+        }
+        return { credentials: store.read(), org };
+    }
+    async logout() {
+        new CredentialStoreV2().delete();
+    }
+}
+function cleanString(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    const s = String(value).trim();
+    return s ? s : undefined;
+}
+function normalizeScope(scope) {
+    if (!scope)
+        return [...DEFAULT_SCOPE];
+    if (Array.isArray(scope))
+        return scope;
+    return scope.split(",").map((s) => s.trim()).filter(Boolean);
+}
+// Backward-compatible signature exports used by older internal imports.
+export { signBindOrg, signApiRequest, canonicalQuery } from "./signature.js";

package/dist/src/core/auth/org-manager.d.ts

@@ -0,0 +1,26 @@
+import { SsoClient } from "../../api/sso-client.js";
+import { HubClient } from "../../api/hub-client.js";
+import { CredentialStoreV2 } from "../../auth/credential-store-v2.js";
+import type { OrgSummary } from "./types.js";
+/**
+ * 组织列表与 bind-org。
+ * Device 模式：组织列表走 Hub 网关代理的 /structure/user/orgs；
+ * 网关不可用时退回本地 current_org 与 SSO identity。
+ */
+export declare class OrgManager {
+    private v2Store;
+    private sso;
+    private hub;
+    constructor(v2Store?: CredentialStoreV2, sso?: SsoClient, hub?: HubClient);
+    listOrgs(): Promise<OrgSummary[]>;
+    /** TTY 下选择结构接口返回的组织；接口不可用时允许手输 orgId。 */
+    switchOrgInteractive(): Promise<OrgSummary | undefined>;
+    switchOrg(orgId: string): Promise<OrgSummary>;
+    bindAuthorizedOrg(orgId: string): Promise<OrgSummary>;
+    getCurrentOrgId(): string | undefined;
+    getCurrentOrg(): OrgSummary | undefined;
+    private listOrgsWithSource;
+    private listStructureOrgs;
+    private listOrgsDevice;
+    private bindOrgDevice;
+}