c64bridge 0.8.0 → 0.9.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.
Files changed (79) hide show
  1. package/.github/prompts/steer.prompt.md +55 -0
  2. package/AGENTS.md +9 -7
  3. package/README.md +139 -95
  4. package/data/embeddings_asm.json +1 -1
  5. package/data/embeddings_basic.json +1 -1
  6. package/data/embeddings_hardware.json +1 -1
  7. package/data/embeddings_mixed.json +1 -1
  8. package/data/embeddings_other.json +1 -1
  9. package/data/graphics/petscii-style-guide.md +4 -4
  10. package/data/graphics/sprite-charset-best-practices.md +9 -9
  11. package/data/vice/vice-binary-monitor-spec.md +921 -0
  12. package/dist/.tsbuildinfo +1 -1
  13. package/dist/device.js +86 -10
  14. package/dist/mcp-server.js +1 -1
  15. package/dist/prompts/registry.js +27 -25
  16. package/dist/rag/knowledgeIndex.js +112 -79
  17. package/dist/rag/resourceUris.js +93 -0
  18. package/dist/tools/audio.js +11 -11
  19. package/dist/tools/debug.js +1 -1
  20. package/dist/tools/developer.js +13 -13
  21. package/dist/tools/graphics.js +10 -10
  22. package/dist/tools/machineControl.js +5 -5
  23. package/dist/tools/memory.js +19 -11
  24. package/dist/tools/meta/index.js +1 -1
  25. package/dist/tools/printer.js +11 -12
  26. package/dist/tools/programRunners.js +16 -16
  27. package/dist/tools/rag.js +9 -9
  28. package/dist/tools/registry/config.js +1 -1
  29. package/dist/tools/registry/disk.js +1 -1
  30. package/dist/tools/registry/drive.js +1 -1
  31. package/dist/tools/registry/extract.js +1 -1
  32. package/dist/tools/registry/graphics.js +1 -1
  33. package/dist/tools/registry/memory.js +1 -1
  34. package/dist/tools/registry/platform.js +1 -1
  35. package/dist/tools/registry/printer.js +1 -1
  36. package/dist/tools/registry/program.js +1 -1
  37. package/dist/tools/registry/rag.js +1 -1
  38. package/dist/tools/registry/sound.js +1 -1
  39. package/dist/tools/registry/stream.js +1 -1
  40. package/dist/tools/registry/system.js +1 -1
  41. package/dist/tools/storage.js +15 -15
  42. package/dist/tools/streaming.js +3 -3
  43. package/dist/tools/types.js +41 -4
  44. package/dist/tools/vice.js +2 -5
  45. package/dist/vice/process.js +79 -2
  46. package/dist/vice/readiness.js +35 -0
  47. package/dist/vice/smokeOptions.js +44 -0
  48. package/dist/viceRunner.js +2 -0
  49. package/doc/developer.md +10 -2
  50. package/doc/plans/prompts/README.md +7 -7
  51. package/mcp/prompts.json +42 -59
  52. package/mcp/protocol-examples.json +2 -2
  53. package/mcp/resources.json +179 -166
  54. package/mcp/schemas/c64_config.schema.json +109 -326
  55. package/mcp/schemas/c64_debug.schema.json +158 -337
  56. package/mcp/schemas/c64_disk.schema.json +180 -262
  57. package/mcp/schemas/c64_drive.schema.json +31 -111
  58. package/mcp/schemas/c64_extract.schema.json +193 -291
  59. package/mcp/schemas/c64_graphics.schema.json +208 -308
  60. package/mcp/schemas/c64_memory.schema.json +94 -144
  61. package/mcp/schemas/c64_printer.schema.json +151 -205
  62. package/mcp/schemas/c64_program.schema.json +229 -367
  63. package/mcp/schemas/c64_rag.schema.json +25 -59
  64. package/mcp/schemas/c64_select_backend.schema.json +19 -26
  65. package/mcp/schemas/c64_sound.schema.json +346 -622
  66. package/mcp/schemas/c64_stream.schema.json +25 -54
  67. package/mcp/schemas/c64_system.schema.json +79 -212
  68. package/mcp/schemas/c64_vice.schema.json +24 -55
  69. package/mcp/server.json +1 -1
  70. package/mcp/tools.json +1935 -3443
  71. package/mcp.json +10 -9
  72. package/package.json +20 -15
  73. package/scripts/fetch-external-sources.mjs +1 -2
  74. package/scripts/prepare-release.mjs +59 -2
  75. package/scripts/run-coverage.mjs +26 -1
  76. package/scripts/run-tests.mjs +2 -2
  77. package/scripts/run-tests.ts +273 -52
  78. package/scripts/update-readme.ts +54 -2
  79. package/server.json +94 -0
package/mcp/prompts.json CHANGED
@@ -6,9 +6,9 @@
6
6
  "description": "Route ultra-fast hello-world and smoke-test requests to the canonical greeting skill.",
7
7
  "_meta": {
8
8
  "requiredResources": [
9
- "c64://context/bootstrap",
10
- "c64://context/fast-paths",
11
- "c64://docs/index"
9
+ "c64://guide/bootstrap",
10
+ "c64://guide/fast-paths",
11
+ "c64://guide/index"
12
12
  ],
13
13
  "optionalResources": [],
14
14
  "tools": [
@@ -29,12 +29,12 @@
29
29
  "description": "Route bespoke Commodore BASIC v2 requests to the canonical BASIC skill.",
30
30
  "_meta": {
31
31
  "requiredResources": [
32
- "c64://specs/basic",
33
- "c64://context/bootstrap",
34
- "c64://docs/index"
32
+ "c64://basic/spec",
33
+ "c64://guide/bootstrap",
34
+ "c64://guide/index"
35
35
  ],
36
36
  "optionalResources": [
37
- "c64://context/fast-paths"
37
+ "c64://guide/fast-paths"
38
38
  ],
39
39
  "tools": [
40
40
  "c64_program",
@@ -53,9 +53,9 @@
53
53
  "description": "Route quick visible demo requests to the cross-platform demo skill.",
54
54
  "_meta": {
55
55
  "requiredResources": [
56
- "c64://context/bootstrap",
57
- "c64://context/fast-paths",
58
- "c64://docs/index"
56
+ "c64://guide/bootstrap",
57
+ "c64://guide/fast-paths",
58
+ "c64://guide/index"
59
59
  ],
60
60
  "optionalResources": [],
61
61
  "tools": [
@@ -75,12 +75,12 @@
75
75
  "description": "Route quick recognizable tune requests to the SID music skill.",
76
76
  "_meta": {
77
77
  "requiredResources": [
78
- "c64://specs/sid",
79
- "c64://specs/sidwave",
80
- "c64://context/fast-paths"
78
+ "c64://sound/sid/spec",
79
+ "c64://sound/sidwave/spec",
80
+ "c64://guide/fast-paths"
81
81
  ],
82
82
  "optionalResources": [
83
- "c64://docs/sid/best-practices"
83
+ "c64://sound/sid/best-practices"
84
84
  ],
85
85
  "tools": [
86
86
  "c64_sound"
@@ -100,24 +100,18 @@
100
100
  "arguments": [
101
101
  {
102
102
  "name": "hardware",
103
- "description": "Optional focus area for the routine (sid, vic, cia, or multi for combined work).",
104
- "options": [
105
- "sid",
106
- "vic",
107
- "cia",
108
- "multi"
109
- ]
103
+ "description": "Optional focus area for the routine (sid, vic, cia, or multi for combined work)."
110
104
  }
111
105
  ],
112
106
  "_meta": {
113
107
  "requiredResources": [
114
- "c64://specs/assembly",
115
- "c64://specs/vic",
116
- "c64://specs/sid",
117
- "c64://context/bootstrap"
108
+ "c64://assembly/6510-spec",
109
+ "c64://graphics/vic/spec",
110
+ "c64://sound/sid/spec",
111
+ "c64://guide/bootstrap"
118
112
  ],
119
113
  "optionalResources": [
120
- "c64://docs/sid/best-practices"
114
+ "c64://sound/sid/best-practices"
121
115
  ],
122
116
  "tools": [
123
117
  "c64_program",
@@ -143,13 +137,13 @@
143
137
  "description": "Route SID playback and composition work to the canonical SID skill.",
144
138
  "_meta": {
145
139
  "requiredResources": [
146
- "c64://specs/sid",
147
- "c64://specs/sidwave",
148
- "c64://docs/sid/file-structure",
149
- "c64://docs/sid/best-practices"
140
+ "c64://sound/sid/spec",
141
+ "c64://sound/sidwave/spec",
142
+ "c64://sound/sid/file-format",
143
+ "c64://sound/sid/best-practices"
150
144
  ],
151
145
  "optionalResources": [
152
- "c64://context/fast-paths"
146
+ "c64://guide/fast-paths"
153
147
  ],
154
148
  "tools": [
155
149
  "c64_sound"
@@ -168,24 +162,18 @@
168
162
  "arguments": [
169
163
  {
170
164
  "name": "mode",
171
- "description": "Target VIC-II technique (text, multicolour, bitmap, or sprite).",
172
- "options": [
173
- "text",
174
- "multicolour",
175
- "bitmap",
176
- "sprite"
177
- ]
165
+ "description": "Target VIC-II technique (text, multicolour, bitmap, or sprite)."
178
166
  }
179
167
  ],
180
168
  "_meta": {
181
169
  "requiredResources": [
182
- "c64://specs/vic",
183
- "c64://context/bootstrap"
170
+ "c64://graphics/vic/spec",
171
+ "c64://guide/bootstrap"
184
172
  ],
185
173
  "optionalResources": [
186
- "c64://specs/assembly",
187
- "c64://specs/charset",
188
- "c64://docs/petscii-style"
174
+ "c64://assembly/6510-spec",
175
+ "c64://graphics/character-set",
176
+ "c64://graphics/petscii/style-guide"
189
177
  ],
190
178
  "tools": [
191
179
  "c64_program",
@@ -213,24 +201,19 @@
213
201
  "arguments": [
214
202
  {
215
203
  "name": "printerType",
216
- "description": "Select Commodore (device 4) or Epson FX workflow helpers.",
217
- "options": [
218
- "commodore",
219
- "epson"
220
- ]
204
+ "description": "Select Commodore (device 4) or Epson FX workflow helpers."
221
205
  }
222
206
  ],
223
207
  "_meta": {
224
208
  "requiredResources": [
225
- "c64://specs/printer",
226
- "c64://docs/printer/guide",
227
- "c64://docs/printer/prompts"
209
+ "c64://printer/spec",
210
+ "c64://printer/prompt-guide"
228
211
  ],
229
212
  "optionalResources": [
230
- "c64://docs/printer/commodore-text",
231
- "c64://docs/printer/commodore-bitmap",
232
- "c64://docs/printer/epson-text",
233
- "c64://docs/printer/epson-bitmap"
213
+ "c64://printer/commodore/text",
214
+ "c64://printer/commodore/bitmap",
215
+ "c64://printer/epson/text",
216
+ "c64://printer/epson/bitmap"
234
217
  ],
235
218
  "tools": [
236
219
  "c64_printer"
@@ -252,9 +235,9 @@
252
235
  "description": "Route reversible memory inspection or patching work to the canonical memory skill.",
253
236
  "_meta": {
254
237
  "requiredResources": [
255
- "c64://context/bootstrap",
256
- "c64://specs/assembly",
257
- "c64://docs/index"
238
+ "c64://guide/bootstrap",
239
+ "c64://assembly/6510-spec",
240
+ "c64://guide/index"
258
241
  ],
259
242
  "optionalResources": [],
260
243
  "tools": [
@@ -274,7 +257,7 @@
274
257
  "description": "Route disk-image and drive-state requests to the canonical drive skill.",
275
258
  "_meta": {
276
259
  "requiredResources": [
277
- "c64://context/bootstrap"
260
+ "c64://guide/bootstrap"
278
261
  ],
279
262
  "optionalResources": [],
280
263
  "tools": [
package/mcp/protocol-examples.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "protocolVersion": "2025-06-18",
2
+ "protocolVersion": "2025-11-25",
3
3
  "examples": {
4
4
  "initialize": {
5
5
  "description": "Client initialization request sent immediately after connecting to the stdio MCP server.",
@@ -8,7 +8,7 @@
8
8
  "id": 1,
9
9
  "method": "initialize",
10
10
  "params": {
11
- "protocolVersion": "2025-06-18",
11
+ "protocolVersion": "2025-11-25",
12
12
  "capabilities": {
13
13
  "resources": {},
14
14
  "tools": {},