gaoding-cli 1.0.0-alpha.5

package/dist/src/middleware/error-handler.js

@@ -0,0 +1,431 @@
+import { ApiError } from "../api/hub-client.js";
+import { DirectApiError } from "../api/direct-client.js";
+import { failedEnvelope, emitJson } from "../core/output/envelope.js";
+import { CliUsageError } from "../core/output/cli-error.js";
+import { isVerbose, isDebug } from "../utils/config.js";
+import { isTransientNetworkError } from "../utils/transient-network-error.js";
+import { detectEntitlementIssue, entitlementCliError, ENTITLEMENT_PRICING_URL, resolveEntitlementPricingUrl, } from "../utils/entitlement.js";
+import { redactSensitiveText, redactSensitiveValue } from "../utils/redact.js";
+const ERROR_GUIDES = {
+    AUTH_MISSING: "请先登录：\n    gd-cli auth login",
+    AUTH_EXPIRED: "凭证已过期，请重新登录：\n    gd-cli auth login",
+    AUTH_REFRESH_FAILED: "凭证刷新失败：\n    gd-cli auth login",
+    AUTH_SCOPE_DENIED: "权限不足，请重新授权",
+    ORG_BIND_EXPIRED: "组织绑定已过期：\n    gd-cli org switch",
+    ORG_INVALID: "当前组织无效：\n    gd-cli org list",
+    PARAM_MISSING: "查看命令帮助：\n    gd-cli <command> --help",
+    PARAM_INVALID: "参数值不合法，请检查参数格式",
+    TOOL_NOT_FOUND: "工具不存在：\n    gd-cli tools ls",
+    APP_NOT_FOUND: "Workflow 不存在：\n    gd-cli workflows ls",
+    TASK_NOT_FOUND: "任务不存在或已过期",
+    RATE_LIMITED: "请求过于频繁，请稍后重试",
+    QUOTA_EXCEEDED: `权益不足，请购买或升级后重试：\n    ${ENTITLEMENT_PRICING_URL}`,
+    ENTITLEMENT_INSUFFICIENT: `权益不足，请购买或升级后重试：\n    ${ENTITLEMENT_PRICING_URL}`,
+};
+export function withErrorHandler(handler) {
+    return async (...args) => {
+        try {
+            await handler(...args);
+        }
+        catch (error) {
+            if (shouldEmitJsonError(args)) {
+                emitJson(failedEnvelope(redactSensitiveValue(toCliErrorBody(error))));
+                process.exit(1);
+            }
+            if (error instanceof CliUsageError) {
+                printCliUsageError(redactSensitiveValue(error.body));
+            }
+            else if (error instanceof DirectApiError) {
+                handleDirectApiError(error);
+            }
+            else if (error instanceof ApiError) {
+                handleApiError(error);
+            }
+            else if (error instanceof Error) {
+                const safeMessage = redactSensitiveText(error.message);
+                if (isRateLimitMessage(safeMessage)) {
+                    console.error("Error: 请求过于频繁，已被平台限流。");
+                    console.error("\n  请稍后重试，或减少并发和连续生成次数。\n");
+                    process.exit(1);
+                }
+                if (isMediaResourceDownloadError(safeMessage)) {
+                    console.error(`Error: ${normalizeMediaResourceMessage(safeMessage)}`);
+                    console.error("\n  请换用可访问的 HTTPS 图片 URL；视频首帧优先使用已验证可访问的图片结果 URL，或先去掉 --image 运行文生视频。\n");
+                    process.exit(1);
+                }
+                if (isToolRouteUnavailableMessage(safeMessage)) {
+                    printToolRouteUnavailableError(safeMessage);
+                    process.exit(1);
+                }
+                const entitlement = detectEntitlementIssue({
+                    message: safeMessage,
+                    detail: error,
+                });
+                if (entitlement) {
+                    printEntitlementError(entitlement.message, entitlement.hint, entitlement.diagnostic_context);
+                    process.exit(1);
+                }
+                const lines = safeMessage.split("\n");
+                console.error(`Error: ${lines[0] ?? ""}`);
+                for (let i = 1; i < lines.length; i++) {
+                    console.error(lines[i]);
+                }
+                if (isVerbose() || isDebug()) {
+                    console.error(redactSensitiveText(error.stack ?? ""));
+                }
+            }
+            else {
+                console.error(`Error: ${redactSensitiveText(String(error))}`);
+            }
+            process.exit(1);
+        }
+    };
+}
+function shouldEmitJsonError(args) {
+    let current = args.find(isCommandLike);
+    while (current) {
+        if (!isCommandLike(current))
+            return false;
+        const format = current.opts().format;
+        const json = current.opts().json;
+        if (json === true)
+            return true;
+        if (format === "json")
+            return true;
+        if (format)
+            return false;
+        current = current.parent;
+    }
+    return !process.stdout.isTTY;
+}
+function isCommandLike(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        "opts" in value &&
+        typeof value.opts === "function");
+}
+function toCliErrorBody(error) {
+    if (error instanceof CliUsageError) {
+        return error.body;
+    }
+    if (error instanceof DirectApiError) {
+        const parsed = parseDirectApiErrorBody(error.body);
+        if (error.statusCode === 429) {
+            return {
+                code: "RATE_LIMITED",
+                type: "business",
+                message: "请求过于频繁，已被平台限流。",
+                hint: ERROR_GUIDES.RATE_LIMITED,
+                retryable: true,
+                detail: redactSensitiveValue(error.body),
+            };
+        }
+        const entitlement = detectEntitlementIssue({
+            code: parsed.code,
+            errorName: parsed.errorName,
+            message: parsed.message,
+            detail: redactSensitiveValue(error.body),
+        });
+        if (entitlement)
+            return redactSensitiveValue(entitlementCliError(entitlement, error.body));
+        if (isToolRouteUnavailableMessage(parsed.message ?? error.message)) {
+            return toolRouteUnavailableCliError(parsed.message ?? error.message, redactSensitiveValue(error.body));
+        }
+        return {
+            code: parsed.code ?? `HTTP_${error.statusCode}`,
+            type: error.statusCode === 401 ? "auth" : "business",
+            message: parsed.message
+                ? normalizeBusinessMessage(parsed.message)
+                : redactSensitiveText(error.message),
+            hint: redactSensitiveText(parsed.hint ?? directApiHint(parsed, error.url) ?? ""),
+            retryable: false,
+            detail: redactSensitiveValue(error.body),
+        };
+    }
+    if (error instanceof ApiError) {
+        const parsed = parseJsonObject(error.body);
+        const code = stringField(parsed, "error_code") ?? stringField(parsed, "error") ?? "API_ERROR";
+        const message = stringField(parsed, "message") ?? error.message;
+        const entitlement = detectEntitlementIssue({
+            code,
+            message,
+            detail: parsed ?? error.body,
+        });
+        if (entitlement)
+            return redactSensitiveValue(entitlementCliError(entitlement, parsed ?? error.body));
+        return {
+            code,
+            type: code.startsWith("AUTH") ? "auth" : "business",
+            message: redactSensitiveText(message),
+            hint: redactSensitiveText(stringField(parsed, "suggestion") ?? errorGuide(code) ?? ""),
+            retryable: false,
+            detail: redactSensitiveValue(parsed ?? error.body),
+        };
+    }
+    if (error instanceof Error) {
+        if (isRateLimitMessage(error.message)) {
+            return {
+                code: "RATE_LIMITED",
+                type: "business",
+                message: "请求过于频繁，已被平台限流。",
+                hint: ERROR_GUIDES.RATE_LIMITED,
+                retryable: true,
+            };
+        }
+        if (isMediaResourceDownloadError(error.message)) {
+            return {
+                code: "MEDIA_RESOURCE_UNREACHABLE",
+                type: "business",
+                message: normalizeMediaResourceMessage(redactSensitiveText(error.message)),
+                hint: "请换用可访问的 HTTPS 图片 URL；视频首帧优先使用已验证可访问的图片结果 URL，或先去掉 --image 运行文生视频。",
+                retryable: false,
+            };
+        }
+        const retryable = isTransientNetworkError(error);
+        const entitlement = detectEntitlementIssue({
+            message: redactSensitiveText(error.message),
+            detail: error,
+        });
+        if (entitlement)
+            return entitlementCliError(entitlement);
+        if (isToolRouteUnavailableMessage(error.message)) {
+            return toolRouteUnavailableCliError(redactSensitiveText(error.message));
+        }
+        return {
+            code: retryable ? "NETWORK_TRANSIENT" : "ERROR",
+            type: retryable ? "network" : "unknown",
+            message: redactSensitiveText(error.message),
+            retryable,
+        };
+    }
+    return {
+        code: "ERROR",
+        type: "unknown",
+        message: redactSensitiveText(String(error)),
+        retryable: false,
+    };
+}
+function printCliUsageError(body) {
+    console.error(`Error: ${body.message}`);
+    console.error(`\n  错误码: ${body.code}`);
+    if (body.reason)
+        console.error(`  原因: ${body.reason}`);
+    const detail = body.detail && typeof body.detail === "object" && !Array.isArray(body.detail)
+        ? body.detail
+        : undefined;
+    const appId = body.app_id ?? stringField(detail, "app_id");
+    const toolId = body.tool_id ?? stringField(detail, "tool_id");
+    if (appId)
+        console.error(`  Workflow: ${appId}`);
+    if (toolId)
+        console.error(`  Tool: ${toolId}`);
+    const missingTools = Array.isArray(body.missing_tools)
+        ? body.missing_tools
+            .map((item) => typeof item === "string"
+            ? item
+            : stringField(item, "id") ?? "")
+            .filter(Boolean)
+        : [];
+    if (missingTools.length > 0) {
+        console.error(`  缺失 Tool: ${missingTools.join(", ")}`);
+    }
+    if (body.hint)
+        console.error(`\n  说明: ${body.hint}`);
+    if (body.next_command)
+        console.error(`\n  下一步: ${body.next_command}`);
+    const listCommand = stringField(detail, "list_command");
+    if (listCommand)
+        console.error(`  查看状态: ${listCommand}`);
+    console.error("");
+}
+function parseDirectApiErrorBody(body) {
+    const parsed = typeof body === "string" ? parseJsonObject(body) : body;
+    if (!parsed || typeof parsed !== "object")
+        return {};
+    const value = parsed;
+    const nestedError = value.error && typeof value.error === "object"
+        ? value.error
+        : undefined;
+    return {
+        code: stringField(nestedError, "error_code") ??
+            stringField(nestedError, "code") ??
+            stringField(value, "error_code") ??
+            stringField(value, "code"),
+        errorName: stringField(nestedError, "error_name") ??
+            stringField(value, "error_name"),
+        message: stringField(nestedError, "message") ?? stringField(value, "message"),
+    };
+}
+function parseJsonObject(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function stringField(value, key) {
+    const field = value?.[key];
+    return typeof field === "string" && field ? field : undefined;
+}
+function handleApiError(error) {
+    let parsed = {};
+    try {
+        parsed = JSON.parse(error.body);
+    }
+    catch {
+        parsed = { message: error.body };
+    }
+    const errorCode = parsed.error_code ?? parsed.error ?? "";
+    const message = redactSensitiveText(parsed.message ?? error.message);
+    const entitlement = detectEntitlementIssue({
+        code: errorCode,
+        message,
+        detail: parsed,
+    });
+    if (entitlement) {
+        printEntitlementError(entitlement.message, entitlement.hint, entitlement.diagnostic_context);
+        return;
+    }
+    console.error(`Error: ${message}`);
+    const guide = redactSensitiveText(parsed.suggestion ?? errorGuide(errorCode) ?? "");
+    if (guide) {
+        console.error(`\n  ${guide}\n`);
+    }
+}
+function handleDirectApiError(error) {
+    const parsed = parseDirectApiErrorBody(error.body);
+    const entitlement = detectEntitlementIssue({
+        code: parsed.code,
+        errorName: parsed.errorName,
+        message: parsed.message,
+        detail: error.body,
+    });
+    if (entitlement) {
+        printEntitlementError(entitlement.message, entitlement.hint, entitlement.diagnostic_context);
+        if (isVerbose() || isDebug()) {
+            const code = parsed.errorName ?? parsed.code;
+            const codeSuffix = code ? ` · ${code}` : "";
+            console.error(`\nHTTP ${error.statusCode}${codeSuffix}`);
+            console.error(`请求: ${redactSensitiveText(error.url)}`);
+            console.error(JSON.stringify(redactSensitiveValue(error.body), null, 2));
+            console.error(redactSensitiveText(error.stack ?? ""));
+        }
+        return;
+    }
+    const message = redactSensitiveText(normalizeBusinessMessage(parsed.message ?? error.message));
+    if (isToolRouteUnavailableMessage(message)) {
+        printToolRouteUnavailableError(message);
+        if (isVerbose() || isDebug()) {
+            const code = parsed.errorName ?? parsed.code;
+            const codeSuffix = code ? ` · ${code}` : "";
+            console.error(`\nHTTP ${error.statusCode}${codeSuffix}`);
+            console.error(`请求: ${redactSensitiveText(error.url)}`);
+            console.error(JSON.stringify(redactSensitiveValue(error.body), null, 2));
+            console.error(redactSensitiveText(error.stack ?? ""));
+        }
+        return;
+    }
+    if (error.statusCode === 429 || isRateLimitMessage(message)) {
+        console.error("Error: 请求过于频繁，已被平台限流。");
+        console.error("\n  请稍后重试，或减少并发和连续生成次数。\n");
+        return;
+    }
+    console.error(`Error: ${message}`);
+    const hint = redactSensitiveText(directApiHint(parsed, error.url) ?? "");
+    if (hint) {
+        console.error(`\n  ${hint}\n`);
+    }
+    if (isVerbose() || isDebug()) {
+        const code = parsed.errorName ?? parsed.code;
+        const codeSuffix = code ? ` · ${code}` : "";
+        console.error(`\nHTTP ${error.statusCode}${codeSuffix}`);
+        console.error(`请求: ${redactSensitiveText(error.url)}`);
+        console.error(JSON.stringify(redactSensitiveValue(error.body), null, 2));
+        console.error(redactSensitiveText(error.stack ?? ""));
+    }
+}
+function printEntitlementError(message, hint, diagnosticContext) {
+    console.error(`Error: ${redactSensitiveText(message)}`);
+    if ((isVerbose() || isDebug()) && diagnosticContext && Object.keys(diagnosticContext).length > 0) {
+        console.error(`\n  诊断上下文: ${formatDiagnosticContext(redactSensitiveValue(diagnosticContext))}`);
+    }
+    console.error(`\n  ${redactSensitiveText(hint)}\n`);
+}
+function formatDiagnosticContext(context) {
+    return Object.entries(context)
+        .filter(([, value]) => value !== undefined && value !== null && value !== "")
+        .map(([key, value]) => `${key}=${redactSensitiveText(Array.isArray(value) ? value.join(",") : String(value))}`)
+        .join(" ");
+}
+function toolRouteUnavailableCliError(message, detail) {
+    return {
+        code: "TOOL_ROUTE_UNAVAILABLE",
+        type: "business",
+        message: normalizeToolRouteUnavailableMessage(message),
+        reason: "tool-route-unavailable",
+        hint: "当前 Tool 的平台生成路由不可用。Agent 应停止重试，不要切换模型、环境、团队或调用内部 raw.dify；请保留本次输入并联系平台确认能力配置。",
+        retryable: false,
+        detail,
+    };
+}
+function printToolRouteUnavailableError(message) {
+    const body = toolRouteUnavailableCliError(message);
+    console.error(`Error: ${body.message}`);
+    console.error(`\n  错误码: ${body.code}`);
+    console.error(`  原因: ${body.reason}`);
+    console.error(`\n  说明: ${body.hint}\n`);
+}
+function isToolRouteUnavailableMessage(message) {
+    return /没有可用的工具|tool-intent 没有返回|tool intent 没有返回|工具路由|模型清单为空|平台.*未开通.*生成|暂未开通的生成通道/i
+        .test(message);
+}
+function normalizeToolRouteUnavailableMessage(message) {
+    const normalized = normalizeBusinessMessage(message);
+    if (/没有可用的工具|tool-intent 没有返回|tool intent 没有返回/i.test(normalized)) {
+        return "当前 Tool 的平台生成路由不可用，未发起生成任务。";
+    }
+    return normalized;
+}
+function normalizeBusinessMessage(message) {
+    if (message === "资产已位于回收站, 不允许访问") {
+        return "资产已位于回收站，无法访问";
+    }
+    return message.replace(/, /g, "，");
+}
+function isRateLimitMessage(message) {
+    return /429|Too Many Requests|rate.?limit|请求过于频繁|限流|频率/i.test(message);
+}
+function isMediaResourceDownloadError(message) {
+    return /resource download failed|image_url.*not valid|content\[\d+\]\.image_url|参考图.*下载|参考图.*视频生成服务|媒体.*下载失败|图片.*下载失败/i
+        .test(message);
+}
+function normalizeMediaResourceMessage(message) {
+    if (/^参考图/.test(message))
+        return message;
+    return "参考图无法被生成服务下载。";
+}
+function directApiHint(parsed, url) {
+    if (parsed.message === "资产已位于回收站, 不允许访问") {
+        return "该素材已被删除到回收站；请在 DAM 中恢复后再访问，或重新上传获取新的 asset_id。";
+    }
+    if (parsed.errorName === "commons.NOT_FOUND" || parsed.code === "404") {
+        return "请确认 asset_id 是否存在、是否属于当前组织，或是否已被删除。";
+    }
+    if (parsed.errorName === "cmc.ORG_EMPTY_ERROR" || parsed.code === "11040022") {
+        return "当前请求缺少业务组织上下文；请先确认已执行 gd-cli org switch，并联系网关/DAM 同学检查组织透传。";
+    }
+    if (/\/dam\/asset\//.test(url)) {
+        return "可使用 gd-cli dam upload <file> 重新上传，或检查当前组织下是否有该素材。";
+    }
+    return undefined;
+}
+function errorGuide(code) {
+    if (code === "QUOTA_EXCEEDED" || code === "ENTITLEMENT_INSUFFICIENT") {
+        return `权益不足，请购买或升级后重试：\n    ${resolveEntitlementPricingUrl()}`;
+    }
+    return ERROR_GUIDES[code];
+}

package/dist/src/middleware/interactive-params.d.ts

@@ -0,0 +1,14 @@
+export interface ParamDef {
+    name: string;
+    description: string;
+    type: "string" | "number" | "boolean" | "select";
+    required: boolean;
+    choices?: {
+        name: string;
+        value: string;
+        description?: string;
+    }[];
+    default?: unknown;
+    validate?: (value: string) => string | true;
+}
+export declare function withInteractiveParams(requiredParams: ParamDef[], optionalParams?: ParamDef[]): (options: Record<string, unknown>) => Promise<Record<string, unknown>>;

package/dist/src/middleware/interactive-params.js

@@ -0,0 +1,53 @@
+import { Prompt } from "../core/prompt/index.js";
+export function withInteractiveParams(requiredParams, optionalParams = []) {
+    return async (options) => {
+        if (!process.stdout.isTTY)
+            return options;
+        const result = { ...options };
+        for (const param of requiredParams) {
+            if (result[param.name] !== undefined && result[param.name] !== "")
+                continue;
+            if (param.type === "select" && param.choices) {
+                result[param.name] = await Prompt.select({
+                    message: param.description,
+                    choices: param.choices,
+                });
+            }
+            else if (param.type === "boolean") {
+                result[param.name] = await Prompt.confirm(param.description, param.default);
+            }
+            else {
+                result[param.name] = await Prompt.text({
+                    message: `${param.description} (${param.name})`,
+                    default: param.default,
+                    validate: param.validate,
+                });
+            }
+        }
+        if (optionalParams.length > 0) {
+            const hasOptionalSet = optionalParams.some((p) => result[p.name] !== undefined);
+            if (!hasOptionalSet) {
+                const customize = await Prompt.confirm("是否自定义可选参数？", false);
+                if (customize) {
+                    for (const param of optionalParams) {
+                        if (param.type === "select" && param.choices) {
+                            result[param.name] = await Prompt.select({
+                                message: param.description,
+                                choices: param.choices,
+                            });
+                        }
+                        else {
+                            const val = await Prompt.text({
+                                message: `${param.description} (${param.name}，留空跳过)`,
+                                default: param.default,
+                            });
+                            if (val)
+                                result[param.name] = val;
+                        }
+                    }
+                }
+            }
+        }
+        return result;
+    };
+}

package/dist/src/middleware/output.d.ts

@@ -0,0 +1,14 @@
+/** 人类可读输出时的业务上下文（工具/应用展示名） */
+export interface HumanFormatContext {
+    /** 如「AI 生图」「电商主图」 */
+    activityLabel?: string;
+}
+export declare function formatOutput(data: unknown, format?: string, humanCtx?: HumanFormatContext): void;
+/** TTY 默认：展示任务/工具结果中的链接与交付物说明，非原始 JSON */
+export declare function printHumanTaskResult(data: unknown, ctx?: HumanFormatContext): void;
+/** 工具列表：扁平列，避免把整份 spec 打进表格 */
+export declare function rowsForToolList(items: unknown[]): Record<string, string>[];
+/** 应用列表 */
+export declare function rowsForAppList(items: unknown[]): Record<string, string>[];
+/** 搜索结果（Tool + App 混合） */
+export declare function rowsForSearchList(items: unknown[]): Record<string, string>[];