@coda-console/protocol 2.3.0 → 2.4.0

package/docs/executor-protocol.md

@@ -5,7 +5,7 @@
 2.2.0 按[第 7 步方案](https://github.com/coda-console/coda/issues/2078#issuecomment-6559423071)补齐流程接入：
 **无资源或一个资源的一单位**，可独占所申请资源；多单位、多资源原子申请仍未开放。
 
-协议对象版本 `protocolVersion: 1`、本目录的 v1、npm 包版本 2.3.0 和插件清单的 v2 分开演进。
+协议对象版本 `protocolVersion: 1`、本目录的 v1、npm 包版本 2.4.0 和插件清单的 v2 分开演进。
 本次只增加契约；不改变 `contributes.executors`，也不宣称 host、scheduler、空间引用解析或账本接口已经实现。
 
 ## 定义与登记

package/package.json

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

package/schemas/plugin/views.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://coda.pub/schemas/plugin/v2/views.json",
   "title": "contributes.views：客户端为插件打开的页面",
-  "description": "插件目录里的 HTML，客户端在沙箱里开：在哪常驻（side 会话旁、page 一页），图标，接管打开的引用种类（handles，像 VS Code 的自定义编辑器），读数（readout）与只给哪种工作位置的会话（checkout）。",
+  "description": "插件目录里的 HTML，客户端在沙箱里开：在哪常驻（side 会话旁、page 一页），图标，接管打开的引用种类（handles，像 VS Code 的自定义编辑器），读数（readout），只给哪种工作位置的会话（checkout）与占位（frame：document 由客户端整页滚动、横向锁死，canvas 铺满视图、自己滚动）。",
   "type": "array",
   "maxItems": 10,
   "items": {
@@ -21,7 +21,8 @@
         "items": {"$ref": "common.json#/$defs/id"}
       },
       "readout": {"description": "读数：workflow-runs、machines、changes", "enum": ["workflow-runs", "machines", "changes"]},
-      "checkout": {"description": "只给哪种工作位置的会话：worktree", "enum": ["worktree"]}
+      "checkout": {"description": "只给哪种工作位置的会话：worktree", "enum": ["worktree"]},
+      "frame": {"description": "它怎么占位：document 由客户端整页滚动、横向锁死；canvas 铺满视图、自己滚动；不写暂与 canvas 相同", "enum": ["document", "canvas"]}
     },
     "required": ["id", "title", "entry"],
     "additionalProperties": false