c64bridge 0.8.1 → 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 (77) 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/plans/prompts/README.md +7 -7
  50. package/mcp/prompts.json +42 -59
  51. package/mcp/protocol-examples.json +2 -2
  52. package/mcp/resources.json +179 -166
  53. package/mcp/schemas/c64_config.schema.json +109 -326
  54. package/mcp/schemas/c64_debug.schema.json +158 -337
  55. package/mcp/schemas/c64_disk.schema.json +180 -262
  56. package/mcp/schemas/c64_drive.schema.json +31 -111
  57. package/mcp/schemas/c64_extract.schema.json +193 -291
  58. package/mcp/schemas/c64_graphics.schema.json +208 -308
  59. package/mcp/schemas/c64_memory.schema.json +94 -144
  60. package/mcp/schemas/c64_printer.schema.json +151 -205
  61. package/mcp/schemas/c64_program.schema.json +229 -367
  62. package/mcp/schemas/c64_rag.schema.json +25 -59
  63. package/mcp/schemas/c64_select_backend.schema.json +19 -26
  64. package/mcp/schemas/c64_sound.schema.json +346 -622
  65. package/mcp/schemas/c64_stream.schema.json +25 -54
  66. package/mcp/schemas/c64_system.schema.json +79 -212
  67. package/mcp/schemas/c64_vice.schema.json +24 -55
  68. package/mcp/server.json +1 -1
  69. package/mcp/tools.json +1935 -3443
  70. package/mcp.json +3 -3
  71. package/package.json +17 -14
  72. package/scripts/fetch-external-sources.mjs +1 -2
  73. package/scripts/run-coverage.mjs +26 -1
  74. package/scripts/run-tests.mjs +2 -2
  75. package/scripts/run-tests.ts +273 -52
  76. package/scripts/update-readme.ts +54 -2
  77. package/server.json +2 -2
package/mcp/schemas/c64_rag.schema.json CHANGED
@@ -1,67 +1,33 @@
1
1
  {
2
2
  "type": "object",
3
- "description": "RAG operations available via the c64_rag tool.",
4
- "oneOf": [
5
- {
6
- "type": "object",
7
- "description": "Retrieve BASIC references and snippets from the local knowledge base.",
8
- "properties": {
9
- "q": {
10
- "type": "string",
11
- "description": "Natural-language query describing the desired BASIC or assembly guidance.",
12
- "minLength": 3
13
- },
14
- "k": {
15
- "type": [
16
- "integer",
17
- "null"
18
- ],
19
- "description": "Maximum number of references to return (1-12).",
20
- "minimum": 1,
21
- "maximum": 12,
22
- "default": 3
23
- },
24
- "op": {
25
- "const": "basic"
26
- }
27
- },
28
- "required": [
29
- "q",
30
- "op"
3
+ "properties": {
4
+ "op": {
5
+ "type": "string",
6
+ "enum": [
7
+ "basic",
8
+ "asm"
31
9
  ],
32
- "additionalProperties": false
10
+ "description": "Selects the operation."
33
11
  },
34
- {
35
- "type": "object",
36
- "description": "Retrieve 6502/6510 assembly references from the local knowledge base.",
37
- "properties": {
38
- "q": {
39
- "type": "string",
40
- "description": "Natural-language query describing the desired BASIC or assembly guidance.",
41
- "minLength": 3
42
- },
43
- "k": {
44
- "type": [
45
- "integer",
46
- "null"
47
- ],
48
- "description": "Maximum number of references to return (1-12).",
49
- "minimum": 1,
50
- "maximum": 12,
51
- "default": 3
52
- },
53
- "op": {
54
- "const": "asm"
55
- }
56
- },
57
- "required": [
58
- "q",
59
- "op"
12
+ "q": {
13
+ "type": "string",
14
+ "description": "Natural-language query describing the desired BASIC or assembly guidance.",
15
+ "minLength": 3
16
+ },
17
+ "k": {
18
+ "type": [
19
+ "integer",
20
+ "null"
60
21
  ],
61
- "additionalProperties": false
22
+ "description": "Maximum number of references to return (1-12).",
23
+ "minimum": 1,
24
+ "maximum": 12,
25
+ "default": 3
62
26
  }
27
+ },
28
+ "required": [
29
+ "op"
63
30
  ],
64
- "discriminator": {
65
- "propertyName": "op"
66
- }
31
+ "description": "RAG operations available via the c64_rag tool.\n\nOperations:\n- basic: Retrieve BASIC references and snippets from the local knowledge base.\n- asm: Retrieve 6502/6510 assembly references from the local knowledge base.",
32
+ "additionalProperties": false
67
33
  }
package/mcp/schemas/c64_select_backend.schema.json CHANGED
@@ -1,32 +1,25 @@
1
1
  {
2
2
  "type": "object",
3
- "description": "Runtime backend selection operations.",
4
- "oneOf": [
5
- {
6
- "type": "object",
7
- "description": "Switch the active runtime backend without restarting the MCP server.",
8
- "properties": {
9
- "op": {
10
- "const": "select",
11
- "description": "Selects the select operation."
12
- },
13
- "backend": {
14
- "type": "string",
15
- "enum": [
16
- "c64u",
17
- "vice"
18
- ],
19
- "description": "Backend to activate for subsequent tool calls."
20
- }
21
- },
22
- "required": [
23
- "op",
24
- "backend"
3
+ "properties": {
4
+ "op": {
5
+ "type": "string",
6
+ "enum": [
7
+ "select"
25
8
  ],
26
- "additionalProperties": false
9
+ "description": "Selects the operation."
10
+ },
11
+ "backend": {
12
+ "type": "string",
13
+ "enum": [
14
+ "c64u",
15
+ "vice"
16
+ ],
17
+ "description": "Backend to activate for subsequent tool calls."
27
18
  }
19
+ },
20
+ "required": [
21
+ "op"
28
22
  ],
29
- "discriminator": {
30
- "propertyName": "op"
31
- }
23
+ "description": "Runtime backend selection operations.\n\nOperations:\n- select: Switch the active runtime backend without restarting the MCP server.",
24
+ "additionalProperties": false
32
25
  }