@raidiant/notifai 0.3.0 → 0.5.0

package/dist/hook-input.js.map

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

package/dist/hooks.d.ts

@@ -1,14 +1,15 @@
-import type { LifecycleEndState, QuestionT, ReplyView } from '@raidiant/notifai-protocol';
-import type { ApiClient } from './client.js';
+import type { LifecycleEndState, NotificationDraftT, QuestionT, ReplyView } from '@raidiant/notifai-protocol';
+import { type ApiClient } from './client.js';
 import { type CliConfig } from './config.js';
+import type { Logger } from './logging.js';
+import { type Harness } from './harnesses.js';
 /**
  * Harness hook handlers.
  *
  * The supported harnesses expose the same useful lifecycle joints: a turn-end
- * event and an event that fires when the user submits a prompt. Claude Code,
- * Codex, and Cursor can continue directly from a turn-end answer. OpenCode
- * preserves the pending answer at turn end and injects it on the next prompt.
- * No question detection or context-window state is needed in either path.
+ * event and an event that fires when the user submits a prompt. Claude Code
+ * and Codex can continue directly from a turn-end answer. Harnesses without a
+ * proven exact-session continuation fail closed at question admission.
  *
  * The load-bearing constraint is that these hooks are synchronous: while one
  * blocks, the harness cannot show its own prompt either. So a hook may only
@@ -32,6 +33,8 @@ export interface HookEnvelope {
 export interface SessionState {
     /** Epoch ms of the user's last prompt in this session — our presence signal. */
     last_prompt_at?: number;
+    /** Epoch ms of the last observed Stop hook, distinct from prompt routing. */
+    last_stop_at?: number;
     /**
      * Questions registered by `notifai ask`, in registration order, each
      * awaiting escalation or its answer. A list, deliberately: registering a
@@ -59,6 +62,19 @@ export interface SessionState {
         answered_at: number;
         count: number;
     };
+    /**
+     * A phone answer durably captured but not yet acknowledged by a successor
+     * hook. It stays here until the next Stop proves the harness processed the
+     * continuation; a crash before stdout therefore replays instead of erasing
+     * the user's answer.
+     */
+    accepted?: AcceptedAnswerDelivery;
+}
+interface AcceptedAnswerDelivery {
+    answers: AnsweredPending[];
+    remaining: number;
+    recorded_at: number;
+    continuation_count?: number;
 }
 /** A delivered question awaiting its retirement push. */
 export interface RetiringQuestion {
@@ -88,6 +104,8 @@ export interface OrphanRetirement extends RetiringQuestion {
     enqueued_at: number;
 }
 export interface PendingQuestion {
+    /** Stable local identity across racing state writers and submit recovery. */
+    question_id?: string;
     /** One-line summary: the single question's text, or the set's first. */
     question: string;
     /**
@@ -108,6 +126,18 @@ export interface PendingQuestion {
     collapse_key?: string;
     /** Exact fanout of the live question; routing config may change afterwards. */
     device_ids?: string[];
+    /** Absolute end of the server reply window and its local continuation owner. */
+    reply_deadline_at?: number;
+    /** Frozen before the first network byte, so an ambiguous submit is replayable. */
+    submission?: PendingSubmissionIntent;
+}
+interface PendingSubmissionIntent {
+    request_id: string;
+    idempotency_key: string;
+    collapse_key: string;
+    device_ids: string[];
+    draft: NotificationDraftT;
+    owner_deadline_at: number;
 }
 export type GraceOutcome = 
 /** The window elapsed with the user still gone; escalate. */
@@ -141,6 +171,8 @@ export interface HookOutcome {
     stdout?: string;
     /** Diagnostics; harnesses surface hook stderr in the transcript. */
     notes: string[];
+    /** Structured lifecycle detail that belongs on hook.end without user text. */
+    log?: Record<string, unknown>;
 }
 export declare function readSessionState(sessionId: string, env: NodeJS.ProcessEnv): SessionState;
 export declare function writeSessionState(sessionId: string, env: NodeJS.ProcessEnv, state: SessionState): void;
@@ -148,7 +180,7 @@ export declare function clearSessionState(sessionId: string, env: NodeJS.Process
 export declare function pruneAbandonedSessions(env: NodeJS.ProcessEnv, now?: number, maxAgeMs?: number): number;
 export declare function claimQuestionPush(sessionId: string, env: NodeJS.ProcessEnv, now?: number, beforeStaleReplace?: () => void): boolean;
 export declare function releaseQuestionPush(sessionId: string, env: NodeJS.ProcessEnv): void;
-/** Records which session is working in a directory, for `notifai ask`. */
+/** Records every live session working in a directory, for `notifai ask`. */
 export declare function writeProjectSession(cwd: string, env: NodeJS.ProcessEnv, sessionId: string, now: number, harness: HookHarness): void;
 export interface ProjectSessionPointer {
     sessionId: string;
@@ -161,6 +193,7 @@ export interface ProjectSessionPointer {
  */
 export declare function readProjectSession(cwd: string, env: NodeJS.ProcessEnv, now: number, maxAgeMs?: number): string | null;
 export declare function readProjectSessionPointer(cwd: string, env: NodeJS.ProcessEnv, now: number, maxAgeMs?: number): ProjectSessionPointer | null;
+export declare function readMatchingProjectSessionPointer(cwd: string, env: NodeJS.ProcessEnv, now: number, sessionId: string, harness: HookHarness, maxAgeMs?: number): ProjectSessionPointer | null;
 /**
  * Absent means the user is not at this machine's keyboard.
  *
@@ -203,10 +236,26 @@ export interface HookContext {
         timedOut: boolean;
         degraded?: boolean;
     }>;
-    /** OpenCode cannot consume Stop stdout, so its adapter must never wait there. */
+    /** The active harness selects the native continuation output adapter. */
     harness?: HookHarness;
+    /**
+     * The local record. A hook's decisions are invisible from everywhere else —
+     * its stderr belongs to the harness and its usual outcome is to do nothing —
+     * so this is the only account of why a question did or did not travel.
+     */
+    log?: Logger;
 }
-export type HookHarness = 'claude-code' | 'codex' | 'cursor' | 'opencode';
+/**
+ * Record one gate decision.
+ *
+ * `verdict` is what happened to the question and `reason` is the closed-set
+ * name of the rule that decided it, so an agent can ask "why was it held" with
+ * a filter rather than by matching on prose. The prose still exists — it is what
+ * the user sees in the terminal — but it is free to be rewritten, and a log a
+ * filter cannot rely on is a log nobody filters.
+ */
+export type GateReason = 'no-session' | 'no-question' | 'answered' | 'already-asked' | 'continuation-repeat' | 'continuation-limit' | 'notifications-off' | 'user-present' | 'claimed-elsewhere' | 'user-returned' | 'no-devices' | 'proceeding';
+export type HookHarness = Harness;
 /**
  * Everything retirement needs. Narrower than a HookContext on purpose:
  * `notifai ask` supersedes the previous question and it is a plain command with
@@ -234,6 +283,12 @@ export declare function orphanRetirements(env: NodeJS.ProcessEnv, entries: Retir
  * 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[]>;
+/** One answered registered question, with everything the agent needs to read it. */
+interface AnsweredPending {
+    pending: PendingQuestion;
+    reply: ReplyView;
+    replies: ReplyView[];
+}
 /**
  * Records presence and retires anything still asking on companion devices. This is the
  * "answered in the terminal" case from the original design: we cannot tell
@@ -246,7 +301,7 @@ export declare function handleUserPromptSubmit(ctx: HookContext, envelope: HookE
  * `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): Promise<HookOutcome>;
+export declare function handleStop(ctx: HookContext, envelope: HookEnvelope, processDeadlineAt?: number): Promise<HookOutcome>;
 /**
  * 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
@@ -279,3 +334,4 @@ export declare function registerQuestion(sessionId: string, env: NodeJS.ProcessE
 /** Parses hook JSON from stdin, tolerating an empty or malformed body. */
 export declare function parseHookInput(raw: string): HookEnvelope;
 export declare function resolveHookConfig(cwd: string, env: NodeJS.ProcessEnv, sessionId: string | undefined): CliConfig;
+export {};