car-runtime 0.58.0 → 0.59.0-nightly.20261016

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 (3) hide show
  1. package/docs/CLI.md +41 -130
  2. package/index.d.ts +9 -3
  3. package/package.json +1 -1
package/docs/CLI.md CHANGED
@@ -2,26 +2,26 @@
2
2
 
3
3
  > **Generated file — do not hand-edit below the task map.** Produced by
4
4
  > `scripts/gen-cli-docs.sh` from `car --help` / `car help <command>` on car
5
- > 0.58.0 (2026-10-16). Every subcommand the installed binary reports is
5
+ > 0.57.0-nightly.20261009 (2026-10-09). Every subcommand the installed binary reports is
6
6
  > below; a new subcommand cannot ship without appearing here the next time
7
7
  > this script runs. To regenerate: `bash scripts/gen-cli-docs.sh`.
8
8
  >
9
- > 80 top-level commands, 159 nested subcommands
9
+ > 79 top-level commands, 158 nested subcommands
10
10
  > (one level deep) — counted from the live binary at generation time, not
11
11
  > typed by hand.
12
12
 
13
13
  ## Finding your way around
14
14
 
15
- `car` is one binary with 80 subcommands spanning several different jobs:
15
+ `car` is one binary with 79 subcommands spanning several different jobs:
16
16
  running the built-in agent, coding, local model management, OS integrations,
17
17
  and installing other people's agents on your machine. This map groups the
18
18
  commands people actually reach for; the full alphabetical reference with every
19
19
  flag follows below.
20
20
 
21
21
  A release-lab build appends its compile-time identity to version output, for
22
- example `car 0.57.0 (build 20261008-7fdc72e)`. The `car-server`,
23
- `car-host`, and `car-mcp` binaries report the same ID. Ordinary builds
24
- without `CAR_BUILD_ID` keep the shorter `name version` form.
22
+ example `car 0.57.0 (build 20261008-7fdc72e)`. The `car-server`, `car-host`, and
23
+ `car-mcp` binaries report the same ID. Ordinary builds without `CAR_BUILD_ID`
24
+ keep the shorter `name version` form.
25
25
 
26
26
  ### Run an agent
27
27
 
@@ -210,10 +210,10 @@ commands on a cadence via launchd / cron / schtasks).
210
210
  | [`car init`](#car-init) | Initialize a .car/ project directory for team-shared configuration |
211
211
  | [`car doctor`](#car-doctor) | Diagnose (and optionally repair) a CAR install: corrupt model weights, unparseable `~/.car` state files, version skew, and leftover files from a previous install. Runs entirely against the local filesystem — no daemon required, so it works even when `car-server` won't start |
212
212
  | [`car feedback`](#car-feedback) | Report a problem to Parslee. Captures a redacted diagnostic bundle (your description, the `car doctor` report, bounded log tails, and a version stamp) into the local outbox at `~/.car/feedback-outbox` — nothing is uploaded by this command; queued reports send when CAR can reach Parslee. Works with the daemon down, like `car doctor`. macOS and Windows; Linux needs its own leak-path audit first |
213
- | [`car update`](#car-update) | Update the locally-installed `car` CLI and its sibling `car-server` daemon to the latest release (or `--version <X.Y.Z>`), in place — regardless of how they were installed. Reconciles the drift that otherwise builds up when one channel updates and another doesn't (e.g. CarHost.app auto-updates its bundled daemon via Sparkle but leaves the `/usr/local/bin/car` CLI behind). The npm/PyPI `car-runtime` client packages are separate — this command never touches them; `car doctor` reports which of your agents have drifted, and prints the exact command per environment. Both remedies pin: `npm install car-runtime@<version>` (`npm update` CANNOT cross a 0.x minor — npm reads `^0.41.0` as `>=0.41.0 <0.42.0`, so it is a no-op) and `<venv>/bin/python -m pip install -U car-runtime==<version>` (a bare `-U` can be silently defeated by the consumer's own pin, and the wrong interpreter installs into an environment that does not hold the stale wheel). On macOS it also creates the `car-mcp` link beside a `car` that links into CarHost.app (or replaces a dangling / wrong-bundle one): Sparkle never re-runs the package postinstall, so an install that predates `car-mcp` lacks it |
213
+ | [`car update`](#car-update) | Update the locally-installed `car` CLI and its sibling `car-server` daemon to the latest release (or `--version <X.Y.Z>`), in place — regardless of how they were installed. Reconciles the drift that otherwise builds up when one channel updates and another doesn't (e.g. CarHost.app auto-updates its bundled daemon via Sparkle but leaves the `/usr/local/bin/car` CLI behind). The npm/PyPI `car-runtime` client packages are separate — this command never touches them; `car doctor` reports which of your agents have drifted, and prints the exact command per environment. Both remedies pin: `npm install car-runtime@<version>` (`npm update` CANNOT cross a 0.x minor — npm reads `^0.41.0` as `>=0.41.0 <0.42.0`, so it is a no-op) and `<venv>/bin/python -m pip install -U car-runtime==<version>` (a bare `-U` can be silently defeated by the consumer's own pin, and the wrong interpreter installs into an environment that does not hold the stale wheel) |
214
214
  | [`car purge`](#car-purge) | Remove this CAR install's own state under `~/.car` (config, logs, managed models, binaries) and reap any OS-level schedules CAR installed — for a clean slate before a reinstall. On macOS this also clears CarHost.app's user-level state and resets its privacy (TCC) permissions, so a reinstall really does re-run permission onboarding. NEVER touches the shared HuggingFace model cache (other tools use it); managed models are symlinks into it, so only the links are removed, not the multi-GB blobs. (To uninstall a single contributed agent instead, use `car uninstall <id>`.) |
215
215
  | [`car code`](#car-code) | Open a coding conversation in your repository. Ask questions, plan a change, or describe work to implement; review the checks and edits, then keep iterating in the same conversation |
216
- | [`car board`](#car-board) | Fullscreen supervision board for coder sessions — one screen for every run on this host, whoever started it (`car code`, CarHost, milo, another board). Attach to a run's full history, confirm its outcome contract, answer its questions, approve its diff, or scope work in a repo-grounded discussion first. It shows and acts on every run, authenticating with CAR's local host key; a board launched by an agent cannot. Closing the board never stops a run |
216
+ | [`car board`](#car-board) | Fullscreen supervision board for coder sessions — one screen for every run on this host, whoever started it (`car code`, CarHost, milo, another board). Attach to a run's full history, confirm its outcome contract, answer its questions, approve its diff, or scope work in a repo-grounded discussion first. Closing the board never stops a run |
217
217
  | [`car do`](#car-do) | CAR Assistant: a general-purpose agent that works out of the box |
218
218
  | [`car policy-check-hook`](#car-policy-check-hook) | Evaluate a host's proposed tool call against `.car/policies/` and answer on stdout with that host's hook decision envelope |
219
219
  | [`car project`](#car-project) | Manage CAR-managed projects (a named, git-backed workspace CAR creates for you — no repo to pick) |
@@ -253,7 +253,6 @@ commands on a cadence via launchd / cron / schtasks).
253
253
  | [`car registry`](#car-registry) | Registry tooling for the contributed-agents registry (Parslee-ai/car#182 phase 5): `digest` a manifest, or `validate` a registry directory (the CI gate run by Parslee-ai/car-agent-registry) |
254
254
  | [`car fleet`](#car-fleet) | What every CAR instance you can reach can do — agents, capabilities and models across the fleet — and whether this machine takes coding subtasks farmed out by peers (`car fleet enroll`). Needs a running daemon |
255
255
  | [`car mp`](#car-mp) | Multiplayer development: a work item moves Build → Improve → Polish through different developers before it merges, each stage a coder session on its owner's machine with the engine they choose. Needs a running daemon and a shared git remote |
256
- | [`car claude`](#car-claude) | Start Claude Code as a CAR-supervised collaboration session. Enrolls a per-session agent bound to the work context `car auth resolve` names for this directory, hands its identity to the CAR plugin's collaboration tools, runs `claude` in this terminal, and removes the agent when it exits. Arguments after `--` go to `claude`. Needs a running daemon |
257
256
  | [`car publish`](#car-publish) | Publish a contributed agent to the registry (Parslee-ai/car#182 phase 5). Reads a local agent's `manifest.toml`, signs it for `--audience public` (ed25519 key at `$CAR_PUBLISH_KEY_PATH`), stages it at the versioned `agents/<namespace>/<name>/<version>/` path, updates `index.json` + the README catalog, re-runs the EXACT `car registry validate` CI gate locally, and opens a PR against the registry repo. Aborts (no PR) on a missing signing key or a validation failure |
258
257
  | [`car help`](#car-help) | Print this message or the help of the given subcommand(s) |
259
258
 
@@ -286,7 +285,7 @@ Options:
286
285
  --json Emit machine-readable JSON
287
286
  --md Emit generated Markdown (the default)
288
287
  --role <ROLE> Print exactly the daemon method names assigned to this caller role [possible
289
- values: agent, owner, operator, operator_only, host]
288
+ values: agent, owner, operator, host]
290
289
  -h, --help Print help
291
290
  ```
292
291
 
@@ -670,8 +669,7 @@ Re-score one delivered attempt without starting a coding session
670
669
  Usage: car coder-ab rescore [OPTIONS] --attempt <ATTEMPT> --corpus <CORPUS>
671
670
 
672
671
  Options:
673
- --attempt <ATTEMPT> Existing `<ledger-dir>/artifacts/ledgers/<ledger
674
- stem>/<task-id>/<attempt>` (or legacy `<ledger-dir>/artifacts/<task-id>/<attempt>`) directory
672
+ --attempt <ATTEMPT> Existing `<ledger-dir>/artifacts/ledgers/<ledger stem>/<task-id>/<attempt>` (or legacy `<ledger-dir>/artifacts/<task-id>/<attempt>`) directory
675
673
  --corpus <CORPUS> Corpus manifest containing the task named by the source ledger row
676
674
  --ledger <LEDGER> Owning ledger. Omit to discover it from the attempt artifact layout
677
675
  -h, --help Print help
@@ -1195,9 +1193,7 @@ Commands:
1195
1193
  --json` prints) from FILE, or stdin. Prints JSON. The verdict is the recommendation estimate
1196
1194
  `models.list_unified` shows, which sizes the KV cache from an installed checkpoint's own KV
1197
1195
  geometry, as load-time admission does, and from the parameter count for a row not installed;
1198
- admission also uses the machine's live state, so it can differ. `platform_compatible` is false for
1199
- a row CAR does not run on Apple Silicon at any size (a GGUF/Candle row, say), and its
1200
- `smallest_mac_gb` is then null whatever the memory verdict
1196
+ admission also uses the machine's live state, so it can differ
1201
1197
  register Register a custom model from a JSON schema file
1202
1198
  unregister Unregister a model by ID
1203
1199
  stats Show performance stats for models based on observed outcomes
@@ -1910,9 +1906,8 @@ Usage: car doctor [OPTIONS]
1910
1906
 
1911
1907
  Options:
1912
1908
  --repair Apply safe repairs: purge corrupt cache files (re-pull afterward), back up
1913
- unparseable state files, refresh the version stamp, and (on macOS) link a missing, dangling,
1914
- or wrong-bundle `car-mcp` beside a bundle-linked `car`. Never deletes unrecognized entries or
1915
- anything not provably corrupt, and never overwrites a regular file
1909
+ unparseable state files, refresh the version stamp. Never deletes unrecognized entries or
1910
+ anything not provably corrupt
1916
1911
  --deep Deep-verify model weights (recompute sha256 vs the HuggingFace etag) instead of the
1917
1912
  cheap presence/non-empty check. Slower but catches truncated-but-non-empty corruption
1918
1913
  -h, --help Print help
@@ -1950,10 +1945,7 @@ which of your agents have drifted, and prints the exact command per environment.
1950
1945
  `npm install car-runtime@<version>` (`npm update` CANNOT cross a 0.x minor — npm reads `^0.41.0` as
1951
1946
  `>=0.41.0 <0.42.0`, so it is a no-op) and `<venv>/bin/python -m pip install -U
1952
1947
  car-runtime==<version>` (a bare `-U` can be silently defeated by the consumer's own pin, and the
1953
- wrong interpreter installs into an environment that does not hold the stale wheel). On macOS it also
1954
- creates the `car-mcp` link beside a `car` that links into CarHost.app (or replaces a dangling /
1955
- wrong-bundle one): Sparkle never re-runs the package postinstall, so an install that predates
1956
- `car-mcp` lacks it
1948
+ wrong interpreter installs into an environment that does not hold the stale wheel)
1957
1949
 
1958
1950
  Usage: car update [OPTIONS]
1959
1951
 
@@ -2097,8 +2089,7 @@ opens saved conversations. The exit summary prints the resume command.
2097
2089
  Fullscreen supervision board for coder sessions — one screen for every run on this host, whoever
2098
2090
  started it (`car code`, CarHost, milo, another board). Attach to a run's full history, confirm its
2099
2091
  outcome contract, answer its questions, approve its diff, or scope work in a repo-grounded
2100
- discussion first. It shows and acts on every run, authenticating with CAR's local host key; a board
2101
- launched by an agent cannot. Closing the board never stops a run
2092
+ discussion first. Closing the board never stops a run
2102
2093
 
2103
2094
  Usage: car board [OPTIONS]
2104
2095
 
@@ -2232,18 +2223,6 @@ Options:
2232
2223
 
2233
2224
  [default: 20]
2234
2225
 
2235
- --org <ORG>
2236
- Work in this organization (one a signed-in login holds). Omitted, the run binds the
2237
- repository's declared org, else your default org (`car auth default-org`), else runs as
2238
- personal work. Its memory, learned repairs, trajectories and receipts stay in that org's
2239
- private store, and your own-account tools (Mail, Calendar, M365, Studio, automation,
2240
- iMessage) are left out. Needs the daemon. Not with --serve: a served agent's organization
2241
- is fixed when it is registered with the daemon
2242
-
2243
- --personal
2244
- Run as personal work even where a default org applies. Refused in a repository that
2245
- declares an org. Not with --serve
2246
-
2247
2226
  -h, --help
2248
2227
  Print help (see a summary with '-h')
2249
2228
  ```
@@ -3122,11 +3101,9 @@ Commands:
3122
3101
  without it the notice is printed and nothing is sent
3123
3102
  connect Connect with another owner's CAR for a shared project: invite, inspect, accept,
3124
3103
  confirm. Both owners consent before anything is shared
3125
- knock Ask a CAR to connect — no invite code. Either a CAR discovered on your network
3126
- (`<machine>`; its identity is unverified, so compare fingerprints with its owner if it matters who
3127
- they are), or, with `--member <account> --org <org>`, a colleague in a Parslee org through the
3128
- Parslee relay, which works when neither CAR can reach the other (identity `cert:<org>:<account>`,
3129
- from their device certificate)
3104
+ knock Ask a CAR discovered on your network to connect — no invite code. Its owner sees
3105
+ your purpose, project and key fingerprint, and accepts or declines. Its identity is unverified:
3106
+ compare fingerprints with its owner if it matters who they are
3130
3107
  knocks CARs discovered on your network, and knocks waiting in both directions
3131
3108
  knock-accept Accept a knock, choosing your label for that CAR and what you share
3132
3109
  knock-decline Decline a knock. That CAR may not knock again for a day, or ever with `--block`
@@ -3136,12 +3113,8 @@ Commands:
3136
3113
  knock-block Block a key from knocking, quiet it (knocks recorded, no prompt), or allow it
3137
3114
  again
3138
3115
  connections Your Lattice connections with other owners' CARs
3139
- directory Colleagues in your orgs: those whose CARs an org admin attested (for `car lattice
3140
- connect offer`), and those whose devices Parslee certifies, reachable through the Parslee relay
3141
- (for `car lattice knock --member`)
3142
- relay-probe Developer check of the Parslee relay: send a sealed probe to a colleague's device,
3143
- or pull and verify probes sent to this one. Uses this CAR's device certificate for the org; reads
3144
- no credential
3116
+ directory Colleagues in your org whose CARs an org admin attested — the people `car lattice
3117
+ connect offer` can reach without a fingerprint exchange
3145
3118
  org Org-attested connections: status, admin attestation and policy, and your standing
3146
3119
  auto-accept rules
3147
3120
  disconnect End a connection now. The other CAR is told; what it already received cannot be
@@ -3266,8 +3239,7 @@ Usage: car lattice connect <COMMAND>
3266
3239
 
3267
3240
  Commands:
3268
3241
  invite Create an invite: purpose, project, a name for the other CAR, and which of your
3269
- nodes it may see and address (repeat --share; a node address, or `agents:<project>` for every
3270
- agent joined in that project)
3242
+ nodes it may see and address (repeat --share)
3271
3243
  inspect Show what an invite asks for — its purpose and project — before accepting it. The
3272
3244
  inviter's fingerprint is not shown: ask them for it
3273
3245
  accept Accept an invite with your own share list. Active once the inviter confirms your
@@ -3280,8 +3252,6 @@ Commands:
3280
3252
  Only then is the connection active
3281
3253
  share Replace which of your nodes an active connection may see and message (repeat
3282
3254
  --share; none shares nothing). Takes effect here at once; the other CAR is told
3283
- rename Rename your name for the other CAR (its nodes are `<node>@<name>`). Only yours: the
3284
- other owner's name for your CAR does not change
3285
3255
  help Print this message or the help of the given subcommand(s)
3286
3256
 
3287
3257
  Options:
@@ -3291,30 +3261,19 @@ Options:
3291
3261
  #### car lattice knock
3292
3262
 
3293
3263
  ```text
3294
- Ask a CAR to connect — no invite code. Either a CAR discovered on your network (`<machine>`; its
3295
- identity is unverified, so compare fingerprints with its owner if it matters who they are), or, with
3296
- `--member <account> --org <org>`, a colleague in a Parslee org through the Parslee relay, which
3297
- works when neither CAR can reach the other (identity `cert:<org>:<account>`, from their device
3298
- certificate)
3264
+ Ask a CAR discovered on your network to connect — no invite code. Its owner sees your purpose,
3265
+ project and key fingerprint, and accepts or declines. Its identity is unverified: compare
3266
+ fingerprints with its owner if it matters who they are
3299
3267
 
3300
- Usage: car lattice knock [OPTIONS] --purpose <PURPOSE> --project <PROJECT> [MACHINE]
3268
+ Usage: car lattice knock --purpose <PURPOSE> --project <PROJECT> --label <LABEL> <MACHINE>
3301
3269
 
3302
3270
  Arguments:
3303
- [MACHINE] The discovered CAR: its advertised name (see `car lattice knocks`) or its URL
3271
+ <MACHINE> The discovered CAR: its advertised name (see `car lattice knocks`) or its URL
3304
3272
 
3305
3273
  Options:
3306
- --member <MEMBER> A colleague's account, as `car lattice directory` lists it: knock through
3307
- the Parslee relay of `--org`
3308
- --org <ORG> With `--member`, the org whose Parslee relay carries the offer. Without
3309
- it, the org whose device certificate this knock presents
3310
- --device <DEVICE> With `--member`, which of their devices (default: the one with the newest
3311
- certificate)
3312
3274
  --purpose <PURPOSE>
3313
3275
  --project <PROJECT>
3314
- --label <LABEL> Your name for that CAR once connected (`<node>@<label>`). Never sent to
3315
- it. Required for a network knock
3316
- --share <SHARE> With `--member`, a node of yours the colleague may see and address once
3317
- they accept (repeat)
3276
+ --label <LABEL> Your name for that CAR once connected (`<node>@<label>`)
3318
3277
  -h, --help Print help
3319
3278
  ```
3320
3279
 
@@ -3416,37 +3375,16 @@ Options:
3416
3375
  #### car lattice directory
3417
3376
 
3418
3377
  ```text
3419
- Colleagues in your orgs: those whose CARs an org admin attested (for `car lattice connect offer`),
3420
- and those whose devices Parslee certifies, reachable through the Parslee relay (for `car lattice
3421
- knock --member`)
3378
+ Colleagues in your org whose CARs an org admin attested — the people `car lattice connect offer` can
3379
+ reach without a fingerprint exchange
3422
3380
 
3423
3381
  Usage: car lattice directory [OPTIONS]
3424
3382
 
3425
3383
  Options:
3426
3384
  --org <ORG> Which org, when this CAR serves several (default: all of them)
3427
- --refresh Read the org's Parslee relay directory again instead of the cache
3428
3385
  -h, --help Print help
3429
3386
  ```
3430
3387
 
3431
- #### car lattice relay-probe
3432
-
3433
- ```text
3434
- Developer check of the Parslee relay: send a sealed probe to a colleague's device, or pull and
3435
- verify probes sent to this one. Uses this CAR's device certificate for the org; reads no credential
3436
-
3437
- Usage: car lattice relay-probe <COMMAND>
3438
-
3439
- Commands:
3440
- send Seal `text` to the device with this Ed25519 key (from the org's relay directory) and deposit
3441
- it with the relay
3442
- pull Pull this device's relay inbox for the org, verify each probe, print them, and acknowledge
3443
- them. Other relay mail stays queued
3444
- help Print this message or the help of the given subcommand(s)
3445
-
3446
- Options:
3447
- -h, --help Print help
3448
- ```
3449
-
3450
3388
  #### car lattice org
3451
3389
 
3452
3390
  ```text
@@ -4519,10 +4457,8 @@ Commands:
4519
4457
  board`
4520
4458
  publish Publish a finished coder session as a stage: an approved diff, or an accepted no-change
4521
4459
  finding. Without --item this publishes a Build and creates the work item
4522
- submit Submit work you did outside CAR (for example in Claude Code or Codex). CAR runs the
4523
- contract on the commit itself, without credentials, before recording it. With an item this is that
4524
- item's next stage; without one it is a Build that creates the item from --intent and
4525
- --contract-file
4460
+ submit Submit a stage you did outside CAR (for example in Claude Code or Codex). CAR runs the
4461
+ item's contract on the commit itself, without credentials, before recording it
4526
4462
  check Re-verify an item end to end and, if it holds, create `car/mp/<id>-final` for a pull
4527
4463
  request. Runs the item's contract here
4528
4464
  abandon Retire a work item (e.g. its locked contract was wrong). Nothing is deleted: the record
@@ -4606,27 +4542,19 @@ Options:
4606
4542
  #### car mp submit
4607
4543
 
4608
4544
  ```text
4609
- Submit work you did outside CAR (for example in Claude Code or Codex). CAR runs the contract on the
4610
- commit itself, without credentials, before recording it. With an item this is that item's next
4611
- stage; without one it is a Build that creates the item from --intent and --contract-file
4545
+ Submit a stage you did outside CAR (for example in Claude Code or Codex). CAR runs the item's
4546
+ contract on the commit itself, without credentials, before recording it
4612
4547
 
4613
- Usage: car mp submit [OPTIONS] [ITEM]
4548
+ Usage: car mp submit [OPTIONS] <ITEM>
4614
4549
 
4615
4550
  Arguments:
4616
- [ITEM]
4617
-
4618
- Options:
4619
- --commit <COMMIT> The work: a commit descending from the item's tip, or for a
4620
- Build from --base [default: HEAD]
4621
- --intent <INTENT> Build only: what the item is for. Fixed here; the only text
4622
- that travels to the later stages
4623
- --contract-file <CONTRACT_FILE> Build only: the outcome contract (JSON, as
4624
- `coder.confirm_contract` takes it) that becomes the item's locked contract
4625
- --base <BASE> Build only: the commit the Build starts from, which must be
4626
- on the remote. Defaults to the remote's default branch
4627
- --repo <REPO> [default: .]
4628
- --remote <REMOTE> [default: origin]
4629
- -h, --help Print help
4551
+ <ITEM>
4552
+
4553
+ Options:
4554
+ --commit <COMMIT> The stage's work: a commit descending from the item's tip [default: HEAD]
4555
+ --repo <REPO> [default: .]
4556
+ --remote <REMOTE> [default: origin]
4557
+ -h, --help Print help
4630
4558
  ```
4631
4559
 
4632
4560
  #### car mp check
@@ -4665,23 +4593,6 @@ Options:
4665
4593
  -h, --help Print help
4666
4594
  ```
4667
4595
 
4668
- ### car claude
4669
-
4670
- ```text
4671
- Start Claude Code as a CAR-supervised collaboration session. Enrolls a per-session agent bound to
4672
- the work context `car auth resolve` names for this directory, hands its identity to the CAR plugin's
4673
- collaboration tools, runs `claude` in this terminal, and removes the agent when it exits. Arguments
4674
- after `--` go to `claude`. Needs a running daemon
4675
-
4676
- Usage: car claude [ARGS]...
4677
-
4678
- Arguments:
4679
- [ARGS]...
4680
-
4681
- Options:
4682
- -h, --help Print help
4683
- ```
4684
-
4685
4596
  ### car publish
4686
4597
 
4687
4598
  ```text
package/index.d.ts CHANGED
@@ -2770,9 +2770,13 @@ export class CarRuntime {
2770
2770
  */
2771
2771
  parsleeM365GenerateDocument(contentBrief: string, outputFilePath: string, documentType?: string | undefined | null, title?: string | undefined | null, author?: string | undefined | null): Promise<string>;
2772
2772
 
2773
- /** List registered in-daemon declarative agents. */
2773
+ /**
2774
+ * List registered in-daemon declarative agents. Each row carries
2775
+ * `registration_id` once the registry has assigned one: new when the id
2776
+ * is registered anew, kept across a rebuild, rename or revert.
2777
+ */
2774
2778
  declagentList(): Promise<string>;
2775
- /** One declarative agent's spec by id, plus daemon-derived `registry_path`. */
2779
+ /** One declarative agent's spec by id (with its `registration_id`), plus daemon-derived `registry_path`. */
2776
2780
  declagentGet(id: string): Promise<string>;
2777
2781
  /** Unregister a declarative agent. */
2778
2782
  declagentRemove(id: string): Promise<string>;
@@ -2784,7 +2788,9 @@ export class CarRuntime {
2784
2788
  declagentRunScenarios(id: string): Promise<string>;
2785
2789
  /**
2786
2790
  * Run a declarative agent on an input with its saved inference selection.
2787
- * Returns `{ output, turns, tool_calls, model_served?, error? }` JSON.
2791
+ * Returns `{ output, turns, tool_calls, model_served?, model?, stood_in?, error?, goal? }`
2792
+ * JSON; `stood_in` (`{ for_model, on_model, notice }`) is set when Parslee
2793
+ * served a turn in place of the agent's unavailable saved model.
2788
2794
  */
2789
2795
  declagentInvoke(id: string, input: string): Promise<string>;
2790
2796
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "car-runtime",
3
- "version": "0.58.0",
3
+ "version": "0.59.0-nightly.20261016",
4
4
  "carProtocolVersion": 3,
5
5
  "description": "Common Agent Runtime — a deterministic execution layer for AI agents",
6
6
  "main": "index.js",