gaoding-cli 1.0.0-alpha.10

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

@@ -0,0 +1,207 @@
+import { bindPreparedAction } from "./action-binding.js";
+import { CliUsageError } from "./errors.js";
+export function registerDamCommands(program, runtime) {
+    const dam = program.command("dam")
+        .description("DAM 素材管理")
+        .helpCommand(false);
+    const list = browseCommand(leaf(dam.command("list")))
+        .description("查看最近素材");
+    bindPreparedAction(list, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const input = browseInput(list);
+        runtime.validators.damListInput(input);
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.list({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        runtime.presenter.result(result, {
+            json: list.opts().json === true,
+            view: assetListView
+        });
+    });
+    const search = browseCommand(leaf(dam.command("search")))
+        .description("按关键词搜索素材")
+        .argument("<query>", "搜索关键词");
+    bindPreparedAction(search, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const input = {
+            query: position(search, 0),
+            ...browseInput(search)
+        };
+        runtime.validators.damSearchInput(input);
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.search({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        runtime.presenter.result(result, {
+            json: search.opts().json === true,
+            view: assetListView
+        });
+    });
+    const get = leaf(dam.command("get"))
+        .description("查看素材完整信息")
+        .argument("<asset>", "素材 ID")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(get, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const input = { asset_id: position(get, 0) };
+        runtime.validators.damGetInput(input);
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.get({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        runtime.presenter.result(result, {
+            json: get.opts().json === true,
+            view: assetDetailView
+        });
+    });
+    const upload = leaf(dam.command("upload"))
+        .description("上传本地文件并创建素材")
+        .argument("<file>", "本地文件路径")
+        .option("--repository-id <id>", "目标资源库 ID")
+        .option("--title <title>", "素材标题")
+        .option("--folder-id <id>", "目标文件夹 ID")
+        .option("--tag-ids <csv>", "标签 ID，逗号分隔")
+        .option("--allow-sensitive-path", "明确允许受保护路径")
+        .option("--wait-analysis", "等待素材分析结束")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(upload, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = upload.opts();
+        const input = {
+            file: position(upload, 0),
+            ...defined("repositoryId", options.repositoryId),
+            ...defined("title", options.title),
+            ...defined("folderId", options.folderId),
+            ...defined("tagIds", csv(options.tagIds)),
+            ...(options.allowSensitivePath === true ? { allowSensitivePath: true } : {}),
+            ...(options.waitAnalysis === true ? { waitAnalysis: true } : {})
+        };
+        runtime.validators.damUploadInput(input);
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.upload({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        runtime.presenter.result(result, {
+            json: upload.opts().json === true,
+            view: assetDetailView
+        });
+    });
+    const deleteCommand = leaf(dam.command("delete"))
+        .description("删除素材")
+        .argument("<asset>", "素材 ID")
+        .option("--repository-id <id>", "所属资源库 ID")
+        .option("--permanent", "移入回收站后永久删除");
+    bindPreparedAction(deleteCommand, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = deleteCommand.opts();
+        const input = {
+            asset_id: position(deleteCommand, 0),
+            ...defined("repositoryId", options.repositoryId),
+            ...(options.permanent === true ? { permanent: true } : {})
+        };
+        runtime.validators.damDeleteInput(input);
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        await runtime.dam.delete({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        runtime.presenter.success(input.permanent === true
+            ? "素材已永久删除。"
+            : "素材已移入回收站。");
+    });
+}
+function leaf(command) {
+    return command.allowExcessArguments(false);
+}
+function browseCommand(command) {
+    return command
+        .option("--repository-id <id>", "指定资源库 ID")
+        .option("--all-repositories", "查询全部可访问资源库")
+        .option("--folder-id <id>", "指定文件夹 ID")
+        .option("--no-include-child-folder", "不包含子文件夹")
+        .option("--type <type>", "素材类型")
+        .option("--asset-format <csv>", "文件格式，逗号分隔")
+        .option("--tag-ids <csv>", "标签 ID，逗号分隔")
+        .option("--page-size <1-100>", "请求分页大小", pageSize)
+        .option("--cursor <id>", "分页游标")
+        .option("--json", "输出 JSON");
+}
+function browseInput(command) {
+    const options = command.opts();
+    return {
+        ...defined("repositoryId", options.repositoryId),
+        ...(options.allRepositories === true ? { allRepositories: true } : {}),
+        ...defined("folderId", options.folderId),
+        ...(command.getOptionValueSource("includeChildFolder") === "cli"
+            ? { includeChildFolder: false }
+            : {}),
+        ...defined("type", options.type),
+        ...defined("assetFormats", csv(options.assetFormat)),
+        ...defined("tagIds", csv(options.tagIds)),
+        ...defined("pageSize", options.pageSize),
+        ...defined("cursor", options.cursor)
+    };
+}
+function defined(key, value) {
+    return value === undefined ? {} : { [key]: value };
+}
+function csv(value) {
+    return value?.split(",").map((item) => item.trim()).filter((item) => item !== "");
+}
+function pageSize(value) {
+    if (!/^\d+$/u.test(value))
+        throw new CliUsageError();
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 100)
+        throw new CliUsageError();
+    return parsed;
+}
+function position(command, index) {
+    const value = command.processedArgs[index];
+    if (typeof value !== "string")
+        throw new CliUsageError();
+    return value;
+}
+function organizationAccess(state) {
+    return {
+        credential: state.credential,
+        organizationId: state.organization.id
+    };
+}
+function assetListView(value) {
+    const assets = value.assets;
+    if (assets.length === 0)
+        return "暂无素材。";
+    return [
+        "ID\t标题\t类型\t格式",
+        ...assets.map(assetRow)
+    ].join("\n");
+}
+function assetRow(asset) {
+    return [asset.asset_id, asset.title ?? "", asset.type ?? "", asset.format ?? ""].join("\t");
+}
+function assetDetailView(value) {
+    const asset = value;
+    return [
+        `素材：${asset.title ?? asset.asset_id}`,
+        `ID：${asset.asset_id}`,
+        ...(asset.type === undefined ? [] : [`类型：${asset.type}`]),
+        ...(asset.format === undefined ? [] : [`格式：${asset.format}`]),
+        ...(asset.url === undefined ? [] : [`URL：${asset.url}`])
+    ].join("\n");
+}

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

@@ -0,0 +1,73 @@
+import { bindAction, bindPreparedAction } from "./action-binding.js";
+export function registerEditorCommands(program, runtime) {
+    const editor = program.command("editor")
+        .description("连接并操作 AI+ Editor")
+        .helpCommand(false);
+    const connect = leaf(editor.command("connect"))
+        .description("打开并连接一个 AI+ Editor 作品")
+        .argument("[target]", "作品 ID 或完整 URL");
+    bindPreparedAction(connect, "none", async (signal) => {
+        signal.throwIfAborted();
+        const target = connect.processedArgs[0];
+        const input = typeof target === "string" ? { target } : {};
+        runtime.validators.editorConnectInput(input);
+        return { handled: false, input };
+    }, async (_context, input, signal) => {
+        const result = await runtime.editor.connect({ input, signal });
+        writeJson(runtime, result);
+    });
+    const disconnect = leaf(editor.command("disconnect"))
+        .description("断开当前 Editor 连接");
+    bindAction(disconnect, "none", async (_context, signal) => {
+        writeJson(runtime, await runtime.editor.disconnect({ signal }));
+    });
+    const snapshot = leaf(editor.command("snapshot"))
+        .description("读取当前作品快照");
+    bindAction(snapshot, "none", async (_context, signal) => {
+        writeJson(runtime, await runtime.editor.snapshot({ signal }));
+    });
+    const apply = leaf(editor.command("apply"))
+        .description("按顺序应用元素操作")
+        .requiredOption("--input <file|->", "从文件或标准输入读取 JSON");
+    bindPreparedAction(apply, "none", async (signal) => {
+        signal.throwIfAborted();
+        const source = apply.opts().input;
+        const input = await runtime.jsonInput.read(source, signal);
+        runtime.validators.editorApplyInput(input);
+        return { handled: false, input };
+    }, async (_context, input, signal) => {
+        writeJson(runtime, await runtime.editor.apply({ input, signal }));
+    });
+    const screenshot = leaf(editor.command("screenshot"))
+        .description("导出当前作品 PNG 截图")
+        .option("--json", "输出 JSON");
+    bindAction(screenshot, "none", async (_context, signal) => {
+        const result = await runtime.editor.screenshot({ signal });
+        runtime.presenter.result(result, {
+            json: screenshot.opts().json === true,
+            view: screenshotView
+        });
+    });
+    const save = leaf(editor.command("save"))
+        .description("保存当前 AI+ Editor 作品")
+        .option("--json", "输出 JSON");
+    bindAction(save, "none", async (_context, signal) => {
+        const result = await runtime.editor.save({ signal });
+        runtime.presenter.result(result, {
+            json: save.opts().json === true,
+            view: saveView
+        });
+    });
+}
+function leaf(command) {
+    return command.allowExcessArguments(false);
+}
+function writeJson(runtime, value) {
+    runtime.io.writeOut(`${JSON.stringify(value)}\n`);
+}
+function screenshotView(value) {
+    return `截图已保存至 ${value.path}`;
+}
+function saveView(value) {
+    return `作品已保存：${value.url}`;
+}

package/dist/src/cli/errors.js

@@ -0,0 +1,90 @@
+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 { ObjectStorageUploadError } from "../features/dam/object-storage.js";
+import { DamInputError } 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 { 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";
+    }
+}
+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 (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 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,47 @@
+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 };
+        runtime.validators.modelListInput(input);
+        const result = await runtime.tool.listModels({
+            input,
+            access: {
+                credential: context.state.credential,
+                organizationId: context.state.organization.id
+            },
+            signal
+        });
+        runtime.validators.modelListOutput(result);
+        runtime.io.writeOut(`${JSON.stringify(result)}\n`);
+    });
+    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 };
+        runtime.validators.modelGetInput(input);
+        const result = await runtime.tool.getModel({
+            input,
+            access: {
+                credential: context.state.credential,
+                organizationId: context.state.organization.id
+            },
+            signal
+        });
+        runtime.validators.modelGetOutput(result);
+        runtime.io.writeOut(`${JSON.stringify(result)}\n`);
+    });
+}

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

@@ -0,0 +1,52 @@
+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 });
+        runtime.validators.orgList(result);
+        runtime.presenter.result(result, {
+            json: list.opts().json === true,
+            view: orgListView
+        });
+    });
+    const current = leaf(org.command("current"))
+        .description("查看当前组织")
+        .option("--json", "输出 JSON");
+    bindAction(current, "none", async () => {
+        const result = await runtime.org.current();
+        runtime.validators.orgCurrent(result);
+        runtime.presenter.result(result, {
+            json: current.opts().json === true,
+            view: orgCurrentView
+        });
+    });
+    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
+        });
+        runtime.presenter.success(`已切换到${record.publicName} (${record.id})。`);
+    });
+}
+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,80 @@
+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));
+        },
+        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 })}\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`);
+            }
+        }
+    };
+}
+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));
+};
+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,65 @@
+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
+        });
+        runtime.validators.toolListOutput(result);
+        runtime.io.writeOut(`${JSON.stringify(result)}\n`);
+    });
+    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.io.writeOut(`${JSON.stringify(schema)}\n`);
+            return;
+        }
+        const result = await runtime.tool.call({
+            input: prepared.input,
+            access,
+            signal
+        });
+        runtime.validators.toolCallOutput(result);
+        runtime.io.writeOut(`${JSON.stringify(result)}\n`);
+    });
+}

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

@@ -0,0 +1,12 @@
+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);
+        runtime.presenter.success(result.updated
+            ? `gd-cli 已更新到 ${result.version}，Agent Skill 已同步。`
+            : `gd-cli ${result.version} 已是最新版本，Agent Skill 已同步。`);
+    });
+}

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"));
+}