@raidiant/notifai 10.1.7 → 11.0.2

package/dist/hook-question-retirement.js

@@ -0,0 +1,261 @@
+import { REPLY_MAX_WINDOW_SECONDS } from '@raidiant/notifai-protocol';
+import { existsSync, 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 { isSamePending, rememberQuestionState, sourceContextAtHookEvent, } from './hook-question-state.js';
+import { pendingList, readSessionState, updateSessionState } from './hook-session-state.js';
+/**
+ * A retirement is only worth syncing while the question it retires could still
+ * be answered, so this has to outlive the longest reply window a user can
+ * choose — it is derived from that bound rather than from a guess about how
+ * long questions stay open, which is exactly the assumption that broke when
+ * the window stopped being one hour. Past it the companion shows the question
+ * as dead on next open anyway. Also the backstop that keeps an unreachable
+ * server from growing the queue for ever.
+ */
+const ORPHAN_TTL_MS = (REPLY_MAX_WINDOW_SECONDS + 3600) * 1000;
+/** More orphans than this means something is looping; keep the newest. */
+const ORPHAN_QUEUE_CAP = 50;
+/**
+ * Close is a server-side serialization fence: a successful response contains
+ * every reply that committed before the window closed. `null` is deliberately
+ * different from an empty reply set — it means ownership could not be proven
+ * final and the local record must stay recoverable.
+ */
+export async function finalizeReplies(ctx, requestId) {
+    try {
+        return await ctx.client.closeReplies(requestId);
+    }
+    catch {
+        return null;
+    }
+}
+/** Best effort only for already-journaled retirement debt. */
+export async function closeQuietly(ctx, requestId) {
+    await finalizeReplies(ctx, requestId);
+}
+/**
+ * Close the reply window so the server can mint the retirement push. Client
+ * submissions cannot carry `question_retired`; that event is reserved for
+ * server-origin state syncs.
+ */
+async function proveRetirement(ctx, requestId) {
+    const response = await finalizeReplies(ctx, requestId);
+    const proven = response !== null;
+    ctx.log?.info('hook.retirement', {
+        request_id: requestId,
+        attempted: true,
+        proven,
+    });
+    return proven;
+}
+/**
+ * Park a delivered question for retirement. Called at the moment we learn it is
+ * dead, which is frequently not a moment we can reach the network.
+ *
+ * Nothing is parked for a question that never reached a device: with no
+ * request_id there is nothing on any device to retire.
+ */
+export function parkForRetirement(sessionId, env, pending, state) {
+    const retirement = retiringQuestion(pending, state);
+    if (retirement === null)
+        return;
+    updateSessionState(sessionId, env, (current) => {
+        const already = current.retiring ?? [];
+        const existing = already.findIndex((entry) => entry.request_id === retirement.request_id);
+        if (existing < 0) {
+            return rememberQuestionState({ ...current, retiring: [...already, retirement] }, pending, state === 'answered' ? 'answered' : 'retired');
+        }
+        const retiring = [...already];
+        // An observed answer is final truth and upgrades an earlier supersession
+        // parked while the submission callback was racing a newer question.
+        if (retirement.state === 'answered' && retiring[existing].state !== 'answered') {
+            retiring[existing] = retirement;
+        }
+        return rememberQuestionState({ ...current, retiring }, pending, state === 'answered' ? 'answered' : 'retired');
+    });
+}
+/**
+ * Convert live question state into a complete retirement instruction.
+ *
+ * A request/collapse pair without the original Delivery targets is not safe to
+ * send: re-resolving today's routing can miss a device that still shows the
+ * question or retire a device that never received it. Fail explicitly and keep
+ * the pending record instead of silently broadening or narrowing the fanout.
+ */
+export function retiringQuestion(pending, state, cwd) {
+    // A submit journal is written before the first network byte. SessionEnd can
+    // therefore race a request that the server accepts after local cleanup. Its
+    // reserved request id and exact fanout are already sufficient retirement
+    // identity, even though the ordinary live fields have not been promoted yet.
+    const requestId = pending.request_id ?? pending.submission?.request_id;
+    const collapseKey = pending.collapse_key ?? pending.submission?.collapse_key;
+    const deviceIds = pending.device_ids ?? pending.submission?.device_ids;
+    const hasRequest = requestId !== undefined;
+    const hasCollapse = collapseKey !== undefined;
+    const hasDevices = deviceIds !== undefined && deviceIds.length > 0;
+    if (!hasRequest && !hasCollapse && !hasDevices)
+        return null;
+    if (!hasRequest || !hasCollapse || !hasDevices) {
+        throw new Error('live question state is incomplete; refusing to retire it without request, collapse, and device identifiers');
+    }
+    const source = sourceContextAtHookEvent(pending.source, cwd);
+    return {
+        ...(pending.question_id !== undefined ? { question_id: pending.question_id } : {}),
+        request_id: requestId,
+        collapse_key: collapseKey,
+        device_ids: [...deviceIds],
+        question: pending.question,
+        ...(pending.project !== undefined ? { project: pending.project } : {}),
+        ...(source !== undefined ? { source } : {}),
+        state,
+    };
+}
+const SHORT_CONFIRMATIONS = new Set(['done', 'yes', 'y', 'no', 'n', 'ok', 'okay']);
+function normalizePrompt(value) {
+    return value.trim().replace(/\s+/g, ' ').toLowerCase();
+}
+function pendingChoiceLabels(pending) {
+    const fromQuestions = (pending.questions ?? []).flatMap((question) => (question.choices ?? []).flatMap((choice) => [choice.label, choice.id]));
+    return fromQuestions.map(normalizePrompt).filter((label) => label.length > 0);
+}
+function pendingHasMatchingChoice(pending, normalizedPrompt) {
+    return pendingChoiceLabels(pending).includes(normalizedPrompt);
+}
+/**
+ * Which outstanding questions this prompt plausibly answers.
+ *
+ * A unique closed-choice match is enough. A short confirmation such as "done"
+ * matches only when exactly one question is outstanding. Long unrelated
+ * prompts leave every question open for the reply window.
+ */
+export function pendingAnsweredByPrompt(prompt, pending) {
+    const normalized = normalizePrompt(prompt ?? '');
+    if (normalized.length === 0 || pending.length === 0)
+        return [];
+    const labelled = pending.filter((entry) => pendingHasMatchingChoice(entry, normalized));
+    if (labelled.length === 1)
+        return labelled;
+    if (labelled.length > 1)
+        return [];
+    if (pending.length === 1 && SHORT_CONFIRMATIONS.has(normalized))
+        return [...pending];
+    return [];
+}
+/**
+ * Send every parked retirement, and forget the ones that landed. A failure
+ * leaves the entry in place for the next hook rather than losing it, which is
+ * the whole reason the queue exists.
+ */
+export async function drainRetirements(ctx, sessionId, env) {
+    const queue = readSessionState(sessionId, env).retiring ?? [];
+    if (queue.length === 0)
+        return [];
+    const retired = [];
+    for (const entry of queue) {
+        const proven = await proveRetirement(ctx, entry.request_id);
+        if (proven) {
+            retired.push(entry.request_id);
+            // Persist each success before touching the next entry. A later corrupt
+            // record or interrupted process must not resurrect work already done.
+            updateSessionState(sessionId, env, (current) => ({
+                ...current,
+                retiring: (current.retiring ?? []).filter((candidate) => candidate.request_id !== entry.request_id),
+            }));
+        }
+    }
+    return retired;
+}
+function orphanQueuePath(env) {
+    return path.join(stateDir(env), 'retire-queue.json');
+}
+function readOrphanQueue(env) {
+    const file = orphanQueuePath(env);
+    if (!existsSync(file))
+        return [];
+    try {
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        // Same stance as session state: corruption fails closed to "nothing queued".
+        return [];
+    }
+}
+function writeOrphanQueueUnlocked(file, queue) {
+    atomicWriteFileSync(file, `${JSON.stringify(queue, null, 2)}\n`);
+}
+function updateOrphanQueue(env, update) {
+    const file = orphanQueuePath(env);
+    return withFileLock(`${file}.lock`, () => {
+        const next = update(readOrphanQueue(env));
+        writeOrphanQueueUnlocked(file, next);
+        return next;
+    });
+}
+/** Move retirements into the global queue; deduped so a retry costs nothing. */
+export function orphanRetirements(env, entries, now) {
+    if (entries.length === 0)
+        return;
+    updateOrphanQueue(env, (queue) => {
+        const known = new Set(queue.map((entry) => entry.request_id));
+        const added = entries
+            .filter((entry) => !known.has(entry.request_id))
+            .map((entry) => ({ ...entry, enqueued_at: now }));
+        return [...queue, ...added].slice(-ORPHAN_QUEUE_CAP);
+    });
+}
+/**
+ * Retire everything a dead session left behind. Failures stay queued for the
+ * next holder of a client; entries past the TTL are dropped as already dead.
+ */
+export async function drainOrphanRetirements(ctx, env, now) {
+    const queue = readOrphanQueue(env);
+    if (queue.length === 0)
+        return [];
+    const done = [];
+    for (const entry of queue) {
+        const age = now - entry.enqueued_at;
+        // A negative age is a clock jump, not a fresh entry; retiring is idempotent
+        // and cheap, so treat it as due rather than letting it linger for ever.
+        if (age > ORPHAN_TTL_MS) {
+            done.push(entry.request_id);
+            updateOrphanQueue(env, (current) => current.filter((candidate) => candidate.request_id !== entry.request_id));
+            continue;
+        }
+        const proven = await proveRetirement(ctx, entry.request_id);
+        if (proven) {
+            done.push(entry.request_id);
+            updateOrphanQueue(env, (current) => current.filter((candidate) => candidate.request_id !== entry.request_id));
+        }
+    }
+    return done;
+}
+export async function retirePendings(ctx, envelope, sessionId, entries, state) {
+    updateSessionState(sessionId, ctx.env, (current) => {
+        const retiring = [...(current.retiring ?? [])];
+        for (const entry of entries) {
+            const retirement = retiringQuestion(entry, state, envelope.cwd);
+            if (retirement !== null && !retiring.some((item) => item.request_id === retirement.request_id)) {
+                retiring.push(retirement);
+            }
+        }
+        const pending = pendingList(current).filter((candidate) => !entries.some((entry) => isSamePending(candidate, entry)));
+        const next = { ...current };
+        if (pending.length > 0)
+            next.pending = pending;
+        else
+            delete next.pending;
+        if (retiring.length > 0)
+            next.retiring = retiring;
+        else
+            delete next.retiring;
+        return entries.reduce((remembered, entry) => rememberQuestionState(remembered, entry, state === 'answered' ? 'answered' : 'retired'), next);
+    });
+    // Network retirement is deliberately deferred to a later no-question hook.
+    // The state write above is the durable operation; blocking here creates a
+    // crash window before an answer can reach harness stdout.
+}
+//# sourceMappingURL=hook-question-retirement.js.map

package/dist/hook-question-retirement.js.map

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

package/dist/hook-question-state.d.ts

@@ -0,0 +1,45 @@
+/** Question history, inspection, and atomic live-question state changes. */
+import type { QuestionT, SourceContextT } from '@raidiant/notifai-protocol';
+import type { PendingQuestion, QuestionDeliveryState, QuestionTerminalState, SessionState } from './hook-types.js';
+export interface QuestionStateView {
+    question_id: string;
+    state: QuestionDeliveryState;
+    /** Null means a frozen submission may or may not have crossed the service boundary. */
+    submitted: boolean | null;
+    request_id: string | null;
+    frozen_request_id: string | null;
+}
+export type QuestionStateLookup = {
+    found: true;
+    session_id: string;
+    question: QuestionStateView;
+} | {
+    found: false;
+    ambiguous: boolean;
+};
+/** Keep immutable session grouping while replacing per-event Git location authoritatively. */
+export declare function sourceContextAtHookEvent(source: SourceContextT | undefined, cwd: string | undefined): SourceContextT | undefined;
+export declare function summarizeRequestIds(entries: readonly PendingQuestion[]): {
+    ids: string[];
+    display: string;
+};
+type QuestionIdentity = Pick<PendingQuestion, 'question_id' | 'request_id' | 'submission'>;
+/** Keep a bounded, content-free map from local identity to its terminal state. */
+export declare function rememberQuestionState(current: SessionState, question: QuestionIdentity, state: QuestionTerminalState): SessionState;
+/** Read one stable local question identity without minting or submitting anything. */
+export declare function inspectQuestionState(questionId: string, env: NodeJS.ProcessEnv): QuestionStateLookup;
+/** Registration identity — the convention every racing writer compares by. */
+export declare function isSamePending(a: PendingQuestion, b: PendingQuestion): boolean;
+export declare function dropPendingQuestion(sessionId: string, env: NodeJS.ProcessEnv, entry: PendingQuestion, terminalState?: QuestionTerminalState): void;
+/**
+ * Drop registrations that never reached a device, so a later Stop cannot push
+ * them. A retirement push would be noise: there is nothing on any device to
+ * withdraw. Returns the withdrawn entries in registration order.
+ */
+export declare function withdrawUnpushedQuestions(sessionId: string, env: NodeJS.ProcessEnv): PendingQuestion[];
+export declare function clearFrozenSubmission(sessionId: string, env: NodeJS.ProcessEnv, entry: PendingQuestion): void;
+/** The question set this pending record pushes, however it was registered. */
+export declare function pendingQuestions(pending: PendingQuestion): QuestionT[];
+/** Did any question in the set offer choices? Decides how replies combine. */
+export declare function pendingHasChoices(pending: PendingQuestion): boolean;
+export {};

package/dist/hook-question-state.js

@@ -0,0 +1,196 @@
+import { findOwningSession, pendingList, readSessionState, updateSessionState, } from './hook-session-state.js';
+import { inferInvocationContext } from './invocation-context.js';
+/** Keep immutable session grouping while replacing per-event Git location authoritatively. */
+export function sourceContextAtHookEvent(source, cwd) {
+    const invocation = cwd === undefined ? null : inferInvocationContext(cwd);
+    const current = {
+        ...(source?.session_id !== undefined ? { session_id: source.session_id } : {}),
+        ...(source?.session_label !== undefined ? { session_label: source.session_label } : {}),
+        ...(source?.harness !== undefined ? { harness: source.harness } : {}),
+        ...(invocation?.branch !== undefined ? { branch: invocation.branch } : {}),
+        ...(invocation?.worktree !== undefined ? { worktree: invocation.worktree } : {}),
+    };
+    return Object.keys(current).length === 0 ? undefined : current;
+}
+export function summarizeRequestIds(entries) {
+    const ids = entries.flatMap((entry) => entry.request_id === undefined ? [] : [entry.request_id]);
+    return { ids, display: ids.join(', ') };
+}
+const QUESTION_HISTORY_CAP = 50;
+/** Keep a bounded, content-free map from local identity to its terminal state. */
+export function rememberQuestionState(current, question, state) {
+    if (question.question_id === undefined)
+        return current;
+    const existing = (current.question_history ?? []).find((entry) => entry.question_id === question.question_id);
+    const terminalState = existing?.state === 'withdrawn' || existing?.state === 'answered'
+        ? existing.state
+        : state === 'answered'
+            ? 'answered'
+            : state;
+    const requestId = question.request_id ?? existing?.request_id;
+    const frozenRequestId = requestId === undefined
+        ? question.submission?.request_id ?? existing?.frozen_request_id
+        : undefined;
+    const record = {
+        question_id: question.question_id,
+        state: terminalState,
+        ...(requestId === undefined ? {} : { request_id: requestId }),
+        ...(frozenRequestId === undefined ? {} : { frozen_request_id: frozenRequestId }),
+    };
+    const history = [
+        ...(current.question_history ?? []).filter((entry) => entry.question_id !== question.question_id),
+        record,
+    ].slice(-QUESTION_HISTORY_CAP);
+    return { ...current, question_history: history };
+}
+function pendingQuestionView(entry) {
+    if (entry.question_id === undefined)
+        return null;
+    if (entry.request_id !== undefined) {
+        return {
+            question_id: entry.question_id,
+            state: 'live',
+            submitted: true,
+            request_id: entry.request_id,
+            frozen_request_id: null,
+        };
+    }
+    if (entry.submission !== undefined) {
+        return {
+            question_id: entry.question_id,
+            state: 'frozen',
+            submitted: null,
+            request_id: null,
+            frozen_request_id: entry.submission.request_id,
+        };
+    }
+    return {
+        question_id: entry.question_id,
+        state: 'local',
+        submitted: false,
+        request_id: null,
+        frozen_request_id: null,
+    };
+}
+/** Read one stable local question identity without minting or submitting anything. */
+export function inspectQuestionState(questionId, env) {
+    const owner = findOwningSession(questionId, env);
+    if (owner.ambiguous || owner.sessionId === null) {
+        return { found: false, ambiguous: owner.ambiguous };
+    }
+    const state = readSessionState(owner.sessionId, env);
+    const pending = pendingList(state).find((entry) => entry.question_id === questionId);
+    const pendingView = pending === undefined ? null : pendingQuestionView(pending);
+    if (pendingView !== null) {
+        return { found: true, session_id: owner.sessionId, question: pendingView };
+    }
+    const accepted = state.accepted?.answers.find(({ pending: entry }) => entry.question_id === questionId)?.pending;
+    if (accepted?.question_id !== undefined) {
+        return {
+            found: true,
+            session_id: owner.sessionId,
+            question: {
+                question_id: accepted.question_id,
+                state: 'answered',
+                submitted: true,
+                request_id: accepted.request_id ?? null,
+                frozen_request_id: null,
+            },
+        };
+    }
+    const retiring = (state.retiring ?? []).find((entry) => entry.question_id === questionId);
+    if (retiring?.question_id !== undefined) {
+        return {
+            found: true,
+            session_id: owner.sessionId,
+            question: {
+                question_id: retiring.question_id,
+                state: retiring.state === 'answered' ? 'answered' : 'retired',
+                submitted: true,
+                request_id: retiring.request_id,
+                frozen_request_id: null,
+            },
+        };
+    }
+    const history = (state.question_history ?? []).find((entry) => entry.question_id === questionId);
+    if (history !== undefined) {
+        return {
+            found: true,
+            session_id: owner.sessionId,
+            question: {
+                question_id: history.question_id,
+                state: history.state,
+                submitted: history.request_id !== undefined
+                    ? true
+                    : history.frozen_request_id !== undefined
+                        ? null
+                        : false,
+                request_id: history.request_id ?? null,
+                frozen_request_id: history.frozen_request_id ?? null,
+            },
+        };
+    }
+    return { found: false, ambiguous: false };
+}
+/** Registration identity — the convention every racing writer compares by. */
+export function isSamePending(a, b) {
+    if (a.question_id !== undefined || b.question_id !== undefined) {
+        return a.question_id !== undefined && a.question_id === b.question_id;
+    }
+    return a.question === b.question && a.asked_at === b.asked_at;
+}
+export function dropPendingQuestion(sessionId, env, entry, terminalState = 'retired') {
+    updateSessionState(sessionId, env, (current) => {
+        const pending = pendingList(current).filter((candidate) => !isSamePending(candidate, entry));
+        const next = { ...current };
+        if (pending.length > 0)
+            next.pending = pending;
+        else
+            delete next.pending;
+        return rememberQuestionState(next, entry, terminalState);
+    });
+}
+/**
+ * Drop registrations that never reached a device, so a later Stop cannot push
+ * them. A retirement push would be noise: there is nothing on any device to
+ * withdraw. Returns the withdrawn entries in registration order.
+ */
+export function withdrawUnpushedQuestions(sessionId, env) {
+    let withdrawn = [];
+    updateSessionState(sessionId, env, (current) => {
+        const pending = pendingList(current);
+        withdrawn = pending.filter((entry) => entry.request_id === undefined);
+        if (withdrawn.length === 0)
+            return current;
+        const remaining = pending.filter((entry) => entry.request_id !== undefined);
+        const next = { ...current };
+        if (remaining.length > 0)
+            next.pending = remaining;
+        else
+            delete next.pending;
+        return withdrawn.reduce((remembered, entry) => rememberQuestionState(remembered, entry, 'withdrawn'), next);
+    });
+    return withdrawn;
+}
+export function clearFrozenSubmission(sessionId, env, entry) {
+    updateSessionState(sessionId, env, (current) => {
+        const list = pendingList(current);
+        const index = list.findIndex((candidate) => isSamePending(candidate, entry));
+        if (index < 0)
+            return current;
+        const next = [...list];
+        const copy = { ...next[index] };
+        delete copy.submission;
+        next[index] = copy;
+        return { ...current, pending: next };
+    });
+}
+/** The question set this pending record pushes, however it was registered. */
+export function pendingQuestions(pending) {
+    return pending.questions ?? [{ id: 'q1', text: pending.question }];
+}
+/** Did any question in the set offer choices? Decides how replies combine. */
+export function pendingHasChoices(pending) {
+    return pendingQuestions(pending).some((question) => question.choices !== undefined);
+}
+//# sourceMappingURL=hook-question-state.js.map

package/dist/hook-question-state.js.map

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

package/dist/hook-session-state.d.ts

@@ -0,0 +1,31 @@
+import type { HookHarness, PendingQuestion, SessionState } from './hook-types.js';
+export declare function sessionStatePath(sessionId: string, env: NodeJS.ProcessEnv): string;
+export declare function sessionHasEnded(sessionId: string, env: NodeJS.ProcessEnv): boolean;
+export declare function markSessionEnded(sessionId: string, env: NodeJS.ProcessEnv, now: number): void;
+export declare function readSessionState(sessionId: string, env: NodeJS.ProcessEnv): SessionState;
+/**
+ * Resolve a stable question or request id to the one exact session that owns it.
+ *
+ * This deliberately searches lifecycle state, not checkout pointers: question
+ * identity is global on this machine, while a linked worktree is only where a
+ * command happened to run. Ambiguous or corrupt matches fail closed.
+ */
+export declare function findOwningSession(id: string, env: NodeJS.ProcessEnv): {
+    sessionId: string | null;
+    ambiguous: boolean;
+};
+export declare function writeSessionState(sessionId: string, env: NodeJS.ProcessEnv, state: SessionState): void;
+export declare function clearSessionState(sessionId: string, env: NodeJS.ProcessEnv): void;
+export declare function writeSessionStateUnlocked(file: string, sessionId: string, state: SessionState): void;
+export declare function updateSessionState(sessionId: string, env: NodeJS.ProcessEnv, update: (current: SessionState) => SessionState): SessionState;
+/** Record the current installation when an owner session starts. */
+export declare function recordSessionStart(sessionId: string, env: NodeJS.ProcessEnv, harness?: HookHarness, cwd?: string, codexStopDefinitionFingerprint?: string): void;
+/** Atomically claim Cursor's first-Stop activation fallback once per conversation. */
+export declare function claimCursorStopActivation(sessionId: string, env: NodeJS.ProcessEnv, now: number): boolean;
+/** Cursor's loop_count proves the previous Stop follow-up reached the host. */
+export declare function confirmCursorStopActivation(sessionId: string, env: NodeJS.ProcessEnv, now: number): boolean;
+/** A fresh/cleared Cursor lifecycle makes its next Stop the fallback owner again. */
+export declare function resetCursorStopActivation(sessionId: string, env: NodeJS.ProcessEnv): void;
+export declare function pruneAbandonedSessions(env: NodeJS.ProcessEnv, now?: number, maxAgeMs?: number): number;
+/** The registered-question queue. Anything but the current shape reads as empty. */
+export declare function pendingList(state: SessionState): PendingQuestion[];