c64bridge 0.8.1 → 0.9.1

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 (92) hide show
  1. package/.github/prompts/steer.prompt.md +55 -0
  2. package/AGENTS.md +9 -7
  3. package/README.md +192 -154
  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 +938 -0
  12. package/dist/.tsbuildinfo +1 -1
  13. package/dist/c64Client.js +76 -2
  14. package/dist/device.js +129 -13
  15. package/dist/mcp-server.js +1 -1
  16. package/dist/prompts/registry.js +27 -25
  17. package/dist/rag/indexer.js +18 -8
  18. package/dist/rag/knowledgeIndex.js +112 -79
  19. package/dist/rag/resourceUris.js +93 -0
  20. package/dist/sidwaveCompiler.js +1 -1
  21. package/dist/{assemblyConverter.js → tools/assember.js} +10 -1
  22. package/dist/tools/audio.js +11 -11
  23. package/dist/{basicConverter.js → tools/basicTokenizer.js} +1 -1
  24. package/dist/tools/debug.js +159 -6
  25. package/dist/tools/developer.js +13 -13
  26. package/dist/tools/disassembler.js +478 -0
  27. package/dist/tools/graphics.js +10 -10
  28. package/dist/tools/input.js +338 -0
  29. package/dist/tools/machineControl.js +5 -5
  30. package/dist/tools/memory.js +336 -12
  31. package/dist/tools/meta/index.js +1 -1
  32. package/dist/tools/printer.js +11 -12
  33. package/dist/tools/programRunners.js +61 -22
  34. package/dist/tools/rag.js +9 -9
  35. package/dist/tools/registry/batch.js +167 -0
  36. package/dist/tools/registry/config.js +1 -1
  37. package/dist/tools/registry/disk.js +1 -1
  38. package/dist/tools/registry/drive.js +1 -1
  39. package/dist/tools/registry/extract.js +1 -1
  40. package/dist/tools/registry/graphics.js +102 -2
  41. package/dist/tools/registry/index.js +4 -0
  42. package/dist/tools/registry/input.js +2 -0
  43. package/dist/tools/registry/memory.js +62 -2
  44. package/dist/tools/registry/platform.js +1 -1
  45. package/dist/tools/registry/printer.js +1 -1
  46. package/dist/tools/registry/program.js +1 -1
  47. package/dist/tools/registry/rag.js +1 -1
  48. package/dist/tools/registry/sound.js +1 -1
  49. package/dist/tools/registry/stream.js +1 -1
  50. package/dist/tools/registry/system.js +1 -1
  51. package/dist/tools/schema.js +4 -5
  52. package/dist/tools/storage.js +15 -15
  53. package/dist/tools/streaming.js +3 -3
  54. package/dist/tools/symbolRegistry.js +49 -0
  55. package/dist/tools/types.js +56 -4
  56. package/dist/tools/vice.js +2 -5
  57. package/dist/vice/process.js +120 -2
  58. package/dist/vice/readiness.js +35 -0
  59. package/dist/vice/smokeOptions.js +44 -0
  60. package/dist/vice/viceClient.js +5 -1
  61. package/dist/viceRunner.js +2 -0
  62. package/doc/plans/prompts/README.md +7 -7
  63. package/mcp/prompts.json +42 -59
  64. package/mcp/protocol-examples.json +2 -2
  65. package/mcp/resources.json +179 -166
  66. package/mcp/schemas/c64_batch.schema.json +53 -0
  67. package/mcp/schemas/c64_config.schema.json +525 -283
  68. package/mcp/schemas/c64_debug.schema.json +763 -304
  69. package/mcp/schemas/c64_disk.schema.json +499 -243
  70. package/mcp/schemas/c64_drive.schema.json +165 -90
  71. package/mcp/schemas/c64_extract.schema.json +533 -274
  72. package/mcp/schemas/c64_graphics.schema.json +607 -295
  73. package/mcp/schemas/c64_input.schema.json +136 -0
  74. package/mcp/schemas/c64_memory.schema.json +637 -128
  75. package/mcp/schemas/c64_printer.schema.json +393 -196
  76. package/mcp/schemas/c64_program.schema.json +699 -340
  77. package/mcp/schemas/c64_rag.schema.json +100 -54
  78. package/mcp/schemas/c64_select_backend.schema.json +49 -23
  79. package/mcp/schemas/c64_sound.schema.json +1092 -577
  80. package/mcp/schemas/c64_stream.schema.json +89 -47
  81. package/mcp/schemas/c64_system.schema.json +351 -185
  82. package/mcp/schemas/c64_vice.schema.json +85 -47
  83. package/mcp/server.json +1 -1
  84. package/mcp/tools.json +7299 -3346
  85. package/mcp.json +3 -3
  86. package/package.json +17 -14
  87. package/scripts/fetch-external-sources.mjs +1 -2
  88. package/scripts/run-coverage.mjs +33 -1
  89. package/scripts/run-tests.mjs +2 -2
  90. package/scripts/run-tests.ts +275 -52
  91. package/scripts/update-readme.ts +132 -3
  92. package/server.json +2 -2
package/mcp/schemas/c64_stream.schema.json CHANGED
@@ -1,61 +1,103 @@
1
1
  {
2
2
  "type": "object",
3
- "description": "Streaming operations available via the c64_stream tool.",
4
- "oneOf": [
3
+ "properties": {
4
+ "op": {
5
+ "type": "string",
6
+ "enum": [
7
+ "start",
8
+ "stop"
9
+ ],
10
+ "description": "Selects the operation."
11
+ },
12
+ "stream": {
13
+ "type": "string",
14
+ "description": "Stream type to control (video/audio/debug).",
15
+ "enum": [
16
+ "video",
17
+ "audio",
18
+ "debug"
19
+ ]
20
+ },
21
+ "target": {
22
+ "type": "string",
23
+ "description": "Destination host:port or UDP target understood by the firmware.",
24
+ "minLength": 3
25
+ }
26
+ },
27
+ "required": [
28
+ "op"
29
+ ],
30
+ "description": "Streaming operations available via the c64_stream tool.\n\nOperations:\n- start: Start an Ultimate streaming session toward a host:port target. Required inputs: stream, target.\n- stop: Stop an active Ultimate streaming session. Required inputs: stream.",
31
+ "additionalProperties": false,
32
+ "x-c64bridge-operations": [
5
33
  {
6
- "type": "object",
34
+ "op": "start",
7
35
  "description": "Start an Ultimate streaming session toward a host:port target.",
8
- "properties": {
9
- "stream": {
10
- "type": "string",
11
- "description": "Stream type to control (video/audio/debug).",
12
- "enum": [
13
- "video",
14
- "audio",
15
- "debug"
16
- ]
17
- },
18
- "target": {
19
- "type": "string",
20
- "description": "Destination host:port or UDP target understood by the firmware.",
21
- "minLength": 3
22
- },
23
- "op": {
24
- "const": "start"
25
- }
26
- },
27
36
  "required": [
28
37
  "stream",
29
- "target",
30
- "op"
38
+ "target"
31
39
  ],
32
- "additionalProperties": false
40
+ "optional": [],
41
+ "inputSchema": {
42
+ "type": "object",
43
+ "description": "Start an Ultimate streaming session toward a host:port target.",
44
+ "properties": {
45
+ "stream": {
46
+ "type": "string",
47
+ "description": "Stream type to control (video/audio/debug).",
48
+ "enum": [
49
+ "video",
50
+ "audio",
51
+ "debug"
52
+ ]
53
+ },
54
+ "target": {
55
+ "type": "string",
56
+ "description": "Destination host:port or UDP target understood by the firmware.",
57
+ "minLength": 3
58
+ },
59
+ "op": {
60
+ "const": "start"
61
+ }
62
+ },
63
+ "required": [
64
+ "stream",
65
+ "target",
66
+ "op"
67
+ ],
68
+ "additionalProperties": false
69
+ }
33
70
  },
34
71
  {
35
- "type": "object",
72
+ "op": "stop",
36
73
  "description": "Stop an active Ultimate streaming session.",
37
- "properties": {
38
- "stream": {
39
- "type": "string",
40
- "description": "Stream type to control (video/audio/debug).",
41
- "enum": [
42
- "video",
43
- "audio",
44
- "debug"
45
- ]
46
- },
47
- "op": {
48
- "const": "stop"
49
- }
50
- },
51
74
  "required": [
52
- "stream",
53
- "op"
75
+ "stream"
54
76
  ],
55
- "additionalProperties": false
77
+ "optional": [],
78
+ "inputSchema": {
79
+ "type": "object",
80
+ "description": "Stop an active Ultimate streaming session.",
81
+ "properties": {
82
+ "stream": {
83
+ "type": "string",
84
+ "description": "Stream type to control (video/audio/debug).",
85
+ "enum": [
86
+ "video",
87
+ "audio",
88
+ "debug"
89
+ ]
90
+ },
91
+ "op": {
92
+ "const": "stop"
93
+ }
94
+ },
95
+ "required": [
96
+ "stream",
97
+ "op"
98
+ ],
99
+ "additionalProperties": false
100
+ }
56
101
  }
57
- ],
58
- "discriminator": {
59
- "propertyName": "op"
60
- }
102
+ ]
61
103
  }