@openduo/duoduo 0.4.4 → 0.4.6

package/bootstrap/codex-runtime.md

@@ -0,0 +1,68 @@
+# Codex Runtime
+
+Duoduo supports two runtime backends:
+
+- **Claude** (default) — Claude Agent SDK.
+- **Codex** (GPT-5.4) — Codex app-server protocol over stdio.
+
+Codex is off by default.
+
+## Prerequisites
+
+- `codex` CLI installed and on `$PATH`.
+- `codex` authenticated with valid API credentials.
+
+## Environment Variables
+
+| Variable               | Required | Values             | Default           |
+| ---------------------- | -------- | ------------------ | ----------------- |
+| `ALADUO_CODEX_ENABLED` | Yes      | `1`, `true`, `yes` | off               |
+| `ALADUO_CODEX_SANDBOX` | No       | see below          | `workspace-write` |
+
+### Sandbox Modes
+
+| Value                | Disk      | Network | Notes                                         |
+| -------------------- | --------- | ------- | --------------------------------------------- |
+| `workspace-write`    | cwd only  | No      | Default. Safe for most jobs.                  |
+| `read-only`          | Read-only | No      | Analysis-only tasks.                          |
+| `danger-full-access` | Full      | Yes     | Needed for localhost API or external network. |
+
+## Enable
+
+Add the variables to the daemon's persistent config file and restart:
+
+```bash
+# ~/.config/duoduo/.env  (created if missing)
+echo 'ALADUO_CODEX_ENABLED=1' >> ~/.config/duoduo/.env
+# optional:
+echo 'ALADUO_CODEX_SANDBOX=workspace-write' >> ~/.config/duoduo/.env
+
+duoduo daemon restart
+```
+
+> **Note:** The daemon reads `~/.config/duoduo/.env` on startup. Shell-only
+> `export` does not persist across launchd/systemd restarts.
+
+## Disable
+
+Remove or comment out `ALADUO_CODEX_ENABLED` from `~/.config/duoduo/.env`,
+then restart:
+
+```bash
+sed -i '' '/^ALADUO_CODEX_ENABLED/d' ~/.config/duoduo/.env
+duoduo daemon restart
+```
+
+Existing `runtime: codex` jobs silently fall back to Claude.
+
+## Usage
+
+When enabled, the ManageJob tool exposes a `runtime` field (`"claude"` | `"codex"`).
+A preflight check runs `codex --version` at job creation and reports errors early.
+
+## Limitations
+
+- Codex built-in tools (bash, file edit, web search) cannot be selectively disabled.
+- `additionalDirectories` not supported — memory board is injected inline.
+- `AGENTS.md` is auto-symlinked from `CLAUDE.md` in job workspaces.
+- Memory board changes take effect on next thread, not mid-thread.

package/bootstrap/dashboard.html

@@ -836,7 +836,7 @@ body{
     interval_ms:"ALADUO_CADENCE_INTERVAL_MS",meta_max_quiet_ticks:"ALADUO_META_MAX_QUIET_TICKS",
     runtime_lock_heartbeat_ms:"ALADUO_RUNTIME_LOCK_HEARTBEAT_MS",
     pull_limit:"ALADUO_PULL_LIMIT",pull_wait_ms:"ALADUO_PULL_WAIT_MS",subscribe_replay_limit:"ALADUO_SUBSCRIBE_REPLAY_LIMIT",
-    log_level:"ALADUO_LOG_LEVEL",sdk_debug:"ALADUO_SDK_DEBUG",log_session_lifecycle:"ALADUO_LOG_SESSION_LIFECYCLE",
+    log_level:"ALADUO_LOG_LEVEL",sdk_debug:"ALADUO_SDK_DEBUG",log_session_lifecycle:"ALADUO_LOG_SESSION_LIFECYCLE",telemetry_enabled:"ALADUO_TELEMETRY_ENABLED",
     permission_mode:"ALADUO_PERMISSION_MODE",
     work_dir:"ALADUO_WORK_DIR",bootstrap_dir:"ALADUO_BOOTSTRAP_DIR",meta_prompt_path:"ALADUO_META_PROMPT_PATH"
   };

package/bootstrap/var/channels/DUODUO.md

@@ -54,6 +54,11 @@ disallowedTools: ["EnterPlanMode"]
 additionalDirectories:
   - /refs
   - ~/shared-docs
+
+# Enable/disable streaming (optional, default: true)
+# When false, output is buffered until the turn completes.
+# Useful for group chats where streaming typing indicators are noise.
+stream: false
 ---
 You are a research assistant specialized in financial analysis.
 Use the reference documents in /refs/ for evidence-based answers.

package/bootstrap/var/telemetry/DUODUO.md

@@ -54,6 +54,14 @@ Bare numeric values are treated as minutes, so `--since 90` means the last 90 mi
 
 The report prints `count`, `avg`, `p50`, `p95`, and `max` for each known metric.
 
+To disable telemetry file persistence entirely on a host, set:
+
+```bash
+ALADUO_TELEMETRY_ENABLED=false
+```
+
+When disabled, duoduo still emits in-process debug telemetry logs when log level allows it, but it skips appending JSONL files under this directory.
+
 ## Guarantees
 
 - **Append-only**: telemetry files are never rewritten in place.