@raidiant/notifai 11.7.1 → 12.0.0-beta.13

package/dist/hook-events.js.map

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

package/dist/hook-gates.d.ts

@@ -1,7 +0,0 @@
-/** Structured gate decisions shared by lifecycle and acknowledgement handling. */
-import type { HookContext } from './hook-types.js';
-/** Runtime vocabulary for every recorded question gate. */
-export declare const GATE_REASONS: readonly ["no-session", "no-question", "answered", "continuation-limit", "delivery-limit", "acknowledgement-required", "acknowledgement-abandoned", "harness-cannot-continue", "notifications-off", "claimed-elsewhere", "elapsed", "proceeding"];
-export type GateReason = (typeof GATE_REASONS)[number];
-/** Record one gate decision using a stable reason agents can filter on. */
-export declare function gate(ctx: HookContext, verdict: 'held' | 'proceeding', reason: GateReason, data?: Record<string, unknown>): void;

package/dist/hook-gates.js

@@ -1,20 +0,0 @@
-/** Runtime vocabulary for every recorded question gate. */
-export const GATE_REASONS = [
-    'no-session',
-    'no-question',
-    'answered',
-    'continuation-limit',
-    'delivery-limit',
-    'acknowledgement-required',
-    'acknowledgement-abandoned',
-    'harness-cannot-continue',
-    'notifications-off',
-    'claimed-elsewhere',
-    'elapsed',
-    'proceeding',
-];
-/** Record one gate decision using a stable reason agents can filter on. */
-export function gate(ctx, verdict, reason, data = {}) {
-    ctx.log?.info('hook.gate', { verdict, reason, stage: 'queued', ...data });
-}
-//# sourceMappingURL=hook-gates.js.map

package/dist/hook-gates.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hook-gates.js","sourceRoot":"","sources":["../src/hook-gates.ts"],"names":[],"mappings":"AAGA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,YAAY;IACZ,aAAa;IACb,UAAU;IACV,oBAAoB;IACpB,gBAAgB;IAChB,0BAA0B;IAC1B,2BAA2B;IAC3B,yBAAyB;IACzB,mBAAmB;IACnB,mBAAmB;IACnB,SAAS;IACT,YAAY;CACJ,CAAA;AAIV,2EAA2E;AAC3E,MAAM,UAAU,IAAI,CAClB,GAAgB,EAChB,OAA8B,EAC9B,MAAkB,EAClB,OAAgC,EAAE;IAElC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;AAC3E,CAAC"}

package/dist/hook-input.d.ts

@@ -1,10 +0,0 @@
-import type { Readable } from 'node:stream';
-/**
- * Read one harness-hook envelope without letting a stuck pipe hold the prompt.
- *
- * A timeout or stream error before any bytes arrive rejects, so the hook can
- * record that its input was unavailable. Once bytes exist they are more useful
- * than the transport failure: complete JSON can still run, while partial or
- * capped JSON reaches the hook's malformed/truncated diagnostic.
- */
-export declare function readStdinWithTimeout(input?: Readable, timeoutMs?: number, maxBytes?: number): Promise<string>;

package/dist/hook-input.js

@@ -1,64 +0,0 @@
-const TRUNCATED_INPUT_SUFFIX = '\n[notifai: hook input truncated]\n';
-/**
- * Read one harness-hook envelope without letting a stuck pipe hold the prompt.
- *
- * A timeout or stream error before any bytes arrive rejects, so the hook can
- * record that its input was unavailable. Once bytes exist they are more useful
- * than the transport failure: complete JSON can still run, while partial or
- * capped JSON reaches the hook's malformed/truncated diagnostic.
- */
-export function readStdinWithTimeout(input = process.stdin, timeoutMs = 2_000, maxBytes = 1_000_000) {
-    if (input.isTTY === true)
-        return Promise.resolve('');
-    return new Promise((resolve, reject) => {
-        const chunks = [];
-        let total = 0;
-        let settled = false;
-        const cleanup = () => {
-            clearTimeout(timer);
-            input.off('data', onData);
-            input.off('end', onEnd);
-            input.off('error', onError);
-            input.destroy();
-        };
-        const finishBuffered = () => {
-            if (settled)
-                return;
-            settled = true;
-            cleanup();
-            resolve(Buffer.concat(chunks).toString('utf8'));
-        };
-        const failEmpty = (err) => {
-            if (settled)
-                return;
-            if (chunks.length > 0)
-                return finishBuffered();
-            settled = true;
-            cleanup();
-            reject(err);
-        };
-        const onData = (chunk) => {
-            const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-            const remaining = Math.max(0, maxBytes - total);
-            if (bytes.length <= remaining) {
-                chunks.push(bytes);
-                total += bytes.length;
-                return;
-            }
-            if (remaining > 0) {
-                chunks.push(bytes.subarray(0, remaining));
-                total += remaining;
-            }
-            chunks.push(Buffer.from(TRUNCATED_INPUT_SUFFIX));
-            finishBuffered();
-        };
-        const onEnd = () => finishBuffered();
-        const onError = (err) => failEmpty(err);
-        const timer = setTimeout(() => failEmpty(new Error(`timed out waiting ${timeoutMs}ms for hook input`)), timeoutMs);
-        timer.unref?.();
-        input.on('data', onData);
-        input.once('end', onEnd);
-        input.once('error', onError);
-    });
-}
-//# sourceMappingURL=hook-input.js.map

package/dist/hook-input.js.map

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

package/dist/hook-lifecycle.d.ts

@@ -1,112 +0,0 @@
-import { type NativeQuestionAdmission } from './codex-question-bindings.js';
-import type { EscalationDeliveryRoute, EscalationWaiterOptions, HookContext, HookEnvelope, HookOutcome, PendingQuestion } from './hook-types.js';
-/**
- * The wire contract's shortest reply window. A question submitted with less
- * than this is rejected outright, and accepting one would in any case let the
- * server go on taking an answer after the waiter that owns it has returned.
- */
-export declare const MIN_REPLY_WINDOW_SECONDS = 60;
-/**
- * The one bound on answer deliveries, for every route.
- *
- * It caps two things that both used to be able to run away: how many times a
- * single accepted answer may be handed to a route before the journal gives up
- * on it, and how many answer-driven continuation generations one chain may
- * produce.
- */
-export declare const MAX_CONTINUATION_COUNT = 3;
-/**
- * How many turns an answer may be *held* before it is settled unread.
- *
- * A hold is not a delivery: the route reported that it handed nothing over, so
- * the agent has not seen the answer and the wake-loop the continuation cap
- * exists to stop has not happened. Counting holds against that cap meant three
- * turns where a liveness probe could not reach a busy session were enough to
- * discard an answer the user had already given.
- *
- * It still has to end. A route that can never deliver would otherwise retry
- * every turn for the life of the session, so holds get their own, far looser
- * bound — loose because each one costs nothing and the answer is still wanted.
- */
-export declare const MAX_HELD_DELIVERIES = 20;
-/**
- * Records presence. Retires a live question only when this prompt plausibly
- * answers it. Typing in the terminal is not by itself a resolution: the User
- * may be answering a different question on a device.
- */
-export declare function handleUserPromptSubmit(ctx: HookContext, envelope: HookEnvelope): Promise<HookOutcome>;
-/**
- * Only engages for a question the agent explicitly registered with
- * `notifai ask`. Guessing from the last assistant message was the alternative
- * and it is not worth it: a false positive here hijacks the terminal.
- */
-export declare function handleStop(ctx: HookContext, envelope: HookEnvelope, processDeadlineAt?: number, route?: EscalationDeliveryRoute, recordStop?: boolean): Promise<HookOutcome>;
-/**
- * Own one registered question pipeline from its terminal-first timer through
- * its final delivery or retirement. Hosts differ only in the injected route.
- */
-export declare function runEscalationWaiter(ctx: HookContext, options: EscalationWaiterOptions): Promise<HookOutcome>;
-/**
- * The blocking Stop hook's own last meter: the answer becomes this process's
- * stdout, and the harness admits it as a new user turn. Exported because a
- * host adapter that has other routes still falls back to this one.
- */
-export declare function hookContinuationRoute(): EscalationDeliveryRoute;
-/**
- * Journal, then record, selected answers already written without a claim. A
- * record that fails stays in this session's delivery journal, so the next
- * hand-off here or the machine-wide sweep records it later.
- */
-export declare function reportHandedOffAfterTheFact(ctx: HookContext, sessionId: string, requestIds: readonly string[]): Promise<void>;
-/** Submit independently of the long-lived answer owner, preserving frozen identities. */
-export declare function submitSessionQuestions(ctx: HookContext, envelope: HookEnvelope, hardDeadlineAt?: number, notes?: string[]): Promise<PendingQuestion[]>;
-/**
- * Claude Code gives SessionEnd hooks a 1.5-second shared budget and Codex 1
- * second, so this cannot make a network call. It drops the local marker — but
- * first moves anything still live on the user's devices into the global
- * retirement queue, because this file was the only record of those ids and no
- * hook for this session will ever run again. A question whose
- * agent just exited can receive no answer, so it is orphaned as `expired`.
- */
-export declare function handleSessionEnd(env: NodeJS.ProcessEnv, envelope: HookEnvelope, now?: number, preserveAccepted?: boolean): HookOutcome;
-/**
- * Registrations still waiting for their first push. More than this in one turn
- * means an agent is looping, not asking, and related questions belong in one
- * `ask --form` instead.
- *
- * Deliberately counts only unasked entries. A question already on the user's
- * devices is waiting on a person, not on the agent, and an answer stays
- * accepted for a day — so counting live questions here would have turned a
- * patient user into a reason the agent could no longer ask anything.
- */
-export declare const MAX_PENDING_QUESTIONS = 4;
-/**
- * Everything this session has open at once, asked or not. The lock screen is
- * the shared resource being protected here, not the agent's turn.
- */
-export declare const MAX_LIVE_QUESTIONS = 10;
-export declare class QuestionRegistrationChanged extends Error {
-    readonly reason: 'credential' | 'owner';
-    constructor(reason: 'credential' | 'owner');
-}
-interface QuestionRegistrationGuard {
-    /** Captured before optional asynchronous discovery; a new turn is allowed. */
-    owner_key?: string;
-    machineStillMatches: () => boolean;
-}
-/**
- * A session may hold several registered questions at once: a new `ask` never
- * ends an earlier one. Each reaches the user as its own notification and is
- * answerable independently. Superseding is reply semantics — a later reply
- * corrects an earlier reply to the same question (that correction model lives
- * server-side) — never question semantics: the old single-slot model silently
- * discarded a question the moment a second was registered, and the user was
- * pointed at a notification that never existed (2026-08-09).
- *
- * The queue is keyed on the session, not the project: several agents may be
- * running in one project at once, and their questions must never interfere.
- */
-export declare function registerQuestion(sessionId: string, env: NodeJS.ProcessEnv, question: PendingQuestion, now?: number, nativeAdmission?: NativeQuestionAdmission, guard?: QuestionRegistrationGuard): string;
-/** Parses hook JSON from stdin, tolerating an empty or malformed body. */
-export declare function parseHookInput(raw: string): HookEnvelope;
-export {};