@coda-console/plugin-check 0.7.6 → 0.8.0
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 +4 -3
- package/check/coda/application/contributions.mjs +9 -0
- package/check/coda/builtin.json +191 -191
- package/check/coda/components/composers/contributions.mjs +31 -0
- package/check/coda/components/plugins/contribution-points.mjs +25 -0
- package/check/coda/components/plugins/git-contributions.mjs +15 -0
- package/check/coda/components/plugins/model-contributions.mjs +9 -0
- package/check/coda/components/plugins/plugin-icons.mjs +15 -0
- package/check/coda/components/plugins/plugin-rules.mjs +25 -60
- package/check/coda/components/plugins/plugin-source-rules.mjs +23 -29
- package/check/coda/components/protocols/types.mjs +1 -7
- package/check/coda/components/session-config/contributions.mjs +55 -0
- package/check/coda/components/workflows/contributions.mjs +17 -0
- package/check/coda/contract.json +14 -8
- package/check/manifest.mjs +3 -1
- package/package.json +2 -2
- package/check/coda/components/plugins/agent-plugins.mjs +0 -45
- package/check/coda/domain/resource-kinds.mjs +0 -4
package/README.md
CHANGED
|
@@ -450,8 +450,9 @@ gh workflow run publish.yml --repo coda-console/coda-plugins --ref main
|
|
|
450
450
|
## 契约检查
|
|
451
451
|
|
|
452
452
|
扮演 Coda 去读一个插件目录:清单对 Coda 的类型 schema 校验,流程按 Coda 的流程方言读,Agent 照 Coda 的样子启动、说 Coda 说的话,资源类型(或旧的面板)由 Coda 的资源插件模块读一次。
|
|
453
|
-
|
|
454
|
-
|
|
453
|
+
插件写的合乎它用到的类型就对:清单的通用键只在协议包 `@coda-console/protocol`([coda-console/coda-protocol](https://github.com/coda-console/coda-protocol))的 schema 里,
|
|
454
|
+
`agents`、`skills`、`mcpServers` 等业务键由 Coda 里读它的一方登记成贡献点(schema 与读法,`check/coda/application/contributions.mjs` 先于读清单加载),都由 Coda 自己用的同一个校验器判,
|
|
455
|
+
检查包不另写规则。`check/coda/` 是 Coda 文件的原样副本(见[契约副本](#契约副本)),检查包手写的只有怎样扮演 Coda、怎样判。
|
|
455
456
|
只在装到一台机器上才知道的(仓库里扫不扫得到、npm 锁文件、和那台已装插件冲突)是那台 Coda 安装时说的,不是插件类型的问题,检查不跑。
|
|
456
457
|
|
|
457
458
|
```sh
|
|
@@ -464,7 +465,7 @@ npx github:coda-console/coda-plugins#<提交> <插件目录>
|
|
|
464
465
|
|
|
465
466
|
| 级 | 要不要登录 | 查什么 |
|
|
466
467
|
| --- | --- | --- |
|
|
467
|
-
| 清单(总是) | 不要 | `package.json`
|
|
468
|
+
| 清单(总是) | 不要 | `package.json` 的通用键对协议 schema 校验(`manifestProblem`),再照 Coda 读成插件(`readPlugin`:登记的贡献点各按自己的 schema 查、读,ID、设置名在 ID 之下);其余写给别的插件扩展点的键,要有 Coda 自带的或旁边依赖的插件声明这个类型。资源类型与旧的面板按资源插件给扩展点 `resources`、`panels` 带的 schema 查。`.coda/workflows/` 里的每个流程(含能力)按协议的流程方言读(`workflowProblem`):不是 BPMN、认不出的 `coda:` 属性或元素、没有的动作或动作不接受的参数都算失败。另有只提醒的:分类、版本、图标页面太小、旧的 Agent ID `claude` |
|
|
468
469
|
| 握手(默认) | 不要 | `sh -c` 启动 `command`(环境是 Coda 的 `pluginEnv` 给的:`CODA_NODE`、`CODA_PLUGIN_PATH`、临时的 `CODA_PLUGIN_STATE`、设置默认值的 `CODA_PLUGIN_SETTINGS`;依赖的插件在旁边(同一个父目录里同名的目录)时 `CODA_PLUGIN_DEPENDENCIES` 给它的目录,Coda 自带的不在这里、不给),发与 Coda 相同的 `initialize`,要求 `protocolVersion` 为 1;能力声明的 `_meta.coda` 与顶层插话声明交协议 schema 校验;声明会话指令(`sessionCapabilities.systemPrompt`,没声明算失败);`session/new` 带会话指令,给出会话与当前模型,配置选项的 `_meta.coda.default` 交协议校验;错误里声明的执行失败也查协议 schema,回 -32000 记为未登录、跳过后面的检查(不算失败);像 Coda 一样对进程组发 SIGTERM,5 秒内要退出(超过 0.8 秒提醒);另起一个进程,关掉标准输入后 5 秒内不退出只提醒。资源类型(或旧的面板)由 Coda 资源插件的 `Panels` 读一次(30 秒),输出合格式 |
|
|
469
470
|
| 一轮(`--live`) | 要 | 第一轮问会话指令里的检查词(一个随机词),回复里要有它;再发一轮提示词(默认「只回复 ok」)收到 `stopReason`;每条 `session/update` 先过 ACP SDK 的 schema,工具审核、用量与默认选项标记再过协议 schema;`_coda/wait` 用协议的 `agentMessageProblem` 校验形状,另查会话归属、登记与终态(子 Agent 不带 `childSessionId`、定时不带 `at` 只提醒);扩展形状问题按现有规则报告协议返回的「位置:说明」;远端绑定码请求先查协议参数再查本会话归属;执行失败的形状交协议校验,重试预算照 Coda 策略;审批与提问一律回拒绝,在一轮之外发来的算失败;再发一轮并 `session/cancel`,30 秒内要结束,读到取消后还在做事或拖过 5 秒才答复却不回 `cancelled` 算失败(见下);有自主轮次的也取消一次;声明插话的,答复用协议的 `agentResultProblem` 校验,一轮结束后插话要回 `promptRequired` 且不自己另开一轮,一轮进行中插话要回 `injected` 或 `promptRequired`(`injected` 的那一轮照常回 `stopReason`);声明 `loadSession` 的,新开进程 `session/load`(同样带会话指令)要成功,随后在新进程里再跑一轮也要收到 `stopReason` |
|
|
470
471
|
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
// The components' contribution points (components/plugins/contribution-points.mjs), defined as this module loads: what
|
|
2
|
+
// puts Coda together (application/service.mjs, the tests, the plugin contract) imports it once, before any plugin is read.
|
|
3
|
+
// In this order what only one plugin may declare is said (plugin-source-rules.mjs claims): sessions', workflows', Git's,
|
|
4
|
+
// the composer's.
|
|
5
|
+
import '../components/session-config/contributions.mjs';
|
|
6
|
+
import '../components/workflows/contributions.mjs';
|
|
7
|
+
import '../components/plugins/model-contributions.mjs';
|
|
8
|
+
import '../components/plugins/git-contributions.mjs';
|
|
9
|
+
import '../components/composers/contributions.mjs';
|