@raidiant/notifai 11.7.1 → 12.0.0-beta.5

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

@@ -1,74 +0,0 @@
-/** Durable question retirement, including cross-session orphan recovery. */
-import type { CloseDisposition, CloseRepliesResponse, LifecycleEndState, ListRepliesResponse } from '@raidiant/notifai-protocol';
-import type { HookContext, HookEnvelope, PendingQuestion, RetiringQuestion } from './hook-types.js';
-/**
- * Everything retirement needs. Narrower than a HookContext on purpose:
- * explicit close is a plain command with no hook payload, no idle probe and
- * nothing to sleep for. Independent asks never supersede each other.
- */
-export type RetireDeps = Pick<HookContext, 'client' | 'config'> & Pick<Partial<HookContext>, 'log'>;
-/**
- * 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.
- *
- * `disposition` tells the service why this close happens, and the first close
- * that ends an open window keeps its reason: `deliver` only from a waiter that
- * will claim the fenced answer before handing it off, `retire` from every
- * retirement. Answer collection that hands off unclaimed sends none, so its
- * answer is honestly not editable after the fence.
- */
-export declare function finalizeReplies(ctx: RetireDeps, requestId: string, disposition?: CloseDisposition): Promise<ListRepliesResponse | CloseRepliesResponse | null>;
-/** Whether this close selected the answer it returned for a claimed hand-off. */
-export declare function selectedForClaimedDelivery(response: ListRepliesResponse | CloseRepliesResponse | null | undefined): boolean;
-/** Best effort only for already-journaled retirement debt. */
-export declare function closeQuietly(ctx: RetireDeps, requestId: string): Promise<void>;
-/**
- * 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 declare function parkForRetirement(sessionId: string, env: NodeJS.ProcessEnv, pending: PendingQuestion, state: LifecycleEndState): void;
-/**
- * Stop queued retries under the same lock as admission. Preparations that
- * never started are withdrawn silently; admitted attempts retain their exact
- * retirement identity even if their receipt is still in flight or was lost.
- */
-export declare function retireQueuedQuestions(sessionId: string, env: NodeJS.ProcessEnv, questionId?: string): {
-    withdrawn: PendingQuestion[];
-    retiring: RetiringQuestion[];
-};
-/**
- * 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 declare function retiringQuestion(pending: PendingQuestion, state: LifecycleEndState, cwd?: string): RetiringQuestion | null;
-/**
- * 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 declare function pendingAnsweredByPrompt(prompt: string | undefined, pending: readonly PendingQuestion[]): PendingQuestion[];
-/**
- * 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 declare function drainRetirements(ctx: RetireDeps, sessionId: string, env: NodeJS.ProcessEnv): Promise<string[]>;
-/** Move retirements into the global queue; deduped so a retry costs nothing. */
-export declare function orphanRetirements(env: NodeJS.ProcessEnv, entries: RetiringQuestion[], now: number): void;
-/**
- * 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 declare function drainOrphanRetirements(ctx: RetireDeps, env: NodeJS.ProcessEnv, now: number): Promise<string[]>;
-export declare function retirePendings(ctx: HookContext, envelope: HookEnvelope, sessionId: string, entries: PendingQuestion[], state: LifecycleEndState): Promise<void>;

package/dist/hook-question-retirement.js

@@ -1,314 +0,0 @@
-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 { terminateCodexQuestions } from './codex-question-bindings.js';
-import { stateDir } from './config.js';
-import { withFileLock } from './file-lock.js';
-import { isSamePending, questionSubmissionAttempted, 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.
- *
- * `disposition` tells the service why this close happens, and the first close
- * that ends an open window keeps its reason: `deliver` only from a waiter that
- * will claim the fenced answer before handing it off, `retire` from every
- * retirement. Answer collection that hands off unclaimed sends none, so its
- * answer is honestly not editable after the fence.
- */
-export async function finalizeReplies(ctx, requestId, disposition) {
-    try {
-        return disposition === undefined
-            ? await ctx.client.closeReplies(requestId)
-            : await ctx.client.closeReplies(requestId, disposition);
-    }
-    catch {
-        return null;
-    }
-}
-/** Whether this close selected the answer it returned for a claimed hand-off. */
-export function selectedForClaimedDelivery(response) {
-    return (response !== null &&
-        response !== undefined &&
-        'close_disposition' in response &&
-        response.close_disposition === 'deliver' &&
-        response.delivered_reply_seq !== null &&
-        response.delivered_reply_seq === response.replies.at(-1)?.seq);
-}
-/** Best effort only for already-journaled retirement debt. */
-export async function closeQuietly(ctx, requestId) {
-    await finalizeReplies(ctx, requestId, 'retire');
-}
-/**
- * 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, 'retire');
-    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');
-    });
-}
-/**
- * Stop queued retries under the same lock as admission. Preparations that
- * never started are withdrawn silently; admitted attempts retain their exact
- * retirement identity even if their receipt is still in flight or was lost.
- */
-export function retireQueuedQuestions(sessionId, env, questionId) {
-    const withdrawn = [];
-    const retiring = [];
-    updateSessionState(sessionId, env, (current) => {
-        const selected = pendingList(current).filter((entry) => entry.request_id === undefined &&
-            (questionId === undefined || entry.question_id === questionId));
-        const remaining = pendingList(current).filter((entry) => !selected.includes(entry));
-        let next = terminateCodexQuestions({ ...current }, new Set(selected.flatMap(entry => entry.question_id === undefined ? [] : [entry.question_id])));
-        if (remaining.length > 0)
-            next.pending = remaining;
-        else
-            delete next.pending;
-        for (const entry of selected) {
-            if (questionSubmissionAttempted(entry)) {
-                const retirement = retiringQuestion(entry, 'answered_elsewhere');
-                retiring.push(retirement);
-                const queue = [...(next.retiring ?? [])];
-                if (!queue.some((item) => item.request_id === retirement.request_id))
-                    queue.push(retirement);
-                next = rememberQuestionState({ ...next, retiring: queue }, entry, 'retired');
-            }
-            else {
-                withdrawn.push(entry);
-                next = rememberQuestionState(next, entry, 'withdrawn');
-            }
-        }
-        return next;
-    });
-    return { withdrawn, retiring };
-}
-/**
- * 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) => rememberQuestionState({
-                ...current,
-                retiring: (current.retiring ?? []).filter((candidate) => candidate.request_id !== entry.request_id),
-            }, entry, entry.state === 'answered' ? 'answered' : 'retired'));
-        }
-    }
-    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

@@ -1 +0,0 @@
-{"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

@@ -1,58 +0,0 @@
-/** Question history, inspection, and atomic live-question state changes. */
-import type { QuestionT, SourceContextT } from '@raidiant/notifai-protocol';
-import type { PendingQuestion, PendingSubmissionIntent, QuestionDeliveryState, QuestionTerminalState, SessionState } from './hook-types.js';
-import type { ServiceIdentity } from './credentials.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;
-/** A cheap preflight check; only admitQueuedQuestion authorizes submission. */
-export declare function queuedQuestionStillEligible(sessionId: string, env: NodeJS.ProcessEnv, entry: PendingQuestion): boolean;
-/** Whether silent local withdrawal is no longer an honest outcome. */
-export declare function questionSubmissionAttempted(entry: PendingQuestion): boolean;
-/**
- * One serialized boundary with close, prompt retirement, and SessionEnd.
- * Withdrawal first means no request starts. Admission first journals the
- * reserved identity and starts the request before releasing the lock; a later
- * close must retire that potentially remote identity, never call it withdrawn.
- *
- * submit must initiate the request synchronously and return its promise. The
- * lock is released before awaiting network work, using the ordinary bounded
- * acquisition and dead-process recovery of the session-state lock.
- */
-export declare function admitQueuedQuestion<T>(sessionId: string, env: NodeJS.ProcessEnv, entry: PendingQuestion, intent: PendingSubmissionIntent, now: number, submit: () => Promise<T>, serviceIdentity?: ServiceIdentity): Promise<T> | null;
-/** Replace only the rejected frozen identity, atomically with the native
- * obligation check. Preparing a replacement never erases the original first.
- */
-export declare function replaceFrozenSubmission(sessionId: string, env: NodeJS.ProcessEnv, entry: PendingQuestion, rejected: PendingSubmissionIntent, replacement: PendingSubmissionIntent): boolean;
-/** 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 {};