@raidiant/notifai 4.0.0 → 6.0.0

package/dist/commands-config.js

@@ -0,0 +1,246 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import path from 'node:path';
+import { parse as parseToml, stringify as stringifyToml } from 'smol-toml';
+import { acceptedValues, configInfo } from './config-schema.js';
+import { BOOLEAN_CONFIG_KEYS, CONFIG_KEYS, NUMERIC_CONFIG_KEYS, configBounds, configDefaultValue, findProjectConfigPath, globalConfigPath, personalProjectConfigPath, sessionConfigPath, } from './config.js';
+import { renderConfigExplain, renderConfigList, renderConfigPlain } from './ui/config-view.js';
+import { EXIT, loadLoggedConfig } from './commands-core.js';
+// ---------------------------------------------------------------------------
+// config show / set / unset
+// ---------------------------------------------------------------------------
+export function configShowCommand(deps, flags) {
+    const config = loadLoggedConfig(deps, { cwd: deps.cwd, env: deps.env });
+    if (flags.json) {
+        const output = Object.fromEntries(CONFIG_KEYS.map((key) => [
+            key,
+            {
+                value: config[key].value,
+                source: config[key].source,
+                summary: configInfo(key).summary,
+            },
+        ]));
+        deps.io.out(JSON.stringify(output, null, 2));
+        return EXIT.ok;
+    }
+    // Anything that is not a person at a terminal keeps the flat `key = value`
+    // form it has always had. Scripts parse this, and a prettier layout for an
+    // audience that cannot see it would only be a breaking change.
+    if (deps.io.interactive !== true || flags.plain === true) {
+        for (const line of renderConfigPlain(config, flags.explain === true))
+            deps.io.out(line);
+        return EXIT.ok;
+    }
+    for (const line of renderConfigList(config, { showAdvanced: flags.explain === true })) {
+        deps.io.out(line);
+    }
+    return EXIT.ok;
+}
+/**
+ * One setting, explained in full.
+ *
+ * The gap this closes: `config show` prints a value and provenance but that is
+ * not enough to explain the setting's consequences. Every key already had a
+ * careful explanation — in a TypeScript comment, read by everyone except the
+ * person who needed it.
+ */
+export function configExplainCommand(deps, key, flags = {}) {
+    if (!CONFIG_KEYS.includes(key)) {
+        deps.io.err(`Unknown setting "${key}".`);
+        deps.io.err(`Valid settings: ${CONFIG_KEYS.join(', ')}`);
+        return EXIT.usage;
+    }
+    const configKey = key;
+    const config = loadLoggedConfig(deps, { cwd: deps.cwd, env: deps.env });
+    const info = configInfo(configKey);
+    const entry = config[configKey];
+    if (flags.json) {
+        deps.io.out(JSON.stringify({
+            key: configKey,
+            label: info.label,
+            group: info.group,
+            kind: info.kind,
+            summary: info.summary,
+            detail: info.detail,
+            accepts: acceptedValues(configKey),
+            ...(info.choices !== undefined ? { choices: info.choices } : {}),
+            value: entry.value,
+            source: entry.source,
+        }, null, 2));
+        return EXIT.ok;
+    }
+    if (deps.io.interactive !== true) {
+        deps.io.out(`${configKey} = ${JSON.stringify(entry.value)}  [${entry.source}]`);
+        deps.io.out(info.detail.replace(/\n\n/g, '\n'));
+        deps.io.out(`accepts: ${acceptedValues(configKey)}`);
+        return EXIT.ok;
+    }
+    for (const line of renderConfigExplain(configKey, config))
+        deps.io.out(line);
+    return EXIT.ok;
+}
+/**
+ * Closest config key by edit distance, or null when nothing is close.
+ *
+ * The threshold matters more than the algorithm: suggesting a key that shares
+ * three letters with the typo sends the reader to the wrong setting with
+ * confidence, which is worse than listing all fourteen and letting them look.
+ */
+function nearestKey(input) {
+    let best = null;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const candidate of CONFIG_KEYS) {
+        const distance = editDistance(input.toLowerCase(), candidate);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            best = candidate;
+        }
+    }
+    return best !== null && bestDistance <= Math.max(2, Math.floor(best.length / 3)) ? best : null;
+}
+function editDistance(a, b) {
+    const previous = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i += 1) {
+        let diagonal = previous[0];
+        previous[0] = i;
+        for (let j = 1; j <= b.length; j += 1) {
+            const above = previous[j];
+            previous[j] = Math.min(previous[j] + 1, previous[j - 1] + 1, diagonal + (a[i - 1] === b[j - 1] ? 0 : 1));
+            diagonal = above;
+        }
+    }
+    return previous[b.length];
+}
+export async function configSetCommand(deps, key, rawValue, flags) {
+    const configKey = configMutationKey(deps, key);
+    if (configKey === null)
+        return EXIT.usage;
+    const info = configInfo(configKey);
+    let value = rawValue;
+    if (NUMERIC_CONFIG_KEYS.includes(configKey)) {
+        const numeric = Number(rawValue);
+        if (!Number.isInteger(numeric)) {
+            deps.io.err(`${key} takes ${acceptedValues(configKey)}, not "${rawValue}".`);
+            return EXIT.usage;
+        }
+        const bounds = configBounds(configKey);
+        if (bounds !== undefined && (numeric < bounds.min || numeric > bounds.max)) {
+            deps.io.err(`${key} must be between ${bounds.min} and ${bounds.max}.`);
+            return EXIT.usage;
+        }
+        value = numeric;
+    }
+    if (BOOLEAN_CONFIG_KEYS.includes(configKey)) {
+        if (rawValue !== 'true' && rawValue !== 'false') {
+            deps.io.err(`${key} is a toggle — pass "true" or "false", not "${rawValue}".`);
+            return EXIT.usage;
+        }
+        value = rawValue === 'true';
+    }
+    // Enum keys were accepted unchecked, so `config set sound whatever` wrote a
+    // value the sender would later reject — a typo that only surfaces at the
+    // moment a notification fails to carry the sound you asked for.
+    if (info.kind === 'enum' && info.choices !== undefined && !info.choices.includes(rawValue)) {
+        deps.io.err(`${key} takes one of: ${info.choices.join(', ')} — not "${rawValue}".`);
+        return EXIT.usage;
+    }
+    if (key === 'devices')
+        value = rawValue.split(',').map((s) => s.trim()).filter(Boolean);
+    const target = await configMutationTarget(deps, flags);
+    if (target === null)
+        return EXIT.usage;
+    if (target.layer === 'global' && Object.is(value, configDefaultValue(configKey))) {
+        deps.io.err(`${key} is already the shipped default (${JSON.stringify(value)}).`);
+        deps.io.err(`Run \`notifai config unset ${key} --yes\` to remove a redundant override instead of creating one.`);
+        return EXIT.usage;
+    }
+    if (!flags.yes) {
+        const confirmed = await deps.io.confirm(`Set ${key} = ${JSON.stringify(value)} in ${target.path}?`);
+        if (!confirmed) {
+            deps.io.err('Not confirmed. Pass --yes to skip the confirmation gate.');
+            return EXIT.usage;
+        }
+    }
+    const existing = existsSync(target.path)
+        ? parseToml(readFileSync(target.path, 'utf8'))
+        : {};
+    existing[key] = value;
+    mkdirSync(path.dirname(target.path), { recursive: true });
+    writeFileSync(target.path, `${stringifyToml(existing)}\n`);
+    deps.io.out(`Wrote ${key} to ${target.path}`);
+    return EXIT.ok;
+}
+function configMutationKey(deps, key) {
+    if (!CONFIG_KEYS.includes(key)) {
+        deps.io.err(`Unknown setting "${key}".`);
+        const near = nearestKey(key);
+        if (near !== null)
+            deps.io.err(`Did you mean "${near}"?`);
+        deps.io.err(`Valid settings: ${CONFIG_KEYS.join(', ')}`);
+        deps.io.err('Run `notifai config explain <key>` to see what one of them does.');
+        return null;
+    }
+    return key;
+}
+async function configMutationTarget(deps, flags) {
+    let layer = flags.local ? 'local' : flags.project ? 'project' : 'global';
+    if (flags.session === undefined &&
+        flags.local !== true &&
+        flags.project !== true &&
+        flags.yes !== true &&
+        deps.io.interactive === true &&
+        deps.io.select) {
+        const selected = await deps.io.select('Where should this setting live?', [
+            { value: 'global', label: 'This machine', hint: 'applies across projects' },
+            { value: 'project', label: 'This project (shared)', hint: '.notifai/config.toml' },
+            { value: 'local', label: 'This project (personal)', hint: 'stored on this machine, not in the repo' },
+        ]);
+        if (selected === null) {
+            deps.io.err('No configuration layer selected.');
+            return null;
+        }
+        layer = selected;
+    }
+    const targetPath = flags.session
+        ? sessionConfigPath(flags.session, deps.env)
+        : layer === 'local'
+            ? personalProjectConfigPath(deps.cwd, deps.env)
+            : layer === 'project'
+                ? (findProjectConfigPath(deps.cwd) ?? path.join(deps.cwd, '.notifai', 'config.toml'))
+                : globalConfigPath(deps.env);
+    return {
+        path: targetPath,
+        layer: flags.session ? 'session' : layer,
+    };
+}
+export async function configUnsetCommand(deps, key, flags) {
+    const configKey = configMutationKey(deps, key);
+    if (configKey === null)
+        return EXIT.usage;
+    const target = await configMutationTarget(deps, flags);
+    if (target === null)
+        return EXIT.usage;
+    const existing = existsSync(target.path)
+        ? parseToml(readFileSync(target.path, 'utf8'))
+        : {};
+    if (!Object.prototype.hasOwnProperty.call(existing, configKey)) {
+        deps.io.out(`${configKey} is not set in ${target.path}`);
+        return EXIT.ok;
+    }
+    if (!flags.yes) {
+        const confirmed = await deps.io.confirm(`Remove ${configKey} from ${target.path}?`);
+        if (!confirmed) {
+            deps.io.err('Not confirmed. Pass --yes to skip the confirmation gate.');
+            return EXIT.usage;
+        }
+    }
+    delete existing[configKey];
+    if (Object.keys(existing).length === 0) {
+        rmSync(target.path, { force: true });
+    }
+    else {
+        writeFileSync(target.path, `${stringifyToml(existing)}\n`);
+    }
+    deps.io.out(`Removed ${configKey} from ${target.path}; the inherited value now applies.`);
+    return EXIT.ok;
+}
+//# sourceMappingURL=commands-config.js.map

package/dist/commands-config.js.map

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

package/dist/commands-core.d.ts

@@ -0,0 +1,102 @@
+import { type ClaudeWakeAdapters } from './claude-wake.js';
+import { type ApiClient, type ClientOptions } from './client.js';
+import { type CodexWakeAdapters } from './codex-wake.js';
+import { loadConfig, type CliConfig } from './config.js';
+import type { CredentialStore, MachineCredential } from './credentials.js';
+import { type HookAdapterTarget } from './hook-adapter.js';
+import { type Logger } from './logging.js';
+import type { NativeSkills } from './native-skills.js';
+import type { Tone } from './ui/theme.js';
+export interface CommandIo {
+    out(line: string): void;
+    err(line: string): void;
+    /** Interactive confirmation; resolves `fallback` (default false) when not interactive. */
+    confirm(question: string, fallback?: boolean): Promise<boolean>;
+    openUrl(url: string): void;
+    /**
+     * True only when a human is demonstrably driving a terminal. Everything below
+     * is optional sugar that MUST only be called behind this flag: an agent that
+     * reaches an interactive prompt does not error, it hangs — the prompt
+     * libraries wait on stdin for ever — so the gate is bypass, not handling.
+     * Test fakes leave all of this undefined and exercise the plain paths.
+     */
+    interactive?: boolean;
+    select?(message: string, options: {
+        value: string;
+        label: string;
+        hint?: string;
+    }[]): Promise<string | null>;
+    /** Interactive multi-select. `initial` are pre-selected values. */
+    multiselect?(message: string, options: {
+        value: string;
+        label: string;
+        hint?: string;
+    }[], initial?: string[]): Promise<string[] | null>;
+    intro?(title: string): Promise<void>;
+    outro?(message: string): Promise<void>;
+    note?(message: string, title?: string): Promise<void>;
+    spinner?(message: string): Promise<CommandSpinner | null>;
+    /**
+     * A report line. `tone` distinguishes the two states that are neither pass
+     * nor fail — something optional the user declined, and something that was
+     * never evaluated — which a boolean has to round to one or the other.
+     * Optional so existing implementations keep type-checking.
+     */
+    check?(ok: boolean, message: string, tone?: Tone): Promise<void>;
+}
+export interface CommandSpinner {
+    message(message: string): void;
+    stop(message: string): void;
+    error(message: string): void;
+}
+export interface CommandDeps {
+    io: CommandIo;
+    store: CredentialStore;
+    env: NodeJS.ProcessEnv;
+    cwd: string;
+    /** Test seam; production fixes the hook adapter under os.homedir(). */
+    hookAdapterHome?: string;
+    /** Test seam; production uses this process's Node and CLI paths. */
+    hookInstallTarget?: HookAdapterTarget;
+    /** Test seam; production uses process.platform for adapter format and quoting. */
+    hookPlatform?: NodeJS.Platform;
+    /** Test seam; production uses fetch against base_url. */
+    clientFactory?: (baseUrl: string, bearer: string | null, options?: ClientOptions) => ApiClient;
+    /** Test seam for bounded polling without wall-clock sleeps. */
+    now?: () => number;
+    /** Test seam for retry/backoff timing. */
+    sleep?: (milliseconds: number) => Promise<void>;
+    /** Test seams for Claude liveness, socket delivery, and cold resume. */
+    claudeWake?: ClaudeWakeAdapters;
+    claudeSourcePid?: number;
+    /** Test seams for the Codex thread-writer probe and cold resume. */
+    codexWake?: CodexWakeAdapters;
+    codexSourcePid?: number;
+    /** Test seam and production adapter for the external native skills installer. */
+    nativeSkills?: NativeSkills;
+    /**
+     * The local record of what this invocation did. Optional so a test fake need
+     * not carry one; `log(deps)` supplies a logger that records nothing.
+     */
+    logger?: Logger;
+}
+/** The invocation's logger, or one that discards everything. */
+export declare function log(deps: CommandDeps): Logger;
+export declare function loadLoggedConfig(deps: CommandDeps, options: Parameters<typeof loadConfig>[0]): CliConfig;
+export declare const EXIT: {
+    readonly ok: 0;
+    readonly failed: 1;
+    readonly usage: 2;
+    readonly noReply: 3;
+    readonly auth: 4;
+    readonly network: 5;
+};
+export declare function makeClient(deps: CommandDeps, baseUrl: string, bearer: string | null, options?: ClientOptions): ApiClient;
+export declare function resolvedBaseUrl(config: CliConfig, credential: MachineCredential | null): string;
+export declare function authedClient(deps: CommandDeps, config: CliConfig): {
+    client: ApiClient;
+    baseUrl: string;
+} | null;
+export declare const UPDATE_CLI_COMMAND = "npm install -g @raidiant/notifai";
+export declare function reportError(deps: CommandDeps, err: unknown, context?: Record<string, unknown>): number;
+export declare function rejectedPaths(details: unknown): string[];

package/dist/commands-core.js

@@ -0,0 +1,135 @@
+import { SHIPPED_CLI_CAPABILITIES } from '@raidiant/notifai-protocol';
+import {} from './claude-wake.js';
+import { ApiCallError, NetworkError, createClient, } from './client.js';
+import {} from './codex-wake.js';
+import { loadConfig } from './config.js';
+import {} from './hook-adapter.js';
+import { logConfigResolved, logSettingsFrom, nullLogger } from './logging.js';
+import { packageVersion } from './release.js';
+/** The invocation's logger, or one that discards everything. */
+export function log(deps) {
+    return deps.logger ?? nullLogger();
+}
+export function loadLoggedConfig(deps, options) {
+    const config = loadConfig(options);
+    const logger = log(deps);
+    logger.adopt(logSettingsFrom(config));
+    logger.bind({ project: config.project.value });
+    logConfigResolved(logger, config);
+    return config;
+}
+export const EXIT = {
+    ok: 0,
+    failed: 1,
+    usage: 2,
+    noReply: 3,
+    auth: 4,
+    network: 5,
+};
+export function makeClient(deps, baseUrl, bearer, options) {
+    return (deps.clientFactory ?? createClient)(baseUrl, bearer, {
+        ...options,
+        logger: log(deps),
+        cliVersion: packageVersion(),
+        capabilities: SHIPPED_CLI_CAPABILITIES,
+    });
+}
+export function resolvedBaseUrl(config, credential) {
+    return config.base_url.source === 'default' && credential ? credential.baseUrl : config.base_url.value;
+}
+export function authedClient(deps, config) {
+    const credential = deps.store.load();
+    if (!credential) {
+        // The commonest reason a command does nothing, and one that leaves no other
+        // trace: it returns before any request is made, so without this the log
+        // shows an exit code and no cause.
+        log(deps).error('cli.error', { kind: 'auth', message: 'not signed in', store: deps.store.describe() });
+        deps.io.err('Not signed in. Run `notifai login` first.');
+        return null;
+    }
+    const baseUrl = resolvedBaseUrl(config, credential);
+    return {
+        client: makeClient(deps, baseUrl, `Bearer nfm_${credential.machineId}.${credential.secret}`),
+        baseUrl,
+    };
+}
+export const UPDATE_CLI_COMMAND = 'npm install -g @raidiant/notifai';
+function localRecovery(action) {
+    switch (action) {
+        case 'update_cli':
+            return `next: ${UPDATE_CLI_COMMAND}`;
+        case 'update_companion':
+            return 'next: Update Notifai on the named device.';
+        case 'wait_for_service':
+            return 'next: The service is being updated; try again later.';
+        default:
+            return null;
+    }
+}
+export function reportError(deps, err, context = {}) {
+    // Recorded before it is printed: stderr from an agent's shell call is often
+    // the one thing that does not survive into the next turn, and this is exactly
+    // the line someone comes back looking for.
+    log(deps).error('cli.error', {
+        ...context,
+        ...(err instanceof ApiCallError
+            ? {
+                kind: 'api',
+                status: err.status,
+                code: err.code,
+                message: err.message,
+                next_action: err.nextAction,
+                recovery_action: err.recoveryAction,
+                details: err.details,
+            }
+            : err instanceof NetworkError
+                ? { kind: 'network', message: err.message }
+                : { kind: 'unknown', message: String(err) }),
+    });
+    if (err instanceof ApiCallError) {
+        deps.io.err(deps.io.interactive === true && err.recoveryAction !== null
+            ? err.message
+            : `${err.code}: ${err.message}`);
+        // The server's field-level details were already being logged above, but
+        // stderr is the one surface an agent's next turn actually reads — so the
+        // diagnosis has to be on it, the same way the hook path prints it.
+        const paths = rejectedPaths(err.details);
+        if (paths.length > 0)
+            deps.io.err(`the server rejected: ${paths.join(', ')}`);
+        // A 422 on a request this CLI built is not a user error: the two sides
+        // disagree about the contract, in whichever direction. `doctor` says which.
+        // Codes that name a policy the account chose are the exception — the
+        // contract held, the body simply did not satisfy that account.
+        if (err.status === 422 &&
+            err.code !== 'acknowledgement_text_required' &&
+            err.code !== 'feature_unavailable') {
+            deps.io.err('this build sent a field the server did not accept — the CLI and server ' +
+                'disagree about the contract; check with `notifai doctor`');
+        }
+        const recovery = localRecovery(err.recoveryAction);
+        if (recovery !== null)
+            deps.io.err(recovery);
+        else if (err.recoveryAction === null && err.nextAction)
+            deps.io.err(`next: ${err.nextAction}`);
+        if (err.code === 'auth_required' || err.code === 'machine_revoked')
+            return EXIT.auth;
+        return err.status >= 500 ? EXIT.network : EXIT.failed;
+    }
+    if (err instanceof NetworkError) {
+        deps.io.err(err.message);
+        return EXIT.network;
+    }
+    deps.io.err(String(err));
+    return EXIT.failed;
+}
+export function rejectedPaths(details) {
+    if (!Array.isArray(details))
+        return [];
+    return details
+        .map((issue) => typeof issue === 'object' && issue !== null && typeof issue.path === 'string'
+        ? issue.path
+        : null)
+        .filter((path) => path !== null && path !== '')
+        .slice(0, 5);
+}
+//# sourceMappingURL=commands-core.js.map

package/dist/commands-core.js.map

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

package/dist/commands-devices.d.ts

@@ -0,0 +1,31 @@
+import { type Platform, type RoutableDevice } from '@raidiant/notifai-protocol';
+import { type CommandDeps } from './commands-core.js';
+export declare function devicesCommand(deps: CommandDeps, flags: {
+    json?: boolean;
+}): Promise<number>;
+/**
+ * Devices as data, for surfaces that render them themselves.
+ *
+ * `devicesCommand` prints and returns an exit code, which is the right shape
+ * for a command and the wrong one for a menu that wants to show names beside
+ * checkboxes. Silent on every failure by design: the interactive app already
+ * shows the credential and connectivity state on its status card, so a second
+ * error line here would be reporting the same fault twice.
+ */
+export declare function deviceInventory(deps: CommandDeps): Promise<RoutableDevice[] | null>;
+/** Whether a device is in a state where a notification would actually arrive. */
+export declare function canDeviceReceive(device: RoutableDevice): boolean;
+export declare function capabilitiesCommand(deps: CommandDeps, flags: {
+    json?: boolean;
+    platform?: Platform;
+}): Promise<number>;
+export declare function supportPageUrl(baseUrl: string): string;
+/** Same-account line for the device hop; prefers the real email when known. */
+export declare function sameAccountSignInLine(email: string | null | undefined): string;
+export declare function deviceInstallRemedy(options: {
+    baseUrl: string;
+    email: string | null;
+    devices: readonly RoutableDevice[];
+}): string;
+export declare function deviceCanReceive(device: RoutableDevice): boolean;
+export declare function readyIosDevices(devices: readonly RoutableDevice[]): RoutableDevice[];