c64bridge 1.0.0 → 1.0.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 (34) hide show
  1. package/README.md +5 -5
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/c64Client.js +151 -37
  4. package/dist/config.js +18 -10
  5. package/dist/device.js +123 -87
  6. package/dist/knowledge.js +1 -1
  7. package/dist/loggingHttpClient.js +15 -3
  8. package/dist/mcp-server.js +56 -15
  9. package/dist/rag/indexer.js +11 -8
  10. package/dist/rag/init.js +11 -8
  11. package/dist/sidwaveCompiler.js +2 -2
  12. package/dist/tools/audio.js +26 -5
  13. package/dist/tools/input.js +9 -14
  14. package/dist/tools/memory.js +20 -5
  15. package/dist/tools/meta/artifacts.js +20 -8
  16. package/dist/tools/meta/background.js +11 -1
  17. package/dist/tools/pollValidator.js +19 -51
  18. package/dist/tools/printer.js +1 -0
  19. package/dist/tools/registry/platform.js +2 -0
  20. package/dist/tools/registry/printer.js +1 -0
  21. package/dist/vice/mockServer.js +33 -0
  22. package/dist/vice/process.js +11 -1
  23. package/dist/vice/viceClient.js +35 -6
  24. package/doc/reviews/hardening/01-fable/prompt-handover.md +125 -0
  25. package/doc/reviews/hardening/01-fable/prompt.md +98 -0
  26. package/doc/reviews/hardening/01-fable/review-prompt.md +468 -0
  27. package/doc/reviews/hardening/01-fable/review.md +1234 -0
  28. package/mcp/schemas/c64_input.schema.json +5 -5
  29. package/mcp/server.json +1 -1
  30. package/mcp/tools.json +7 -6
  31. package/mcp.json +1 -1
  32. package/package.json +1 -1
  33. package/scripts/mockC64Server.mjs +131 -2
  34. package/server.json +2 -2
package/README.md CHANGED
@@ -18,7 +18,7 @@ Your AI Command Bridge for the Commodore 64.
18
18
 
19
19
  C64 Bridge is an MCP server for controlling and working with a Commodore 64 from an AI client.
20
20
 
21
- It lets you run programs, read and write memory, render graphics, and play sound on a [C64 Ultimate](https://www.commodore.net/), [Ultimate 64](https://ultimate64.com/), or U2-family cartridge. You can also switch to a [VICE](https://vice-emu.sourceforge.io/) emulator session, so one MCP conversation can span hardware and emulation.
21
+ It lets you run programs, read and write memory, render graphics, and play sound on a [C64 Ultimate](https://www.commodore.net/), [Ultimate 64](https://ultimate64.com/), or [U2](https://1541u-documentation.readthedocs.io/en/latest/quick_guide.html)-family cartridge. You can also switch to a [VICE](https://vice-emu.sourceforge.io/) emulator session, so one MCP conversation can span hardware and emulation.
22
22
 
23
23
  It is built on the official TypeScript `@modelcontextprotocol/sdk` and supports both `stdio` for local AI integration and an optional HTTP bridge for manual inspection.
24
24
 
@@ -809,7 +809,7 @@ Cross-platform PETSCII typing plus native Ultimate keyboard and joystick events.
809
809
 
810
810
  | Operation | Description | Required Inputs | Optional Inputs | C64U | U2 | VICE |
811
811
  | --- | --- | --- | --- | --- | --- | --- |
812
- | `joystick` | Simulate joystick input. On C64U/U64 this uses machine:input (a C64U firmware version that provides it, or U64 3.15+); VICE writes CIA1 registers. | `port`, `controls`, `action` | `durationMs=80` | ✅ | | ✅ |
812
+ | `joystick` | Simulate joystick input. On C64U/U64 this uses machine:input; VICE uses Binary Monitor Joyport Set. | `port`, `controls`, `action` | `durationMs=80` | ✅ | | ✅ |
813
813
  | `key` | Tap a single key or hold it for a duration. | `key` | `durationMs=0`, `count=1` | ✅ | ✅ | ✅ |
814
814
  | `keyboard` | Send physical C64 keyboard matrix events through machine:input (a C64U firmware version that provides it, or U64 3.15+). | `inputs`, `transition` | — | ✅ | | |
815
815
  | `release_all` | Release every key and joystick control injected through machine:input (a C64U firmware version that provides it, or U64 3.15+). | — | — | ✅ | | |
@@ -839,9 +839,9 @@ Grouped entry point for Commodore and Epson printing helpers.
839
839
 
840
840
  | Operation | Description | Required Inputs | Optional Inputs | C64U | U2 | VICE |
841
841
  | --- | --- | --- | --- | --- | --- | --- |
842
- | `define_chars` | Define custom printer characters (Commodore DLL mode). | `firstChar`, `chars` | `secondaryAddress` | ✅ | | |
843
- | `print_bitmap` | Print a bitmap row via Commodore (BIM) or Epson ESC/P workflows. | `printer="commodore"`, `columns` | `repeats`, `useSubRepeat`, `secondaryAddress`, `ensureMsb=true`, `mode`, `density`, `timesPerLine` | ✅ | | |
844
- | `print_text` | Generate BASIC that prints text to device 4. | `text` | `target="commodore"`, `secondaryAddress`, `formFeed=false` | ✅ | | |
842
+ | `define_chars` | Define custom printer characters (Commodore DLL mode). | `firstChar`, `chars` | `secondaryAddress` | ✅ | ✅ | |
843
+ | `print_bitmap` | Print a bitmap row via Commodore (BIM) or Epson ESC/P workflows. | `printer="commodore"`, `columns` | `repeats`, `useSubRepeat`, `secondaryAddress`, `ensureMsb=true`, `mode`, `density`, `timesPerLine` | ✅ | ✅ | |
844
+ | `print_text` | Generate BASIC that prints text to device 4. | `text` | `target="commodore"`, `secondaryAddress`, `formFeed=false` | ✅ | ✅ | |
845
845
 
846
846
  #### c64_program
847
847