@letta-ai/dreams 0.0.3 → 0.0.4

package/dist/local/detect.js

@@ -3,7 +3,8 @@
  * `dreams source detect` — register a harness as a detected Cloud source
  * without reading transcripts, approving roots, scanning, or uploading.
  *
- * Today CLI defaults to the Claude adapter ([LET-10313]).
+ * CLI defaults to the Claude adapter; pass an explicit adapter for Codex
+ * (`dreams source detect --source codex`) ([LET-10313] / [LET-10315]).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.detectClaudeCodeHarness = detectClaudeCodeHarness;
@@ -16,6 +17,7 @@ const version_1 = require("../version");
 const skill_1 = require("../skill");
 const bindings_1 = require("./bindings");
 const claude_1 = require("./claude");
+const codex_1 = require("./codex");
 const db_1 = require("./db");
 const leases_1 = require("./leases");
 /**
@@ -59,7 +61,9 @@ async function runSourceDetect(db, options) {
             registration: "skipped",
             message: adapter.sourceType === claude_1.claudeSourceAdapter.sourceType
                 ? "Claude Code was not detected under ~/.claude"
-                : `${adapter.displayName} was not detected`,
+                : adapter.sourceType === codex_1.CODEX_SOURCE_TYPE
+                    ? "Codex was not detected under ~/.codex"
+                    : `${adapter.displayName} was not detected`,
         };
     }
     const localId = ensureLocalDetectedSource(db, options.leaseOwner, adapter);

package/dist/local/hooks-install.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * `dreams hooks install [--dry-run] [--source <type>] [--json]`
+ *
+ * CLI owns the mutation; the setup skill owns consent and showing the dry-run.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandHooksInstall = commandHooksInstall;
+const claude_1 = require("./claude");
+const claude_hooks_1 = require("./claude-hooks");
+const codex_1 = require("./codex");
+const codex_hooks_1 = require("./codex-hooks");
+const source_adapters_1 = require("./source-adapters");
+const skill_1 = require("../skill");
+const managed_install_1 = require("../managed-install");
+function emit(json, payload, human) {
+    if (json)
+        console.log(JSON.stringify(payload, null, 2));
+    else
+        console.log(human());
+}
+function commandHooksInstall(options) {
+    let sources;
+    try {
+        if (options.sourceType) {
+            const adapter = (0, source_adapters_1.resolveSourceAdapter)(options.sourceType);
+            if (adapter.sourceType !== "claude-code" && adapter.sourceType !== "codex") {
+                process.stderr.write(`hooks install does not support source type ${adapter.sourceType}\n`);
+                return 1;
+            }
+            sources = [adapter.sourceType];
+        }
+        else {
+            sources = ["claude-code", "codex"];
+        }
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    const cliPath = (0, managed_install_1.stableCliPath)();
+    const results = [];
+    const humanLines = [
+        options.dryRun ? "Dreams hooks install (dry-run — no files written)" : "Dreams hooks install",
+        "",
+        `  CLI path: ${cliPath}`,
+    ];
+    for (const source of sources) {
+        if (source === "claude-code") {
+            const present = (0, claude_1.detectClaudeCodeHarness)().present;
+            if (!present && options.sourceType === undefined) {
+                humanLines.push("", "Claude Code: harness not detected — skipped");
+                results.push({ source: "claude-code", status: "skipped", reason: "harness_not_detected" });
+                continue;
+            }
+            const plan = (0, claude_hooks_1.planClaudeHooksInstall)({ cliPath });
+            if (!options.dryRun)
+                (0, claude_hooks_1.installClaudeHooks)({ cliPath });
+            results.push({
+                source: "claude-code",
+                status: options.dryRun ? "dry_run" : plan.changed ? "updated" : "unchanged",
+                settings_path: plan.settings_path,
+                changed: plan.changed,
+                session_start_command: plan.session_start_command,
+                stop_command: plan.stop_command,
+                next_contents: options.dryRun ? plan.next_contents : undefined,
+            });
+            humanLines.push("", `Claude Code (${options.dryRun ? "dry-run" : plan.changed ? "updated" : "unchanged"}):`, `  Settings: ${plan.settings_path}`, `  SessionStart → wake: ${plan.session_start_command}`, `  Stop → sync:         ${plan.stop_command}`);
+            continue;
+        }
+        const present = (0, codex_1.detectCodexHarness)().present;
+        if (!present && options.sourceType === undefined) {
+            humanLines.push("", "Codex: harness not detected — skipped");
+            results.push({ source: "codex", status: "skipped", reason: "harness_not_detected" });
+            continue;
+        }
+        const hookScriptPath = (0, skill_1.codexSyncHookScriptPath)();
+        const plan = (0, codex_hooks_1.planCodexHooksInstall)({ cliPath, hookScriptPath });
+        if (!options.dryRun)
+            (0, codex_hooks_1.installCodexHooks)({ cliPath, hookScriptPath });
+        results.push({
+            source: "codex",
+            status: options.dryRun ? "dry_run" : plan.hooks_changed || plan.config_changed ? "updated" : "unchanged",
+            hooks_path: plan.hooks_path,
+            config_path: plan.config_path,
+            hooks_changed: plan.hooks_changed,
+            config_changed: plan.config_changed,
+            session_start_command: plan.session_start_command,
+            stop_command: plan.stop_command,
+            next_hooks_contents: options.dryRun ? plan.next_hooks_contents : undefined,
+            next_config_contents: options.dryRun ? plan.next_config_contents : undefined,
+        });
+        humanLines.push("", `Codex (${options.dryRun ? "dry-run" : plan.hooks_changed || plan.config_changed ? "updated" : "unchanged"}):`, `  Hooks:  ${plan.hooks_path}`, `  Config: ${plan.config_path}`, `  SessionStart → wake: ${plan.session_start_command}`, `  Stop → sync:         ${plan.stop_command}`, options.dryRun ? "  (Also ensures [features].hooks = true in config.toml)" : "");
+    }
+    emit(options.json, {
+        status: "ok",
+        dry_run: options.dryRun,
+        cli_path: cliPath,
+        results,
+    }, () => humanLines.filter((line) => line !== "").join("\n"));
+    return 0;
+}

package/dist/local/source-adapters.js

@@ -11,6 +11,7 @@ exports.registerSourceAdapter = registerSourceAdapter;
 exports.getSourceAdapterById = getSourceAdapterById;
 exports.getSourceAdapterByType = getSourceAdapterByType;
 exports.defaultSourceAdapter = defaultSourceAdapter;
+exports.resolveSourceAdapter = resolveSourceAdapter;
 exports.listSourceAdapters = listSourceAdapters;
 const claude_1 = require("./claude");
 const codex_1 = require("./codex");
@@ -51,6 +52,18 @@ function defaultSourceAdapter() {
         throw new Error("no default source adapter registered");
     return getSourceAdapterById(defaultSourceId);
 }
+/**
+ * Resolve `--source <type>` at command boundaries (stdin never selects source).
+ * Omitted / undefined preserves the Claude default; empty/unknown fail closed.
+ */
+function resolveSourceAdapter(sourceType) {
+    if (sourceType === undefined)
+        return defaultSourceAdapter();
+    const trimmed = sourceType.trim();
+    if (!trimmed)
+        throw new Error("unknown source type: (empty)");
+    return getSourceAdapterByType(trimmed);
+}
 function listSourceAdapters() {
     return [...bySourceId.values()];
 }

package/dist/local/sync-control.js

@@ -10,7 +10,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_UPLOAD_ROW_BUDGET = exports.MAX_TRAILING_PASSES = exports.RETRY_BACKOFF_MS = exports.CADENCE_MS = exports.DEFAULT_SOURCE_ID = void 0;
 exports.uploadRowBudget = uploadRowBudget;
 exports.readTrigger = readTrigger;
+exports.readActiveSourceId = readActiveSourceId;
 exports.readRuntime = readRuntime;
+exports.peekRuntime = peekRuntime;
+exports.sourceExists = sourceExists;
 exports.recordSyncRequest = recordSyncRequest;
 exports.setPaused = setPaused;
 exports.isPaused = isPaused;
@@ -20,6 +23,7 @@ exports.completeSyncPass = completeSyncPass;
 exports.markRuntimeDegraded = markRuntimeDegraded;
 exports.earliestUploadRetryAt = earliestUploadRetryAt;
 exports.markRuntimeRunning = markRuntimeRunning;
+exports.clearActiveSourceId = clearActiveSourceId;
 exports.normalizeStaleRunning = normalizeStaleRunning;
 exports.triggerPending = triggerPending;
 exports.sourceIsRunnable = sourceIsRunnable;
@@ -102,31 +106,60 @@ function globalWorkerState(db) {
  * Per-source schedule view + global pause. Cadence/retry fields come from
  * `sync_triggers`; `paused` and global `running` come from `sync_runtime`.
  */
-function readRuntime(db, sourceId = exports.DEFAULT_SOURCE_ID) {
+function runtimeFromTriggerRow(db, sourceId, row) {
     ensureRuntime(db);
-    ensureTrigger(db, sourceId);
     const paused = globalPaused(db);
-    const globalState = globalWorkerState(db);
-    const row = db
-        .prepare(`SELECT state, last_attempt_at, last_success_at, last_error_at, last_error_code, last_error_message, next_due_at
-       FROM sync_triggers WHERE source_id = ?`)
-        .get(sourceId);
-    let state = row.state || "idle";
+    let state = row?.state || "idle";
     if (paused)
         state = "paused";
-    else if (globalState === "running")
+    else if (readActiveSourceId(db) === sourceId && globalWorkerState(db) === "running") {
+        // Only the source that owns the singleton worker is "running".
         state = "running";
+    }
     return {
         paused,
         state,
-        last_attempt_at: row.last_attempt_at,
-        last_success_at: row.last_success_at,
-        last_error_at: row.last_error_at,
-        last_error_code: row.last_error_code ?? null,
-        last_error_message: row.last_error_message,
-        next_due_at: row.next_due_at,
+        last_attempt_at: row?.last_attempt_at ?? null,
+        last_success_at: row?.last_success_at ?? null,
+        last_error_at: row?.last_error_at ?? null,
+        last_error_code: row?.last_error_code ?? null,
+        last_error_message: row?.last_error_message ?? null,
+        next_due_at: row?.next_due_at ?? null,
     };
 }
+function readActiveSourceId(db) {
+    ensureRuntime(db);
+    try {
+        const row = db.prepare("SELECT active_source_id FROM sync_runtime WHERE id = 1").get();
+        return row?.active_source_id ?? null;
+    }
+    catch {
+        // Pre-migration databases in the middle of openDb won't hit this path.
+        return null;
+    }
+}
+function readRuntime(db, sourceId = exports.DEFAULT_SOURCE_ID) {
+    ensureTrigger(db, sourceId);
+    const row = db
+        .prepare(`SELECT state, last_attempt_at, last_success_at, last_error_at, last_error_code, last_error_message, next_due_at
+       FROM sync_triggers WHERE source_id = ?`)
+        .get(sourceId);
+    return runtimeFromTriggerRow(db, sourceId, row);
+}
+/**
+ * Status-safe runtime peek: never creates source/trigger rows. Missing sources
+ * report as idle/not configured ([LET-10317]).
+ */
+function peekRuntime(db, sourceId) {
+    const row = db
+        .prepare(`SELECT state, last_attempt_at, last_success_at, last_error_at, last_error_code, last_error_message, next_due_at
+       FROM sync_triggers WHERE source_id = ?`)
+        .get(sourceId);
+    return runtimeFromTriggerRow(db, sourceId, row);
+}
+function sourceExists(db, sourceId) {
+    return Boolean(db.prepare("SELECT id FROM sources WHERE id = ?").get(sourceId));
+}
 /** Atomic pause check + trigger record. Returns null when paused. */
 function recordSyncRequest(db, options = {}) {
     const sourceId = options.sourceId ?? exports.DEFAULT_SOURCE_ID;
@@ -272,10 +305,22 @@ function earliestUploadRetryAt(db, sourceId = exports.DEFAULT_SOURCE_ID) {
         .get(sourceId);
     return row?.next_at ?? null;
 }
-function markRuntimeRunning(db) {
+function markRuntimeRunning(db, sourceId = exports.DEFAULT_SOURCE_ID) {
     (0, db_1.tx)(db, () => {
         ensureRuntime(db);
-        db.prepare(`UPDATE sync_runtime SET state = CASE WHEN paused = 1 THEN 'paused' ELSE 'running' END, last_attempt_at = ?, updated_at = ? WHERE id = 1`).run((0, db_1.nowIso)(), (0, db_1.nowIso)());
+        db.prepare(`UPDATE sync_runtime
+          SET state = CASE WHEN paused = 1 THEN 'paused' ELSE 'running' END,
+              active_source_id = ?,
+              last_attempt_at = ?,
+              updated_at = ?
+        WHERE id = 1`).run(sourceId, (0, db_1.nowIso)(), (0, db_1.nowIso)());
+    });
+}
+/** Clear singleton-worker source ownership (call on worker shutdown after lease release). */
+function clearActiveSourceId(db) {
+    (0, db_1.tx)(db, () => {
+        ensureRuntime(db);
+        db.prepare(`UPDATE sync_runtime SET active_source_id = NULL, updated_at = ? WHERE id = 1`).run((0, db_1.nowIso)());
     });
 }
 /** Normalize stale running state when no worker lease is held. */
@@ -285,11 +330,17 @@ function normalizeStaleRunning(db, workerLeaseHeld) {
     (0, db_1.tx)(db, () => {
         ensureRuntime(db);
         const row = db.prepare("SELECT state, paused FROM sync_runtime WHERE id = 1").get();
-        if (row.state !== "running")
-            return;
-        db.prepare(`UPDATE sync_runtime
-         SET state = CASE WHEN paused = 1 THEN 'paused' ELSE 'idle' END, updated_at = ?
-       WHERE id = 1`).run((0, db_1.nowIso)());
+        if (row.state === "running") {
+            db.prepare(`UPDATE sync_runtime
+           SET state = CASE WHEN paused = 1 THEN 'paused' ELSE 'idle' END,
+               active_source_id = NULL,
+               updated_at = ?
+         WHERE id = 1`).run((0, db_1.nowIso)());
+        }
+        else {
+            // Pass completion may already have set idle while ownership lingered.
+            db.prepare(`UPDATE sync_runtime SET active_source_id = NULL, updated_at = ? WHERE id = 1`).run((0, db_1.nowIso)());
+        }
     });
 }
 function triggerPending(db, sourceId = exports.DEFAULT_SOURCE_ID) {