@raidiant/notifai 9.3.0 → 10.0.0

package/dist/harnesses.js

@@ -1,35 +1,101 @@
-/** Every harness Notifai ships. This is the sole source of the harness union. */
-export const HARNESSES = ['claude-code', 'codex', 'cursor', 'opencode'];
+/** Every harness Notifai can name in Source Context when authoritatively known. */
+export const SOURCE_CONTEXT_HARNESSES = ['claude-code', 'codex', 'cursor', 'opencode', 'hermes'];
+/**
+ * Harnesses whose lifecycle Notifai can install and manage.
+ *
+ * Source Context is the broader vocabulary. Managed hook installation is a
+ * narrower, independently proven cell: Hermes can appear in Source Context
+ * without being hook-installable.
+ */
+export const HOOK_INSTALLABLE_HARNESSES = ['claude-code', 'codex', 'cursor', 'opencode'];
+export function isHookInstallableHarness(value) {
+    return HOOK_INSTALLABLE_HARNESSES.includes(value);
+}
 export const HARNESS_LABELS = {
     'claude-code': 'Claude Code',
     codex: 'Codex',
     cursor: 'Cursor',
     opencode: 'OpenCode',
+    hermes: 'Hermes',
+};
+const CLAUDE_CODE_CAPABILITY = {
+    stopContinuation: 'decision-block',
+    deliveryRoutes: ['hook-continuation', 'inbox-socket', 'cold-resume', 'hold-for-next-turn'],
+    deliveryContract: 'the Stop hook returns at once and waits out of band through the complete answer window, then posts the answer into this same session over its own inbox socket; a session that has stopped is resumed only once a liveness probe proves it stopped',
+};
+const CODEX_CAPABILITY = {
+    stopContinuation: 'decision-block',
+    deliveryRoutes: ['hook-continuation', 'cold-resume', 'hold-for-next-turn'],
+    deliveryContract: 'live Stop continuation while the turn is held through the complete answer window; crash recovery may resume only a stopped thread behind its writer lock',
+};
+const CURSOR_CAPABILITY = {
+    stopContinuation: 'unsupported',
+    deliveryRoutes: ['unsupported'],
+    deliveryContract: 'the hook can return a live follow-up, but the invoking shell exposes no exact conversation id; asynchronous ask is unsupported',
+};
+const OPENCODE_CAPABILITY = {
+    stopContinuation: 'unsupported',
+    deliveryRoutes: ['unsupported'],
+    deliveryContract: 'no proven answer continuation after session.idle; use a blocking reply command',
+};
+export const HERMES_QUESTION_ROUTING_UNAVAILABLE = {
+    stopContinuation: 'unsupported',
+    deliveryRoutes: ['unsupported'],
+    deliveryContract: 'Hermes asynchronous ask has no proven continuation owner on this integration surface. Use a blocking `notifai send --reply` question',
 };
 /**
- * Exhaustive runtime contract. Adding a harness without deciding every
- * continuation joint is a type error, not a silently degraded notification.
+ * The one Hermes integration instance proven by the pinned vertical probe.
+ *
+ * This is evidence-bearing capability data, not an adapter. Unsupported and
+ * deferred surfaces intentionally have no empty implementation object here.
  */
-export const HARNESS_CAPABILITIES = {
-    'claude-code': {
-        stopContinuation: 'decision-block',
-        deliveryRoutes: ['hook-continuation', 'inbox-socket', 'cold-resume', 'hold-for-next-turn'],
-        deliveryContract: 'the Stop hook returns at once and waits out of band through the complete answer window, then posts the answer into this same session over its own inbox socket; a session that has stopped is resumed only once a liveness probe proves it stopped',
-    },
-    codex: {
-        stopContinuation: 'decision-block',
-        deliveryRoutes: ['hook-continuation', 'cold-resume', 'hold-for-next-turn'],
-        deliveryContract: 'live Stop continuation while the turn is held through the complete answer window; crash recovery may resume only a stopped thread behind its writer lock',
-    },
-    cursor: {
-        stopContinuation: 'unsupported',
-        deliveryRoutes: ['unsupported'],
-        deliveryContract: 'the hook can return a live follow-up, but the invoking shell exposes no exact conversation id; asynchronous ask is unsupported',
-    },
-    opencode: {
-        stopContinuation: 'unsupported',
-        deliveryRoutes: ['unsupported'],
-        deliveryContract: 'no proven answer continuation after session.idle; use a blocking reply command',
+export const HERMES_CLASSIC_CLI_LOCAL_CAPABILITY = {
+    instance: {
+        harness: 'hermes',
+        surface: 'classic-cli',
+        terminalBackend: 'local',
     },
+    setup: 'unsupported',
+    activation: 'unsupported',
+    sourceContext: 'hermes-session-id-and-invocation-cwd',
+    continuation: 'unsupported',
+};
+/**
+ * Resolve only the Hermes instance whose complete marker envelope was proven.
+ *
+ * `HERMES_SESSION_ID` is also bridged by deferred gateway, TUI, API, ACP, and
+ * remote-backend paths. Their first-party routing/source/backend markers keep
+ * those cells distinct. Missing source/backend values are the pinned classic
+ * CLI defaults; a gateway key is never part of that instance.
+ */
+export function hermesClassicCliLocalInstance(env) {
+    const sessionId = (env['HERMES_SESSION_ID'] ?? '').trim();
+    const sessionKey = (env['HERMES_SESSION_KEY'] ?? '').trim();
+    const platform = (env['HERMES_SESSION_PLATFORM'] ?? '').trim().toLowerCase();
+    const source = (env['HERMES_SESSION_SOURCE'] ?? '').trim().toLowerCase();
+    const terminalBackend = (env['TERMINAL_ENV'] ?? '').trim().toLowerCase();
+    if (sessionId === '' || sessionKey !== '' || platform !== '')
+        return null;
+    if (source !== '' && source !== 'cli')
+        return null;
+    if (terminalBackend !== '' && terminalBackend !== 'local')
+        return null;
+    return HERMES_CLASSIC_CLI_LOCAL_CAPABILITY.instance;
+}
+/**
+ * Question-routing contract for hook-installable harnesses.
+ *
+ * Hermes is deliberately absent: a send-only surface must not occupy this
+ * table with a fake managed-hook continuation route.
+ */
+export const HARNESS_CAPABILITIES = {
+    'claude-code': CLAUDE_CODE_CAPABILITY,
+    codex: CODEX_CAPABILITY,
+    cursor: CURSOR_CAPABILITY,
+    opencode: OPENCODE_CAPABILITY,
 };
+/** Question-routing capability for the active harness integration. */
+export function questionRoutingCapability(harness) {
+    return HARNESS_CAPABILITIES[harness];
+}
 //# sourceMappingURL=harnesses.js.map

package/dist/harnesses.js.map

@@ -1 +1 @@
-{"version":3,"file":"harnesses.js","sourceRoot":"","sources":["../src/harnesses.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAA;AAIhF,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,aAAa,EAAE,aAAa;IAC5B,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACrB,CAAA;AAqBD;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAuC;IACtE,aAAa,EAAE;QACb,gBAAgB,EAAE,gBAAgB;QAClC,cAAc,EAAE,CAAC,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,CAAC;QAC1F,gBAAgB,EACd,oPAAoP;KACvP;IACD,KAAK,EAAE;QACL,gBAAgB,EAAE,gBAAgB;QAClC,cAAc,EAAE,CAAC,mBAAmB,EAAE,aAAa,EAAE,oBAAoB,CAAC;QAC1E,gBAAgB,EACd,0JAA0J;KAC7J;IACD,MAAM,EAAE;QACN,gBAAgB,EAAE,aAAa;QAC/B,cAAc,EAAE,CAAC,aAAa,CAAC;QAC/B,gBAAgB,EACd,gIAAgI;KACnI;IACD,QAAQ,EAAE;QACR,gBAAgB,EAAE,aAAa;QAC/B,cAAc,EAAE,CAAC,aAAa,CAAC;QAC/B,gBAAgB,EACd,gFAAgF;KACnF;CACF,CAAA"}
+{"version":3,"file":"harnesses.js","sourceRoot":"","sources":["../src/harnesses.ts"],"names":[],"mappings":"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"}

package/dist/hooks.d.ts

@@ -2,7 +2,7 @@ import type { LifecycleEndState, MediaItemT, NotificationDraftT, QuestionT, Repl
 import { type ApiClient } from './client.js';
 import { type CliConfig } from './config.js';
 import type { Logger } from './logging.js';
-import { type DeliveryRoute, type Harness } from './harnesses.js';
+import { type DeliveryRoute, type HookInstallableHarness } from './harnesses.js';
 /**
  * Harness hook handlers.
  *
@@ -373,7 +373,7 @@ export declare const GATE_REASONS: readonly ["no-session", "no-question", "answe
  * emitted once; documenting them taught agents to filter for silence.
  */
 export type GateReason = (typeof GATE_REASONS)[number];
-export type HookHarness = Harness;
+export type HookHarness = HookInstallableHarness;
 /**
  * Everything retirement needs. Narrower than a HookContext on purpose:
  * `notifai ask` supersedes the previous question and it is a plain command with

package/dist/hooks.js

@@ -9,7 +9,7 @@ import { buildDraft } from './send.js';
 import { atomicWriteFileSync } from './atomic-file.js';
 import { withFileLock } from './file-lock.js';
 import { inferInvocationContext } from './invocation-context.js';
-import { HARNESS_CAPABILITIES, HARNESSES, } from './harnesses.js';
+import { HARNESS_CAPABILITIES, HOOK_INSTALLABLE_HARNESSES, } from './harnesses.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
@@ -474,7 +474,7 @@ function storedProjectSessionPointer(candidate) {
         return null;
     if (typeof entry.updated_at !== 'number')
         return null;
-    if (!HARNESSES.includes(entry.harness))
+    if (!HOOK_INSTALLABLE_HARNESSES.includes(entry.harness))
         return null;
     return {
         sessionId: entry.session_id,