@excitedjs/dreamux 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 excitedjs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,223 @@
+# @excitedjs/dreamux
+
+The Codex-host server package. One long-running Node process hosts N
+**Dispatchers**; each Dispatcher binds **1 Feishu bot + 1 Codex thread**.
+
+This file is the **package-level** quick start. For the monorepo layout
+and harness pieces, see the top-level
+[`README.md`](../../README.md) and
+[`.agents/root.md`](../../.agents/root.md).
+
+Design background:
+[#1 Proposal](https://github.com/excitedjs/dreamux/issues/1) ·
+[#2 Engineering plan](https://github.com/excitedjs/dreamux/issues/2) ·
+[#4 Monorepo + harness](https://github.com/excitedjs/dreamux/issues/4).
+
+## What this package ships
+
+- The `dreamux` CLI (preferred): `dreamux server start`,
+  `dreamux server status`, `dreamux dispatcher add|remove|list|status|start|stop`.
+- Legacy aliases: `dreamux-server` (= `dreamux server start`) and
+  `server-ctl` (= `dreamux <verb>`). Kept so pre-monorepo operators
+  don't have to rewrite PATH entries; see
+  [`.agents/decisions/0002-cli-and-package-naming.md`](../../.agents/decisions/0002-cli-and-package-naming.md).
+- A SQLite-backed runtime (`dispatchers` + `inbound_buffer`) plus the
+  Feishu / Codex adapters that drive each dispatcher.
+
+## What this MVP does (P0)
+
+- **One Node process, many Dispatchers.** Each Dispatcher = 1 Feishu Bot
+  (independent appId/secret) + 1 long-lived Codex `app-server` child + 1
+  Codex thread.
+- **Single-thread, multi-chat fan-in.** A bot can be invited into multiple
+  groups and DMs; every inbound message goes into the same Codex thread.
+  Outbound replies are routed by the inbound's `source_chat_id`.
+- **No dispatcher↔worktree binding.** Codex picks the worktree at `tm`-call
+  time. The Codex daemon's cwd is `~/.codex-host/dispatchers/<id>/cwd/`
+  (intentionally empty).
+- **FIFO + at-most-once.** One running turn per dispatcher. After a server
+  crash, `running` inbound rows are flipped to `unknown` (the user is told
+  to confirm or resend); `awaiting_outbound` rows are safely retried.
+- **Trusted-local only.** No chat allowlist, `approval-policy=never`. Any
+  other deployment must uplift access control first — see
+  [issue #2 §"信任模型"](https://github.com/excitedjs/dreamux/issues/2).
+
+Explicitly **not** in MVP: approval cards, streaming outbound, per-chat
+threads, tm registry isolation, cross-machine coordination, web UI.
+
+## Install / build / test
+
+Two paths; both work, pick whichever fits the workflow.
+
+**Per-package (this directory).** Matches pre-monorepo muscle memory and
+runs the `prepare` hook (`tsc → dist/`):
+
+```bash
+cd packages/dreamux
+npm install
+npm run build       # also runs automatically via `prepare`
+npm run typecheck   # tsc --noEmit (no emit)
+npm test            # smoke + bin-launcher + (live) codex-0134 tests
+```
+
+**Monorepo (from repo root).** Required once a second package exists; CI
+exercises this path so a broken `rush.json` fails CI:
+
+```bash
+node common/scripts/install-run-rush.js update
+node common/scripts/install-run-rush.js build
+node common/scripts/install-run-rush.js test
+```
+
+The bin launchers shell out to plain `node` against the compiled `dist/`
+output; **no `tsx` is needed at runtime** (PR #6).
+
+## Run the server
+
+```bash
+# Preferred — unified CLI (issue #4)
+./bin/dreamux server start
+
+# Backward-compat alias
+./bin/server
+```
+
+Both work from any cwd and via symlinks (PR #6 + bin-launcher tests).
+
+The server uses two separate home directories — by design (decision 0003):
+
+| Path | Purpose | Source of truth |
+|---|---|---|
+| `~/.dreamux/config.toml`                 | User-editable global config — auto-created on first boot with sensible defaults; edit and restart to apply | the operator |
+| `~/.codex-host/state.db`                 | SQLite (dispatchers + inbound buffer)      | the server |
+| `~/.codex-host/admin.sock`               | Admin Unix socket (`0600`)                 | the server |
+| `~/.codex-host/dispatchers/<id>/cwd/`    | Codex app-server cwd                       | the server |
+| `~/.codex-host/dispatchers/<id>/socket`  | Codex Unix socket                          | the server |
+| `~/.codex-host/dispatchers/<id>/*.log`   | Codex stdout / stderr                      | the server |
+
+`rm -rf ~/.codex-host` is a safe recovery — your config in `~/.dreamux/`
+survives. `runtime_dir` and `admin_socket` paths in the config can move
+the `~/.codex-host` half anywhere you like.
+
+## Configure a dispatcher
+
+```bash
+# Bot secret comes from an env var the server process can see.
+export BOT_SECRET_FLOW='cli_secret_XXX'
+
+./bin/dreamux dispatcher add \
+  --id flow \
+  --bot-app-id cli_aaa \
+  --bot-secret-ref env:BOT_SECRET_FLOW
+
+# Inspect / restart
+./bin/dreamux dispatcher list
+./bin/dreamux dispatcher status --id flow
+./bin/dreamux dispatcher start  --id flow   # if not auto-started
+```
+
+`./bin/server-ctl <args>` still works as an alias.
+
+## MVP verification path (issue #2 §"MVP 验收脚本")
+
+1. `dreamux dispatcher add --id flow --bot-app-id cli_aaa --bot-secret-ref env:BOT_SECRET_FLOW`
+2. `dreamux server start` — dispatcher `flow` goes to `ready`
+3. Invite the bot to a Feishu group A, send `hi`
+4. Server delivers it into the Codex thread; reply goes back to group A
+5. Invite the same bot to a DM, ask "do you remember the 'hi' from earlier?"
+6. Same thread, so the reply confirms — and goes back to the DM
+7. Ask the bot to "run the test suite via tm and summarize"
+8. Codex shells out to `tm`, reads stdout/stderr, replies into the source chat
+9. Repeat with a **different** worktree to prove dispatcher↔worktree decoupling
+10. `pkill node` to crash the server, then restart it
+11. Continue chatting — Codex `thread/resume` restores context
+
+## Configuration reference
+
+Precedence for every config-able value (highest wins): env var →
+per-dispatcher field → `~/.dreamux/config.toml` → built-in default.
+See [decision 0003](../../.agents/decisions/0003-global-config-dir.md).
+
+### Global: `~/.dreamux/config.toml`
+
+Auto-created on first boot with this default (excerpt — open the file
+itself for the inline comments explaining each key):
+
+```toml
+runtime_dir = "~/.codex-host"
+# admin_socket = "~/.codex-host/admin.sock"   # default: <runtime_dir>/admin.sock
+
+[codex]
+bin = "codex"
+approval_policy = "never"        # never | auto | auto-approve | on-failure
+sandbox_mode = "workspace-write" # read-only | workspace-write | danger-full-access
+extra_args = []
+initialize_timeout_ms = 10000
+
+[outbound]
+retries = 3
+retry_delay_ms = 1000
+```
+
+Edit and restart `dreamux server start`. Parse errors fail-fast with a
+`file:line` pointer.
+
+### `codex_args_json` (per-dispatcher, overrides global)
+
+JSON object stored in `dispatchers.codex_args_json`:
+
+```json
+{ "approvalPolicy": "never", "sandboxMode": "workspace-write", "extraArgs": ["--model", "gpt-5"] }
+```
+
+| Field            | Default   | Notes                                                |
+| ---------------- | --------- | ---------------------------------------------------- |
+| `approvalPolicy` | inherits `[codex] approval_policy` from `~/.dreamux/config.toml`, else `"never"` | Must be one of `never`/`auto`/`auto-approve`/`on-failure`. Otherwise startup fails fast (issue #2 §"实现陷阱"). |
+| `sandboxMode`    | inherits `[codex] sandbox_mode`, else `"workspace-write"` | Must be one of `read-only`/`workspace-write`/`danger-full-access` (codex 0.134 enum). Validated at dispatcher startup. |
+| `extraArgs`      | appended *after* global `codex.extra_args` | codex's "last write wins" semantics for `-c key=value` mean a per-dispatcher entry effectively overrides a same-key global. |
+
+### Env vars (highest precedence — escape hatch)
+
+| Var                          | Purpose                                            |
+| ---------------------------- | -------------------------------------------------- |
+| `CODEX_HOST_RUNTIME_DIR`     | Override `runtime_dir`                             |
+| `CODEX_HOST_ADMIN_SOCKET`    | Override admin Unix socket path                    |
+| `CODEX_HOST_CODEX_BIN`       | Override `codex.bin`                               |
+| `DREAMUX_CONFIG_DIR`         | Override `~/.dreamux` (where `config.toml` lives)  |
+| `BOT_SECRET_<NAME>`          | Bot secrets referenced by `env:BOT_SECRET_<NAME>`  |
+| `DREAMUX_SKIP_LIVE_CODEX`    | Opt out of the live codex 0.134 integration test (loud skip) |
+
+## What this MVP does **not** do
+
+(see [issue #2 §"明确不在 MVP 范围"](https://github.com/excitedjs/dreamux/issues/2))
+
+- Multiple threads per dispatcher
+- Per-chat memory
+- Approval / Feishu approval cards
+- Streaming assistant deltas
+- tm CLI changes (`tm --json`, registry namespace)
+- Cross-machine coordination
+- Web UI / Prometheus
+- Migration from old claudemux dispatcher state
+- access gate / chat allowlist / pairing (D12 + Trust Model)
+
+## Testing
+
+```bash
+npm test           # smoke + bin-launcher + codex-0134-live
+```
+
+- `tests/smoke.test.ts` — fake-codex-driven dispatcher behavior:
+  happy path, FIFO, crash recovery (running → unknown), thread/resume
+  failure, outbound retry without turn re-run, approval fail-fast.
+- `tests/bin-launcher.test.ts` — spawns the real bash launchers
+  (`dreamux`, `dreamux-server`, `server-ctl`, plus the repo-root
+  forwarders) from arbitrary cwds and through symlinks; static "no tsx"
+  assertion.
+- `tests/codex-0134-live.test.ts` — spawns a real `codex app-server`
+  (skipped loudly when `codex` is missing or wrong version; opt-in via
+  `DREAMUX_SKIP_LIVE_CODEX=1`).
+
+## License
+
+MIT.

package/bin/dreamux

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# Launcher for the unified `dreamux` CLI (issue #4).
+# Resolves its own location through symlinks so it works from any cwd and
+# via any chain of symlinks (npm-link, ~/bin shortcuts, etc.). Runs the
+# compiled dist output produced by `npm install` / `rush build`.
+set -eu
+
+SOURCE="${BASH_SOURCE[0]}"
+hop=0
+while [ -L "$SOURCE" ]; do
+  hop=$((hop + 1))
+  if [ "$hop" -gt 40 ]; then
+    echo "dreamux: too many symlink hops resolving $SOURCE" >&2
+    exit 1
+  fi
+  TARGET="$(readlink "$SOURCE")"
+  if [ "${TARGET:0:1}" = "/" ]; then
+    SOURCE="$TARGET"
+  else
+    SOURCE="$(dirname -- "$SOURCE")/$TARGET"
+  fi
+done
+
+DIR="$(cd -- "$(dirname -- "$SOURCE")/.." &> /dev/null && pwd)"
+TARGET="$DIR/dist/cli/dreamux.js"
+if [ ! -f "$TARGET" ]; then
+  echo "dreamux: $TARGET is missing." >&2
+  echo "Run 'npm install' (it runs 'npm run build' via the prepare hook), 'npm run build', or 'rush build' from the monorepo root first." >&2
+  exit 1
+fi
+exec node "$TARGET" "$@"

package/bin/server

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Launcher for dreamux-server.
+#
+# Resolves its own location (following symlinks) so it works from any cwd
+# AND when invoked via a symlink (e.g. `npm install -g` puts a symlink under
+# the node bin dir). Runs the compiled dist output produced by
+# `npm install` / `npm run build`.
+set -eu
+
+SOURCE="${BASH_SOURCE[0]}"
+# Resolve symlinks until we find the real file. Handles both absolute and
+# relative symlink targets. Bounded by a reasonable loop cap to detect cycles.
+hop=0
+while [ -L "$SOURCE" ]; do
+  hop=$((hop + 1))
+  if [ "$hop" -gt 40 ]; then
+    echo "dreamux-server: too many symlink hops resolving $SOURCE" >&2
+    exit 1
+  fi
+  TARGET="$(readlink "$SOURCE")"
+  if [ "${TARGET:0:1}" = "/" ]; then
+    SOURCE="$TARGET"
+  else
+    SOURCE="$(dirname -- "$SOURCE")/$TARGET"
+  fi
+done
+
+DIR="$(cd -- "$(dirname -- "$SOURCE")/.." &> /dev/null && pwd)"
+TARGET="$DIR/dist/cli/server.js"
+if [ ! -f "$TARGET" ]; then
+  echo "dreamux-server: $TARGET is missing." >&2
+  echo "Run 'npm install' (it runs 'npm run build' via the prepare hook) or 'npm run build' from $DIR first." >&2
+  exit 1
+fi
+exec node "$TARGET" "$@"

package/bin/server-ctl

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# Launcher for server-ctl. See bin/server for resolution details.
+set -eu
+
+SOURCE="${BASH_SOURCE[0]}"
+hop=0
+while [ -L "$SOURCE" ]; do
+  hop=$((hop + 1))
+  if [ "$hop" -gt 40 ]; then
+    echo "server-ctl: too many symlink hops resolving $SOURCE" >&2
+    exit 1
+  fi
+  TARGET="$(readlink "$SOURCE")"
+  if [ "${TARGET:0:1}" = "/" ]; then
+    SOURCE="$TARGET"
+  else
+    SOURCE="$(dirname -- "$SOURCE")/$TARGET"
+  fi
+done
+
+DIR="$(cd -- "$(dirname -- "$SOURCE")/.." &> /dev/null && pwd)"
+TARGET="$DIR/dist/cli/server-ctl.js"
+if [ ! -f "$TARGET" ]; then
+  echo "server-ctl: $TARGET is missing." >&2
+  echo "Run 'npm install' (it runs 'npm run build' via the prepare hook) or 'npm run build' from $DIR first." >&2
+  exit 1
+fi
+exec node "$TARGET" "$@"

package/db/migrations/0001_init.sql

@@ -0,0 +1,49 @@
+-- dreamux MVP schema (issue excitedjs/dreamux#2)
+-- Version tracked via PRAGMA user_version, not a schema_version table.
+
+CREATE TABLE dispatchers (
+  dispatcher_id        TEXT PRIMARY KEY,
+  bot_app_id           TEXT NOT NULL UNIQUE,
+  bot_secret_ref       TEXT NOT NULL,
+  codex_args_json      TEXT NOT NULL DEFAULT '{}',
+  codex_cwd            TEXT,
+  thread_id            TEXT,
+  status               TEXT NOT NULL DEFAULT 'declared'
+    CHECK (status IN ('declared','starting','ready','degraded','stopping','stopped')),
+  enabled              INTEGER NOT NULL DEFAULT 1,
+  created_at           INTEGER NOT NULL,
+  updated_at           INTEGER NOT NULL,
+  last_started_at      INTEGER,
+  last_ready_at        INTEGER,
+  last_error           TEXT,
+  last_lost_thread_id  TEXT
+);
+
+CREATE TABLE inbound_buffer (
+  id                       INTEGER PRIMARY KEY AUTOINCREMENT,
+  dispatcher_id            TEXT NOT NULL REFERENCES dispatchers(dispatcher_id),
+  source_chat_id           TEXT NOT NULL,
+  source_message_id        TEXT,
+  sender_id                TEXT,
+  feishu_event_json        TEXT NOT NULL,
+  parsed_text              TEXT NOT NULL,
+  state                    TEXT NOT NULL DEFAULT 'queued'
+    CHECK (state IN ('queued','running','awaiting_outbound',
+                     'completed','outbound_failed','failed','unknown')),
+  codex_turn_id            TEXT,
+  assistant_text           TEXT,
+  feishu_message_ids_json  TEXT,
+  outbound_error           TEXT,
+  received_at              INTEGER NOT NULL,
+  started_at               INTEGER,
+  completed_at             INTEGER,
+  failed_at                INTEGER,
+  error                    TEXT
+);
+
+CREATE INDEX idx_inbound_dispatcher_state
+  ON inbound_buffer(dispatcher_id, state, id);
+
+CREATE UNIQUE INDEX idx_inbound_message_dedupe
+  ON inbound_buffer(dispatcher_id, source_message_id)
+  WHERE source_message_id IS NOT NULL;

package/dist/admin/methods.js

@@ -0,0 +1,103 @@
+/**
+ * Admin method handlers.
+ *
+ * Each handler takes typed params and returns the `result` payload to put on
+ * the wire. Throws `AdminError` for user-actionable failures (the protocol
+ * layer formats those as `error` responses).
+ */
+import { AdminError } from './protocol.js';
+export const adminMethods = {
+    'server.status': (server) => ({
+        pid: process.pid,
+        uptimeSec: Math.floor(process.uptime()),
+        dispatchers: server.summarize(),
+    }),
+    'dispatcher.add': (server, params) => {
+        const id = mustString(params, 'dispatcher_id');
+        const botAppId = mustString(params, 'bot_app_id');
+        const botSecretRef = mustString(params, 'bot_secret_ref');
+        const codexArgsJson = optionalString(params, 'codex_args_json') ?? '{}';
+        const codexCwd = optionalString(params, 'codex_cwd');
+        try {
+            const row = server.repos.dispatchers.create({
+                dispatcher_id: id,
+                bot_app_id: botAppId,
+                bot_secret_ref: botSecretRef,
+                codex_args_json: codexArgsJson,
+                codex_cwd: codexCwd ?? null,
+            });
+            return { dispatcher_id: row.dispatcher_id, status: row.status };
+        }
+        catch (err) {
+            if (err && typeof err === 'object') {
+                const code = err.code;
+                if (code === 'SQLITE_CONSTRAINT_UNIQUE' ||
+                    code === 'SQLITE_CONSTRAINT_PRIMARYKEY') {
+                    throw new AdminError('CONFLICT', `dispatcher_id or bot_app_id already exists: ${err.message}`);
+                }
+            }
+            throw err;
+        }
+    },
+    'dispatcher.remove': async (server, params) => {
+        const id = mustString(params, 'dispatcher_id');
+        const row = server.repos.dispatchers.get(id);
+        if (row === null) {
+            throw new AdminError('DISPATCHER_NOT_FOUND', `no dispatcher with id '${id}'`);
+        }
+        await server.stopDispatcher(id);
+        server.repos.dispatchers.remove(id);
+        return { dispatcher_id: id };
+    },
+    'dispatcher.list': (server) => ({ dispatchers: server.summarize() }),
+    'dispatcher.status': (server, params) => {
+        const id = mustString(params, 'dispatcher_id');
+        const row = server.repos.dispatchers.get(id);
+        if (row === null) {
+            throw new AdminError('DISPATCHER_NOT_FOUND', `no dispatcher with id '${id}'`);
+        }
+        const runtime = server.getRuntime(id);
+        const counts = server.repos.inbound.countByState(id);
+        return {
+            dispatcher_id: row.dispatcher_id,
+            bot_app_id: row.bot_app_id,
+            status: runtime?.getStatus() ?? row.status,
+            thread_id: runtime?.getThreadId() ?? row.thread_id,
+            last_lost_thread_id: row.last_lost_thread_id,
+            last_error: row.last_error,
+            inbound_buffer: counts,
+        };
+    },
+    'dispatcher.start': async (server, params) => {
+        const id = mustString(params, 'dispatcher_id');
+        const row = server.repos.dispatchers.get(id);
+        if (row === null) {
+            throw new AdminError('DISPATCHER_NOT_FOUND', `no dispatcher with id '${id}'`);
+        }
+        await server.startDispatcher(id);
+        return { dispatcher_id: id, status: server.getRuntime(id)?.getStatus() };
+    },
+    'dispatcher.stop': async (server, params) => {
+        const id = mustString(params, 'dispatcher_id');
+        await server.stopDispatcher(id);
+        return { dispatcher_id: id, status: 'stopped' };
+    },
+};
+function mustString(params, key) {
+    if (params === undefined || typeof params[key] !== 'string') {
+        throw new AdminError('BAD_REQUEST', `missing or non-string param '${key}'`);
+    }
+    return params[key];
+}
+function optionalString(params, key) {
+    if (params === undefined)
+        return null;
+    const v = params[key];
+    if (v === undefined || v === null)
+        return null;
+    if (typeof v !== 'string') {
+        throw new AdminError('BAD_REQUEST', `param '${key}' must be a string`);
+    }
+    return v;
+}
+//# sourceMappingURL=methods.js.map

package/dist/admin/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/admin/methods.ts"],"names":[],"mappings":"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"}

package/dist/admin/protocol.js

@@ -0,0 +1,15 @@
+/**
+ * NDJSON Unix-socket protocol for admin commands (issue #2 §"管理接口").
+ *
+ * One line in / one line out. Permissions on the socket are 0600 (only the
+ * owner). Method names use dotted lowercase; error codes use SCREAMING_SNAKE_CASE.
+ */
+export class AdminError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AdminError';
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/admin/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/admin/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACP;IAA5B,YAA4B,IAAY,EAAE,OAAe;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QADW,SAAI,GAAJ,IAAI,CAAQ;QAEtC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}