@raidiant/notifai 0.5.0 → 0.5.1

package/dist/codex-wake.js

@@ -0,0 +1,238 @@
+import { spawn } from 'node:child_process';
+import { closeSync, constants, existsSync, openSync } from 'node:fs';
+import path from 'node:path';
+import { configHome } from './install-hooks.js';
+import { hookContinuationRoute, } from './hooks.js';
+/** Codex's per-thread writer lock directory, relative to `$CODEX_HOME`. */
+export const CODEX_THREAD_LOCK_DIR = 'thread-writer-locks';
+/**
+ * BSD `open(2)` lock flags. Node does not surface them in `fs.constants`, and
+ * they are the only way to take a non-blocking `flock` from Node without a
+ * native addon: the kernel takes the lock at open and drops it at close.
+ */
+const O_EXLOCK = 0x20;
+const O_NONBLOCK = 0x4;
+/** Platforms whose `open(2)` implements `O_EXLOCK`. Everything else fails closed. */
+const LOCK_PROBE_PLATFORMS = new Set(['darwin', 'freebsd', 'openbsd']);
+/** Codex thread ids are UUIDs, and the lock file is named by the exact id. */
+const THREAD_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * The one cross-process oracle for "who owns this Codex thread".
+ *
+ * Codex's thread store takes a non-blocking `flock(LOCK_EX)` on a zero-byte
+ * file per thread and holds it for as long as that process owns the thread —
+ * verified against both a hosted app-server thread sitting idle and an
+ * in-process `codex exec` run (2026-08-12). Because the kernel holds it, a
+ * crash, SIGKILL, or reboot releases it instantly, and the leftover file proves
+ * nothing: only the lock does. Codex fails closed itself with `-32600` when a
+ * second writer contends, but that is the backstop; this is the gate.
+ */
+export function observeCodexThread(threadId, env, adapters) {
+    if (!THREAD_ID.test(threadId)) {
+        return { state: 'unknown', reason: 'the Codex session id is not a thread id' };
+    }
+    try {
+        return adapters.probeThreadWriter(codexThreadLockPath(threadId, env));
+    }
+    catch (err) {
+        return {
+            state: 'unknown',
+            reason: `Codex thread-writer lock probe failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+export function codexThreadLockPath(threadId, env) {
+    return path.join(codexThreadLockDirectory(env), `${threadId}.lock`);
+}
+export function codexThreadLockDirectory(env) {
+    return path.join(configHome(env, 'CODEX_HOME', '.codex'), CODEX_THREAD_LOCK_DIR);
+}
+/**
+ * Whether a Codex thread whose Stop hook has already returned could still be
+ * cold-resumed, decided without taking any lock or spawning anything.
+ *
+ * Two things have to hold: this platform must implement the non-blocking
+ * `flock` the probe is built on, and `$CODEX_HOME` must actually have a
+ * thread-writer-lock directory — its absence is not evidence that a thread is
+ * unowned, so the gate fails closed and the answer waits for the next turn.
+ * Neither affects the ordinary path, where the hook's own stdout continues the
+ * held turn.
+ */
+export function inspectCodexResume(env, options) {
+    const lockDirectory = codexThreadLockDirectory(env);
+    if (!LOCK_PROBE_PLATFORMS.has(options.platform)) {
+        return {
+            state: 'unavailable',
+            reason: `no non-blocking thread-writer lock probe exists on ${options.platform}`,
+        };
+    }
+    if (!options.directoryExists(lockDirectory)) {
+        return {
+            state: 'unavailable',
+            reason: `no thread-writer-lock directory at ${lockDirectory}, so no thread can be proven unowned`,
+        };
+    }
+    return { state: 'ready', lockDirectory };
+}
+/**
+ * Codex's answer-delivery route: the blocking Stop hook, then nothing else.
+ *
+ * The default is the hook continuation itself. While the Codex process that
+ * invoked this hook is alive it is reading this process's stdout, and
+ * `{"decision":"block"}` there creates a real new user turn — no launch
+ * ownership, no control plane, no probe required. That path must never depend
+ * on the lock probe: printing to a dead pipe cannot ghost-write anything, so
+ * an unreadable `$CODEX_HOME` is not a reason to withhold a continuation.
+ *
+ * Only when that process is gone does the answer need another last meter, and
+ * then exactly one is safe: a cold `codex exec resume` of a thread no live
+ * writer owns. Anything else — a live writer, an unprobeable platform, a thread
+ * id we cannot name — is journaled and replayed at the session's next Stop.
+ * That accepted gap is the honest floor of the Codex adapter: a session that
+ * went idle after its Stop returned, which Notifai did not launch, cannot be
+ * woken in place.
+ */
+export function codexWakeRoute(options) {
+    const env = options.env ?? process.env;
+    const adapters = options.adapters ?? systemCodexWakeAdapters(env);
+    const continuation = hookContinuationRoute();
+    return {
+        kind: 'hook-continuation',
+        async deliver(event) {
+            if (adapters.sourceAlive(options.sourcePid))
+                return continuation.deliver(event);
+            // Probe immediately before the spawn, twice, and never trust the earlier
+            // answer: ownership is a kernel fact that can change between two syscalls,
+            // and resuming a thread someone else owns is the disqualifying failure.
+            const observed = observeCodexThread(options.threadId, env, adapters);
+            const held = holdForNextTurn(observed);
+            if (held !== null)
+                return held;
+            const confirmed = observeCodexThread(options.threadId, env, adapters);
+            const raced = holdForNextTurn(confirmed);
+            if (raced !== null)
+                return raced;
+            await adapters.resume(options.threadId, options.cwd, event.context);
+            return {
+                notes: ['cold-resumed the stopped Codex thread with its accepted answer'],
+                log: { route: 'cold-resume', stage: 'delivered' },
+                // The resume ran: the thread holds the answer, and no later hook of this
+                // session will report on a turn that started elsewhere.
+                acknowledgement: 'delivered',
+            };
+        },
+    };
+}
+/** The journal, with the exact reason the thread could not be resumed. */
+function holdForNextTurn(observation) {
+    if (observation.state === 'stopped')
+        return null;
+    const reason = observation.state === 'live'
+        ? 'a live writer owns the Codex thread and this hook can no longer continue it'
+        : observation.reason;
+    return {
+        notes: [`holding the accepted answer for the next turn: ${reason}`],
+        log: { route: 'hold-for-next-turn', stage: 'queued', reason },
+        acknowledgement: 'held',
+    };
+}
+/**
+ * Take and release the writer lock in one open/close pair.
+ *
+ * The probe momentarily owns the lock when it is free, so it is held for
+ * microseconds and never across a spawn — a probe racing a legitimate resume
+ * must not be what makes that resume fail.
+ */
+function probeThreadWriterLock(lockPath) {
+    if (!LOCK_PROBE_PLATFORMS.has(process.platform)) {
+        return {
+            state: 'unknown',
+            reason: `no non-blocking thread-writer lock probe exists on ${process.platform}`,
+        };
+    }
+    const directory = path.dirname(lockPath);
+    if (!existsSync(directory)) {
+        // No lock directory means this is not a Codex home that has ever opened a
+        // thread, so its silence is not evidence that nothing owns this one.
+        return { state: 'unknown', reason: `no Codex thread-writer lock directory at ${directory}` };
+    }
+    let handle;
+    try {
+        handle = openSync(lockPath, constants.O_RDONLY | O_EXLOCK | O_NONBLOCK);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'EAGAIN' || code === 'EWOULDBLOCK')
+            return { state: 'live' };
+        // Codex unlinks the lock file when its writer drops cleanly, so a missing
+        // file inside a real lock directory means the thread has no owner.
+        if (code === 'ENOENT')
+            return { state: 'stopped' };
+        return {
+            state: 'unknown',
+            reason: `Codex thread-writer lock probe failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    closeSync(handle);
+    return { state: 'stopped' };
+}
+function runCodex(args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('codex', args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const stdout = [];
+        const stderr = [];
+        child.stdout?.on('data', (chunk) => stdout.push(Buffer.from(chunk)));
+        child.stderr?.on('data', (chunk) => stderr.push(Buffer.from(chunk)));
+        child.once('error', reject);
+        child.once('exit', (code, signal) => {
+            if (code === 0) {
+                resolve(Buffer.concat(stdout).toString());
+                return;
+            }
+            reject(new Error(`codex ${args[0] ?? ''} exited ${code === null ? `on ${String(signal)}` : String(code)}: ${Buffer.concat(stderr).toString().trim()}`));
+        });
+    });
+}
+/**
+ * The resumed process must not inherit the ended session's identity, or it
+ * reports itself as that thread to every hook it fires. `CODEX_HOME` is the one
+ * exception: it names the thread store the resume has to open.
+ */
+function coldResumeEnvironment(env) {
+    const next = { ...env };
+    for (const key of Object.keys(next)) {
+        if (key.startsWith('CODEX_') && key !== 'CODEX_HOME')
+            delete next[key];
+    }
+    return next;
+}
+export function systemCodexWakeAdapters(env = process.env) {
+    return {
+        probeThreadWriter: probeThreadWriterLock,
+        sourceAlive(pid) {
+            if (!Number.isInteger(pid) || pid <= 1)
+                return false;
+            try {
+                process.kill(pid, 0);
+                return true;
+            }
+            catch (err) {
+                // Signalling a process we may not touch still proves it exists.
+                return err.code === 'EPERM';
+            }
+        },
+        async resume(threadId, cwd, context) {
+            if (!existsSync(cwd))
+                throw new Error(`Codex thread cwd no longer exists: ${cwd}`);
+            await runCodex(['exec', 'resume', threadId, context], {
+                cwd,
+                env: coldResumeEnvironment(env),
+            });
+        },
+    };
+}
+//# sourceMappingURL=codex-wake.js.map

package/dist/codex-wake.js.map

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

package/dist/commands.d.ts

@@ -5,6 +5,8 @@ import { type Readiness } from './readiness.js';
 import type { Tone } from './ui/theme.js';
 import { type HookHarness } from './hooks.js';
 import { type Logger } from './logging.js';
+import { type ClaudeWakeAdapters } from './claude-wake.js';
+import { type CodexWakeAdapters } from './codex-wake.js';
 import { type SendFlags } from './send.js';
 import type { NativeSkills, SkillScope } from './native-skills.js';
 export interface CommandIo {
@@ -56,8 +58,12 @@ export interface CommandDeps {
     now?: () => number;
     /** Test seam for retry/backoff timing. */
     sleep?: (milliseconds: number) => Promise<void>;
-    /** Test seam for the OS idle probe; production shells out to the platform. */
-    idleSeconds?: () => number | null;
+    /** Test seams for Claude liveness, socket delivery, and cold resume. */
+    claudeWake?: ClaudeWakeAdapters;
+    claudeSourcePid?: number;
+    /** Test seams for the Codex thread-writer probe and cold resume. */
+    codexWake?: CodexWakeAdapters;
+    codexSourcePid?: number;
     /** Test seam and production adapter for the external native skills installer. */
     nativeSkills?: NativeSkills;
     /**
@@ -208,10 +214,9 @@ export declare function buildQuestions(flags: AskFlags, question: string | undef
     error: string;
 };
 /**
- * Registers a question for turn-end routing under the user's presence config.
- * Returns immediately so the agent can ask in prose and end its turn. Presence
- * does not block the shipped default; `require_idle = true` intentionally keeps
- * the question local while the user is active.
+ * Registers a question for turn-end routing. Returns immediately so the agent
+ * can ask in prose and end its turn; the terminal keeps the question to itself
+ * for `ask_grace_seconds` before it reaches any device.
  */
 export declare function askCommand(deps: CommandDeps, question: string | undefined, flags: AskFlags): number;
 /** Retire a question so a late answer is rejected rather than silently lost. */
@@ -284,11 +289,11 @@ export declare function parseSince(raw: string, now: number): number | null;
  */
 export declare function logsCommand(deps: CommandDeps, flags: LogsFlags): number;
 /**
- * Where `npx skills add` fetches the optional agent skill from. In skills CLI
- * 1.5.x, `owner/repo@name` selects a skill; a Git ref belongs after `#`.
- * Keep this immutable and public because the command is printed to users.
+ * Where `npx skills add` fetches the optional agent skill from, derived from
+ * this build's own version so the pin cannot drift from the release it names.
+ * Null when the build cannot establish its version; see `./release.js`.
  */
-export declare const SKILLS_SOURCE = "Raidiant-io/notifai#v0.4.0";
+export declare const SKILLS_SOURCE: string | null;
 /** Derive a contract-valid project slug from a directory name. */
 export declare function projectSlugFrom(name: string): string;
 export interface InitFlags {