@gaoding/cli 0.0.0 → 1.0.0-alpha.25

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present GDHub Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,42 @@
-# @gaoding/cli
+# GaoDing CLI
 
-Placeholder package for the Gaoding CLI.
+稿定面向 Agent 与人的命令行产品，提供 Agent 创作、Tool/Model 调用、AI+ Editor 操作和 DAM 素材管理。
 
-This package does not provide any functionality yet.
+## 安装
+
+需要 Node.js 20 或更高版本。使用 npm 或 pnpm 全局安装：
+
+```bash
+npm install --global --allow-scripts=@gaoding/cli @gaoding/cli
+# 或
+pnpm add --global --allow-build=@gaoding/cli @gaoding/cli
+```
+
+全局安装和后续包升级会自动同步随包 `gd-cli` Agent Skill 到 canonical 目录，并连接已检测到的 Agent 宿主。npm 的 `--allow-scripts=@gaoding/cli` 与 pnpm 的 `--allow-build=@gaoding/cli` 分别只允许本包执行安装脚本。若安装时使用了 `--ignore-scripts`，执行以下命令补齐：
+
+```bash
+gd-cli update
+```
+
+## 开始使用
+
+```bash
+gd-cli auth login
+gd-cli org list
+gd-cli org switch --org <org-id>
+
+gd-cli agent send --schema
+gd-cli tool list
+gd-cli model list --tool <tool>
+gd-cli model get <model>
+```
+
+选定 Model 后，以 `model get` 返回的 `parameters` 与 `usageDescription` 构造实际输入；其中 `cost` 是当前上架 SKU 的稿豆价格区间，不表示某次调用的实际扣费。`tool call --schema` 只给出整个 Tool 的参数并集。运行 `gd-cli --help` 查看当前命令；运行任一命令的 `--help` 查看参数。
+
+CLI 最多每小时检查一次 npm `latest`，发现新版本后每天最多在 stderr 提醒一次；检查失败不影响原命令，`CI=true` 时跳过。普通启动不会检查或修复 Agent Skill。`gd-cli update` 始终实时检查 `latest`，支持更新 npm、pnpm 全局安装并同步 Agent Skill。
+
+发布切换必须先完成精确版本的安装验收，再执行仓库中的 `scripts/promote-latest.mjs`；不要直接用未校验的 `npm dist-tag add` 移动 `latest`。
+
+## License
+
+MIT

package/contracts/operations/agent.send/input.schema.json

@@ -0,0 +1,353 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AgentSendInput",
+  "description": "发送给稿定 Agent 的结构化创作消息。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "message"
+  ],
+  "properties": {
+    "message": {
+      "$ref": "#/$defs/UserMessage",
+      "description": "本次发送的消息。"
+    }
+  },
+  "$defs": {
+    "UserMessage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "parts"
+      ],
+      "properties": {
+        "contextId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "继续已有创作 Context 时使用服务端返回的标识。"
+        },
+        "parts": {
+          "type": "array",
+          "minItems": 1,
+          "description": "按顺序发送的消息内容。",
+          "items": {
+            "$ref": "#/$defs/UserPart"
+          }
+        }
+      },
+      "allOf": [
+        {
+          "properties": {
+            "parts": {
+              "type": "array",
+              "contains": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/TextPart"
+                  },
+                  {
+                    "$ref": "#/$defs/QuestionAnswerPart"
+                  }
+                ]
+              },
+              "minContains": 1
+            }
+          }
+        },
+        {
+          "properties": {
+            "parts": {
+              "type": "array",
+              "contains": {
+                "$ref": "#/$defs/GenerationConstraintsPart"
+              },
+              "minContains": 0,
+              "maxContains": 1
+            }
+          }
+        },
+        {
+          "properties": {
+            "parts": {
+              "type": "array",
+              "contains": {
+                "$ref": "#/$defs/QuestionAnswerPart"
+              },
+              "minContains": 0,
+              "maxContains": 1
+            }
+          }
+        },
+        {
+          "properties": {
+            "parts": {
+              "type": "array",
+              "contains": {
+                "$ref": "#/$defs/FirstFramePart"
+              },
+              "minContains": 0,
+              "maxContains": 1
+            }
+          }
+        },
+        {
+          "properties": {
+            "parts": {
+              "type": "array",
+              "contains": {
+                "$ref": "#/$defs/LastFramePart"
+              },
+              "minContains": 0,
+              "maxContains": 1
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "parts": {
+                "type": "array",
+                "contains": {
+                  "$ref": "#/$defs/QuestionAnswerPart"
+                },
+                "minContains": 1
+              }
+            },
+            "required": [
+              "parts"
+            ]
+          },
+          "then": {
+            "type": "object",
+            "properties": {
+              "contextId": {
+                "type": "string"
+              },
+              "parts": {
+                "type": "array",
+                "maxItems": 1
+              }
+            },
+            "required": [
+              "contextId"
+            ]
+          }
+        }
+      ]
+    },
+    "UserPart": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/TextPart"
+        },
+        {
+          "$ref": "#/$defs/InputAssetPart"
+        },
+        {
+          "$ref": "#/$defs/GenerationConstraintsPart"
+        },
+        {
+          "$ref": "#/$defs/QuestionAnswerPart"
+        }
+      ]
+    },
+    "TextPart": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "text"
+      ],
+      "properties": {
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "创作要求或补充说明。"
+        }
+      }
+    },
+    "InputAssetPart": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "url"
+      ],
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "HTTP(S) 素材或由 CLI 处理的 file:// 本地文件。"
+        },
+        "mediaType": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "素材 MIME type；无法从 URL 判断时使用。"
+        },
+        "filename": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "素材文件名；无法从 URL 判断时使用。"
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "素材在本次创作中的用途。",
+          "properties": {
+            "role": {
+              "type": "string",
+              "enum": [
+                "reference",
+                "first_frame",
+                "last_frame"
+              ],
+              "description": "素材角色；省略时按 reference 处理。"
+            }
+          }
+        }
+      }
+    },
+    "GenerationConstraintsPart": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "data"
+      ],
+      "properties": {
+        "data": {
+          "type": "object",
+          "additionalProperties": false,
+          "minProperties": 1,
+          "description": "本次创作指定的模型与动态参数；它们不决定 Agent 或 Tool 路由。",
+          "properties": {
+            "model": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": ".*\\S.*",
+              "description": "可选创作模型机器标识；指定时由 CLI 根据实时 Model Catalog 校验。"
+            },
+            "arguments": {
+              "type": "object",
+              "minProperties": 1,
+              "description": "按模型公开字段传递的动态控制参数；素材使用独立 InputAssetPart。",
+              "additionalProperties": true
+            }
+          }
+        }
+      }
+    },
+    "QuestionAnswerPart": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "data"
+      ],
+      "properties": {
+        "data": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "questionMessageId",
+            "answers"
+          ],
+          "description": "对上一轮 Agent 追问的回答。",
+          "properties": {
+            "questionMessageId": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": ".*\\S.*",
+              "description": "上一轮追问消息的标识。"
+            },
+            "answers": {
+              "type": "array",
+              "minItems": 1,
+              "description": "按问题原文给出的回答。",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "question",
+                  "values"
+                ],
+                "properties": {
+                  "question": {
+                    "type": "string",
+                    "minLength": 1,
+                    "pattern": ".*\\S.*",
+                    "description": "上一轮返回的问题原文。"
+                  },
+                  "values": {
+                    "type": "array",
+                    "minItems": 1,
+                    "description": "该问题的一项或多项回答。",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1,
+                      "pattern": ".*\\S.*"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "FirstFramePart": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/InputAssetPart"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "metadata": {
+              "type": "object",
+              "properties": {
+                "role": {
+                  "const": "first_frame"
+                }
+              },
+              "required": [
+                "role"
+              ]
+            }
+          },
+          "required": [
+            "metadata"
+          ]
+        }
+      ]
+    },
+    "LastFramePart": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/InputAssetPart"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "metadata": {
+              "type": "object",
+              "properties": {
+                "role": {
+                  "const": "last_frame"
+                }
+              },
+              "required": [
+                "role"
+              ]
+            }
+          },
+          "required": [
+            "metadata"
+          ]
+        }
+      ]
+    }
+  }
+}

package/contracts/operations/agent.send/output.schema.json

@@ -0,0 +1,271 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AgentSendOutput",
+  "description": "稿定 Agent 同步返回的最终消息与实际稿豆消耗。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "message",
+    "usage"
+  ],
+  "properties": {
+    "message": {
+      "$ref": "#/$defs/AgentMessage",
+      "description": "本次调用返回的最终 Agent 消息。"
+    },
+    "usage": {
+      "$ref": "#/$defs/AgentUsage",
+      "description": "本次调用由最终消息结算的实际稿豆消耗。"
+    }
+  },
+  "$defs": {
+    "ActualCost": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "unit",
+        "amount"
+      ],
+      "properties": {
+        "unit": {
+          "const": "gaodou",
+          "description": "稿豆计价单位。"
+        },
+        "amount": {
+          "type": "number",
+          "minimum": 0,
+          "description": "实际消耗的稿豆数量。"
+        }
+      }
+    },
+    "AgentUsage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "cost",
+        "items"
+      ],
+      "properties": {
+        "cost": {
+          "$ref": "#/$defs/ActualCost",
+          "description": "本次 Agent 调用的实际总消耗。"
+        },
+        "items": {
+          "type": "array",
+          "description": "产生实际消耗的模型调用明细。",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "model",
+              "cost"
+            ],
+            "properties": {
+              "model": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": ".*\\S.*",
+                "description": "实际调用的模型机器标识。"
+              },
+              "cost": {
+                "$ref": "#/$defs/ActualCost",
+                "description": "该次模型调用的实际稿豆消耗。"
+              }
+            }
+          }
+        }
+      }
+    },
+    "AgentMessage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contextId",
+        "parts"
+      ],
+      "properties": {
+        "messageId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "存在追问时返回的真实追问消息标识。"
+        },
+        "contextId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "后续继续创作时使用的 Context 标识。"
+        },
+        "parts": {
+          "type": "array",
+          "minItems": 1,
+          "description": "最终文本、素材或有效追问。",
+          "items": {
+            "$ref": "#/$defs/AgentPart"
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "parts": {
+                "type": "array",
+                "contains": {
+                  "$ref": "#/$defs/QuestionPart"
+                },
+                "minContains": 1
+              }
+            },
+            "required": [
+              "parts"
+            ]
+          },
+          "then": {
+            "type": "object",
+            "properties": {
+              "messageId": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "messageId"
+            ]
+          },
+          "else": {
+            "properties": {
+              "messageId": false
+            }
+          }
+        }
+      ]
+    },
+    "AgentPart": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/TextPart"
+        },
+        {
+          "$ref": "#/$defs/OutputAssetPart"
+        },
+        {
+          "$ref": "#/$defs/QuestionPart"
+        }
+      ]
+    },
+    "TextPart": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "text"
+      ],
+      "properties": {
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "Agent 返回的最终文本。"
+        }
+      }
+    },
+    "OutputAssetPart": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "url",
+        "mediaType"
+      ],
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "生成素材的访问 URL。"
+        },
+        "mediaType": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "生成素材的 MIME type。"
+        },
+        "filename": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "生成素材的文件名。"
+        }
+      }
+    },
+    "QuestionPart": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "data"
+      ],
+      "properties": {
+        "data": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "questions"
+          ],
+          "description": "Agent 要求调用者补充的信息。",
+          "properties": {
+            "title": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": ".*\\S.*",
+              "description": "本轮问题组标题。"
+            },
+            "questions": {
+              "type": "array",
+              "minItems": 1,
+              "description": "Agent 返回的一项或多项问题。",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "question",
+                  "options",
+                  "allowMultiple"
+                ],
+                "properties": {
+                  "question": {
+                    "type": "string",
+                    "minLength": 1,
+                    "pattern": ".*\\S.*",
+                    "description": "需要调用者回答的问题原文。"
+                  },
+                  "options": {
+                    "type": "array",
+                    "description": "可选答案；空数组表示允许自由回答。",
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "required": [
+                        "label"
+                      ],
+                      "properties": {
+                        "label": {
+                          "type": "string",
+                          "minLength": 1,
+                          "pattern": ".*\\S.*",
+                          "description": "一个可选答案的展示文本。"
+                        }
+                      }
+                    }
+                  },
+                  "allowMultiple": {
+                    "type": "boolean",
+                    "description": "是否允许同时选择多个答案。"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/contracts/operations/auth.status/input.schema.json

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