@raidiant/notifai 11.7.1 → 12.0.0-beta.11

package/dist/hook-question-state.js

@@ -1,239 +0,0 @@
-import { withFileLock } from './file-lock.js';
-import { findOwningSession, pendingList, readSessionState, sessionHasEnded, sessionStatePath, updateSessionState, writeSessionStateUnlocked, } 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 && terminalState !== 'withdrawn'
-        ? 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 ?? []), ...(state.delivered_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);
-    const history = (state.question_history ?? []).find((entry) => entry.question_id === questionId);
-    if (retiring?.question_id !== undefined) {
-        const unconfirmed = history?.request_id === undefined &&
-            history?.frozen_request_id === retiring.request_id;
-        return {
-            found: true,
-            session_id: owner.sessionId,
-            question: {
-                question_id: retiring.question_id,
-                state: retiring.state === 'answered' ? 'answered' : 'retired',
-                submitted: unconfirmed ? null : true,
-                request_id: unconfirmed ? null : retiring.request_id,
-                frozen_request_id: unconfirmed ? retiring.request_id : null,
-            },
-        };
-    }
-    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);
-    });
-}
-function queuedQuestionIndex(state, entry) {
-    if (entry.question_id !== undefined) {
-        const remembered = (state.question_history ?? []).find((item) => item.question_id === entry.question_id);
-        if (remembered?.state === 'withdrawn' ||
-            remembered?.state === 'answered' ||
-            remembered?.state === 'retired') {
-            return -1;
-        }
-    }
-    return pendingList(state).findIndex((candidate) => isSamePending(candidate, entry) && candidate.request_id === undefined);
-}
-/** A cheap preflight check; only admitQueuedQuestion authorizes submission. */
-export function queuedQuestionStillEligible(sessionId, env, entry) {
-    return queuedQuestionIndex(readSessionState(sessionId, env), entry) >= 0;
-}
-/** Whether silent local withdrawal is no longer an honest outcome. */
-export function questionSubmissionAttempted(entry) {
-    return entry.request_id !== undefined || entry.submission?.admitted_at !== undefined;
-}
-/**
- * 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 function admitQueuedQuestion(sessionId, env, entry, intent, now, submit, serviceIdentity) {
-    const file = sessionStatePath(sessionId, env);
-    return withFileLock(`${file}.lock`, () => {
-        if (sessionHasEnded(sessionId, env))
-            return null;
-        const current = readSessionState(sessionId, env);
-        const index = queuedQuestionIndex(current, entry);
-        if (index < 0)
-            return null;
-        const pending = [...pendingList(current)];
-        const candidate = pending[index];
-        for (const identity of [candidate.service_identity, intent.service_identity]) {
-            if (identity !== undefined && (identity.machine_id !== serviceIdentity?.machine_id ||
-                identity.base_url !== serviceIdentity?.base_url))
-                return null;
-        }
-        if (candidate.submission?.request_id !== intent.request_id)
-            return null;
-        pending[index] = {
-            ...candidate,
-            submission: { ...intent, admitted_at: intent.admitted_at ?? now },
-        };
-        writeSessionStateUnlocked(file, sessionId, { ...current, pending });
-        return submit();
-    });
-}
-/** Replace only the rejected frozen identity, atomically with the native
- * obligation check. Preparing a replacement never erases the original first.
- */
-export function replaceFrozenSubmission(sessionId, env, entry, rejected, replacement) {
-    let replaced = false;
-    updateSessionState(sessionId, env, (current) => {
-        if (sessionHasEnded(sessionId, env) || current.native_answer_operations?.some(op => op.question_id === entry.question_id))
-            return current;
-        const list = pendingList(current);
-        const index = queuedQuestionIndex(current, entry);
-        if (index < 0 || list[index]?.submission?.request_id !== rejected.request_id ||
-            list[index]?.submission?.idempotency_key !== rejected.idempotency_key)
-            return current;
-        const next = [...list];
-        next[index] = { ...next[index], submission: replacement };
-        replaced = true;
-        return { ...current, pending: next };
-    });
-    return replaced;
-}
-/** 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

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

@@ -1,127 +0,0 @@
-import type { HookHarness, PendingQuestion, SessionState } from './hook-types.js';
-import type { ProcessIdentity } from './process-identity.js';
-export declare function sessionStatePath(sessionId: string, env: NodeJS.ProcessEnv): string;
-export declare function sessionHasEnded(sessionId: string, env: NodeJS.ProcessEnv): boolean;
-/**
- * When a lifecycle edge happened, in an order no wall-clock change can alter.
- *
- * `mono` is the system-wide monotonic clock (`process.hrtime`), shared by
- * every process on this machine within one boot. Wall time is kept for people
- * reading the files, never for ordering: an NTP step or a manual change moved
- * it backwards far enough to end a resumed session with its own earlier end.
- */
-export interface LifecycleStamp {
-    wall: number;
-    mono: string;
-}
-export declare function lifecycleStamp(wall?: number): LifecycleStamp;
-/**
- * Whether `edge` happened before `reference`, a stamp taken by this process.
- * A monotonic value ahead of this process's own clock can only come from an
- * earlier boot, so it is earlier too; an edge without a stamp (an older
- * build's marker) is treated as earlier.
- */
-export declare function happenedBefore(edge: LifecycleStamp | null, reference: LifecycleStamp): boolean;
-/** What SessionEnd recorded: when, and which incarnation it ended. */
-export interface SessionEndMarker {
-    stamp: LifecycleStamp | null;
-    /** `key` of the incarnation current when the session ended, when there was one. */
-    ends: string | null;
-}
-export declare function markSessionEnded(sessionId: string, env: NodeJS.ProcessEnv, now: number): SessionEndMarker;
-/** The end marker, or null when the session carries none. */
-export declare function readSessionEndMarker(sessionId: string, env: NodeJS.ProcessEnv): SessionEndMarker | null;
-/** Whether this marker ended exactly this incarnation. */
-export declare function endsIncarnation(marker: SessionEndMarker | null, incarnation: SessionIncarnation): boolean;
-/**
- * One start of one Agent Session: the edge from which its end is judged.
- *
- * A harness may start the same session id again — `/resume` in the same
- * process, or `--resume` in a new one — after SessionEnd already marked it
- * ended. SessionEnd names the incarnation it ended, so an end recorded for an
- * earlier incarnation can never end a later one, whatever the wall clock did.
- */
-export interface SessionIncarnation {
-    /** Stable local identity of this start; end markers name it. */
-    key: string;
-    /** Opaque identity shown to the service by the Session Attendant. Never a PID. */
-    incarnation: string;
-    start: LifecycleStamp;
-    /** The OpenClaw plugin generation behind this stable sessionKey. */
-    openclaw_generation?: string;
-    /** The harness process hosting this incarnation, when the starter knew it. */
-    harness_process?: ProcessIdentity;
-}
-export declare function readSessionIncarnation(sessionId: string, env: NodeJS.ProcessEnv): SessionIncarnation | null;
-export declare function newIncarnationId(): string;
-/**
- * The one shared, idempotent start of an Agent Session incarnation.
- *
- * Every SessionStart handler calls it before anything reads the end marker,
- * stamped with the moment its own invocation began.
- *
- * - The recorded incarnation is joined when it runs in the same harness
- *   process and has not ended — the second handler of one start — or when its
- *   end came *after* this handler began: that end is this start's own, seen by
- *   a delayed handler, and it must stay ended.
- * - Otherwise a new incarnation is minted: no record, another harness
- *   process, or the recorded incarnation ended before this handler began
- *   (in-process `/resume` after `/clear`).
- * - An end marker from before this handler, for any incarnation but the one
- *   joined, is dropped; a later one is kept.
- */
-export declare function beginSessionIncarnation(sessionId: string, env: NodeJS.ProcessEnv, options: {
-    stamp: LifecycleStamp;
-    harnessProcess?: ProcessIdentity;
-    /**
-     * Only a SessionStart may drop an earlier end marker. A re-arm (a later
-     * hook finding no incarnation for its harness process) mints one without
-     * touching the marker, so shared cancellation stays intact.
-     */
-    clearEarlierEnd?: boolean;
-    openclawGeneration?: string;
-}): SessionIncarnation;
-/**
- * Replace this incarnation's service identity after the service refused it,
- * keeping its local key and start. Only the holder of `expected` may rotate it.
- */
-export declare function rotateSessionIncarnation(sessionId: string, env: NodeJS.ProcessEnv, expected: string): SessionIncarnation | null;
-export declare function sessionNotified(sessionId: string, env: NodeJS.ProcessEnv): boolean;
-/** Record the first accepted Notification Request of an Agent Session. Never throws. */
-export declare function recordSessionNotified(sessionId: string, env: NodeJS.ProcessEnv, now: number): void;
-/**
- * Keep a long-running session's small files younger than the abandoned-state
- * prune, including any extra files its owner names (the attendant's claim).
- */
-export declare function refreshSessionMarkers(sessionId: string, env: NodeJS.ProcessEnv, now: number, extra?: readonly string[]): 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;
-/** Caller owns the session lock. Completed keys remain non-reusable until the
- * whole abandoned session is pruned; unfinished operations pin that boundary.
- */
-export declare function clearSessionStateUnlocked(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, stamp?: LifecycleStamp, openclawGeneration?: 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[];