gaoding-cli 1.0.0-alpha.10

package/contracts/operations/model.list/output.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ModelListResult",
+  "description": "当前可用的创作模型摘要。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "models"
+  ],
+  "properties": {
+    "models": {
+      "type": "array",
+      "description": "当前已发布且至少有一个上架 SKU 的创作模型。",
+      "items": {
+        "$ref": "#/$defs/ModelSummary"
+      }
+    }
+  },
+  "$defs": {
+    "NonBlankString": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*"
+    },
+    "CostRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "unit",
+        "minimum",
+        "maximum"
+      ],
+      "properties": {
+        "unit": {
+          "const": "gaodou",
+          "description": "稿豆计价单位。"
+        },
+        "minimum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最低稿豆消耗。"
+        },
+        "maximum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最高稿豆消耗。"
+        }
+      }
+    },
+    "EstimatedTimeRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "unit",
+        "minimum",
+        "maximum"
+      ],
+      "properties": {
+        "unit": {
+          "const": "second",
+          "description": "秒级耗时单位。"
+        },
+        "minimum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最短预估耗时。"
+        },
+        "maximum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最长预估耗时。"
+        }
+      }
+    },
+    "ModelSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "tool",
+        "model",
+        "title"
+      ],
+      "properties": {
+        "tool": {
+          "$ref": "#/$defs/NonBlankString",
+          "description": "模型所属的产品创作工具。"
+        },
+        "model": {
+          "$ref": "#/$defs/NonBlankString",
+          "description": "调用模型时使用的机器标识。"
+        },
+        "title": {
+          "$ref": "#/$defs/NonBlankString",
+          "description": "模型的展示名称。"
+        },
+        "description": {
+          "$ref": "#/$defs/NonBlankString",
+          "description": "模型的用途说明。"
+        },
+        "cost": {
+          "$ref": "#/$defs/CostRange",
+          "description": "模型当前可用配置的稿豆消耗区间。"
+        },
+        "estimatedTime": {
+          "$ref": "#/$defs/EstimatedTimeRange",
+          "description": "模型当前可用配置的预估耗时区间。"
+        }
+      }
+    }
+  }
+}

package/contracts/operations/org.current/input.schema.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.gaoding.com/operations/org.current/input.schema.json",
+  "title": "OrgCurrentInput",
+  "type": "object",
+  "additionalProperties": false
+}

package/contracts/operations/org.current/output.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.gaoding.com/operations/org.current/output.schema.json",
+  "title": "OrgCurrentResult",
+  "description": "本机当前选择的组织。",
+  "type": "object",
+  "required": [
+    "organization",
+    "next_steps"
+  ],
+  "properties": {
+    "organization": {
+      "description": "本机当前选择的组织；尚未选择时为 null。",
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "name"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "当前组织 ID。"
+            },
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "description": "当前组织名称。"
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "next_steps": {
+      "type": "array",
+      "description": "尚未选择组织时的下一步命令。",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/operations/org.list/input.schema.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.gaoding.com/operations/org.list/input.schema.json",
+  "title": "OrgListInput",
+  "type": "object",
+  "additionalProperties": false
+}

package/contracts/operations/org.list/output.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.gaoding.com/operations/org.list/output.schema.json",
+  "title": "OrgListResult",
+  "description": "当前账号可以访问的组织列表。",
+  "type": "object",
+  "required": [
+    "orgs",
+    "current_org_id"
+  ],
+  "properties": {
+    "orgs": {
+      "type": "array",
+      "description": "当前账号可以访问的组织。",
+      "items": {
+        "$ref": "#/$defs/OrgSummary"
+      }
+    },
+    "current_org_id": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "本机当前选择的组织 ID；尚未选择时为 null。"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "OrgSummary": {
+      "type": "object",
+      "required": [
+        "id",
+        "name"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "组织 ID。"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "组织名称。"
+        },
+        "type": {
+          "type": "string",
+          "description": "组织类型。"
+        },
+        "status": {
+          "type": "string",
+          "description": "组织状态。"
+        },
+        "product_name": {
+          "type": "string",
+          "description": "当前产品版本名称。"
+        },
+        "product_type": {
+          "type": "string",
+          "description": "当前产品版本类型。"
+        },
+        "expires_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "产品到期时间，ISO 8601。"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/contracts/operations/tool.call/input.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ToolCallInput",
+  "description": "调用一个产品创作工具的结构化输入。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "name",
+    "arguments"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "要调用的产品创作工具机器标识。"
+    },
+    "arguments": {
+      "type": "object",
+      "description": "当前工具与模型接受的动态参数。",
+      "required": [
+        "model"
+      ],
+      "properties": {
+        "model": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "要调用的创作模型机器标识。"
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/contracts/operations/tool.call/output.schema.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ToolCallOutput",
+  "description": "创作工具同步返回的最终内容与所选模型成本。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "content",
+    "usage"
+  ],
+  "properties": {
+    "content": {
+      "type": "array",
+      "description": "创作工具最终产出的文本或资源链接。",
+      "items": {
+        "oneOf": [
+          {
+            "$ref": "#/$defs/TextContent"
+          },
+          {
+            "$ref": "#/$defs/ResourceLink"
+          }
+        ]
+      }
+    },
+    "usage": {
+      "$ref": "#/$defs/ToolUsage",
+      "description": "本次调用所选模型及 Model Catalog 声明的成本。"
+    }
+  },
+  "$defs": {
+    "CostRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "unit",
+        "minimum",
+        "maximum"
+      ],
+      "properties": {
+        "unit": {
+          "const": "gaodou",
+          "description": "稿豆计价单位。"
+        },
+        "minimum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最低稿豆消耗。"
+        },
+        "maximum": {
+          "type": "number",
+          "minimum": 0,
+          "description": "当前可用配置中的最高稿豆消耗。"
+        }
+      }
+    },
+    "ToolUsage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "model"
+      ],
+      "properties": {
+        "model": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "本次调用选择的模型机器标识。"
+        },
+        "cost": {
+          "$ref": "#/$defs/CostRange",
+          "description": "Model Catalog 声明的稿豆消耗区间。"
+        }
+      }
+    },
+    "TextContent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "text"
+      ],
+      "properties": {
+        "type": {
+          "const": "text",
+          "description": "文本内容的固定类型。"
+        },
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "创作工具返回的文本。"
+        }
+      }
+    },
+    "ResourceLink": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "uri",
+        "name"
+      ],
+      "properties": {
+        "type": {
+          "const": "resource_link",
+          "description": "资源链接的固定类型。"
+        },
+        "uri": {
+          "type": "string",
+          "format": "uri",
+          "description": "创作工具生成资源的 URI。"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "资源的文件名。"
+        },
+        "mimeType": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "资源的 MIME type。"
+        }
+      }
+    }
+  }
+}

package/contracts/operations/tool.list/input.schema.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ToolListInput",
+  "description": "列出当前可用产品创作工具的输入。",
+  "type": "object",
+  "additionalProperties": false
+}

package/contracts/operations/tool.list/output.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ToolListResult",
+  "description": "当前可用的产品创作工具。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "tools"
+  ],
+  "properties": {
+    "tools": {
+      "type": "array",
+      "description": "当前至少有一个可用模型的产品创作工具。",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": ".*\\S.*",
+            "description": "调用创作工具时使用的机器标识。"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": ".*\\S.*",
+            "description": "创作工具的展示名称。"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": ".*\\S.*",
+            "description": "创作工具的用途说明。"
+          }
+        }
+      }
+    }
+  }
+}

package/dist/bin/gd-cli.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { createCli, executeCli } from "../src/bootstrap/create-cli.js";
+import { createProductionRuntime } from "../src/bootstrap/create-runtime.js";
+import { mapCliError } from "../src/cli/errors.js";
+import { redact } from "../src/platform/redact.js";
+const controller = new AbortController();
+const interrupt = () => controller.abort(new Error("SIGINT"));
+process.once("SIGINT", interrupt);
+let runtime;
+try {
+    runtime = createProductionRuntime();
+    const program = createCli(runtime, { signal: controller.signal });
+    process.exitCode = await executeCli({
+        program,
+        argv: process.argv.slice(2),
+        presenter: runtime.presenter,
+        signal: controller.signal
+    });
+}
+catch (error) {
+    const outcome = redact(mapCliError(error, { aborted: controller.signal.aborted }));
+    if (runtime) {
+        runtime.presenter.error(outcome, { json: process.argv.includes("--json") });
+    }
+    else if (outcome.kind === "interrupted") {
+        process.stderr.write("已取消。\n");
+    }
+    else if (process.argv.includes("--json")) {
+        process.stderr.write(`${JSON.stringify({ error: outcome.failure })}\n`);
+    }
+    else {
+        process.stderr.write(`${outcome.failure.code}: ${outcome.failure.message}\n`);
+    }
+    process.exitCode = outcome.exitCode;
+}
+finally {
+    process.removeListener("SIGINT", interrupt);
+}

package/dist/bin/postinstall.js

@@ -0,0 +1,42 @@
+import { fileURLToPath } from "node:url";
+import { resolve } from "node:path";
+import { loadBundledSkills } from "../src/features/skill/bundled-skills.js";
+import { syncBundledSkills } from "../src/features/skill/installer.js";
+export function isSupportedGlobalLifecycle(env) {
+    const userAgent = env.npm_config_user_agent ?? "";
+    if (env.npm_config_global === "true") {
+        return /^(?:npm|pnpm)\//u.test(userAgent);
+    }
+    const initialDirectory = (env.INIT_CWD ?? "").replace(/\\/gu, "/");
+    return userAgent.startsWith("pnpm/")
+        && env.npm_command === "add"
+        && env.npm_lifecycle_event === "postinstall"
+        && env.npm_package_name === "gaoding-cli"
+        && /\/v\d+\/[0-9a-f]+-[0-9a-f]+-[0-9a-f]{16}$/u.test(initialDirectory);
+}
+export async function runPostinstall(options = {}) {
+    const env = options.env ?? process.env;
+    if (!isSupportedGlobalLifecycle(env))
+        return;
+    const writeError = options.writeError ?? ((text) => process.stderr.write(text));
+    try {
+        const skills = (options.loadSkills ?? loadBundledSkills)(options.startFile ?? fileURLToPath(import.meta.url));
+        await (options.syncSkills ?? syncBundledSkills)(skills, {
+            env,
+            ...(options.homeDirectory ? { homeDirectory: options.homeDirectory } : {})
+        });
+    }
+    catch (error) {
+        writeError(`警告: ${oneLineMessage(error)}\n`);
+    }
+}
+function oneLineMessage(error) {
+    const value = error instanceof Error ? error.message : String(error);
+    return value.replace(/\s+/gu, " ").trim() || "Agent Skill 自动安装失败";
+}
+const entryPath = process.argv[1];
+const isDirectEntry = entryPath !== undefined
+    && resolve(entryPath) === fileURLToPath(import.meta.url);
+if (isDirectEntry || process.env.npm_lifecycle_event === "postinstall") {
+    void runPostinstall();
+}

package/dist/src/bootstrap/create-cli.js

@@ -0,0 +1,55 @@
+import { Command } from "commander";
+import { assertAllLeafCommandsBound, configureActionEnvironment } from "../cli/action-binding.js";
+import { registerAgentCommands } from "../cli/agent-commands.js";
+import { registerAuthCommands } from "../cli/auth-commands.js";
+import { isHelpOutcome, mapCliError } from "../cli/errors.js";
+import { registerOrgCommands } from "../cli/org-commands.js";
+import { registerToolCommands } from "../cli/tool-commands.js";
+import { registerModelCommands } from "../cli/model-commands.js";
+import { registerEditorCommands } from "../cli/editor-commands.js";
+import { registerDamCommands } from "../cli/dam-commands.js";
+import { registerUpdateCommand } from "../cli/update-command.js";
+import { redact } from "../platform/redact.js";
+export { assertAllLeafCommandsBound, bindAction } from "../cli/action-binding.js";
+export function createCli(runtime, options) {
+    const program = new Command()
+        .name("gd-cli")
+        .description("稿定命令行工具")
+        .version(runtime.version)
+        .helpCommand(false)
+        .showHelpAfterError(false)
+        .showSuggestionAfterError(false)
+        .allowExcessArguments(false)
+        .exitOverride()
+        .configureOutput({
+        writeOut: runtime.io.writeOut,
+        writeErr: () => undefined
+    });
+    configureActionEnvironment(program, {
+        policies: runtime.accessPolicies,
+        signal: options.signal
+    });
+    registerAuthCommands(program, runtime);
+    registerOrgCommands(program, runtime);
+    registerAgentCommands(program, runtime);
+    registerToolCommands(program, runtime);
+    registerModelCommands(program, runtime);
+    registerEditorCommands(program, runtime);
+    registerDamCommands(program, runtime);
+    registerUpdateCommand(program, runtime);
+    assertAllLeafCommandsBound(program);
+    return program;
+}
+export async function executeCli(options) {
+    try {
+        await options.program.parseAsync(options.argv, { from: "user" });
+        return 0;
+    }
+    catch (error) {
+        if (isHelpOutcome(error))
+            return 0;
+        const outcome = redact(mapCliError(error, { aborted: options.signal.aborted }));
+        options.presenter.error(outcome, { json: options.argv.includes("--json") });
+        return outcome.exitCode;
+    }
+}