@raidiant/notifai 11.7.1 → 12.0.0-beta.13

package/dist/hermes-plugin.js

@@ -1,299 +0,0 @@
-import { spawnSync } from 'node:child_process';
-import { existsSync, lstatSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { pathToFileURL } from 'node:url';
-import { hookAdapterPath } from './hook-adapter.js';
-import { accountHome } from './platform.js';
-export const HERMES_PLUGIN_ID = 'notifai';
-export const HERMES_PLUGIN_MARKER = '# notifai managed hermes plugin v1';
-export function hermesPluginDir(env = process.env) {
-    const home = env['HERMES_HOME']?.trim() || path.join(accountHome(env, process.platform), '.hermes');
-    return path.join(home, 'plugins', HERMES_PLUGIN_ID);
-}
-export function hermesPluginSource(adapterPath, nodePath) {
-    const command = nodePath === undefined ? [adapterPath] : [nodePath, adapterPath];
-    return `${HERMES_PLUGIN_MARKER}
-"""Notifai activation and Session Attendant for a local Hermes CLI session."""
-import atexit
-import json
-import os
-import select
-import subprocess
-import threading
-import time
-
-COMMAND = ${JSON.stringify(command)}
-_attendants = {}
-_lock = threading.RLock()
-
-def _attached_session(ctx):
-    cli = getattr(ctx._manager, "_cli_ref", None)
-    return str(getattr(cli, "session_id", "") or "") if cli is not None else ""
-
-def _run_attendant(ctx, session_id, cwd, stopped):
-    proc = None
-    wall_anchor = time.time_ns()
-    mono_anchor = time.monotonic_ns()
-    try:
-        proc = subprocess.Popen(COMMAND + ["hook", "hermes-attend", "--owner", "notifai", "--harness", "hermes"],
-                                cwd=cwd, stdin=subprocess.PIPE, stdout=subprocess.PIPE,
-                                stderr=subprocess.DEVNULL, text=True, bufsize=1)
-        with _lock:
-            _attendants[session_id] = (stopped, proc)
-        def send(frame):
-            with _lock:
-                if proc.stdin is None or proc.stdin.closed:
-                    return False
-                try:
-                    proc.stdin.write(json.dumps(frame, ensure_ascii=False) + "\\n")
-                    proc.stdin.flush()
-                    return True
-                except (OSError, ValueError):
-                    return False
-        if not send({"type": "hello", "session_id": session_id, "cwd": cwd, "pid": os.getpid()}):
-            return
-        pending = bytearray()
-        while not stopped.is_set() and proc.poll() is None:
-            with _lock:
-                current = _attached_session(ctx)
-                working = bool(getattr(ctx._manager._cli_ref, "_agent_running", False)) if current == session_id else False
-            if current != session_id:
-                break
-            if not send({"type": "state", "session_id": session_id,
-                         "activity": "working" if working else "idle"}):
-                break
-            readable, _, _ = select.select([proc.stdout], [], [], 1.0)
-            if not readable:
-                continue
-            chunk = os.read(proc.stdout.fileno(), 65536)
-            if not chunk:
-                break
-            pending.extend(chunk)
-            if len(pending) > 2 * 1024 * 1024:
-                break
-            while b"\\n" in pending:
-                raw, _, rest = pending.partition(b"\\n")
-                pending = bytearray(rest)
-                try:
-                    frame = json.loads(raw.decode("utf-8"))
-                except (UnicodeDecodeError, ValueError):
-                    continue
-                if frame.get("type") != "write" or not isinstance(frame.get("id"), int):
-                    continue
-                accepted = False
-                with _lock:
-                    wall_now = time.time_ns()
-                    mono_now = time.monotonic_ns()
-                    # Fail closed after a backward wall-clock step. Node's
-                    # deadline is wall time because its monotonic origin may
-                    # differ from Python's on the same macOS host.
-                    clock_stable = wall_now - wall_anchor + 100_000_000 >= mono_now - mono_anchor
-                    deadline = frame.get("deadline_ms")
-                    if (not stopped.is_set() and frame.get("session_id") == session_id and
-                            _attached_session(ctx) == session_id and
-                            type(deadline) is int and wall_now < deadline * 1_000_000 and clock_stable):
-                        try:
-                            accepted = bool(ctx.inject_message(frame.get("text", "")))
-                        except Exception:
-                            pass
-                send({"type": "result", "id": frame["id"], "accepted": accepted,
-                      "reason": "session-replaced" if not accepted else ""})
-        send({"type": "end", "session_id": session_id})
-    except (OSError, ValueError):
-        pass
-    finally:
-        with _lock:
-            if _attendants.get(session_id, (None, None))[0] is stopped:
-                _attendants.pop(session_id, None)
-        if proc is not None:
-            try:
-                if proc.stdin is not None:
-                    proc.stdin.close()
-                proc.wait(timeout=4)
-            except (OSError, subprocess.TimeoutExpired):
-                proc.terminate()
-                try:
-                    proc.wait(timeout=2)
-                except subprocess.TimeoutExpired:
-                    proc.kill()
-
-def _start_attendant(ctx, session_id, cwd):
-    if os.name == "nt":
-        return
-    with _lock:
-        if _attached_session(ctx) != session_id or os.environ.get("HERMES_SESSION_ID") != session_id:
-            return
-        if session_id in _attendants:
-            return
-        stopped = threading.Event()
-        _attendants[session_id] = (stopped, None)
-        threading.Thread(target=_run_attendant, args=(ctx, session_id, cwd, stopped),
-                         daemon=True, name="notifai-hermes-attendant").start()
-
-def _stop_attendant(session_id):
-    with _lock:
-        item = _attendants.get(session_id)
-        if item is None:
-            return
-        stopped, proc = item
-        stopped.set()
-        if proc is not None and proc.stdin is not None and not proc.stdin.closed:
-            try:
-                proc.stdin.write(json.dumps({"type": "end", "session_id": session_id}) + "\\n")
-                proc.stdin.flush()
-            except (OSError, ValueError):
-                pass
-
-def _stop_all():
-    for session_id in list(_attendants):
-        _stop_attendant(session_id)
-
-def _activation(info):
-    platform = str(info.get("platform") or "")
-    if platform not in ("cli", "subagent"):
-        return ""
-    if os.environ.get("HERMES_SESSION_SOURCE", "").lower() not in ("", "cli"):
-        return ""
-    # Hermes may import gateway.run inside a classic CLI and set its process
-    # marker there. The attached CLI object and exact session are the proof.
-    if os.environ.get("HERMES_TUI_ACTIVE_SESSION_FILE"):
-        return ""
-    if os.environ.get("TERMINAL_ENV", "").lower() not in ("", "local"):
-        return ""
-    if os.environ.get("HERMES_SESSION_KEY") or os.environ.get("HERMES_SESSION_PLATFORM"):
-        return ""
-    session_id = str(info.get("session_id") or "").strip()
-    if not session_id:
-        return ""
-    cwd = str(info.get("cwd") or "").strip()
-    if not cwd:
-        # A set but invalid TERMINAL_CWD cannot fall back to the launch dir.
-        if os.environ.get("TERMINAL_CWD", "").strip():
-            return ""
-        try:
-            cwd = os.getcwd()
-        except OSError:
-            return ""
-    if not os.path.isdir(cwd):
-        return ""
-    worker = platform == "subagent"
-    event = "subagent-start" if worker else "session-start"
-    envelope = {"session_id": session_id, "cwd": cwd,
-                "hook_event_name": "SubagentStart" if worker else "SessionStart"}
-    try:
-        result = subprocess.run(COMMAND + ["hook", event, "--owner", "notifai", "--harness", "hermes"],
-                                input=json.dumps(envelope), text=True, capture_output=True,
-                                timeout=10, check=False)
-    except (OSError, subprocess.TimeoutExpired):
-        return ""
-    content = result.stdout.strip() if result.returncode == 0 else ""
-    if content and not worker:
-        _start_attendant(_ctx, session_id, cwd)
-    return content
-
-def register(ctx):
-    global _ctx
-    _ctx = ctx
-    ctx.register_system_prompt_section("notifai.activation", _activation,
-                                       position="after_memory", max_chars=4000)
-    ctx.register_hook("on_session_finalize", lambda session_id=None, **_: _stop_attendant(str(session_id or "")))
-    ctx.register_hook("on_session_reset", lambda session_id=None, **_: _stop_all())
-    atexit.register(_stop_all)
-`;
-}
-export function isOurHermesPlugin(dir) {
-    try {
-        if (!lstatSync(dir).isDirectory() ||
-            !lstatSync(path.join(dir, '__init__.py')).isFile() ||
-            !lstatSync(path.join(dir, 'plugin.yaml')).isFile())
-            return false;
-        return readFileSync(path.join(dir, '__init__.py'), 'utf8').startsWith(HERMES_PLUGIN_MARKER) &&
-            /^name: notifai$/m.test(readFileSync(path.join(dir, 'plugin.yaml'), 'utf8'));
-    }
-    catch {
-        return false;
-    }
-}
-function hermesCommand(args, env) {
-    const result = spawnSync('hermes', ['plugins', ...args], {
-        env, encoding: 'utf8', timeout: 30_000, maxBuffer: 256 * 1024,
-    });
-    if (result.error || result.status !== 0) {
-        throw new Error(`Hermes plugin command failed: ${result.error?.message ?? result.stderr?.trim() ?? result.stdout?.trim() ?? 'unknown error'}`);
-    }
-    return result.stdout;
-}
-export function hermesVersionSupported(env = process.env) {
-    const result = spawnSync('hermes', ['--version'], {
-        env, encoding: 'utf8', timeout: 10_000, maxBuffer: 64 * 1024,
-    });
-    return result.status === 0 && /^Hermes Agent v0\.21\.5\b/m.test(result.stdout);
-}
-export function hermesPluginListed(env = process.env) {
-    return hermesCommand(['list', '--plain', '--no-bundled'], env)
-        .split(/\r?\n/)
-        .some(line => /^enabled\s+\S+\s+\S+\s+notifai\s*$/.test(line));
-}
-export function preflightHermesPlugin(env = process.env) {
-    const installed = hermesPluginDir(env);
-    if (existsSync(installed) && !isOurHermesPlugin(installed)) {
-        throw new Error('Hermes already has a foreign plugin named notifai; leave it unchanged');
-    }
-    if (!hermesVersionSupported(env)) {
-        throw new Error('Hermes v0.21.5 is required for the proven Notifai plugin integration');
-    }
-    if (!existsSync(installed) && hermesCommand(['list', '--plain'], env)
-        .split(/\r?\n/)
-        .some(line => /^(?:enabled|disabled|not enabled)\s+\S+\s+\S+\s+notifai\s*$/.test(line))) {
-        throw new Error('Hermes already discovers a foreign plugin named notifai; leave it unchanged');
-    }
-}
-export function installHermesPlugin(adapterPath, env = process.env, nodePath) {
-    const installed = hermesPluginDir(env);
-    preflightHermesPlugin(env);
-    const source = hermesPluginSource(adapterPath, nodePath);
-    if (existsSync(installed) && readFileSync(path.join(installed, '__init__.py'), 'utf8') === source) {
-        hermesCommand(['enable', HERMES_PLUGIN_ID], env);
-    }
-    else {
-        const temp = mkdtempSync(path.join(os.tmpdir(), 'notifai-hermes-plugin-'));
-        try {
-            writeFileSync(path.join(temp, 'plugin.yaml'), 'name: notifai\nversion: "1.0.0"\ndescription: "Notifai activation and Session Attendant"\nprovides_hooks:\n  - on_session_finalize\n  - on_session_reset\n');
-            writeFileSync(path.join(temp, '__init__.py'), source);
-            const git = (args) => {
-                const result = spawnSync('git', args, { cwd: temp, env, encoding: 'utf8', timeout: 10_000 });
-                if (result.error || result.status !== 0)
-                    throw new Error(`Could not prepare Hermes plugin: ${result.error?.message ?? result.stderr?.trim() ?? 'git failed'}`);
-            };
-            git(['init', '-q']);
-            git(['add', 'plugin.yaml', '__init__.py']);
-            git(['-c', 'user.name=Notifai', '-c', 'user.email=notifai@example.invalid', 'commit', '-qm', 'plugin']);
-            hermesCommand(['install', pathToFileURL(temp).href, '--enable', '--no-deps', ...(existsSync(installed) ? ['--force'] : [])], env);
-        }
-        finally {
-            rmSync(temp, { recursive: true, force: true });
-        }
-    }
-    if (!isOurHermesPlugin(installed) || !hermesPluginListed(env)) {
-        throw new Error('Hermes did not report an enabled Notifai plugin after installation');
-    }
-    return installed;
-}
-export function uninstallHermesPlugin(env = process.env) {
-    const installed = hermesPluginDir(env);
-    if (!existsSync(installed))
-        return false;
-    if (!isOurHermesPlugin(installed))
-        throw new Error('Hermes plugin named notifai is foreign; leave it unchanged');
-    hermesCommand(['remove', HERMES_PLUGIN_ID], env);
-    if (existsSync(installed))
-        throw new Error('Hermes still has the Notifai plugin after removal');
-    return true;
-}
-export function hermesPluginCurrent(adapterHome, env) {
-    const dir = hermesPluginDir(env);
-    return isOurHermesPlugin(dir) && readFileSync(path.join(dir, '__init__.py'), 'utf8') ===
-        hermesPluginSource(hookAdapterPath(adapterHome), process.platform === 'win32' ? process.execPath : undefined);
-}
-//# sourceMappingURL=hermes-plugin.js.map

package/dist/hermes-plugin.js.map

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

package/dist/hook-acknowledgements.d.ts

@@ -1,70 +0,0 @@
-import type { AcceptedAnswerDelivery, AnsweredPending, HookContext, HookOutcome, MessageAcknowledgementDue, OwedAcknowledgement, SessionState } from './hook-types.js';
-export declare function owedAcknowledgementId(owed: OwedAcknowledgement): string;
-/** Presented messages only: queued Codex input cannot hold its preceding turn. */
-export declare function presentedMessageAcknowledgements(state: SessionState): MessageAcknowledgementDue[];
-/** Every presented acknowledgement this session still owes, request debt first. */
-export declare function owedAcknowledgements(state: SessionState): OwedAcknowledgement[];
-/** Exact queued text entering the owning Codex turn proves presentation, not action. */
-export declare function observeQueuedMessagePrompt(sessionId: string, env: NodeJS.ProcessEnv, prompt: string | undefined): string[];
-/**
- * Record the acknowledgement a Session Message is owed, before it is written:
- * an agent that acknowledges the moment it reads the message must find the
- * debt already there to clear.
- */
-export declare function recordMessageAcknowledgementDue(sessionId: string, env: NodeJS.ProcessEnv, due: MessageAcknowledgementDue): void;
-export declare function acknowledgementContext(answered: AnsweredPending[]): string;
-/**
- * Every answer that has arrived, as one message. Several registered questions
- * may resolve in one hook pass; the agent reads them together, each answer
- * tied to the question that asked it, with a truthful note about anything
- * still waiting.
- */
-export declare function answersContext(answered: AnsweredPending[], remaining: number): string;
-export declare function stopAnswerOutput(context: string): string;
-/**
- * Close, truthfully retire, and forget every answered pending question in one
- * state write, without dropping any other retirement debt or any question
- * still waiting. Stop answers also open one bounded continuation generation;
- * UserPromptSubmit answers ride the user's new turn.
- */
-export declare function stageAcceptedAnswers(ctx: HookContext, sessionId: string, answered: AnsweredPending[], remaining: number): AcceptedAnswerDelivery;
-/** Amend the live accepted record in place, without resurrecting a settled one. */
-export declare function amendAcceptedAnswers(ctx: HookContext, sessionId: string, amend: (accepted: AcceptedAnswerDelivery) => AcceptedAnswerDelivery): void;
-/**
- * Finish a route write that linearized before SessionEnd.
- *
- * Ordinary state writers stop at the ended marker. This one narrow completion
- * is allowed through because the journal's own `delivery_committed_at` proves
- * the irreversible write won the ordering first; without the matching finish,
- * a later SessionStart would replay a write that already reached the harness.
- */
-export declare function finishCommittedDelivery(ctx: HookContext, sessionId: string, accepted: AcceptedAnswerDelivery, deliveredRoute: string): void;
-export declare function classifyJournaledAcknowledgements(sessionId: string, env: NodeJS.ProcessEnv): AcceptedAnswerDelivery | undefined;
-/** Resume a queue write recorded by an earlier process without replaying it. */
-export declare function recoverQueuedAnswers(sessionId: string, env: NodeJS.ProcessEnv): void;
-/** Forget one owed acknowledgement, dispatched by identifier: `sm_…` or a request id. */
-export declare function clearAcknowledgementObligation(sessionId: string, env: NodeJS.ProcessEnv, id: string): boolean;
-export declare function acknowledgementBlockContext(due: readonly OwedAcknowledgement[]): string;
-/**
- * Hold the turn for an outstanding acknowledgement, or give up and let it
- * through once holding has stopped being worth its cost.
- *
- * Returns the outcome that blocks the turn, or `null` to carry on.
- */
-export declare function holdForAcknowledgement(ctx: HookContext, sessionId: string, due: readonly OwedAcknowledgement[], notes: string[]): HookOutcome | null;
-/** A turn that was not held resets the streak; only consecutive holds count. */
-export declare function resetAcknowledgementBlocks(sessionId: string, env: NodeJS.ProcessEnv): void;
-/**
- * Ask the service which owed acknowledgements now exist and forget those.
- * Returns what is still owed; a failed check counts as still owed.
- */
-export declare function reconcileAcknowledgementObligations<T extends OwedAcknowledgement>(ctx: HookContext, sessionId: string, due: readonly T[]): Promise<T[]>;
-/**
- * Retire the answered questions and close the journal.
- *
- * Called once an answer's delivery is acknowledged — by the route's own write,
- * or by the successor Stop of a blocking continuation. The continuation counter
- * grows with each settled generation, so the cap that bounds chained
- * answer-to-question loops is a real count rather than a constant 1.
- */
-export declare function settleAcceptedAnswers(ctx: HookContext, sessionId: string, accepted: AcceptedAnswerDelivery, cwd?: string): void;