@gaoding/cli 0.0.0 → 1.0.0

package/dist/src/cli/errors.js

@@ -0,0 +1,157 @@
+import { CommanderError } from "commander";
+import { AuthExpiredError, AuthRequiredError } from "../features/auth/access-policy.js";
+import { AuthStateInvalidError } from "../features/auth/state.js";
+import { SsoRequestError } from "../features/auth/sso-service.js";
+import { DeviceAuthorizationExpiredError } from "../features/auth/use-cases.js";
+import { AgentInputError } from "../features/agent/use-cases.js";
+import { ToolInputError } from "../features/tool/catalog.js";
+import { ToolTaskFailedError } from "../features/tool/tool-api-adapter.js";
+import { ObjectStorageUploadError } from "../features/dam/object-storage.js";
+import { DamAssetNotDownloadableError, DamAssetNotFoundError, DamFolderNotFoundError } from "../features/dam/dam-api-adapter.js";
+import { DamDownloadDestinationExistsError } from "../features/dam/file-downloader.js";
+import { DamOperationFailedError } from "../features/dam/operation-executor.js";
+import { DamInputError, DamOperationUnconfirmedError, DamRepositoryNotFoundError } from "../features/dam/use-cases.js";
+import { OrganizationResponseError } from "../features/org/org-service.js";
+import { OrganizationBindFailedError, OrganizationInvalidError, OrgUsageError } from "../features/org/use-cases.js";
+import { RemoteRequestError } from "../platform/signed-http-transport.js";
+import { RemoteProtocolError } from "../platform/remote-protocol.js";
+import { InputContractError, OutputContractError } from "../bootstrap/validators.js";
+import { JsonInputError } from "../platform/json-input.js";
+import { LocalFileInputError } from "../platform/safe-upload-file.js";
+import { EditorBridgeError } from "../features/editor/bridge-client.js";
+import { EditorNotReadyError, EditorSessionNotFoundError, EditorTargetError } from "../features/editor/session.js";
+import { UpdateError } from "../features/update/update-service.js";
+export class CliUsageError extends Error {
+    constructor() {
+        super("命令或参数无效。");
+        this.name = "CliUsageError";
+    }
+}
+const INSUFFICIENT_CREDITS_REMOTE_CODE = "12020770";
+const INSUFFICIENT_CREDITS_NEXT_STEPS = [
+    "前往 https://www.gaoding.art/pricing 购买稿豆",
+    "也可以执行 gd-cli org switch 切换到有可用稿豆的组织",
+    "处理后重新发起本次创作"
+];
+export function isHelpOutcome(error) {
+    return error instanceof CommanderError
+        && error.exitCode === 0
+        && (error.code === "commander.helpDisplayed" || error.code === "commander.version");
+}
+export function mapCliError(error, options) {
+    if (options.aborted)
+        return { kind: "interrupted", exitCode: 130 };
+    if (error instanceof AuthRequiredError) {
+        return failure("AUTH_REQUIRED", "请先执行 gd-cli auth login", 1, ["gd-cli auth login"]);
+    }
+    if (error instanceof AuthExpiredError) {
+        return failure("AUTH_EXPIRED", "登录已过期，请退出后重新登录。", 1, ["gd-cli auth logout", "gd-cli auth login"]);
+    }
+    if (error instanceof AuthStateInvalidError) {
+        return failure("AUTH_STATE_INVALID", "本地登录状态已失效，请退出后重新登录。", 1, ["gd-cli auth logout", "gd-cli auth login"]);
+    }
+    if (error instanceof OrganizationInvalidError) {
+        return failure("ORG_INVALID", "所选组织不可用，请重新选择组织。", 1, ["gd-cli org switch"]);
+    }
+    if (error instanceof UpdateError) {
+        return failure(error.code, error.message, 1, error.nextSteps);
+    }
+    if (error instanceof EditorTargetError) {
+        return failure(error.code, error.message, 2);
+    }
+    if (error instanceof OrgUsageError
+        || error instanceof CliUsageError
+        || error instanceof JsonInputError
+        || error instanceof InputContractError
+        || error instanceof AgentInputError
+        || error instanceof ToolInputError
+        || error instanceof DamInputError
+        || error instanceof LocalFileInputError
+        || error instanceof CommanderError) {
+        return failure("USAGE_ERROR", "命令或参数无效，请查看 --help。", 2);
+    }
+    if (isInsufficientCreditsError(error)) {
+        return failure("INSUFFICIENT_CREDITS", "当前组织稿豆不足，无法完成本次创作。", 1, INSUFFICIENT_CREDITS_NEXT_STEPS);
+    }
+    if (error instanceof RemoteProtocolError) {
+        return failure("REMOTE_PROTOCOL_INCOMPATIBLE", "稿定服务返回了当前 CLI 无法安全处理的结果；为避免重复创作，已停止处理。", 1);
+    }
+    if (error instanceof ToolTaskFailedError) {
+        return failure("TOOL_TASK_FAILED", "稿定工具任务执行失败。", 1);
+    }
+    if (error instanceof DamAssetNotFoundError) {
+        return failure("DAM_ASSET_NOT_FOUND", "未找到指定的 DAM 素材。", 1);
+    }
+    if (error instanceof DamFolderNotFoundError) {
+        return failure("DAM_FOLDER_NOT_FOUND", "未找到指定的 DAM 文件夹。", 1);
+    }
+    if (error instanceof DamAssetNotDownloadableError) {
+        return failure("DAM_ASSET_NOT_DOWNLOADABLE", "该素材当前没有可下载的源文件；请先查看素材状态。", 1, ["gd-cli dam get <asset-id>"]);
+    }
+    if (error instanceof DamDownloadDestinationExistsError) {
+        return failure("DAM_DOWNLOAD_DESTINATION_EXISTS", "目标文件已存在，未覆盖任何文件；请更换输出目录或移走同名文件。", 1);
+    }
+    if (error instanceof DamOperationUnconfirmedError) {
+        return failure("DAM_OPERATION_UNCONFIRMED", "操作已提交，但未能确认最终结果；请先查询目标位置，不要立即重复提交。", 1);
+    }
+    if (error instanceof DamOperationFailedError) {
+        return failure("DAM_OPERATION_FAILED", "DAM 操作执行失败；请先按诊断 ID 查询原因，不要立即重复提交。", 1);
+    }
+    if (error instanceof DamRepositoryNotFoundError) {
+        return failure("DAM_REPOSITORY_NOT_FOUND", "当前组织没有可用的 DAM 资源库。", 1, ["gd-cli org list", "gd-cli org switch --org <org-id>"]);
+    }
+    if (error instanceof RemoteRequestError
+        || error instanceof SsoRequestError
+        || error instanceof DeviceAuthorizationExpiredError
+        || error instanceof OrganizationResponseError
+        || error instanceof OrganizationBindFailedError
+        || error instanceof ObjectStorageUploadError) {
+        return failure("REMOTE_REQUEST_FAILED", "稿定服务请求失败。", 1);
+    }
+    if (error instanceof OutputContractError) {
+        return failure("INTERNAL_ERROR", "CLI 内部结果校验失败。", 1);
+    }
+    if (error instanceof EditorBridgeError
+        || error instanceof EditorSessionNotFoundError
+        || error instanceof EditorNotReadyError) {
+        return failure(error.code, error.message, 1);
+    }
+    return failure("INTERNAL_ERROR", "CLI 发生内部错误。", 1);
+}
+function isInsufficientCreditsError(error) {
+    return (error instanceof RemoteRequestError
+        || error instanceof RemoteProtocolError
+        || error instanceof ToolTaskFailedError) && error.remoteCode === INSUFFICIENT_CREDITS_REMOTE_CODE;
+}
+export function classifyTelemetryError(error) {
+    const outcome = mapCliError(error, { aborted: false });
+    const remoteError = error instanceof RemoteRequestError
+        || error instanceof RemoteProtocolError
+        || error instanceof ToolTaskFailedError
+        ? error
+        : undefined;
+    return {
+        outcome: outcome.kind === "interrupted" ? "interrupted" : "failure",
+        ...(outcome.kind === "failure" ? { errorCode: outcome.failure.code } : {}),
+        ...(error instanceof RemoteRequestError && error.status !== undefined
+            ? { httpStatus: error.status }
+            : {}),
+        ...(remoteError?.remoteCode === undefined
+            ? {}
+            : { remoteErrorCode: remoteError.remoteCode }),
+        ...(remoteError?.remoteBody === undefined
+            ? {}
+            : { remoteErrorBody: remoteError.remoteBody })
+    };
+}
+function failure(code, message, exitCode, nextSteps) {
+    return {
+        kind: "failure",
+        failure: {
+            code,
+            message,
+            ...(nextSteps ? { details: { next_steps: nextSteps } } : {})
+        },
+        exitCode
+    };
+}

package/dist/src/cli/model-commands.js

@@ -0,0 +1,61 @@
+import { bindAction } from "./action-binding.js";
+import { CliUsageError } from "./errors.js";
+export function registerModelCommands(program, runtime) {
+    const model = program.command("model")
+        .description("创作模型")
+        .helpCommand(false);
+    const list = model.command("list")
+        .description("列出可用模型")
+        .option("--tool <tool>", "按工具筛选")
+        .allowExcessArguments(false);
+    bindAction(list, "organization", async (context, signal) => {
+        const selectedTool = list.opts().tool;
+        const input = selectedTool === undefined ? {} : { tool: selectedTool };
+        await runtime.telemetry.stage("input", async () => {
+            runtime.validators.modelListInput(input);
+        });
+        const result = await runtime.tool.listModels({
+            input,
+            access: {
+                credential: context.state.credential,
+                organizationId: context.state.organization.id
+            },
+            signal
+        });
+        if (selectedTool !== undefined)
+            runtime.telemetry.annotate({ tool_name: selectedTool });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.validators.modelListOutput(result);
+            runtime.io.writeOut(`${JSON.stringify(result)}\n`);
+        });
+    }, { operation: "model.list" });
+    const get = model.command("get")
+        .description("查看模型完整信息")
+        .argument("<model>", "模型机器标识")
+        .allowExcessArguments(false);
+    bindAction(get, "organization", async (context, signal) => {
+        const modelName = get.processedArgs[0];
+        if (typeof modelName !== "string" || modelName.trim() === "")
+            throw new CliUsageError();
+        const input = { model: modelName };
+        await runtime.telemetry.stage("input", async () => {
+            runtime.validators.modelGetInput(input);
+        });
+        const access = {
+            credential: context.state.credential,
+            organizationId: context.state.organization.id
+        };
+        const result = await runtime.tool.getModel({
+            input,
+            access,
+            signal
+        });
+        runtime.telemetry.annotate({ model_id: modelName });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.validators.modelGetOutput(result);
+            runtime.io.writeOut(`${JSON.stringify(result)}\n`);
+        });
+    }, {
+        operation: "model.get"
+    });
+}

package/dist/src/cli/org-commands.js

@@ -0,0 +1,58 @@
+import { bindAction } from "./action-binding.js";
+import { OrgUsageError } from "../features/org/use-cases.js";
+import { orgCurrentView, orgListView } from "./presenter.js";
+export function registerOrgCommands(program, runtime) {
+    const org = program.command("org")
+        .description("组织选择")
+        .helpCommand(false);
+    const list = leaf(org.command("list"))
+        .description("列出可用组织")
+        .option("--json", "输出 JSON");
+    bindAction(list, "credential", async (context, signal) => {
+        const result = await runtime.org.list({ state: context.state, signal });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.validators.orgList(result);
+            runtime.presenter.result(result, {
+                json: list.opts().json === true,
+                view: orgListView
+            });
+        });
+    }, { operation: "org.list" });
+    const current = leaf(org.command("current"))
+        .description("查看当前组织")
+        .option("--json", "输出 JSON");
+    bindAction(current, "none", async () => {
+        const result = await runtime.org.current();
+        await runtime.telemetry.stage("output", async () => {
+            runtime.validators.orgCurrent(result);
+            runtime.presenter.result(result, {
+                json: current.opts().json === true,
+                view: orgCurrentView
+            });
+        });
+    }, { operation: "org.current" });
+    const switchCommand = leaf(org.command("switch"))
+        .description("切换当前组织")
+        .option("--org <org-id>", "指定组织 ID");
+    bindAction(switchCommand, "credential", async (context, signal) => {
+        const organizationId = switchCommand.opts().org;
+        if (organizationId === undefined && !isInteractive(runtime))
+            throw new OrgUsageError();
+        const record = await runtime.org.switchOrganization({
+            state: context.state,
+            ...(organizationId === undefined
+                ? { select: (records) => runtime.prompt.choose(records, signal) }
+                : { organizationId }),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.success(`已切换到${record.publicName} (${record.id})。`);
+        });
+    }, { operation: "org.switch" });
+}
+function leaf(command) {
+    return command.allowExcessArguments(false);
+}
+function isInteractive(runtime) {
+    return runtime.io.inputTerminal && runtime.io.stderrTerminal;
+}

package/dist/src/cli/presenter.js

@@ -0,0 +1,105 @@
+import * as QRCode from "qrcode";
+export function createPresenter(options) {
+    const qrCode = options.qrCode ?? ((text) => QRCode.toString(text, {
+        type: "terminal",
+        small: true
+    }));
+    return {
+        result(value, presentation) {
+            options.writeOut(presentation.json
+                ? `${JSON.stringify(value)}\n`
+                : `${presentation.view(value)}\n`);
+        },
+        success(message) {
+            options.writeOut(`${message}\n`);
+        },
+        async authorization(input) {
+            options.writeError(`授权地址: ${input.url.href}\n`);
+            if (input.terminal)
+                options.writeError(await qrCode(input.url.href));
+        },
+        notice(message) {
+            options.writeError(`提示: ${message}\n`);
+        },
+        warning(message) {
+            options.writeError(`警告: ${message}\n`);
+        },
+        error(outcome, presentation) {
+            if (outcome.kind === "interrupted") {
+                options.writeError("已取消。\n");
+                return;
+            }
+            if (presentation.json) {
+                options.writeError(`${JSON.stringify({
+                    error: {
+                        ...outcome.failure,
+                        ...(presentation.traceId
+                            ? { trace_id: presentation.traceId }
+                            : {})
+                    }
+                })}\n`);
+                return;
+            }
+            options.writeError(`${outcome.failure.code}: ${outcome.failure.message}\n`);
+            const nextSteps = nextStepsFrom(outcome.failure.details);
+            if (nextSteps.length > 0) {
+                options.writeError(`下一步: ${nextSteps.join("，")}\n`);
+            }
+            if (presentation.traceId) {
+                options.writeError(`诊断 ID: ${presentation.traceId}\n`);
+            }
+        }
+    };
+}
+export const authStatusView = (value) => {
+    const status = value;
+    if (!status.logged_in)
+        return lines("未登录", nextStepsLine(status.next_steps));
+    return lines("已登录", `账号: ${status.account.name ?? "未记录"}${status.account.user_id ? ` (${status.account.user_id})` : ""}`, status.organization
+        ? `组织: ${status.organization.name} (${status.organization.id})`
+        : "组织: 未选择", `凭证: ${status.credential.valid ? "有效" : "已过期"}，到期 ${status.credential.expires_at}`, status.credential.scope.length > 0
+        ? `权限: ${status.credential.scope.join(", ")}`
+        : "权限: 未声明", nextStepsLine(status.next_steps));
+};
+export const orgListView = (value) => {
+    const result = value;
+    if (result.orgs.length === 0)
+        return "没有可用组织。";
+    return result.orgs.map((organization) => {
+        const product = organization.product_name ? ` · ${organization.product_name}` : "";
+        const current = organization.id === result.current_org_id ? " [当前]" : "";
+        return `${organization.name} (${organization.id})${product}${current}`;
+    }).join("\n");
+};
+export const orgCurrentView = (value) => {
+    const result = value;
+    return result.organization
+        ? `当前组织: ${result.organization.name} (${result.organization.id})`
+        : lines("尚未选择组织。", nextStepsLine(result.next_steps));
+};
+export const repositoryListView = (value) => {
+    const result = value;
+    if (result.repositories.length === 0)
+        return "没有可用资源库。";
+    return result.repositories.map((repository) => {
+        const permission = repository.permission_code === undefined
+            ? ""
+            : ` · ${repository.permission_code}`;
+        const defaultMarker = repository.is_default ? " [默认]" : "";
+        return `${repository.name} (${repository.repository_id}) · ${repository.type}${permission}${defaultMarker}`;
+    }).join("\n");
+};
+function lines(...values) {
+    return values.filter((value) => Boolean(value)).join("\n");
+}
+function nextStepsLine(nextSteps) {
+    return nextSteps.length > 0 ? `下一步: ${nextSteps.join("，")}` : undefined;
+}
+function nextStepsFrom(details) {
+    if (typeof details !== "object" || details === null || Array.isArray(details))
+        return [];
+    const nextSteps = details.next_steps;
+    return Array.isArray(nextSteps) && nextSteps.every((item) => typeof item === "string")
+        ? nextSteps
+        : [];
+}

package/dist/src/cli/prompt.js

@@ -0,0 +1,30 @@
+import { createInterface } from "node:readline/promises";
+import { OrganizationInvalidError } from "../features/org/use-cases.js";
+export function createOrganizationPrompt(options) {
+    return {
+        async choose(records, signal) {
+            signal.throwIfAborted();
+            if (records.length === 0)
+                throw new OrganizationInvalidError();
+            const readline = createInterface({ input: options.input, output: options.output });
+            try {
+                options.output.write("请选择组织：\n");
+                records.forEach((record, index) => {
+                    const product = record.productName ? ` · ${record.productName}` : "";
+                    options.output.write(`${index + 1}. ${record.publicName} (${record.id})${product}\n`);
+                });
+                while (true) {
+                    const answer = (await readline.question("输入序号: ", { signal })).trim();
+                    const index = Number(answer) - 1;
+                    if (Number.isInteger(index) && index >= 0 && index < records.length) {
+                        return records[index].id;
+                    }
+                    options.output.write("请输入列表中的有效序号。\n");
+                }
+            }
+            finally {
+                readline.close();
+            }
+        }
+    };
+}

package/dist/src/cli/tool-commands.js

@@ -0,0 +1,77 @@
+import { bindAction, bindPreparedAction } from "./action-binding.js";
+import { CliUsageError } from "./errors.js";
+export function registerToolCommands(program, runtime) {
+    const tool = program.command("tool")
+        .description("创作工具")
+        .helpCommand(false);
+    const list = tool.command("list")
+        .description("列出可用工具")
+        .allowExcessArguments(false);
+    bindAction(list, "organization", async (context, signal) => {
+        const result = await runtime.tool.listTools({
+            access: {
+                credential: context.state.credential,
+                organizationId: context.state.organization.id
+            },
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.validators.toolListOutput(result);
+            runtime.io.writeOut(`${JSON.stringify(result)}\n`);
+        });
+    }, { operation: "tool.list" });
+    const call = tool.command("call")
+        .description("调用创作工具")
+        .argument("<tool>", "工具机器标识")
+        .option("--schema", "输出当前工具所有模型参数并集的输入 Schema")
+        .option("--input <file|->", "从文件或标准输入读取参数 JSON")
+        .allowExcessArguments(false);
+    bindPreparedAction(call, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const name = call.processedArgs[0];
+        if (typeof name !== "string" || name.trim() === "")
+            throw new CliUsageError();
+        const options = call.opts();
+        const modes = Number(options.schema === true) + Number(options.input !== undefined);
+        if (modes !== 1)
+            throw new CliUsageError();
+        if (options.schema === true) {
+            return { handled: false, input: { mode: "schema", name } };
+        }
+        const argumentsInput = await runtime.jsonInput.read(options.input, signal);
+        const input = { name, arguments: argumentsInput };
+        runtime.validators.toolCallInput(input);
+        return { handled: false, input: { mode: "call", input } };
+    }, async (context, prepared, signal) => {
+        const access = {
+            credential: context.state.credential,
+            organizationId: context.state.organization.id
+        };
+        if (prepared.mode === "schema") {
+            const schema = await runtime.tool.getArgumentsSchema({
+                name: prepared.name,
+                access,
+                signal
+            });
+            runtime.telemetry.annotate({ tool_name: prepared.name });
+            await runtime.telemetry.stage("output", async () => {
+                runtime.io.writeOut(`${JSON.stringify(schema)}\n`);
+            });
+            return;
+        }
+        const result = await runtime.tool.call({
+            input: prepared.input,
+            access,
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.validators.toolCallOutput(result);
+            runtime.io.writeOut(`${JSON.stringify(result)}\n`);
+        });
+    }, {
+        operation: "tool.call",
+        mode: () => call.opts().schema === true
+            ? "schema"
+            : "execute"
+    });
+}

package/dist/src/cli/update-command.js

@@ -0,0 +1,14 @@
+import { bindAction } from "./action-binding.js";
+export function registerUpdateCommand(program, runtime) {
+    const update = program.command("update")
+        .description("更新 GD CLI 与内置 Agent Skill")
+        .allowExcessArguments(false);
+    bindAction(update, "none", async (_context, signal) => {
+        const result = await runtime.update.run(signal);
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.success(result.updated
+                ? `gd-cli 已更新到 ${result.version}，Agent Skill 已同步。`
+                : `gd-cli ${result.version} 已是最新版本，Agent Skill 已同步。`);
+        });
+    }, { operation: "update" });
+}

package/dist/src/contracts/schema.js

@@ -0,0 +1,4 @@
+import { readFileSync } from "node:fs";
+export function contractSchema(operation, direction) {
+    return JSON.parse(readFileSync(new URL(`../../../contracts/operations/${operation}/${direction}.schema.json`, import.meta.url), "utf8"));
+}

package/dist/src/features/agent/creative-agent-adapter.js

@@ -0,0 +1,36 @@
+import { buildCreativeRequest, creativeContextId, creativeTurnMessages, normalizeCreativeMessages, restoreCreativeResourceUrls } from "./creative-protocol.js";
+import { parseCreativeStream } from "./creative-stream.js";
+export function createCreativeAgentAdapter(dependencies) {
+    return {
+        async complete(message, access, signal) {
+            signal.throwIfAborted();
+            const ids = message.contextId === undefined
+                ? {
+                    localThreadId: dependencies.idFactory(),
+                    localMessageId: dependencies.idFactory()
+                }
+                : { localMessageId: dependencies.idFactory() };
+            const streamed = await dependencies.telemetry.stage("execute", async () => {
+                const stream = await dependencies.transport.postStream({
+                    path: "/ai-agent/v1/thread/completion",
+                    body: buildCreativeRequest(message, ids),
+                    accept: "text/event-stream",
+                    credential: access.credential,
+                    organizationId: access.organizationId,
+                    signal
+                });
+                return parseCreativeStream(stream, signal);
+            });
+            const contextId = creativeContextId(streamed);
+            return dependencies.telemetry.stage("result", async () => {
+                const messages = await dependencies.transport.getJson({
+                    path: `/ai-agent/v1/thread/${encodeURIComponent(contextId)}/messages`,
+                    credential: access.credential,
+                    organizationId: access.organizationId,
+                    signal
+                });
+                return normalizeCreativeMessages(restoreCreativeResourceUrls(creativeTurnMessages(messages, ids.localMessageId), streamed));
+            });
+        }
+    };
+}