@nocville/npc 0.0.0-stage → 0.2.1

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

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodexWatcher = exports.describeExecScript = exports.parseRolloutLine = exports.CODEX_HOOK_EVENTS = exports.installCodexHooksInto = exports.uninstallCodexHooks = exports.setupCodexHooks = exports.handleCodexHookEvent = exports.codexServiceId = exports.codexTransition = exports.CODEX_ADAPTER = exports.CODEX_DEFAULTS = void 0;
+exports.handleCodexCommand = handleCodexCommand;
+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");
+const watcher_js_1 = require("./watcher.js");
+var defaults_js_2 = require("./defaults.js");
+Object.defineProperty(exports, "CODEX_DEFAULTS", { enumerable: true, get: function () { return defaults_js_2.CODEX_DEFAULTS; } });
+var hook_handler_js_2 = require("./hook-handler.js");
+Object.defineProperty(exports, "CODEX_ADAPTER", { enumerable: true, get: function () { return hook_handler_js_2.CODEX_ADAPTER; } });
+Object.defineProperty(exports, "codexTransition", { enumerable: true, get: function () { return hook_handler_js_2.codexTransition; } });
+Object.defineProperty(exports, "codexServiceId", { enumerable: true, get: function () { return hook_handler_js_2.codexServiceId; } });
+Object.defineProperty(exports, "handleCodexHookEvent", { enumerable: true, get: function () { return hook_handler_js_2.handleCodexHookEvent; } });
+var setup_js_2 = require("./setup.js");
+Object.defineProperty(exports, "setupCodexHooks", { enumerable: true, get: function () { return setup_js_2.setupCodexHooks; } });
+Object.defineProperty(exports, "uninstallCodexHooks", { enumerable: true, get: function () { return setup_js_2.uninstallCodexHooks; } });
+Object.defineProperty(exports, "installCodexHooksInto", { enumerable: true, get: function () { return setup_js_2.installCodexHooksInto; } });
+Object.defineProperty(exports, "CODEX_HOOK_EVENTS", { enumerable: true, get: function () { return setup_js_2.CODEX_HOOK_EVENTS; } });
+var rollout_js_1 = require("./rollout.js");
+Object.defineProperty(exports, "parseRolloutLine", { enumerable: true, get: function () { return rollout_js_1.parseRolloutLine; } });
+Object.defineProperty(exports, "describeExecScript", { enumerable: true, get: function () { return rollout_js_1.describeExecScript; } });
+var watcher_js_2 = require("./watcher.js");
+Object.defineProperty(exports, "CodexWatcher", { enumerable: true, get: function () { return watcher_js_2.CodexWatcher; } });
+/**
+ * codex subcommands: setup | uninstall | hook | flush | watch | cleanup.
+ * `hook`/`flush` are invoked by Codex / ourselves and stay silent on stdout.
+ */
+async function handleCodexCommand(opts) {
+    const { subcommand, config, flags } = opts;
+    switch (subcommand) {
+        case 'setup': {
+            if (flags['uninstall']) {
+                (0, setup_js_1.uninstallCodexHooks)();
+                break;
+            }
+            const ok = (0, setup_js_1.setupCodexHooks)({
+                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],
+            });
+            if (!ok)
+                process.exitCode = 1;
+            break;
+        }
+        case 'uninstall':
+            (0, setup_js_1.uninstallCodexHooks)();
+            break;
+        case 'hook':
+            await (0, hook_handler_js_1.handleCodexHookEvent)(config, (0, hook_runner_js_1.readStdin)(), { mode: 'detach' });
+            break;
+        case 'watchdog':
+            await (0, watchdog_js_1.runWatchdog)(hook_handler_js_1.CODEX_ADAPTER, config, opts.args?.[0]);
+            break;
+        case 'flush':
+            await (0, hook_runner_js_1.runFlushCommand)(hook_handler_js_1.CODEX_ADAPTER, config, opts.args?.[0], (0, config_js_1.numberFlag)(flags, 'delay'), flags['stats'] === true);
+            break;
+        case 'watch': {
+            console.error('codex watch is a fallback for Codex builds without hooks; prefer `nocville-npc codex setup`.');
+            if (!config.apiKey) {
+                console.error('Error: no API key — run `nocville-npc init --api-key=<key>` or pass --api-key');
+                process.exitCode = 1;
+                return;
+            }
+            const idleMin = (0, config_js_1.numberFlag)(flags, 'idle-timeout');
+            const watcher = new watcher_js_1.CodexWatcher(config, {
+                sessionsDir: (0, config_js_1.stringFlag)(flags, 'sessions-dir'),
+                idleTimeoutMs: idleMin !== undefined ? idleMin * 60_000 : undefined,
+                includeExec: (0, config_js_1.boolFlag)(flags, 'include-exec') ?? false,
+                pollMs: (0, config_js_1.numberFlag)(flags, 'poll-interval'),
+            });
+            await watcher.start();
+            break;
+        }
+        case 'cleanup': {
+            const removed = await (0, session_js_1.cleanupSessionStates)(defaults_js_1.CODEX_DEFAULTS.stateDir, defaults_js_1.CODEX_DEFAULTS.stateFileMaxAge);
+            console.log(`Cleanup complete: ${removed} stale file(s) removed`);
+            break;
+        }
+        default:
+            console.error(`Unknown codex subcommand: ${subcommand}`);
+            console.error('Available subcommands: setup, uninstall, watch, hook, cleanup');
+            process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeExecScript = describeExecScript;
+exports.parseRolloutLine = parseRolloutLine;
+// Unsupported, best-effort fallback: Codex rollout logs are an internal format. Prefer hooks.
+const activity_js_1 = require("../agent-common/activity.js");
+const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+const s = (v) => (typeof v === 'string' && v ? v : undefined);
+function stripFileUrl(p) {
+    return p.replace(/^file:\/\//, '');
+}
+/** Pull a JS/JSON string property (`cmd:"…"` / `"cmd": "…"`) out of a script. */
+function scriptString(script, key) {
+    const re = new RegExp(`["']?${key}["']?\\s*:\\s*"((?:[^"\\\\]|\\\\.)*)"`);
+    const m = script.match(re);
+    if (!m)
+        return undefined;
+    try {
+        return JSON.parse(`"${m[1]}"`);
+    }
+    catch {
+        return m[1];
+    }
+}
+/** Tool helpers inside exec scripts that carry nothing worth showing. */
+const QUIET_SCRIPT_TOOLS = new Set(['write_stdin', 'wait', 'clock__curr_time', 'get_goal']);
+/**
+ * Describe a Codex "exec" code-mode script (`text(await tools.exec_command({cmd:"…"}))`)
+ * by its first tool call. Returns null for no-op helpers.
+ */
+function describeExecScript(script, cwd) {
+    const m = script.match(/tools\.([A-Za-z0-9_]+)\s*\(/);
+    if (!m)
+        return 'Running code';
+    const tool = m[1];
+    if (QUIET_SCRIPT_TOOLS.has(tool))
+        return null;
+    switch (tool) {
+        case 'exec_command': {
+            const cmd = scriptString(script, 'cmd') ?? scriptString(script, 'command');
+            const short = cmd ? (0, activity_js_1.shortCommand)(cmd) : '';
+            return short ? `Running ${short}` : 'Running a command';
+        }
+        case 'apply_patch': {
+            // The patch is embedded as a JS string with escaped newlines.
+            return (0, activity_js_1.editingFiles)((0, activity_js_1.patchFiles)(script.replace(/\\n/g, '\n')), cwd);
+        }
+        case 'view_image':
+            return 'Viewing an image';
+        case 'update_plan':
+            return 'Planning';
+        case 'web__run':
+        case 'web_search':
+            return 'Browsing the web';
+        case 'image_gen__imagegen':
+            return 'Generating an image';
+        case 'spawn_agent':
+            return 'Delegating to a subagent';
+        default:
+            return (0, activity_js_1.describeToolUse)(tool.includes('__') ? `mcp__${tool}` : tool, {}, cwd);
+    }
+}
+function parseArgs(raw) {
+    if (isObj(raw))
+        return raw;
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            if (isObj(parsed))
+                return parsed;
+        }
+        catch {
+            return { input: raw };
+        }
+    }
+    return {};
+}
+/** Describe a `function_call` / `custom_tool_call` response item. */
+function describeCall(name, rawArgs, cwd) {
+    switch (name) {
+        case 'exec':
+            return typeof rawArgs === 'string' ? describeExecScript(rawArgs, cwd) : 'Running code';
+        case 'wait':
+        case 'write_stdin':
+        case 'list_agents':
+            return null;
+        case 'send_message':
+        case 'followup_task':
+            return 'Coordinating subagents';
+        case 'apply_patch': {
+            const args = parseArgs(rawArgs);
+            const patch = s(args['input']) ?? s(args['patch']) ?? (typeof rawArgs === 'string' ? rawArgs : '');
+            return (0, activity_js_1.editingFiles)((0, activity_js_1.patchFiles)(patch), cwd);
+        }
+        case 'shell':
+        case 'local_shell':
+        case 'exec_command':
+        case 'container.exec': {
+            const args = parseArgs(rawArgs);
+            return (0, activity_js_1.describeToolUse)('Bash', { command: args['command'] ?? args['cmd'] }, cwd);
+        }
+        default:
+            return (0, activity_js_1.describeToolUse)(name, parseArgs(rawArgs), cwd);
+    }
+}
+function approvalText(payload, cwd) {
+    const cmd = payload['command'];
+    if (cmd) {
+        const short = (0, activity_js_1.shortCommand)(cmd);
+        if (short)
+            return `Needs your approval: Running ${short}`;
+    }
+    const changes = payload['changes'];
+    if (isObj(changes)) {
+        return `Needs your approval: ${(0, activity_js_1.editingFiles)(Object.keys(changes).map(stripFileUrl), cwd)}`;
+    }
+    return 'Needs your approval';
+}
+function parseEventMsg(payload, cwd) {
+    const type = s(payload['type']) ?? '';
+    switch (type) {
+        case 'task_started':
+        case 'user_message':
+            return { kind: 'working', activity: activity_js_1.THINKING };
+        case 'task_complete':
+            return { kind: 'idle', activity: 'Done — waiting for next task' };
+        case 'turn_aborted':
+            return { kind: 'idle', activity: 'Interrupted — waiting for you' };
+        case 'exec_command_begin': {
+            const short = (0, activity_js_1.shortCommand)(payload['command']);
+            return { kind: 'working', activity: short ? `Running ${short}` : 'Running a command' };
+        }
+        case 'patch_apply_begin': {
+            const changes = isObj(payload['changes']) ? Object.keys(payload['changes']) : [];
+            return { kind: 'working', activity: (0, activity_js_1.editingFiles)(changes.map(stripFileUrl), cwd) };
+        }
+        case 'web_search_begin':
+            return { kind: 'working', activity: 'Searching the web' };
+        case 'request_user_input':
+            return { kind: 'waiting', activity: 'Has a question for you' };
+        case 'item_started': {
+            const item = isObj(payload['item']) ? payload['item'] : {};
+            const itemType = s(item['type']);
+            if (itemType === 'CommandExecution') {
+                const short = (0, activity_js_1.shortCommand)(item['command']);
+                return { kind: 'working', activity: short ? `Running ${short}` : 'Running a command' };
+            }
+            if (itemType === 'FileChange' && isObj(item['changes'])) {
+                return {
+                    kind: 'working',
+                    activity: (0, activity_js_1.editingFiles)(Object.keys(item['changes']).map(stripFileUrl), cwd),
+                };
+            }
+            return null;
+        }
+        case 'item_completed': {
+            // Newer builds log file edits only on completion; still the best signal.
+            const item = isObj(payload['item']) ? payload['item'] : {};
+            if (s(item['type']) === 'FileChange' && isObj(item['changes'])) {
+                return {
+                    kind: 'working',
+                    activity: (0, activity_js_1.editingFiles)(Object.keys(item['changes']).map(stripFileUrl), cwd),
+                };
+            }
+            return null;
+        }
+        default:
+            if (/approval_request$/.test(type) || type === 'request_permissions') {
+                return { kind: 'waiting', activity: approvalText(payload, cwd) };
+            }
+            return null;
+    }
+}
+function parseResponseItem(payload, cwd) {
+    const type = s(payload['type']) ?? '';
+    if (type === 'custom_tool_call' || type === 'function_call') {
+        const name = s(payload['name']) ?? '';
+        const activity = describeCall(name, payload['input'] ?? payload['arguments'], cwd);
+        return activity ? { kind: 'working', activity } : null;
+    }
+    if (type === 'local_shell_call') {
+        const action = isObj(payload['action']) ? payload['action'] : {};
+        const short = (0, activity_js_1.shortCommand)(action['command']);
+        return { kind: 'working', activity: short ? `Running ${short}` : 'Running a command' };
+    }
+    if (type === 'web_search_call')
+        return { kind: 'working', activity: 'Searching the web' };
+    return null;
+}
+/** Parse one rollout line into a signal (or null when it carries nothing useful). */
+function parseRolloutLine(line, cwd) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed[0] !== '{')
+        return null;
+    let rec;
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (!isObj(parsed))
+            return null;
+        rec = parsed;
+    }
+    catch {
+        return null;
+    }
+    const type = s(rec['type']) ?? '';
+    const payload = isObj(rec['payload']) ? rec['payload'] : {};
+    switch (type) {
+        case 'session_meta': {
+            const meta = isObj(payload['meta']) ? payload['meta'] : payload; // older nesting
+            const sessionId = s(meta['id']) ?? s(meta['session_id']);
+            if (!sessionId)
+                return null;
+            const source = meta['source'];
+            const threadSource = s(meta['thread_source']);
+            const subagent = (isObj(source) && 'subagent' in source) ||
+                threadSource === 'subagent' ||
+                threadSource === 'guardian_review';
+            const exec = source === 'exec' || s(meta['originator']) === 'codex_exec';
+            return { kind: 'meta', sessionId, cwd: s(meta['cwd']), subagent, exec };
+        }
+        case 'turn_context': {
+            const c = s(payload['cwd']);
+            return c ? { kind: 'cwd', cwd: c } : null;
+        }
+        case 'event_msg':
+            return parseEventMsg(payload, cwd);
+        case 'response_item':
+            return parseResponseItem(payload, cwd);
+        case 'function_call':
+        case 'custom_tool_call':
+        case 'local_shell_call':
+        case 'web_search_call':
+            // 2025-era rollouts wrote response items unwrapped.
+            return parseResponseItem(rec, cwd);
+        case '': {
+            // 2025-era first line: bare `{ id, timestamp, instructions }` session header.
+            const id = s(rec['id']);
+            return id && s(rec['timestamp'])
+                ? { kind: 'meta', sessionId: id, subagent: false, exec: false }
+                : null;
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=rollout.js.map

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

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODEX_HOOK_EVENTS = void 0;
+exports.codexHooksPath = codexHooksPath;
+exports.installCodexHooksInto = installCodexHooksInto;
+exports.buildCodexHookCommand = buildCodexHookCommand;
+exports.setupCodexHooks = setupCodexHooks;
+exports.uninstallCodexHooks = uninstallCodexHooks;
+const node_fs_1 = require("node:fs");
+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");
+/**
+ * Codex hook events we install (developers.openai.com/codex/hooks). PostCompact
+ * is omitted — it carries nothing displayable.
+ */
+exports.CODEX_HOOK_EVENTS = [
+    'SessionStart',
+    'SessionEnd',
+    'UserPromptSubmit',
+    'PreToolUse',
+    'PostToolUse',
+    'PermissionRequest',
+    'Stop',
+    'Interrupt',
+    'PreCompact',
+    'SubagentStart',
+    'SubagentStop',
+];
+function codexHooksPath() {
+    return (0, node_path_1.join)((0, defaults_js_1.codexHome)(), 'hooks.json');
+}
+/** Install the nocville group into every Codex event. Mutates `file`. */
+function installCodexHooksInto(file, command, opts = {}) {
+    return (0, hook_settings_js_1.installHookGroups)(file, command, exports.CODEX_HOOK_EVENTS, {
+        perEvent: Object.fromEntries(exports.CODEX_HOOK_EVENTS.map((event) => [
+            event,
+            event === 'SessionEnd' || event === 'Interrupt'
+                ? { timeout: 3 }
+                : { async: true, timeout: opts.timeout ?? 10 },
+        ])),
+    });
+}
+function buildCodexHookCommand(_cliPath) {
+    return (0, hook_settings_js_1.buildShimHookCommand)('codex');
+}
+function out(opts, msg) {
+    if (!opts.quiet)
+        console.log(msg);
+}
+/**
+ * Install Nocville hooks into `~/.codex/hooks.json` (same matcher-group JSON
+ * format as Claude Code). Merges with existing hooks, idempotent, keeps a
+ * one-time `.nocville-backup`. Codex requires new hooks to be reviewed and
+ * trusted once via `/hooks` before they run — we print that instruction.
+ */
+function setupCodexHooks(opts = {}) {
+    const hooksPath = opts.hooksPath ?? codexHooksPath();
+    const dir = (0, node_path_1.join)(hooksPath, '..');
+    if (!(0, node_fs_1.existsSync)(dir)) {
+        console.error(`${dir} does not exist — is Codex installed? Skipping Codex setup.`);
+        return false;
+    }
+    const file = (0, hook_settings_js_1.readJsonFile)(hooksPath);
+    if (file === null) {
+        console.error(`Could not parse ${hooksPath}; fix it (or move it aside) and re-run setup.`);
+        return false;
+    }
+    const creds = (0, user_config_js_1.persistCredentials)(opts);
+    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 { installed } = installCodexHooksInto(file, buildCodexHookCommand(cliPath), {
+        timeout: defaults_js_1.CODEX_DEFAULTS.hookTimeoutSeconds,
+    });
+    (0, hook_settings_js_1.writeJsonFile)(hooksPath, file);
+    out(opts, `✓ Codex: installed Nocville hooks for ${installed} events in ${hooksPath}`);
+    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, '  ➜ One-time step: start Codex and run /hooks to review and trust the Nocville');
+    out(opts, '    hooks (Codex skips new hooks until trusted).');
+    return true;
+}
+/** Remove all Nocville hooks from `~/.codex/hooks.json`. */
+function uninstallCodexHooks(opts = {}) {
+    const hooksPath = opts.hooksPath ?? codexHooksPath();
+    const file = (0, hook_settings_js_1.readJsonFile)(hooksPath);
+    if (!file || !(0, node_fs_1.existsSync)(hooksPath)) {
+        out(opts, 'Codex: no hooks.json — nothing to remove.');
+        return 0;
+    }
+    const removed = (0, hook_settings_js_1.removeHookGroups)(file);
+    if (removed > 0)
+        (0, hook_settings_js_1.writeJsonFile)(hooksPath, file);
+    out(opts, `✓ Codex: removed ${removed} Nocville hook(s) from ${hooksPath}`);
+    return removed;
+}
+//# sourceMappingURL=setup.js.map