@awebai/oats 0.44.0 → 0.45.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/bin/oats.mjs CHANGED
@@ -1971,7 +1971,8 @@ async function capabilityFacts(rows, discovery, lock, ctx, remote = remoteModule
1971
1971
  }
1972
1972
 
1973
1973
  /** Souls rows' spawnability (feature desktop-facts): the refusal a spawn of each would meet, computed from
1974
- * discovery and the lock without spawning (soulSpawnability). */
1974
+ * discovery and the lock without spawning (soulSpawnability), and what the same resolution composes
1975
+ * (`capabilities`, feature souls-capabilities; null when not spawnable). */
1975
1976
  async function soulFacts(rows, discovery, lock, ctx, remote = remoteModule) {
1976
1977
  const { soulSpawnability } = await import("../lib/instance-resolution.mjs");
1977
1978
  // Indexes built once, each keeping the FIRST match as `find` did (a scan per row was O(souls × members)).
@@ -1984,7 +1985,7 @@ async function soulFacts(rows, discovery, lock, ctx, remote = remoteModule) {
1984
1985
  for (const row of rows) {
1985
1986
  const entry = entryOf(row);
1986
1987
  row.file = { path: `${row.path}/soul.yaml`, url: remoteModule.browseUrl(row.repoKey, row.commit, `${row.path}/soul.yaml`) };
1987
- Object.assign(row, entry ? await soulSpawnability(ctx.local, discovery, lock, entry, { remoteOptions: ctx.remoteOptions, remote }) : { spawnable: false, problem: { code: "E_SOUL_UNKNOWN", message: `${row.name} is not in this discovery` } });
1988
+ Object.assign(row, entry ? await soulSpawnability(ctx.local, discovery, lock, entry, { remoteOptions: ctx.remoteOptions, remote }) : { spawnable: false, problem: { code: "E_SOUL_UNKNOWN", message: `${row.name} is not in this discovery` }, capabilities: null });
1988
1989
  }
1989
1990
  }
1990
1991
 
@@ -3388,7 +3389,7 @@ function versionCmd() {
3388
3389
  // Phase B: `instance-modules` and `spawn-provider-payload` are advertised only once spawn
3389
3390
  // runs on resolve/materialize (contract §6); a feature the binary does not implement is
3390
3391
  // never listed.
3391
- console.log(JSON.stringify({ schemaVersion: 1, name: "@awebai/oats", version: OATS_VERSION, desktopApi: 1, harnesses: ["pi", "claude", "codex"], sessionBackends: ["tmux"], launchOptions: ["yolo"], remote: ["spawn", "retire", "status", "session", "session-start", "session-restart", "launch-config", "roster", "harvest", "schedule", "session-upload", "operations", "readiness", "instance-events", "instance-git", "lifecycle-plans"], features: ["retire-home", "session-start", "session-restart", "launch-config", "schedule", "schedule-host-caps", "session-upload", "operations", "instance-git", "instance-git-remote", "souls-declarations", "lifecycle-plans", "retire-retention", "readiness", "spawn-preview", "instance-events", "instance-events-2", "schedule-history", "schedule-read-2", "spawn-preview-2", "spawn-idempotency", "spawn-idempotency-2", "spawn-apply-2", "workspace-v2", "instance-modules", "spawn-provider-payload", "served-identity", "packages-no-approval", "spawn-name", "settings-origins", "team-model-3", "settings-declared", "capabilities-private", "layers-from", "harness", "package-souls", "triggers", "automations", "desktop-facts", "launch-preference", "preview-composed-from", "observe-max-age", "spawn-preview-max-age", "launch-config-default", "capability-show", "capture-file", "workspace-identity", "server-connect", "capability-route", "servers-per-workspace", "operator-default-soul", "waiting-on-you", "automation-descriptions"], automationsApi: A.AUTOMATIONS_API, workspaceApi: 2, instanceGitApi: 1, spawnApplyApi: 1, soulsApi: 2, lifecycleApi: 1, readinessApi: 2, spawnPreviewApi: 2, eventsApi: 2, scheduleHistoryApi: 3, scheduleApi: SCHEDULE_API, operationsApi: 2, capabilityShowApi: 1 }));
3392
+ console.log(JSON.stringify({ schemaVersion: 1, name: "@awebai/oats", version: OATS_VERSION, desktopApi: 1, harnesses: ["pi", "claude", "codex"], sessionBackends: ["tmux"], launchOptions: ["yolo"], remote: ["spawn", "retire", "status", "session", "session-start", "session-restart", "launch-config", "roster", "harvest", "schedule", "session-upload", "operations", "readiness", "instance-events", "instance-git", "lifecycle-plans"], features: ["retire-home", "session-start", "session-restart", "launch-config", "schedule", "schedule-host-caps", "session-upload", "operations", "instance-git", "instance-git-remote", "souls-declarations", "lifecycle-plans", "retire-retention", "readiness", "spawn-preview", "instance-events", "instance-events-2", "schedule-history", "schedule-read-2", "spawn-preview-2", "spawn-idempotency", "spawn-idempotency-2", "spawn-apply-2", "workspace-v2", "instance-modules", "spawn-provider-payload", "served-identity", "packages-no-approval", "spawn-name", "settings-origins", "team-model-3", "settings-declared", "capabilities-private", "layers-from", "harness", "package-souls", "triggers", "automations", "desktop-facts", "launch-preference", "preview-composed-from", "observe-max-age", "spawn-preview-max-age", "launch-config-default", "capability-show", "capture-file", "workspace-identity", "server-connect", "capability-route", "servers-per-workspace", "operator-default-soul", "waiting-on-you", "automation-descriptions", "souls-capabilities"], automationsApi: A.AUTOMATIONS_API, workspaceApi: 2, instanceGitApi: 1, spawnApplyApi: 1, soulsApi: 2, lifecycleApi: 1, readinessApi: 2, spawnPreviewApi: 2, eventsApi: 2, scheduleHistoryApi: 3, scheduleApi: SCHEDULE_API, operationsApi: 2, capabilityShowApi: 1 }));
3392
3393
  return;
3393
3394
  }
3394
3395
  console.log(`@awebai/oats ${OATS_VERSION} (desktop API v1)`);
@@ -38,8 +38,9 @@ canonical (`github.com/<org>/<repo>`, or `local/<abs-path>`). Examples use
38
38
  "instance-events-2","schedule-history","schedule-read-2","spawn-preview-2","spawn-idempotency","spawn-idempotency-2","spawn-apply-2",
39
39
  "workspace-v2","instance-modules","spawn-provider-payload","served-identity","packages-no-approval","spawn-name","settings-origins",
40
40
  "team-model-3","settings-declared","capabilities-private","layers-from","harness","package-souls","triggers","automations","desktop-facts","launch-preference",
41
- "preview-composed-from","observe-max-age","spawn-preview-max-age","capability-show","capture-file","workspace-identity",
42
- "server-connect","capability-route","servers-per-workspace","operator-default-soul","waiting-on-you"],
41
+ "preview-composed-from","observe-max-age","spawn-preview-max-age","launch-config-default","capability-show","capture-file",
42
+ "workspace-identity","server-connect","capability-route","servers-per-workspace","operator-default-soul","waiting-on-you",
43
+ "automation-descriptions","souls-capabilities"],
43
44
  "automationsApi":1,"workspaceApi":2,"instanceGitApi":1,"spawnApplyApi":1,"soulsApi":2,"lifecycleApi":1,
44
45
  "readinessApi":2,"spawnPreviewApi":2,"eventsApi":2,"scheduleHistoryApi":3,"scheduleApi":2,"operationsApi":2,
45
46
  "capabilityShowApi":1}
@@ -109,6 +110,7 @@ canonical (`github.com/<org>/<repo>`, or `local/<abs-path>`). Examples use
109
110
  | `operator-default-soul` | a capability command from a deployment without `--soul` runs as the first soul that provides its namespace (named on stderr); none is `E_BAD_ARGS`, OATS 0.39.0 ([capabilities.md](capabilities.md)) | |
110
111
  | `waiting-on-you` | the `waiting` event kind and the session boundary rule; `oats instance waiting` and `oats instance attention`; `waitingOnYou` (with `message`) on `oats status --json` instance rows, on `oats session inspect --json` and in the events read, OATS 0.40.0 ([Waiting on you](#waiting-on-you)) | `eventsApi: 2` |
111
112
  | `automation-descriptions` | a `description` on every trigger and schedule row, local or workspace, by one rule; `oats schedule update <id> --description=<text>` (the description only) and `oats trigger update <id> --description=<text>`; `--description=<text>` on `schedule add` and `trigger add`, OATS 0.43.0 ([Shared row fields](#automations-shared-rows)) | |
113
+ | `souls-capabilities` | `capabilities` on `oats souls --json` rows: the capabilities each soul composes, keyed like `oats capabilities` rows, with `from`, OATS 0.45.0 ([`oats capabilities` and `oats souls`](#oats-capabilities---dir---json--capabilitiesapi-1--oats-souls---dir---json--soulsapi-1)) | |
112
114
 
113
115
  Payload-only integers, never in the probe: `onboardApi: 2`, `syncApi: 1`,
114
116
  `workspaceStatusApi: 1`, `capabilitiesApi: 1`, the `oats souls` document's
@@ -826,12 +828,14 @@ packages' capabilities and souls, sorted by name, then origin. Both carry
826
828
  "teams":[{"label":"mine","team":"mine:ana.aweb.ai","default":true,"from":"local"},{"label":"global","team":null,"default":false,"from":"shared"}],
827
829
  "defaultTeam":{"label":"mine","team":"mine:ana.aweb.ai","from":"deployment"},
828
830
  "private":false,"path":"souls/writer","work":"directory","description":"Drafts campaigns.","harness":"pi","model":null,"harnessFrom":"kernel-default",
829
- "file":{"path":"souls/writer/soul.yaml","url":null},"spawnable":true,"problem":null},
831
+ "file":{"path":"souls/writer/soul.yaml","url":null},"spawnable":true,"problem":null,
832
+ "capabilities":[{"name":"oats.aweb","kind":"package","package":"oats.aweb","from":"workspace"}]},
830
833
  {"name":"knowledge-maintainer","qualifiedName":"oats.okf/knowledge-maintainer","origin":"package oats.okf v4.1.1","kind":"package","package":"oats.okf",
831
834
  "version":"4.1.1","repoKey":"github.com/awebai/oats-okf","commit":"e1d604f7…","teams":null,"defaultTeam":null,"private":false,
832
835
  "path":"oats-package/souls/knowledge-maintainer","work":"directory","description":"Reviews harvested knowledge.","harness":"pi","model":null,
833
836
  "harnessFrom":"kernel-default","file":{"path":"oats-package/souls/knowledge-maintainer/soul.yaml","url":null},
834
- "spawnable":false,"problem":{"code":"E_TEAM_UNKNOWN","message":"team \"reviewers\" is not declared (oats-local.yaml#/defaultTeam): …"}}],
837
+ "spawnable":false,"problem":{"code":"E_TEAM_UNKNOWN","message":"team \"reviewers\" is not declared (oats-local.yaml#/defaultTeam): …"},
838
+ "capabilities":null}],
835
839
  "problems":[]}
836
840
  ```
837
841
 
@@ -846,7 +850,8 @@ are absent until `sync`.
846
850
  **Soul rows:** `name, origin, kind (member | external | package), repoKey,
847
851
  commit, teams, defaultTeam, private (always false), path, work, description`,
848
852
  plus the Desktop facts `harness, model, harnessFrom, file, spawnable,
849
- problem`, and (feature `launch-preference`) `key` and `launch`.
853
+ problem`, (feature `souls-capabilities`) `capabilities`, and (feature
854
+ `launch-preference`) `key` and `launch`.
850
855
  - `key` is the soul key that `souls.launch` uses, and that
851
856
  `oats soul teams <key>` takes: `qualifiedName` for a package
852
857
  soul, the bare `name` for a member or external soul. Two member souls that
@@ -857,6 +862,16 @@ problem`, and (feature `launch-preference`) `key` and `launch`.
857
862
  [TeamRow](#the-team-row-teamrow) list and a
858
863
  [DefaultTeam](#the-default-defaultteam); both `null` when the soul's teams
859
864
  do not resolve (`problem` names the `E_TEAM_*` code).
865
+ - `capabilities` (feature `souls-capabilities`, OATS 0.45.0): what the soul's
866
+ resolution composes, slots and additive alike, sorted by `name`. Each entry
867
+ names its capability with the capability row's own keys: `name`, `kind`
868
+ (`member` | `package`), then `repoKey` for a member or `package` for a
869
+ package, so it matches exactly one `oats capabilities` row. `from` is why
870
+ the soul has it: `soul` (it declares it) or `workspace` (a workspace
871
+ default), as in inspect's `layers.<slot>.from`. A capability the soul
872
+ turned off (`off`, or `<slot>: none` over a workspace default) is not
873
+ listed. `null` whenever `spawnable` is false (`problem` names why),
874
+ including a soul disabled on this machine; never `[]` for unknown.
860
875
  - Package souls (feature `package-souls`) add `qualifiedName`
861
876
  (`<package>/<soul>`), `package` and `version`. Spawn one by
862
877
  `qualifiedName` (the bare name when unique). Its instances live under
@@ -1353,8 +1368,9 @@ offers **covers** it when all of these hold on this machine:
1353
1368
  - it is not in `souls.disabled`;
1354
1369
  - it resolves as a spawn would;
1355
1370
  - its modules include `oats.setup`;
1356
- - it empties no layer slot the workspace fills, so it keeps the workspace's
1357
- core, messaging and knowledge.
1371
+ - it does not empty the messaging slot the workspace fills (`messaging:
1372
+ none`), so it stays reachable. Emptying `knowledge` or `tasks` does not
1373
+ disqualify it (0.45.0).
1358
1374
 
1359
1375
  It covers a team when that team is among its resolved teams. Detection is by
1360
1376
  composition only: a soul's name never counts, and there is no role marker. An
@@ -1388,8 +1404,8 @@ relevant, each as `{soul, code}`:
1388
1404
  - a soul whose `soul.yaml` names `oats.setup` but that is disabled
1389
1405
  (`E_SOUL_DISABLED`), ambiguous (`E_SOUL_AMBIGUOUS`) or refused (the
1390
1406
  resolution's code);
1391
- - a soul that composes `oats.setup` but empties a slot the workspace fills
1392
- (`slot-none`, with `slots`).
1407
+ - a soul that composes `oats.setup` but empties the messaging slot the
1408
+ workspace fills (`slot-none`, with `slots: ["messaging"]`).
1393
1409
 
1394
1410
  Coverage that holds adds no item.
1395
1411
 
package/docs/desktop.md CHANGED
@@ -153,6 +153,27 @@ workspace on a server: `name — server`).
153
153
  window they were opened in, and switching that window back to the
154
154
  workspace brings them back.
155
155
 
156
+ ## Capabilities and spawning
157
+
158
+ **Workspace › Capabilities** lists what the workspace offers, in three
159
+ sections: **Workspace owned** (from the member repos, for every soul),
160
+ **Repo owned** (only for souls of the same repo) and **Packages** (pinned
161
+ versions). Workspace owned and Repo owned are grouped by the repository
162
+ that defines each capability. The groups are headed like the Souls tab:
163
+ repo name, then "member repo · host · N capabilities". The host repository
164
+ comes first, then the others by name; capabilities from outside the member
165
+ repos come last, under **external**. At the top right of Workspace owned,
166
+ pills (**All**, then one per repository, each with its count) show one
167
+ repository at a time; "N of M shown" appears while a pill or the search
168
+ narrows the list.
169
+
170
+ The **Spawn** dialog's left column, **What will be created**, starts with the
171
+ new instance's name and its home. Then come where it works, its harness and
172
+ model (with where that choice came from), its default team and the teams it may
173
+ also join, and its relationship when it has one. Under them are its core
174
+ capabilities and its other capabilities. Every dropdown in the app has the
175
+ same themed look, and its open list follows the light or dark theme.
176
+
156
177
  ## One workspace, several machines
157
178
 
158
179
  The switcher lists each workspace once, however many deployments it has: the
@@ -237,6 +258,20 @@ registered remote workspace the timer and definitions live on that server, so
237
258
  they do not depend on the Mac staying awake. See [Schedules](schedules.md) for
238
259
  the CLI, cron semantics, observed outcomes and recovery commands.
239
260
 
261
+ ## A workspace's teams and setup
262
+
263
+ The Workspace › **Teams** tab has one card per team. Under its description,
264
+ **Default for** says whose default the team is: all souls of a repository, a
265
+ single soul, or every soul without its own default for the default team. **May
266
+ join** says who else may join it. Both are read from the workspace's committed
267
+ `souls:`; a team nobody may join yet says so. The address (the team on the
268
+ messaging provider) and the members running in it follow.
269
+
270
+ The **Setup** tab's List view starts with the workspace's **host**, the
271
+ repository that holds `oats-workspace.yaml`, and marks every repository the
272
+ workspace trusts for souls and capabilities as a **Member**. The host is a
273
+ member too. A legend under the title explains both badges.
274
+
240
275
  ## A workspace's machines
241
276
 
242
277
  A window offers only the machines that run its workspace: those whose
@@ -342,6 +377,18 @@ has reached the execution host. Both CLI installations must advertise
342
377
  `session-upload`. A failed transfer leaves the draft unchanged and shows an
343
378
  error in the terminal. Each drop/paste accepts up to 16 files totaling 25 MB.
344
379
 
380
+ ## Harness badges
381
+
382
+ Roster rows, soul cards, the soul page, the context panel and the spawn
383
+ dialog show each instance's or soul's harness as a small badge, next to its
384
+ name. The badge names the harness the CLI reports; it says nothing about
385
+ whether that harness is installed or signed in. Pi's badge is the official
386
+ pi.dev press-kit mark (MIT), and Claude Code's is Anthropic's Claude spark
387
+ in the theme's colours. The Codex badge is OATS's own drawing, not OpenAI's
388
+ logo. OATS is not affiliated with or endorsed by Anthropic or OpenAI. An
389
+ unknown or unreported harness shows "?". Sources and licences are in
390
+ `packages/desktop/renderer/harness-marks/README.md`.
391
+
345
392
  ## Security posture
346
393
 
347
394
  - The bundled backend binds **127.0.0.1 only** and guards against DNS
@@ -0,0 +1,47 @@
1
+ # OATS 0.44.1
2
+
3
+ ## Changed
4
+
5
+ - **Desktop: the instance panel toggles with ⌘I** (Ctrl+I on Linux and Windows), in place of ⌥⌘B /
6
+ Ctrl+Alt+B. As before, it does not fire inside a Linux/Windows terminal, where Ctrl+I is the program's
7
+ Tab. A rebinding you made in Keyboard shortcuts is kept.
8
+ - **Desktop: harness badges show recognisable marks instead of letters.**
9
+ Pi's badge is the official pi.dev press-kit mark (MIT; source and licence
10
+ in `packages/desktop/renderer/harness-marks/`), drawn in the theme's
11
+ colour. Claude Code shows an ivory four-pointed sparkle on a terracotta
12
+ tile, and Codex a `>_` prompt on an inverse tile. Both are OATS's own
13
+ drawings, not the official logos. The badge keeps its accessible name
14
+ ("Harness: <name>"), and an unknown harness still shows "?". Every mark
15
+ holds 4.5:1 on its tile in White, Solarized and Dark, and on a stopped
16
+ instance's dimmed row.
17
+ - **Desktop: Capabilities grouped by repository, and a clearer spawn preview.**
18
+ - **Capabilities.** Workspace owned and Repo owned are grouped by the
19
+ repository that defines each capability. Groups are headed like the Souls
20
+ tab: host first, then by name, external sources last. Pills (**All**, then
21
+ one per repository, each with its count) replace the Team and Repo
22
+ dropdowns. The Team dropdown never matched anything, because capability
23
+ rows carry no team.
24
+ - **Spawn dialog.** **What will be created** leads with the instance name and
25
+ its home, then works in, harness and model, team, relationship and runs on.
26
+ The launch-prompt policy is a note after them. Capability rows keep their
27
+ chips on a second, left-aligned line, and the column stacks its facts when
28
+ narrow. Cancel and Spawn stay together on one line at every width.
29
+ - **Dropdowns.** Every dropdown shares one themed style, and each theme
30
+ declares its `color-scheme`, so open lists and scrollbars follow light or
31
+ dark.
32
+ - **Desktop: the Teams tab says whose default each team is, and Setup names
33
+ the host and the members.** Each team card now has two rows, computed from
34
+ the workspace's committed `souls:` alone:
35
+ - **Default for**, e.g. "all souls of **lfx-ai-engineering**", or "every
36
+ soul without its own default" for the workspace's (or this deployment's)
37
+ default team;
38
+ - **May join**, e.g. "souls of **lfx-agents** · **ai-reviewer**
39
+ (lfx-ai-engineering)".
40
+
41
+ These replace "Who may join: N entries in souls:". The default team's card
42
+ comes first, the address is the card's quietest line, and members sit under
43
+ a "Members · N" head with their states in one column. In Workspace › Setup
44
+ (List), the host repository comes first with a **Host** badge naming
45
+ `oats-workspace.yaml`, and every member row, the host's included, has a
46
+ **Member** badge. A legend under the title explains both terms. The Graph
47
+ view's host leaf reads "host · member". No kernel or JSON change.
@@ -0,0 +1,56 @@
1
+ # OATS 0.45.0
2
+
3
+ ## Added
4
+
5
+ - **`oats souls` rows say what each soul composes.** Each row of
6
+ `oats souls --json` carries `capabilities`: the capabilities its
7
+ resolution composes, keyed like `oats capabilities` rows (`name`, `kind`,
8
+ `repoKey` or `package`), each with `from` (`soul` or `workspace`). A soul
9
+ that does not resolve has `null`. The Desktop uses it to say which souls
10
+ use a capability, including ones no live instance carries. Feature
11
+ `souls-capabilities`; `soulsApi` is unchanged. See
12
+ [`oats capabilities` and `oats souls`](../desktop-cli-api.md#oats-capabilities---dir---json--capabilitiesapi-1--oats-souls---dir---json--soulsapi-1).
13
+
14
+ ## Changed
15
+
16
+ - **The Desktop accepts OATS CLIs `>=0.25.8 <0.46.0`**, so it runs against
17
+ 0.45. Upgrade the Desktop and the CLI together: a 0.44 Desktop refuses a 0.45
18
+ CLI as outside its band. Without `souls-capabilities` (an older CLI), *Used by*
19
+ keeps its earlier, live-instance behaviour.
20
+ - **Desktop: Capabilities says which souls use each capability, without the
21
+ Source column.**
22
+ - **Used by.** With `souls-capabilities`, *Used by* lists the souls whose
23
+ composition includes the capability, matched by name and source (its
24
+ repository or package). Before, it listed only souls with a live instance
25
+ that recorded it, so a capability souls declare read "Not used" until one
26
+ ran. A soul that does not resolve is not counted, and a workspace default
27
+ still reads "Every soul". The capability page lists one row per soul, with
28
+ that soul's live instances carrying it (0 when none runs). A package
29
+ soul's instances are found by its `<package>--<soul>` agent name. With an
30
+ older OATS, *Used by* stays instance-derived, as before.
31
+ - **No Source column.** Each group's heading names where its capabilities
32
+ come from, so the column repeated it. The row's accessible name still
33
+ says "from <source>", and the capability page keeps its *Comes from*
34
+ card.
35
+ - **Packages grouped by package.** The Packages section is headed per
36
+ package, like the other two sections are per repository:
37
+ "package · v<version> · N capabilities".
38
+
39
+ - **Desktop: the Claude Code harness badge shows the Claude spark.** It
40
+ replaces the four-pointed sparkle from 0.44.1. The mark is Anthropic's spark,
41
+ geometry unmodified, in ivory on the same terracotta tile, and it holds 4.5:1
42
+ in White, Solarized and Dark. Pi and Codex are unchanged, and the badge keeps
43
+ its accessible name ("Harness: Claude"). Source and terms are in
44
+ `packages/desktop/renderer/harness-marks/README.md`.
45
+
46
+ ## Fixed
47
+
48
+ - **An operator soul may empty its knowledge and tasks slots.** Operator
49
+ coverage (readiness and doctor) excluded a soul that composes `oats.setup`
50
+ when it emptied any slot the workspace fills, so a setup soul with
51
+ `knowledge: none` or `tasks: none` left permanent warnings: its teams
52
+ uncovered, and `operator-soul-missing` naming it ("not usable here: …
53
+ slot-none") when it was the only one. Only `messaging: none` now excludes
54
+ it, so an operator stays reachable. The items' shape and codes are
55
+ unchanged. See
56
+ [Operator coverage items](../desktop-cli-api.md#operator-coverage-items).
@@ -481,12 +481,26 @@ export function requireMemberClone(prepared, { explicit } = {}) {
481
481
  /** Would a spawn of this discovered soul be refused before it touches this machine (feature desktop-facts)?
482
482
  * The same checks prepareInstance makes — souls.disabled, then the soul's resolution (its teams here, slot
483
483
  * conflicts, missing or private capabilities, compatibility …) — without spawning anything.
484
- * → { spawnable: true, problem: null } | { spawnable: false, problem: { code, message } } */
484
+ * `capabilities` (feature souls-capabilities) is what that one resolution composes, one entry per module in
485
+ * its order (by name, codepoint), keyed like an `oats capabilities` row — { name, kind: "member", repoKey,
486
+ * from } | { name, kind: "package", package, from } — with `from` its capabilitiesFrom ("soul" | "workspace").
487
+ * null whenever the soul is not spawnable: nothing resolved, so nothing is known to be composed.
488
+ * → { spawnable: true, problem: null, capabilities: [...] } | { spawnable: false, problem: { code, message }, capabilities: null } */
485
489
  export async function soulSpawnability(local, discovery, lock, soulEntry, { remoteOptions, remote } = {}) {
486
490
  const disabled = disabledEntry(local, soulEntry);
487
- if (disabled !== null) return { spawnable: false, problem: { code: "E_SOUL_DISABLED", message: `disabled on this machine (oats-local.yaml souls.disabled: ${disabled})` } };
488
- try { await resolveSoul(discovery, soulEntry, { local, lock, spawn: {}, remoteOptions, remote }); return { spawnable: true, problem: null }; }
489
- catch (e) { if (typeof e?.code === "string" && e.code.startsWith("E_")) return { spawnable: false, problem: { code: e.code, message: e.message } }; throw e; }
491
+ if (disabled !== null) return { spawnable: false, problem: { code: "E_SOUL_DISABLED", message: `disabled on this machine (oats-local.yaml souls.disabled: ${disabled})` }, capabilities: null };
492
+ let resolution;
493
+ try { resolution = await resolveSoul(discovery, soulEntry, { local, lock, spawn: {}, remoteOptions, remote }); }
494
+ catch (e) { if (typeof e?.code === "string" && e.code.startsWith("E_")) return { spawnable: false, problem: { code: e.code, message: e.message }, capabilities: null }; throw e; }
495
+ return { spawnable: true, problem: null, capabilities: composedCapabilities(resolution) };
496
+ }
497
+
498
+ /** A resolution's modules as `oats capabilities` row identities, each with why the soul has it (feature
499
+ * souls-capabilities). Only the identity keys: no commit, version, layer or integrity. */
500
+ function composedCapabilities(resolution) {
501
+ return resolution.modules.map((m) => m.from.kind === "package"
502
+ ? { name: m.name, kind: "package", package: m.from.package, from: resolution.capabilitiesFrom[m.name] }
503
+ : { name: m.name, kind: "member", repoKey: m.from.repoKey, from: resolution.capabilitiesFrom[m.name] });
490
504
  }
491
505
 
492
506
  /** The async half of a spawn: everything that touches the network. Returns a
@@ -8,6 +8,10 @@ import { resolveSoul } from "./resolve.mjs";
8
8
 
9
9
  export const OPERATOR_CAPABILITY = "oats.setup";
10
10
  const SEAT = "an eligible soul is not a launched seat";
11
+ /** The core slot an operator must not empty (maintainer decision, 0.45.0): messaging, so it is reachable.
12
+ * Emptying knowledge or tasks (`knowledge: none`, `tasks: none`) does not disqualify an operator. Only
13
+ * `slot-none` is judged here: a capability the soul turns `off` is not (#671's rule, unchanged). */
14
+ const OPERATOR_SLOTS = new Set(["messaging"]);
11
15
 
12
16
  /** The Desktop refuses a whole readiness answer whose item `reason` or `remedy` is over 1024 characters
13
17
  * (packages/desktop/renderer/readiness-contract.mjs): each detail is clipped, lists show three and a count,
@@ -26,9 +30,9 @@ const declaresOperator = (entry) => obj(entry?.definition?.capabilities) && Obje
26
30
  /**
27
31
  * The coverage of the workspace and of `teams` (labels), from one discovery. A soul covers when it is
28
32
  * offered (soulCandidates), not disabled here (souls.disabled), resolves as a spawn would (resolveSoul),
29
- * composes oats.setup, and empties no layer slot the workspace selects (no `slot-none` in turnedOff:
30
- * the operator keeps the workspace's chosen core, messaging and knowledge). It covers a team when the
31
- * team is among its resolved teams. Souls are resolved in turn until every question is answered.
33
+ * composes oats.setup, and does not empty the messaging slot the workspace fills (no `slot-none` on
34
+ * messaging in turnedOff: it stays reachable; `knowledge: none` and `tasks: none` are its own choice).
35
+ * It covers a team when the team is among its resolved teams. Souls are resolved in turn until every question is answered.
32
36
  *
33
37
  * → { known: true, workspace: { covered, by }, teams: [{ label, covered, by }], excluded: [{ soul, code, slots? }] }
34
38
  * | { known: false, reason }
@@ -67,8 +71,8 @@ export async function operatorCoverage({ discovery, local = null, lock = null, t
67
71
  throw e;
68
72
  }
69
73
  if (!(res.modules || []).some((m) => m.name === OPERATOR_CAPABILITY)) continue;
70
- const emptied = (res.turnedOff || []).filter((o) => o.reason === "slot-none");
71
- if (emptied.length) { excluded.push({ soul, code: "slot-none", slots: emptied.map((o) => o.slot) }); continue; }
74
+ const emptied = (res.turnedOff || []).filter((o) => o.reason === "slot-none" && OPERATOR_SLOTS.has(o.slot));
75
+ if (emptied.length) { excluded.push({ soul, code: "slot-none", slots: [...new Set(emptied.map((o) => o.slot))] }); continue; }
72
76
  by.workspace ??= soul;
73
77
  for (const t of res.teams || []) if (wanted.includes(t.label) && !by.teams.has(t.label)) by.teams.set(t.label, soul);
74
78
  }
@@ -89,7 +93,7 @@ export function operatorProblems(coverage, { workspace = null, unknownRemedy = "
89
93
  if (!coverage?.known) return [{ code: "operator-coverage-unknown", message: clip(`operator coverage unknown: ${clip(coverage?.reason ?? "not computed", 700)}; this says nothing about whether an operator soul exists`, MAX_TEXT), remedy: clip(unknownRemedy, MAX_TEXT) }];
90
94
  const named = workspace ? `workspace ${workspace}` : "this workspace";
91
95
  const why = coverage.excluded.length ? ` (not usable here: ${some(coverage.excluded.map((x) => clip(`${x.soul} ${x.code}${x.slots ? ` ${x.slots.join(",")}` : ""}`)))})` : "";
92
- const remedy = `give a soul the ${OPERATOR_CAPABILITY} capability in its soul.yaml (reviewed source), keeping the workspace's core, messaging and knowledge, then \`oats spawn <soul> --preview\``;
96
+ const remedy = `give a soul the ${OPERATOR_CAPABILITY} capability in its soul.yaml (reviewed source), keeping the workspace's messaging (no \`messaging: none\`), then \`oats spawn <soul> --preview\``;
93
97
  const out = [];
94
98
  if (!coverage.workspace.covered) {
95
99
  out.push({ code: "operator-soul-missing", message: clip(`no soul ${clip(named)} offers composes ${OPERATOR_CAPABILITY}, so it has no operator soul${why}; ${SEAT}`, MAX_TEXT), remedy, excluded: coverage.excluded });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@awebai/oats",
3
- "version": "0.44.0",
3
+ "version": "0.45.0",
4
4
  "description": "OATS (Open Agent Team Specification) — durable souls, disposable instances, targetable capability packages, and the runtime-neutral oats CLI/kernel.",
5
5
  "keywords": [
6
6
  "agents",