@chengchenccc/oh-my-agent 0.2.0-rc.2 → 0.2.0-rc.3

package/README.md

@@ -7,7 +7,7 @@ Product Backend → Agent Run → Adapter → spawn oma --mode rpc
 → per-Run Runtime → BackendRunOutcome → stdout → child 退出
 ```
 
-**不是 daemon**：一个 Run = 一个子进程 = 一个 Runtime = 一个 outcome。没有常驻进程、没有 session supervisor、没有 worker pool。
+**不是 daemon**（就 Run 执行模型而言）：一个 Run = 一个子进程 = 一个 Runtime = 一个 outcome。没有常驻的 session supervisor，没有 worker pool。同一个包里的 `core/gateway/` 是另一回事——`oma gateway up -d` 确实会起一个 detached daemon，那是它自己的 pidfile 加 supervisor，与 Run 无关。
 
 ## TUI
 
@@ -38,13 +38,13 @@ Product Backend → Agent Run → Adapter → spawn oma --mode rpc
 
 ## Runtime
 
-`createOmaRuntime()`（`src/core/create-runtime.ts`）构造一个 Runtime = 一个 Run：
+`createOmaRuntime()`（`src/core/runtime/create-runtime.ts`）构造一个 Runtime = 一个 Run：
 
 - `run(input)` 返回唯一 segment，其 `outcome` 是 Run 的唯一终态；
 - `steer(input)` 注入 live loop；`stop()` 中止；
 - `close()` 拆除 MCP clients 与 SessionStore。
 
-Runtime 主体就在本 app 的 `src/core/`：OmaSession（model/tool loop、retry、compaction、插件、todo、tool-result pruning）与 in-memory SessionStore（`core/store/`）。seed 时把 **full Product history + meta + input** 原子写入，Run 结束即销毁。
+Runtime 主体就在本 app 的 `src/core/`：OmaSession（model/tool loop、retry、compaction、插件、todo、tool-result pruning）与 in-memory SessionStore（`core/store/`）。in-memory store 随 Run 销毁，但子进程会把本轮写进自己的 session 文件（`core/session/` 的 JSONL），并通过 outcome 回传 `cliSessionRef`；下一个 Run 用它 resume 那个文件，扁平的历史桥只在没有引用时才用。
 
 ## 运行
 
@@ -53,7 +53,7 @@ bun run --cwd apps/oh-my-agent dev -- -p "hello"    # source CLI (dev)
 bun apps/oh-my-agent/src/cli.ts -p "hello"          # source CLI, direct
 
 bun run --cwd apps/oh-my-agent build                # → dist/cli.js (executable)
-apps/oh-my-agent/dist/cli.js -p "hello"             # built binary
+./dist/cli.js -p "hello"                            # built binary (inside apps/oh-my-agent)
 
 cd apps/oh-my-agent && bun link                     # optional local install
 oma -p "hello"                              # then run from anywhere
@@ -69,9 +69,14 @@ oma                                     # standalone interactive TUI
 src/
   cli.ts                可执行入口（shebang + runCli()）
   main.ts               main()/runCli()：参数解析、模式分发、退出码（无 process.exit）
-  cli/                  print/json 模式、初始输入构建、CLI 测试
+  cli/                  参数解析、初始输入构建、gateway 子命令
   modes/                tui / print / json / rpc 模式
-  core/                 create-runtime.ts（per-Run Runtime 装配）、project-settings.ts（.oma/settings.json）、fake-provider（测试）
+  core/
+    runtime/            create-runtime.ts（per-Run Runtime 装配）
+    session/            session 文件（JSONL）：/resume、--continue 与跨 Run resume 的持久侧
+    settings/           project-settings.ts（.oma/settings.json）
+    loops/ goals/ plans/  三种持续模式的状态机与工具面
+    gateway/            `oma gateway` 的 daemon、supervisor、doctor、artifact
 ```
 
 ## 相关文档

package/dist/cli/args.d.ts

@@ -1,6 +1,6 @@
 import { type GatewayCommand } from "./gateway-commands.js";
 export type CliMode = "print" | "json" | "rpc" | "tui";
-export type PermissionFlag = "ask" | "auto" | "deny" | "off";
+export type PermissionFlag = "ask" | "auto" | "deny" | "off" | "yolo";
 export interface CliArgs {
     mode: CliMode;
     /** True when -p/--mode was given explicitly; a bare positional prompt

package/dist/cli/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAoB,MAAM,uBAAuB,CAAC;AAE7F,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,OAAO,CAAC;IACd;yEACqE;IACrE,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;mCAG+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAkCxC;6DAC6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAuG1D"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAoB,MAAM,uBAAuB,CAAC;AAE7F,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,OAAO,CAAC;IACd;yEACqE;IACrE,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;mCAG+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAkCxC;6DAC6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CA6G1D"}

package/dist/cli/args.js

@@ -19,7 +19,7 @@ Usage:
   oma --continue                 resume the most recent session
   oma --session <id> -p "..."    one-shot follow-up on a session
   oma --permission ask -p "..."  gate bash/write/mcp behind approval cards
-  oma --read-only -p "..."       research-only run (no mutating tools)
+  oma --yolo -p "..."            ungated run (OS sandbox forced when present)
   oma --model <provider/model> -p "<prompt>"
                                           pick a model by canonical id
                                           (default: first available model)
@@ -30,7 +30,7 @@ Piped stdin (print/json modes):
   cat error.log | oma -p          (stdin only)
 `;
 const MODES = ["print", "json", "rpc", "tui"];
-const PERMISSIONS = ["ask", "auto", "deny", "off"];
+const PERMISSIONS = ["ask", "auto", "deny", "off", "yolo"];
 /** Parse argv SYNTAX only: whether a run actually has an input (prompt or
  *  piped stdin) is decided in main() after stdin is read. */
 export function parseArgs(argv) {
@@ -111,6 +111,13 @@ export function parseArgs(argv) {
         else if (arg === "--read-only") {
             args.readOnly = true;
         }
+        else if (arg === "--yolo") {
+            // The industry's skip-permissions flag (crush --yolo / CC
+            // --dangerously-skip-permissions): ungated run. Boundaries that do
+            // not depend on judgment (workspace containment, protected files,
+            // secret stripping, egress rules, write freshness) all remain.
+            args.permission = "yolo";
+        }
         else if (arg === "--permission") {
             const value = argv[i + 1];
             if (!value || !PERMISSIONS.includes(value)) {

package/dist/cli/gateway-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-commands.d.ts","sourceRoot":"","sources":["../../src/cli/gateway-commands.ts"],"names":[],"mappings":"AAwBA;iEACiE;AACjE,eAAO,MAAM,aAAa,gEAAiE,CAAC;AAC5F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,eAAO,MAAM,aAAa,0pBAaF,CAAC;AAEzB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAKvE;AAED;;;uDAGuD;AACvD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,EAAE,OAAO,GACnB,MAAM,EAAE,CAMV;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAyBD;qEACqE;AACrE,wBAAsB,eAAe,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBvF;AAED;qEACqE;AACrE,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgExF;AAED;iFACiF;AACjF,wBAAsB,YAAY,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAoCpF;AAED;;;mBAGmB;AACnB,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BxF;AA2BD,mFAAmF;AACnF,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBxF;AAED,yDAAyD;AACzD,wBAAsB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAUtF;AA+DD,8EAA8E;AAC9E,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,MAAM,CAAC,CAOjB"}
+{"version":3,"file":"gateway-commands.d.ts","sourceRoot":"","sources":["../../src/cli/gateway-commands.ts"],"names":[],"mappings":"AAwBA;iEACiE;AACjE,eAAO,MAAM,aAAa,gEAAiE,CAAC;AAC5F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,eAAO,MAAM,aAAa,0pBAaF,CAAC;AAEzB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAKvE;AAED;;;uDAGuD;AACvD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,EAAE,OAAO,GACnB,MAAM,EAAE,CAMV;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAyBD;qEACqE;AACrE,wBAAsB,eAAe,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBvF;AAED;qEACqE;AACrE,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgExF;AAED;iFACiF;AACjF,wBAAsB,YAAY,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAoCpF;AAED;;;mBAGmB;AACnB,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BxF;AAmDD,mFAAmF;AACnF,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBxF;AAED,yDAAyD;AACzD,wBAAsB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAUtF;AA+DD,8EAA8E;AAC9E,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/cli/gateway-commands.js

@@ -1,4 +1,4 @@
-import { existsSync } from "node:fs";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { currentVersion, fetchGatewayArtifact, gatewayPaths, generatePassword, installedVersions, omaHome, omaVersion, readSecrets, } from "../core/gateway/artifact.js";
@@ -205,19 +205,49 @@ export async function runGatewayPasswd(opts = {}) {
     const secrets = { ...readSecrets(home), MOCK_PASSWORD: password };
     await writeFile(secretsPath, `${JSON.stringify(secrets, null, 2)}\n`, { mode: 0o600 });
     log(`login password replaced: user-001 / ${password}`);
-    // A password set in the console is stored as a hash and wins over this file,
-    // so push the new one there too when the gateway is up — otherwise rotating
-    // here would silently not take effect.
+    // A password set in the console is stored as a hash in the stack's settings
+    // and wins over this file, so the new one has to land there too — otherwise
+    // rotating here would silently not take effect.
     const pushed = await pushPasswordToRunningGateway(secrets, password);
     if (pushed) {
         log("the running gateway took it too (console-set password updated)");
+        return 0;
+    }
+    // Gateway not reachable: leave a reset request instead, so the next start
+    // adopts the secret above. Without this, "rotate while down" is a no-op — the
+    // stored hash outlives the rotation and the new password is refused.
+    const marker = requestPasswordReset(home);
+    if (marker) {
+        log(`the stored password will be dropped on the next start (${marker})`);
     }
     else {
         log("restart to apply: oma gateway down && oma gateway up -d");
-        log("note: a password set in the web console wins over this file — change it there if you used that");
     }
     return 0;
 }
+/** Marker filename. Owned by the backend
+ *  (`apps/backend/src/features/auth/password.ts` PASSWORD_RESET_MARKER); oma
+ *  cannot import a backend module, so the literal is repeated here on purpose —
+ *  change both together. */
+const PASSWORD_RESET_MARKER = "password-reset";
+/** Ask the backend to drop its stored password by leaving the reset marker in
+ *  the gateway data dir; the backend consumes it on the next boot and the
+ *  secret file becomes authoritative again.
+ *
+ *  Deliberately NOT a database write: the backend owns backend.db (see
+ *  apps/oh-my-agent/AGENTS.md — "backend is the source of truth for product
+ *  state; the runtime is the runtime"). Writing another process's SQLite file
+ *  from the CLI would also race a running gateway. Returns the path written, or
+ *  null when there is no gateway data dir to write to yet. */
+function requestPasswordReset(home) {
+    const dataDir = join(gatewayPaths(home).data, "backend");
+    if (!existsSync(join(gatewayPaths(home).data)))
+        return null;
+    mkdirSync(dataDir, { recursive: true });
+    const marker = join(dataDir, PASSWORD_RESET_MARKER);
+    writeFileSync(marker, `${new Date().toISOString()}\n`);
+    return marker;
+}
 /** Update the console-set password (a hash in the backend's settings) when the
  *  gateway is reachable. Returns false when it is not: the file value then
  *  applies after the next start. */

package/dist/cli/initial-input.d.ts

@@ -28,8 +28,9 @@ export declare function buildCliRunInput(opts: {
     modelRuntime: ModelRuntime;
     /** Canonical `<provider>/<model>` id; undefined = first available. */
     modelId?: string;
-    /** Standalone permission gate. undefined = ungated (legacy default). */
-    permissionMode?: "ask" | "auto" | "deny";
+    /** Standalone permission gate. undefined = ungated (legacy default);
+     *  "yolo" = ungated + OS bash sandbox forced when available. */
+    permissionMode?: "ask" | "auto" | "deny" | "yolo";
     /** --read-only: advertise no write/edit/bash/eval to the model. */
     readOnly?: boolean;
     /** Clipboard/pasted images riding this prompt (vision input). */

package/dist/cli/initial-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initial-input.d.ts","sourceRoot":"","sources":["../../src/cli/initial-input.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUrD;;;;;wDAKwD;AACxD,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CA+C3E;AAMD;;yCAEyC;AACzC,wBAAsB,cAAc,CAClC,MAAM,GAAE,cAAc,CAAC,UAAU,CAAsB,GACtD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAsB7B;AAED;;iDAEiD;AACjD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKpF;AA0BD;;;wBAGwB;AAExB,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,MAAM,CAAC,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;QACnE,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ,GAAG,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAyClC"}
+{"version":3,"file":"initial-input.d.ts","sourceRoot":"","sources":["../../src/cli/initial-input.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUrD;;;;;wDAKwD;AACxD,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CA+C3E;AAMD;;yCAEyC;AACzC,wBAAsB,cAAc,CAClC,MAAM,GAAE,cAAc,CAAC,UAAU,CAAsB,GACtD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAsB7B;AAED;;iDAEiD;AACjD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKpF;AA0BD;;;wBAGwB;AAExB,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;oEACgE;IAChE,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClD,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,MAAM,CAAC,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;QACnE,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ,GAAG,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAyClC"}

package/dist/core/coordination/registry.d.ts

@@ -73,6 +73,17 @@ export interface CoordinationRegistry {
     isDeliveryAcknowledged(id: string): boolean;
     settleEntry(id: string, patch: Partial<RegistryEntry>): void;
     setCompletionListener(cb: ((entry: RegistryEntry) => void) | null): void;
+    /** Remove THIS callback only. A TUI session installs a listener and must
+     *  remove it on close without clobbering whichever listener a NEWER
+     *  session has since installed (single-slot setCompletionListener(null)
+     *  would). */
+    removeCompletionListener(cb: (entry: RegistryEntry) => void): void;
+    /** Kill every RUNNING entry that owns a kill callback (bash/eval bg
+     *  jobs). Run teardown: the table is about to be dropped, so the children
+     *  must go with it — clearAll() alone frees the bookkeeping and orphans
+     *  the processes. Subagents are excluded (the delegation executor owns
+     *  those) and settled entries have nothing to kill. */
+    stopRunningEntries(scope?: string): number;
     notifyEntryCompletion(entry: RegistryEntry): void;
     /** Drop every entry (Run teardown). */
     clearAll(): void;

package/dist/core/coordination/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/coordination/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/coordination/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AACzE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAOD;;;;sDAIsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAChD,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC7D,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IACvC,WAAW,CAAC,IAAI,EAAE;QAChB,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,gBAAgB,IAAI,MAAM,CAAC;IAC3B;;sEAEkE;IAClE,qBAAqB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACpD,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5C,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC7D,qBAAqB,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACzE;;;kBAGc;IACd,wBAAwB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;IACnE;;;;2DAIuD;IACvD,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAClD,uCAAuC;IACvC,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,wBAAgB,0BAA0B,IAAI,oBAAoB,CA6LjE;AAED;;kEAEkE;AAClE,eAAO,MAAM,eAAe,EAAE,oBAAmD,CAAC"}

package/dist/core/coordination/registry.js

@@ -130,6 +130,27 @@ export function createCoordinationRegistry() {
     function setCompletionListener(cb) {
         completionListener = cb;
     }
+    function removeCompletionListener(cb) {
+        if (completionListener === cb)
+            completionListener = null;
+    }
+    function stopRunningEntries(scope) {
+        let stopped = 0;
+        for (const e of entries.values()) {
+            if (e.status !== "running" || e.kind === "subagent" || !e.kill)
+                continue;
+            if (scope !== undefined && e.scope !== scope)
+                continue;
+            try {
+                e.kill();
+                stopped++;
+            }
+            catch {
+                /* a broken kill never blocks the rest of teardown */
+            }
+        }
+        return stopped;
+    }
     function acknowledgeDeliveries(ids) {
         for (const id of ids)
             ackedDeliveries.add(id);
@@ -154,6 +175,8 @@ export function createCoordinationRegistry() {
         isDeliveryAcknowledged,
         settleEntry,
         setCompletionListener,
+        removeCompletionListener,
+        stopRunningEntries,
         notifyEntryCompletion,
         clearAll,
     };

package/dist/core/gateway/artifact.d.ts

@@ -1,7 +1,6 @@
 import { type GatewayManifest } from "./manifest.js";
 export declare class GatewayArtifactError extends Error {
 }
-export declare const DEFAULT_STACK_REPO = "Chengchcc/my-agent-team";
 export declare function omaHome(env?: NodeJS.ProcessEnv): string;
 /** The launcher's on-disk layout, in one place: code lives under
  *  gateway/versions/<version>/, state under gateway-data/ so an upgrade that swaps

package/dist/core/gateway/artifact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../src/core/gateway/artifact.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAuB,MAAM,eAAe,CAAC;AAE1E,qBAAa,oBAAqB,SAAQ,KAAK;CAAG;AAElD,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAM5D,wBAAgB,OAAO,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEpE;AAED;;sDAEsD;AACtD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAkB,GAAG,YAAY,CAUnE;AAED;qDACqD;AACrD,wBAAgB,UAAU,IAAI,MAAM,CAQnC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;oFACoF;AACpF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,eAAe,CAMjB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI9D;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMhE;AAiFD,wBAAgB,gBAAgB,IAAI,MAAM,CAYzC;AASD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBhE;AAED;kDACkD;AAClD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiBjC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;6EAC6E;AAC7E,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuDxF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,EAAE,CAMpE;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,GAAG,SAAS,CAO3E"}
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../src/core/gateway/artifact.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAuB,MAAM,eAAe,CAAC;AAE1E,qBAAa,oBAAqB,SAAQ,KAAK;CAAG;AAQlD,wBAAgB,OAAO,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEpE;AAED;;sDAEsD;AACtD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAkB,GAAG,YAAY,CAUnE;AAED;qDACqD;AACrD,wBAAgB,UAAU,IAAI,MAAM,CAQnC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;oFACoF;AACpF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,eAAe,CAMjB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI9D;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMhE;AAiFD,wBAAgB,gBAAgB,IAAI,MAAM,CAYzC;AASD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBhE;AAED;kDACkD;AAClD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiBjC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;6EAC6E;AAC7E,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuDxF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,EAAE,CAMpE;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,GAAG,SAAS,CAO3E"}

package/dist/core/gateway/artifact.js

@@ -5,7 +5,7 @@ import { join, resolve } from "node:path";
 import { readGatewayManifest } from "./manifest.js";
 export class GatewayArtifactError extends Error {
 }
-export const DEFAULT_STACK_REPO = "Chengchcc/my-agent-team";
+const DEFAULT_STACK_REPO = "Chengchcc/my-agent-team";
 /** Written last, after a version is fully unpacked: its presence is what makes
  *  an install idempotent. */
 const INSTALL_MARKER = ".complete";

package/dist/core/goals/index.d.ts

@@ -0,0 +1,8 @@
+/** Goal mode (omp goals/ port): the session's persistent autonomous
+ *  objective — state machine + prompts (state.ts), the runtime that owns
+ *  accounting and loop decisions (runtime.ts), and the model-facing tool
+ *  (tool.ts). */
+export { type GoalLoopDecision, GoalRuntime, type GoalTurnUsage, type SettledTurn, } from "./runtime.js";
+export { accountTurn, accrueUsage, budgetLimitedGoal, canCreateGoal, completeGoal, completionBudgetReport, createGoal, dropGoal, type Goal, type GoalModeState, type GoalPromptKind, type GoalStatus, goalTokenDelta, isAccountingStatus, pauseGoal, remainingTokens, renderGoalPrompt, renderInterviewPrompt, resumeGoal, validateTokenBudget, } from "./state.js";
+export { createGoalPlugin, createGoalTool } from "./tool.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/goals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/goals/index.ts"],"names":[],"mappings":"AAAA;;;iBAGiB;AAEjB,OAAO,EACL,KAAK,gBAAgB,EACrB,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACV,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/goals/index.js

@@ -0,0 +1,7 @@
+/** Goal mode (omp goals/ port): the session's persistent autonomous
+ *  objective — state machine + prompts (state.ts), the runtime that owns
+ *  accounting and loop decisions (runtime.ts), and the model-facing tool
+ *  (tool.ts). */
+export { GoalRuntime, } from "./runtime.js";
+export { accountTurn, accrueUsage, budgetLimitedGoal, canCreateGoal, completeGoal, completionBudgetReport, createGoal, dropGoal, goalTokenDelta, isAccountingStatus, pauseGoal, remainingTokens, renderGoalPrompt, renderInterviewPrompt, resumeGoal, validateTokenBudget, } from "./state.js";
+export { createGoalPlugin, createGoalTool } from "./tool.js";

package/dist/core/goals/runtime.d.ts

@@ -0,0 +1,112 @@
+import type { TodoItem } from "../tools/todo-store.js";
+import { type Goal, type GoalModeState } from "./state.js";
+/** The session-level goal runtime (omp's GoalRuntime analogue): the SINGLE
+ *  owner of goal state, token/time accounting, and loop decisions. The TUI
+ *  is presentation only — it forwards settled turns here and renders the
+ *  decision; the `goal` tool mutates through the same object.
+ *
+ *  Why a class and not loose functions: accounting is stateful, and the loop
+ *  needs one choke point to decide continue / wrap-up / pause.
+ *
+ *  The final turn's usage is the interesting part. A completion can fire
+ *  MID-run (the model calls the tool), before that turn's usage is known, so
+ *  flushing at the transition would write a report missing its own last turn.
+ *  The transition therefore defers the completion RECORD
+ *  (`#pendingFinalFlush`), and settleTurn folds the settled turn in and writes
+ *  it once — after the transition, not before it. */
+export interface GoalTurnUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface SettledTurn {
+    usage: GoalTurnUsage;
+    wallSeconds: number;
+    status: "completed" | "failed" | "aborted" | "timeout";
+    /** Whether the turn used any tool (stall backstop input). */
+    usedTools: boolean;
+}
+export type GoalLoopDecision = {
+    action: "continue";
+    prompt: string;
+    tokensUsed: number;
+    tokenBudget?: number;
+} | {
+    action: "budget-wrapup";
+    prompt: string;
+    tokensUsed: number;
+    tokenBudget: number;
+} | {
+    action: "paused";
+    reason: string;
+} | {
+    action: "completed";
+    objective: string;
+    report: string | null;
+} | {
+    action: "idle";
+};
+export declare class GoalRuntime {
+    #private;
+    /** Persist a transition (session event). Called on EVERY mutation so a
+     *  quit right after /goal pause still survives resume. */
+    /** Persist a transition. `recordCompletion` is false for the transition
+     *  that still owes a usage flush (see complete()). */
+    private readonly persist;
+    /** Surface a transition for the UI (status line). */
+    private readonly notify;
+    constructor(
+    /** Persist a transition (session event). Called on EVERY mutation so a
+     *  quit right after /goal pause still survives resume. */
+    /** Persist a transition. `recordCompletion` is false for the transition
+     *  that still owes a usage flush (see complete()). */
+    persist?: (state: GoalModeState | null, recordCompletion: boolean) => void, 
+    /** Surface a transition for the UI (status line). */
+    notify?: (message: string) => void);
+    get state(): GoalModeState | null;
+    get goal(): Goal | null;
+    get interviewing(): boolean;
+    /** Whether the goal tool should be mounted for the next run. */
+    get toolWanted(): boolean;
+    beginInterview(): void;
+    /** Resume replay (session event): a live goal comes back PAUSED. */
+    restore(state: GoalModeState | null): void;
+    /** Start a goal, or REPLACE the current one (fresh counters and budget).
+     *  A PAUSED goal cannot be silently overwritten: resume it and use set, or
+     *  drop it first — otherwise parked work would vanish without a word. */
+    create(objective: string, tokenBudget?: number): GoalModeState;
+    pause(): void;
+    resume(): void;
+    drop(): Goal | null;
+    /** Set the TOTAL token budget (not an increment); accumulated usage is
+     *  kept. Raising it past tokensUsed resumes a budget-limited goal; lowering
+     *  it below re-limits. Returns a continuation prompt when the goal resumed,
+     *  else null.
+     *
+     *  A PAUSED goal must be resumed first: changing the budget of work that is
+     *  not running silently rewrites the terms of a decision the user already
+     *  parked. */
+    setBudget(budget: number | undefined): {
+        prompt: string;
+    } | null;
+    /** Flush the in-flight turn into the goal, then mark it complete. The
+     *  turn's provider usage is only known when the run SETTLES, so the final
+     *  flush is deferred there (#pendingFinalFlush) — the report the settle
+     *  returns covers the final turn, exactly like omp's flush-inside-
+     *  completeGoalFromTool. */
+    complete(): void;
+    /** The status-bar indicator: the state plus the usage the user supervises
+     *  the goal with. The driver owns its wording. */
+    statusLabel(): string | undefined;
+    remainingTokens(): number | null;
+    /** The loop's post-turn decision. Fail-safe ordering: an interrupted or
+     *  failed turn PAUSES and never queues work (omp onTaskAborted flushes
+     *  with steering suppressed); a terminal transition reports; budget
+     *  crossing wraps up once; otherwise continue (or pause on a stall). */
+    settleTurn(turn: SettledTurn): GoalLoopDecision;
+    /** omp goal-todo-context: a continuation has no visible user nudge, so the
+     *  live todo state must ride along or stale items silently rot. Appended
+     *  to continuation/budget prompts by the caller that owns the todo file. */
+    static renderTodoContext(items: readonly TodoItem[]): string;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/goals/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/core/goals/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAML,KAAK,IAAI,EACT,KAAK,aAAa,EAKnB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;qDAaqD;AAErD,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACjE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAIvB,qBAAa,WAAW;;IASpB;8DAC0D;IAC1D;0DACsD;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAIxB,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM;;IATvB;8DAC0D;IAC1D;0DACsD;IACrC,OAAO,GAAE,CACxB,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,gBAAgB,EAAE,OAAO,KACtB,IAAe;IACpB,qDAAqD;IACpC,MAAM,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe;IAG/D,IAAI,KAAK,IAAI,aAAa,GAAG,IAAI,CAEhC;IAED,IAAI,IAAI,IAAI,IAAI,GAAG,IAAI,CAEtB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,gEAAgE;IAChE,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,cAAc,IAAI,IAAI;IAItB,oEAAoE;IACpE,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAS1C;;6EAEyE;IACzE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa;IAmB9D,KAAK,IAAI,IAAI;IAMb,MAAM,IAAI,IAAI;IAOd,IAAI,IAAI,IAAI,GAAG,IAAI;IASnB;;;;;;;kBAOc;IACd,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA2BhE;;;;gCAI4B;IAC5B,QAAQ,IAAI,IAAI;IAahB;sDACkD;IAClD,WAAW,IAAI,MAAM,GAAG,SAAS;IAQjC,eAAe,IAAI,MAAM,GAAG,IAAI;IAMhC;;;4EAGwE;IACxE,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,gBAAgB;IA8D/C;;gFAE4E;IAC5E,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM;CAiB7D"}