@theaileverage/marionette 0.2.2 → 0.3.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.
- package/CHANGELOG.md +9 -0
- package/CONTRIBUTING.md +28 -2
- package/README.md +39 -250
- package/RELEASING.md +13 -11
- package/THIRD_PARTY_NOTICES.md +28 -0
- package/VERIFICATION.md +14 -0
- package/dist/cli.js +37583 -11065
- package/dist/herdr-protocol.d.ts +2 -2
- package/dist/herdr-sdk.d.ts +8 -7
- package/dist/herdr-sdk.js +12 -6
- package/dist/herdr-streams.d.ts +3 -3
- package/dist/herdr-streams.js +7 -3
- package/dist/herdr-transport.d.ts +6 -2
- package/dist/herdr-transport.js +2 -2
- package/dist/mcp.js +24292 -2694
- package/documentation/effect-compatibility.md +56 -0
- package/documentation/effect-runtime.md +73 -0
- package/package.json +36 -23
- package/public/assets/{index-CCfdv-uF.js → index-DhL3znDT.js} +12 -12
- package/public/index.html +1 -1
- package/skills/marionette/SKILL.md +1 -1
- package/skills/marionette/references/herdr-sdk.md +2 -2
- 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-
|
|
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>
|
|
@@ -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 `
|
|
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
|
|
@@ -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 `
|
|
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';
|
|
@@ -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.
|