@theaileverage/marionette 0.2.2 → 0.4.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 (23) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/CONTRIBUTING.md +46 -2
  3. package/README.md +60 -232
  4. package/RELEASING.md +13 -11
  5. package/THIRD_PARTY_NOTICES.md +192 -0
  6. package/VERIFICATION.md +24 -0
  7. package/dist/cli.js +44528 -12214
  8. package/dist/herdr-protocol.d.ts +2 -2
  9. package/dist/herdr-sdk.d.ts +8 -7
  10. package/dist/herdr-sdk.js +12 -6
  11. package/dist/herdr-streams.d.ts +3 -3
  12. package/dist/herdr-streams.js +7 -3
  13. package/dist/herdr-transport.d.ts +6 -2
  14. package/dist/herdr-transport.js +2 -2
  15. package/dist/mcp.js +24855 -2702
  16. package/documentation/effect-compatibility.md +56 -0
  17. package/documentation/effect-runtime.md +73 -0
  18. package/package.json +38 -22
  19. package/public/assets/{index-CCfdv-uF.js → index-DhL3znDT.js} +12 -12
  20. package/public/index.html +1 -1
  21. package/skills/marionette/SKILL.md +5 -1
  22. package/skills/marionette/references/herdr-sdk.md +2 -2
  23. package/vendor/herdr-0.9.0/README.md +0 -5
package/public/index.html CHANGED
@@ -5,7 +5,7 @@
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
6
  <meta name="theme-color" content="#182a29" />
7
7
  <title>Marionette · Project control</title>
8
- <script type="module" crossorigin src="/assets/index-CCfdv-uF.js"></script>
8
+ <script type="module" crossorigin src="/assets/index-DhL3znDT.js"></script>
9
9
  <link rel="stylesheet" crossorigin href="/assets/index-Dfuji944.css">
10
10
  </head>
11
11
  <body>
package/skills/marionette/SKILL.md CHANGED
@@ -11,7 +11,7 @@ Marionette is a persistent supervisor for agent CLIs in Herdr. Leads use a fence
11
11
 
12
12
  Prefer connected Marionette MCP tools. MCP names use underscores (`project_briefing`); CLI action names use dots (`project.briefing`). Read the tool's input schema before constructing a call.
13
13
 
14
- For CLI access, use the installed `marionette`, or `node /absolute/package/dist/cli.js` for a source build. Commands discover the project binding from the working directory; pass `--home /absolute/state/directory` for a selected instance. Start with:
14
+ For CLI access, use the installed `marionette`, or `bun /absolute/package/dist/cli.js` for a source build. Commands discover the project binding from the working directory; pass `--home /absolute/state/directory` for a selected instance. Start with:
15
15
 
16
16
  ```sh
17
17
  marionette projects
@@ -23,6 +23,10 @@ Read the selected project's briefing, decisions, outstanding questions, and inbo
23
23
 
24
24
  If setup is needed, `marionette setup --schema` and `setup --help` describe the installed options. `setup --json --project /absolute/project --lead codex-desktop --lead-name NAME` creates/reuses the named session, supervisor and project binding and configures the selected lead. Setup's `--dry-run` previews its effects. Preserve an existing installation and saved lead. `doctor` diagnoses connections; deleting state is not a recovery step.
25
25
 
26
+ `marionette update --check` reports available updates; `update` and `upgrade` update the shared instance and its project bindings/MCP registrations, with rollback on startup failure. Setup offers migration for an older saved runtime; scripted setup requires `--upgrade`. Workspace trust is the general `trustWorkspaces` option for Codex, Claude Code, and AGY; `--no-trust-workspaces` retains native workspace prompts without changing tool approvals.
27
+
28
+ For user-requested removal, inspect `remove --dry-run` or `uninstall --dry-run --global` first. `remove` targets the current project (`--project DIR` or `--project-id ID` selects another); `uninstall` removes the selected instance, with `--global` also removing detected Bun/npm CLI installs. Source files and Git branches are preserved. Resolve active tasks, pending operations, and managed worktrees first. Closing verified agent panes requires explicit `--stop-agents`; `--keep-herdr` retains terminal resources. Noninteractive deletion requires `--yes`. Never use removal as a repair shortcut.
29
+
26
30
  ## Lead workflow
27
31
 
28
32
  Read a supplied bootstrap prompt and private lease file locally. Keep the token out of prose, artifacts, and logs. A CLI mutation accepts `--lease /private/path/lead.json`; an MCP mutation accepts the equivalent `lease` object. Acquire control only for initial establishment or an authorized takeover. `lead_handover` / `lead.handover` transfers the lease and invalidates the old one. Do not take over merely because another lead is quiet.
package/skills/marionette/references/herdr-sdk.md CHANGED
@@ -4,11 +4,11 @@
4
4
 
5
5
  The SDK targets the installed Herdr **0.9.0, protocol 22** schema. It exposes all **102 schema-defined methods**, plus the documented `pane.graphics.stream` transport omitted by upstream's exported schema. This includes workspace, worktree, tab, pane, layout, agent, event, integration, plugin, notification, client, and server APIs. The full surface uses `api[method](params, options?)`; the short helpers below remain conveniences for common operations.
6
6
 
7
- The vendored schema and generated types are reproducible with `npm run sdk:generate` in the Marionette source checkout. Coverage tests exercise every method through an isolated Unix-socket peer, plus streaming success/failure cases. A separate live 0.9.0 server/client check verified emitted RGB/RGBA/BGRA/PNG payloads, file-frame acknowledgements, placement, replacement, and layer removal using a simulated Kitty-capable terminal. See `VERIFICATION.md` in the package for evidence and limits; this does not validate every server-side operation or the native terminal display. Herdr still enforces semantic constraints, installed plugins, and client/graphics capabilities. Existing Marionette pane and agent methods also remain schema-compatible with 0.8.2/protocol 20.
7
+ The vendored schema and generated types are reproducible with `bun run sdk:generate` in the Marionette source checkout. Coverage tests exercise every method through an isolated Unix-socket peer, plus streaming success/failure cases. A separate live 0.9.0 server/client check verified emitted RGB/RGBA/BGRA/PNG payloads, file-frame acknowledgements, placement, replacement, and layer removal using a simulated Kitty-capable terminal. See `VERIFICATION.md` in the package for evidence and limits; this does not validate every server-side operation or the native terminal display. Herdr still enforces semantic constraints, installed plugins, and client/graphics capabilities. Existing Marionette pane and agent methods also remain schema-compatible with 0.8.2/protocol 20.
8
8
 
9
9
  The [Socket API documentation](https://herdr.dev/docs/socket-api/) describes the server contract. In 0.9.0, multiple clients can size tabs independently, so read current pane geometry before splitting.
10
10
 
11
- After installing a build of Marionette containing the SDK, import its ESM subpath in Node.js 22.13+:
11
+ After installing a build of Marionette containing the SDK, import its ESM subpath in Bun 1.3.14+ (the standalone SDK also supports Node.js 22.13+):
12
12
 
13
13
  ```js
14
14
  import { HerdrClient, HerdrError } from '@theaileverage/marionette/herdr-sdk';
package/vendor/herdr-0.9.0/README.md DELETED
@@ -1,5 +0,0 @@
1
- # Herdr 0.9.0 socket schema
2
-
3
- `api.schema.json` is the unmodified output of `herdr api schema --json` from the installed Herdr 0.9.0 binary (protocol 22). The corresponding upstream release is https://github.com/herdrdev/herdr/tree/v0.9.0. The upstream Apache-2.0 license is retained in `LICENSE`.
4
-
5
- Marionette generates TypeScript declarations and its method registry with `npm run sdk:generate`. The generated types describe wire structure; Herdr enforces numeric ranges, feature availability, and other semantic constraints. The documented `pane.graphics.stream` transport is handled separately because upstream omits it from this JSON schema; its contract comes from `src/api/schema/panes.rs` and `src/api/server/pane_graphics_stream.rs` at the same tag.