@coda-console/plugin-check 0.8.3 → 0.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -21,6 +21,7 @@ plugins/host/ 宿主资源:发布本机 coda/executor@1 执行环
21
21
  plugins/magpie/ Magpie:把本机的 Magpie 网关作为模型服务提供给 Pi 等插件,安装时装好 Magpie 并让网关常驻
22
22
  plugins/network-log/ 网络记录:默认关闭,按需开启建连等待与定时探测采集;关闭后仍可查看历史
23
23
  plugins/review/ PR 生命流程:会话开的 PR 先跑项目的检查、再交叉评审,你批准后合并、部署与发布;也是写 PR 流程的样例
24
+ plugins/desktop-pet/ 桌面宠物:Coda 娘待在 Mac 桌面上,Agent 在跑时打字,有事等你时举卡片叫你(Coda 的浮窗)
24
25
  plugins/testbed/ 测试机:长插在 Mac 上的 iPhone、iPad 只经 use-testbed 使用,排到后装 App、交给会话操作、用完切黑屏;依赖宿主资源
25
26
  plugins/composer/ 输入框模式与开发流程:Ultra 用 develop 委派代码修改,主 Agent 审查,设备验收后检查、批准、合并与部署;名单引用 composer.templates
26
27
  templates/agent/ 最小的 Agent 插件:手写 ACP 的回声 Agent,演示会话指令、插话、Agent 活动与自主轮次
@@ -245,6 +246,48 @@ Codex 调用 `clock.sleep` 时,会话底部显示一个后台等待项(例
245
246
  Codex 没有只取消单个 sleep 的接口,因此等待项不提供单独的停止按钮。正常结束、插话唤醒、整轮取消或失败都会了结等待,
246
247
  子 Agent 的等待归它自己的会话。
247
248
 
249
+ ### Codex 异步消息与提问
250
+
251
+ OpenAI 的模型目录给模型开了 `send_user_message_async` 与 `request_user_input_async`(不随 Codex 版本,本地设置关不掉)。
252
+ Codex 把每次调用报成一条 `delivery: "async"` 的完整 Agent 消息、提问另带 `questions`,不发增量;codex-acp 1.12.0 只从增量显示 Agent 消息,
253
+ 插件打补丁接住它(适配器一变就启动失败)。Codex 的这一轮不等回答,回答之后作为新的用户消息到达它。
254
+
255
+ - **消息**:没有收到过增量的异步消息,把它的文字作为 Agent 消息显示。
256
+ - **提问**:文字照常作为 Agent 消息显示(Codex 把问题与选项写在里面,链接可以点开);这次调用的全部问题再作为一张表单卡片,只用来收回答。
257
+ 字段同 Claude 的提问:第 i 题是必填字段 `q{i}`,标题是问题;有选项时单选,末尾多一项「其他(写在下面)」配可选字段 `q{i}_other`;没有选项时填文字。
258
+ - **这一轮**:卡片都有结果之前,Coda 的这一轮一直在进行,codex-acp 那次 `session/prompt` 的答复先不转给 Coda。
259
+ 回答作为用户消息交给 Codex,每题一行:「回答你的提问「<问题>」:<答案>」;用户取消或卡片被撤回,就说「用户没有回答「<问题>」」。
260
+ codex-acp 那次 prompt 还在跑时经插话(`idleBehavior: "promptRequired"`)加进去;回 `promptRequired` 或已经跑完,入口自己向 codex-acp 发 `session/prompt`,
261
+ 它的输出照常算在 Coda 的这一轮里,最后一次答复才结束这一轮。
262
+ - **等卡片时**:停止会话撤回没答的卡片(`$/cancel_request`),把取消转给 codex-acp,这一轮按取消结束;
263
+ Codex 已停下时收到的插话作为下一次 `session/prompt` 跑、回 `injected`,仍算这一轮,卡片保留。
264
+
265
+ ### Codex 没适配的东西
266
+
267
+ Codex 或 OpenAI 的服务端加了新东西(新的 item 类型、字段取值、通知,模型能用的新工具),入口不认识就会悄悄丢掉,谁也不知道。
268
+ codex 入口分三层,让这类情况在升级时或运行时被发现,经 `_coda/unrecognized`(协议[没适配的东西](https://github.com/coda-console/coda-protocol/blob/main/docs/agent-protocol.md#没适配的东西))报给 Coda:
269
+
270
+ - **登记表与升级检查**:`agent/registry.json` 对锁定的 `@openai/codex` 的 app-server 协议,列出每种 ThreadItem 类型、agentMessage 的每个字段与
271
+ `delivery`、`phase` 的每个取值、codex-acp 收到的每个服务端通知与服务端请求,各注明转给 Coda(`shown: true`)还是明确不显示,附一句原因。
272
+ `scripts/check-codex-protocol.mjs` 用插件锁定的 Codex 跑 `codex app-server generate-json-schema --experimental`,有没登记的就失败并列出来。
273
+ `npm test` 跑它(`test/plugins/codex/protocol.test.mjs`),所以升级 `@openai/codex` 的 PR 要先登记新东西。
274
+ 它要这个平台的 Codex 二进制:`@openai/codex` 的可选依赖,`install-plugins.mjs` 带 `--include=optional` 装上(CI 的 ubuntu x64 是 `@openai/codex-linux-x64`);
275
+ 没装上就失败,并说明怎么装,不跳过。
276
+ - **运行时报告**:codex-acp 的补丁(适配器一变就启动失败)把到了却没登记的报上来。Coda 在握手里声明了 `_meta.coda.unrecognized` 才发,同一会话同一 `name` 只报一次。
277
+ - 没登记的 item 类型,完成时报 `item:<类型>`:有 `text`、`message` 或 `summary` 文字的照样作为 Agent 消息显示,报 `lost: false`;显示不了的报 `lost: true`。
278
+ - agentMessage 完成时有文字、没收到过增量,又不是已接住的 async:照样显示,报 `item:agentMessage.unstreamed`(`lost: false`)。这是「文字没送到 Coda」的通用兜底。
279
+ - agentMessage 没登记的字段(有值时)与 `delivery`、`phase` 的取值,报 `lost: false`,文字照常显示。
280
+ - 没登记的通知报 `notification:<方法>`(`lost: false`);没登记的服务端请求报 `request:<方法>`(`lost: true`),照 codex-acp 原来的做法回 MethodNotFound。
281
+ - **工具清单对照**:codex-acp 开的线程(`thread/start`、`thread/resume`,答复里有 rollout 的 `path`)一轮结束后,读 rollout 里给模型的 `additional_tools`,
282
+ 按 `namespace.name`(托管的工具没有名字,按类型,如 `web_search`)对照 `agent/known-tools.json`,新出现的报 `tool:<namespace.name>`(`kind: tool`)。
283
+ MCP 工具(`mcp__<服务器>`)是用户配的,不比。每个线程读到工具为止,读文件不挡开会话,也不挡这一轮。
284
+
285
+ 升级 `@openai/codex` 时:
286
+
287
+ 1. 跑 `node scripts/check-codex-protocol.mjs`(`npm test` 也跑),把列出的新东西登记进 `agent/registry.json`;要转给 Coda 的,先在入口补上。
288
+ 2. 用新 Codex 跑一轮真实会话,看它的 rollout(`~/.codex/sessions/…`)里 `additional_tools` 的原生工具,把新的加进 `agent/known-tools.json`;入口专门接住的标「已适配」。
289
+ 3. codex-acp 跟着变了,补丁对不上会启动失败,照新代码改补丁。
290
+
248
291
  ### Codex 权限默认值与 Coda 工具
249
292
 
250
293
  从 codex 插件 1.9.0 起,未指定模式的会话默认「完全访问」(`agent-full-access`):Codex 原生轮次使用
@@ -342,6 +385,9 @@ Codex 会话、资源与登录用的 Codex CLI 就是 `codex` 插件依赖的 `@
342
385
  Dependabot(`.github/dependabot.yml`)每周为它们各开一个 PR,连同 `package-lock.json` 一起改;合并后在 Coda「设置 › 插件」
343
386
  对该插件点「检查更新」;合并时勾选「部署」,`sync-coda` 给 Coda 开升级依赖的 PR。升 `@openai/codex` 时 codex-acp 经 `overrides` 跟着用新版本,
344
387
  Coda 根上的同一条 overrides 由 `sync-coda` 一起改(npm 只认根的,Coda 的测试会核对);合并前用真实会话跑一轮。
388
+ 升 `@openai/codex` 还要登记新 Codex 带来的东西,见 [Codex 没适配的东西](#codex-没适配的东西)。
389
+ 升 `@anthropic-ai/claude-agent-sdk` 要先把新 SDK 的消息类型与内容块登记进 `plugins/claude/agent/registry.mjs`,`npm test` 里的升级检查会列出没登记的,
390
+ 见 [plugins/claude/README.md](plugins/claude/README.md)「认不出的东西」。
345
391
 
346
392
  ## 在 Coda 里安装
347
393
 
@@ -15,6 +15,8 @@ export function providerAPI({ call, watch, connection, plugin, operations, repor
15
15
  setStatus: (kind, id, status, revision) => call('setStatus', [kind, id, status, revision]),
16
16
  delete: (kind, id) => call('delete', [kind, id]),
17
17
  publish: (kind, id, enabled = true) => call('publish', [kind, id, enabled]),
18
+ // An upload of this machine a post to a session names (`upload`): `{ id, name, size, mime?, duration?, …, path }`.
19
+ upload: id => call('upload', [id]),
18
20
  observe,
19
21
  handle(kind, operation, handler) {
20
22
  if (typeof kind !== 'string' || !kind || typeof operation !== 'string' || !operation || typeof handler !== 'function')
@@ -991,7 +991,7 @@
991
991
  "id": "claude",
992
992
  "displayName": "Claude",
993
993
  "description": "用 Claude Agent SDK 跑会话",
994
- "version": "1.10.0",
994
+ "version": "1.11.0",
995
995
  "category": "Agent",
996
996
  "icon": {
997
997
  "light": "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",
@@ -1002,8 +1002,8 @@
1002
1002
  "kind": "builtin",
1003
1003
  "package": "@coda-console/claude",
1004
1004
  "tag": "latest",
1005
- "version": "1.10.0",
1006
- "integrity": "sha512-iG7lXu3xtzuvuMKDZiIBEzvidrMn8mPmi+WFLrJl9iY1XoLyJYyPuZa4rY3f+HNB6L0jAz2P4NsgzEtJxEry6g==",
1005
+ "version": "1.11.0",
1006
+ "integrity": "sha512-/xVoMX+X7IWim490qMjLPH4TK9Ck686kYbAYWEHcm0c30bBfiIawffTwJRCkdIOTXt3bbb1hyk6BbgAkhQy2Qw==",
1007
1007
  "repo": "https://github.com/coda-console/coda-plugins.git",
1008
1008
  "path": "plugins/claude"
1009
1009
  },
@@ -1087,7 +1087,7 @@
1087
1087
  "id": "codex",
1088
1088
  "displayName": "Codex",
1089
1089
  "description": "用 OpenAI Codex 跑会话",
1090
- "version": "1.11.0",
1090
+ "version": "1.12.0",
1091
1091
  "category": "Agent",
1092
1092
  "icon": {
1093
1093
  "light": "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",
@@ -1098,8 +1098,8 @@
1098
1098
  "kind": "builtin",
1099
1099
  "package": "@coda-console/codex",
1100
1100
  "tag": "latest",
1101
- "version": "1.11.0",
1102
- "integrity": "sha512-/Vri1yv+QOGIHZ/PIvL1A8Ai9hYcT4LbJOvZ9AcLJIACJ4tK5Mq8WBIkAPYvZgxY37rnH1EqwNAChGFlsPl75A==",
1101
+ "version": "1.12.0",
1102
+ "integrity": "sha512-6bNcN5xsKWL5AnPWCW6ciTIGjbMy81cvywKCAUtSAVfaF7w/F4m9t3/2/EQk+6fnKkuRYb24DRe7HRgKjzPzLA==",
1103
1103
  "repo": "https://github.com/coda-console/coda-plugins.git",
1104
1104
  "path": "plugins/codex"
1105
1105
  },
@@ -1842,7 +1842,7 @@
1842
1842
  "id": "review",
1843
1843
  "displayName": "PR 生命流程",
1844
1844
  "description": "PR 从检查、评审到批准合并;简易开发",
1845
- "version": "2.12.0",
1845
+ "version": "2.13.0",
1846
1846
  "category": "工作流程",
1847
1847
  "icon": {
1848
1848
  "symbol": "checkmark.bubble.fill",
@@ -1853,14 +1853,21 @@
1853
1853
  "kind": "builtin",
1854
1854
  "package": "@coda-console/review",
1855
1855
  "tag": "latest",
1856
- "version": "2.12.0",
1857
- "integrity": "sha512-WjP7W8vQqfdF/l4jMgHqUz5VITx0JpyHY1oK0a1wEdbKHfIM+LuyY0LITR7k80mmc17QxXUOdRn8eq7vuSqNow==",
1856
+ "version": "2.13.0",
1857
+ "integrity": "sha512-JC74T/YZdp32tFX/VTKtOFx1+fGdL5XsjLQz8t08nxoMeDTG6RroMat4waRtrmh5kUrgIUSfKqyt0xXOegIdlw==",
1858
1858
  "repo": "https://github.com/coda-console/coda-plugins.git",
1859
1859
  "path": "plugins/review"
1860
1860
  },
1861
1861
  "dir": "node_modules/@coda-console/review",
1862
1862
  "title": "PR 生命流程",
1863
1863
  "properties": {
1864
+ "review.autoRun": {
1865
+ "type": "boolean",
1866
+ "description": "会话开的 PR 新建或有新提交时自动开始 PR 生命流程。关掉后只能手动发起;会话或目录在「工作流」里单独设过的,按它们的。不影响简易开发。",
1867
+ "title": "PR 自动运行",
1868
+ "order": 0,
1869
+ "default": true
1870
+ },
1864
1871
  "review.reviewers": {
1865
1872
  "type": "object",
1866
1873
  "description": "一行是一类作者和评审它的 Agent。作者只选到哪一级,就只按那一级区分;越具体的一行越优先。",
@@ -1,5 +1,5 @@
1
1
  import { requireCondition as check } from '../../domain/errors.mjs';
2
- import { AGENT_ID, keys, object, text } from '../../domain/values.mjs';
2
+ import { AGENT_ID, attachments, keys, object, text } from '../../domain/values.mjs';
3
3
 
4
4
  // What a session runs with: its model, effort and mode, and the agent's other config options by their ID (`options`: a
5
5
  // choice's ID, or on and off for a switch), as the agent's catalog offers them (coda-protocol docs/agent-protocol.md「ACP 部分」).
@@ -25,12 +25,8 @@ export function settings(value = {}) {
25
25
  ...(options ? { options } : {}) };
26
26
  }
27
27
 
28
- // Upload IDs as the client names them are the request's identity. What is on disk is read once, when the
29
- // message is first accepted: an agent may since have changed or removed the file, and a replay must still match.
30
- export function attachments(value = []) {
31
- check(Array.isArray(value) && value.length <= 20 && new Set(value).size === value.length, 'invalid_input', '附件列表无效');
32
- return value.map(id => text(id, '附件标识', 100));
33
- }
28
+ // Upload IDs as the client names them (domain/values.mjs), as a message and a card's answer take them.
29
+ export { attachments };
34
30
  // A message without files keeps the request identity it always had.
35
31
  export const withAttachments = (value, ids) => ids.length ? { ...value, attachments: ids } : value;
36
32
  // Passages the user picked from the conversation, kept apart from their own words. Together they stay
@@ -1,9 +1,9 @@
1
1
  {
2
- "commit": "7c868b9eb75cc10ce781dd560ed1c85607741300",
2
+ "commit": "47735aefcb41a796ca438fa9a4a4321827c9e3bf",
3
3
  "packages": {
4
4
  "@0dep/piso": "5.2.0",
5
5
  "@agentclientprotocol/sdk": "1.4.0",
6
- "@coda-console/protocol": "git+https://github.com/coda-console/coda-protocol.git#3dc8cbccb73d6ba854f79d18ab9400cb69039c24",
6
+ "@coda-console/protocol": "5.4.0",
7
7
  "ajv": "8.20.0",
8
8
  "yaml": "2.9.1"
9
9
  },
@@ -11,7 +11,7 @@
11
11
  "check/coda/application/contributions.mjs": "7460dc676171e24802b165a72e83ec72c4115f5ed169abcad08963bd2d9d251f",
12
12
  "check/coda/components/protocols/creation.mjs": "2b4a400d3064af4b5106077dc783c567910fef3c47b2d52af3f0d838c5accf19",
13
13
  "check/coda/components/protocols/types.mjs": "6876689142866bd45fc085951f6ea9e1fc303334e3657e97cc9cf5e277311248",
14
- "check/coda/adapters/provider-api.mjs": "a584316c3e0dafa19667f4288c54b8f894b49de72d9f62098d592b9084dec482",
14
+ "check/coda/adapters/provider-api.mjs": "2b0802b52ae4d894e92f1fa7647cf727556f4008ad5e63c14e6400dc24bb3a6e",
15
15
  "check/coda/adapters/admission-api.mjs": "461b5a8a1ad73d7afed5db308813d02324e29c643b8e773ad127d4bdb00fb524",
16
16
  "check/coda/components/composers/contributions.mjs": "43d3e15fb1f63b7b5c20716030d9537613809ed5cc2fb466a3678bfa308f9f92",
17
17
  "check/coda/components/composers/schemas.mjs": "6d497f58147756e789f9a566b2366f2fe36c0c72310421fb02508bf24a04f2c0",
@@ -24,21 +24,21 @@
24
24
  "check/coda/components/plugins/plugin-source-rules.mjs": "375bd284d4c29278d9ad0a476b743a378cca40be550fc68c6e86a78ffcd60a39",
25
25
  "check/coda/components/plugins/skill-document.mjs": "153ad3c096c7c9b7774bcf7dcc0ba603c962ee1ac8697c8a71e3f2c9ba9c92e6",
26
26
  "check/coda/components/prompt-recovery/prompt-recovery.mjs": "f43f21d24c19a58113d3304f9248225b12080ab00ed15eab74bf7b94642732de",
27
- "check/coda/components/session-config/commands.mjs": "b8505802e25590435bf48d741522d85c8b185e8f2ae190d49e53eebd35a1d453",
27
+ "check/coda/components/session-config/commands.mjs": "7ce6b7872b3bf4dbc73b2af9a53cca4b5356ad32656903218757f449bb5abed4",
28
28
  "check/coda/components/session-config/contributions.mjs": "830be1bf9e158d0090f16ed4be0ead4e33c7392531312299a3a637db8f470aa8",
29
29
  "check/coda/components/workflows/contributions.mjs": "824c9b29584821b5e75bad00f02f21adc5031369db4ee9a4a5a836dfd44f98f5",
30
30
  "check/coda/components/workflows/executor-labels.mjs": "dceca6ae60c0a4f3c3cc72a6c84f1489831790774c93caab96e4ddb493bc89e1",
31
- "check/coda/domain/agent-protocol.mjs": "769cc10dc21b3cef7718f94272aaef2d17d4882d42617b408cb47357abfc3bcb",
31
+ "check/coda/domain/agent-protocol.mjs": "df1424f562d6c3d83c703262f5ce50afe7b18aa6e29c4226cbe5e7148bff818a",
32
32
  "check/coda/domain/duration.mjs": "d6d7235c6166e8fcf4155999b1e9a514cf2ef91da179d4c0e48162cff4b692f5",
33
33
  "check/coda/domain/errors.mjs": "8319c6759c5b16b692f5e0a6208d066e43882c571da1075bff8698761020daef",
34
34
  "check/coda/domain/resource-admission.mjs": "775b1d7067f9d8487a3504d737f3f4bea31adf77af3357ed42e313805e5188e7",
35
35
  "check/coda/domain/plugin-services.mjs": "940a72a14da980188a32c790c7f341d3ec0062a6e87ef1ebc9ef051798ea0a75",
36
- "check/coda/domain/values.mjs": "01cc72b8d9c09e3fe16c93ec332ca01148bba859b1c672586d9d07444d7816c4",
36
+ "check/coda/domain/values.mjs": "afb8bf30e374bed27fe41ee4b6d8c3c0b4dbe1dcfb6b62dad9d3d53b966706a1",
37
37
  "check/coda/kernel/agent-failures.mjs": "cbc215e2403d86f0acc765c2077197e0b529fc01e213db465c388361238ea8ce",
38
38
  "check/coda/resources/plugins/resources/panels/command.mjs": "606f28bf87f87dded9df2db892bc7624c770d795ffab88f2409998346920ae42",
39
39
  "check/coda/resources/plugins/resources/panels/panels.mjs": "4862dccd91c29db76caf1033ffeab743c7943befaca7406a56467c470b90a1b8",
40
40
  "check/coda/resources/plugins/resources/panels/rules.mjs": "d5b12f3e0e5040224314e5d2de2bd49f5b1ed24ea205590ff99a54e8b4e96d7f",
41
41
  "check/coda/resources/plugins/resources/panels/sign-in.mjs": "1271a24e33b1b882a1fb9bee03b8e240db8b9bee1b5208f0e1c84499cfb1be7e",
42
- "check/coda/builtin.json": "a92e59edb50e444394daef8160ed9bc9d593fccc57d09df7b4ec4f9997850624"
42
+ "check/coda/builtin.json": "b52c28a1cf24885472473ecb7104bab47e8657d5ee313287db36276df95ae0db"
43
43
  }
44
44
  }
@@ -9,8 +9,9 @@ export const clientCapabilities = () => ({
9
9
  elicitation: { form: {}, url: {} },
10
10
  // A config option may be a switch: shown as one, its value on or off (`options`).
11
11
  session: { compaction: {}, configOptions: { boolean: {} } },
12
- // Coda takes the agent's own waits, and relays what is asked of the session from outside to an agent that takes it.
13
- _meta: { coda: { waits: {}, remote: {} } },
12
+ // Coda takes the agent's own waits and what its entry could not adapt, and relays what is asked of the session from
13
+ // outside to an agent that takes it.
14
+ _meta: { coda: { waits: {}, remote: {}, unrecognized: {} } },
14
15
  });
15
16
  // The remote entry (「远端入口」): an agent whose work is done elsewhere (a bot on its own computer) declares it; the code to
16
17
  // bind that place to its session is asked of Coda (`REMOTE_CODE`), and what that place then asks of the session is handed
@@ -37,6 +38,8 @@ export const currentModel = session => session?.configOptions?.find?.(x => x?.ca
37
38
  // What an agent may say of a wait of its own (「_coda/wait」); anything else is dropped unread.
38
39
  export const WAIT_STATES = new Set(AGENT_SCHEMAS['wait.json'].properties.state.enum);
39
40
  export const validWait = p => agentMessageProblem('_coda/wait', p) === null;
41
+ // What an agent's entry got and could not adapt (「没适配的东西」); anything else is dropped unread.
42
+ export const validUnrecognized = p => agentMessageProblem('_coda/unrecognized', p) === null;
40
43
  // What the agent's own check of a tool call said before running it (「工具调用的审核」): `_meta.coda.review` of the call's
41
44
  // `tool_call` or `tool_call_update`, as Coda keeps it; null for anything else. A risk it does not know is left out.
42
45
  export const toolReview = r => agentValueProblem('review.json', r) === null
@@ -1,4 +1,5 @@
1
1
  // Shapes every layer checks what it is given against, and the stable serialization requests are compared by.
2
+ import { createHash } from 'node:crypto';
2
3
  import { isAbsolute, normalize } from 'node:path';
3
4
  import { requireCondition as check } from './errors.mjs';
4
5
 
@@ -16,6 +17,13 @@ export function text(value, name, max = 200) {
16
17
  return value;
17
18
  }
18
19
 
20
+ // Upload IDs as the client names them are the request's identity. What is on disk is read once, when the
21
+ // message is first accepted: an agent may since have changed or removed the file, and a replay must still match.
22
+ export function attachments(value = []) {
23
+ check(Array.isArray(value) && value.length <= 20 && new Set(value).size === value.length, 'invalid_input', '附件列表无效');
24
+ return value.map(id => text(id, '附件标识', 100));
25
+ }
26
+
19
27
  export function keys(value, allowed) {
20
28
  check(Object.keys(value).every(key => allowed.includes(key)), 'invalid_input', '包含不支持的字段');
21
29
  }
@@ -31,6 +39,13 @@ export function canonical(value) {
31
39
  return encoded;
32
40
  }
33
41
 
42
+ // A UUID derived from the parts that name a call: the same parts make the same one, so a retry finds its call and the
43
+ // session it opened, and two callers naming the same request are two calls.
44
+ export function derivedUUID(...parts) {
45
+ const hex = createHash('sha256').update(canonical(parts)).digest('hex');
46
+ return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-4${hex.slice(13, 16)}-a${hex.slice(17, 20)}-${hex.slice(20, 32)}`;
47
+ }
48
+
34
49
  // A path the user gave, as an absolute one.
35
50
  export function absolutePath(value) {
36
51
  text(value, '路径', 4096);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@coda-console/plugin-check",
3
- "version": "0.8.3",
3
+ "version": "0.8.4",
4
4
  "description": "Coda 插件的契约检查:扮演 Coda 读清单、启动 Agent 讲 ACP 与 _coda/wait、读资源类型(与旧的面板)。",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -24,7 +24,7 @@
24
24
  "dependencies": {
25
25
  "@0dep/piso": "5.2.0",
26
26
  "@agentclientprotocol/sdk": "1.4.0",
27
- "@coda-console/protocol": "git+https://github.com/coda-console/coda-protocol.git#3dc8cbccb73d6ba854f79d18ab9400cb69039c24",
27
+ "@coda-console/protocol": "5.4.0",
28
28
  "ajv": "8.20.0",
29
29
  "yaml": "2.9.1"
30
30
  },
@@ -32,6 +32,7 @@
32
32
  "access": "public"
33
33
  },
34
34
  "devDependencies": {
35
- "feelin": "8.2.0"
35
+ "feelin": "8.2.0",
36
+ "typescript": "6.0.3"
36
37
  }
37
38
  }