@mutagent/cli 0.1.337 → 0.1.339

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/README.md CHANGED
@@ -293,6 +293,40 @@ mutagent hooks install
293
293
  mutagent hooks install --cwd ./path # Target a specific directory
294
294
  ```
295
295
 
296
+ ### Managed Agents (`agent`, `helix agent @slug`)
297
+
298
+ A managed agent is a folder whose entry file is `agent.md`: YAML frontmatter,
299
+ then the standing prompt. The base fields (`name`, `description`, `model`,
300
+ `thinking`, `tools`, `disallowed_tools`, `skills`) are a local brief; one
301
+ optional `harness:` block holds the deployment settings (tools, skills, files,
302
+ bindings, runtime). A complete example is in
303
+ [tests/fixtures/agent-deployment](tests/fixtures/agent-deployment).
304
+
305
+ ```bash
306
+ mutagent agent check ./invoice/agent.md
307
+ mutagent agent pack ./invoice/agent.md --output ./invoice.tgz
308
+ mutagent agent run ./invoice/agent.md "Price three widget units."
309
+ mutagent agent deploy ./invoice/agent.md --env prod
310
+ mutagent helix agent @invoice-pricing --env prod -p "Price three widget units."
311
+ mutagent agent inspect invoice-pricing --env prod
312
+ mutagent agent activate invoice-pricing --revision v2 --env prod
313
+ mutagent agent retire invoice-pricing --env prod
314
+ mutagent agent list
315
+ ```
316
+
317
+ - `name` is the slug. `model` is `provider/model`, as `mutagent helix models`
318
+ lists it; deploy and activate refuse a model outside the workspace model list.
319
+ - Each deploy of new content is the next revision (`v1`, `v2`, ...); unchanged
320
+ content reuses its revision. A slot is the agent in one Environment: `--env`
321
+ names it, and no `--env` is the default slot. `--no-activate` stores the
322
+ revision without moving the slot.
323
+ - `mutagent helix agent @slug[:vN|:latest] [--env X] (-p "<task>" | --rpc)` runs
324
+ it in the cloud. The receipt is one JSON line on stderr; its reference is what
325
+ `mutagent helix session` commands take.
326
+ - `agent run` runs a local `agent.md` on this machine with the local Helix binary
327
+ (`MUTAGENT_HELIX_BIN` selects one) and creates nothing in the workspace.
328
+ - Compilation requires Bun 1.3.14 on `PATH` or `MUTAGENT_BUN_BIN`.
329
+
296
330
  ### Lifecycle Meta-Installer (`install`)
297
331
 
298
332
  ```bash