@chengchenccc/oh-my-agent 0.1.1-rc.1

package/README.md

@@ -0,0 +1,79 @@
+# @chengchenccc/oh-my-agent
+
+Oma 是本仓库自研的 Agent 执行引擎：既可**独立交互式 TUI**（默认 `oma` 进入终端界面），也可作为无 UI 的一次性 CLI 被 Product Backend 的 Adapter（`@chengchenccc/adapter-oma-agent`）按**每个 Agent Run** spawn 一次。
+
+```text
+Product Backend → Agent Run → Adapter → spawn oma --mode rpc
+→ per-Run Runtime → BackendRunOutcome → stdout → child 退出
+```
+
+**不是 daemon**：一个 Run = 一个子进程 = 一个 Runtime = 一个 outcome。没有常驻进程、没有 session supervisor、没有 worker pool。
+
+## TUI
+
+用 `oma`（或 `oma --session <id>`）在终端直接开始交互式会话。
+
+- 流式渲染 assistant / tool 事件
+- `ctrl+t` 展开 thinking，`ctrl+o` 展开 tool 详情
+- mermaid fence 渲染为终端 ASCII 图
+- `/resume` 列表/恢复 session，`/fork <n>` 分支
+- 模型选择持久化到项目级 `.oma/settings.json`（standalone TUI 专用；backend→oma 仍以 `agent.yml` 为默认，可被 run 参数覆盖）
+- composer loader 实时摘要当前动作（tool intent / thinking 首行）
+
+| Real session | Tools | Mermaid |
+|---|---|---|
+| <img src="../../docs/screenshots/oma-tui-real.png" width="280" alt="Oma TUI real session" /> | <img src="../../docs/screenshots/oma-tui-tools.png" width="280" alt="Oma TUI tools" /> | <img src="../../docs/screenshots/oma-tui-mermaid.png" width="280" alt="Oma TUI mermaid" /> |
+
+## CLI 模式
+
+| 模式 | 用途 |
+|---|---|
+| `tui` | 默认；交互式终端会话（一个进程 = N 个 Run 共享一个 session 文件） |
+| `print` | 一次 Run；stdout 只有 final assistant text；stderr 日志；非零退出码表示失败 |
+| `json` | 一次 Run；stdout 全部事件 JSONL + 恰好一个 terminal outcome 行 |
+| `rpc` | 每 Run 一次 `execute` + 可选的 `steer`/`abort`；命令走 stdin，`event`/`outcome`/`response` 走 stdout（严格 LF JSONL，stdout 只承载协议） |
+
+`--mode rpc` 是 Adapter 使用的模式。协议 schema 与事件/outcome mapping 定义在契约包 `@chengchenccc/agent-backend`，两侧共用同一份。
+
+## Runtime
+
+`createOmaRuntime()`（`src/core/create-runtime.ts`）构造一个 Runtime = 一个 Run：
+
+- `run(input)` 返回唯一 segment，其 `outcome` 是 Run 的唯一终态；
+- `steer(input)` 注入 live loop；`stop()` 中止；
+- `close()` 拆除 MCP clients 与 SessionStore。
+
+Runtime 内部由 `packages/agent` 提供：OmaSession（model/tool loop、retry、compaction、插件、todo）与 in-memory SessionStore。seed 时把 **full Product history + meta + input** 原子写入，Run 结束即销毁。
+
+## 运行
+
+```bash
+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
+
+cd apps/oh-my-agent && bun link                     # optional local install
+oma -p "hello"                              # then run from anywhere
+oma                                     # standalone interactive TUI
+```
+
+- 正常由 Backend 通过 `OMA_BIN` spawn（生产：构建后的 `dist/cli.js` 绝对路径；未配置时 Backend 自动用 Bun + 源码入口，dev 无需全局安装或 `bun link`）。
+- `dist/cli.js` 带 `#!/usr/bin/env bun` shebang，构建脚本会设置可执行位。
+
+## 目录
+
+```
+src/
+  cli.ts                可执行入口（shebang + runCli()）
+  main.ts               main()/runCli()：参数解析、模式分发、退出码（无 process.exit）
+  cli/                  print/json 模式、初始输入构建、CLI 测试
+  modes/                tui / print / json / rpc 模式
+  core/                 create-runtime.ts（per-Run Runtime 装配）、project-settings.ts（.oma/settings.json）、fake-provider（测试）
+```
+
+## 相关文档
+
+- [架构 Wiki — Oma](docs/architecture/runtime/oma.md)
+- [Agent Backend 协议](docs/architecture/execution/agent-backend.md)

package/dist/cli/args.d.ts

@@ -0,0 +1,24 @@
+export type CliMode = "print" | "json" | "rpc" | "tui";
+export interface CliArgs {
+    mode: CliMode;
+    /** True when -p/--mode was given explicitly; a bare positional prompt
+     *  keeps this false so main() can open the TUI with it prefilled. */
+    modeExplicit: boolean;
+    prompt: string;
+    listModels: boolean;
+    /** Canonical `<provider>/<model>` id; undefined = first available model. */
+    model?: string;
+    /** Resume a session file by id (TUI mode). */
+    session?: string;
+    /** Tool filter: comma-separated tool names or groups. Plain names form a
+     *  whitelist (ONLY those tools run); `!name` entries form a blacklist
+     *  (all but those). Applied to the FINAL tool table (native + MCP +
+     *  plugin) at Run assembly. */
+    tools?: string;
+}
+export declare class UsageError extends Error {
+}
+/** Parse argv SYNTAX only: whether a run actually has an input (prompt or
+ *  piped stdin) is decided in main() after stdin is read. */
+export declare function parseArgs(argv: readonly string[]): CliArgs;
+//# sourceMappingURL=args.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvD,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,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;mCAG+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAW,SAAQ,KAAK;CAAG;AA0BxC;6DAC6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CA6E1D"}

package/dist/cli/args.js

@@ -0,0 +1,120 @@
+export class UsageError extends Error {
+}
+const USAGE = `oma - Oma coding agent
+
+Usage:
+  oma                            interactive TUI (default in a terminal)
+  oma --session <id>             resume a session in the TUI
+  oma -p "<prompt>"              print mode: one Run, final text on stdout
+  oma "<prompt>"                 print mode shorthand
+  oma --mode json "<prompt>"     json mode: all events + one outcome as JSONL
+  oma --mode rpc                 rpc mode: stdin/stdout JSONL protocol
+  oma --list-models              print the model catalog as JSON
+  oma --model <provider/model> -p "<prompt>"
+                                          pick a model by canonical id
+                                          (default: first available model)
+  oma --tools todo_write,read -p "..."    only these tools enter the Run
+  oma --tools '!todo_write' -p "..."      all tools except todo_write
+
+Piped stdin (print/json modes):
+  cat file | oma -p "Review"
+  git diff | oma --mode json "Review"
+  cat error.log | oma -p          (stdin only)
+`;
+const MODES = ["print", "json", "rpc", "tui"];
+/** 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) {
+    const args = {
+        mode: "print",
+        modeExplicit: false,
+        prompt: "",
+        listModels: false,
+    };
+    const positional = [];
+    let modeFlag = null;
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg === "-p") {
+            modeFlag = "print";
+            args.modeExplicit = true;
+        }
+        else if (arg === "--mode") {
+            const value = argv[i + 1];
+            if (!value || !MODES.includes(value)) {
+                throw new UsageError(`--mode requires one of: ${MODES.join(" | ")}`);
+            }
+            modeFlag = value;
+            args.modeExplicit = true;
+            i++;
+        }
+        else if (arg.startsWith("--mode=")) {
+            const value = arg.slice("--mode=".length);
+            if (!MODES.includes(value)) {
+                throw new UsageError(`--mode requires one of: ${MODES.join(" | ")}`);
+            }
+            modeFlag = value;
+            args.modeExplicit = true;
+        }
+        else if (arg === "--list-models") {
+            args.listModels = true;
+        }
+        else if (arg === "--model") {
+            const value = argv[i + 1];
+            if (!value || value.startsWith("-")) {
+                throw new UsageError("--model requires a canonical <provider>/<model> id");
+            }
+            args.model = value;
+            i++;
+        }
+        else if (arg.startsWith("--model=")) {
+            const value = arg.slice("--model=".length);
+            if (!value)
+                throw new UsageError("--model requires a canonical <provider>/<model> id");
+            args.model = value;
+        }
+        else if (arg === "--session") {
+            const value = argv[i + 1];
+            if (!value || value.startsWith("-")) {
+                throw new UsageError("--session requires a session id");
+            }
+            args.session = value;
+            i++;
+        }
+        else if (arg.startsWith("--session=")) {
+            const value = arg.slice("--session=".length);
+            if (!value)
+                throw new UsageError("--session requires a session id");
+            args.session = value;
+        }
+        else if (arg === "--tools") {
+            const value = argv[i + 1];
+            if (!value || value.startsWith("-")) {
+                throw new UsageError("--tools requires a comma-separated tool list");
+            }
+            args.tools = value;
+            i++;
+        }
+        else if (arg.startsWith("--tools=")) {
+            const value = arg.slice("--tools=".length);
+            if (!value)
+                throw new UsageError("--tools requires a comma-separated tool list");
+            args.tools = value;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            throw new UsageError(USAGE);
+        }
+        else if (arg.startsWith("-")) {
+            throw new UsageError(`unknown option: ${arg}\n\n${USAGE}`);
+        }
+        else {
+            positional.push(arg);
+        }
+        i++;
+    }
+    if (modeFlag)
+        args.mode = modeFlag;
+    args.prompt = positional.join(" ");
+    return args;
+}

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

@@ -0,0 +1,32 @@
+import type { BackendRunInput } from "@chengchenccc/agent-contract";
+import type { ModelRuntime } from "@chengchenccc/ai";
+/** Standalone skill roots (the Product passes its own via the run snapshot):
+ *  `<workspace>/.oma/skills` first, then the user-global `<agentDir>/skills`.
+ *  `skills` in `.oma/settings.json` overrides the defaults (absolute paths,
+ *  or relative to the workspace root). The `enableClaude` / `enableCodex` /
+ *  `enableAgents` toggles add Claude / Codex / agent skill dirs to the
+ *  defaults. Only existing directories are returned. */
+export declare function resolveStandaloneSkillRoots(workspaceRoot: string): string[];
+/** Read piped stdin for print/json one-shot runs. Returns undefined when
+ *  stdin is a TTY or carries only whitespace. RPC mode NEVER calls this: its
+ *  stdin is the JSONL command stream. */
+export declare function readPipedStdin(stream?: ReadableStream<Uint8Array>): Promise<string | undefined>;
+/** Merge the CLI prompt with piped stdin: stdin comes FIRST, then a blank
+ *  line, then the instruction (the classic `git diff | cli -p "review"`
+ *  shape). Whitespace-only parts are dropped. */
+export declare function mergeInitialInput(input: {
+    prompt?: string;
+    piped?: string;
+}): string;
+/** Build the BackendRunInput for a one-shot CLI run: current cwd as the
+ *  workspace, empty Product history, the requested model (canonical
+ *  `<provider>/<model>` id) or the first available model, no Product Tools,
+ *  no system prompt. */
+export declare function buildCliRunInput(opts: {
+    prompt: string;
+    workspaceRoot: string;
+    modelRuntime: ModelRuntime;
+    /** Canonical `<provider>/<model>` id; undefined = first available. */
+    modelId?: string;
+}): Promise<BackendRunInput<"oma">>;
+//# sourceMappingURL=initial-input.d.ts.map

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

@@ -0,0 +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;AAQrD;;;;;wDAKwD;AACxD,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAqC3E;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;AAED;;;wBAGwB;AACxB,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;CAClB,GAAG,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAqClC"}

package/dist/cli/initial-input.js

@@ -0,0 +1,131 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, join } from "node:path";
+import { enabledPluginSkillRoots } from "../core/plugins/plugin-marketplace.js";
+import { buildSystemPrompt, readMemorySummary } from "../core/runtime/prompts.js";
+import { agentDir } from "../core/session/session-file.js";
+import { loadProjectSettings } from "../core/settings/project-settings.js";
+import { readWorkspaceSystemPrompt } from "../core/settings/workspace-context.js";
+import { UsageError } from "./args.js";
+/** Standalone skill roots (the Product passes its own via the run snapshot):
+ *  `<workspace>/.oma/skills` first, then the user-global `<agentDir>/skills`.
+ *  `skills` in `.oma/settings.json` overrides the defaults (absolute paths,
+ *  or relative to the workspace root). The `enableClaude` / `enableCodex` /
+ *  `enableAgents` toggles add Claude / Codex / agent skill dirs to the
+ *  defaults. Only existing directories are returned. */
+export function resolveStandaloneSkillRoots(workspaceRoot) {
+    const settings = loadProjectSettings(workspaceRoot);
+    const configured = settings.skills;
+    const candidates = [];
+    if (configured && configured.length > 0) {
+        for (const p of configured) {
+            candidates.push(isAbsolute(p) ? p : join(workspaceRoot, p));
+        }
+    }
+    else {
+        candidates.push(join(workspaceRoot, ".oma", "skills"));
+        candidates.push(join(agentDir(), "skills"));
+        if (settings.enableClaude) {
+            candidates.push(join(workspaceRoot, ".claude", "skills"), join(homedir(), ".claude", "skills"));
+        }
+        if (settings.enableCodex) {
+            candidates.push(join(workspaceRoot, ".codex", "skills"), join(homedir(), ".codex", "skills"));
+        }
+        if (settings.enableAgents) {
+            candidates.push(join(workspaceRoot, ".agent", "skills"), join(workspaceRoot, ".agents", "skills"), join(homedir(), ".agent", "skills"), join(homedir(), ".agents", "skills"));
+        }
+    }
+    const roots = [];
+    for (const dir of candidates) {
+        if (existsSync(dir) && statSync(dir).isDirectory())
+            roots.push(dir);
+    }
+    for (const dir of enabledPluginSkillRoots(workspaceRoot)) {
+        if (!roots.includes(dir))
+            roots.push(dir);
+    }
+    return roots;
+}
+/** One-shot CLI stdin bound: a hostile `cat huge-file | oma -p`
+ *  must not balloon memory. */
+const MAX_STDIN_BYTES = 16 * 1024 * 1024;
+/** Read piped stdin for print/json one-shot runs. Returns undefined when
+ *  stdin is a TTY or carries only whitespace. RPC mode NEVER calls this: its
+ *  stdin is the JSONL command stream. */
+export async function readPipedStdin(stream = Bun.stdin.stream()) {
+    if (process.stdin.isTTY)
+        return undefined;
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    let text = "";
+    let bytes = 0;
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            bytes += value.length;
+            if (bytes > MAX_STDIN_BYTES) {
+                throw new UsageError("piped stdin exceeds 16 MiB");
+            }
+            text += decoder.decode(value, { stream: true });
+        }
+        text += decoder.decode();
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const trimmed = text.trim();
+    return trimmed || undefined;
+}
+/** Merge the CLI prompt with piped stdin: stdin comes FIRST, then a blank
+ *  line, then the instruction (the classic `git diff | cli -p "review"`
+ *  shape). Whitespace-only parts are dropped. */
+export function mergeInitialInput(input) {
+    const parts = [input.piped?.trim(), input.prompt?.trim()].filter((part) => Boolean(part));
+    return parts.join("\n\n");
+}
+/** Build the BackendRunInput for a one-shot CLI run: current cwd as the
+ *  workspace, empty Product history, the requested model (canonical
+ *  `<provider>/<model>` id) or the first available model, no Product Tools,
+ *  no system prompt. */
+export async function buildCliRunInput(opts) {
+    const catalog = await opts.modelRuntime.getCatalog();
+    const model = opts.modelId
+        ? catalog.models.find((m) => `${m.providerId}/${m.modelId}` === opts.modelId)
+        : catalog.models.find((m) => m.available !== false);
+    if (opts.modelId && !model) {
+        throw new Error(`model not found in catalog: ${opts.modelId}`);
+    }
+    if (opts.modelId && model && model.available === false) {
+        throw new Error(`model unavailable: ${opts.modelId}`);
+    }
+    if (!model) {
+        throw new Error("no available model in the catalog (check provider credentials)");
+    }
+    const modelId = `${model.providerId}/${model.modelId}`;
+    const runId = `cli-${randomUUID()}`;
+    const skillRoots = resolveStandaloneSkillRoots(opts.workspaceRoot);
+    const input = {
+        input: {
+            inputId: `cli-in-${randomUUID()}`,
+            message: { role: "user", text: opts.prompt },
+        },
+        run: {
+            runId,
+            model: { backendKind: "oma", modelId },
+            systemPrompt: buildSystemPrompt({
+                workspacePrompt: readWorkspaceSystemPrompt(opts.workspaceRoot),
+                memorySummary: readMemorySummary(opts.workspaceRoot),
+                cwd: opts.workspaceRoot,
+            }),
+            configRevision: 0,
+        },
+        workspace: { root: opts.workspaceRoot, access: "read_write" },
+        // Standalone agent: no product conversation/agent/branch identity.
+    };
+    if (skillRoots.length === 0)
+        return input;
+    return { ...input, run: { ...input.run, skillRoots } };
+}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import { runCli } from "./main.js";
+await runCli();

package/dist/core/__fixtures__/echo-model.d.ts

@@ -0,0 +1,6 @@
+import type { AIMessageChunk } from "@chengchenccc/message";
+/** Deterministic scripted model stream: yields one assistant text chunk, a
+ *  usage record, and end_turn - the minimal shape the agent loop needs to
+ *  complete a turn. */
+export declare function createEchoModelStream(text: string): () => AsyncIterable<AIMessageChunk>;
+//# sourceMappingURL=echo-model.d.ts.map

package/dist/core/__fixtures__/echo-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-model.d.ts","sourceRoot":"","sources":["../../../src/core/__fixtures__/echo-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;uBAEuB;AACvB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAMvF"}

package/dist/core/__fixtures__/echo-model.js

@@ -0,0 +1,10 @@
+/** Deterministic scripted model stream: yields one assistant text chunk, a
+ *  usage record, and end_turn - the minimal shape the agent loop needs to
+ *  complete a turn. */
+export function createEchoModelStream(text) {
+    return async function* () {
+        yield { delta: { type: "text", text } };
+        yield { usage: { input: 10, output: 3, cacheRead: 1, cacheCreate: 0 } };
+        yield { stopReason: "end_turn" };
+    };
+}

package/dist/core/__fixtures__/mcp-echo-server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-echo-server.d.ts.map

package/dist/core/__fixtures__/mcp-echo-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-echo-server.d.ts","sourceRoot":"","sources":["../../../src/core/__fixtures__/mcp-echo-server.ts"],"names":[],"mappings":""}

package/dist/core/__fixtures__/mcp-echo-server.js

@@ -0,0 +1,54 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+/** Deterministic stdio MCP server for contract tests. Echoes the tool name +
+ *  the TOP-LEVEL `_meta.identity` it received (the production wire shape:
+ *  identity rides in call params._meta, never inside arguments), so a test
+ *  can assert the wire binding of descriptor.name and identity propagation
+ *  without a Product backend.
+ *
+ *  Modes by `echo` value:
+ *    - "fail": the call rejects (server error) - failure path.
+ *    - "slow": the call sleeps 30s - lets a test abort/stop mid-call. */
+const server = new Server({ name: "echo-server", version: "1.0.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    // MCP_ECHO_TOOLS=todo_write,history_recent renames the offered tools
+    // (tests inject "backend-like" product tools); default stays "echo".
+    const names = (process.env.MCP_ECHO_TOOLS ?? "echo").split(",").filter(Boolean);
+    return {
+        tools: names.map((name) => ({
+            name,
+            description: `Echo ${name}`,
+            inputSchema: { type: "object" },
+        })),
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const name = req.params.name;
+    const args = (req.params.arguments ?? {});
+    const params = req.params;
+    if (typeof args.echo === "string" && args.echo.startsWith("slow")) {
+        // "slow" sleeps 30s (default); "slow:<ms>" overrides for in-process
+        // child-process tests so an aborted call doesn't linger a full 30s. Duration
+        // travels in-band because the SDK child env is a safe-list, not the
+        // parent's full env.
+        const ms = Number(args.echo.split(":")[1] ?? 30_000);
+        await new Promise((r) => setTimeout(r, ms));
+    }
+    if (args.echo === "fail") {
+        throw new Error("echo failed on purpose");
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    name,
+                    meta: params._meta ?? null,
+                    echo: args.echo ?? null,
+                }),
+            },
+        ],
+    };
+});
+await server.connect(new StdioServerTransport());

package/dist/core/agent-runtime.d.ts

@@ -0,0 +1,21 @@
+export { createInMemorySessionStore } from "./persistence/in-memory-session-store.js";
+export type { AppendBatchInput, AppendBatchResult, SessionStore, } from "./persistence/session-store.js";
+export type { CodingSessionEntry, CodingSessionMetadata, CodingSessionOperation, CodingSessionSnapshot, CompactionEntry, MessageEntry, TodoStateEntry, } from "./persistence/session-tree.js";
+export type { AgentLoopListener, OmaLoopEvent } from "./runtime/agent-event.js";
+export type { ContextBudget, ContextSummarizer, OmaLoopResult, OmaSession, OmaSessionOptions, StreamRule, } from "./runtime/agent-loop.js";
+export { createOmaSession } from "./runtime/agent-loop.js";
+export type { CompactionResult } from "./runtime/compaction.js";
+export { compactSession } from "./runtime/compaction.js";
+export { estimateContextTokens, isSilentContextOverflow, type TurnUsage, type UsageAnchor, usageTotalTokens, } from "./runtime/context-estimate.js";
+export type { CodingLoopInput, LoopInputDeps, LoopInputResult } from "./runtime/loop-input.js";
+export { buildLoopInput } from "./runtime/loop-input.js";
+export type { MetaSectionProvider, Plugin, PluginHooks, PluginTool } from "./runtime/plugin.js";
+export { collectTools, renderMeta, validatePlugins } from "./runtime/plugin.js";
+export type { PluginRuntime } from "./runtime/plugin-runtime.js";
+export type { LoopMetaInput } from "./runtime/prompt.js";
+export { renderLoopMeta } from "./runtime/prompt.js";
+export type { RetryOptions } from "./runtime/retry.js";
+export { retryStream } from "./runtime/retry.js";
+export type { TodoItem, TodoState } from "./runtime/todo.js";
+export { readTodo, updateTodo, writeTodo } from "./runtime/todo.js";
+//# sourceMappingURL=agent-runtime.d.ts.map

package/dist/core/agent-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../src/core/agent-runtime.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,cAAc,GACf,MAAM,+BAA+B,CAAC;AAGvC,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAChF,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,UAAU,GACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/agent-runtime.js

@@ -0,0 +1,14 @@
+// Phase 2: Oma Runtime
+//
+// Persistence
+export { createInMemorySessionStore } from "./persistence/in-memory-session-store.js";
+export { createOmaSession } from "./runtime/agent-loop.js";
+// Compaction + retry
+export { compactSession } from "./runtime/compaction.js";
+export { estimateContextTokens, isSilentContextOverflow, usageTotalTokens, } from "./runtime/context-estimate.js";
+export { buildLoopInput } from "./runtime/loop-input.js";
+export { collectTools, renderMeta, validatePlugins } from "./runtime/plugin.js";
+export { renderLoopMeta } from "./runtime/prompt.js";
+export { retryStream } from "./runtime/retry.js";
+// Todo
+export { readTodo, updateTodo, writeTodo } from "./runtime/todo.js";

package/dist/core/memory/autonomous-memory.d.ts

@@ -0,0 +1,21 @@
+import type { ModelRuntime } from "@chengchenccc/ai";
+import { type Message } from "@chengchenccc/message";
+export interface AutonomousMemoryInput {
+    modelRuntime: ModelRuntime;
+    /** Canonical "<provider>/<model>" of the Run's model. */
+    modelId: string;
+    workspaceRoot: string;
+    runId: string;
+    messages: readonly Message[];
+    compactions: readonly string[];
+}
+/** Result of one memory-learn pass. `ran` is true when the pipeline made
+ * its extraction call (facts may still dedup to zero); false when disabled,
+ * empty, or failed — best-effort semantics, never throws. Surfaces use it
+ * for the omp-style "learn" indicator. */
+export interface MemoryLearnResult {
+    readonly ran: boolean;
+    readonly freshFacts: number;
+}
+export declare function extractAutonomousMemory(input: AutonomousMemoryInput): Promise<MemoryLearnResult>;
+//# sourceMappingURL=autonomous-memory.d.ts.map

package/dist/core/memory/autonomous-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autonomous-memory.d.ts","sourceRoot":"","sources":["../../../src/core/memory/autonomous-memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA2DlE,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,YAAY,CAAC;IAC3B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED;;;0CAG0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA+C5B"}