@coda-console/plugin-check 0.5.6 → 0.5.8

package/README.md

@@ -11,6 +11,7 @@ plugins/codex/           Codex：入口在同一进程里运行锁定版本的 c
 plugins/claude/          Claude SDK：基于 Claude Agent SDK 的 ACP 入口（npm 依赖），面板「Claude」
 plugins/kimi/            Kimi Code：在运行机的 kimi acp 与 Coda 之间转发，面板「Kimi」
 plugins/grok/            Grok：转发运行机上 Grok CLI 的 ACP，并适配审批模式，面板「Grok」
+plugins/grok-bot/        Grok Bot：把 xAI 云端 Bot 接成长期会话，Webhook 消息、定时巡检与用户审批；依赖 Coda 远端 Agent 入口
 plugins/opencode/        OpenCode：在运行机的 opencode acp 与 Coda 之间转发，送入会话指令与所选模型服务，模型按来源分组
 plugins/codex-accounts/  Codex 多账号：管理登录、自动续期与账号选择，接管 Codex 额度面板
 plugins/cursor/          Cursor：在运行机的 cursor-agent acp 与 Coda 之间转发，送入会话指令
@@ -19,6 +20,7 @@ plugins/magpie/          Magpie：把本机的 Magpie 网关作为模型服务
 plugins/network-log/     网络记录：只记录不拦截，每秒读连接表记下建连卡住的连接（进程、对端、网卡、mihomo 有没有收到），每分钟分段探测常用服务
 plugins/review/          PR 生命流程：会话开的 PR 先跑项目的检查、再交叉评审，你批准后合并、部署与发布；也是写 PR 流程的样例
 plugins/testbed/         测试机：长插在 Mac 上的 iPhone、iPad 只经 use-testbed 使用，排到后装 App、交给会话操作、用完切黑屏；依赖宿主资源
+plugins/ultra/           Ultra：输入框的 Ultra 模式，主 Agent 主动把能并行的活按名单派给子会话，汇总后验证；名单与模板在模式参数和设置里
 templates/agent/         最小的 Agent 插件：手写 ACP 的回声 Agent，演示会话指令、插话、Agent 活动与自主轮次
 templates/panel/         最小的面板插件：一张卡片、一条进度条、一个按钮
 bin/、check/             契约检查（仓库根的 package.json 就是它，@coda-console/plugin-check）；check/coda/ 是 Coda 同步来的规则副本，不要手改

package/check/coda/builtin.json

@@ -125,6 +125,155 @@
       }
     ]
   },
+  {
+    "id": "composer",
+    "displayName": "输入框模式",
+    "description": "输入框的三种模式：交接到新会话、新建子会话，以及打 ! 执行命令。停用后输入框里没有这几种模式。",
+    "version": "1.1.0",
+    "category": "工作流程",
+    "source": {
+      "kind": "builtin"
+    },
+    "dir": "src/resources/plugins/composer",
+    "title": "输入框模式",
+    "properties": {},
+    "main": "main.mjs",
+    "workflows": [],
+    "capabilities": [],
+    "services": [],
+    "groups": [],
+    "commands": [],
+    "gitCredentials": [],
+    "endpoints": [],
+    "views": [],
+    "composerModes": [
+      {
+        "id": "handoff",
+        "title": "交接到新会话",
+        "icon": "arrow.right.square",
+        "hint": "新会话承接这里的上下文，共享当前工作目录及其中的文件；这个会话保留，仍可继续使用。",
+        "placeholder": "接下来要完成什么？",
+        "sendLabel": "交接",
+        "agent": "own",
+        "in": [
+          "session"
+        ]
+      },
+      {
+        "id": "subagent",
+        "title": "子会话",
+        "icon": "arrow.triangle.branch",
+        "hint": "承接父会话近期上下文，沿用父会话工作目录；只启动子会话，不向父 Agent 发送这段要求。",
+        "placeholder": "描述交给子会话的任务…",
+        "sendLabel": "启动子会话",
+        "agent": "own",
+        "in": [
+          "session"
+        ],
+        "parameters": {
+          "properties": {
+            "replyTo": {
+              "type": "string",
+              "enum": [
+                "parent",
+                "sender"
+              ],
+              "enumItemLabels": [
+                "完成后回报父会话",
+                "完成后回报你"
+              ],
+              "enumDescriptions": [
+                "结果交给父 Agent，由它接着处理",
+                "做完提醒你，不叫醒父 Agent"
+              ],
+              "title": "回报对象",
+              "default": "parent",
+              "order": 0
+            }
+          }
+        },
+        "schema": {
+          "type": "object",
+          "properties": {
+            "replyTo": {
+              "title": "回报对象",
+              "type": "string",
+              "enum": [
+                "parent",
+                "sender"
+              ],
+              "enumItemLabels": [
+                "完成后回报父会话",
+                "完成后回报你"
+              ],
+              "enumDescriptions": [
+                "结果交给父 Agent，由它接着处理",
+                "做完提醒你，不叫醒父 Agent"
+              ],
+              "default": "parent"
+            }
+          }
+        }
+      },
+      {
+        "id": "shell",
+        "title": "执行命令",
+        "icon": "terminal",
+        "hint": "在会话工作目录执行，命令和结果作为这条消息发给 Agent。",
+        "placeholder": "输入要执行的命令…",
+        "sendLabel": "执行",
+        "agent": "off",
+        "trigger": "!",
+        "in": [
+          "session",
+          "new"
+        ]
+      }
+    ],
+    "agents": [],
+    "dependencies": [],
+    "extensionPoints": {},
+    "extensions": []
+  },
+  {
+    "id": "diagnostics",
+    "displayName": "机器诊断",
+    "description": "给巡检会话提供只读工具，查看空间各台机器的健康状态、网络诊断与客户端性能。需要时安装，再按目录启用或用 Tag 限定。",
+    "version": "1.0.0",
+    "category": "机器与资源",
+    "source": {
+      "kind": "builtin"
+    },
+    "dir": "src/resources/plugins/diagnostics",
+    "title": "机器诊断",
+    "properties": {},
+    "workflows": [],
+    "capabilities": [],
+    "services": [],
+    "groups": [],
+    "commands": [],
+    "gitCredentials": [],
+    "endpoints": [],
+    "views": [],
+    "agents": [],
+    "dependencies": [
+      "space"
+    ],
+    "extensionPoints": {},
+    "extensions": [],
+    "mcpServers": [
+      {
+        "name": "diagnostics",
+        "command": "${CODA_NODE}",
+        "args": [
+          "${CODA_PLUGIN_PATH}/mcp.mjs",
+          "--state",
+          "${CODA_PLUGIN_STATE}"
+        ],
+        "env": []
+      }
+    ]
+  },
   {
     "id": "github",
     "displayName": "GitHub",
@@ -442,7 +591,7 @@
   {
     "id": "session",
     "displayName": "会话生命周期",
-    "description": "所有会话共用：存续期间管理空闲进程和任务转交，归档宽限后收尾，按设置回收托管工作树。停用后不自动执行这些政策。",
+    "description": "所有会话共用：存续期间管理空闲进程和任务转交，归档宽限后收尾，按设置回收托管工作树，限定同时执行的子会话。停用后不自动执行这些政策。",
     "version": "1.0.0",
     "category": "工作流程",
     "source": {
@@ -488,6 +637,15 @@
         "title": "Agent 停下多久后转给你",
         "order": 9,
         "default": "PT2M"
+      },
+      "session.subagents": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 64,
+        "description": "Agent 开的子会话为父会话干活时各占一个名额；满了再开会当场失败，Agent 等其中一个做完再开，或者自己做。按这台机器算。",
+        "title": "同时执行的子会话",
+        "order": 10,
+        "default": 5
       }
     },
     "workflows": [
@@ -495,7 +653,12 @@
     ],
     "capabilities": [],
     "services": [],
-    "groups": [],
+    "groups": [
+      {
+        "name": "subagents",
+        "capacity": "session.subagents"
+      }
+    ],
     "commands": [],
     "gitCredentials": [],
     "endpoints": [],

package/check/coda/components/plugins/plugin-rules.mjs

@@ -51,7 +51,7 @@ const PACKAGE_ROOT = fileURLToPath(new URL('../../../', import.meta.url));
 // What a plugin may contribute to Coda itself; anything else in `contributes` is for a point another plugin declares to
 // take it (the resources plugin's `panels`), refused when none does, as any other way of writing Coda cannot read.
 export const CONTRIBUTES = ['configuration', 'capabilities', 'instructions', 'agents', 'extensionPoints', 'extensions', 'groups', 'events', 'commands', 'gitCredentials',
-  'repositories', 'services', 'setup', 'skills', 'environment', 'path', 'endpoints', 'mcpServers', 'views', 'modelProviders', 'executors'];
+  'repositories', 'services', 'setup', 'skills', 'environment', 'path', 'endpoints', 'mcpServers', 'views', 'modelProviders', 'executors', 'composerModes'];
 // The string formats a setting may have, beside `coda-agent` (an object) and `coda-agent-match` (a table's row names):
 // `coda-model-provider` names a model service another plugin provides (docs/plugins.md「模型服务」); `coda-model-url` is the
 // address of one, its Key and API in fields beside it (`modelKey`, `modelApi`), which Coda checks (「检查可用模型」).
@@ -81,19 +81,22 @@ const SYMBOL = /^[a-z0-9]+(\.[a-z0-9]+)*$/;
 // ---- Declarations ----
 // The JSON Schema Coda reads: a scalar, a choice of several among fixed options (an array of `items.anyOf` constants, as a
 // form's multi-select), several model services (an array of `items` of format `coda-model-provider`, which the
-// machine's model services are offered for), or an object whose entries all share one schema (VS Code shows such a setting as a table): a single
-// value, an Agent combination, or a row of named columns, each a single value, secrets among them (docs/plugins.md「类型」). Anything else is refused when the plugin is read, not ignored. `level`: what is read, a
-// setting, a table's entry, or a column of its rows.
+// machine's model services are offered for), a list of rows (an array of `items` an object of named columns), or an object
+// whose entries all share one schema (VS Code shows such a setting as a table): a single value, an Agent combination, or a
+// row of named columns, each a single value or an Agent combination, secrets among them (docs/plugins.md「类型」). Anything
+// else is refused when the plugin is read, not ignored. `level`: what is read, a setting, a table's entry, or a column of its rows.
 const COLUMN = /^[a-z][A-Za-z0-9]{0,39}$/, OPTION = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+// How many rows a list of them holds.
+const ROWS_AT_MOST = 50;
 function schema(value, where, level = 'setting') {
   check(value && typeof value === 'object' && !Array.isArray(value), 'invalid_plugin', `${where} 须为 JSON Schema 对象`);
-  const known = ['type', 'default', 'description', 'markdownDescription', 'title', 'enum', 'enumDescriptions', 'minimum', 'maximum', 'format', 'order',
+  const known = ['type', 'default', 'description', 'markdownDescription', 'title', 'enum', 'enumDescriptions', 'enumItemLabels', 'minimum', 'maximum', 'format', 'order',
     ...{ setting: ['additionalProperties', 'propertyNames', 'writeOnly', 'modelKey', 'modelApi', 'items', 'uniqueItems'], entry: ['properties', 'required'],
       column: ['writeOnly', 'modelKey', 'modelApi'] }[level]];
-  check(level !== 'column' || value.type !== 'object', 'invalid_plugin', `${where}：一列只能是单个值`);
+  check(level !== 'column' || value.type !== 'object' || value.format === 'coda-agent', 'invalid_plugin', `${where}：一列只能是单个值或 Agent 组合`);
   check(level !== 'entry' || value.type !== 'object' || value.format === 'coda-agent' || value.properties !== undefined, 'invalid_plugin',
     `${where}：表格的每一项只能是单个值、Agent 组合，或 properties 写明的 1–20 列`);
-  check(value.type !== 'array' || level === 'setting', 'invalid_plugin', `${where}：多选只能是插件的一项设置，不能放进表格`);
+  check(value.type !== 'array' || level === 'setting', 'invalid_plugin', `${where}：多选与一列行只能是插件的一项设置，不能放进表格`);
   const extra = Object.keys(value).filter(k => !known.includes(k));
   check(!extra.length, 'invalid_plugin', `${where} 里有 Coda 不支持的键：${extra.join('、')}`);
   check((value.properties === undefined && value.required === undefined) || (value.type === 'object' && value.format === undefined), 'invalid_plugin',
@@ -104,14 +107,20 @@ function schema(value, where, level = 'setting') {
     'invalid_plugin', `${where}：密文设置（writeOnly）只能是没有 format、enum 与默认值的文本`);
   const agent = value.format === 'coda-agent';
   check(['boolean', 'integer', 'number', 'string', 'object', 'array'].includes(value.type), 'invalid_plugin', `${where} 的 type 不受支持：${value.type}`);
-  check((value.items === undefined && value.uniqueItems === undefined) || value.type === 'array', 'invalid_plugin', `${where}：只有多选（type: array）才写 items 与 uniqueItems`);
+  check((value.items === undefined && value.uniqueItems === undefined) || value.type === 'array', 'invalid_plugin', `${where}：只有多选与一列行（type: array）才写 items 与 uniqueItems`);
   check(value.format === undefined || agent || value.format === 'coda-agent-match' || STRING_FORMATS.includes(value.format), 'invalid_plugin', `${where} 的 format 不受支持：${value.format}`);
   check(!agent || value.type === 'object', 'invalid_plugin', `${where}：coda-agent 是对象`);
   check(!STRING_FORMATS.includes(value.format) || value.type === 'string', 'invalid_plugin', `${where}：${value.format} 是文本`);
   check(value.enum === undefined || (Array.isArray(value.enum) && value.enum.length && ['string', 'integer', 'number'].includes(value.type)), 'invalid_plugin', `${where} 的 enum 无效`);
+  // What each option is shown as, as VS Code's settings say it.
+  check(value.enumItemLabels === undefined || (Array.isArray(value.enum) && Array.isArray(value.enumItemLabels) && value.enumItemLabels.length === value.enum.length
+    && value.enumItemLabels.every(label => typeof label === 'string' && label.length <= 100)), 'invalid_plugin', `${where} 的 enumItemLabels 须与 enum 一一对应`);
   check((value.modelKey === undefined && value.modelApi === undefined) || value.format === 'coda-model-url', 'invalid_plugin',
     `${where}：modelKey 与 modelApi 只写在 coda-model-url 的地址上`);
   const out = { type: value.type, ...(value.format ? { format: value.format } : {}), ...(value.enum ? { enum: value.enum } : {}),
+    ...(value.enumItemLabels ? { enumItemLabels: value.enumItemLabels } : {}),
+    ...(Array.isArray(value.enumDescriptions) && value.enum && value.enumDescriptions.length === value.enum.length && value.enumDescriptions.every(d => typeof d === 'string')
+      ? { enumDescriptions: value.enumDescriptions } : {}),
     ...(value.minimum !== undefined ? { minimum: value.minimum } : {}), ...(value.maximum !== undefined ? { maximum: value.maximum } : {}),
     ...(typeof value.description === 'string' ? { description: value.description } : typeof value.markdownDescription === 'string' ? { description: value.markdownDescription } : {}),
     ...(typeof value.title === 'string' ? { title: value.title } : {}), ...(Number.isFinite(value.order) ? { order: value.order } : {}),
@@ -129,6 +138,14 @@ function schema(value, where, level = 'setting') {
       && items.modelApis.every(isModelApi)), 'invalid_plugin', `${where}.items.modelApis 须为 1–10 个接口名，取 ${MODEL_APIS.join('、')}`);
     out.format = 'coda-model-provider';
     if (items.modelApis) out.modelApis = [...new Set(items.modelApis)];
+  } else if (value.type === 'array' && value.items?.type === 'object') {
+    // A list of rows, each of named columns as a table's row is, kept in the order written: what has no name of its own.
+    check(value.format === undefined && value.minimum === undefined && value.maximum === undefined && value.uniqueItems === undefined, 'invalid_plugin',
+      `${where}：一列行不写 format、minimum、maximum 与 uniqueItems`);
+    check(value.items.format === undefined && value.items.properties !== undefined, 'invalid_plugin', `${where}：一列行写 items: { type: object, properties, required }`);
+    out.rows = schema(value.items, `${where}.items`, 'entry');
+    // Taken whole, as a value is: a secret is written only column by column, as a table's row has it.
+    check(!Object.values(out.rows.columns).some(column => column.writeOnly), 'invalid_plugin', `${where}：一列行的列不能是密文，要密文用表格`);
   } else if (value.type === 'array') {
     // A choice of several: each option a constant of its own, with what the client shows for it; chosen ones kept in this order.
     check(value.format === undefined && value.minimum === undefined && value.maximum === undefined, 'invalid_plugin', `${where}：多选不写 format、minimum 与 maximum`);
@@ -184,6 +201,76 @@ function modelFields(fields, where) {
   }
 }
 
+// The modes a composer can be put in (docs/plugins.md「输入框模式」): what it shows then — an icon and a title, a line on
+// what sending does, its placeholder and send button —, whom what is sent is for (`agent`: the session's agent, `own` one
+// chosen for it, which a new session runs, `off` none shown), and its parameters, written as settings are. One entered by a
+// character typed first (`trigger`, as `!`) is the text's: it has no parameters, and what is sent in it is the session's.
+// Which composers offer it (`in`) is its own to say: a session's (`session`), and the one of a session not started yet
+// (`new`, the new task's), where what is sent starts that session in it; one whose messages a new session takes is sent
+// from a session, so only a session's.
+export const MODE_AGENTS = ['session', 'own', 'off'];
+// What a plugin tells a session's agent at once (docs/session-contracts.md「顺带告诉」): a text, at most this long.
+const TELL_LIMIT = 4000;
+export const checkTold = text => check(typeof text === 'string' && text.trim() && text.length <= TELL_LIMIT && !text.includes('\0'), 'invalid_input',
+  `要告诉的话须为不超过 ${TELL_LIMIT} 字的文字`);
+export const MODE_PLACES = ['session', 'new'];
+const MODE_KEYS = ['id', 'title', 'icon', 'hint', 'placeholder', 'sendLabel', 'agent', 'trigger', 'in', 'parameters'];
+const oneLine = (text, most) => typeof text === 'string' && !!text.trim() && [...text].length <= most && !/[\0\r\n]/.test(text);
+function composerModeDeclarations(value) {
+  const modes = value ?? [];
+  check(Array.isArray(modes) && modes.length <= 10, 'invalid_plugin', 'contributes.composerModes 须为数组，至多 10 个');
+  const out = modes.map((m, i) => {
+    const where = `contributes.composerModes[${i}]`;
+    check(m && typeof m === 'object' && !Array.isArray(m) && Object.keys(m).every(k => MODE_KEYS.includes(k)), 'invalid_plugin',
+      `${where} 只能写 ${MODE_KEYS.join('、')}`);
+    check(typeof m.id === 'string' && COMMAND.test(m.id), 'invalid_plugin', `${where}.id 是小写字母、数字和「-」，以字母开头，不超过 40 个字符`);
+    check(oneLine(m.title, 40), 'invalid_plugin', `${where}.title 是不超过 40 字的一行`);
+    check(typeof m.icon === 'string' && m.icon.length <= 100 && SYMBOL.test(m.icon), 'invalid_plugin', `${where}.icon 是 SF Symbol 的名字`);
+    check(m.hint === undefined || oneLine(m.hint, 200), 'invalid_plugin', `${where}.hint 是不超过 200 字的一行`);
+    check(m.placeholder === undefined || oneLine(m.placeholder, 40), 'invalid_plugin', `${where}.placeholder 是不超过 40 字的一行`);
+    check(m.sendLabel === undefined || oneLine(m.sendLabel, 20), 'invalid_plugin', `${where}.sendLabel 是不超过 20 字的一行`);
+    check(m.agent === undefined || MODE_AGENTS.includes(m.agent), 'invalid_plugin', `${where}.agent 只能是 ${MODE_AGENTS.join('、')}`);
+    check(m.trigger === undefined || (typeof m.trigger === 'string' && /^[!#$%&*+:;=?^|~]$/.test(m.trigger)), 'invalid_plugin',
+      `${where}.trigger 是一个标点：!#$%&*+:;=?^|~ 之一`);
+    check(m.trigger === undefined || (m.parameters === undefined && m.agent !== 'own'), 'invalid_plugin', `${where}：打字进入的模式（trigger）没有参数，也不另选 Agent`);
+    check(m.in === undefined || (Array.isArray(m.in) && m.in.length && m.in.every(place => MODE_PLACES.includes(place)) && new Set(m.in).size === m.in.length),
+      'invalid_plugin', `${where}.in 是它出现的输入框，取 ${MODE_PLACES.join('、')}，不重复`);
+    check(m.agent !== 'own' || !m.in?.includes('new'), 'invalid_plugin', `${where}：开新会话的模式（agent: own）要从会话里发出，不能在 new 里`);
+    return { id: m.id, title: m.title.trim(), icon: m.icon, ...(m.hint ? { hint: m.hint.trim() } : {}), ...(m.placeholder ? { placeholder: m.placeholder.trim() } : {}),
+      ...(m.sendLabel ? { sendLabel: m.sendLabel.trim() } : {}), agent: m.agent ?? 'session', ...(m.trigger ? { trigger: m.trigger } : {}),
+      in: m.in ? MODE_PLACES.filter(place => m.in.includes(place)) : ['session'],
+      // As read, which the clients show; as written (JSON Schema), which its hooks are given (components/composer-modes).
+      ...(m.parameters !== undefined ? { parameters: modeParameters(m.parameters, `${where}.parameters`), schema: structuredClone(m.parameters) } : {}) };
+  });
+  check(new Set(out.map(m => m.id)).size === out.length, 'invalid_plugin', 'contributes.composerModes 的 id 不能重复');
+  const triggers = out.filter(m => m.trigger).map(m => m.trigger);
+  check(new Set(triggers).size === triggers.length, 'invalid_plugin', 'contributes.composerModes 的 trigger 不能重复');
+  return out;
+}
+// A mode's parameters: an object of named properties, each read as a setting is but a secret; what it cannot go without, `required`.
+export function modeParameters(value, where) {
+  check(value && typeof value === 'object' && !Array.isArray(value) && value.type === 'object' && Object.keys(value).every(k => ['type', 'properties', 'required'].includes(k)),
+    'invalid_plugin', `${where} 须为 { type: object, properties, required? }`);
+  const properties = value.properties;
+  check(properties && typeof properties === 'object' && !Array.isArray(properties) && Object.keys(properties).length >= 1 && Object.keys(properties).length <= 20,
+    'invalid_plugin', `${where}.properties 须为 1–20 个参数`);
+  // In the order written, which the clients show them in: JSON's objects keep none of their own there.
+  const ordered = (fields, at) => Object.fromEntries(Object.entries(fields).map(([name, spec], i) => [name, { ...spec, order: spec.order ?? at + i }]));
+  const out = Object.fromEntries(Object.entries(properties).map(([name, p], i) => {
+    check(COLUMN.test(name), 'invalid_plugin', `${where} 的参数名只用字母和数字，以小写字母开头：${name}`);
+    const read = schema(p, `${where}.properties.${name}`);
+    const rows = read.rows ? { rows: { ...read.rows, columns: ordered(read.rows.columns, 0) } } : {};
+    const spec = { ...read, ...rows, order: read.order ?? i };
+    const secret = s => s.writeOnly || Object.values(s.columns ?? s.rows?.columns ?? s.entries?.columns ?? {}).some(c => c.writeOnly);
+    check(!secret(spec), 'invalid_plugin', `${where}.properties.${name}：参数不能是密文`);
+    return [name, spec];
+  }));
+  const required = value.required ?? [];
+  check(Array.isArray(required) && required.every(name => typeof name === 'string' && Object.hasOwn(out, name)) && new Set(required).size === required.length,
+    'invalid_plugin', `${where}.required 须为本模式的参数名，不重复`);
+  return { properties: out, ...(required.length ? { required: [...required] } : {}) };
+}
+
 // The category it is listed under (docs/plugins.md「商店」): the first of its manifest's `categories`, as VS Code's are
 // written; empty when it names none. Not checked: readPlugin does that.
 export const manifestCategory = manifest => Array.isArray(manifest?.categories) && typeof manifest.categories[0] === 'string' ? manifest.categories[0].trim().slice(0, 32) : '';
@@ -288,6 +375,7 @@ export function readPlugin(dir, source) {
     && (v.readout === undefined || VIEW_READOUTS.includes(v.readout)) && (v.checkout === undefined || VIEW_CHECKOUTS.includes(v.checkout)))
     && new Set(views.map(v => v.id)).size === views.length, 'invalid_plugin',
   `contributes.views 须为 { id, title, entry, in?, icon?, handles? } 的数组，至多 10 个：id 是小写字母、数字和「-」，以字母开头，不重复；title 是不超过 40 字的一行；entry 是插件目录里的 .html 文件；in 是它常驻的位置（${VIEW_PLACES.join('、')}），不重复；icon 是 SF Symbol 的名字；handles 是它接管打开的引用种类（如 workflow-runs），至多 8 个，不重复；readout 是它的读数（${VIEW_READOUTS.join('、')}）；checkout 是它只给哪种工作位置的会话（${VIEW_CHECKOUTS.join('、')}）`);
+  const composerModes = composerModeDeclarations(manifest.contributes?.composerModes);
   const handled = views.flatMap(v => v.handles ?? []);
   check(new Set(handled).size === handled.length, 'invalid_plugin', 'contributes.views：同一种引用只能由一个视图接管');
   for (const v of views) {
@@ -337,6 +425,7 @@ export function readPlugin(dir, source) {
     views: views.map(v => ({ id: v.id, title: v.title, entry: posix.normalize(v.entry), ...(v.in?.length ? { in: [...v.in] } : {}), ...(v.icon ? { icon: v.icon } : {}),
       ...(v.handles?.length ? { handles: [...v.handles] } : {}), ...(v.readout ? { readout: v.readout } : {}),
       ...(v.checkout ? { checkout: v.checkout } : {}) })),
+    ...(composerModes.length ? { composerModes } : {}),
     // What it writes for another plugin's points, as written (components/plugins/plugin-extensions.mjs offerDeclarations).
     ...(Object.keys(offers).length ? { offers } : {}),
     agents: agentDeclarations(manifest.contributes?.agents, dir),
@@ -647,6 +736,16 @@ export function checkValue(spec, value, where, code = 'invalid_input') {
     }));
   }
   if (spec.type === 'boolean') { check(typeof value === 'boolean', code, `${where}须为开或关`); return value; }
+  // Rows in the order written, taken whole: a column not written is its default, as a table's row is resolved (rowValue),
+  // so that one a row cannot go without is there.
+  if (spec.type === 'array' && spec.rows) {
+    check(Array.isArray(value) && value.length <= ROWS_AT_MOST, code, `${where}须为至多 ${ROWS_AT_MOST} 行`);
+    const defaults = Object.entries(spec.rows.columns).filter(([, column]) => column.default !== undefined);
+    return value.map((row, i) => {
+      const checked = checkValue(spec.rows, row, `${where}第 ${i + 1} 行`, code);
+      return { ...Object.fromEntries(defaults.map(([name, column]) => [name, column.default])), ...checked };
+    });
+  }
   // Model services, each once, in the order chosen: one named may be of a plugin not installed (yet), as a single one may.
   if (spec.type === 'array' && spec.format === 'coda-model-provider') {
     check(Array.isArray(value) && value.length <= MODEL_PROVIDERS_AT_MOST && value.every(v => typeof v === 'string' && MODEL_PROVIDER.test(v)), code,
@@ -761,7 +860,7 @@ function read(item, spec, from) {
   // Of options chosen once, those the plugin has no more are not chosen; a value stored before the setting was a choice is none.
   if (spec.type === 'array' && spec.format === 'coda-model-provider')
     return Array.isArray(item.value) ? { value: item.value.filter(v => typeof v === 'string' && MODEL_PROVIDER.test(v)), from } : null;
-  if (spec.type === 'array') return Array.isArray(item.value) ? { value: spec.options.map(o => o.value).filter(v => item.value.includes(v)), from } : null;
+  if (spec.type === 'array' && spec.options) return Array.isArray(item.value) ? { value: spec.options.map(o => o.value).filter(v => item.value.includes(v)), from } : null;
   return { value: item.value, from };
 }
 // Every setting of a plugin for one project (or for every project, without one): project over plugin over default.

package/check/coda/components/plugins/plugin-source-rules.mjs

@@ -254,11 +254,13 @@ export function builtinProblem(id, source, builtin, installed) {
   return `与内置插件 ${id} 同名${copy.source?.repo || copy.source?.package ? '，来源不同' : ''}，请先卸载内置插件再安装`;
 }
 // What only one plugin may declare, as said to the user: an agent (sessions name it by its ID alone), a concurrency group
-// (any process takes it by its name), Git's credentials for an address, opening a kind of reference (a view's `handles`)
+// (any process takes it by its name), Git's credentials for an address, opening a kind of reference (a view's `handles`),
+// a composer mode's name and the character typed to enter one (the composer finds it by them)
 // and a key of `contributes` a point takes. A command, as a Skill or a variable, is a
 // project's: one two plugins of a project bring is neither's there (components/plugins/plugins.mjs launch).
 export const claims = plugin => [...plugin.agents.map(a => `Agent ${a.id}`), ...plugin.groups.map(g => `组 ${g.name}`),
   ...(plugin.gitCredentials ?? []).map(c => `${c.url} 的 Git 凭据`), ...(plugin.views ?? []).flatMap(v => (v.handles ?? []).map(kind => `打开 ${kind} 引用`)),
+  ...(plugin.composerModes ?? []).flatMap(m => [`输入框模式 /${m.id}`, ...(m.trigger ? [`输入框里打 ${m.trigger} 进入的模式`] : [])]),
   ...Object.values(plugin.extensionPoints ?? {}).filter(p => p.contributes).map(p => `扩展点 contributes.${p.contributes}`)];
 // Why a plugin cannot sit beside those this machine has (`catalog`: built-in and installed, by ID; `builtin`: the plugins
 // Coda ships, by ID), or null: an installed built-in one's ID from another source (builtinProblem), or an agent, a group
@@ -328,6 +330,8 @@ export function contributions(plugin, catalog = new Map()) {
     ...(plugin.views?.length ? { views: plugin.views.map(v => ({ id: v.id, title: v.title, ...(v.in ? { in: v.in } : {}), ...(v.icon ? { icon: v.icon } : {}), ...(v.handles ? { handles: v.handles } : {}), ...(v.readout ? { readout: v.readout } : {}),
       ...(v.checkout ? { checkout: v.checkout } : {}) })) } : {}),
     groups: plugin.groups.map(g => ({ name: g.name, capacity: g.capacity })),
+    // The modes it puts the composer in, as declared: the clients show them from this.
+    ...(plugin.composerModes?.length ? { composerModes: plugin.composerModes.map(({ schema: _, ...mode }) => mode) } : {}),
     extensions: plugin.extensions.map(e => ({ plugin: e.plugin, point: e.point, command: e.command })),
     // What it writes for points under keys of `contributes` (the resources plugin's panels): by point, how many and the
     // commands in them, each with what it is for.

package/check/coda/components/session-config/commands.mjs

@@ -42,11 +42,20 @@ export function quotes(value = []) {
   return passages;
 }
 
+// The composer mode a message was sent in (docs/plugins.md「输入框模式」), as it was then: `<plugin>/<mode>`, its title and
+// icon, which its bubble shows however the plugin changes later.
+export function modeMark(value) {
+  object(value, '输入框模式');
+  keys(value, ['id', 'title', 'icon']);
+  check(typeof value.id === 'string' && /^[a-z][a-z0-9-]{0,39}\/[a-z][a-z0-9-]{0,39}$/.test(value.id), 'invalid_input', '输入框模式须写成「插件/模式」');
+  return { id: value.id, title: text(value.title, '模式名', 40), icon: text(value.icon, '模式图标', 100) };
+}
+
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
 export function firstMessage(value) {
   object(value, '首次发送');
   keys(value, ['requestId', 'projectId', 'title', 'agent', 'checkout', 'settings', 'text', 'attachments', 'quotes', 'handoffSource', 'parentThreadId',
-    'replyTo', 'threadId', 'extensionParent']);
+    'replyTo', 'threadId', 'extensionParent', 'mode']);
   const handoff = value.handoffSource === undefined ? {} : { handoffSource: text(value.handoffSource, '交接来源', 100) };
   const parent = value.parentThreadId === undefined ? {} : { parentThreadId: text(value.parentThreadId, '父会话', 100) };
   check(!parent.parentThreadId || handoff.handoffSource === parent.parentThreadId, 'invalid_input', '子会话必须引用父会话上下文');
@@ -96,6 +105,7 @@ export function firstMessage(value) {
     settings: settings(value.settings),
     text: message,
     ...(passages.length ? { quotes: passages } : {}),
+    ...(value.mode === undefined ? {} : { mode: modeMark(value.mode) }),
   }, attachments(value.attachments));
 }
 

package/check/coda/contract.json

@@ -1,5 +1,5 @@
 {
-  "commit": "93e1f9059276267bbf0aa4cd2979a98e199b6547",
+  "commit": "04fd85113f83823020febc7ffc647f10d15a2ddc",
   "packages": {
     "@0dep/piso": "5.2.0",
     "@agentclientprotocol/sdk": "1.4.0",
@@ -9,11 +9,11 @@
     "check/coda/components/plugins/agent-plugins.mjs": "23016dd0f7350a10f71565a2c44e2c1179299a93e8c859529071099f2ce862d1",
     "check/coda/components/plugins/model-protocols.mjs": "762244c01266cf61384377bdfbb84bef5ab157b1783f9254ddc1ae3d576a73c5",
     "check/coda/components/plugins/plugin-extensions.mjs": "e527800a109ec9849975357f841b0c05ecfa50c9d9c34e26d828aef3cb7d3cb3",
-    "check/coda/components/plugins/plugin-rules.mjs": "78d9431c1b4f6354457f153bb74a0fd085c771eaadd9f7523633915cb700f4f9",
-    "check/coda/components/plugins/plugin-source-rules.mjs": "d620ee62fb372e31e5389e27f7202308aab74324b6f5552ffef3844afc7d0001",
+    "check/coda/components/plugins/plugin-rules.mjs": "8cd1058fc96365f7f35451a4a75bd1c6434e0e036bb4b18f7c7fc37709e66c3e",
+    "check/coda/components/plugins/plugin-source-rules.mjs": "e03606bf3056061ee3a78494d34dae9dfbe35d6fb2f139880fab5891663cbedc",
     "check/coda/components/plugins/skill-document.mjs": "c5b5e815c42cd836572f7b60e22a46af6ac607fd9df0170fa36f955825636ce6",
     "check/coda/components/prompt-recovery/prompt-recovery.mjs": "f43f21d24c19a58113d3304f9248225b12080ab00ed15eab74bf7b94642732de",
-    "check/coda/components/session-config/commands.mjs": "96247da877e455f835e0ee41622e531936e2600e911c2e9a4638fda00e987ec3",
+    "check/coda/components/session-config/commands.mjs": "2ccc0c089d88b3f76d9098876dc60bd7e06348931773da131732c0d6c6c7a6cf",
     "check/coda/components/workflows/executor-labels.mjs": "dceca6ae60c0a4f3c3cc72a6c84f1489831790774c93caab96e4ddb493bc89e1",
     "check/coda/domain/agent-protocol.mjs": "7337cf0af97a9592bbcad98a0e4f3837d8bb4d48b53c22846a8c56a0c88a4630",
     "check/coda/domain/duration.mjs": "15dd64ef9b02342ad521c66e5968a569432a89dc7568d11afd3e6f3fe37e104b",
@@ -24,7 +24,7 @@
     "check/coda/resources/plugins/resources/panels/panels.mjs": "aee040febb37fd6eebaf1a1da5b3299d2b6a9dfc982e649d9a628291af298179",
     "check/coda/resources/plugins/resources/panels/rules.mjs": "c024c5ede7c1516877128aa6d6796fbe5fd0e14642741b0745481bb1c5ca41d3",
     "check/coda/resources/plugins/resources/panels/sign-in.mjs": "1271a24e33b1b882a1fb9bee03b8e240db8b9bee1b5208f0e1c84499cfb1be7e",
-    "check/coda/builtin.json": "0e04c5a9bb82db5573d865791df6fe9e52295be470b1bcdf0add719d2d2c0b85",
+    "check/coda/builtin.json": "add6de7df1f74456223275750a76919c983fd3eba2f4c0750077f7b998d9d3fc",
     "docs/agent-protocol.md": "2a40fac029e93bc512d0405105c9d74fa3e5a59e92788b6951dba182775875c1"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coda-console/plugin-check",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "Coda 插件的契约检查：扮演 Coda 读清单、启动 Agent 讲 ACP 与 _coda/wait、读面板。",
   "license": "MIT",
   "repository": {