@gaoding/cli 0.0.0 → 1.0.0

package/contracts/operations/editor.snapshot/output.schema.json

@@ -0,0 +1,113 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "EditorSnapshotResult",
+  "description": "当前编辑器中的受支持元素与选区。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["elements", "selectedIds"],
+  "properties": {
+    "elements": {
+      "type": "array",
+      "description": "当前编辑器中的受支持元素。",
+      "items": {
+        "oneOf": [
+          { "$ref": "#/$defs/EditorShape" },
+          { "$ref": "#/$defs/EditorConnector" }
+        ]
+      }
+    },
+    "selectedIds": {
+      "type": "array",
+      "description": "当前选中元素的 ID。",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": ".*\\S.*"
+      }
+    }
+  },
+  "$defs": {
+    "EditorShape": {
+      "title": "EditorShape",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["_type", "id", "shapeType", "x", "y", "w", "h", "fill", "stroke"],
+      "properties": {
+        "_type": {
+          "const": "shape",
+          "description": "元素类型。"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "元素 ID。"
+        },
+        "shapeType": {
+          "type": "string",
+          "enum": ["rectangle", "rounded-rectangle", "triangle-up", "ellipse", "diamond"],
+          "description": "图形类型。"
+        },
+        "x": { "type": "number", "description": "左上角横坐标。" },
+        "y": { "type": "number", "description": "左上角纵坐标。" },
+        "w": { "type": "number", "description": "宽度。" },
+        "h": { "type": "number", "description": "高度。" },
+        "text": { "type": "string", "description": "图形中的文本。" },
+        "fill": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "填充颜色。"
+        },
+        "stroke": {
+          "description": "描边颜色；null 表示无描边。",
+          "anyOf": [
+            { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "EditorConnector": {
+      "title": "EditorConnector",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["_type", "id", "fromId", "toId", "lineType", "color"],
+      "properties": {
+        "_type": {
+          "const": "connector",
+          "description": "元素类型。"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "连线 ID。"
+        },
+        "fromId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "起点元素 ID。"
+        },
+        "toId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "终点元素 ID。"
+        },
+        "lineType": {
+          "type": "string",
+          "enum": ["straight", "elbowed"],
+          "description": "连线类型。"
+        },
+        "color": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*",
+          "description": "连线颜色。"
+        }
+      }
+    }
+  }
+}

package/contracts/operations/model.get/input.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ModelGetInput",
+  "description": "读取一个创作模型完整信息的输入。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "model"
+  ],
+  "properties": {
+    "model": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "要读取的创作模型机器标识。"
+    }
+  }
+}

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

@@ -0,0 +1,191 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ModelDetail",
+  "description": "一个创作模型的完整产品信息。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "tool",
+    "model",
+    "title",
+    "parameters"
+  ],
+  "properties": {
+    "tool": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "模型所属的产品创作工具。"
+    },
+    "model": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "调用模型时使用的机器标识。"
+    },
+    "title": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "模型的展示名称。"
+    },
+    "description": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "模型的用途说明。"
+    },
+    "usageDescription": {
+      "$ref": "#/$defs/NonBlankString",
+      "description": "模型的使用说明。"
+    },
+    "outputMediaTypes": {
+      "type": "array",
+      "description": "模型支持的输出 MIME type。",
+      "items": {
+        "$ref": "#/$defs/NonBlankString"
+      }
+    },
+    "parameters": {
+      "type": "array",
+      "description": "当前模型允许调用者提供的公开参数。",
+      "items": {
+        "$ref": "#/$defs/ModelParameter"
+      }
+    },
+    "cost": {
+      "$ref": "#/$defs/CostRange",
+      "description": "模型当前可用配置的稿豆消耗区间。"
+    },
+    "estimatedTime": {
+      "$ref": "#/$defs/EstimatedTimeRange",
+      "description": "模型当前可用配置的预估耗时区间。"
+    }
+  },
+  "$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": "当前可用配置中的最长预估耗时。"
+        }
+      }
+    },
+    "ModelParameter": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "type",
+        "required"
+      ],
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/NonBlankString",
+          "description": "调用模型时使用的参数名。"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "string",
+            "number",
+            "uri",
+            "uri[]"
+          ],
+          "description": "规范化后的参数类型。"
+        },
+        "required": {
+          "type": "boolean",
+          "description": "调用当前模型时是否必须提供该参数。"
+        },
+        "description": {
+          "$ref": "#/$defs/NonBlankString",
+          "description": "参数的用途说明。"
+        },
+        "default": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "object"
+            },
+            {
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "服务端声明的默认值。"
+        },
+        "options": {
+          "type": "array",
+          "description": "选择型参数当前允许的值。",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "value"
+            ],
+            "properties": {
+              "value": {
+                "$ref": "#/$defs/NonBlankString",
+                "description": "调用时提供的选项值。"
+              },
+              "label": {
+                "$ref": "#/$defs/NonBlankString",
+                "description": "选项的展示名称。"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ModelListInput",
+  "description": "列出当前可用创作模型的输入。",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "tool": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": ".*\\S.*",
+      "description": "可选的创作工具机器标识。"
+    }
+  }
+}

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
+    }
+  }
+}