@coda-console/plugin-check 0.5.4 → 0.5.6

package/README.md

@@ -93,6 +93,9 @@ OpenCode 遇到模型服务的 429，会照 `Retry-After` 等（OpenCode 2 每
 Coda 自己对服务故障只等一分钟以内，所以主请求或它仍在等待的前台子会话要等超过一分钟才重试时，入口先 `session/cancel` 停下这一轮（前台子 Agent 随之停下），
 再把这一轮答成失败，原因是服务给的原文加上 OpenCode 要等多久；停下后 OpenCode 回的是什么都不转出。一分钟以内的等待照旧由 OpenCode 自己处理。
 不在入口里按厂商的错误文字判断额度耗尽。
+明确的 `[ttft_admission_refused] the cell is at capacity` 容量拒绝在停下原生轮次后报告为 `service_unavailable`，
+带 `input: accepted` 与 OpenCode 实际安排的剩余等待 `retryAfterMs`；Coda 按该等待决定是否重试，长等待以已知失败结束。
+保留服务原文（其中建议的短等待也原样保留），不把它当成 OpenCode 的实际重试时间，不把普通 429 或认证失败归为容量拒绝。
 
 OpenCode 的原生子会话经 ACP 的 `opencode/child-session-updates` 能力接入（入口 `agent/children.mjs`，核对 OpenCode 2.1.4）：
 `opencode/session/child_update` 的创建与运行状态登记成 `_coda/wait`，带原生 `childSessionId`；子会话的回复、思考与工具调用各归自己的过程，
@@ -191,7 +194,8 @@ Claude 的设置「缓存过期前压缩」（`claude.idleCompaction`，默认
 - **Agent 报什么**：每轮结束时，入口在 `usage_update` 的 `_meta.coda` 里带上主线程缓存的情况，Coda 原样作为会话事实 `usage`：
   `lastRequestAt`（最后一次请求模型的时刻，缓存最后被用到；压缩那一轮不算）、`contextTokens`（那次请求带的上下文 token 数）、
   `cacheTtl`（`PT1H` 或 `PT5M`，从回复写缓存的明细看出）、`compactedAt`（最近一次压缩，Claude Code 自动的、`/compact` 的、Coda 请的都算）。
-  `usage_update` 的 `used` 是这一轮所有请求加起来的，不是上下文大小。
+  `usage_update` 的 `used` 同样取主线程最近一次请求的上下文量（含缓存读取与写入），压缩后取摘要留下的 token 数；
+  不累加一轮中的多次请求，也不包含子 Agent 的上下文。尚无上下文量时不显示窗口用量；`cost` 保留 SDK 报的累计费用估算。
 - **压缩那一轮**：入口在 `initialize` 的 `agentCapabilities._meta.coda` 里声明 `compact: {}`，收到 `_coda/session/compact`（`{ sessionId }`，
   两轮之间也可以发）就往 SDK 的输入送一条 `/compact`。这一轮不归 Coda 的哪个 `session/prompt`，也不登记活动；Coda 只看到 `compaction_update`，
   命令输出不转成回复。期间 Coda 发来的一轮排在它后面照常回复，插话回 `promptRequired`。压完回答 `{ compacted: true, before, after }`（前后的

package/check/coda/builtin.json

@@ -128,8 +128,8 @@
   {
     "id": "github",
     "displayName": "GitHub",
-    "description": "在 Coda 里登录 GitHub 账号，可以登录多个。Coda 启动的会话、流程步骤与插件安装访问 GitHub 时，按仓库的 owner 自动试出能推送的账号并记下，之后这个 owner 的仓库都用它；账号按面板上的顺序试，可以上移下移；会话里的 gh 与提交署名也跟着这个账号；gh 的只读命令遇到网络类失败会自动重试。添加项目、安装插件时可以从这些账号的仓库里挑。",
-    "version": "1.6.0",
+    "description": "在 Coda 里登录 GitHub 账号，可以登录多个。Coda 启动的会话、流程步骤与插件安装访问 GitHub 时，按仓库的 owner 自动试出能推送的账号并记下，之后这个 owner 的仓库都用它；账号按面板上的顺序试，可以上移下移；会话里的 gh 与提交署名也跟着这个账号；gh 的只读命令遇到网络类失败会自动重试。会话里的 git 也经它交给真正的 git，Git 自己已知、重跑即好的故障（几个工作树同时创建时读到别的还没写好的 commondir）自动重跑；会话推送它开的 PR 的分支时，PR 观察立即去看，PR 已合并或关闭就当场提醒这次推送进不了目标分支。添加项目、安装插件时可以从这些账号的仓库里挑。",
+    "version": "1.8.0",
     "category": "模型与账号",
     "source": {
       "kind": "builtin"
@@ -155,6 +155,10 @@
         "name": "gh",
         "command": "exec \"$CODA_NODE\" \"$CODA_PLUGIN_PATH/scripts/gh.mjs\""
       },
+      {
+        "name": "git",
+        "command": ". \"$CODA_PLUGIN_PATH/scripts/git.sh\""
+      },
       {
         "name": "github-reported-pr",
         "command": "exec \"$CODA_NODE\" \"$CODA_PLUGIN_PATH/scripts/reported-pr.mjs\""
@@ -165,6 +169,10 @@
         "name": "github.pull_request_reported",
         "starts": true
       },
+      {
+        "name": "git.pushed",
+        "starts": true
+      },
       {
         "name": "pull_request.opened",
         "starts": true
@@ -620,14 +628,14 @@
     "id": "claude",
     "displayName": "Claude",
     "description": "Claude SDK Agent：Coda 基于 Claude Agent SDK 写的 ACP 入口，一个进程一个 SDK 会话；资源页的「Claude」面板显示会话报告的额度，可从 Coda 登录。",
-    "version": "1.7.1",
+    "version": "1.7.2",
     "category": "Agent",
     "source": {
       "kind": "builtin",
       "package": "@coda-console/claude",
       "tag": "latest",
-      "version": "1.7.1",
-      "integrity": "sha512-9qMohzOjOa9b/axGqLmJIMpGqeyBN3cTymzjGI2Q9w0nImRah+/t5sPdTy9k/w2xLY3d7nSnXYJ26A55Bz/m3A==",
+      "version": "1.7.2",
+      "integrity": "sha512-Ux5uWnF1sBwOIUTIXfeZwbRWbJz9ZVKaxPL0Q2QMD7C5uPDzDU1KQjR6fJPKwmIw9kR5YFSz3cq7GuL3DEo4kg==",
       "repo": "https://github.com/coda-console/coda-plugins.git",
       "path": "plugins/claude"
     },
@@ -709,15 +717,15 @@
   {
     "id": "codex",
     "displayName": "Codex",
-    "description": "Codex Agent：Coda 自带的入口运行 codex-acp，报告子 Agent 与后台命令。额度与登录由账号来源插件接管；未接入账号来源时使用 Codex 自己的登录面板。",
-    "version": "1.8.4",
+    "description": "Codex Agent：Coda 自带的入口运行 codex-acp，报告子 Agent、后台命令与命令的自动审核。额度与登录由账号来源插件接管；未接入账号来源时使用 Codex 自己的登录面板。",
+    "version": "1.8.5",
     "category": "Agent",
     "source": {
       "kind": "builtin",
       "package": "@coda-console/codex",
       "tag": "latest",
-      "version": "1.8.4",
-      "integrity": "sha512-5I25uyfwVaAjkOKV7iD5bzFnVGwD0dykFmz12k0sumgICaVKdvkimTK2bZQBAuKwUt8E44F8qSonRRIlIKVK5A==",
+      "version": "1.8.5",
+      "integrity": "sha512-5XPcuzapKiTI/jf8V7JADLTgr2nimB1untf961lhujLlMHPevrMO+u5qIgZPeadLNl7IAo6Gez1GARcpAzfmcw==",
       "repo": "https://github.com/coda-console/coda-plugins.git",
       "path": "plugins/codex"
     },
@@ -1012,14 +1020,14 @@
     "id": "opencode",
     "displayName": "OpenCode",
     "description": "OpenCode Agent：接入原生子会话的状态、过程与停止，跟踪后台命令，并送入会话指令。",
-    "version": "2.2.0",
+    "version": "2.2.1",
     "category": "Agent",
     "source": {
       "kind": "builtin",
       "package": "@coda-console/opencode",
       "tag": "latest",
-      "version": "2.2.0",
-      "integrity": "sha512-mjssWkJr+Pg6bCI9f5JfG3zGrNfE9ecyLZhmz4z3Ij0FHZ7p/4UJ36ps+e18xC8WZDQXkwzOle4xYaxfFPoCAA==",
+      "version": "2.2.1",
+      "integrity": "sha512-Nh8hHSI3mBC43spD6410oCxAfSmjj/OWF1AXEhibCQIxswISHgXt0b39OpY1wHZPENZ9UmFSjmmAJpmdujNuEg==",
       "repo": "https://github.com/coda-console/coda-plugins.git",
       "path": "plugins/opencode"
     },
@@ -1085,15 +1093,15 @@
   {
     "id": "review",
     "displayName": "PR 生命流程",
-    "description": "会话开的 PR 从开出来起一条流程：每个新版本先跑项目声明的检查，再请另一家 Agent 评审，要求修改时交给开 PR 的会话处理、有分歧时交给你仲裁；通过后请你批准合并，跑过项目的合并前检查再合并，合并后按你的选择调用项目的部署、发布流程，PR 合并或关闭时结束。",
-    "version": "2.6.0",
+    "description": "会话开的 PR 从开出来起一条流程：每个新版本先跑项目声明的检查，再请另一家 Agent 评审，要求修改时交给开 PR 的会话处理、有分歧时交给你仲裁；通过后请你批准合并，跑过项目的合并前检查再合并，合并后按你的选择删除远程分支、调用项目的部署和发布流程，PR 合并或关闭时结束。",
+    "version": "2.7.0",
     "category": "工作流程",
     "source": {
       "kind": "builtin",
       "package": "@coda-console/review",
       "tag": "latest",
-      "version": "2.6.0",
-      "integrity": "sha512-OEMg2O/4wJ3hoG/S4cbgXL3Fsmopb4hF6xwDeJbDOR5hWXQ406okHO7uxSOCJCbqp5E8vPTrwmrwvz8CN7qRWw==",
+      "version": "2.7.0",
+      "integrity": "sha512-RI8F5KkWgoKnvCv7Xwk7C0CwXe2AG8WcHOKOSY1oBFwe2qxXhJbgPqroc7IJkjXYhbnW23cmokt9ThP8pPD8gA==",
       "repo": "https://github.com/coda-console/coda-plugins.git",
       "path": "plugins/review"
     },

package/check/coda/components/plugins/model-protocols.mjs

@@ -0,0 +1,39 @@
+// The interfaces a model service may speak (docs/plugins.md「模型服务」): a closed table. A plugin providing a service names
+// one of these (`api`), and so does one choosing services by what it speaks (`modelApis`). Each is a kind of resource of its
+// own (model-services.mjs): a service speaking OpenAI's is nothing like one speaking Anthropic's, whoever provides them. The
+// node delivers a service with its key where its interface carries it (model-services.mjs), Coda lists its models as a
+// client of it would (model-check.mjs), and what an agent is told of calling one is its kind's definition, from here
+// (coda-resources explain). A new interface is a row here: the node would not know where its key goes otherwise.
+// Each: what it is called and where it is defined; how its clients send a key (`key`) and what else (`also`); how the node
+// hands a key on to the service (`delivered`); how it is called and an example, templates of `{base}` (the service's
+// address), `{v1}` (that with `/v1` once: Anthropic's clients take the API's root and add `/v1` themselves, and a service
+// whose address is its versioned base has it already) and `{model}`.
+export const MODEL_PROTOCOLS = {
+  'openai-completions': {
+    title: 'OpenAI Chat', spec: 'https://platform.openai.com/docs/api-reference/chat',
+    description: '讲 OpenAI Chat Completions 接口的服务',
+    key: key => ({ Authorization: `Bearer ${key}` }), also: {},
+    delivered: key => ({ authorization: `Bearer ${key}` }),
+    call: 'POST {base}/chat/completions，body 带 model 与 messages',
+    example: `curl -s {base}/chat/completions -H 'Authorization: Bearer coda' -H 'Content-Type: application/json' \\\n  -d '{"model": "{model}", "messages": [{"role": "user", "content": "你好"}]}'`,
+  },
+  'openai-responses': {
+    title: 'OpenAI Responses', spec: 'https://platform.openai.com/docs/api-reference/responses',
+    description: '讲 OpenAI Responses 接口的服务',
+    key: key => ({ Authorization: `Bearer ${key}` }), also: {},
+    delivered: key => ({ authorization: `Bearer ${key}` }),
+    call: 'POST {base}/responses，body 带 model 与 input',
+    example: `curl -s {base}/responses -H 'Authorization: Bearer coda' -H 'Content-Type: application/json' \\\n  -d '{"model": "{model}", "input": "你好"}'`,
+  },
+  'anthropic-messages': {
+    title: 'Anthropic', spec: 'https://docs.anthropic.com/en/api/messages',
+    description: '讲 Anthropic Messages 接口的服务',
+    key: key => ({ 'x-api-key': key }), also: { 'anthropic-version': '2023-06-01' },
+    // Some of its clients send the key as a bearer token: the node sends it both ways.
+    delivered: key => ({ 'x-api-key': key, authorization: `Bearer ${key}` }),
+    call: 'POST {v1}/messages，body 带 model、max_tokens 与 messages；带请求头 anthropic-version',
+    example: `curl -s {v1}/messages -H 'x-api-key: coda' -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n  -d '{"model": "{model}", "max_tokens": 256, "messages": [{"role": "user", "content": "你好"}]}'`,
+  },
+};
+export const MODEL_APIS = Object.keys(MODEL_PROTOCOLS);
+export const isModelApi = api => typeof api === 'string' && Object.hasOwn(MODEL_PROTOCOLS, api);

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

@@ -23,6 +23,7 @@ import { fileURLToPath } from 'node:url';
 import { settings as agentSettings } from '../session-config/commands.mjs';
 import { requireCondition as check, ContractError } from '../../domain/errors.mjs';
 import { isDuration } from '../../domain/duration.mjs';
+import { MODEL_APIS, isModelApi } from './model-protocols.mjs';
 import { AGENT_ID } from '../../domain/values.mjs';
 import { agentDeclarations } from './agent-plugins.mjs';
 import { checkCatalog, dependencyDeclarations, extensionDeclarations, extensionPointDeclarations, extensionsFor, offerDeclarations } from './plugin-extensions.mjs';
@@ -59,7 +60,7 @@ export const MODEL_PROVIDER = /^[a-z][a-z0-9-]{0,39}\/[a-z][a-z0-9-]{0,39}$/;
 // How many model services a setting of several may name.
 const MODEL_PROVIDERS_AT_MOST = 20;
 // A command's name, as a shell finds it on the PATH; Coda's own come first and are no plugin's.
-const COMMAND = /^[a-z][a-z0-9-]{0,39}$/, CODA_COMMANDS = ['coda-run', 'coda-event'];
+const COMMAND = /^[a-z][a-z0-9-]{0,39}$/, CODA_COMMANDS = ['coda-run', 'coda-event', 'coda-resources'];
 // Where in the clients a view may stay (docs/plugins.md「视图」): beside a session.
 export const VIEW_PLACES = ['side', 'page'];
 // What a view's entry in the clients can show (docs/plugins.md「视图」): a count the clients keep themselves, not one the
@@ -125,7 +126,7 @@ function schema(value, where, level = 'setting') {
     check(Object.keys(items).every(k => ['type', 'format', 'modelApis'].includes(k)) && items.type === 'string', 'invalid_plugin',
       `${where}：多个模型服务写 items: { type: string, format: coda-model-provider, modelApis }`);
     check(items.modelApis === undefined || (Array.isArray(items.modelApis) && items.modelApis.length >= 1 && items.modelApis.length <= 10
-      && items.modelApis.every(api => typeof api === 'string' && COMMAND.test(api))), 'invalid_plugin', `${where}.items.modelApis 须为 1–10 个接口名，如 anthropic-messages`);
+      && 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') {
@@ -411,7 +412,7 @@ function modelProviderDeclarations(raw, declared) {
       `${where} 须为 { id, title, api, url, key? }`);
     check(typeof p.id === 'string' && COMMAND.test(p.id), 'invalid_plugin', `${where} 的 id 只用小写字母、数字和「-」，以字母开头`);
     check(typeof p.title === 'string' && p.title.trim() && [...p.title].length <= 40 && !/[\0\r\n]/.test(p.title), 'invalid_plugin', `${where} 的 title 须为不超过 40 字的一行`);
-    check(typeof p.api === 'string' && COMMAND.test(p.api), 'invalid_plugin', `${where} 的 api 只用小写字母、数字和「-」，如 openai-completions`);
+    check(isModelApi(p.api), 'invalid_plugin', `${where} 的 api 须为 Coda 认得的接口：${MODEL_APIS.join('、')}`);
     check(typeof p.url === 'string' && p.url && p.url.length <= 4096 && !/[\0\r\n]/.test(p.url), 'invalid_plugin', `${where} 的 url 须为一行地址`);
     for (const [, place] of p.url.matchAll(PLACE)) {
       const setting = /^config:(.+)$/.exec(place)?.[1];

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

@@ -99,19 +99,20 @@ export function firstMessage(value) {
   }, attachments(value.attachments));
 }
 
-// Agent tool calls. The calling agent never chooses the child's approval mode: the child follows its parent's
-// (see `delegateMode`), so a manually approved session cannot start an unattended one. `turn` is a ticket checked inside the commit transaction and
+// Agent tool calls. The calling agent may ask for the child's approval mode (as an agent reference gives it) but never one
+// more unattended than its parent's hands on (see `delegateMode`), so a manually approved session cannot start an
+// unattended one. `turn` is a ticket checked inside the commit transaction and
 // is not part of request equality: a replay may arrive after the turn has ended.
 export function childSpawn(value) {
   object(value, 'spawn');
-  keys(value, ['turn', 'requestId', 'agent', 'prompt', 'title', 'model', 'effort', 'checkout', 'project']);
+  keys(value, ['turn', 'requestId', 'agent', 'prompt', 'title', 'model', 'effort', 'mode', 'options', 'checkout', 'project']);
   check([undefined, 'shared', 'worktree'].includes(value.checkout), 'invalid_input', 'checkout 必须是 shared 或 worktree');
   check(typeof value.agent === 'string' && AGENT_ID.test(value.agent), 'invalid_input', 'agent 须为 Agent 的 ID（agents 工具列出的）');
   const prompt = text(value.prompt, 'prompt', 100_000);
   return { turn: text(value.turn, 'turn', 100), requestId: text(value.requestId, 'requestId', 100), agent: value.agent, prompt,
     title: text(value.title ?? prompt.trim().slice(0, 80), 'title'), checkout: value.checkout ?? 'shared',
     ...(value.project === undefined ? {} : { project: text(value.project, 'project', 200) }),
-    settings: settings(Object.fromEntries(['model', 'effort'].filter(k => value[k] !== undefined).map(k => [k, value[k]]))) };
+    settings: settings(Object.fromEntries(['model', 'effort', 'mode', 'options'].filter(k => value[k] !== undefined).map(k => [k, value[k]]))) };
 }
 
 

package/check/coda/contract.json

@@ -1,5 +1,5 @@
 {
-  "commit": "2c629f95c2691fa0f98a1f20e72d3ce5037e75e2",
+  "commit": "93e1f9059276267bbf0aa4cd2979a98e199b6547",
   "packages": {
     "@0dep/piso": "5.2.0",
     "@agentclientprotocol/sdk": "1.4.0",
@@ -7,12 +7,13 @@
   },
   "files": {
     "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": "ec7e0dc818dadc973480f34c911c148b3ee30df99aa566d0f7202bbe3c9bf844",
+    "check/coda/components/plugins/plugin-rules.mjs": "78d9431c1b4f6354457f153bb74a0fd085c771eaadd9f7523633915cb700f4f9",
     "check/coda/components/plugins/plugin-source-rules.mjs": "d620ee62fb372e31e5389e27f7202308aab74324b6f5552ffef3844afc7d0001",
     "check/coda/components/plugins/skill-document.mjs": "c5b5e815c42cd836572f7b60e22a46af6ac607fd9df0170fa36f955825636ce6",
     "check/coda/components/prompt-recovery/prompt-recovery.mjs": "f43f21d24c19a58113d3304f9248225b12080ab00ed15eab74bf7b94642732de",
-    "check/coda/components/session-config/commands.mjs": "d980a585dbe13f10c49b3b2a7869ac65933feadfc82d7f86dd6decebbf1b6afa",
+    "check/coda/components/session-config/commands.mjs": "96247da877e455f835e0ee41622e531936e2600e911c2e9a4638fda00e987ec3",
     "check/coda/components/workflows/executor-labels.mjs": "dceca6ae60c0a4f3c3cc72a6c84f1489831790774c93caab96e4ddb493bc89e1",
     "check/coda/domain/agent-protocol.mjs": "7337cf0af97a9592bbcad98a0e4f3837d8bb4d48b53c22846a8c56a0c88a4630",
     "check/coda/domain/duration.mjs": "15dd64ef9b02342ad521c66e5968a569432a89dc7568d11afd3e6f3fe37e104b",
@@ -23,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": "2b19c654aec9652470cacdaf1b4a9f128d1e34aa76974e8643e29c462fdfb8cf",
+    "check/coda/builtin.json": "0e04c5a9bb82db5573d865791df6fe9e52295be470b1bcdf0add719d2d2c0b85",
     "docs/agent-protocol.md": "2a40fac029e93bc512d0405105c9d74fa3e5a59e92788b6951dba182775875c1"
   }
 }

package/package.json

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