laive-mcp 0.1.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 (67) hide show
  1. package/AGENTS.md +48 -0
  2. package/CHANGELOG.md +13 -0
  3. package/LICENSE +674 -0
  4. package/README.md +219 -0
  5. package/bin/laive.mjs +340 -0
  6. package/package.json +66 -0
  7. package/packages/als-parser/src/index.js +2 -0
  8. package/packages/als-parser/src/read.js +16 -0
  9. package/packages/als-parser/src/summarize.js +116 -0
  10. package/packages/common/src/index.js +3 -0
  11. package/packages/common/src/jsonl.js +41 -0
  12. package/packages/common/src/protocol.js +94 -0
  13. package/packages/common/src/validation.js +121 -0
  14. package/packages/live-bridge-remote-script/README.md +22 -0
  15. package/packages/live-bridge-remote-script/python/laive/__init__.py +7 -0
  16. package/packages/live-bridge-remote-script/python/laive/control_surface.py +208 -0
  17. package/packages/live-bridge-remote-script/python/laive/fake_live.py +168 -0
  18. package/packages/live-bridge-remote-script/python/laive/listeners.py +46 -0
  19. package/packages/live-bridge-remote-script/python/laive/live_access.py +272 -0
  20. package/packages/live-bridge-remote-script/python/laive/protocol.py +87 -0
  21. package/packages/live-bridge-remote-script/python/laive/server.py +130 -0
  22. package/packages/live-bridge-remote-script/python/laive/task_queue.py +47 -0
  23. package/packages/live-bridge-remote-script/src/bridge/client.js +113 -0
  24. package/packages/live-bridge-remote-script/src/bridge/server.js +189 -0
  25. package/packages/live-bridge-remote-script/src/cli/client.js +75 -0
  26. package/packages/live-bridge-remote-script/src/cli/server.js +51 -0
  27. package/packages/live-bridge-remote-script/src/fixtures/default-live-set.json +113 -0
  28. package/packages/live-bridge-remote-script/src/index.js +3 -0
  29. package/packages/live-bridge-remote-script/src/runtime/fixture-runtime.js +356 -0
  30. package/packages/live-sidecar-m4l/README.md +45 -0
  31. package/packages/live-sidecar-m4l/device/laive-sidecar.amxd +0 -0
  32. package/packages/live-sidecar-m4l/project/code/laive-sidecar-node.js +149 -0
  33. package/packages/live-sidecar-m4l/project/data/laive-sidecar.manifest.json +8 -0
  34. package/packages/live-sidecar-m4l/project/laive-sidecar.maxproj +36 -0
  35. package/packages/live-sidecar-m4l/project/patchers/laive-sidecar.maxpat +172 -0
  36. package/packages/live-sidecar-m4l/src/contracts.js +35 -0
  37. package/packages/live-sidecar-m4l/src/index.js +19 -0
  38. package/packages/live-sidecar-m4l/src/install-sidecar-device.js +15 -0
  39. package/packages/live-sidecar-m4l/src/package-sidecar.js +5 -0
  40. package/packages/live-sidecar-m4l/src/project.js +132 -0
  41. package/packages/live-sidecar-m4l/src/runtime.js +96 -0
  42. package/packages/live-sidecar-m4l/src/workflows.js +95 -0
  43. package/packages/mcp-server/src/cli.js +113 -0
  44. package/packages/mcp-server/src/default-tools.js +253 -0
  45. package/packages/mcp-server/src/errors.js +24 -0
  46. package/packages/mcp-server/src/index.js +10 -0
  47. package/packages/mcp-server/src/server.js +96 -0
  48. package/packages/mcp-server/src/session.js +475 -0
  49. package/packages/mcp-server/src/tool-registry.js +41 -0
  50. package/packages/state-engine/src/engine.js +566 -0
  51. package/packages/state-engine/src/ids.js +57 -0
  52. package/packages/state-engine/src/index.js +40 -0
  53. package/packages/state-engine/src/normalize.js +357 -0
  54. package/packages/state-engine/src/queries.js +154 -0
  55. package/packages/state-engine/src/replay.js +60 -0
  56. package/packages/ui-automation/src/executor.js +87 -0
  57. package/packages/ui-automation/src/guards.js +21 -0
  58. package/packages/ui-automation/src/helper.js +186 -0
  59. package/packages/ui-automation/src/index.js +20 -0
  60. package/packages/ui-automation/src/macos.js +82 -0
  61. package/packages/ui-automation/src/package-ui-helper.js +5 -0
  62. package/packages/ui-automation/src/workflows.js +72 -0
  63. package/scripts/install-remote-script.py +7 -0
  64. package/scripts/install-ui-helper.mjs +14 -0
  65. package/scripts/package-remote-script.py +7 -0
  66. package/scripts/package-ui-helper.mjs +4 -0
  67. package/scripts/remote_script_tooling.py +253 -0
package/AGENTS.md ADDED
@@ -0,0 +1,48 @@
1
+ # AGENTS
2
+
3
+ This repository uses a simple release discipline. Agents working here must follow it.
4
+
5
+ This file is maintainer-only guidance. It is not part of the end-user install flow.
6
+
7
+ ## Changelog
8
+
9
+ - Any user-visible change must add or update a bullet under `## Unreleased` in [CHANGELOG.md](./CHANGELOG.md).
10
+ - User-visible means CLI behavior, installer behavior, MCP configuration, shipped assets, manual setup steps, supported Live behavior, or docs that change how operators use the system.
11
+ - Purely internal refactors that do not change behavior may skip the changelog.
12
+
13
+ ## Semver
14
+
15
+ - `major`: breaking changes to CLI flags, installer behavior, MCP tool surface, shipped artifact layout, or required manual steps.
16
+ - `minor`: new end-user commands, new install automation, new sidecar/helper delivery, or new supported workflows.
17
+ - `patch`: bug fixes, non-breaking behavior fixes, docs clarifications, and internal maintenance.
18
+
19
+ ## Release Prep
20
+
21
+ - Do not cut a release unless the user explicitly asks.
22
+ - Default to dry-run for release tooling.
23
+ - Use the root repo version in `package.json` as the canonical release version.
24
+ - Keep workspace package versions in lockstep with the root version.
25
+ - Before preparing a release, run:
26
+ - `npm test`
27
+ - `npm run test:python`
28
+ - `npm run test:delivery`
29
+ - `node ./bin/laive.mjs doctor --json`
30
+ - `node ./bin/laive.mjs package --json`
31
+ - `node ./bin/laive.mjs install --json`
32
+ - `npm pack --dry-run`
33
+
34
+ ## Release Mechanics
35
+
36
+ - Use `node ./scripts/release.mjs prepare <patch|minor|major>` for dry-run planning.
37
+ - Use `node ./scripts/release.mjs prepare <patch|minor|major> --apply` to update versions and finalize the changelog.
38
+ - Release commit format: `chore(release): vX.Y.Z`
39
+ - Release tag format: `vX.Y.Z`
40
+
41
+ ## Compatibility And Docs
42
+
43
+ - If install flow or support posture changes, update:
44
+ - `README.md`
45
+ - `docs/quickstart.md`
46
+ - `docs/operator-checklist-macos.md`
47
+ - `docs/compatibility-matrix.md` when compatibility claims change
48
+ - `agent-plans/progress.md` when plan state materially changes
package/CHANGELOG.md ADDED
@@ -0,0 +1,13 @@
1
+ # Changelog
2
+
3
+ ## Unreleased
4
+
5
+ ## v0.1.0 - 2026-03-22
6
+
7
+ - Renamed the published npm package from `laive` to `laive-mcp` because `laive` is already taken on npm. The Ableton-side control surface name remains `laive`.
8
+ - Corrected the npm `bin` metadata so the published package exposes a valid executable entrypoint.
9
+ - Set the published project license to `GPL-3.0-only` and added the repository `LICENSE` file.
10
+ - Added stable default installation targets for `~/Applications/laive-ui-helper.app` and the Ableton User Library MIDI effect path.
11
+ - Added shipping and staging for the prebuilt `laive-sidecar.amxd` device.
12
+ - Added `laive mcp-config` for local and published MCP client configuration output.
13
+ - Added publish and release tooling, including `AGENTS.md`, `scripts/release.mjs`, and `scripts/version-workspaces.mjs`.