gaoding-cli 1.0.0-alpha.21 → 1.0.0-alpha.22

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

@@ -1,9 +1,203 @@
-import { bindPreparedAction } from "./action-binding.js";
+import { bindAction, bindPreparedAction } from "./action-binding.js";
 import { CliUsageError } from "./errors.js";
+import { repositoryListView } from "./presenter.js";
 export function registerDamCommands(program, runtime) {
     const dam = program.command("dam")
         .description("DAM 素材管理")
         .helpCommand(false);
+    const repository = dam.command("repository")
+        .description("DAM 资源库")
+        .helpCommand(false);
+    const repositoryList = leaf(repository.command("list"))
+        .description("列出可用资源库")
+        .option("--json", "输出 JSON");
+    bindAction(repositoryList, "organization", async (context, signal) => {
+        const result = await runtime.telemetry.stage("repository", () => (runtime.dam.repositoryList({
+            access: organizationAccess(context.state),
+            signal
+        })));
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: repositoryList.opts().json === true,
+                view: repositoryListView
+            });
+        });
+    }, { operation: "dam.repository.list" });
+    const folder = dam.command("folder")
+        .description("DAM 文件夹")
+        .helpCommand(false);
+    const folderList = leaf(folder.command("list"))
+        .description("列出文件夹")
+        .option("--repository-id <id>", "指定资源库 ID")
+        .option("--parent-id <id>", "父文件夹 ID")
+        .option("--query <text>", "按名称筛选")
+        .option("--page <n>", "页码", positiveInteger)
+        .option("--page-size <1-100>", "分页大小", pageSize)
+        .option("--json", "输出 JSON");
+    bindPreparedAction(folderList, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = folderList.opts();
+        const input = {
+            ...defined("repositoryId", options.repositoryId),
+            ...defined("parentId", options.parentId),
+            ...defined("query", options.query),
+            ...defined("page", options.page),
+            ...defined("pageSize", options.pageSize)
+        };
+        runtime.validators.damFolderListInput(input);
+        runtime.telemetry.annotate({ parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.folderList({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: folderList.opts().json === true,
+                view: folderListView
+            });
+        });
+    }, { operation: "dam.folder.list" });
+    const tag = dam.command("tag")
+        .description("DAM 标签")
+        .helpCommand(false);
+    const tagList = leaf(tag.command("list"))
+        .description("列出标签")
+        .option("--repository-id <id>", "指定资源库 ID")
+        .option("--query <text>", "按名称筛选")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(tagList, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = tagList.opts();
+        const input = {
+            ...defined("repositoryId", options.repositoryId),
+            ...defined("query", options.query)
+        };
+        runtime.validators.damTagListInput(input);
+        runtime.telemetry.annotate({ parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.tagList({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: tagList.opts().json === true,
+                view: tagListView
+            });
+        });
+    }, { operation: "dam.tag.list" });
+    const download = leaf(dam.command("download"))
+        .description("下载一个素材")
+        .argument("<asset>", "素材 ID")
+        .option("--repository-id <id>", "所属资源库 ID")
+        .option("--output-dir <directory>", "输出目录")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(download, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = download.opts();
+        const input = {
+            asset_id: position(download, 0),
+            ...defined("repositoryId", options.repositoryId),
+            ...defined("outputDir", options.outputDir)
+        };
+        runtime.validators.damDownloadInput(input);
+        runtime.telemetry.annotate({ content_id: input.asset_id, parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.download({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: download.opts().json === true,
+                view: downloadView
+            });
+        });
+    }, { operation: "dam.download" });
+    const rename = leaf(dam.command("rename"))
+        .description("重命名一个素材或文件夹")
+        .argument("<entry>", "素材或文件夹 ID")
+        .requiredOption("--kind <asset|folder>", "条目类型")
+        .requiredOption("--title <title>", "新标题")
+        .option("--repository-id <id>", "所属资源库 ID")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(rename, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = rename.opts();
+        const input = {
+            entry_id: position(rename, 0),
+            kind: options.kind,
+            title: options.title,
+            ...defined("repositoryId", options.repositoryId)
+        };
+        runtime.validators.damRenameInput(input);
+        runtime.telemetry.annotate({ content_id: input.entry_id, parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.rename({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: rename.opts().json === true,
+                view: renameView
+            });
+        });
+    }, { operation: "dam.rename" });
+    for (const operation of ["move", "copy"]) {
+        const command = leaf(dam.command(operation))
+            .description(operation === "move" ? "移动一个素材或文件夹" : "复制一个素材或文件夹")
+            .argument("<entry>", "素材或文件夹 ID")
+            .requiredOption("--kind <asset|folder>", "条目类型")
+            .requiredOption("--target-folder-id <id>", "目标文件夹 ID；根目录使用 0")
+            .option("--repository-id <source-id>", "源资源库 ID")
+            .option("--target-repository-id <target-id>", "目标资源库 ID")
+            .option("--json", "输出 JSON");
+        bindPreparedAction(command, "organization", async (signal) => {
+            signal.throwIfAborted();
+            const options = command.opts();
+            const input = {
+                entry_id: position(command, 0),
+                kind: options.kind,
+                targetFolderId: options.targetFolderId,
+                ...defined("repositoryId", options.repositoryId),
+                ...defined("targetRepositoryId", options.targetRepositoryId)
+            };
+            if (operation === "move")
+                runtime.validators.damMoveInput(input);
+            else
+                runtime.validators.damCopyInput(input);
+            runtime.telemetry.annotate({ content_id: input.entry_id, parameters: { ...input } });
+            return { handled: false, input: input };
+        }, async (context, input, signal) => {
+            const result = operation === "move"
+                ? await runtime.dam.move({
+                    input: input,
+                    access: organizationAccess(context.state),
+                    signal
+                })
+                : await runtime.dam.copy({
+                    input: input,
+                    access: organizationAccess(context.state),
+                    signal
+                });
+            await runtime.telemetry.stage("output", async () => {
+                runtime.presenter.result(result, {
+                    json: command.opts().json === true,
+                    view: operation === "move" ? moveView : copyView
+                });
+            });
+        }, { operation: `dam.${operation}` });
+    }
     const list = browseCommand(leaf(dam.command("list")))
         .description("查看最近素材");
     bindPreparedAction(list, "organization", async (signal) => {
@@ -186,6 +380,14 @@ function pageSize(value) {
         throw new CliUsageError();
     return parsed;
 }
+function positiveInteger(value) {
+    if (!/^\d+$/u.test(value))
+        throw new CliUsageError();
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 1)
+        throw new CliUsageError();
+    return parsed;
+}
 function position(command, index) {
     const value = command.processedArgs[index];
     if (typeof value !== "string")
@@ -220,3 +422,48 @@ function assetDetailView(value) {
         ...(asset.url === undefined ? [] : [`URL：${asset.url}`])
     ].join("\n");
 }
+function folderListView(value) {
+    const folders = value.folders;
+    if (folders.length === 0)
+        return "暂无文件夹。";
+    return [
+        "ID\t名称\t子文件夹数\t素材数",
+        ...folders.map((folder) => [
+            folder.folder_id,
+            folder.title,
+            folder.child_folder_count,
+            folder.asset_count
+        ].join("\t"))
+    ].join("\n");
+}
+function tagListView(value) {
+    const tags = value.tags;
+    if (tags.length === 0)
+        return "暂无标签。";
+    return [
+        "ID\t名称\t素材数",
+        ...tags.map((tag) => [tag.tag_id, tag.name, tag.asset_count].join("\t"))
+    ].join("\n");
+}
+function downloadView(value) {
+    return value.files
+        .map((file) => `已下载：${file.path}`)
+        .join("\n");
+}
+function renameView(value) {
+    const result = value;
+    return `已重命名：${result.title} (${result.entry_id})`;
+}
+function moveView(value) {
+    const result = value;
+    return `已移动至：${result.repository_id} / ${result.folder_id}`;
+}
+function copyView(value) {
+    const result = value;
+    return [
+        `已复制至：${result.repository_id} / ${result.folder_id}`,
+        ...(result.copied_entry_id === undefined
+            ? []
+            : [`复制条目 ID：${result.copied_entry_id}`])
+    ].join("\n");
+}

package/dist/src/cli/errors.js

@@ -7,8 +7,10 @@ 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 { DamAssetNotFoundError } from "../features/dam/dam-api-adapter.js";
-import { DamInputError } from "../features/dam/use-cases.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";
@@ -80,6 +82,24 @@ export function mapCliError(error, options) {
     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

package/dist/src/cli/presenter.js

@@ -74,6 +74,18 @@ export const orgCurrentView = (value) => {
         ? `当前组织: ${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");
 }