@coda-console/protocol 0.0.0 → 1.1.0

package/schemas/plugin/common.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/common.json",
+  "title": "插件清单里共用的写法",
+  "$defs": {
+    "id": {"description": "小写字母、数字和「-」，以字母开头，至多 40 个字符", "type": "string", "pattern": "^[a-z][a-z0-9-]{0,39}$"},
+    "name": {"description": "小写字母、数字和「-」，以字母开头，至多 64 个字符", "type": "string", "pattern": "^[a-z][a-z0-9-]{0,63}$"},
+    "line10": {"description": "不超过 10 字的一行", "type": "string", "maxLength": 10, "pattern": "^(?=.*\\S)[^\\u0000\\r\\n]*$"},
+    "line20": {"description": "不超过 20 字的一行", "type": "string", "maxLength": 20, "pattern": "^(?=.*\\S)[^\\u0000\\r\\n]*$"},
+    "line40": {"description": "不超过 40 字的一行", "type": "string", "maxLength": 40, "pattern": "^(?=.*\\S)[^\\u0000\\r\\n]*$"},
+    "line100": {"description": "不超过 100 字的一行", "type": "string", "maxLength": 100, "pattern": "^(?=.*\\S)[^\\u0000\\r\\n]*$"},
+    "line200": {"description": "不超过 200 字的一行", "type": "string", "maxLength": 200, "pattern": "^(?=.*\\S)[^\\u0000\\r\\n]*$"},
+    "line1000": {"description": "不超过 1000 字的一行", "type": "string", "maxLength": 1000, "pattern": "^(?=.*\\S)[^\\u0000\\r\\n]*$"},
+    "line4096": {"description": "不超过 4096 字的一行", "type": "string", "maxLength": 4096, "pattern": "^(?=.*\\S)[^\\u0000\\r\\n]*$"},
+    "command": {"description": "一行命令，由 sh 运行，不超过 4000 字", "type": "string", "maxLength": 4000, "pattern": "^(?=.*\\S)[^\\u0000\\r\\n]*$"},
+    "symbol": {"description": "SF Symbol 的名字", "type": "string", "maxLength": 100, "pattern": "^[a-z0-9]+(\\.[a-z0-9]+)*$"},
+    "commandHolder": {
+      "description": "{ command }：command 是一行命令",
+      "type": "object",
+      "properties": {"command": {"$ref": "#/$defs/command"}},
+      "required": ["command"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/plugin/composer-modes.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/composer-modes.json",
+  "title": "contributes.composerModes：输入框模式",
+  "description": "输入框能处在的模式：显示什么（图标、标题、发出去是什么、占位与发送按钮），发出的给谁（agent：session 会话的 Agent，own 为它另选的、开新会话跑，off 不显示），在哪些输入框里能进（in：session 会话的、new 新任务的），参数（写法同设置）。打字进入的（trigger，如 !）没有参数，发出的就是会话的。",
+  "type": "array",
+  "maxItems": 10,
+  "items": {
+    "type": "object",
+    "properties": {
+      "id": {"$ref": "common.json#/$defs/id"},
+      "title": {"$ref": "common.json#/$defs/line40"},
+      "icon": {"$ref": "common.json#/$defs/symbol"},
+      "hint": {"$ref": "common.json#/$defs/line200"},
+      "placeholder": {"$ref": "common.json#/$defs/line40"},
+      "sendLabel": {"$ref": "common.json#/$defs/line20"},
+      "agent": {"description": "agent 只能是 session、own、off", "enum": ["session", "own", "off"]},
+      "trigger": {"description": "trigger 是一个标点：!#$%&*+:;=?^|~ 之一", "type": "string", "pattern": "^[!#$%&*+:;=?^|~]$"},
+      "in": {"description": "它出现的输入框：session、new，不重复", "type": "array", "minItems": 1, "uniqueItems": true, "items": {"enum": ["session", "new"]}},
+      "parameters": {"$ref": "#/$defs/parameters"}
+    },
+    "required": ["id", "title", "icon"],
+    "additionalProperties": false,
+    "allOf": [
+      {
+        "if": {"required": ["trigger"]},
+        "then": {
+          "description": "打字进入的模式（trigger）没有参数，也不另选 Agent",
+          "not": {"anyOf": [{"required": ["parameters"]}, {"properties": {"agent": {"const": "own"}}, "required": ["agent"]}]}
+        }
+      },
+      {
+        "if": {"properties": {"agent": {"const": "own"}}, "required": ["agent"]},
+        "then": {
+          "description": "开新会话的模式（agent: own）要从会话里发出，不能在 new 里",
+          "properties": {"in": {"description": "开新会话的模式（agent: own）要从会话里发出，不能在 new 里", "not": {"contains": {"const": "new"}}}}
+        }
+      }
+    ]
+  },
+  "x-unique-by": ["id", "trigger"],
+  "$defs": {
+    "parameters": {
+      "description": "模式的参数：{ type: object, properties, required? }，1–20 个，每个写法同设置，不能是密文",
+      "type": "object",
+      "properties": {
+        "type": {"const": "object"},
+        "properties": {
+          "type": "object",
+          "minProperties": 1,
+          "maxProperties": 20,
+          "propertyNames": {"description": "参数名只用字母和数字，以小写字母开头", "pattern": "^[a-z][A-Za-z0-9]{0,39}$"},
+          "additionalProperties": {
+            "allOf": [
+              {"$ref": "setting.json"},
+              {
+                "description": "参数不能是密文",
+                "not": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]},
+                "properties": {
+                  "additionalProperties": {
+                    "properties": {"properties": {"additionalProperties": {"not": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]}}}}
+                  }
+                }
+              }
+            ]
+          }
+        },
+        "required": {
+          "description": "required 是本模式的参数名，不重复",
+          "type": "array",
+          "uniqueItems": true,
+          "items": {"description": "required 是本模式的参数名，不重复", "type": "string", "x-ref": {"pointer": "2/properties"}}
+        }
+      },
+      "required": ["type", "properties"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/plugin/configuration.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/configuration.json",
+  "title": "contributes.configuration：插件的设置",
+  "description": "照 VS Code 的 contributes.configuration：properties 是设置名 → 声明（setting.json），设置名以「<插件 ID>.」开头；required 是缺了就不能用的设置。",
+  "type": "object",
+  "properties": {
+    "title": {"type": "string"},
+    "properties": {
+      "description": "设置名 → 声明；单值设置是一组，至多一个模型地址（coda-model-url）：检查可用模型按组找它",
+      "type": "object",
+      "propertyNames": {"description": "设置名是插件 ID 加「.」再加字母和数字", "pattern": "^[a-z][a-z0-9-]*(\\.[a-z][A-Za-z0-9]*)+$"},
+      "additionalProperties": {"$ref": "setting.json"},
+      "x-max-contains": {"match": {"properties": {"format": {"const": "coda-model-url"}}, "required": ["format"]}, "max": 1}
+    },
+    "required": {
+      "description": "contributes.configuration.required 是本插件声明过的设置名，不重复",
+      "type": "array",
+      "uniqueItems": true,
+      "items": {"description": "contributes.configuration.required 是本插件声明过的设置名，不重复", "type": "string", "x-ref": {"pointer": "2/properties"}}
+    }
+  }
+}

package/schemas/plugin/endpoints.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/endpoints.json",
+  "title": "contributes.endpoints：客户端发给插件的请求",
+  "description": "id → 回答它的一行命令（请求从标准输入给）；checks 是它检查的本插件设置，客户端在那项设置旁提供「检查」，一项设置至多一个端点。",
+  "type": "array",
+  "maxItems": 20,
+  "items": {
+    "type": "object",
+    "properties": {
+      "id": {"$ref": "common.json#/$defs/id"},
+      "command": {"$ref": "common.json#/$defs/command"},
+      "checks": {"description": "checks 是本插件声明的一项设置", "type": "string", "x-ref": {"pointer": "/contributes/configuration/properties"}}
+    },
+    "required": ["id", "command"],
+    "additionalProperties": false
+  },
+  "x-unique-by": ["id", "checks"]
+}

package/schemas/plugin/environment.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/environment.json",
+  "title": "contributes.environment：给项目里启动的东西的环境变量",
+  "description": "变量名 → 值，不超过 100 个。值里可以写 ${config:<本插件的单值设置>}（不能是密文：密文从 CODA_PLUGIN_SECRETS 给的文件读）、${CODA_PLUGIN_PATH}、${CODA_PLUGIN_STATE}。PATH 由 contributes.path 给；Coda 自己的变量与 shell 的钩子不归插件。",
+  "type": "object",
+  "maxProperties": 100,
+  "propertyNames": {
+    "description": "变量名只用字母、数字和「_」，不以数字开头，也不能是 PATH、ZDOTDIR、BASH_ENV 或 CODA_、BASH_FUNC_ 开头的",
+    "pattern": "^(?!(PATH|ZDOTDIR|BASH_ENV|CODA_.*|BASH_FUNC_.*)$)[A-Za-z_][A-Za-z0-9_]*$"
+  },
+  "additionalProperties": {
+    "description": "不超过 4096 字的文字；${…} 只能是 config:<本插件的单值设置>、CODA_PLUGIN_PATH 或 CODA_PLUGIN_STATE；密文不进环境变量，插件的进程从 CODA_PLUGIN_SECRETS 给的文件读",
+    "type": "string",
+    "maxLength": 4096,
+    "pattern": "^[^\\u0000]*$",
+    "x-placeholders": {
+      "names": ["CODA_PLUGIN_PATH", "CODA_PLUGIN_STATE"],
+      "config": {"properties": {"type": {"enum": ["string", "number", "integer", "boolean"]}, "writeOnly": {"const": false}}, "required": ["type"]}
+    }
+  }
+}

package/schemas/plugin/events.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/events.json",
+  "title": "contributes.events：插件发布的事件",
+  "description": "流程订阅的事件名；starts（默认开）是否开始订阅它的流程，否则只送到在跑的运行；ends 是否结束它的主体（如 PR 关闭）。",
+  "type": "array",
+  "maxItems": 50,
+  "items": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "description": "事件名是「<域>.<名>」：小写字母、数字和「_」，以字母开头，不超过 100 个字符；域不能是 Coda 自己的 workflow、session、user",
+        "type": "string",
+        "pattern": "^(?!(workflow|session|user)\\.)(?=.{3,100}$)[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$"
+      },
+      "starts": {"type": "boolean"},
+      "ends": {"type": "boolean"}
+    },
+    "required": ["name"],
+    "additionalProperties": false
+  },
+  "x-unique-by": ["name"]
+}

package/schemas/plugin/executors.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/executors.json",
+  "title": "contributes.executors：给这台机器脚本步骤的执行环境",
+  "description": "照 GitHub 的 container hooks：叫什么、有哪些标签（coda:runsOn 那样写），以及 hook——步骤的执行器为作业的每一部分调用的一行命令。",
+  "type": "array",
+  "maxItems": 10,
+  "items": {
+    "type": "object",
+    "properties": {
+      "id": {"$ref": "common.json#/$defs/id"},
+      "title": {"$ref": "common.json#/$defs/line40"},
+      "labels": {
+        "description": "1–10 个标签（小写字母、数字与 . _ -），数组或逗号分隔，如 linux,x64",
+        "oneOf": [
+          {"type": "array", "minItems": 1, "maxItems": 10, "items": {"type": "string", "pattern": "^\\s*[a-z0-9][a-z0-9._-]{0,39}\\s*$"}},
+          {"type": "string", "pattern": "^\\s*[a-z0-9][a-z0-9._-]{0,39}\\s*(,\\s*[a-z0-9][a-z0-9._-]{0,39}\\s*){0,9}$"}
+        ]
+      },
+      "command": {"$ref": "common.json#/$defs/command"}
+    },
+    "required": ["id", "title", "labels", "command"],
+    "additionalProperties": false
+  },
+  "x-unique-by": ["id"]
+}

package/schemas/plugin/extension-points.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/extension-points.json",
+  "title": "contributes.extensionPoints：插件声明的扩展点",
+  "description": "扩展点名 → 声明。只写 description 的，别的插件用 contributes.extensions 接一条命令；写了 contributes 的，任何插件在它的 contributes 里用这个键写的东西归它，原样交给声明它的插件读，合乎它的 schema 才装得上。",
+  "type": "object",
+  "propertyNames": {"$ref": "common.json#/$defs/id"},
+  "additionalProperties": {
+    "type": "object",
+    "properties": {
+      "description": {"$ref": "common.json#/$defs/line200"},
+      "contributes": {
+        "description": "别的插件在 contributes 里用的键：字母和数字，以小写字母开头，不能是 Coda 自己的类型",
+        "type": "string",
+        "pattern": "^[a-z][A-Za-z0-9]{0,39}$",
+        "not": {
+          "enum": [
+            "configuration",
+            "capabilities",
+            "instructions",
+            "agents",
+            "extensionPoints",
+            "extensions",
+            "groups",
+            "events",
+            "commands",
+            "gitCredentials",
+            "repositories",
+            "services",
+            "setup",
+            "skills",
+            "environment",
+            "path",
+            "endpoints",
+            "mcpServers",
+            "views",
+            "modelProviders",
+            "executors",
+            "composerModes"
+          ]
+        }
+      },
+      "title": {"$ref": "common.json#/$defs/line20"},
+      "commands": {
+        "description": "每样东西里哪里是命令（以「.」连接的键名或「*」）→ 安装确认里怎么叫它（不超过 40 字）",
+        "type": "object",
+        "propertyNames": {"pattern": "^(\\*|[A-Za-z][A-Za-z0-9]{0,39})(\\.(\\*|[A-Za-z][A-Za-z0-9]{0,39})){0,7}$"},
+        "additionalProperties": {"$ref": "common.json#/$defs/line40"}
+      },
+      "schema": {
+        "description": "别的插件在这个键下写的东西的 JSON Schema（draft 2020-12）：本插件目录里的 .json 文件，至多 256 KiB。它和协议的类型并列，可以引用它们（common.json#/$defs/line40）、用协议的五个关键字；指针只指它自己校验的那份值里的位置",
+        "type": "string",
+        "pattern": "\\.json$",
+        "x-file": {"type": "file", "maxBytes": 262144, "schema": true}
+      }
+    },
+    "required": ["description"],
+    "additionalProperties": false,
+    "if": {"required": ["contributes"]},
+    "then": {"description": "写了 contributes 的扩展点也写 title", "required": ["title"]},
+    "else": {"description": "只有写了 contributes 的扩展点才写 title、commands 与 schema", "not": {"anyOf": [{"required": ["title"]}, {"required": ["commands"]}, {"required": ["schema"]}]}}
+  }
+}

package/schemas/plugin/extensions.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/extensions.json",
+  "title": "contributes.extensions：接在别的插件扩展点上的命令",
+  "description": "「插件 ID/扩展点名」→ { command }；那个插件须写在 extensionDependencies 里。",
+  "type": "object",
+  "propertyNames": {
+    "description": "须写成「插件 ID/扩展点名」，插件是 extensionDependencies 里的一个",
+    "pattern": "^[a-z][a-z0-9-]{0,39}/[a-z][a-z0-9-]{0,39}$",
+    "x-ref": {"pointer": "/extensionDependencies", "part": "^([^/]+)/"}
+  },
+  "additionalProperties": {"$ref": "common.json#/$defs/commandHolder"}
+}

package/schemas/plugin/git-credentials.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/git-credentials.json",
+  "title": "contributes.gitCredentials：为一个 https 主机回答 Git 凭据",
+  "description": "url 是 https:// 加小写主机名（可带端口，不带路径）；command 作为 Git 的凭据助手运行。只有 Coda 自带的插件装得上（安装时的规则）。",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "properties": {
+      "url": {"description": "https:// 加小写主机名（可带端口，不带路径）", "type": "string", "pattern": "^https://[a-z0-9.-]+(:\\d+)?$"},
+      "command": {"$ref": "common.json#/$defs/command"}
+    },
+    "required": ["url", "command"],
+    "additionalProperties": false
+  },
+  "x-unique-by": ["url"]
+}

package/schemas/plugin/groups.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/groups.json",
+  "title": "contributes.groups：并发组",
+  "description": "有名字、有容量的锁：name 是任何进程都能拿的组名，capacity 是本插件的一项整数设置，说同时放进几个。",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "properties": {
+      "name": {"description": "组名：1–100 个非空白字符", "type": "string", "pattern": "^\\S{1,100}$"},
+      "capacity": {
+        "description": "capacity 是本插件声明的一项整数设置",
+        "type": "string",
+        "x-ref": {"pointer": "/contributes/configuration/properties", "match": {"properties": {"type": {"const": "integer"}}, "required": ["type"]}}
+      }
+    },
+    "required": ["name", "capacity"],
+    "additionalProperties": false
+  },
+  "x-unique-by": ["name"]
+}

package/schemas/plugin/instructions.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/instructions.json",
+  "title": "contributes.instructions：写给 Agent 的几句话",
+  "description": "装了这个插件的项目里，每个会话的指令都带上它：不超过 200 字。",
+  "type": "string",
+  "maxLength": 200,
+  "pattern": "\\S"
+}

package/schemas/plugin/mcp-servers.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/mcp-servers.json",
+  "title": "contributes.mcpServers：给 Agent 的 MCP 服务器",
+  "description": "服务器名 → { command, args, env }，照 Claude Code 的 .mcp.json：Agent 在本机启动、经标准输入输出说话的程序（stdio），不经 shell。command 与 args 里可以写 ${CODA_PLUGIN_PATH}、${CODA_PLUGIN_STATE}、${CODA_NODE}；设置经 env 交给它（写法同 contributes.environment）。",
+  "type": "object",
+  "maxProperties": 20,
+  "propertyNames": {"description": "服务器名只用小写字母、数字和「-」，以字母开头，至多 40 个字符，不能是 Coda 自己的 coda", "$ref": "common.json#/$defs/id", "not": {"const": "coda"}},
+  "additionalProperties": {
+    "description": "一个服务器：由 Agent 在本机启动、经标准输入输出说话的程序（stdio），写 command 与 args；远程的（http、sse）现在不支持",
+    "type": "object",
+    "properties": {
+      "type": {"description": "现在只支持由 Agent 在本机启动的服务器（stdio）", "const": "stdio"},
+      "command": {"$ref": "#/$defs/word"},
+      "args": {"description": "不超过 100 项", "type": "array", "maxItems": 100, "items": {"$ref": "#/$defs/word"}},
+      "env": {"$ref": "environment.json"}
+    },
+    "required": ["command"],
+    "additionalProperties": false
+  },
+  "$defs": {
+    "word": {
+      "description": "一行不超过 4096 字的文字；${…} 只能是 CODA_PLUGIN_PATH、CODA_PLUGIN_STATE 或 CODA_NODE，设置经 env 交给它",
+      "type": "string",
+      "maxLength": 4096,
+      "pattern": "^[^\\u0000\\r\\n]+$",
+      "x-placeholders": {"names": ["CODA_PLUGIN_PATH", "CODA_PLUGIN_STATE", "CODA_NODE"]}
+    }
+  }
+}

package/schemas/plugin/model-providers.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/model-providers.json",
+  "title": "contributes.modelProviders：插件提供的模型服务",
+  "description": "别的插件用 coda-model-provider 的设置按「插件/id」选它：叫什么、讲哪种接口、在哪（地址里可以写本插件的单值设置 ${config:…}）、Key 是本插件的哪个密文。",
+  "type": "array",
+  "maxItems": 10,
+  "items": {
+    "type": "object",
+    "properties": {
+      "id": {"$ref": "common.json#/$defs/id"},
+      "title": {"$ref": "common.json#/$defs/line40"},
+      "api": {
+        "description": "接口：openai-completions、openai-responses、anthropic-messages",
+        "enum": ["openai-completions", "openai-responses", "anthropic-messages"]
+      },
+      "url": {
+        "description": "一行地址，只能引用本插件的单值设置（${config:<设置名>}，不能是密文）",
+        "type": "string",
+        "maxLength": 4096,
+        "pattern": "^[^\\u0000\\r\\n]+$",
+        "x-placeholders": {"config": {"properties": {"type": {"enum": ["string", "number", "integer"]}, "writeOnly": {"const": false}}, "required": ["type"]}}
+      },
+      "key": {
+        "description": "key 是 ${config:<本插件的密文设置>}",
+        "type": "string",
+        "pattern": "^\\$\\{config:[^}]+\\}$",
+        "x-ref": {
+          "pointer": "/contributes/configuration/properties",
+          "part": "^\\$\\{config:([^}]+)\\}$",
+          "match": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]}
+        }
+      }
+    },
+    "required": ["id", "title", "api", "url"],
+    "additionalProperties": false
+  },
+  "x-unique-by": ["id"]
+}

package/schemas/plugin/path.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/path.json",
+  "title": "contributes.path：放上 PATH 的目录",
+  "description": "插件目录里的目录（相对路径），或它在后端的状态目录 ${CODA_PLUGIN_STATE} 下的目录（setup 可以建它）。",
+  "type": "array",
+  "maxItems": 20,
+  "items": {
+    "type": "string",
+    "minLength": 1,
+    "pattern": "^[^\\u0000:\\n]*$",
+    "if": {"pattern": "^\\$\\{CODA_PLUGIN_STATE\\}"},
+    "then": {"description": "${CODA_PLUGIN_STATE} 下的目录：不离开它", "pattern": "^\\$\\{CODA_PLUGIN_STATE\\}(/(?!(.*/)?\\.\\.(/|$))[^$]*)?$"},
+    "else": {"description": "插件目录里的目录（相对路径，不离开插件目录）", "pattern": "^(?!/)(?!(.*/)?\\.\\.(/|$))(?!\\.?/*$)[^$]*$", "x-file": {"type": "directory"}}
+  }
+}

package/schemas/plugin/plugin.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/plugin.json",
+  "title": "插件清单（插件目录的 package.json）",
+  "description": "照 VS Code 扩展的 package.json 写；Coda 读的是下面这些键，其余是 npm 的，不管。contributes 的每个键是一种类型，各有自己的 schema；不是 Coda 的键，是写给别的插件的扩展点的（它们声明的类型），由那个扩展点的 schema 校验。",
+  "type": "object",
+  "properties": {
+    "id": {"$ref": "common.json#/$defs/id", "description": "插件 ID：小写字母、数字和「-」，以字母开头，至多 40 个字符；不写就用 name"},
+    "name": {"type": "string"},
+    "categories": {"description": "分类：文本的数组，第一个是插件页里归的类", "type": "array", "items": {"type": "string"}},
+    "main": {"description": "插件宿主运行的模块：插件目录里的 .js 或 .mjs 文件", "type": "string", "pattern": "\\.m?js$", "x-file": {"type": "file"}},
+    "activationEvents": {"description": "宿主什么时候加载 main：onStartupFinished（后端一启动），不重复", "type": "array", "items": {"enum": ["onStartupFinished"]}, "uniqueItems": true},
+    "extensionDependencies": {"description": "需要先装的插件的 ID，不重复", "type": "array", "items": {"$ref": "common.json#/$defs/id"}, "uniqueItems": true},
+    "contributes": {
+      "description": "插件带来的东西：每个键一种类型",
+      "type": "object",
+      "properties": {
+        "configuration": {"$ref": "configuration.json"},
+        "capabilities": {"$ref": "capabilities.json"},
+        "instructions": {"$ref": "instructions.json"},
+        "agents": {"$ref": "agents.json"},
+        "extensionPoints": {"$ref": "extension-points.json"},
+        "extensions": {"$ref": "extensions.json"},
+        "groups": {"$ref": "groups.json"},
+        "events": {"$ref": "events.json"},
+        "commands": {"$ref": "commands.json"},
+        "gitCredentials": {"$ref": "git-credentials.json"},
+        "repositories": {"$ref": "repositories.json"},
+        "services": {"$ref": "services.json"},
+        "setup": {"$ref": "setup.json"},
+        "skills": {"$ref": "skills.json"},
+        "environment": {"$ref": "environment.json"},
+        "path": {"$ref": "path.json"},
+        "endpoints": {"$ref": "endpoints.json"},
+        "mcpServers": {"$ref": "mcp-servers.json"},
+        "views": {"$ref": "views.json"},
+        "modelProviders": {"$ref": "model-providers.json"},
+        "executors": {"$ref": "executors.json"},
+        "composerModes": {"$ref": "composer-modes.json"}
+      },
+      "propertyNames": {"description": "contributes 的键：字母和数字，以小写字母开头", "pattern": "^[a-z][A-Za-z0-9]{0,39}$"}
+    }
+  },
+  "if": {"properties": {"activationEvents": {"minItems": 1}}, "required": ["activationEvents"]},
+  "then": {"required": ["main"], "description": "写了 activationEvents 的插件须有 main"}
+}

package/schemas/plugin/repositories.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/repositories.json",
+  "title": "contributes.repositories：列出这台能访问的仓库",
+  "description": "一行命令，打印仓库供客户端选。只有 Coda 自带的插件装得上（安装时的规则）。",
+  "$ref": "common.json#/$defs/commandHolder"
+}

package/schemas/plugin/services.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/plugin/v1/services.json",
+  "title": "contributes.services：开启随包服务",
+  "description": "随后端包的独立服务的 ID；没有已安装插件开启的服务不运行。",
+  "type": "array",
+  "uniqueItems": true,
+  "items": {"$ref": "common.json#/$defs/name"}
+}