@raidiant/notifai 11.7.1-beta.2 → 12.0.0-beta.11

package/dist/agent-update-notice.js

@@ -1,77 +0,0 @@
-import { lstatSync, readFileSync } from 'node:fs';
-import path from 'node:path';
-import { atomicWriteFileSync } from './atomic-file.js';
-import { stateDir } from './config.js';
-import { withFileLock } from './file-lock.js';
-import { newerPublishedCli, publishedCliDistTags, shouldConsultCliRegistry, thisCliVersion } from './cli-release.js';
-import { CLI_UPDATE_AVAILABLE } from './cli-contract.js';
-const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
-const NOTICE_INTERVAL_MS = 7 * CHECK_INTERVAL_MS;
-function readState(file) {
-    try {
-        const stat = lstatSync(file);
-        if (!stat.isFile() || stat.size > 1024)
-            throw new Error('invalid update notice state');
-        const value = JSON.parse(readFileSync(file, 'utf8'));
-        if (typeof value !== 'object' || value === null)
-            throw new Error('invalid update notice state');
-        const state = value;
-        for (const timestamp of [state.checked_at, state.notified_at]) {
-            if (timestamp !== undefined && (!Number.isSafeInteger(timestamp) || timestamp < 0)) {
-                throw new Error('invalid update notice timestamp');
-            }
-        }
-        return state;
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return {};
-        throw error;
-    }
-}
-function recent(timestamp, now, interval) {
-    // A clock rollback must not create another notice.
-    return timestamp !== undefined && now - timestamp < interval;
-}
-/** One optional notice per machine-local state directory, across roots and harnesses. */
-export async function agentUpdateNotice(options) {
-    if (!shouldConsultCliRegistry({ env: options.env }))
-        return undefined;
-    const file = path.join(stateDir(options.env), 'cli-update-notice.json');
-    const save = (state) => atomicWriteFileSync(file, `${JSON.stringify(state)}\n`);
-    try {
-        // Claim the lookup before doing network I/O. Another process neither waits
-        // for the registry nor emits a duplicate. Only short disk work holds a lock.
-        const claimed = withFileLock(`${file}.lock`, () => {
-            const state = readState(file);
-            if (recent(state.notified_at, options.now, NOTICE_INTERVAL_MS) ||
-                recent(state.checked_at, options.now, CHECK_INTERVAL_MS))
-                return false;
-            save({ ...state, checked_at: options.now });
-            return true;
-        }, { waitMs: 50 });
-        if (!claimed)
-            return undefined;
-        const tags = await publishedCliDistTags(options.fetchImpl, { useCache: false });
-        if (newerPublishedCli(thisCliVersion(), tags) === null)
-            return undefined;
-        const notify = withFileLock(`${file}.lock`, () => {
-            const state = readState(file);
-            if (recent(state.notified_at, options.now, NOTICE_INTERVAL_MS))
-                return false;
-            save({ ...state, notified_at: options.now });
-            return true;
-        }, { waitMs: 50 });
-        if (!notify)
-            return undefined;
-        return `${CLI_UPDATE_AVAILABLE} Run \`notifai update --check --json\`, read the release notes, and briefly offer to perform the update at a natural pause. ` +
-            `When authorized, use \`${options.updateCommand}\` and follow the new CLI guidance and session handoff. ` +
-            'Follow the User\'s instructions about updating; keep working if deferred. ' +
-            'Do not send a Notification Request just for this notice. It appears at most once every seven days on this machine.';
-    }
-    catch {
-        // Update discovery must never interrupt lifecycle guidance or routing.
-        return undefined;
-    }
-}
-//# sourceMappingURL=agent-update-notice.js.map

package/dist/agent-update-notice.js.map

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

package/dist/atomic-file.d.ts

@@ -1,30 +0,0 @@
-export interface AtomicWriteOptions {
-    /** Mode for a newly created file. Existing regular files keep their mode. */
-    mode?: number;
-    /** False when a managed executable must keep the requested mode on repair. */
-    preserveMode?: boolean;
-    /** Reject a target owned by another user instead of replacing it. */
-    requireCurrentUserOwner?: boolean;
-    /**
-     * POSIX directory mode applied to the parent. Defaults to 0o700 when
-     * `requireCurrentUserOwner` is set so credential and config dirs match the
-     * hook-adapter and log directories.
-     */
-    directoryMode?: number;
-}
-/**
- * Replace one regular file without exposing a truncated intermediate state.
- *
- * The temporary file is a unique sibling, so rename is atomic on every
- * supported filesystem. The contents are flushed before the rename, and a
- * symlink target is refused instead of silently writing through it.
- */
-export declare function atomicWriteFileSync(file: string, contents: string | Uint8Array, options?: AtomicWriteOptions): void;
-/**
- * Create (or tighten) a directory that must not be world-readable.
- *
- * `mkdir` mode applies only to a newly created leaf, so an existing 0755
- * credential directory would otherwise stay world-listable. POSIX chmod of
- * the leaf is the matching repair; Windows has no equivalent mode bits.
- */
-export declare function ensurePrivateDirectory(directory: string): void;

package/dist/atomic-file.js

@@ -1,148 +0,0 @@
-import { randomBytes } from 'node:crypto';
-import { chmodSync, closeSync, fsyncSync, lstatSync, mkdirSync, openSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
-import path from 'node:path';
-/**
- * Replace one regular file without exposing a truncated intermediate state.
- *
- * The temporary file is a unique sibling, so rename is atomic on every
- * supported filesystem. The contents are flushed before the rename, and a
- * symlink target is refused instead of silently writing through it.
- */
-export function atomicWriteFileSync(file, contents, options = {}) {
-    const directory = path.dirname(file);
-    const requireCurrentUserOwner = options.requireCurrentUserOwner ?? false;
-    const directoryMode = options.directoryMode ?? (requireCurrentUserOwner ? 0o700 : undefined);
-    const parent = ensureDirectory(directory, {
-        requireCurrentUserOwner,
-        ...(directoryMode === undefined ? {} : { mode: directoryMode }),
-    });
-    const target = targetMetadata(file, options.mode ?? 0o600, options.preserveMode ?? true, options.requireCurrentUserOwner ?? false);
-    const temp = path.join(directory, `.${path.basename(file)}.notifai-${process.pid}-${randomBytes(6).toString('hex')}.tmp`);
-    let handle;
-    try {
-        handle = openSync(temp, 'wx', target.mode);
-        writeFileSync(handle, contents);
-        fsyncSync(handle);
-        closeSync(handle);
-        handle = undefined;
-        // Creation may already have the exact mode. Avoid a redundant operation
-        // that a sandbox can forbid while still allowing the private write.
-        if ((lstatSync(temp).mode & 0o7777) !== target.mode)
-            chmodSync(temp, target.mode);
-        assertSameDirectory(directory, parent);
-        assertUnchangedTarget(file, target);
-        renameSync(temp, file);
-        syncDirectory(directory);
-    }
-    catch (err) {
-        if (handle !== undefined)
-            closeSync(handle);
-        try {
-            unlinkSync(temp);
-        }
-        catch {
-            // Preserve the original error; the temp may not have been created.
-        }
-        throw err;
-    }
-}
-/**
- * Create (or tighten) a directory that must not be world-readable.
- *
- * `mkdir` mode applies only to a newly created leaf, so an existing 0755
- * credential directory would otherwise stay world-listable. POSIX chmod of
- * the leaf is the matching repair; Windows has no equivalent mode bits.
- */
-export function ensurePrivateDirectory(directory) {
-    ensureDirectory(directory, { mode: 0o700, requireCurrentUserOwner: false });
-}
-function ensureDirectory(directory, options) {
-    if (options.mode === undefined)
-        mkdirSync(directory, { recursive: true });
-    else
-        mkdirSync(directory, { recursive: true, mode: options.mode });
-    const parent = safeDirectory(directory, options.requireCurrentUserOwner);
-    if (options.mode !== undefined &&
-        process.platform !== 'win32' &&
-        parent.mode !== options.mode) {
-        chmodSync(directory, options.mode);
-    }
-    return parent;
-}
-/** Persist the published directory entry where the host supports directory fsync. */
-function syncDirectory(directory) {
-    if (process.platform === 'win32')
-        return;
-    const handle = openSync(directory, 'r');
-    try {
-        fsyncSync(handle);
-    }
-    finally {
-        closeSync(handle);
-    }
-}
-function targetMetadata(file, fallback, preserveMode, requireCurrentUserOwner) {
-    let stat;
-    try {
-        stat = lstatSync(file);
-    }
-    catch (err) {
-        if (err.code === 'ENOENT') {
-            return { mode: fallback, identity: null };
-        }
-        throw err;
-    }
-    if (stat.isSymbolicLink()) {
-        throw new Error(`${file} is a symlink; refusing to write through it. Replace it with a regular file, ` +
-            'or use a different state directory.');
-    }
-    if (!stat.isFile())
-        throw new Error(`${file} is not a regular file; refusing to replace it.`);
-    if (requireCurrentUserOwner)
-        assertCurrentUserOwns(file, stat.uid);
-    return {
-        mode: preserveMode ? stat.mode & 0o777 : fallback,
-        identity: { dev: stat.dev, ino: stat.ino },
-    };
-}
-function assertUnchangedTarget(file, target) {
-    let current;
-    try {
-        current = lstatSync(file);
-    }
-    catch (err) {
-        if (err.code === 'ENOENT' && target.identity === null)
-            return;
-        throw new Error(`${file} changed during the atomic write; refusing to replace it.`);
-    }
-    if (target.identity === null ||
-        current.dev !== target.identity.dev ||
-        current.ino !== target.identity.ino) {
-        throw new Error(`${file} changed during the atomic write; refusing to replace it.`);
-    }
-}
-function safeDirectory(directory, requireCurrentUserOwner) {
-    const stat = lstatSync(directory);
-    if (stat.isSymbolicLink() || !stat.isDirectory()) {
-        throw new Error(`${directory} is not a regular directory; refusing to write inside it.`);
-    }
-    if (requireCurrentUserOwner)
-        assertCurrentUserOwns(directory, stat.uid);
-    return { dev: stat.dev, ino: stat.ino, mode: stat.mode & 0o7777 };
-}
-function assertSameDirectory(directory, expected) {
-    const current = lstatSync(directory);
-    if (current.isSymbolicLink() ||
-        !current.isDirectory() ||
-        current.dev !== expected.dev ||
-        current.ino !== expected.ino) {
-        throw new Error(`${directory} changed during the write; refusing to publish the file.`);
-    }
-}
-function assertCurrentUserOwns(file, owner) {
-    const uid = typeof process.getuid === 'function' ? process.getuid() : undefined;
-    if (uid !== undefined && owner !== uid) {
-        throw new Error(`${file} is owned by uid ${owner}, not the current user; refusing to replace it.`);
-    }
-}
-//# sourceMappingURL=atomic-file.js.map

package/dist/atomic-file.js.map

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

package/dist/attendant-update.d.ts

@@ -1,15 +0,0 @@
-import { type CommandDeps } from './commands-core.js';
-/** Existing durable ownership is required; this path cannot create a session. */
-export declare function recoveryOwner(deps: CommandDeps, sessionId: string, key: string): {
-    owner: import("./hook-session-state.js").SessionIncarnation;
-    cwd: string;
-} | null;
-/** Internal child entrypoint. It observes native data; it does not impersonate a hook. */
-export declare function resumeAttendantCommand(deps: CommandDeps, sessionId: string, key: string): Promise<number>;
-export interface AttendantActivation {
-    session_id: string;
-    state: 'current' | 'activated' | 'pending';
-    native_activity: boolean;
-}
-/** Called only by the authorized updater, after effective installation checks. */
-export declare function activateInstalledAttendants(deps: CommandDeps, artifact: string): Promise<AttendantActivation[]>;

package/dist/attendant-update.js

@@ -1,96 +0,0 @@
-/** Explicit recovery of already-owned resident writers after an installation. */
-import { spawn } from 'node:child_process';
-import { readFileSync } from 'node:fs';
-import { EXIT, log } from './commands-core.js';
-import { attendHook, attendantGates, attendantRuntimeRevision } from './commands-hook-attend.js';
-import { findNativeTranscript, nativeTranscriptOwned } from './codex-native-turn.js';
-import { lifecycleStamp, readSessionIncarnation, readSessionState, sessionHasEnded } from './hook-session-state.js';
-import { readClaimFile } from './hook-question-lock.js';
-import { processExecutableName, processIdentityLiveness } from './process-identity.js';
-import { attendantClaimPath, attendantStatusPath, codexNativeActivityObserved, listAttendantReports } from './session-attendant-state.js';
-import { packageVersion } from './release.js';
-import { codexTrustProblems, findInstallations } from './install-hooks.js';
-/** Existing durable ownership is required; this path cannot create a session. */
-export function recoveryOwner(deps, sessionId, key) {
-    const state = readSessionState(sessionId, deps.env);
-    const owner = readSessionIncarnation(sessionId, deps.env);
-    if (state.harness !== 'codex' || typeof state.activation_cwd !== 'string' ||
-        owner?.key !== key || owner.harness_process === undefined || sessionHasEnded(sessionId, deps.env) ||
-        processIdentityLiveness(owner.harness_process) !== 'alive' ||
-        processExecutableName(owner.harness_process.pid) !== 'codex')
-        return null;
-    return { owner, cwd: state.activation_cwd };
-}
-/** Internal child entrypoint. It observes native data; it does not impersonate a hook. */
-export async function resumeAttendantCommand(deps, sessionId, key) {
-    const owned = recoveryOwner(deps, sessionId, key);
-    if (owned === null)
-        return EXIT.failed;
-    const transcript = readSessionState(sessionId, deps.env).codex_native_turn?.transcript_path ?? findNativeTranscript(sessionId, deps.env);
-    if (transcript === null || !nativeTranscriptOwned(transcript, sessionId, deps.env))
-        return EXIT.failed;
-    const installations = findInstallations(deps.env, deps.hookAdapterHome, deps.hookPlatform).filter(entry => entry.harness === 'codex');
-    if (installations.length === 0 || codexTrustProblems(installations, deps.env).length > 0)
-        return EXIT.failed;
-    const logger = log(deps);
-    logger.bind({ session: sessionId });
-    logger.info('attendant.state', { source: 'update-resume', phase: 'recovering' });
-    return attendHook(deps, {
-        envelope: { session_id: sessionId, cwd: owned.cwd }, harness: 'codex', cwd: owned.cwd,
-        invokedAt: lifecycleStamp(), logger,
-        recovery: { key, harnessProcess: owned.owner.harness_process, transcriptPath: transcript },
-    });
-}
-/** Called only by the authorized updater, after effective installation checks. */
-export async function activateInstalledAttendants(deps, artifact) {
-    const reports = listAttendantReports(deps.env).filter(report => report.alive && readSessionState(report.session_id, deps.env).harness === 'codex');
-    // Each current owner is independent. Bound subprocess fanout and wall time.
-    return Promise.all(reports.map(async (report, index) => {
-        const sessionId = report.session_id;
-        const result = (state) => ({
-            session_id: sessionId, state, native_activity: codexNativeActivityObserved(sessionId, deps.env),
-        });
-        const current = readSessionIncarnation(sessionId, deps.env);
-        if (current === null || index >= 16)
-            return result('pending');
-        const owned = recoveryOwner(deps, sessionId, current.key);
-        if (owned === null || !attendantGates(deps, owned.cwd, sessionId, 'codex', packageVersion()).ok)
-            return result('pending');
-        const claimFile = attendantClaimPath(sessionId, deps.env);
-        const holder = readClaimFile(claimFile);
-        if (holder?.['runtime_revision'] === attendantRuntimeRevision && holder['runtime_version'] === packageVersion())
-            return result('current');
-        const transcript = readSessionState(sessionId, deps.env).codex_native_turn?.transcript_path ?? findNativeTranscript(sessionId, deps.env);
-        if (transcript === null || !nativeTranscriptOwned(transcript, sessionId, deps.env))
-            return result('pending');
-        let child;
-        try {
-            child = spawn(process.execPath, [artifact, 'attendant-resume', sessionId, current.key], {
-                cwd: owned.cwd, env: deps.env, detached: true, stdio: 'ignore', windowsHide: true,
-            });
-        }
-        catch {
-            return result('pending');
-        }
-        let failed = false;
-        child.on('error', () => { failed = true; });
-        child.unref();
-        const until = performance.now() + 8_000;
-        while (!failed && performance.now() < until) {
-            const claim = readClaimFile(claimFile);
-            let active = {};
-            try {
-                active = JSON.parse(readFileSync(attendantStatusPath(sessionId, deps.env), 'utf8'));
-            }
-            catch { /* not started */ }
-            if (claim?.['runtime_revision'] === attendantRuntimeRevision && active.pid === claim['pid'] &&
-                ['dormant', 'attending'].includes(active.phase ?? ''))
-                return result('activated');
-            if (recoveryOwner(deps, sessionId, current.key) === null)
-                break;
-            await new Promise(resolve => setTimeout(resolve, 100));
-        }
-        return result('pending');
-    }));
-}
-//# sourceMappingURL=attendant-update.js.map

package/dist/attendant-update.js.map

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

package/dist/claude-wake.d.ts

@@ -1,108 +0,0 @@
-import type { EscalationDeliveryRoute } from './hook-types.js';
-import { type WriteGuard } from './wake-support.js';
-/** Claude Code's currently observed inbox protocol. Unknown versions fail closed. */
-export declare const CLAUDE_PEER_PROTOCOL = 1;
-/** The first Claude Code release that publishes a session inbox socket. */
-export declare const CLAUDE_MIN_INBOX_VERSION = "2.1.224";
-/** macOS verifies own-child ancestry only while the posting process is alive. */
-export declare const CLAUDE_POST_SEND_LIVENESS_MS = 8000;
-export interface ClaudeSessionDescriptor {
-    pid: number;
-    sessionId: string;
-    cwd: string;
-    startedAt: number;
-    procStart: string;
-    version: string;
-    peerProtocol: number;
-    messagingSocketPath: string;
-    status: string;
-}
-export interface ClaudeAgentObservation {
-    pid: number;
-    sessionId: string;
-    startedAt: number;
-    status: string;
-}
-export interface ClaudeWakeAdapters {
-    listAgents(): Promise<unknown>;
-    readDescriptor(pid: number): unknown;
-    /** With `guard`, a connection that is late or no longer writable writes nothing. */
-    sendSocket(socketPath: string, line: string, guard?: WriteGuard): Promise<void>;
-    /** `onSpawn` receives the resumed harness's own process group as soon as it exists. */
-    resume(sessionId: string, cwd: string, context: string, onSpawn?: (pgid: number) => void): Promise<void>;
-    sleep(milliseconds: number): Promise<void>;
-}
-export type ClaudeWakeObservation = {
-    state: 'live-idle' | 'live-busy';
-    descriptor: ClaudeSessionDescriptor;
-} | {
-    state: 'stopped';
-} | {
-    state: 'unknown';
-    reason: string;
-};
-/** A Claude Code session descriptor, or null when it has an unknown shape. */
-export declare function parseDescriptor(value: unknown): ClaudeSessionDescriptor | null;
-/**
- * Observe one exact Claude Code session without guessing.
- *
- * `claude agents --json` is the liveness oracle: Claude Code itself validates
- * each registry row against both PID and process start time before returning it.
- * The descriptor supplies the socket and peer protocol, but is never trusted as
- * proof that a process still owns the session.
- */
-export declare function observeClaudeSession(sessionId: string, adapters: Pick<ClaudeWakeAdapters, 'listAgents' | 'readDescriptor'>): Promise<ClaudeWakeObservation>;
-export type ClaudeInboxReadiness = {
-    state: 'ready';
-    socketPath: string;
-    version: string;
-} | {
-    state: 'unavailable';
-    reason: string;
-};
-/**
- * Whether an answer could reach this exact Claude session over its inbox
- * socket, decided from evidence already on disk.
- *
- * Read-only by construction: it reads the session descriptor and asks whether
- * the socket file exists, and never connects to it. A diagnostic that delivers
- * a message is not a diagnostic.
- *
- * Every negative answer here is a degradation, not a failure — the accepted
- * journal still replays the answer at the session's next turn. What it buys is
- * that the reason is nameable in advance instead of being discovered as
- * silence. The common one is `--bare`, which binds no socket at all (and runs
- * no hooks either, so nothing would have registered a question in the first
- * place).
- */
-export declare function inspectClaudeInbox(options: {
-    pid: number;
-    platform: NodeJS.Platform;
-    readDescriptor: (pid: number) => unknown;
-    socketExists: (socketPath: string) => boolean;
-}): ClaudeInboxReadiness;
-/**
- * Claude's own-child delivery route.
- *
- * A successful socket write proves delivery to Claude Code, not model
- * consumption — and this route reports exactly that, no more. It reports
- * `delivered` all the same, because the write is the strongest acknowledgement
- * this route can ever obtain: the message it posts starts a brand-new turn
- * rather than continuing this one, so no later hook will confirm anything about
- * it. An answer delivered once and settled is strictly better than an answer
- * redelivered on every turn-end for ever.
- *
- * Every path that hands nothing over reports `held`, so the accepted journal
- * replays it. Unknown state deliberately returns without throwing, so the
- * journal becomes `hold-for-next-turn` instead of failing the hook. The
- * in-place write is the hand-off shared with Session Messages
- * (`session-handoff.ts`); only the cold resume of a stopped session belongs to
- * this answer route.
- */
-export declare function claudeWakeRoute(options: {
-    sessionId: string;
-    cwd: string;
-    sourcePid: number;
-    adapters?: ClaudeWakeAdapters;
-}): EscalationDeliveryRoute;
-export declare function systemClaudeWakeAdapters(env?: NodeJS.ProcessEnv): ClaudeWakeAdapters;