@awebai/oats 0.65.0 → 0.67.1
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 +11 -5
- package/bin/oats.mjs +74 -20
- package/docs/capabilities.md +4 -4
- package/docs/capability-manifest.schema.json +1 -1
- package/docs/desktop-cli-api.md +222 -10
- package/docs/desktop.md +101 -22
- package/docs/implementation.md +16 -6
- package/docs/integrations.md +1 -1
- package/docs/official-catalog.md +2 -2
- package/docs/packages.md +7 -7
- package/docs/release-lane.md +16 -0
- package/docs/release-notes/v0.66.0.md +183 -0
- package/docs/release-notes/v0.67.0.md +366 -0
- package/docs/release-notes/v0.67.1.md +64 -0
- package/docs/servers.md +5 -4
- package/docs/souls-and-instances.md +20 -3
- package/docs/tui.md +658 -143
- package/docs/upgrading.md +107 -25
- package/docs/workspaces.md +9 -2
- package/lib/capability-contract.mjs +2 -2
- package/lib/core.mjs +126 -54
- package/lib/deployments.mjs +21 -5
- package/lib/instance-color.mjs +58 -0
- package/lib/instance-inspect.mjs +107 -23
- package/lib/instance-lifecycle.mjs +21 -1
- package/lib/instance-naming.mjs +187 -0
- package/lib/instance-resolution.mjs +5 -1
- package/lib/materialize.mjs +62 -11
- package/lib/servers.mjs +15 -6
- package/lib/soul-composition.mjs +7 -3
- package/package-catalog.json +2 -2
- package/package.json +1 -1
- package/packages/client/cli-adapter.mjs +37 -5
- package/packages/client/cli-locator.mjs +2 -2
- package/packages/client/composed-gate.mjs +10 -2
- package/packages/client/deployment-data.mjs +5 -0
- package/packages/client/deployment-identity.mjs +40 -0
- package/packages/client/deployment-panel.mjs +3 -1
- package/packages/client/inspect-boundary.mjs +11 -7
- package/packages/client/inspect-cache.mjs +2 -2
- package/packages/client/instance-name.mjs +28 -0
- package/packages/client/instance-presentation.mjs +11 -0
- package/packages/client/keymap.mjs +99 -11
- package/packages/client/keys-file.mjs +122 -0
- package/packages/client/machine-contract.mjs +1 -5
- package/packages/client/own-codes.mjs +4 -2
- package/packages/client/panel-views.mjs +62 -9
- package/packages/client/spawn-naming.mjs +31 -0
- package/packages/client/spawn-preview-cli.mjs +22 -7
- package/packages/client/spawn-preview-contract.mjs +24 -0
- package/packages/client/spawn-preview-facts.mjs +8 -4
- package/packages/client/spawn-preview.mjs +47 -2
- package/packages/record/bin/setup.mjs +10 -2
- package/packages/record/docs/capture-service.md +45 -6
- package/packages/record/lib/capture-service-install.mjs +6 -95
- package/packages/record/lib/capture-setup-write.mjs +233 -0
- package/packages/tui/README.md +9 -8
- package/packages/tui/lib/actions.mjs +108 -64
- package/packages/tui/lib/client.mjs +8 -3
- package/packages/tui/lib/config.mjs +208 -26
- package/packages/tui/lib/main.mjs +91 -20
- package/packages/tui/lib/model.mjs +167 -61
- package/packages/tui/lib/read.mjs +53 -1
- package/packages/tui/lib/store.mjs +156 -47
- package/packages/tui/lib/term/keys.mjs +150 -34
- package/packages/tui/lib/term/kitty.mjs +223 -0
- package/packages/tui/lib/term/through.mjs +174 -27
- package/packages/tui/lib/term/tty.mjs +43 -12
- package/packages/tui/lib/views/frame.mjs +158 -79
- package/packages/tui/lib/views/help.mjs +143 -21
- package/packages/tui/lib/views/instances.mjs +59 -20
- package/packages/tui/lib/views/palette.mjs +14 -4
- package/packages/tui/lib/views/souls.mjs +2 -2
- package/packages/tui/lib/views/switcher.mjs +6 -1
- package/skills/oats-getting-started/SKILL.md +107 -34
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# OATS 0.67.1
|
|
2
|
+
|
|
3
|
+
Unreleased
|
|
4
|
+
|
|
5
|
+
**0.67.1 is the first published 0.67 release.** v0.67.0 was tagged but never
|
|
6
|
+
published: its release run stopped before npm and the Desktop Release, on
|
|
7
|
+
Desktop tests that failed on macOS (Fixed, below). Everything in
|
|
8
|
+
[0.67.0's notes](v0.67.0.md) ships in 0.67.1.
|
|
9
|
+
|
|
10
|
+
## Upgrade
|
|
11
|
+
|
|
12
|
+
- **Do [0.67.0's Upgrade steps](v0.67.0.md#upgrade):** they are this
|
|
13
|
+
release's. Install the Desktop first and the CLI second: a 0.66 Desktop
|
|
14
|
+
refuses a 0.67.1 CLI. The 0.67.1 Desktop accepts OATS CLIs
|
|
15
|
+
`>=0.26.0 <0.68.0`. The leader moves to Ctrl+X, and the shortcuts on Linux
|
|
16
|
+
and Windows move to Ctrl+Alt; the official catalog pins oats.framework
|
|
17
|
+
1.13.5.
|
|
18
|
+
|
|
19
|
+
- **Coming from 0.65 or earlier:** do 0.66.0's Upgrade steps too, and
|
|
20
|
+
0.62.0's when coming from 0.61 or earlier.
|
|
21
|
+
|
|
22
|
+
## Added
|
|
23
|
+
|
|
24
|
+
- **`/oats-upgrade`, an oats.setup skill for "upgrade OATS" and "update to
|
|
25
|
+
the latest".** It takes the latest version from
|
|
26
|
+
`npm view @awebai/oats version`, reads [Upgrading](../upgrading.md) and
|
|
27
|
+
the `## Upgrade` section of every release after the installed one at the
|
|
28
|
+
tag `v<latest>`, never the copy in the installed CLI, and walks the person
|
|
29
|
+
through each release's own steps, the Desktop, the CLI, the pi bridges in
|
|
30
|
+
every deployment and `oats doctor`, one step on each yes. On a tag whose page does not
|
|
31
|
+
open with the latest version yet (up to v0.67.0), it takes the order from
|
|
32
|
+
the page and the version and the Desktop's CLIs from the latest release's
|
|
33
|
+
notes. `/oats-setup-model` points at it instead of the installed copy. It
|
|
34
|
+
ships with the next oats.framework release
|
|
35
|
+
([#1440](https://github.com/awebai/oats/issues/1440)).
|
|
36
|
+
|
|
37
|
+
## Fixed
|
|
38
|
+
|
|
39
|
+
- **The spawn dialog's name suggestion refuses an oversized request before
|
|
40
|
+
it reads it.** The Desktop's spawn-preview proxy now refuses a body past
|
|
41
|
+
its limit before parsing it; a parsed body that is not a suggestion read
|
|
42
|
+
keeps a preview's 16 KiB limit
|
|
43
|
+
([#1441](https://github.com/awebai/oats/pull/1441), follow-up to
|
|
44
|
+
[#1438](https://github.com/awebai/oats/pull/1438)).
|
|
45
|
+
|
|
46
|
+
- **Three Desktop keymap tests assumed the Linux keys,** so they failed on
|
|
47
|
+
macOS, and one of them kept `node --test` from ending; the v0.67.0 release
|
|
48
|
+
run stopped there. They now pin the platform they test. No shipped code
|
|
49
|
+
changes ([#1445](https://github.com/awebai/oats/pull/1445);
|
|
50
|
+
[#1433](https://github.com/awebai/oats/issues/1433)).
|
|
51
|
+
|
|
52
|
+
## Documentation
|
|
53
|
+
|
|
54
|
+
- **[Upgrading](../upgrading.md) opens with "Upgrading to the latest
|
|
55
|
+
version":** the latest version, the CLIs its Desktop accepts and the
|
|
56
|
+
steps. What each older release asks of a host that comes from it is under
|
|
57
|
+
"Coming from an older version", one line per release, newest first, each
|
|
58
|
+
linking its notes; the capture service's release order is there too. The
|
|
59
|
+
page states only the latest Desktop's CLIs; the earlier ones stay in
|
|
60
|
+
their notes ([#1440](https://github.com/awebai/oats/issues/1440)).
|
|
61
|
+
- **The release-prep pull request updates that section with the notes**
|
|
62
|
+
([Release lane](../release-lane.md#for-the-tag-owner)), and
|
|
63
|
+
`test/release-packaging.test.mjs` checks that it names the version the
|
|
64
|
+
manifests carry, and no other.
|
package/docs/servers.md
CHANGED
|
@@ -71,7 +71,7 @@ which is where a [macOS keychain](#git-on-a-macos-host) problem shows up.
|
|
|
71
71
|
## Connect a machine
|
|
72
72
|
|
|
73
73
|
```bash
|
|
74
|
-
oats server connect altair-aweb --ssh altair --path /opt/homebrew/bin --install-oats
|
|
74
|
+
oats server connect altair-aweb --ssh altair --dir '~/acme' --path /opt/homebrew/bin --install-oats
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
Run from a deployment, `server connect` puts that deployment's workspace on
|
|
@@ -81,8 +81,8 @@ missing, so after a human step you run the same command again.
|
|
|
81
81
|
|
|
82
82
|
| Option | Default |
|
|
83
83
|
|---|---|
|
|
84
|
+
| `--dir <path>` | none, inside a deployment too: the folder on the host for this deployment, absolute or `~/…` (resolved by the host). Without it: `E_BAD_ARGS` "--dir <path on the host> is required: the folder on `<host>` for this deployment (absolute, or ~/… resolved there)". A registration made before it was required is unchanged |
|
|
84
85
|
| `--workspace-ref <ref>` | this deployment's `oats-local.yaml` `workspace:` |
|
|
85
|
-
| `--dir <path>` | `~/Agents/<this deployment's directory name>`; absolute or `~/…`, resolved by the host |
|
|
86
86
|
| `--oats <path>`, `--path <dirs>`, `--label <text>` | as for `server add`; `--path` is where the host finds `npm`, `oats` and the harnesses |
|
|
87
87
|
| `--install-oats` | off: a missing or older OATS is a human step |
|
|
88
88
|
| `--replace` | off: an id registered for another host or directory is refused |
|
|
@@ -235,7 +235,7 @@ sent as text or on stdin, never as paths.
|
|
|
235
235
|
|
|
236
236
|
| Command | Where it runs | The server must advertise |
|
|
237
237
|
|---|---|---|
|
|
238
|
-
| `spawn` | registered workspace | the requested harness, backend and yolo option; `launch-config` for `--launch-config`; `schedule` for a wake schedule; `spawn-preview-2` for `--preview` |
|
|
238
|
+
| `spawn` | registered workspace | the requested harness, backend and yolo option; `launch-config` for `--launch-config`; `schedule` for a wake schedule; `spawn-preview-2` for `--preview`, and `spawn-suggest-name` for `--suggest-name` |
|
|
239
239
|
| `status` | registered workspace | |
|
|
240
240
|
| `retire` | the instance's home | `retire-home` to retire by exact home |
|
|
241
241
|
| `session inspect`, `session attach` | the instance's home | `session`; `session-attach-detach-key` for `attach --detach-key` |
|
|
@@ -244,11 +244,12 @@ sent as text or on stdin, never as paths.
|
|
|
244
244
|
| `okf harvest --instance <name>` | the saved home | `harvest` |
|
|
245
245
|
| `schedule ...` | registered workspace | `schedule` |
|
|
246
246
|
| `launch-config list\|set\|remove\|preview` | `--dir`, the instance's home, or the registered workspace | `launch-config` |
|
|
247
|
-
| `inspect`, `operation run` | `--dir`, the instance's home, or the registered workspace | `operations`; `inspect --instructions` also `soul-composed-instructions`, `inspect --skills` also `soul-skills` |
|
|
247
|
+
| `inspect`, `operation run` | `--dir`, the instance's home, or the registered workspace | `operations`; `inspect --instructions` also `soul-composed-instructions`, `inspect --skills` also `soul-skills`, `inspect --composed-skills` also `soul-composed-skills` |
|
|
248
248
|
| `readiness` | the instance's home, `--dir`, or the registered workspace | `readiness` (`readinessApi: 2`) |
|
|
249
249
|
| `instance events` | the instance's home | `instance-events-2` (`eventsApi: 2`) |
|
|
250
250
|
| `instance git`, `instance diff` | the instance's home; the Git runs there | `instance-git` (`instanceGitApi: 1`) |
|
|
251
251
|
| `instance stop --plan\|--apply`, `retire --plan`, `retire --plan-revision … --idempotency-key …` | the instance's home | `lifecycle-plans` (`lifecycleApi: 1`) |
|
|
252
|
+
| `instance color` | the instance's home | `instance-color` |
|
|
252
253
|
|
|
253
254
|
Before every routed command except `status`, the kernel reads the server's
|
|
254
255
|
`oats version --json`. A remote OATS older than 0.22.1 is refused, and so is a
|
|
@@ -313,15 +313,32 @@ locally refused legacy instance selector. For preview confirmation and receipt
|
|
|
313
313
|
replay, see the [spawn decision and apply contract](desktop-cli-api.md#the-decision).
|
|
314
314
|
|
|
315
315
|
```bash
|
|
316
|
-
oats spawn release-manager --
|
|
316
|
+
oats spawn release-manager --name cut-3-2-manager --task "…" # a soul of a confirmed member
|
|
317
317
|
oats spawn release-manager --preview --json # decide everything, create nothing
|
|
318
318
|
oats spawn release-manager --provider oats.aweb identity.source=/abs/path/to/retained/.aw # instance-level payload
|
|
319
319
|
```
|
|
320
320
|
|
|
321
|
-
An instance is named
|
|
321
|
+
An instance is named exactly `--name <slug>`, or `<soul>-<purpose>` with
|
|
322
|
+
`--purpose`; with neither, the kernel numbers it. The convention for a name a
|
|
323
|
+
person or an agent chooses is `<descriptive>-<role>` through `--name`: a few
|
|
324
|
+
words for the instance's work, then the soul's role, the last word of the
|
|
325
|
+
soul's name after any package qualifier (`--name desktop-improvements-expert`
|
|
326
|
+
for an `oats-desktop-expert`). `--purpose` derives the name from the soul, for
|
|
327
|
+
automations and scripts that know only the soul and a purpose.
|
|
322
328
|
Names are unique per deployment (a workspace-model deployment has one agents
|
|
323
329
|
root): a derived name in use gets `-2`, `-3`…; an explicit `--name` in use is
|
|
324
|
-
refused (`E_INSTANCE_NAME_TAKEN`).
|
|
330
|
+
refused (`E_INSTANCE_NAME_TAKEN`). The Desktop's spawn dialog adds the role to
|
|
331
|
+
a typed name.
|
|
332
|
+
`oats spawn <soul> --preview --suggest-name --task-file <f>` asks the soul's
|
|
333
|
+
own harness for the descriptive words, from the task, in one call that starts
|
|
334
|
+
none of the user's MCP servers, hooks, plugins or extensions. Claude Code's
|
|
335
|
+
built-in plugins, the host's managed-policy hooks and pi's credential commands
|
|
336
|
+
are the stated exceptions; a claude login through `apiKeyHelper` is not read,
|
|
337
|
+
so that user's name stays numbered (`harness-failed`). The preview then answers for
|
|
338
|
+
`--name <descriptive>-<role>`, de-duplicated the same way. On claude and pi
|
|
339
|
+
only; any other harness, and any failure of the call, leaves the name numbered
|
|
340
|
+
and says why
|
|
341
|
+
([The suggested name](desktop-cli-api.md#the-suggested-name-feature-spawn-suggest-name)).
|
|
325
342
|
|
|
326
343
|
From a deployment (where `oats-local.yaml` is), a spawn: reads the local file →
|
|
327
344
|
discovers the workspace over its remotes and confirms membership → finds the
|