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/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
  }