@coda-console/plugin-check 0.7.5 → 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 +5 -3
- package/check/coda/application/contributions.mjs +9 -0
- package/check/coda/builtin.json +192 -192
- 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
|
@@ -22,6 +22,7 @@ plugins/magpie/ Magpie:把本机的 Magpie 网关作为模型服务
|
|
|
22
22
|
plugins/network-log/ 网络记录:默认关闭,按需开启建连等待与定时探测采集;关闭后仍可查看历史
|
|
23
23
|
plugins/review/ PR 生命流程:会话开的 PR 先跑项目的检查、再交叉评审,你批准后合并、部署与发布;也是写 PR 流程的样例
|
|
24
24
|
plugins/testbed/ 测试机:长插在 Mac 上的 iPhone、iPad 只经 use-testbed 使用,排到后装 App、交给会话操作、用完切黑屏;依赖宿主资源
|
|
25
|
+
plugins/wechat/ 微信:把手机上的微信群提供为 coda/session@1 外部会话(只读),经手机桥读数据,装在安卓手机节点上
|
|
25
26
|
plugins/composer/ 输入框模式与开发流程:Ultra 用 develop 委派代码修改,主 Agent 审查,设备验收后检查、批准、合并与部署;名单引用 composer.templates
|
|
26
27
|
templates/agent/ 最小的 Agent 插件:手写 ACP 的回声 Agent,演示会话指令、插话、Agent 活动与自主轮次
|
|
27
28
|
templates/resource/ 最小的资源插件:一个资源、两个读数、一个按钮
|
|
@@ -449,8 +450,9 @@ gh workflow run publish.yml --repo coda-console/coda-plugins --ref main
|
|
|
449
450
|
## 契约检查
|
|
450
451
|
|
|
451
452
|
扮演 Coda 去读一个插件目录:清单对 Coda 的类型 schema 校验,流程按 Coda 的流程方言读,Agent 照 Coda 的样子启动、说 Coda 说的话,资源类型(或旧的面板)由 Coda 的资源插件模块读一次。
|
|
452
|
-
|
|
453
|
-
|
|
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、怎样判。
|
|
454
456
|
只在装到一台机器上才知道的(仓库里扫不扫得到、npm 锁文件、和那台已装插件冲突)是那台 Coda 安装时说的,不是插件类型的问题,检查不跑。
|
|
455
457
|
|
|
456
458
|
```sh
|
|
@@ -463,7 +465,7 @@ npx github:coda-console/coda-plugins#<提交> <插件目录>
|
|
|
463
465
|
|
|
464
466
|
| 级 | 要不要登录 | 查什么 |
|
|
465
467
|
| --- | --- | --- |
|
|
466
|
-
| 清单(总是) | 不要 | `package.json`
|
|
468
|
+
| 清单(总是) | 不要 | `package.json` 的通用键对协议 schema 校验(`manifestProblem`),再照 Coda 读成插件(`readPlugin`:登记的贡献点各按自己的 schema 查、读,ID、设置名在 ID 之下);其余写给别的插件扩展点的键,要有 Coda 自带的或旁边依赖的插件声明这个类型。资源类型与旧的面板按资源插件给扩展点 `resources`、`panels` 带的 schema 查。`.coda/workflows/` 里的每个流程(含能力)按协议的流程方言读(`workflowProblem`):不是 BPMN、认不出的 `coda:` 属性或元素、没有的动作或动作不接受的参数都算失败。另有只提醒的:分类、版本、图标页面太小、旧的 Agent ID `claude` |
|
|
467
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 秒),输出合格式 |
|
|
468
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` |
|
|
469
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';
|