@coda-console/protocol 1.9.1 → 2.0.0

package/README.md

@@ -2,7 +2,7 @@
 
 Coda 与插件之间的约定，Coda 和插件都引用它，独立演进：
 
-- **插件清单的类型**（`schemas/plugin/`）：插件目录 `package.json` 里 `contributes` 的每个键是一种类型，各有一份 JSON Schema（draft 2020-12，`$id` 为 `https://coda.pub/schemas/plugin/v1/<文件>`）。`plugin.json` 是整份清单，`setting.json` 是一项设置的声明。插件写的合乎它用到的类型就对；写给别的插件扩展点的键由那个插件声明，扩展点可以带自己的 schema（`extensionPoints.<名>.schema`，声明它的插件目录里的一个文件），写给它的东西合乎那份 schema 才对。
+- **插件清单的类型**（`schemas/plugin/`）：插件目录 `package.json` 里 `contributes` 的每个键是一种类型，各有一份 JSON Schema（draft 2020-12，`$id` 为 `https://coda.pub/schemas/plugin/v2/<文件>`）。`plugin.json` 是整份清单，`setting.json` 是一项设置的声明。插件写的合乎它用到的类型就对；写给别的插件扩展点的键由那个插件声明，扩展点可以带自己的 schema（`extensionPoints.<名>.schema`，声明它的插件目录里的一个文件），写给它的东西合乎那份 schema 才对。
 - **通用校验器**（`validate.mjs`）：用 Ajv 对清单做 schema 校验。JSON Schema 说不了的只用五个通用关键字（`x-unique-by`、`x-max-contains`、`x-ref`、`x-placeholders`、`x-file`，照 Kubernetes 的 `x-kubernetes-*`），每个在哪里写都是同一个意思，写法见文件开头。校验器不随功能变长：类型加字段就是改 schema。
 - **流程方言**（`workflow/`）：项目和插件的流程（`.coda/workflows/*.bpmn`，BPMN 2.0）在 Coda 的命名空间 `https://coda.pub/schema/bpmn/1.0` 里能写什么。`moddle.json` 是 `coda:` 属性与元素（bpmn-moddle 的描述格式），`values.json` 是每个值能写什么（每个 `coda:` 类型的属性组成的对象的 JSON Schema，一个元素里同种 `coda:` 元素成组的 schema），`actions.json` 是 `coda:action` 的各个动作和它们接受的参数，`dialect.json` 是流程种类、Coda 自己发的事件、步骤失败的错误码、表达式能读的运行变量和运行的输入能是哪些类型。`workflow.mjs` 用它们读一份流程：方言里没有的、值不合 schema 的都拒绝，说法是「位置：schema 对那里的说明」。值的 schema 用清单的那几个关键字，另加三个：`x-feel`（是 FEEL：「=」开头是表达式，否则文字里的 `{{ … }}` 是，按这份流程里的名字读得通）、`x-duration`（ISO 8601 时长，不为负）、`x-number`（文字换算成数字是个有限的数）。`structure.json` 声明流程结构规则，`structure.mjs` 负责跨节点检查。
 - **Agent 接入扩展**（`schemas/agent/`、`agent.mjs`、`docs/agent-protocol.md`）：Coda 怎样用 ACP 接 Agent，以及 Coda 加的扩展（会话指令、插话、`_coda/wait`、执行失败、工具调用的审核）。
@@ -30,7 +30,7 @@ import { manifestProblem, pointProblem, valueProblem, TYPES, SCHEMAS } from '@co
 
 // 整份清单；给出插件目录时，连同它点名的文件一起查（x-file）。合乎类型返回 null，否则是一句说明：哪里、schema 怎么说。
 const problem = manifestProblem(JSON.parse(readFileSync('plugin/package.json', 'utf8')), 'plugin');
-// 某个类型里的一部分，如输入框模式的参数（插件运行时给出的）。
+// 某个类型里的一部分，如输入框模式声明的参数。
 valueProblem('composer-modes.json#/$defs/parameters', parameters, '插件给出的参数');
 // 写给别的插件扩展点的东西，按那个扩展点的 schema（已读出的对象）；给出写它的插件目录时连同它点名的文件一起查。
 pointProblem(panelsSchema, manifest.contributes.panels, 'contributes.panels', 'plugin');
@@ -63,6 +63,14 @@ fieldsProblem(JSON.parse(fieldsJSON), 'ask');
 
 设置的 `items.anyOf` 选项可附带 `workflowKind`（`check`、`premerge`、`deploy`、`preview`、`release`）。全局设置显示全部选项；项目设置只显示该项目有的流程类别，未写此字段的选项始终显示。宿主负责按项目提供可选项，流程执行时仍需按运行的提交判断可用操作。
 
+## 输入框模式
+
+从 2.0.0 起，`contributes.composerModes` 可写 `once: true`：这个模式里发出的一条被收下后，它从输入框退出。`once` 是可选布尔值。模式不再接受 `agent`，工具栏始终使用输入框自己的执行者；旧清单须删除模式级的 `agent` 字段。
+
+模式的对象数组参数（`type: array` 且 `items.type: object`）可写 `"presets": { "from": "composer.templates", "by": "template" }`。`from` 是表格设置 ID，`by` 是分组列，两者都是必填字符串，不接受其他字段。此字段只用于模式参数，不用于普通设置。Coda 按输入框所在目录读取设置，以分组列首次出现的顺序显示预设；选中时一次性填入该组的行，只取项中声明的列，之后可普通编辑。进入模式时填入第一组，设置为空则不填。
+
+插件 schema 的 `$id` 命名空间随此不兼容变更升为 `https://coda.pub/schemas/plugin/v2/`；直接写绝对 `$ref` 的调用方须同步更新。Agent 接入和流程方言的 schema 命名空间不变。
+
 ## Agent 接入扩展
 
 从 1.9.0 起，[Agent 协议正文](docs/agent-protocol.md#可执行的形状定义)引用 `schemas/agent/` 的可执行定义：

package/docs/agent-protocol.md

@@ -27,6 +27,7 @@ ACP 的消息、内容块、会话指令和能力由 ACP SDK 校验，这里只
 | 工具更新的 `_meta.coda.review` | [review.json](../schemas/agent/review.json)；已知风险值见 `$defs/risk` |
 | 用量更新的 `_meta.coda` | [usage.json](../schemas/agent/usage.json) |
 | 配置选项的 `_meta.coda.default` | [default.json](../schemas/agent/default.json)（传入 `_meta.coda` 对象） |
+| 模型、模式、配置项及其选项的 `_meta.coda.shortName` | [display.json](../schemas/agent/display.json)（传入 `_meta.coda` 对象） |
 
 `@coda-console/protocol/agent` 导出 `agentMessageProblem(method, params)`、`agentResultProblem(method, result)`、
 `agentCapabilitiesProblem(meta, party = 'agent')` 和 `agentValueProblem(ref, value, where)`，合法返回 `null`，
@@ -105,6 +106,11 @@ ACP 只允许在一轮（`session/prompt`）进行时交互。Agent 在两轮之
   `clientCapabilities.session.configOptions.boolean` 里声明接受开关型。会话设置里按配置项 ID 给的值，每轮开始前设给 Agent；当前模型没有这一项就不设。
   Coda 设过、会话设置里又去掉的（用户选回「Agent 默认」），切回 Agent 标了 `_meta.coda.default` 的那一项，没标就切回 Coda 第一次设它之前、
   同一模型下 Agent 报的值，两样都不知道就不改。Agent 自己改的 Coda 不去改回；用户在会话里用命令改的（如 Codex 的 `/fast`）记进会话设置。名字与说明照 Agent 给的显示。
+  模型、模式、配置项及其选项可在 `_meta.coda.shortName` 声明紧凑显示名（[display.json](../schemas/agent/display.json)），
+  适用于 `configOptions` 的项与叶子选项，以及 `availableModels`、`availableModes` 的项。例如
+  `{ "value": "read-only", "name": "Ask for approval", "_meta": { "coda": { "shortName": "审批" } } }`。
+  工具栏优先短名，再取完整 `name`，最后取 ID；选择面板和辅助功能保留完整名称。短名由插件声明，客户端不猜测或改写模型 ID，
+  不影响设置、分组与执行；插件应保留版本、上下文变体等辨认所需的信息。没声明时保持原有显示。
 - **未登录**：Agent 在 `initialize`、`session/new` 或 `session/load` 回错误 -32000（ACP 的 `auth_required`）时，Coda 告诉用户这个 Agent 未登录，
   到「资源」里添加（面板的登录（Coda 的 docs/plugins.md「面板的登录」））；Coda 不调用 `authenticate`，也不按错误文字猜。
 - **Agent 版本**：`initialize` 结果的 `agentInfo`（ACP 的 `name`、`version`）填**实际运行的那个 Agent**：包装了别家 CLI 或 SDK 的插件，
@@ -409,7 +415,7 @@ Bot 需要随时进到自己的会话里来：说话、调 Coda 的工具、开
 
 只给 Agent 声明了 `agentCapabilities._meta.coda.remote` 的会话提供 MCP 工具 `new_session`；
 会话启动时生成工具列表，其他会话不列出它，直接调用也拒绝。
-Bot 是工作的发起者：批准后开的是普通根会话，不是它的子会话，也不是一次会话间调用。
+Bot 是工作的发起者：批准后开的是普通根会话，首条任务的回复权归发起会话；独立会话身份与回复对象分开记录。
 
 参数为 `agent`、`prompt`、`requestId`、`turn`、`project`，以及可选的 `model`、`effort`、`mode`、`options`、`checkout`、`title`。
 `agent` 是 Agent 的 ID，或用户给的 Agent 链接 `coda://agents/<UUID>?…`，原样照填：Coda 从链接取 Agent 与它所在的机器，
@@ -426,13 +432,17 @@ Agent、模型、强度、审批档位、其他配置、标题和任务全文；
 不在调用里等用户，卡片的提醒、归档失效沿用会话授权卡片。
 
 允许后在目标目录建根会话（`shared` 用原目录，`worktree` 从卡片写明的默认分支新建工作树），第一条消息就是 `prompt`，审批档位保留卡片批准的参数，不跟随 Bot；标题固定为批准的标题。
-没有 parent、没有调用或结果投递；首条输入为用户的任务，结果、通知和 PR 事件的 `coda.session` 都归新会话自己。
-会话数据的 `initiatedBy` 保存 `{threadId, title, reference}`，表示「由哪个会话发起」，不转移回复权或附带旧上下文；
+没有 parent，但首条任务建立发起会话的一次调用（沿用 `send` 的会话间回复机制）。任务完成或失败后，结果自动送回并唤醒发起会话；
+这次任务引发的后续沿用补交规则。用户在新会话里另发的消息仍回复用户。PR 事件的 `coda.session` 仍采用新会话自己的 Agent 与配置。
+会话数据的 `initiatedBy` 保存 `{threadId, title, reference}`，表示「由哪个会话发起」，不附带旧上下文；回复关系由首条任务的调用保存。
 `reference` 是发起会话的 `coda://threads/…`。两端客户端尚未显示这个来源字段。
 
 决定以一条 Coda 通知唤醒发起会话：允许为「已开出：标题（Coda 的 docs/coda://threads/<新会话 ID>）」，拒绝为「用户拒绝了：<标题>」，
-新会话后续的结果不回传给 Bot。已决定请求的工具重试返回这句结果，仍保留应交的通知。
-其他机器上的创建走状态层转发的普通首次发送接口；发送前持久化允许决定与提交标识，卡片进入 `submitting`。
+允许通知同时说明任务结果会自动送回并唤醒发起会话，不必轮询或等待。已决定请求的工具重试返回这句结果，仍保留应交的通知。
+目标若声明外部生命周期，则首条消息附带发起会话地址与原 `requestId`，目标按委派约定用 `send` 的 `replyTo` 明确回传；自主发言不自动作为结果。
+其他机器上的创建走状态层转发的普通首次发送接口；发送前持久化允许决定、提交标识与回复调用，卡片进入 `submitting`。
+目标用固定会话标识创建，并在接受首条任务的同一事务里建立回话；发起机器取认证身份，不信任请求正文提供的机器。
+结果通过现有跨机投递返回，即使任务在创建回执到达前完成也能交回；重复投递不重复唤醒。
 目标暂不可达或应答丢失时，使用原提交标识与允许决定重试恢复同一次创建，不再接受拒绝或其他提交；
 工具重试返回「用户已批准，正在确认新会话；结果会作为新消息告诉你。」，收到创建结果后才通知已开出。
 目标明确拒绝（例如批准前目录已删除）则结算为失败，通知「未能开出：<标题>（<原因>）」；

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coda-console/protocol",
-  "version": "1.9.1",
+  "version": "2.0.0",
   "description": "Coda 的协议：插件清单的类型（JSON Schema）、通用校验器、流程方言与 Agent 接入协议",
   "type": "module",
   "license": "MIT",

package/schemas/agent/display.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/agent/v1/display.json",
+  "type": "object",
+  "description": "_meta.coda 须为对象",
+  "properties": {
+    "shortName": {
+      "type": "string",
+      "pattern": "\\S",
+      "description": "shortName 须为非空白文本，用于紧凑位置的显示，不改变选项 ID"
+    }
+  }
+}

package/schemas/plugin/agents.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/agents.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/agents.json",
   "title": "contributes.agents：插件带来的 Agent",
   "description": "每个是一个讲 ACP（加 Coda 的等待项）的程序：它是谁、客户端怎么画它、Coda 怎么启动它。",
   "type": "array",

package/schemas/plugin/capabilities.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/capabilities.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/capabilities.json",
   "title": "contributes.capabilities：插件带来的能力",
   "description": "能力名的数组，每个是 .coda/capabilities/<名>.bpmn；只能被调用（workflow_run、callActivity），没有触发器。",
   "type": "array",

package/schemas/plugin/commands.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/commands.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/commands.json",
   "title": "contributes.commands：放在会话与步骤 PATH 最前的命令",
   "description": "命令名 → 由 sh 运行的一行命令（带上参数）。",
   "type": "array",

package/schemas/plugin/common.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/common.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/common.json",
   "title": "插件清单里共用的写法",
   "$defs": {
     "id": {"description": "小写字母、数字和「-」，以字母开头，至多 40 个字符", "type": "string", "pattern": "^[a-z][a-z0-9-]{0,39}$"},

package/schemas/plugin/composer-modes.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/composer-modes.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/composer-modes.json",
   "title": "contributes.composerModes：输入框模式",
-  "description": "输入框能处在的模式：显示什么（图标、标题、发出去是什么、占位与发送按钮），发出的给谁（agent：session 会话的 Agent，own 为它另选的、开新会话跑，off 不显示），在哪些输入框里能进（in：session 会话的、new 新任务的），参数（写法同设置）。打字进入的（trigger，如 !）没有参数，发出的就是会话的。",
+  "description": "输入框能处在的模式：显示什么（图标、标题、发出去是什么、占位与发送按钮），发出的一条被收下后是否退出（once），工具栏始终使用输入框自己的执行者，在哪些输入框里能进（in：session 会话的、new 新任务的），参数（写法同设置）。打字进入的（trigger，如 !）没有参数，发出的就是会话的。",
   "type": "array",
   "maxItems": 10,
   "items": {
@@ -14,7 +14,7 @@
       "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"]},
+      "once": {"description": "true：这个模式里发出的一条被收下后，它从输入框退出", "type": "boolean"},
       "trigger": {"description": "trigger 是一个标点：!#$%&*+:;=?^|~ 之一", "type": "string", "pattern": "^[!#$%&*+:;=?^|~]$"},
       "in": {"description": "它出现的输入框：session、new，不重复", "type": "array", "minItems": 1, "uniqueItems": true, "items": {"enum": ["session", "new"]}},
       "parameters": {"$ref": "#/$defs/parameters"}
@@ -25,15 +25,8 @@
       {
         "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"}}}}
+          "description": "打字进入的模式（trigger）没有参数",
+          "not": {"required": ["parameters"]}
         }
       }
     ]
@@ -51,8 +44,32 @@
           "maxProperties": 20,
           "propertyNames": {"description": "参数名只用字母和数字，以小写字母开头", "pattern": "^[a-z][A-Za-z0-9]{0,39}$"},
           "additionalProperties": {
+            "properties": {
+              "presets": {
+                "description": "按表格设置的分组列填入预设，只用于项是对象的数组参数",
+                "type": "object",
+                "properties": {
+                  "from": {"type": "string"},
+                  "by": {"type": "string"}
+                },
+                "required": ["from", "by"],
+                "additionalProperties": false
+              }
+            },
+            "unevaluatedProperties": false,
             "allOf": [
-              {"$ref": "setting.json"},
+              {
+                "if": {"required": ["presets"]},
+                "then": {
+                  "description": "presets 只用于 type: array 且 items.type: object 的参数",
+                  "properties": {
+                    "type": {"const": "array"},
+                    "items": {"type": "object", "properties": {"type": {"const": "object"}}, "required": ["type"]}
+                  },
+                  "required": ["type", "items"]
+                }
+              },
+              {"$ref": "setting.json#/$defs/setting"},
               {
                 "description": "参数不能是密文",
                 "not": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]},

package/schemas/plugin/configuration.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/configuration.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/configuration.json",
   "title": "contributes.configuration：插件的设置",
   "description": "照 VS Code 的 contributes.configuration：properties 是设置名 → 声明（setting.json），设置名以「<插件 ID>.」开头；required 是缺了就不能用的设置。",
   "type": "object",

package/schemas/plugin/endpoints.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/endpoints.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/endpoints.json",
   "title": "contributes.endpoints：客户端发给插件的请求",
   "description": "id → 回答它的一行命令（请求从标准输入给）；checks 是它检查的本插件设置，客户端在那项设置旁提供「检查」，一项设置至多一个端点。",
   "type": "array",

package/schemas/plugin/environment.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/environment.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/environment.json",
   "title": "contributes.environment：给项目里启动的东西的环境变量",
   "description": "变量名 → 值，不超过 100 个。值里可以写 ${config:<本插件的单值设置>}（不能是密文：密文从 CODA_PLUGIN_SECRETS 给的文件读）、${CODA_PLUGIN_PATH}、${CODA_PLUGIN_STATE}。PATH 由 contributes.path 给；Coda 自己的变量与 shell 的钩子不归插件。",
   "type": "object",

package/schemas/plugin/events.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/events.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/events.json",
   "title": "contributes.events：插件发布的事件",
   "description": "流程订阅的事件名；starts（默认开）是否开始订阅它的流程，否则只送到在跑的运行；ends 是否结束它的主体（如 PR 关闭）。",
   "type": "array",

package/schemas/plugin/executors.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/executors.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/executors.json",
   "title": "contributes.executors：给这台机器脚本步骤的执行环境",
   "description": "照 GitHub 的 container hooks：叫什么、有哪些标签（coda:runsOn 那样写），以及 hook——步骤的执行器为作业的每一部分调用的一行命令。",
   "type": "array",

package/schemas/plugin/extension-points.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/extension-points.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/extension-points.json",
   "title": "contributes.extensionPoints：插件声明的扩展点",
   "description": "扩展点名 → 声明。只写 description 的，别的插件用 contributes.extensions 接一条命令；写了 contributes 的，任何插件在它的 contributes 里用这个键写的东西归它，原样交给声明它的插件读，合乎它的 schema 才装得上。",
   "type": "object",

package/schemas/plugin/extensions.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/extensions.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/extensions.json",
   "title": "contributes.extensions：接在别的插件扩展点上的命令",
   "description": "「插件 ID/扩展点名」→ { command }；那个插件须写在 extensionDependencies 里。",
   "type": "object",

package/schemas/plugin/git-credentials.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/git-credentials.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/git-credentials.json",
   "title": "contributes.gitCredentials：为一个 https 主机回答 Git 凭据",
   "description": "url 是 https:// 加小写主机名（可带端口，不带路径）；command 作为 Git 的凭据助手运行。只有 Coda 自带的插件装得上（安装时的规则）。",
   "type": "array",

package/schemas/plugin/groups.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/groups.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/groups.json",
   "title": "contributes.groups：并发组",
   "description": "有名字、有容量的锁：name 是任何进程都能拿的组名，capacity 是本插件的一项整数设置，说同时放进几个。",
   "type": "array",

package/schemas/plugin/instructions.json

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

package/schemas/plugin/mcp-servers.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/mcp-servers.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/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",

package/schemas/plugin/model-providers.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/model-providers.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/model-providers.json",
   "title": "contributes.modelProviders：插件提供的模型服务",
   "description": "别的插件用 coda-model-provider 的设置按「插件/id」选它：叫什么、讲哪种接口、在哪（地址里可以写本插件的单值设置 ${config:…}）、Key 是本插件的哪个密文。",
   "type": "array",

package/schemas/plugin/path.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/path.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/path.json",
   "title": "contributes.path：放上 PATH 的目录",
   "description": "插件目录里的目录（相对路径），或它在后端的状态目录 ${CODA_PLUGIN_STATE} 下的目录（setup 可以建它）。",
   "type": "array",

package/schemas/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/plugin.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/plugin.json",
   "title": "插件清单（插件目录的 package.json）",
   "description": "照 VS Code 扩展的 package.json 写；Coda 读的是下面这些键，其余是 npm 的，不管。contributes 的每个键是一种类型，各有自己的 schema；不是 Coda 的键，是写给别的插件的扩展点的（它们声明的类型），由那个扩展点的 schema 校验。",
   "type": "object",

package/schemas/plugin/repositories.json

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

package/schemas/plugin/services.json

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

package/schemas/plugin/setting.json

@@ -1,9 +1,10 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/setting.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/setting.json",
   "title": "一项设置的声明",
   "description": "插件用 JSON Schema 声明设置，Coda 读的是其中一部分：单个值；多选（items.anyOf 的常量）；多个模型服务；一列行；表格（additionalProperties 是每一项）。表格的每一项是单个值、Agent 组合或几列；一列是单个值或 Agent 组合。格式只认 coda-agent（新会话用什么启动）、coda-agent-match（表格的行名：哪些会话）、duration（ISO 8601 时长）、coda-repo、coda-directory、coda-model-provider（别的插件提供的模型服务）、coda-model-url（模型服务的地址，Key 与接口写在同组的 modelKey、modelApi）。writeOnly 是密文：只写不读，放在数据库旁的文件里。",
   "$ref": "#/$defs/setting",
+  "unevaluatedProperties": false,
   "$defs": {
     "base": {
       "type": "object",
@@ -72,7 +73,6 @@
         "additionalProperties": true,
         "propertyNames": true
       },
-      "unevaluatedProperties": false,
       "allOf": [
         {
           "if": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]},

package/schemas/plugin/setup.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/setup.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/setup.json",
   "title": "contributes.setup：准备运行环境",
   "description": "用户安装或更新插件后运行的一行命令。",
   "$ref": "common.json#/$defs/commandHolder"

package/schemas/plugin/skills.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/skills.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/skills.json",
   "title": "contributes.skills：插件带来的 Agent Skill",
   "description": "插件目录里的目录，每个有自己的 SKILL.md；Agent 按目录名找到它，所以目录名不重复。",
   "type": "array",

package/schemas/plugin/views.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://coda.pub/schemas/plugin/v1/views.json",
+  "$id": "https://coda.pub/schemas/plugin/v2/views.json",
   "title": "contributes.views：客户端为插件打开的页面",
   "description": "插件目录里的 HTML，客户端在沙箱里开：在哪常驻（side 会话旁、page 一页），图标，接管打开的引用种类（handles，像 VS Code 的自定义编辑器），读数（readout）与只给哪种工作位置的会话（checkout）。",
   "type": "array",

package/validate.mjs

@@ -1,5 +1,5 @@
 // A plugin is right when what it writes is of the types it names: each key of a manifest's `contributes` is a type with a
-// JSON Schema of its own (schemas/plugin/, `https://coda.pub/schemas/plugin/v1/…`), and a key that is no type of Coda's is
+// JSON Schema of its own (schemas/plugin/, `https://coda.pub/schemas/plugin/v2/…`), and a key that is no type of Coda's is
 // one a plugin's extension point declares, for that plugin to read: of the schema that point names, a file of the declaring
 // plugin's (`extensionPoints.<point>.schema`), when it names one. Checking one is checking it against those schemas,
 // nothing else: a field joins a type by joining its schema, never by a rule here. Coda checks a plugin with this module
@@ -28,7 +28,7 @@ import { fileURLToPath } from 'node:url';
 import Ajv2020 from 'ajv/dist/2020.js';
 
 export const SCHEMA_DIR = fileURLToPath(new URL('./schemas/plugin/', import.meta.url));
-const BASE = 'https://coda.pub/schemas/plugin/v1/';
+const BASE = 'https://coda.pub/schemas/plugin/v2/';
 // The schemas, by file name.
 export const SCHEMAS = Object.fromEntries(readdirSync(SCHEMA_DIR).filter(file => file.endsWith('.json')).sort()
   .map(file => [file, JSON.parse(readFileSync(join(SCHEMA_DIR, file), 'utf8'))]));