@nocville/npc 0.0.0-stage → 0.2.1

package/dist/cjs/npcs/claude-code/hook-handler.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLAUDE_HOOK_SPEC = exports.CLAUDE_ADAPTER = void 0;
+exports.deriveServiceId = deriveServiceId;
+exports.humanizeProjectName = humanizeProjectName;
+exports.lookupSessionNameFromStore = lookupSessionNameFromStore;
+exports.resolveSessionName = resolveSessionName;
+exports.handleHookEvent = handleHookEvent;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const hook_runner_js_1 = require("../agent-common/hook-runner.js");
+const session_js_1 = require("../agent-common/session.js");
+const normalize_js_1 = require("../cursor/normalize.js");
+const hook_handler_js_1 = require("../cursor/hook-handler.js");
+const defaults_js_1 = require("./defaults.js");
+const state_machine_js_1 = require("./state-machine.js");
+exports.CLAUDE_ADAPTER = {
+    command: 'claude-code',
+    label: 'Claude',
+    family: 'claude',
+    stateDir: defaults_js_1.DEFAULTS.stateDir,
+    heartbeatSeconds: defaults_js_1.DEFAULTS.heartbeatSeconds,
+    processNames: ['claude'],
+};
+/**
+ * Derive a serviceId from the session and project directory.
+ * Format: "claude-{project_name}-{session_id_prefix}" (≤100 chars).
+ */
+function deriveServiceId(sessionId, cwd) {
+    return (0, session_js_1.sanitizeServiceId)(`claude-${(0, session_js_1.projectNameOf)(cwd)}-${sessionId.slice(0, 8)}`);
+}
+/**
+ * Humanize a project dir name into a banner label: split on punctuation and
+ * title-case each word ("gridbreak" -> "Gridbreak", "my-cool-app" -> "My Cool App").
+ */
+function humanizeProjectName(cwd) {
+    const raw = (0, session_js_1.projectNameOf)(cwd);
+    const words = raw
+        .replace(/[^a-zA-Z0-9]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+    if (words.length === 0)
+        return raw;
+    return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+}
+/** Default location of Claude Code's per-session sidecar files. */
+function sessionsStoreDir() {
+    return (0, node_path_1.join)((0, node_os_1.homedir)(), '.claude', 'sessions');
+}
+/**
+ * Correlate a session_id to its user-facing name via the local session store.
+ * Claude Code writes ~/.claude/sessions/<pid>.json — keyed by pid, each holding
+ * `{ sessionId, name, ... }` — so we scan for the file whose sessionId matches.
+ * `dir` is injectable for testing.
+ */
+function lookupSessionNameFromStore(sessionId, dir = sessionsStoreDir()) {
+    if (!sessionId)
+        return null;
+    let files;
+    try {
+        files = (0, node_fs_1.readdirSync)(dir);
+    }
+    catch {
+        return null;
+    }
+    for (const file of files) {
+        if (!file.endsWith('.json'))
+            continue;
+        try {
+            const obj = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(dir, file), 'utf-8'));
+            if (obj.sessionId === sessionId && typeof obj.name === 'string' && obj.name.trim()) {
+                return obj.name.trim();
+            }
+        }
+        catch {
+            // Skip unreadable / partially-written session files.
+        }
+    }
+    return null;
+}
+/**
+ * Resolve the user-facing session name. Checked fresh only on the cheap,
+ * low-frequency events (SessionStart carries `session_title`; UserPromptSubmit
+ * falls back to the store scan) so renames propagate; otherwise the cached
+ * value is reused. Returns null when unknown (banner falls back to the project).
+ */
+function resolveSessionName(event, cached, dir) {
+    const name = (0, state_machine_js_1.eventName)(event);
+    const shouldRefresh = name === 'SessionStart' || name === 'UserPromptSubmit' || !cached;
+    if (!shouldRefresh)
+        return cached;
+    const fromPayload = typeof event.session_title === 'string' ? event.session_title.trim() : '';
+    if (fromPayload)
+        return fromPayload;
+    return lookupSessionNameFromStore(event.session_id ?? '', dir) ?? cached;
+}
+exports.CLAUDE_HOOK_SPEC = {
+    adapter: exports.CLAUDE_ADAPTER,
+    serviceIdFor: deriveServiceId,
+    transition: (event, prev) => (0, state_machine_js_1.claudeTransition)(event, prev),
+    resolveName: (event, prev) => {
+        // Only scan the store on the low-frequency events; never on PreToolUse.
+        const name = (0, state_machine_js_1.eventName)(event);
+        if (prev && name !== 'SessionStart' && name !== 'UserPromptSubmit')
+            return undefined;
+        return resolveSessionName(event, prev?.name ?? null) ?? undefined;
+    },
+};
+/**
+ * Handle a single Claude Code hook event.
+ *
+ * Reads the JSON payload (from `rawInput` if provided, else stdin), updates the
+ * per-session state file, and pushes an NPC status update (banner
+ * "Claude · <session name or project>"). Defaults to an in-process push; the CLI
+ * passes `mode: 'detach'` so the push runs in a background process. Never throws.
+ */
+async function handleHookEvent(config, rawInput, opts = {}) {
+    const input = rawInput ?? (0, hook_runner_js_1.readStdin)();
+    let event;
+    try {
+        event = JSON.parse(input);
+    }
+    catch {
+        return;
+    }
+    if (!event || typeof event !== 'object' || Array.isArray(event))
+        return;
+    if ((0, normalize_js_1.isCursorInvocation)(event)) {
+        await (0, hook_handler_js_1.handleCursorHookEvent)(config, event, opts, 'third-party');
+        return;
+    }
+    await (0, hook_runner_js_1.runAgentHook)(exports.CLAUDE_HOOK_SPEC, config, event, {
+        minPushGapMs: defaults_js_1.DEFAULTS.minPushGapMs,
+        ...opts,
+    });
+}
+//# sourceMappingURL=hook-handler.js.map

package/dist/cjs/npcs/claude-code/index.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeCodeNPC = exports.uninstallHooks = exports.setupHooks = exports.CLAUDE_ADAPTER = exports.handleHookEvent = exports.claudeTransition = exports.processHookEvent = exports.DEFAULTS = void 0;
+exports.handleClaudeCodeCommand = handleClaudeCodeCommand;
+const config_js_1 = require("../../core/config.js");
+const hook_runner_js_1 = require("../agent-common/hook-runner.js");
+const watchdog_js_1 = require("../agent-common/watchdog.js");
+const session_js_1 = require("../agent-common/session.js");
+const defaults_js_1 = require("./defaults.js");
+const hook_handler_js_1 = require("./hook-handler.js");
+const setup_js_1 = require("./setup.js");
+var defaults_js_2 = require("./defaults.js");
+Object.defineProperty(exports, "DEFAULTS", { enumerable: true, get: function () { return defaults_js_2.DEFAULTS; } });
+var state_machine_js_1 = require("./state-machine.js");
+Object.defineProperty(exports, "processHookEvent", { enumerable: true, get: function () { return state_machine_js_1.processHookEvent; } });
+Object.defineProperty(exports, "claudeTransition", { enumerable: true, get: function () { return state_machine_js_1.claudeTransition; } });
+var hook_handler_js_2 = require("./hook-handler.js");
+Object.defineProperty(exports, "handleHookEvent", { enumerable: true, get: function () { return hook_handler_js_2.handleHookEvent; } });
+Object.defineProperty(exports, "CLAUDE_ADAPTER", { enumerable: true, get: function () { return hook_handler_js_2.CLAUDE_ADAPTER; } });
+var setup_js_2 = require("./setup.js");
+Object.defineProperty(exports, "setupHooks", { enumerable: true, get: function () { return setup_js_2.setupHooks; } });
+Object.defineProperty(exports, "uninstallHooks", { enumerable: true, get: function () { return setup_js_2.uninstallHooks; } });
+/** Remove stale session state files. */
+async function cleanupStateFiles() {
+    const removed = await (0, session_js_1.cleanupSessionStates)(defaults_js_1.DEFAULTS.stateDir, defaults_js_1.DEFAULTS.stateFileMaxAge);
+    console.log(`Cleanup complete: ${removed} stale file(s) removed`);
+}
+/**
+ * claude-code subcommands: setup | uninstall | hook | flush | cleanup.
+ * `hook` and `flush` are invoked by Claude Code / ourselves and must stay
+ * silent on stdout and never exit non-zero.
+ */
+async function handleClaudeCodeCommand(opts) {
+    const { subcommand, config, flags } = opts;
+    switch (subcommand) {
+        case 'setup': {
+            if (flags['uninstall']) {
+                (0, setup_js_1.uninstallHooks)();
+                break;
+            }
+            const ok = (0, setup_js_1.setupHooks)({
+                apiUrl: (0, config_js_1.stringFlag)(flags, 'api-url') ?? process.env['NOCVILLE_API_URL'],
+                apiKey: (0, config_js_1.stringFlag)(flags, 'api-key') ?? process.env['NOCVILLE_API_KEY'],
+                map: (0, config_js_1.stringFlag)(flags, 'map'),
+                cliPath: process.argv[1],
+                debug: config.debug,
+            });
+            if (!ok)
+                process.exitCode = 1;
+            break;
+        }
+        case 'uninstall':
+            (0, setup_js_1.uninstallHooks)();
+            break;
+        case 'hook':
+            await (0, hook_handler_js_1.handleHookEvent)(config, (0, hook_runner_js_1.readStdin)(), { mode: 'detach' });
+            break;
+        case 'watchdog':
+            await (0, watchdog_js_1.runWatchdog)(hook_handler_js_1.CLAUDE_ADAPTER, config, opts.args?.[0]);
+            break;
+        case 'flush':
+            await (0, hook_runner_js_1.runFlushCommand)(hook_handler_js_1.CLAUDE_ADAPTER, config, opts.args?.[0], (0, config_js_1.numberFlag)(flags, 'delay'), flags['stats'] === true);
+            break;
+        case 'cleanup':
+            await cleanupStateFiles();
+            break;
+        default: {
+            console.error(`Unknown claude-code subcommand: ${subcommand}`);
+            console.error('Available subcommands: setup, uninstall, hook, cleanup');
+            process.exitCode = 1;
+        }
+    }
+}
+/**
+ * ClaudeCodeNPC class for programmatic use.
+ */
+class ClaudeCodeNPC {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Process a hook event from stdin (in-process push). */
+    async handleHook() {
+        await (0, hook_handler_js_1.handleHookEvent)(this.config);
+    }
+    /** Install hooks into Claude Code settings. */
+    setup() {
+        (0, setup_js_1.setupHooks)({
+            apiUrl: this.config.apiUrl,
+            apiKey: this.config.apiKey,
+            debug: this.config.debug,
+        });
+    }
+    /** Remove all Nocville hooks from Claude Code settings. */
+    uninstall() {
+        (0, setup_js_1.uninstallHooks)();
+    }
+    /** Clean up stale session state files. */
+    async cleanup() {
+        await cleanupStateFiles();
+    }
+}
+exports.ClaudeCodeNPC = ClaudeCodeNPC;
+//# sourceMappingURL=index.js.map

package/dist/cjs/npcs/claude-code/setup.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findExistingNocvilleCommand = exports.CLAUDE_HOOK_EVENTS = exports.extractFlag = void 0;
+exports.claudeSettingsPath = claudeSettingsPath;
+exports.installHooksInto = installHooksInto;
+exports.removeHooksFrom = removeHooksFrom;
+exports.buildHookCommand = buildHookCommand;
+exports.legacyCredentials = legacyCredentials;
+exports.setupHooks = setupHooks;
+exports.uninstallHooks = uninstallHooks;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const user_config_js_1 = require("../../core/user-config.js");
+const hook_settings_js_1 = require("../agent-common/hook-settings.js");
+const shim_js_1 = require("../agent-common/shim.js");
+const runtime_js_1 = require("../agent-common/runtime.js");
+const defaults_js_1 = require("./defaults.js");
+var hook_settings_js_2 = require("../agent-common/hook-settings.js");
+Object.defineProperty(exports, "extractFlag", { enumerable: true, get: function () { return hook_settings_js_2.extractFlag; } });
+function claudeSettingsPath() {
+    return (0, node_path_1.join)((0, node_os_1.homedir)(), '.claude', 'settings.json');
+}
+/**
+ * Hook events to install. Verified against code.claude.com/docs/en/hooks —
+ * all exist; events without matcher support ignore the empty matcher.
+ */
+exports.CLAUDE_HOOK_EVENTS = [
+    'SessionStart',
+    'SessionEnd',
+    'UserPromptSubmit',
+    'PreToolUse',
+    'PostToolUse',
+    'PostToolUseFailure',
+    'PermissionRequest',
+    'Notification',
+    'Stop',
+    'SubagentStart',
+    'SubagentStop',
+    'PreCompact',
+];
+/** Install the nocville group into every Claude Code event. Mutates `settings`. */
+function installHooksInto(settings, command, opts = {}) {
+    return (0, hook_settings_js_1.installHookGroups)(settings, command, exports.CLAUDE_HOOK_EVENTS, {
+        perEvent: Object.fromEntries(exports.CLAUDE_HOOK_EVENTS.map((event) => [
+            event,
+            {
+                ...((opts.platform ?? process.platform) === 'win32' ? { shell: 'powershell' } : {}),
+                ...(event === 'SessionEnd'
+                    ? { timeout: 5 }
+                    : { async: true, timeout: opts.timeout ?? 10 }),
+            },
+        ])),
+    });
+}
+/** Remove all nocville entries (nested or legacy flat). Mutates `settings`. */
+function removeHooksFrom(settings) {
+    return (0, hook_settings_js_1.removeHookGroups)(settings);
+}
+var hook_settings_js_3 = require("../agent-common/hook-settings.js");
+Object.defineProperty(exports, "findExistingNocvilleCommand", { enumerable: true, get: function () { return hook_settings_js_3.findNocvilleCommand; } });
+/** `'<node>' '<cli.js>' claude-code hook # nocville-npc-hook` — no key on the command line. */
+function buildHookCommand(_cliPath) {
+    return (0, hook_settings_js_1.buildShimHookCommand)('claude-code');
+}
+/**
+ * Credentials embedded in a legacy hook command (`--api-url=… --api-key=…`),
+ * so upgrading setup can move them into the user config.
+ */
+function legacyCredentials(settings) {
+    const prev = (0, hook_settings_js_1.findNocvilleCommand)(settings);
+    if (!prev)
+        return {};
+    return { apiUrl: (0, hook_settings_js_1.extractFlag)(prev, 'api-url'), apiKey: (0, hook_settings_js_1.extractFlag)(prev, 'api-key') };
+}
+function out(opts, msg) {
+    if (!opts.quiet)
+        console.log(msg);
+}
+/**
+ * Install Nocville hooks into Claude Code settings (matcher-group format,
+ * absolute node/cli paths, 10s timeout safety net). Idempotent: migrates and
+ * de-duplicates legacy entries and moves any legacy inline credentials into
+ * ~/.config/nocville/config.json. Returns false if setup could not complete.
+ */
+function setupHooks(opts) {
+    const settingsPath = opts.settingsPath ?? claudeSettingsPath();
+    const dir = (0, node_path_1.join)(settingsPath, '..');
+    if (!(0, node_fs_1.existsSync)(dir)) {
+        console.error(`${dir} does not exist — is Claude Code installed? Skipping Claude Code setup.`);
+        return false;
+    }
+    const settings = (0, hook_settings_js_1.readJsonFile)(settingsPath);
+    if (settings === null) {
+        console.error(`Could not parse ${settingsPath}; fix it (or move it aside) and re-run setup.`);
+        return false;
+    }
+    const creds = (0, user_config_js_1.persistCredentials)(opts, legacyCredentials(settings));
+    const resolved = (0, hook_settings_js_1.resolveCliPath)(opts.cliPath);
+    const cliPath = (0, runtime_js_1.ensureStableCliPath)(resolved);
+    (0, shim_js_1.installHookShim)((0, hook_settings_js_1.stableNodePath)(), cliPath);
+    const command = buildHookCommand(cliPath);
+    const { migrated, installed } = installHooksInto(settings, command, {
+        timeout: defaults_js_1.DEFAULTS.hookTimeoutSeconds,
+    });
+    (0, hook_settings_js_1.writeJsonFile)(settingsPath, settings);
+    out(opts, `✓ Claude Code: installed Nocville hooks for ${installed} events in ${settingsPath}`);
+    if (migrated > 0)
+        out(opts, `  (migrated ${migrated} legacy entr${migrated === 1 ? 'y' : 'ies'})`);
+    out(opts, `  Hook runs: ${process.execPath} ${cliPath}`);
+    out(opts, `  API: ${creds.apiUrl ?? 'https://nocville.com'}  key: ${(0, user_config_js_1.maskKey)(creds.apiKey)}`);
+    if (!creds.apiKey) {
+        out(opts, '  ⚠ No API key saved yet — run: nocville-npc init --api-key=<your team key>');
+    }
+    out(opts, '  New Claude Code sessions will appear in your office. Restart running sessions.');
+    return true;
+}
+/** Remove all Nocville hooks from Claude Code settings. */
+function uninstallHooks(opts = {}) {
+    const o = typeof opts === 'boolean' ? {} : opts;
+    const settingsPath = o.settingsPath ?? claudeSettingsPath();
+    const settings = (0, hook_settings_js_1.readJsonFile)(settingsPath);
+    if (!settings || !(0, node_fs_1.existsSync)(settingsPath)) {
+        out(o, 'Claude Code: no settings.json — nothing to remove.');
+        return 0;
+    }
+    const removed = removeHooksFrom(settings);
+    if (removed > 0)
+        (0, hook_settings_js_1.writeJsonFile)(settingsPath, settings);
+    out(o, `✓ Claude Code: removed ${removed} Nocville hook(s) from ${settingsPath}`);
+    return removed;
+}
+//# sourceMappingURL=setup.js.map

package/dist/cjs/npcs/claude-code/state-machine.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventName = eventName;
+exports.claudeTransition = claudeTransition;
+exports.processHookEvent = processHookEvent;
+const activity_js_1 = require("../agent-common/activity.js");
+const hook_runner_js_1 = require("../agent-common/hook-runner.js");
+const session_js_1 = require("../agent-common/session.js");
+/** Resolve the event name from either the real or legacy field. */
+function eventName(event) {
+    return (0, hook_runner_js_1.hookEventName)(event);
+}
+const working = (activity, warn = false) => ({
+    state: 'WORKING',
+    activity,
+    status: warn ? 'warning' : 'healthy',
+    mood: warn ? 'concerned' : 'happy',
+});
+const waiting = (activity) => ({
+    state: 'WAITING',
+    activity,
+    status: 'warning',
+    mood: 'concerned',
+});
+const idle = (activity) => ({
+    state: 'IDLE',
+    activity,
+    status: 'healthy',
+    mood: 'idle',
+});
+/** Notification types that mean "the human needs to act". */
+const WAITING_NOTIFICATIONS = new Set([
+    'permission_prompt',
+    'elicitation_dialog',
+    'elicitation_url_dialog',
+    'agent_needs_input',
+]);
+/**
+ * Map one Claude Code hook event to a phase + activity line.
+ * Event names / payload fields per code.claude.com/docs/en/hooks.
+ * Prompt text is never read (privacy); tool inputs are summarized, not echoed.
+ */
+function claudeTransition(event, prev) {
+    const name = eventName(event);
+    const cwd = (typeof event.cwd === 'string' && event.cwd) || prev?.projectDir;
+    const keep = prev?.state ?? 'IDLE';
+    switch (name) {
+        case 'SessionStart':
+            return idle('Ready for a task');
+        case 'UserPromptSubmit':
+            return working(activity_js_1.THINKING);
+        case 'PreToolUse': {
+            const activity = (0, activity_js_1.describeToolUse)(event.tool_name, event.tool_input, cwd);
+            if ((0, activity_js_1.isQuestionTool)(event.tool_name))
+                return waiting(activity);
+            return working(activity);
+        }
+        case 'PostToolUse':
+        case 'PostToolBatch':
+            // Tool finished — still working; keep showing the same activity.
+            return { ...working(undefined), quiet: prev?.state === 'WORKING' };
+        case 'PostToolUseFailure':
+            return working((0, activity_js_1.failureText)(event.tool_name), true);
+        case 'PermissionRequest': {
+            const what = event.tool_name ? (0, activity_js_1.describeToolUse)(event.tool_name, event.tool_input, cwd) : '';
+            return waiting(what ? `Needs your approval: ${what}` : 'Needs your approval');
+        }
+        case 'Notification': {
+            const type = typeof event.notification_type === 'string' ? event.notification_type : '';
+            if (type === 'idle_prompt')
+                return idle('Done — waiting for next task');
+            if (type === 'permission_prompt')
+                return waiting('Needs your approval');
+            if (WAITING_NOTIFICATIONS.has(type) || !type)
+                return waiting('Waiting for you');
+            // auth_success, agent_completed, quota_* … → informational only.
+            return {
+                state: keep,
+                status: prev?.status ?? 'healthy',
+                mood: prev?.mood ?? 'idle',
+                quiet: true,
+            };
+        }
+        case 'Stop':
+            return idle('Done — waiting for next task');
+        case 'StopFailure':
+            return { ...idle('Stopped with an error'), status: 'warning', mood: 'concerned' };
+        case 'SubagentStart':
+            return working('Delegating to a subagent');
+        case 'SubagentStop':
+            return working('Subagent finished');
+        case 'PreCompact':
+            return working('Compacting context');
+        case 'SessionEnd':
+            return {
+                state: 'IDLE',
+                activity: 'Session ended',
+                status: 'unknown',
+                mood: 'idle',
+                offline: true,
+            };
+        default:
+            return {
+                state: keep,
+                status: prev?.status ?? 'healthy',
+                mood: prev?.mood ?? 'idle',
+                quiet: true,
+            };
+    }
+}
+/**
+ * Derive the NPC status output from a hook event (state + presentation).
+ * Kept for library consumers; the hook runner uses `claudeTransition` directly.
+ */
+function processHookEvent(event, currentState) {
+    const t = claudeTransition(event, currentState);
+    const { subStatus, behavior } = (0, session_js_1.phasePresentation)(t.state, t.offline);
+    return {
+        state: t.state,
+        output: {
+            status: t.status,
+            mood: t.mood,
+            message: t.activity ?? currentState?.activity?.[0] ?? '',
+            subStatus,
+            behavior,
+            offline: t.offline,
+        },
+    };
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/cjs/npcs/codex/defaults.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODEX_DEFAULTS = void 0;
+exports.codexHome = codexHome;
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+exports.CODEX_DEFAULTS = {
+    /** Hook-mode per-session state (shared with the watcher to avoid double pushes). */
+    stateDir: (0, node_path_1.join)((0, node_os_1.tmpdir)(), 'nocville-codex'),
+    stateFileMaxAge: 24 * 60 * 60 * 1000,
+    /** Watchdog-backed sessions become unknown after three minutes without a heartbeat. */
+    heartbeatSeconds: 90,
+    minPushGapMs: 1500,
+    hookTimeoutSeconds: 10,
+    /** Watcher: Codex session rollout logs. */
+    sessionsDir: (0, node_path_1.join)(process.env['CODEX_HOME'] ?? (0, node_path_1.join)((0, node_os_1.homedir)(), '.codex'), 'sessions'),
+    /** Watcher: poll interval for new sessions / appended lines. */
+    pollMs: 1000,
+    /**
+     * Watcher: a session whose rollout file hasn't grown for this long is treated
+     * as ended (offline push). Matches Codex's own 30-minute idle SessionEnd.
+     */
+    idleTimeoutMs: 30 * 60 * 1000,
+    /** Watcher: bytes read from the end of an already-active rollout on discovery. */
+    initialTailBytes: 256 * 1024,
+    /** Watcher: max bytes read per tick per session before skipping ahead to the tail. */
+    maxReadBytes: 8 * 1024 * 1024,
+};
+function codexHome() {
+    return process.env['CODEX_HOME'] ?? (0, node_path_1.join)((0, node_os_1.homedir)(), '.codex');
+}
+//# sourceMappingURL=defaults.js.map

package/dist/cjs/npcs/codex/hook-handler.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODEX_HOOK_SPEC = exports.CODEX_ADAPTER = void 0;
+exports.codexServiceId = codexServiceId;
+exports.codexTransition = codexTransition;
+exports.handleCodexHookEvent = handleCodexHookEvent;
+const activity_js_1 = require("../agent-common/activity.js");
+const hook_runner_js_1 = require("../agent-common/hook-runner.js");
+const session_js_1 = require("../agent-common/session.js");
+const defaults_js_1 = require("./defaults.js");
+exports.CODEX_ADAPTER = {
+    command: 'codex',
+    label: 'Codex',
+    family: 'codex',
+    stateDir: defaults_js_1.CODEX_DEFAULTS.stateDir,
+    heartbeatSeconds: defaults_js_1.CODEX_DEFAULTS.heartbeatSeconds,
+    processNames: ['codex'],
+};
+/**
+ * Codex session ids are UUIDv7 (time-ordered): the leading chars are shared by
+ * sessions started close together, so key the serviceId on the random tail.
+ */
+function codexServiceId(sessionId, cwd) {
+    const hex = sessionId.replace(/[^A-Za-z0-9]/g, '');
+    return (0, session_js_1.sanitizeServiceId)(`codex-${(0, session_js_1.projectNameOf)(cwd)}-${hex.slice(-8) || 'session'}`);
+}
+const working = (activity, warn = false) => ({
+    state: 'WORKING',
+    activity,
+    status: warn ? 'warning' : 'healthy',
+    mood: warn ? 'concerned' : 'happy',
+});
+const waiting = (activity) => ({
+    state: 'WAITING',
+    activity,
+    status: 'warning',
+    mood: 'concerned',
+});
+const idle = (activity) => ({
+    state: 'IDLE',
+    activity,
+    status: 'healthy',
+    mood: 'idle',
+});
+/**
+ * Map one Codex hook event to a phase + activity line. Events and payload
+ * fields per the Codex hooks reference (developers.openai.com/codex/hooks):
+ * SessionStart, SessionEnd, UserPromptSubmit, PreToolUse, PostToolUse,
+ * PermissionRequest, Stop, Interrupt, PreCompact, PostCompact, SubagentStart,
+ * SubagentStop. Bash/apply_patch carry `tool_input.command`.
+ */
+function codexTransition(event, prev) {
+    const name = (0, hook_runner_js_1.hookEventName)(event);
+    const cwd = (typeof event.cwd === 'string' && event.cwd) || prev?.projectDir;
+    const keep = prev?.state ?? 'IDLE';
+    switch (name) {
+        case 'SessionStart':
+            return idle('Ready for a task');
+        case 'UserPromptSubmit':
+            return working(activity_js_1.THINKING);
+        case 'PreToolUse': {
+            const activity = (0, activity_js_1.describeToolUse)(event.tool_name, event.tool_input, cwd);
+            return (0, activity_js_1.isQuestionTool)(event.tool_name) ? waiting(activity) : working(activity);
+        }
+        case 'PostToolUse':
+        case 'PostCompact':
+            return { ...working(undefined), quiet: prev?.state === 'WORKING' };
+        case 'PostToolUseFailure':
+            return working((0, activity_js_1.failureText)(event.tool_name), true);
+        case 'PermissionRequest': {
+            const what = event.tool_name ? (0, activity_js_1.describeToolUse)(event.tool_name, event.tool_input, cwd) : '';
+            return waiting(what ? `Needs your approval: ${what}` : 'Needs your approval');
+        }
+        case 'Stop':
+            return idle('Done — waiting for next task');
+        case 'Interrupt':
+            return idle('Interrupted — waiting for you');
+        case 'PreCompact':
+            return working('Compacting context');
+        case 'SubagentStart':
+            return working('Delegating to a subagent');
+        case 'SubagentStop':
+            return working('Subagent finished');
+        case 'SessionEnd':
+            return {
+                state: 'IDLE',
+                activity: 'Session ended',
+                status: 'unknown',
+                mood: 'idle',
+                offline: true,
+            };
+        default:
+            return {
+                state: keep,
+                status: prev?.status ?? 'healthy',
+                mood: prev?.mood ?? 'idle',
+                quiet: true,
+            };
+    }
+}
+exports.CODEX_HOOK_SPEC = {
+    adapter: exports.CODEX_ADAPTER,
+    serviceIdFor: codexServiceId,
+    transition: codexTransition,
+};
+/**
+ * Handle a single Codex hook event (stdin JSON unless `rawInput` is given).
+ * In-process push by default; the CLI passes `mode: 'detach'`. Never throws.
+ */
+async function handleCodexHookEvent(config, rawInput, opts = {}) {
+    await (0, hook_runner_js_1.runAgentHook)(exports.CODEX_HOOK_SPEC, config, rawInput ?? (0, hook_runner_js_1.readStdin)(), {
+        minPushGapMs: defaults_js_1.CODEX_DEFAULTS.minPushGapMs,
+        ...opts,
+    });
+}
+//# sourceMappingURL=hook-handler.js.map