@awebai/oats 0.69.22 → 0.69.24
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 +185 -38
- package/docs/capabilities.md +365 -7
- package/docs/capability-manifest.schema.json +37 -1
- package/docs/configuration.md +27 -7
- package/docs/container.md +206 -228
- package/docs/design/2026-11-19-sandboxes.md +1352 -0
- package/docs/design/2026-11-20-provider-home-lifecycle.md +320 -0
- package/docs/design/README.md +7 -0
- package/docs/desktop-cli-api.md +673 -81
- package/docs/desktop.md +241 -65
- package/docs/execution-targets.md +186 -3
- package/docs/first-team.md +11 -0
- package/docs/implementation.md +6 -2
- package/docs/integrations.md +3 -3
- package/docs/knowledge-capability-authoring.md +10 -7
- package/docs/knowledge-reference/acceptance.md +21 -19
- package/docs/knowledge-reference/adoption.md +18 -4
- package/docs/knowledge-reference/model.md +11 -9
- package/docs/knowledge-reference/package-craft.md +2 -2
- package/docs/knowledge-reference/proposal.md +127 -0
- package/docs/knowledge-reference/provider-mapping.md +10 -10
- package/docs/knowledge-reference/reader-capture.md +26 -22
- package/docs/knowledge-theory.md +1 -1
- package/docs/knowledge.md +25 -16
- package/docs/official-catalog.md +4 -4
- package/docs/packages.md +13 -13
- package/docs/release-notes/v0.69.23.md +231 -0
- package/docs/release-notes/v0.69.24.md +264 -0
- package/docs/servers.md +10 -6
- package/docs/souls-and-instances.md +96 -22
- package/docs/tui.md +25 -4
- package/docs/upgrading.md +19 -5
- package/docs/workspaces.md +14 -6
- package/lib/argv.mjs +6 -2
- package/lib/capability-contract.mjs +2 -2
- package/lib/capability-show.mjs +11 -1
- package/lib/command-flags.mjs +40 -3
- package/lib/compile-cache.mjs +1 -1
- package/lib/core.mjs +1201 -195
- package/lib/errors.mjs +4 -1
- package/lib/hook-env.mjs +106 -0
- package/lib/host-run.mjs +11 -3
- package/lib/instance-board.mjs +337 -0
- package/lib/instance-events.mjs +48 -10
- package/lib/instance-inspect.mjs +44 -0
- package/lib/instance-lifecycle.mjs +34 -18
- package/lib/instance-listing.mjs +113 -16
- package/lib/instance-related-work.mjs +143 -0
- package/lib/kernel-features.mjs +13 -1
- package/lib/node-version.mjs +9 -0
- package/lib/provider-call-child.mjs +60 -0
- package/lib/provider-resume.mjs +83 -0
- package/lib/provider-test-seams.mjs +20 -0
- package/lib/read-call.mjs +2 -0
- package/lib/reserved-launch-env.mjs +8 -1
- package/lib/retire-admission.mjs +5 -1
- package/lib/schedule.mjs +14 -4
- package/lib/servers.mjs +151 -17
- package/lib/session-inspect.mjs +104 -13
- package/lib/session-providers.mjs +528 -0
- package/lib/session-resume.mjs +68 -15
- package/lib/stable-node.mjs +3 -0
- package/lib/triggers.mjs +3 -1
- package/package-catalog.json +3 -3
- package/package.json +2 -1
- package/packages/client/capability-list.mjs +21 -0
- package/packages/client/cli-adapter.mjs +19 -4
- package/packages/client/cli-locator.mjs +5 -1
- package/packages/client/deployment-data.mjs +27 -3
- package/packages/client/deployment-panel.mjs +27 -4
- package/packages/client/home-board.mjs +33 -19
- package/packages/client/inspect-boundary.mjs +18 -8
- package/packages/client/instance-acts.mjs +30 -3
- package/packages/client/instance-board.mjs +206 -0
- package/packages/client/instance-presentation.mjs +55 -0
- package/packages/client/instance-tree.mjs +34 -4
- package/packages/client/keymap.mjs +5 -0
- package/packages/client/liveness.mjs +15 -4
- package/packages/client/mail-contract.mjs +130 -0
- package/packages/client/own-codes.mjs +5 -1
- package/packages/client/panel-views.mjs +7 -7
- package/packages/client/related-work.mjs +84 -0
- package/packages/client/remote-roster.mjs +9 -3
- package/packages/client/session-backends.mjs +31 -0
- package/packages/client/session-start.mjs +18 -6
- package/packages/client/spawn-apply-cli.mjs +5 -3
- package/packages/client/spawn-apply-contract.mjs +25 -2
- package/packages/client/spawn-apply.mjs +5 -1
- package/packages/client/spawn-messages.mjs +3 -0
- package/packages/client/terminal-contract.mjs +4 -0
- package/packages/client/waiting-on-you.mjs +12 -2
- package/packages/client/workspace-cli.mjs +13 -2
- package/packages/tui/lib/model.mjs +14 -3
- package/packages/tui/lib/store.mjs +12 -3
- package/skills/oats-getting-started/SKILL.md +11 -8
- package/docs/knowledge-reference/harvester.md +0 -109
- package/lib/instance-same-work.mjs +0 -67
- package/packages/client/same-work.mjs +0 -49
package/lib/argv.mjs
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* Dependency-free. */
|
|
5
5
|
|
|
6
6
|
/** The kernel's switches: a value never rides one (`--yolo=false` must not turn yolo on). */
|
|
7
|
-
const KERNEL_SWITCHES = new Set(["allow-child-spawns", "apply", "background", "check", "clear", "composed-skills", "delete-branch", "discard-worktree", "dry-run", "ephemeral", "force", "help", "host", "if-absent", "install-oats", "instructions", "json", "keep-dir", "keep-env", "no-background", "no-child-spawns", "no-default", "no-launch", "no-recursive", "no-yolo", "plan", "policy", "preview", "print", "replace", "run-source", "same-work", "self", "skills", "suggest-name", "verbose", "yes", "yolo"]);
|
|
7
|
+
const KERNEL_SWITCHES = new Set(["allow-child-spawns", "apply", "background", "board", "check", "clear", "composed-skills", "delete-branch", "discard-worktree", "dry-run", "ephemeral", "force", "help", "host", "if-absent", "install-oats", "instructions", "json", "keep-dir", "keep-env", "no-background", "no-child-spawns", "no-default", "no-launch", "no-recursive", "no-yolo", "plan", "policy", "preview", "print", "related-work", "replace", "run-source", "same-work", "self", "skills", "suggest-name", "verbose", "yes", "yolo"]);
|
|
8
8
|
/** `--flag=value` is `--flag value`: every kernel reader (flag(), valueFlag(), the onboard and
|
|
9
9
|
* routed-command loops) then applies the spaced form's validation to it. `problem` is an empty
|
|
10
10
|
* `--flag=`, a switch given a value, or a value that is itself an option (`--model=--yolo`):
|
|
@@ -16,8 +16,12 @@ const INLINE_TEXT_FLAGS = new Set(["message"]);
|
|
|
16
16
|
/** Free-text flags whose inline value is always kept whole, the empty one included:
|
|
17
17
|
* `--description=` clears a trigger's or schedule's description. */
|
|
18
18
|
const INLINE_WHOLE_FLAGS = new Set(["description"]);
|
|
19
|
+
/** A word that is a switch everywhere but one form, where it takes a value: `oats instance board ask
|
|
20
|
+
* --clear <id>` (feature instance-board). There, `--clear=<id>` is `--clear <id>`. */
|
|
21
|
+
const VALUE_IN_FORM = [{ words: ["instance", "board", "ask"], name: "clear" }];
|
|
19
22
|
export function expandInlineValues(argv) {
|
|
20
23
|
const out = [];
|
|
24
|
+
const valued = new Set(VALUE_IN_FORM.filter((f) => f.words.every((w, i) => argv[i] === w)).map((f) => f.name));
|
|
21
25
|
const inline = new Map();
|
|
22
26
|
let problem;
|
|
23
27
|
for (const a of argv) {
|
|
@@ -25,7 +29,7 @@ export function expandInlineValues(argv) {
|
|
|
25
29
|
if (!a.startsWith("--") || eq <= 2) { out.push(a); continue; }
|
|
26
30
|
const name = a.slice(2, eq), value = a.slice(eq + 1);
|
|
27
31
|
if (INLINE_WHOLE_FLAGS.has(name) || (INLINE_TEXT_FLAGS.has(name) && value.startsWith("--"))) { inline.set(name, value); out.push(`--${name}`); continue; }
|
|
28
|
-
problem ??= KERNEL_SWITCHES.has(name) ? `--${name} takes no value (got ${a})` : value === "" ? `--${name}= needs a value` : value.startsWith("--") ? `--${name}= takes a value, not an option (got ${a})` : undefined;
|
|
32
|
+
problem ??= KERNEL_SWITCHES.has(name) && !valued.has(name) ? `--${name} takes no value (got ${a})` : value === "" ? `--${name}= needs a value` : value.startsWith("--") ? `--${name}= takes a value, not an option (got ${a})` : undefined;
|
|
29
33
|
out.push(`--${name}`, value);
|
|
30
34
|
}
|
|
31
35
|
return { argv: out, problem, inline };
|
|
@@ -181,13 +181,13 @@ const DISPOSABLE_HOME_PREFIX_RE = /^\.[A-Za-z0-9_][A-Za-z0-9._-]*-\*$/;
|
|
|
181
181
|
* declaration may not cover them: these exact names, and every exact name
|
|
182
182
|
* starting with one of these prefixes (the events log; the stop, restart and
|
|
183
183
|
* start receipts and locks; the rollback marker; AGENTS.md backups; the
|
|
184
|
-
* attachments directory; the instance colour, `.oats-color.json`; the background record, `.oats-background.json`; the pin, `.oats-pinned.json`; the
|
|
184
|
+
* attachments directory; the instance colour, `.oats-color.json`; the background record, `.oats-background.json`; the pin, `.oats-pinned.json`; the related-work flag, `.oats-related-work.json`, and `.oats-same-work.json`, the file of the same-work flag it replaced, which the kernel still reads while the new one is absent; the agent's board, `.oats-board.json`, and its lock). This is the one list: a new kernel-written top-level
|
|
185
185
|
* home entry MUST be added here and to the `not` patterns of
|
|
186
186
|
* `retirement.disposable.home` in docs/capability-manifest.schema.json. A
|
|
187
187
|
* prefix declaration can reach none of them except through `.oats-`, which is
|
|
188
188
|
* refused whole; `.oats-<provider>` as an exact name stays declarable. */
|
|
189
189
|
const KERNEL_HOME_NAMES = new Set([".oats", ".agents", ".claude"]);
|
|
190
|
-
const KERNEL_HOME_NAME_PREFIXES = [".oats-events", ".oats-stop", ".oats-restart", ".oats-rollback", ".oats-agents-md", ".oats-start", ".oats-attachments", ".oats-color", ".oats-background", ".oats-pinned", ".oats-same-work"];
|
|
190
|
+
const KERNEL_HOME_NAME_PREFIXES = [".oats-events", ".oats-stop", ".oats-restart", ".oats-rollback", ".oats-agents-md", ".oats-start", ".oats-attachments", ".oats-color", ".oats-background", ".oats-pinned", ".oats-same-work", ".oats-related-work", ".oats-board"];
|
|
191
191
|
|
|
192
192
|
/** Why `root` is not a declarable home entry: "shape" (not one hidden top-level
|
|
193
193
|
* name or prefix), "kernel-owned", or undefined when it is sound. */
|
package/lib/capability-show.mjs
CHANGED
|
@@ -32,6 +32,7 @@ import { capabilitySkills, lockedCapability, lockedPackageCapabilities, manifest
|
|
|
32
32
|
import { memberRowByKey } from "./workspace.mjs";
|
|
33
33
|
import { sameRepo } from "./repo-moves.mjs";
|
|
34
34
|
import { triggerSourcesOf } from "./trigger-sources.mjs";
|
|
35
|
+
import { sessionProvidersOf } from "./session-providers.mjs";
|
|
35
36
|
|
|
36
37
|
export const CAPABILITY_SHOW_API = 1;
|
|
37
38
|
/** A text is cut to at most this many UTF-8 bytes; binary detection examines this many + 3. */
|
|
@@ -194,6 +195,15 @@ function triggerSourceKeys(manifest) {
|
|
|
194
195
|
return { triggerSources: manifest.triggerSources, ...(problems.length ? { triggerSourceProblems: problems } : {}) };
|
|
195
196
|
}
|
|
196
197
|
|
|
198
|
+
/** The session providers a manifest declares (lib/session-providers.mjs), as declared, and the problems a
|
|
199
|
+
* `--backend` naming them would get: added keys, each only when there is something to say. A malformed
|
|
200
|
+
* declaration is shown, never refused. */
|
|
201
|
+
function sessionProviderKeys(manifest) {
|
|
202
|
+
if (manifest?.sessionProviders === undefined) return {};
|
|
203
|
+
const { problems } = sessionProvidersOf(manifest);
|
|
204
|
+
return { sessionProviders: manifest.sessionProviders, ...(problems.length ? { sessionProviderProblems: problems } : {}) };
|
|
205
|
+
}
|
|
206
|
+
|
|
197
207
|
/** The show answer (capabilityShowApi 1): the inject with its text, each skill with its description and files. */
|
|
198
208
|
export async function capabilityShow(source, { remote, remoteOptions }) {
|
|
199
209
|
const r = bindRemote(remote, remoteOptions);
|
|
@@ -220,7 +230,7 @@ export async function capabilityShow(source, { remote, remoteOptions }) {
|
|
|
220
230
|
skills.push({ name: skill.name, path: skill.path, description, files: skill.files, filesTruncated: skill.filesTruncated });
|
|
221
231
|
}
|
|
222
232
|
}
|
|
223
|
-
return { ...header(source), repoKey: source.repoKey, package: source.package, version: source.version, commit, path: dir, inject, skills, problems, warnings: contractWarnings(source), ...triggerSourceKeys(source.manifest) };
|
|
233
|
+
return { ...header(source), repoKey: source.repoKey, package: source.package, version: source.version, commit, path: dir, inject, skills, problems, warnings: contractWarnings(source), ...triggerSourceKeys(source.manifest), ...sessionProviderKeys(source.manifest) };
|
|
224
234
|
}
|
|
225
235
|
|
|
226
236
|
/** The `--file` answer: one file the show lists (the inject, or a listed skill file), at the row's commit.
|
package/lib/command-flags.mjs
CHANGED
|
@@ -6,8 +6,28 @@
|
|
|
6
6
|
* missing here is not checked. Kernel-private, not exported from `./core`. Dependency-free. */
|
|
7
7
|
|
|
8
8
|
export const RETIRE_DELETE_BRANCH_REFUSED = "oats retire no longer deletes branches: --delete-branch is not accepted. Retire without it; the branch is left in the repository. Inspect it there and delete it with Git if it is no longer wanted.";
|
|
9
|
+
/** The spellings the related-work rename (feature instance-related-work) kept as deprecated aliases
|
|
10
|
+
* (feature instance-same-work, the compatibility layer): `oats spawn … --same-work` is `--related-work`,
|
|
11
|
+
* and `oats instance same-work` is `oats instance related-work`. Each use prints its line on stderr, once,
|
|
12
|
+
* before the command runs or is sent to a --server host (sameWorkDeprecation, the dispatch's), and never
|
|
13
|
+
* in a --json answer. spawnInstance's `sameWork` option is the same alias (lib/core.mjs). */
|
|
14
|
+
export const SAME_WORK_ALIASES = Object.freeze({
|
|
15
|
+
flag: "--same-work is renamed: use --related-work",
|
|
16
|
+
verb: "oats instance same-work is renamed: use oats instance related-work",
|
|
17
|
+
});
|
|
18
|
+
|
|
19
|
+
/** spawnInstance's deprecated option, said as a DeprecationWarning (code OATS_SAME_WORK) by lib/core.mjs. */
|
|
20
|
+
export const SAME_WORK_OPTION_RENAMED = "sameWork is renamed: use relatedWork";
|
|
21
|
+
|
|
22
|
+
/** The deprecation line `argv` (the CLI's argv, after `oats`, as typed) earns by an alias of
|
|
23
|
+
* SAME_WORK_ALIASES, or undefined. */
|
|
24
|
+
export function sameWorkDeprecation(argv) {
|
|
25
|
+
if (argv[0] === "instance" && argv[1] === "same-work") return SAME_WORK_ALIASES.verb;
|
|
26
|
+
if (argv[0] === "spawn" && argv.some((a) => a === "--same-work" || a.startsWith("--same-work="))) return SAME_WORK_ALIASES.flag;
|
|
27
|
+
return undefined;
|
|
28
|
+
}
|
|
9
29
|
export const RETIRE_USAGE = "usage: oats retire <instance> [--plan] [--plan-revision <rev> --idempotency-key <key>] [--home <path>] [--dir <d>] [--server <id>] [--self] [--discard-worktree] [--keep-dir] [--force] [--json]";
|
|
10
|
-
export const SPAWN_USAGE = "usage: oats spawn <agent> [--task <text>|--task-file <f>] [--purpose <slug>|--name <slug>|--suggest-name] [--preview] [--base <ref>] [--model <id>|@native-default] [--allow-child-spawns|--no-child-spawns] [--relation child|sibling|parent|unrelated --relative-to <instance> [--relative-root <agents-root>]] [--parent <instance>] [--same-work] [--repo <r>] [--work worktree|checkout|attached|workspace|directory] [--work-dir <owner-work>] [--harness pi|claude|codex] [--backend tmux] [--yolo|--no-yolo] [--background|--no-background] [--model <m>] [--branch <b>] [--no-launch] [--json]";
|
|
30
|
+
export const SPAWN_USAGE = "usage: oats spawn <agent> [--task <text>|--task-file <f>] [--purpose <slug>|--name <slug>|--suggest-name] [--preview] [--base <ref>] [--model <id>|@native-default] [--allow-child-spawns|--no-child-spawns] [--relation child|sibling|parent|unrelated --relative-to <instance> [--relative-root <agents-root>]] [--parent <instance>] [--related-work|--same-work] [--repo <r>] [--work worktree|checkout|attached|workspace|directory] [--work-dir <owner-work>] [--harness pi|claude|codex] [--backend tmux|<session provider>] [--yolo|--no-yolo] [--background|--no-background] [--model <m>] [--branch <b>] [--no-launch] [--json]";
|
|
11
31
|
export const SYNC_USAGE = "usage: oats sync [--dir <deployment>] [--plan] [--json]";
|
|
12
32
|
export const APPROVAL_REMOVED = "package approval was removed; declaring a package in packages: is the trust decision";
|
|
13
33
|
export const TEAMS_USAGE = "usage: oats teams [--json] | oats teams add <label> --team <id> [--description <d>] [--no-default] | oats teams remove <label> | oats teams default <label> [--if-absent | --expect <label>] [--dir <deployment>] [--json]";
|
|
@@ -38,6 +58,16 @@ const waiting = (verb) => ({ command: `instance waiting ${verb}`, operands: [],
|
|
|
38
58
|
usage: `usage: oats instance waiting ${verb} --producer <id>${verb === "set" ? " --reason permission|question|attention" : ""} [--message=<text>] [--home <abs>] [--dir <d>] [--json]` });
|
|
39
59
|
const ATTENTION_USAGE = "usage: oats instance attention [--message=<text>] [--clear] [--json]";
|
|
40
60
|
const attentionHasNo = (flag) => `oats instance attention has no ${flag}: it records the agent's own claim on the instance it runs in ($OATS_INSTANCE_HOME); ${ATTENTION_USAGE}`;
|
|
61
|
+
/** `oats instance board`'s forms (feature instance-board), each its own usage line; BOARD_USAGE all of them. */
|
|
62
|
+
const BOARD_FORMS = Object.freeze({
|
|
63
|
+
set: "oats instance board set <key> --label <text> --value <text> [--unit <text>] [--link <https-url>] [--json]",
|
|
64
|
+
unset: "oats instance board unset <key> [--json]",
|
|
65
|
+
ask: "oats instance board ask <question> --option <text> --option <text> [--option <text>]… [--id <id>] [--context-file <f>] [--json] | oats instance board ask --clear <id> [--json]",
|
|
66
|
+
});
|
|
67
|
+
export const BOARD_USAGE = `usage: ${Object.values(BOARD_FORMS).join(" | ")}`;
|
|
68
|
+
/** `oats instance board` records on the instance it runs in, as `attention` does: these are refused in its words. */
|
|
69
|
+
const boardRefused = (verb) => Object.freeze(Object.fromEntries(["--home", "--dir", "--server"].map((f) => [f, `oats instance board has no ${f}: it records on the board of the instance it runs in ($OATS_INSTANCE_HOME); usage: ${BOARD_FORMS[verb]}`])));
|
|
70
|
+
const board = (verb, operand, values, required = 1) => ({ command: `instance board ${verb}`, operands: [operand], required, values, switches: ["--json"], refused: boardRefused(verb), usage: `usage: ${BOARD_FORMS[verb]}` });
|
|
41
71
|
const TRIGGER_RUN_SOURCE = Object.freeze(["--run-source", "--json"]);
|
|
42
72
|
const SESSION_ADDRESS = Object.freeze(["--home", "--instance", "--server"]);
|
|
43
73
|
/** Every `oats session` form refuses the captured path's selector in these words (bin's sessionCmd says them
|
|
@@ -82,7 +112,7 @@ export const COMMAND_FLAGS = Object.freeze([
|
|
|
82
112
|
{ command: "spawn", operands: ["soul"],
|
|
83
113
|
values: ["--agents-root", "--backend", "--base", "--branch", "--dir", "--expect-decision", "--harness", "--herdr-socket", "--idempotency-key", "--instance", "--launch-config", "--max-age", "--model", "--name", "--parent", "--provider", "--purpose", "--relation", "--relative-root", "--relative-to", "--repo", "--runtime", "--server", "--task", "--task-file", "--trigger-event", "--wake-cron", "--wake-every", "--wake-file", "--wake-json", "--wake-message", "--wake-message-file", "--wake-tz", "--work", "--work-dir"],
|
|
84
114
|
arity: { "--provider": 2 },
|
|
85
|
-
switches: ["--allow-child-spawns", "--background", "--json", "--no-background", "--no-child-spawns", "--no-launch", "--no-yolo", "--preview", "--same-work", "--suggest-name", "--yolo"],
|
|
115
|
+
switches: ["--allow-child-spawns", "--background", "--json", "--no-background", "--no-child-spawns", "--no-launch", "--no-yolo", "--preview", "--related-work", "--same-work", "--suggest-name", "--yolo"],
|
|
86
116
|
// Local souls (local-agents/) are gone with the workspace model: a soul is a member
|
|
87
117
|
// repository's souls/<name>, so spawn never writes one.
|
|
88
118
|
refused: { "--instructions-file": SPAWN_REMOVED_SOUL("--instructions-file"), "--def-file": SPAWN_REMOVED_SOUL("--def-file"),
|
|
@@ -103,11 +133,18 @@ export const COMMAND_FLAGS = Object.freeze([
|
|
|
103
133
|
usage: "usage: oats instance color <instance> (<color> | --clear) [--home <abs>] [--dir <d> | --server <id>] [--json]" },
|
|
104
134
|
onOff("background"),
|
|
105
135
|
onOff("pin"),
|
|
136
|
+
onOff("related-work"),
|
|
137
|
+
// The verb's deprecated alias (SAME_WORK_ALIASES): the same arguments.
|
|
106
138
|
onOff("same-work"),
|
|
107
139
|
waiting("set"),
|
|
108
140
|
waiting("clear"),
|
|
109
141
|
{ command: "instance attention", operands: [], values: ["--message"], switches: ["--clear", "--json"],
|
|
110
142
|
refused: Object.fromEntries(["--home", "--dir", "--producer", "--reason"].map((f) => [f, attentionHasNo(f)])), usage: ATTENTION_USAGE },
|
|
143
|
+
board("set", "key", ["--label", "--value", "--unit", "--link"]),
|
|
144
|
+
board("unset", "key", []),
|
|
145
|
+
// `--clear <id>` takes the id as its value, so the question is optional here; the command refuses a form
|
|
146
|
+
// with neither, or with both.
|
|
147
|
+
board("ask", "question", ["--option", "--id", "--context-file", "--clear"], 0),
|
|
111
148
|
{ command: "instance suggest-name", operands: [], values: ["--soul", "--task", "--task-file", "--harness", "--model", "--launch-config", "--dir"], switches: ["--json"],
|
|
112
149
|
refused: { "--server": "instance suggest-name takes no --server: it runs this machine's harness, for a spawn that may land on another; the host it lands on makes the name unique (or names an unnamed --suggest-name spawn itself)" },
|
|
113
150
|
usage: "usage: oats instance suggest-name [--soul <soul>] (--task <t> | --task-file <f>) [--harness claude|pi] [--model <m>] [--launch-config <n>] [--dir <d>] [--json]" },
|
|
@@ -121,7 +158,7 @@ export const COMMAND_FLAGS = Object.freeze([
|
|
|
121
158
|
refused: { ...NATIVE_RECORD_GONE, "--resume": "--resume exists on session start only: it brings back a session that was lost" },
|
|
122
159
|
usage: "usage: oats session restart (--home <abs> | --server <id> (--instance <name> | --home <abs>)) [--launch-config <name>|none | --reselect-launch] [--harness pi|claude|codex] [--model <id>] [--yolo|--no-yolo] [--stop-grace <seconds>] [--json]" },
|
|
123
160
|
{ command: "session resume", operands: [], values: ["--deployment"],
|
|
124
|
-
refused: { ...NATIVE_RECORD_GONE, "--server": RESUME_LOCAL_ONLY }, switches: ["--plan", "--json"], usage: "usage: oats session resume [--deployment <dir>] [--plan] [--json]" },
|
|
161
|
+
refused: { ...NATIVE_RECORD_GONE, "--server": RESUME_LOCAL_ONLY }, switches: ["--plan", "--without-provider-inspect", "--json"], usage: "usage: oats session resume [--deployment <dir>] [--plan [--without-provider-inspect]] [--json]" },
|
|
125
162
|
{ command: "session input", operands: [], refused: NATIVE_RECORD_GONE, values: ["--home", "--text-file"], switches: ["--json"], usage: "usage: oats session input --home <abs> [--text-file <path>] [--json]" },
|
|
126
163
|
{ command: "session receive", operands: [], refused: NATIVE_RECORD_GONE, values: ["--home", "--name"], switches: ["--json"], usage: "usage: oats session receive --home <abs> --name <file name> [--json]" },
|
|
127
164
|
{ command: "session upload", operands: [], refused: NATIVE_RECORD_GONE, values: ["--file", ...SESSION_ADDRESS], switches: ["--json"],
|
package/lib/compile-cache.mjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/** Node's compile cache for the CLI (awebai/oats#1630): V8 keeps the code it compiled for the
|
|
2
2
|
* kernel's modules, so a command does not recompile them all on every run. Kernel-private, not
|
|
3
3
|
* exported from `./core` and not a contract: `bin/oats.mjs` calls enableCliCompileCache before it
|
|
4
|
-
* imports the kernel (only
|
|
4
|
+
* imports the kernel (only dependency-free startup helpers are parsed before), and in-process
|
|
5
5
|
* consumers never call it (they run in their own processes).
|
|
6
6
|
*
|
|
7
7
|
* - The cache is `$OATS_HOME_DIR/compile-cache` (`~/.oats/compile-cache`), made 0700 here: Node's
|