@raidiant/notifai 9.3.0 → 10.1.0

package/dist/openclaw-plugin.js

@@ -0,0 +1,350 @@
+import path from 'node:path';
+import { hookHostPlatform } from './hook-adapter.js';
+import { harnessAccountHome } from './install-hooks.js';
+import { MISSING_LIFECYCLE_GUIDANCE_CONTEXT, WORKER_ACTIVATION_CONTEXT, } from './session-activation.js';
+/**
+ * The OpenClaw adapter.
+ *
+ * OpenClaw's extension point is an in-process Gateway plugin, not a command
+ * hook. The generated module shells out to the same `notifai hook <event>`
+ * commands every other harness invokes, so presence, activation, and
+ * retirement stay in the CLI.
+ *
+ *   before_prompt_build -> session-start / subagent-start  (first owner/worker)
+ *   message_received    -> user-prompt-submit              (User is present)
+ *   agent_end           -> stop                            (the turn ended)
+ *   session_end         -> session-end                     (retire local state)
+ *   resolve_exec_env    -> NOTIFAI_ACTIVE_* markers        (exact Source Context)
+ *
+ * `command:stop` is a User abort and is deliberately not wired. Asynchronous
+ * ask is unsupported until a live continuation probe.
+ */
+export const OPENCLAW_PLUGIN_MARKER = '// notifai managed openclaw plugin';
+export const OPENCLAW_PLUGIN_ID = 'notifai';
+export const OPENCLAW_PLUGIN_FILENAME = 'index.js';
+export const OPENCLAW_PLUGIN_MANIFEST = 'openclaw.plugin.json';
+export const OPENCLAW_PLUGIN_PACKAGE = 'package.json';
+const OPENCLAW_ADAPTER_VERSION = 1;
+export const OPENCLAW_EVENTS = [
+    ['SessionStart', 'session-start'],
+    ['SubagentStart', 'subagent-start'],
+    ['UserPromptSubmit', 'user-prompt-submit'],
+    ['Stop', 'stop'],
+    ['SessionEnd', 'session-end'],
+];
+export function openclawStateDir(env = process.env, platform = process.platform) {
+    const override = env['OPENCLAW_STATE_DIR'];
+    if (override !== undefined && override !== '')
+        return override;
+    const homeOverride = env['OPENCLAW_HOME'];
+    if (homeOverride !== undefined && homeOverride !== '') {
+        return path.join(homeOverride, '.openclaw');
+    }
+    return path.join(harnessAccountHome(env, platform), '.openclaw');
+}
+export function openclawConfigPath(env = process.env, platform = process.platform) {
+    const override = env['OPENCLAW_CONFIG_PATH'];
+    if (override !== undefined && override !== '')
+        return override;
+    return path.join(openclawStateDir(env, platform), 'openclaw.json');
+}
+export function openclawPluginDir(global, cwd, env = process.env, platform = process.platform) {
+    return global
+        ? path.join(openclawStateDir(env, platform), 'extensions', OPENCLAW_PLUGIN_ID)
+        : path.join(cwd, '.openclaw', 'extensions', OPENCLAW_PLUGIN_ID);
+}
+export function openclawPluginPath(global, cwd, env = process.env, platform = process.platform) {
+    return path.join(openclawPluginDir(global, cwd, env, platform), OPENCLAW_PLUGIN_FILENAME);
+}
+export function openclawPluginManifest() {
+    return `${JSON.stringify({
+        id: OPENCLAW_PLUGIN_ID,
+        name: 'Notifai',
+        description: 'Notifai lifecycle activation, Source Context, and session observation.',
+        activation: { onStartup: true },
+        configSchema: { type: 'object', additionalProperties: false },
+    }, null, 2)}\n`;
+}
+export function openclawPluginPackage() {
+    return `${JSON.stringify({
+        name: 'notifai-openclaw',
+        version: '1.0.0',
+        type: 'module',
+        openclaw: { extensions: [`./${OPENCLAW_PLUGIN_FILENAME}`] },
+    }, null, 2)}\n`;
+}
+export function openclawPluginSource(options) {
+    const { adapterPath, timeoutSeconds } = options;
+    const win32 = hookHostPlatform(options.platform) === 'win32';
+    const nodeConstant = win32
+        ? `const NODE = ${JSON.stringify(options.nodePath ?? process.execPath)}\n`
+        : '';
+    const spawnArguments = win32
+        ? 'NODE, [ADAPTER, "hook", event, "--owner", "notifai", "--harness", "openclaw"]'
+        : 'ADAPTER, ["hook", event, "--owner", "notifai", "--harness", "openclaw"]';
+    const windowsHide = win32 ? '\n        windowsHide: true,' : '';
+    return `${OPENCLAW_PLUGIN_MARKER}
+// Generated by \`notifai hooks install --harness openclaw\`. Edits are lost on
+// the next install; change the CLI instead, which is where the logic lives.
+import { spawn } from "node:child_process"
+
+${nodeConstant}const ADAPTER = ${JSON.stringify(adapterPath)}
+const TIMEOUT_MS = ${timeoutSeconds * 1000}
+const ADAPTER_VERSION = ${OPENCLAW_ADAPTER_VERSION}
+const MISSING_LIFECYCLE_GUIDANCE_CONTEXT = ${JSON.stringify(MISSING_LIFECYCLE_GUIDANCE_CONTEXT)}
+const WORKER_ACTIVATION_CONTEXT = ${JSON.stringify(WORKER_ACTIVATION_CONTEXT)}
+
+function runHook(event, envelope) {
+  return new Promise((resolve) => {
+    let child
+    try {
+      child = spawn(${spawnArguments}, {
+        env: process.env,
+        shell: false,${windowsHide}
+        stdio: ["pipe", "pipe", "pipe"],
+      })
+    } catch {
+      resolve(null)
+      return
+    }
+
+    let stdout = ""
+    let settled = false
+    const finish = (value) => {
+      if (settled) return
+      settled = true
+      clearTimeout(timer)
+      resolve(value)
+    }
+    const timer = setTimeout(() => {
+      child.kill("SIGTERM")
+      finish(null)
+    }, TIMEOUT_MS)
+
+    child.stdout?.setEncoding("utf-8")
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk
+    })
+    child.stderr?.resume()
+    child.on("error", () => finish(null))
+    child.on("close", () => finish(stdout))
+
+    try {
+      child.stdin?.end(JSON.stringify(envelope))
+    } catch {
+      finish(null)
+    }
+  })
+}
+
+function sessionKeyOf(event, ctx) {
+  const key = ctx?.sessionKey ?? event?.sessionKey ?? event?.context?.sessionKey
+  return typeof key === "string" ? key.trim() : ""
+}
+
+function workspaceDirOf(event, ctx) {
+  const dir = ctx?.workspaceDir ?? event?.workspaceDir ?? event?.context?.workspaceDir
+  return typeof dir === "string" && dir.length > 0 ? dir : process.cwd()
+}
+
+function isWorkerSession(sessionKey, ctx) {
+  if (sessionKey === "") return true
+  if (sessionKey.includes(":subagent:")) return true
+  if (sessionKey.includes(":acp:")) return true
+  if (ctx?.targetKind === "acp" || ctx?.dispatchKind === "acp") return true
+  if (typeof ctx?.parentSessionKey === "string" && ctx.parentSessionKey.length > 0) return true
+  return false
+}
+
+function isUserMessage(event, ctx) {
+  const from = event?.from ?? event?.context?.from ?? ctx?.senderId
+  if (typeof from !== "string" || from.trim().length === 0) return false
+  const trigger = ctx?.trigger ?? event?.trigger
+  if (trigger === "cron" || trigger === "heartbeat") return false
+  return true
+}
+
+function register(api) {
+  const activated = new Set()
+  api.on("before_prompt_build", async (event, ctx) => {
+    const sessionKey = sessionKeyOf(event, ctx)
+    if (sessionKey === "") return { prependContext: WORKER_ACTIVATION_CONTEXT }
+    if (activated.has(sessionKey)) return
+    const worker = isWorkerSession(sessionKey, ctx)
+    const resolved = await runHook(worker ? "subagent-start" : "session-start", {
+      session_id: sessionKey,
+      cwd: workspaceDirOf(event, ctx),
+      hook_event_name: worker ? "SubagentStart" : "SessionStart",
+    })
+    const context = typeof resolved === "string" && resolved.trim().length > 0
+      ? resolved.trim()
+      : worker ? WORKER_ACTIVATION_CONTEXT : MISSING_LIFECYCLE_GUIDANCE_CONTEXT
+    activated.add(sessionKey)
+    return { prependContext: context }
+  })
+
+  api.on("message_received", async (event, ctx) => {
+    if (!isUserMessage(event, ctx)) return
+    const sessionKey = sessionKeyOf(event, ctx)
+    if (sessionKey === "") return
+    await runHook("user-prompt-submit", {
+      session_id: sessionKey,
+      cwd: workspaceDirOf(event, ctx),
+      hook_event_name: "UserPromptSubmit",
+    })
+  })
+
+  api.on("agent_end", async (event, ctx) => {
+    const sessionKey = sessionKeyOf(event, ctx)
+    if (sessionKey === "") return
+    await runHook("stop", {
+      session_id: sessionKey,
+      cwd: workspaceDirOf(event, ctx),
+      hook_event_name: "Stop",
+    })
+  })
+
+  api.on("session_end", async (event, ctx) => {
+    const sessionKey = sessionKeyOf(event, ctx)
+    if (sessionKey === "") return
+    activated.delete(sessionKey)
+    await runHook("session-end", {
+      session_id: sessionKey,
+      cwd: workspaceDirOf(event, ctx),
+      hook_event_name: "SessionEnd",
+    })
+  })
+
+  api.on("resolve_exec_env", (event, ctx) => {
+    const sessionKey = sessionKeyOf(event, ctx)
+    if (sessionKey === "") return
+    return {
+      NOTIFAI_ACTIVE_HARNESS: "openclaw",
+      NOTIFAI_ACTIVE_SESSION_ID: sessionKey,
+    }
+  })
+}
+
+export default {
+  id: ${JSON.stringify(OPENCLAW_PLUGIN_ID)},
+  name: "Notifai",
+  register,
+}
+`;
+}
+export function isOurOpenclawPlugin(contents) {
+    return contents.includes(OPENCLAW_PLUGIN_MARKER);
+}
+export function openclawPluginTarget(contents) {
+    if (!isOurOpenclawPlugin(contents))
+        return null;
+    const adapter = /^const ADAPTER = (".*")$/m.exec(contents)?.[1];
+    const node = /^const NODE = (".*")$/m.exec(contents)?.[1];
+    const version = Number(/^const ADAPTER_VERSION = (\d+)$/m.exec(contents)?.[1] ?? 0);
+    const timeoutMs = Number(/^const TIMEOUT_MS = (\d+)$/m.exec(contents)?.[1] ?? Number.NaN);
+    if (adapter === undefined)
+        return null;
+    try {
+        return {
+            adapter: JSON.parse(adapter),
+            current: version === OPENCLAW_ADAPTER_VERSION,
+            ...(Number.isFinite(timeoutMs) ? { timeoutSeconds: timeoutMs / 1000 } : {}),
+            ...(node === undefined ? {} : { nodePath: JSON.parse(node) }),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function parseOpenclawConfig(source) {
+    try {
+        const parsed = JSON.parse(source);
+        if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        const stripped = source
+            .replace(/\/\*[\s\S]*?\*\//g, '')
+            .replace(/^\s*\/\/.*$/gm, '')
+            .replace(/,(\s*[}\]])/g, '$1');
+        const parsed = JSON.parse(stripped);
+        if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    throw new Error('OpenClaw config is not a JSON object');
+}
+export function mergeOpenclawNotifaiEntry(config, pluginDir, global) {
+    const plugins = config.plugins !== null && typeof config.plugins === 'object' && !Array.isArray(config.plugins)
+        ? { ...config.plugins }
+        : {};
+    const entries = plugins.entries !== null && typeof plugins.entries === 'object' && !Array.isArray(plugins.entries)
+        ? { ...plugins.entries }
+        : {};
+    const existing = entries[OPENCLAW_PLUGIN_ID] !== null &&
+        typeof entries[OPENCLAW_PLUGIN_ID] === 'object' &&
+        !Array.isArray(entries[OPENCLAW_PLUGIN_ID])
+        ? { ...entries[OPENCLAW_PLUGIN_ID] }
+        : {};
+    const hooks = existing.hooks !== null && typeof existing.hooks === 'object' && !Array.isArray(existing.hooks)
+        ? { ...existing.hooks }
+        : {};
+    entries[OPENCLAW_PLUGIN_ID] = {
+        ...existing,
+        enabled: true,
+        hooks: { ...hooks, allowConversationAccess: true },
+    };
+    plugins.entries = entries;
+    if (!global) {
+        const load = plugins.load !== null && typeof plugins.load === 'object' && !Array.isArray(plugins.load)
+            ? { ...plugins.load }
+            : {};
+        const paths = Array.isArray(load.paths) ? [...load.paths] : [];
+        if (!paths.includes(pluginDir))
+            paths.push(pluginDir);
+        load.paths = paths;
+        plugins.load = load;
+    }
+    return { ...config, plugins };
+}
+export function removeOpenclawNotifaiEntry(config, pluginDir) {
+    const plugins = config.plugins !== null && typeof config.plugins === 'object' && !Array.isArray(config.plugins)
+        ? { ...config.plugins }
+        : {};
+    const entries = plugins.entries !== null && typeof plugins.entries === 'object' && !Array.isArray(plugins.entries)
+        ? { ...plugins.entries }
+        : {};
+    delete entries[OPENCLAW_PLUGIN_ID];
+    if (Object.keys(entries).length > 0)
+        plugins.entries = entries;
+    else
+        delete plugins.entries;
+    const load = plugins.load !== null && typeof plugins.load === 'object' && !Array.isArray(plugins.load)
+        ? { ...plugins.load }
+        : {};
+    if (Array.isArray(load.paths)) {
+        const paths = load.paths.filter((value) => value !== pluginDir);
+        if (paths.length > 0)
+            load.paths = paths;
+        else
+            delete load.paths;
+    }
+    if (Object.keys(load).length > 0)
+        plugins.load = load;
+    else
+        delete plugins.load;
+    if (Object.keys(plugins).length > 0)
+        return { ...config, plugins };
+    const next = { ...config };
+    delete next.plugins;
+    return next;
+}
+/** Config-directory presence is not ownership. These files mean OpenClaw is actually configured. */
+export function openclawHasGlobalEvidence(exists, env = process.env, platform = process.platform) {
+    const state = openclawStateDir(env, platform);
+    return (exists(openclawConfigPath(env, platform)) ||
+        exists(path.join(state, 'agents')) ||
+        exists(path.join(state, 'workspace')));
+}
+//# sourceMappingURL=openclaw-plugin.js.map

package/dist/openclaw-plugin.js.map

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

package/dist/orca-session-title.d.ts

@@ -0,0 +1,10 @@
+export type OrcaSessionTitleLookup = (env: NodeJS.ProcessEnv) => string | undefined;
+export type OrcaCommand = (executable: string, args: readonly string[]) => string | null;
+/**
+ * Read the User-facing task name assigned to this exact Orca worktree.
+ *
+ * The environment contributes only an opaque selector. Orca must return that
+ * exact id and its matching path before its display name becomes trusted; no
+ * path component or identifier is ever promoted into an Agent Session label.
+ */
+export declare function readOrcaSessionTitle(env: NodeJS.ProcessEnv, command?: OrcaCommand): string | undefined;

package/dist/orca-session-title.js

@@ -0,0 +1,98 @@
+import { execFileSync } from 'node:child_process';
+import path from 'node:path';
+const runOrcaCommand = (executable, args) => {
+    try {
+        return execFileSync(executable, args, {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 2_000,
+            maxBuffer: 512 * 1024,
+            windowsHide: true,
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+};
+function containsControlCharacter(value) {
+    return Array.from(value).some((character) => {
+        const codePoint = character.codePointAt(0) ?? 0;
+        return codePoint < 32 || codePoint === 127;
+    });
+}
+function worktreePathFromId(value) {
+    if (value.length === 0 || value.length > 4_096 || containsControlCharacter(value))
+        return null;
+    const separator = value.indexOf('::');
+    if (separator <= 0)
+        return null;
+    const repoId = value.slice(0, separator);
+    const worktreePath = value.slice(separator + 2);
+    if (!/^[A-Za-z0-9._-]+$/u.test(repoId) || worktreePath.length === 0)
+        return null;
+    return path.posix.isAbsolute(worktreePath) || path.win32.isAbsolute(worktreePath)
+        ? worktreePath
+        : null;
+}
+function orcaExecutable(env) {
+    const configured = env['ORCA_CLI_COMMAND']?.trim();
+    if (configured !== undefined && configured.length > 0) {
+        return containsControlCharacter(configured) ? null : configured;
+    }
+    return env['ORCA_DEV_REPO_ROOT'] === undefined ? 'orca' : 'orca-dev';
+}
+/**
+ * Read the User-facing task name assigned to this exact Orca worktree.
+ *
+ * The environment contributes only an opaque selector. Orca must return that
+ * exact id and its matching path before its display name becomes trusted; no
+ * path component or identifier is ever promoted into an Agent Session label.
+ */
+export function readOrcaSessionTitle(env, command = runOrcaCommand) {
+    if (env['TERM_PROGRAM'] !== 'Orca')
+        return undefined;
+    const worktreeId = env['ORCA_WORKTREE_ID'];
+    if (worktreeId === undefined)
+        return undefined;
+    const expectedPath = worktreePathFromId(worktreeId);
+    if (expectedPath === null)
+        return undefined;
+    const executable = orcaExecutable(env);
+    if (executable === null)
+        return undefined;
+    let output;
+    try {
+        output = command(executable, [
+            'worktree',
+            'show',
+            '--worktree',
+            `id:${worktreeId}`,
+            '--json',
+        ]);
+    }
+    catch {
+        return undefined;
+    }
+    if (output === null || output === '')
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(output);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const response = parsed;
+    const worktree = response.result?.worktree;
+    if (response.ok !== true ||
+        worktree?.id !== worktreeId ||
+        worktree.path !== expectedPath ||
+        typeof worktree.displayName !== 'string' ||
+        worktree.displayName.trim().length === 0) {
+        return undefined;
+    }
+    return worktree.displayName;
+}
+//# sourceMappingURL=orca-session-title.js.map

package/dist/orca-session-title.js.map

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

package/dist/program.d.ts

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { acknowledgeCommand, askCommand, accessStatusCommand, authStatusCommand, capabilitiesCommand, closeCommand, configExplainCommand, configSetCommand, configShowCommand, configUnsetCommand, devicesCommand, doctorCommand, guidanceSetCommand, guidanceShowCommand, guidanceUnsetCommand, hookRunCommand, hooksInstallCommand, hooksUninstallCommand, initCommand, loginCommand, logoutCommand, projectDisableCommand, projectEnableCommand, projectStatusCommand, logsCommand, repliesCommand, sendCommand, statusCommand, type CommandDeps } from './commands.js';
+import { acknowledgeCommand, askCommand, accessStatusCommand, agentSessionRenameCommand, authStatusCommand, capabilitiesCommand, closeCommand, configExplainCommand, configSetCommand, configShowCommand, configUnsetCommand, devicesCommand, doctorCommand, guidanceSetCommand, guidanceShowCommand, guidanceUnsetCommand, hookRunCommand, hooksInstallCommand, hooksUninstallCommand, initCommand, loginCommand, logoutCommand, projectDisableCommand, projectEnableCommand, projectStatusCommand, logsCommand, repliesCommand, sendCommand, soundsCommand, statusCommand, type CommandDeps } from './commands.js';
 /**
  * Every command implementation the tree dispatches to, injectable so a test
  * can parse real argv and assert the exact flags a command would receive —
@@ -14,10 +14,12 @@ declare const defaultRunners: {
     authStatus: typeof authStatusCommand;
     accessStatus: typeof accessStatusCommand;
     devices: typeof devicesCommand;
+    sounds: typeof soundsCommand;
     capabilities: typeof capabilitiesCommand;
     projectEnable: typeof projectEnableCommand;
     projectDisable: typeof projectDisableCommand;
     projectStatus: typeof projectStatusCommand;
+    agentSessionRename: typeof agentSessionRenameCommand;
     send: typeof sendCommand;
     replies: typeof repliesCommand;
     acknowledge: typeof acknowledgeCommand;

package/dist/program.js

@@ -1,8 +1,8 @@
 import { readFileSync } from 'node:fs';
 import { Command } from 'commander';
-import { acknowledgeCommand, askCommand, accessStatusCommand, authStatusCommand, capabilitiesCommand, closeCommand, configExplainCommand, configSetCommand, configShowCommand, configUnsetCommand, devicesCommand, doctorCommand, guidanceSetCommand, guidanceShowCommand, guidanceUnsetCommand, hookDefersDiagnosticsUntilAfterCleanup, hookRunCommand, hooksInstallCommand, hooksUninstallCommand, initCommand, loginCommand, logoutCommand, projectDisableCommand, projectEnableCommand, projectStatusCommand, logsCommand, repliesCommand, reportAskFailure, sendCommand, statusCommand, } from './commands.js';
+import { acknowledgeCommand, askCommand, accessStatusCommand, agentSessionRenameCommand, authStatusCommand, capabilitiesCommand, closeCommand, configExplainCommand, configSetCommand, configShowCommand, configUnsetCommand, devicesCommand, doctorCommand, guidanceSetCommand, guidanceShowCommand, guidanceUnsetCommand, hookDefersDiagnosticsUntilAfterCleanup, hookRunCommand, hooksInstallCommand, hooksUninstallCommand, initCommand, loginCommand, logoutCommand, projectDisableCommand, projectEnableCommand, projectStatusCommand, logsCommand, repliesCommand, reportAskFailure, sendCommand, soundsCommand, statusCommand, } from './commands.js';
 import { packageVersion } from './release.js';
-import { HARNESSES } from './install-hooks.js';
+import { HOOK_INSTALLABLE_HARNESSES } from './harnesses.js';
 import { GROUP, SEND_GROUP, helpConfiguration, rootHelpFooter } from './ui/help.js';
 import { readStdinWithTimeout } from './hook-input.js';
 import { argvFlagNames } from './logging.js';
@@ -46,10 +46,12 @@ const defaultRunners = {
     authStatus: authStatusCommand,
     accessStatus: accessStatusCommand,
     devices: devicesCommand,
+    sounds: soundsCommand,
     capabilities: capabilitiesCommand,
     projectEnable: projectEnableCommand,
     projectDisable: projectDisableCommand,
     projectStatus: projectStatusCommand,
+    agentSessionRename: agentSessionRenameCommand,
     send: sendCommand,
     replies: repliesCommand,
     acknowledge: acknowledgeCommand,
@@ -126,11 +128,12 @@ export function buildProgram(deps, options = {}) {
     /**
      * Bare `notifai`.
      *
-     * At a human terminal this opens the interactive app; anywhere else it prints
-     * help exactly as before. The check is the same one every other prompt in this
-     * CLI is gated on — stdin and stdout both TTYs, not CI, `NOTIFAI_NO_INPUT`
-     * unset — because an agent that reaches a prompt does not fail, it hangs
-     * for ever waiting on a stdin nobody is typing into.
+     * At a human terminal this opens the interactive app, which enters `init`
+     * when the machine is not yet paired and otherwise offers daily actions.
+     * Anywhere else it prints help exactly as before. The check is the same one
+     * every other prompt in this CLI is gated on — stdin and stdout both TTYs,
+     * not CI, `NOTIFAI_NO_INPUT` unset — because an agent that reaches a prompt
+     * does not fail, it hangs for ever waiting on a stdin nobody is typing into.
      */
     /**
      * An unrecognised subcommand reaches the root as an excess argument, and
@@ -198,9 +201,21 @@ export function buildProgram(deps, options = {}) {
     project.command('status').description('Show lifecycle enablement for this Project').option('--json').action((opts) => {
         exit(runners.projectStatus(deps, opts.json === true));
     });
+    const session = program
+        .command('session')
+        .helpGroup(GROUP.agent)
+        .summary('Inspect or rename the current Agent Session')
+        .description('Operate on the exact Agent Session owned by the active harness');
+    session
+        .command('rename <label>')
+        .description('Rename this exact Agent Session; agents use this only after its job changes completely enough that the old label would mislead')
+        .option('--json', 'machine-readable output')
+        .action(async (label, opts) => {
+        exit(await runners.agentSessionRename(deps, label, opts));
+    });
     program
         .command('login')
-        .helpGroup(GROUP.start)
+        .helpGroup(GROUP.advanced)
         .summary('Sign in and pair this machine')
         .description('Pair this machine with your Notifai account via browser approval')
         .option('--name <name>', 'machine name shown in the dashboard (default: hostname)')
@@ -246,6 +261,15 @@ export function buildProgram(deps, options = {}) {
         .action(async (opts) => {
         exit(await runners.devices(deps, opts));
     });
+    program
+        .command('sounds')
+        .helpGroup(GROUP.daily)
+        .summary('List shipped and Account custom sounds')
+        .description('List the sounds --sound and the saved sound key accept: shipped names and this Account\'s custom sounds')
+        .option('--json', 'machine-readable output')
+        .action(async (opts) => {
+        exit(await runners.sounds(deps, opts));
+    });
     program
         .command('capabilities')
         .helpGroup(GROUP.advanced)
@@ -289,7 +313,7 @@ export function buildProgram(deps, options = {}) {
         .option('--choice <label>', 'with --reply, ask a closed question; repeat the flag once per answer (2-6)', (v, all = []) => [...all, v])
         .option('--multi', 'with --choice, several answers may be selected')
         .optionsGroup(SEND_GROUP.advanced)
-        .option('--sound <sound>', 'override saved sound: default | done | attention | alert | none')
+        .option('--sound <sound>', 'override saved sound: default | done | attention | alert | none, or a custom name or id from notifai sounds')
         .option('--level <level>', 'Apple-only interruption level: passive | active | time_sensitive (unsupported with --platform android)')
         .option('--wait <seconds>', 'how long to wait for provider outcomes', (v) => Number(v))
         .option('--no-wait', 'return immediately after acceptance')
@@ -330,7 +354,7 @@ export function buildProgram(deps, options = {}) {
             flags.wait = wait;
         exit(await runners.send(deps, flags));
     });
-    send.addHelpText('after', `\nKind is required, and it selects the sound the notification arrives with: done rings the completion chime, failed the most insistent tone, blocked and question a distinct attention tone, update the standard one.\nAn explicit --sound or saved sound preference outranks that default. --level is Apple-only; Android attention is owned by kind, product channels, and device settings.\n`);
+    send.addHelpText('after', `\nKind is required, and it selects the sound the notification arrives with: done rings the completion chime, failed the most insistent tone, blocked and question a distinct attention tone, update Device default.\nAn explicit --sound or saved sound preference outranks that default. --sound accepts a shipped name, an Account custom sound name or id from \`notifai sounds\`, or none. --level is Apple-only; Android attention is owned by kind, product channels, and device settings.\n`);
     program
         .command('replies [request_id]')
         .helpGroup(GROUP.agent)
@@ -449,7 +473,7 @@ export function buildProgram(deps, options = {}) {
         .option('--owner <name>', 'internal ownership marker')
         .option('--harness <name>', 'internal harness output adapter')
         .action(async (event, opts) => {
-        const harness = HARNESSES.find((candidate) => candidate === opts.harness);
+        const harness = HOOK_INSTALLABLE_HARNESSES.find((candidate) => candidate === opts.harness);
         exit(await runners.hookRun(deps, event, () => readStdinWithTimeout(), harness));
     });
     const hooks = program
@@ -460,7 +484,7 @@ export function buildProgram(deps, options = {}) {
     hooks
         .command('install')
         .description('Wire this harness to route registered questions to your devices')
-        .option('--harness <name>', 'claude-code | codex | cursor | opencode (default: every detected harness)')
+        .option('--harness <name>', 'claude-code | codex | cursor | opencode | openclaw (default: every detected harness)')
         .option('--global', 'install for every project instead of just this one')
         .action((opts) => {
         exit(runners.hooksInstall(deps, opts));
@@ -468,7 +492,7 @@ export function buildProgram(deps, options = {}) {
     hooks
         .command('uninstall')
         .description('Remove the hooks this CLI installed')
-        .option('--harness <name>', 'claude-code | codex | cursor | opencode (default: detected)')
+        .option('--harness <name>', 'claude-code | codex | cursor | opencode | openclaw (default: detected)')
         .option('--global', 'remove the machine-wide install')
         .action((opts) => {
         exit(runners.hooksUninstall(deps, opts));