@coda-console/plugin-check 0.5.10 → 0.5.12

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.
Files changed (39) hide show
  1. package/README.md +6 -6
  2. package/bin/check.mjs +2 -2
  3. package/check/coda/components/plugins/agent-plugins.mjs +19 -70
  4. package/check/coda/components/plugins/plugin-extensions.mjs +1 -70
  5. package/check/coda/components/plugins/plugin-rules.mjs +120 -513
  6. package/check/coda/components/plugins/plugin-schema.mjs +177 -0
  7. package/check/coda/components/plugins/plugin-source-rules.mjs +3 -1
  8. package/check/coda/components/plugins/schemas/agents.json +50 -0
  9. package/check/coda/components/plugins/schemas/capabilities.json +16 -0
  10. package/check/coda/components/plugins/schemas/commands.json +21 -0
  11. package/check/coda/components/plugins/schemas/common.json +25 -0
  12. package/check/coda/components/plugins/schemas/composer-modes.json +79 -0
  13. package/check/coda/components/plugins/schemas/configuration.json +23 -0
  14. package/check/coda/components/plugins/schemas/endpoints.json +19 -0
  15. package/check/coda/components/plugins/schemas/environment.json +22 -0
  16. package/check/coda/components/plugins/schemas/events.json +23 -0
  17. package/check/coda/components/plugins/schemas/executors.json +26 -0
  18. package/check/coda/components/plugins/schemas/extension-points.json +57 -0
  19. package/check/coda/components/plugins/schemas/extensions.json +13 -0
  20. package/check/coda/components/plugins/schemas/git-credentials.json +17 -0
  21. package/check/coda/components/plugins/schemas/groups.json +21 -0
  22. package/check/coda/components/plugins/schemas/instructions.json +9 -0
  23. package/check/coda/components/plugins/schemas/mcp-servers.json +29 -0
  24. package/check/coda/components/plugins/schemas/model-providers.json +39 -0
  25. package/check/coda/components/plugins/schemas/path.json +16 -0
  26. package/check/coda/components/plugins/schemas/plugin.json +46 -0
  27. package/check/coda/components/plugins/schemas/repositories.json +7 -0
  28. package/check/coda/components/plugins/schemas/services.json +9 -0
  29. package/check/coda/components/plugins/schemas/setting.json +242 -0
  30. package/check/coda/components/plugins/schemas/setup.json +7 -0
  31. package/check/coda/components/plugins/schemas/skills.json +15 -0
  32. package/check/coda/components/plugins/schemas/views.json +30 -0
  33. package/check/coda/components/session-config/commands.mjs +17 -2
  34. package/check/coda/contract.json +35 -9
  35. package/check/coda/domain/errors.mjs +3 -0
  36. package/check/index.mjs +2 -1
  37. package/check/manifest.mjs +56 -164
  38. package/package.json +2 -1
  39. package/check/coda/components/plugins/model-protocols.mjs +0 -39
@@ -0,0 +1,9 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/instructions.json",
4
+ "title": "contributes.instructions:写给 Agent 的几句话",
5
+ "description": "装了这个插件的项目里,每个会话的指令都带上它:不超过 200 字。",
6
+ "type": "string",
7
+ "maxLength": 200,
8
+ "pattern": "\\S"
9
+ }
@@ -0,0 +1,29 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/mcp-servers.json",
4
+ "title": "contributes.mcpServers:给 Agent 的 MCP 服务器",
5
+ "description": "服务器名 → { command, args, env },照 Claude Code 的 .mcp.json:Agent 在本机启动、经标准输入输出说话的程序(stdio),不经 shell。command 与 args 里可以写 ${CODA_PLUGIN_PATH}、${CODA_PLUGIN_STATE}、${CODA_NODE};设置经 env 交给它(写法同 contributes.environment)。",
6
+ "type": "object",
7
+ "maxProperties": 20,
8
+ "propertyNames": {"description": "服务器名只用小写字母、数字和「-」,以字母开头,至多 40 个字符,不能是 Coda 自己的 coda", "$ref": "common.json#/$defs/id", "not": {"const": "coda"}},
9
+ "additionalProperties": {
10
+ "type": "object",
11
+ "properties": {
12
+ "type": {"description": "现在只支持由 Agent 在本机启动的服务器(stdio)", "const": "stdio"},
13
+ "command": {"$ref": "#/$defs/word"},
14
+ "args": {"description": "不超过 100 项", "type": "array", "maxItems": 100, "items": {"$ref": "#/$defs/word"}},
15
+ "env": {"$ref": "environment.json"}
16
+ },
17
+ "required": ["command"],
18
+ "additionalProperties": false
19
+ },
20
+ "$defs": {
21
+ "word": {
22
+ "description": "一行不超过 4096 字的文字;${…} 只能是 CODA_PLUGIN_PATH、CODA_PLUGIN_STATE 或 CODA_NODE,设置经 env 交给它",
23
+ "type": "string",
24
+ "maxLength": 4096,
25
+ "pattern": "^[^\\u0000\\r\\n]+$",
26
+ "x-placeholders": {"names": ["CODA_PLUGIN_PATH", "CODA_PLUGIN_STATE", "CODA_NODE"]}
27
+ }
28
+ }
29
+ }
@@ -0,0 +1,39 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/model-providers.json",
4
+ "title": "contributes.modelProviders:插件提供的模型服务",
5
+ "description": "别的插件用 coda-model-provider 的设置按「插件/id」选它:叫什么、讲哪种接口、在哪(地址里可以写本插件的单值设置 ${config:…})、Key 是本插件的哪个密文。",
6
+ "type": "array",
7
+ "maxItems": 10,
8
+ "items": {
9
+ "type": "object",
10
+ "properties": {
11
+ "id": {"$ref": "common.json#/$defs/id"},
12
+ "title": {"$ref": "common.json#/$defs/line40"},
13
+ "api": {
14
+ "description": "接口:openai-completions、openai-responses、anthropic-messages",
15
+ "enum": ["openai-completions", "openai-responses", "anthropic-messages"]
16
+ },
17
+ "url": {
18
+ "description": "一行地址,只能引用本插件的单值设置(${config:<设置名>},不能是密文)",
19
+ "type": "string",
20
+ "maxLength": 4096,
21
+ "pattern": "^[^\\u0000\\r\\n]+$",
22
+ "x-placeholders": {"config": {"properties": {"type": {"enum": ["string", "number", "integer"]}, "writeOnly": {"const": false}}, "required": ["type"]}}
23
+ },
24
+ "key": {
25
+ "description": "key 是 ${config:<本插件的密文设置>}",
26
+ "type": "string",
27
+ "pattern": "^\\$\\{config:[^}]+\\}$",
28
+ "x-ref": {
29
+ "pointer": "/contributes/configuration/properties",
30
+ "part": "^\\$\\{config:([^}]+)\\}$",
31
+ "match": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]}
32
+ }
33
+ }
34
+ },
35
+ "required": ["id", "title", "api", "url"],
36
+ "additionalProperties": false
37
+ },
38
+ "x-unique-by": ["id"]
39
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/path.json",
4
+ "title": "contributes.path:放上 PATH 的目录",
5
+ "description": "插件目录里的目录(相对路径),或它在后端的状态目录 ${CODA_PLUGIN_STATE} 下的目录(setup 可以建它)。",
6
+ "type": "array",
7
+ "maxItems": 20,
8
+ "items": {
9
+ "type": "string",
10
+ "minLength": 1,
11
+ "pattern": "^[^\\u0000:\\n]*$",
12
+ "if": {"pattern": "^\\$\\{CODA_PLUGIN_STATE\\}"},
13
+ "then": {"description": "${CODA_PLUGIN_STATE} 下的目录:不离开它", "pattern": "^\\$\\{CODA_PLUGIN_STATE\\}(/(?!(.*/)?\\.\\.(/|$))[^$]*)?$"},
14
+ "else": {"description": "插件目录里的目录(相对路径,不离开插件目录)", "pattern": "^(?!/)(?!(.*/)?\\.\\.(/|$))(?!\\.?/*$)[^$]*$", "x-file": {"type": "directory"}}
15
+ }
16
+ }
@@ -0,0 +1,46 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/plugin.json",
4
+ "title": "插件清单(插件目录的 package.json)",
5
+ "description": "照 VS Code 扩展的 package.json 写;Coda 读的是下面这些键,其余是 npm 的,不管。contributes 的每个键是一种类型,各有自己的 schema;不是 Coda 的键,是写给别的插件的扩展点的(它们声明的类型),由那个扩展点的 schema 校验。",
6
+ "type": "object",
7
+ "properties": {
8
+ "id": {"$ref": "common.json#/$defs/id", "description": "插件 ID:小写字母、数字和「-」,以字母开头,至多 40 个字符;不写就用 name"},
9
+ "name": {"type": "string"},
10
+ "categories": {"description": "分类:文本的数组,第一个是插件页里归的类", "type": "array", "items": {"type": "string"}},
11
+ "main": {"description": "插件宿主运行的模块:插件目录里的 .js 或 .mjs 文件", "type": "string", "pattern": "\\.m?js$", "x-file": {"type": "file"}},
12
+ "activationEvents": {"description": "宿主什么时候加载 main:onStartupFinished(后端一启动),不重复", "type": "array", "items": {"enum": ["onStartupFinished"]}, "uniqueItems": true},
13
+ "extensionDependencies": {"description": "需要先装的插件的 ID,不重复", "type": "array", "items": {"$ref": "common.json#/$defs/id"}, "uniqueItems": true},
14
+ "contributes": {
15
+ "description": "插件带来的东西:每个键一种类型",
16
+ "type": "object",
17
+ "properties": {
18
+ "configuration": {"$ref": "configuration.json"},
19
+ "capabilities": {"$ref": "capabilities.json"},
20
+ "instructions": {"$ref": "instructions.json"},
21
+ "agents": {"$ref": "agents.json"},
22
+ "extensionPoints": {"$ref": "extension-points.json"},
23
+ "extensions": {"$ref": "extensions.json"},
24
+ "groups": {"$ref": "groups.json"},
25
+ "events": {"$ref": "events.json"},
26
+ "commands": {"$ref": "commands.json"},
27
+ "gitCredentials": {"$ref": "git-credentials.json"},
28
+ "repositories": {"$ref": "repositories.json"},
29
+ "services": {"$ref": "services.json"},
30
+ "setup": {"$ref": "setup.json"},
31
+ "skills": {"$ref": "skills.json"},
32
+ "environment": {"$ref": "environment.json"},
33
+ "path": {"$ref": "path.json"},
34
+ "endpoints": {"$ref": "endpoints.json"},
35
+ "mcpServers": {"$ref": "mcp-servers.json"},
36
+ "views": {"$ref": "views.json"},
37
+ "modelProviders": {"$ref": "model-providers.json"},
38
+ "executors": {"$ref": "executors.json"},
39
+ "composerModes": {"$ref": "composer-modes.json"}
40
+ },
41
+ "propertyNames": {"description": "contributes 的键:字母和数字,以小写字母开头", "pattern": "^[a-z][A-Za-z0-9]{0,39}$"}
42
+ }
43
+ },
44
+ "if": {"properties": {"activationEvents": {"minItems": 1}}, "required": ["activationEvents"]},
45
+ "then": {"required": ["main"], "description": "写了 activationEvents 的插件须有 main"}
46
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/repositories.json",
4
+ "title": "contributes.repositories:列出这台能访问的仓库",
5
+ "description": "一行命令,打印仓库供客户端选。只有 Coda 自带的插件装得上(安装时的规则)。",
6
+ "$ref": "common.json#/$defs/commandHolder"
7
+ }
@@ -0,0 +1,9 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/services.json",
4
+ "title": "contributes.services:开启随包服务",
5
+ "description": "随后端包的独立服务的 ID;没有已安装插件开启的服务不运行。",
6
+ "type": "array",
7
+ "uniqueItems": true,
8
+ "items": {"$ref": "common.json#/$defs/name"}
9
+ }
@@ -0,0 +1,242 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/setting.json",
4
+ "title": "一项设置的声明",
5
+ "description": "插件用 JSON Schema 声明设置,Coda 读的是其中一部分:单个值;多选(items.anyOf 的常量);多个模型服务;一列行;表格(additionalProperties 是每一项)。表格的每一项是单个值、Agent 组合或几列;一列是单个值或 Agent 组合。格式只认 coda-agent(新会话用什么启动)、coda-agent-match(表格的行名:哪些会话)、duration(ISO 8601 时长)、coda-repo、coda-directory、coda-model-provider(别的插件提供的模型服务)、coda-model-url(模型服务的地址,Key 与接口写在同组的 modelKey、modelApi)。writeOnly 是密文:只写不读,放在数据库旁的文件里。",
6
+ "$ref": "#/$defs/setting",
7
+ "$defs": {
8
+ "base": {
9
+ "type": "object",
10
+ "properties": {
11
+ "type": {"description": "type 取 boolean、integer、number、string、object、array", "enum": ["boolean", "integer", "number", "string", "object", "array"]},
12
+ "title": {"type": "string"},
13
+ "description": {"type": "string"},
14
+ "markdownDescription": {"type": "string"},
15
+ "order": {"type": "number"},
16
+ "default": true,
17
+ "enum": {"description": "enum 是非空的数组", "type": "array", "minItems": 1},
18
+ "enumDescriptions": {"type": "array"},
19
+ "enumItemLabels": {"description": "enumItemLabels 是每个选项显示的文字,各不超过 100 字", "type": "array", "items": {"type": "string", "maxLength": 100}},
20
+ "minimum": {"type": "number"},
21
+ "maximum": {"type": "number"},
22
+ "format": {
23
+ "description": "format 只认 coda-agent、coda-agent-match、duration、coda-repo、coda-directory、coda-model-provider、coda-model-url",
24
+ "enum": ["coda-agent", "coda-agent-match", "duration", "coda-repo", "coda-directory", "coda-model-provider", "coda-model-url"]
25
+ }
26
+ },
27
+ "required": ["type"],
28
+ "allOf": [
29
+ {
30
+ "if": {"properties": {"format": {"const": "coda-agent"}}, "required": ["format"]},
31
+ "then": {"description": "coda-agent 是对象", "properties": {"type": {"const": "object"}}}
32
+ },
33
+ {
34
+ "if": {
35
+ "properties": {"format": {"enum": ["duration", "coda-repo", "coda-directory", "coda-model-provider", "coda-model-url"]}},
36
+ "required": ["format"]
37
+ },
38
+ "then": {"description": "duration、coda-repo、coda-directory、coda-model-provider、coda-model-url 是文本", "properties": {"type": {"const": "string"}}}
39
+ },
40
+ {"if": {"required": ["enum"]}, "then": {"description": "enum 只用于文本与数字", "properties": {"type": {"enum": ["string", "integer", "number"]}}}},
41
+ {"if": {"required": ["enumItemLabels"]}, "then": {"description": "enumItemLabels 跟着 enum 写", "required": ["enum"]}},
42
+ {
43
+ "if": {"anyOf": [{"required": ["modelKey"]}, {"required": ["modelApi"]}]},
44
+ "then": {
45
+ "description": "modelKey 与 modelApi 只写在 coda-model-url 的地址上",
46
+ "properties": {"format": {"const": "coda-model-url"}},
47
+ "required": ["format"]
48
+ }
49
+ }
50
+ ]
51
+ },
52
+ "secret": {"description": "writeOnly 是开或关", "type": "boolean"},
53
+ "modelKey": {
54
+ "description": "modelKey 是同组的一个密文的名字",
55
+ "type": "string",
56
+ "x-ref": {"pointer": "2", "match": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]}}
57
+ },
58
+ "modelApi": {
59
+ "description": "modelApi 是同组的一个文本(不是密文)的名字",
60
+ "type": "string",
61
+ "x-ref": {"pointer": "2", "match": {"properties": {"type": {"const": "string"}, "writeOnly": {"const": false}}, "required": ["type"]}}
62
+ },
63
+ "setting": {
64
+ "description": "插件的一项设置",
65
+ "$ref": "#/$defs/base",
66
+ "properties": {
67
+ "writeOnly": {"$ref": "#/$defs/secret"},
68
+ "modelKey": {"$ref": "#/$defs/modelKey"},
69
+ "modelApi": {"$ref": "#/$defs/modelApi"},
70
+ "items": true,
71
+ "uniqueItems": {"description": "uniqueItems 只能是 true(每项至多一次)", "const": true},
72
+ "additionalProperties": true,
73
+ "propertyNames": true
74
+ },
75
+ "unevaluatedProperties": false,
76
+ "allOf": [
77
+ {
78
+ "if": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]},
79
+ "then": {
80
+ "description": "密文设置(writeOnly)只能是没有 format、enum 与默认值的文本",
81
+ "properties": {"type": {"const": "string"}},
82
+ "not": {"anyOf": [{"required": ["format"]}, {"required": ["enum"]}, {"required": ["default"]}]}
83
+ }
84
+ },
85
+ {
86
+ "if": {"properties": {"type": {"const": "array"}}, "required": ["type"]},
87
+ "then": {"$ref": "#/$defs/array"},
88
+ "else": {
89
+ "description": "只有多选、多个模型服务与一列行(type: array)才写 items 与 uniqueItems",
90
+ "not": {"anyOf": [{"required": ["items"]}, {"required": ["uniqueItems"]}]}
91
+ }
92
+ },
93
+ {
94
+ "if": {
95
+ "properties": {"type": {"const": "object"}},
96
+ "required": ["type"],
97
+ "not": {"properties": {"format": {"const": "coda-agent"}}, "required": ["format"]}
98
+ },
99
+ "then": {
100
+ "description": "表格写 additionalProperties(每一项是什么);propertyNames 只能是 { format: coda-agent-match }",
101
+ "required": ["additionalProperties"],
102
+ "properties": {
103
+ "additionalProperties": {"$ref": "#/$defs/entry"},
104
+ "propertyNames": {
105
+ "description": "propertyNames 只支持 format: coda-agent-match",
106
+ "type": "object",
107
+ "properties": {"format": {"const": "coda-agent-match"}},
108
+ "required": ["format"],
109
+ "additionalProperties": false
110
+ }
111
+ }
112
+ }
113
+ }
114
+ ]
115
+ },
116
+ "array": {
117
+ "description": "多选、多个模型服务与一列行写 items,不写 format、minimum 与 maximum",
118
+ "required": ["items"],
119
+ "not": {"anyOf": [{"required": ["format"]}, {"required": ["minimum"]}, {"required": ["maximum"]}]},
120
+ "if": {"properties": {"items": {"properties": {"format": {"const": "coda-model-provider"}}, "required": ["format"]}}},
121
+ "then": {"properties": {"items": {"$ref": "#/$defs/modelProviders"}}},
122
+ "else": {
123
+ "if": {"properties": {"items": {"properties": {"type": {"const": "object"}}, "required": ["type"]}}},
124
+ "then": {"description": "一列行不写 uniqueItems", "not": {"required": ["uniqueItems"]}, "properties": {"items": {"$ref": "#/$defs/rows"}}},
125
+ "else": {"properties": {"items": {"$ref": "#/$defs/options"}}}
126
+ }
127
+ },
128
+ "modelProviders": {
129
+ "description": "多个模型服务写 items: { type: string, format: coda-model-provider, modelApis }",
130
+ "type": "object",
131
+ "properties": {
132
+ "type": {"const": "string"},
133
+ "format": {"const": "coda-model-provider"},
134
+ "modelApis": {
135
+ "description": "modelApis 是 1–10 个接口名,取 openai-completions、openai-responses、anthropic-messages",
136
+ "type": "array",
137
+ "minItems": 1,
138
+ "maxItems": 10,
139
+ "items": {"enum": ["openai-completions", "openai-responses", "anthropic-messages"]}
140
+ }
141
+ },
142
+ "required": ["type", "format"],
143
+ "additionalProperties": false
144
+ },
145
+ "rows": {
146
+ "description": "一列行写 items: { type: object, properties, required }",
147
+ "$ref": "#/$defs/entry",
148
+ "required": ["properties"],
149
+ "not": {"required": ["format"]},
150
+ "properties": {
151
+ "properties": {
152
+ "additionalProperties": {"description": "一列行的列不能是密文,要密文用表格", "not": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]}}
153
+ }
154
+ }
155
+ },
156
+ "options": {
157
+ "description": "多选写 items: { anyOf: [{ const, title, description }] },1–50 项",
158
+ "type": "object",
159
+ "properties": {
160
+ "anyOf": {
161
+ "type": "array",
162
+ "minItems": 1,
163
+ "maxItems": 50,
164
+ "items": {
165
+ "description": "多选的一项是 { const, title, description }:const 只用字母、数字和「._-」,title 与 description 不超过 400 字",
166
+ "type": "object",
167
+ "properties": {
168
+ "const": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"},
169
+ "title": {"type": "string", "maxLength": 400},
170
+ "description": {"type": "string", "maxLength": 400}
171
+ },
172
+ "required": ["const"],
173
+ "additionalProperties": false
174
+ },
175
+ "x-unique-by": ["const"]
176
+ }
177
+ },
178
+ "required": ["anyOf"],
179
+ "additionalProperties": false
180
+ },
181
+ "entry": {
182
+ "description": "表格的一项:单个值、Agent 组合,或 properties 写明的 1–20 列",
183
+ "$ref": "#/$defs/base",
184
+ "properties": {"properties": true, "required": true},
185
+ "unevaluatedProperties": false,
186
+ "allOf": [
187
+ {"if": {"properties": {"type": {"const": "array"}}, "required": ["type"]}, "then": {"description": "多选与一列行只能是插件的一项设置,不能放进表格", "not": {}}},
188
+ {
189
+ "if": {"properties": {"type": {"const": "object"}}, "required": ["type"]},
190
+ "then": {
191
+ "description": "表格的每一项只能是单个值、Agent 组合,或 properties 写明的 1–20 列",
192
+ "anyOf": [{"properties": {"format": {"const": "coda-agent"}}, "required": ["format"]}, {"required": ["properties"]}]
193
+ }
194
+ },
195
+ {
196
+ "if": {"anyOf": [{"required": ["properties"]}, {"required": ["required"]}]},
197
+ "then": {"description": "只有一行几列时才写 properties 与 required", "properties": {"type": {"const": "object"}}, "not": {"required": ["format"]}}
198
+ },
199
+ {"if": {"required": ["properties"]}, "then": {"$ref": "#/$defs/row"}}
200
+ ]
201
+ },
202
+ "row": {
203
+ "properties": {
204
+ "properties": {
205
+ "description": "一行写 1–20 列;一行是一组,至多一个模型地址(coda-model-url):检查可用模型按组找它",
206
+ "type": "object",
207
+ "minProperties": 1,
208
+ "maxProperties": 20,
209
+ "propertyNames": {"description": "列名只用字母和数字,以小写字母开头", "pattern": "^[a-z][A-Za-z0-9]{0,39}$"},
210
+ "additionalProperties": {"$ref": "#/$defs/column"},
211
+ "x-max-contains": {"match": {"properties": {"format": {"const": "coda-model-url"}}, "required": ["format"]}, "max": 1}
212
+ },
213
+ "required": {
214
+ "description": "required 是本行的列名,不重复",
215
+ "type": "array",
216
+ "uniqueItems": true,
217
+ "items": {"description": "required 是本行的列名,不重复", "type": "string", "x-ref": {"pointer": "2/properties"}}
218
+ }
219
+ }
220
+ },
221
+ "column": {
222
+ "description": "一列:单个值或 Agent 组合",
223
+ "$ref": "#/$defs/base",
224
+ "properties": {"writeOnly": {"$ref": "#/$defs/secret"}, "modelKey": {"$ref": "#/$defs/modelKey"}, "modelApi": {"$ref": "#/$defs/modelApi"}},
225
+ "unevaluatedProperties": false,
226
+ "allOf": [
227
+ {
228
+ "if": {"properties": {"writeOnly": {"const": true}}, "required": ["writeOnly"]},
229
+ "then": {
230
+ "description": "密文设置(writeOnly)只能是没有 format、enum 与默认值的文本",
231
+ "properties": {"type": {"const": "string"}},
232
+ "not": {"anyOf": [{"required": ["format"]}, {"required": ["enum"]}, {"required": ["default"]}]}
233
+ }
234
+ },
235
+ {
236
+ "if": {"properties": {"type": {"enum": ["object", "array"]}}, "required": ["type"]},
237
+ "then": {"description": "一列只能是单个值或 Agent 组合", "properties": {"format": {"const": "coda-agent"}}, "required": ["format"]}
238
+ }
239
+ ]
240
+ }
241
+ }
242
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/setup.json",
4
+ "title": "contributes.setup:准备运行环境",
5
+ "description": "用户安装或更新插件后运行的一行命令。",
6
+ "$ref": "common.json#/$defs/commandHolder"
7
+ }
@@ -0,0 +1,15 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/skills.json",
4
+ "title": "contributes.skills:插件带来的 Agent Skill",
5
+ "description": "插件目录里的目录,每个有自己的 SKILL.md;Agent 按目录名找到它,所以目录名不重复。",
6
+ "type": "array",
7
+ "maxItems": 100,
8
+ "items": {
9
+ "description": "插件目录里的相对路径,目录名只用字母、数字、「.」「_」「-」,里面有 SKILL.md",
10
+ "type": "string",
11
+ "pattern": "^(?!/)(?!(.*/)?\\.\\.(/|$))(?!\\.?/*$)(.*/)?[A-Za-z0-9][A-Za-z0-9._-]{0,63}/*$",
12
+ "x-file": {"type": "directory", "contains": "SKILL.md"}
13
+ },
14
+ "x-unique-by": [{"part": "([^/]+)/*$"}]
15
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://coda.pub/schemas/plugin/v1/views.json",
4
+ "title": "contributes.views:客户端为插件打开的页面",
5
+ "description": "插件目录里的 HTML,客户端在沙箱里开:在哪常驻(side 会话旁、page 一页),图标,接管打开的引用种类(handles,像 VS Code 的自定义编辑器),读数(readout)与只给哪种工作位置的会话(checkout)。",
6
+ "type": "array",
7
+ "maxItems": 10,
8
+ "items": {
9
+ "type": "object",
10
+ "properties": {
11
+ "id": {"$ref": "common.json#/$defs/id"},
12
+ "title": {"$ref": "common.json#/$defs/line40"},
13
+ "entry": {"description": "插件目录里的 .html 文件", "type": "string", "pattern": "^(?!/)(?!(.*/)?\\.\\.(/|$)).*\\.html$", "x-file": {"type": "file"}},
14
+ "in": {"description": "它常驻的位置:side、page,不重复", "type": "array", "uniqueItems": true, "items": {"enum": ["side", "page"]}},
15
+ "icon": {"$ref": "common.json#/$defs/symbol"},
16
+ "handles": {
17
+ "description": "它接管打开的引用种类(如 workflow-runs),至多 8 个,不重复",
18
+ "type": "array",
19
+ "maxItems": 8,
20
+ "uniqueItems": true,
21
+ "items": {"$ref": "common.json#/$defs/id"}
22
+ },
23
+ "readout": {"description": "读数:workflow-runs、machines、changes", "enum": ["workflow-runs", "machines", "changes"]},
24
+ "checkout": {"description": "只给哪种工作位置的会话:worktree", "enum": ["worktree"]}
25
+ },
26
+ "required": ["id", "title", "entry"],
27
+ "additionalProperties": false
28
+ },
29
+ "x-unique-by": ["id"]
30
+ }
@@ -55,7 +55,14 @@ const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
55
55
  export function firstMessage(value) {
56
56
  object(value, '首次发送');
57
57
  keys(value, ['requestId', 'projectId', 'title', 'agent', 'checkout', 'settings', 'text', 'attachments', 'quotes', 'handoffSource', 'parentThreadId',
58
- 'replyTo', 'threadId', 'extensionParent', 'mode']);
58
+ 'replyTo', 'threadId', 'extensionParent', 'mode', 'initiatedBy']);
59
+ const initiatedBy = value.initiatedBy === undefined ? {} : (() => {
60
+ const source = object(value.initiatedBy, '发起会话');
61
+ keys(source, ['threadId', 'title']);
62
+ check(UUID.test(source.threadId ?? ''), 'invalid_input', '发起会话标识须为 UUID');
63
+ check(!value.parentThreadId && !value.extensionParent && !value.handoffSource, 'invalid_input', '发起的会话须为独立会话');
64
+ return { initiatedBy: { threadId: source.threadId, title: text(source.title, '发起会话标题') } };
65
+ })();
59
66
  const handoff = value.handoffSource === undefined ? {} : { handoffSource: text(value.handoffSource, '交接来源', 100) };
60
67
  const parent = value.parentThreadId === undefined ? {} : { parentThreadId: text(value.parentThreadId, '父会话', 100) };
61
68
  check(!parent.parentThreadId || handoff.handoffSource === parent.parentThreadId, 'invalid_input', '子会话必须引用父会话上下文');
@@ -94,6 +101,7 @@ export function firstMessage(value) {
94
101
  const message = text(value.text, '消息', 100_000), passages = quotes(value.quotes);
95
102
  return withAttachments({
96
103
  ...handoff,
104
+ ...initiatedBy,
97
105
  ...parent,
98
106
  ...reply,
99
107
  ...outside,
@@ -125,4 +133,11 @@ export function childSpawn(value) {
125
133
  settings: settings(Object.fromEntries(['model', 'effort', 'mode', 'options'].filter(k => value[k] !== undefined).map(k => [k, value[k]]))) };
126
134
  }
127
135
 
128
-
136
+ // A remote client asks the user to open a root session. No checkout or parent is supplied by the agent.
137
+ export function newSession(value) {
138
+ object(value, 'new_session');
139
+ keys(value, ['turn', 'requestId', 'project', 'agent', 'prompt', 'title', 'model', 'effort', 'mode', 'options']);
140
+ text(value.project, 'project', 200);
141
+ const { checkout: _, ...spec } = childSpawn(value);
142
+ return spec;
143
+ }
@@ -1,30 +1,56 @@
1
1
  {
2
- "commit": "2e5849933437879adf1a1efd75b7f4dc9d469f6a",
2
+ "commit": "4d0cab284f690d4f98ec0a390412fcc3b76f024c",
3
3
  "packages": {
4
4
  "@0dep/piso": "5.2.0",
5
5
  "@agentclientprotocol/sdk": "1.4.0",
6
+ "ajv": "8.20.0",
6
7
  "yaml": "2.9.1"
7
8
  },
8
9
  "files": {
9
- "check/coda/components/plugins/agent-plugins.mjs": "23016dd0f7350a10f71565a2c44e2c1179299a93e8c859529071099f2ce862d1",
10
- "check/coda/components/plugins/model-protocols.mjs": "762244c01266cf61384377bdfbb84bef5ab157b1783f9254ddc1ae3d576a73c5",
11
- "check/coda/components/plugins/plugin-extensions.mjs": "e527800a109ec9849975357f841b0c05ecfa50c9d9c34e26d828aef3cb7d3cb3",
12
- "check/coda/components/plugins/plugin-rules.mjs": "8cd1058fc96365f7f35451a4a75bd1c6434e0e036bb4b18f7c7fc37709e66c3e",
13
- "check/coda/components/plugins/plugin-source-rules.mjs": "e03606bf3056061ee3a78494d34dae9dfbe35d6fb2f139880fab5891663cbedc",
10
+ "check/coda/components/plugins/agent-plugins.mjs": "e3b894b71db213a92dbb6601b7d6711346bc5001cb863fed7ace852462dd2214",
11
+ "check/coda/components/plugins/plugin-extensions.mjs": "a1e8810296fd64d0e7792f1d987bd6ea6f71d1aa5d52a225f4a14eb6681f2758",
12
+ "check/coda/components/plugins/plugin-rules.mjs": "5ec4113c3eca61b30992ab8e46e7da3e390e517924faf26796ec26db7919a580",
13
+ "check/coda/components/plugins/plugin-schema.mjs": "ce71d81cff6d5b0ec53dcd9fa148672b1ece2db1d4a9bf9e4b1b35d485aed691",
14
+ "check/coda/components/plugins/plugin-source-rules.mjs": "4eedfd024c0824b1fed78be106f1a2827ffc3dd35ac0c69b8b0c61a59af42efd",
14
15
  "check/coda/components/plugins/skill-document.mjs": "c5b5e815c42cd836572f7b60e22a46af6ac607fd9df0170fa36f955825636ce6",
15
16
  "check/coda/components/prompt-recovery/prompt-recovery.mjs": "f43f21d24c19a58113d3304f9248225b12080ab00ed15eab74bf7b94642732de",
16
- "check/coda/components/session-config/commands.mjs": "b59772a8216d8d97d0e0fb4f094c194b3e602ef3aeca2ea3eba5919f481f791c",
17
+ "check/coda/components/session-config/commands.mjs": "bd198ea12c3ed02d8aa173d86653eeac2f10e4cb8493503ba81ddac9bb76b729",
17
18
  "check/coda/components/workflows/executor-labels.mjs": "dceca6ae60c0a4f3c3cc72a6c84f1489831790774c93caab96e4ddb493bc89e1",
18
19
  "check/coda/domain/agent-protocol.mjs": "e85866b88c802de1204d4215f7c10d345d76aa9900854d5e2d615f2d1c8f30b7",
19
20
  "check/coda/domain/duration.mjs": "15dd64ef9b02342ad521c66e5968a569432a89dc7568d11afd3e6f3fe37e104b",
20
- "check/coda/domain/errors.mjs": "773c641309a0d19b93c0b3457428d74ecf636454d9fe91cacf3d944b952831dc",
21
+ "check/coda/domain/errors.mjs": "ddc00aef9bb6f9a56845a9926c82200628a906230d31212d88fcde48e36dfd36",
21
22
  "check/coda/domain/values.mjs": "01cc72b8d9c09e3fe16c93ec332ca01148bba859b1c672586d9d07444d7816c4",
22
23
  "check/coda/kernel/agent-failures.mjs": "e435b9a1710b8a7c0ee243f04a556464f50b1a5605fb7bb59af21b78fca1b637",
23
24
  "check/coda/resources/plugins/resources/panels/command.mjs": "606f28bf87f87dded9df2db892bc7624c770d795ffab88f2409998346920ae42",
24
25
  "check/coda/resources/plugins/resources/panels/panels.mjs": "aee040febb37fd6eebaf1a1da5b3299d2b6a9dfc982e649d9a628291af298179",
25
26
  "check/coda/resources/plugins/resources/panels/rules.mjs": "c024c5ede7c1516877128aa6d6796fbe5fd0e14642741b0745481bb1c5ca41d3",
26
27
  "check/coda/resources/plugins/resources/panels/sign-in.mjs": "1271a24e33b1b882a1fb9bee03b8e240db8b9bee1b5208f0e1c84499cfb1be7e",
28
+ "check/coda/components/plugins/schemas/agents.json": "5f340b69f9bae6040f36aa68c350495f76c5f033eafdc4e5d73a73fa875b6040",
29
+ "check/coda/components/plugins/schemas/capabilities.json": "e5cb7ca58e12fa9778e015d2cdcd58d96fff8464314c73a950208a1f2a19f6d6",
30
+ "check/coda/components/plugins/schemas/commands.json": "bd520205842e0c7b987f962943898b16e52bf9cb05ddfaf09e34fb99e5b467d6",
31
+ "check/coda/components/plugins/schemas/common.json": "b6781559e4db07fab095d0a171b73f32277aa56ef048f70a4216e94b41c681f3",
32
+ "check/coda/components/plugins/schemas/composer-modes.json": "69d4a97cc330c50052bda104ae623375d79f785b6097e806fc9dbd73bceb5429",
33
+ "check/coda/components/plugins/schemas/configuration.json": "b5ad5e294da0f2282a6b6f051b4e6d5b6bb6fb9e1c737ecd399e2ff1d4baa297",
34
+ "check/coda/components/plugins/schemas/endpoints.json": "20fd2ce0ff4130b537b1b5b87749c8a4462ebd2e28498b4fe78050f39241a2cd",
35
+ "check/coda/components/plugins/schemas/environment.json": "a17b697adff32d0099bf9c93de99363cc7a8450964d2f7a91dddace3ec640e2e",
36
+ "check/coda/components/plugins/schemas/events.json": "d0da29f2b82a24249ca7de944c109a0a849adce3045797b431b47115d662ee7b",
37
+ "check/coda/components/plugins/schemas/executors.json": "30a3134020dabcafbdc5e1b2aa8b907bdfd74d6bac36c408a520bcf2a2d87897",
38
+ "check/coda/components/plugins/schemas/extension-points.json": "01b5fa12aac0de9ef526d8c76281abd4ec4b4ab5bf3c362f144e13eefb4b5cf8",
39
+ "check/coda/components/plugins/schemas/extensions.json": "62c9db6de8199e84f653a7dce404e4f0d6923ae7954347fc8fedc3f8ca69391a",
40
+ "check/coda/components/plugins/schemas/git-credentials.json": "24e98fd31cc0f9f48be928c4792de9bed00b2b1b1f01963a67d6b600ac2fd432",
41
+ "check/coda/components/plugins/schemas/groups.json": "d7b6de75213849846b2e38ef89865e2d33bf41f617c418ee0496d0a425d7c421",
42
+ "check/coda/components/plugins/schemas/instructions.json": "c4c82b29e641a4f68b64b25e2e2bc578f0dbedf35030f1980ce539885517906d",
43
+ "check/coda/components/plugins/schemas/mcp-servers.json": "e395b3ef7ce93ffaa4e7591065de14bc755d8a6e11a605a0318537383a4ed79a",
44
+ "check/coda/components/plugins/schemas/model-providers.json": "2022568128887be53609cff03f6ae1e8f129c1b963709ddfd087814088161ceb",
45
+ "check/coda/components/plugins/schemas/path.json": "12cefad92473711607ea502d05934fb5548c7d900455667017df405cfce2a52e",
46
+ "check/coda/components/plugins/schemas/plugin.json": "453d2fb32a24a995f787f436ef44a77ea2e0a4043d105e5552515d0b32c06354",
47
+ "check/coda/components/plugins/schemas/repositories.json": "a4b5a4cc0367dad92e2f5879a609cfcfb85c2072c2ff2293284d12b976b1c72b",
48
+ "check/coda/components/plugins/schemas/services.json": "a39ce23c985912580dab13df795b3f64d96f5dc0efcba039945c67962cef9973",
49
+ "check/coda/components/plugins/schemas/setting.json": "16e768eefc4402658adb7056c8830a236368e4933509d8c9b5419bbdb8d499bc",
50
+ "check/coda/components/plugins/schemas/setup.json": "b6c78841e9fcd84ec171d8d76da92ff1a70d979f2d0212bb2fd5dceffe9e5535",
51
+ "check/coda/components/plugins/schemas/skills.json": "4b9c8dea5419319481eeb89d503e20390a933052a997a334e2b7568230722791",
52
+ "check/coda/components/plugins/schemas/views.json": "d9db0019d32e05d026292f6a8e0f16158b1ebe148b2c6ede6b52d54207b88fb5",
27
53
  "check/coda/builtin.json": "d1865fad1440a62341188458578cf95e1afc5528229ff8a97c2a727ce7985b67",
28
- "docs/agent-protocol.md": "322271992a6c95db24fa4f8fbddf8bec23ca9dc9e7d00e5f8bdb4258a30e1cd7"
54
+ "docs/agent-protocol.md": "643482a77eed0978b4f366b604bff87ddb41541c08da1df919811da26e7c0024"
29
55
  }
30
56
  }
@@ -9,3 +9,6 @@ export class ContractError extends Error {
9
9
  export function requireCondition(condition, code, message) {
10
10
  if (!condition) throw new ContractError(code, message);
11
11
  }
12
+
13
+ // A remote request was conclusively refused. Other errors leave its outcome uncertain and can be retried.
14
+ export const REFUSED = new Set(['forbidden', 'not_found', 'invalid_input', 'invalid_state', 'idempotency_conflict', 'call_ended']);
package/check/index.mjs CHANGED
@@ -1,5 +1,6 @@
1
1
  // The contract check of one plugin directory: the manifest, then each agent's handshake (and with `live`, a turn) and each
2
- // panel's reading. The rules are Coda's own code (check/coda/), run where a plugin is written.
2
+ // panel's reading. The manifest is checked against Coda's schemas of its types, the rest by Coda's own code (check/coda/), run where
3
+ // a plugin is written.
3
4
  import { resolve } from 'node:path';
4
5
  import { checkAgent } from './agent.mjs';
5
6
  import { checkManifest } from './manifest.mjs';