botmux 3.4.2 → 3.5.0

package/dist/features/codex-notifier/event.js

@@ -0,0 +1,188 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+export const CODEX_NOTIFIER_PLUGIN_ID = 'codex-watch';
+export const MAX_CODEX_NOTIFIER_EVENT_BYTES = 64 * 1024;
+/** 飞书消息幂等键基于完整事件 ID，避免只截断长 ID 前缀造成碰撞。 */
+export function codexNotifierMessageUuid(eventId) {
+    return `cw_${createHash('sha256').update(eventId).digest('hex').slice(0, 47)}`;
+}
+/** 插件事件边界的可分类校验错误，供 HTTP 层映射 4xx 响应。 */
+export class CodexNotifierEventValidationError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'CodexNotifierEventValidationError';
+    }
+}
+const requiredText = (max) => z.string().trim().min(1).max(max);
+const CodexTaskCompletedEventSchema = z.object({
+    schemaVersion: z.literal(1),
+    eventId: requiredText(128),
+    type: z.literal('task.completed'),
+    source: z.literal('codex-desktop'),
+    clientSurface: z.enum(['codex-app', 'codex-cli']).optional(),
+    conversationKind: z.literal('side').optional(),
+    threadId: requiredText(256),
+    nativeTurnId: requiredText(256),
+    status: z.enum(['completed', 'failed', 'cancelled']),
+    title: requiredText(300).optional(),
+    cwd: requiredText(4096),
+    completedAt: z.string().datetime({ offset: true }),
+    finalPreview: requiredText(6500).optional(),
+}).strict();
+function plainObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function byteLengthOfObject(value) {
+    try {
+        return Buffer.byteLength(JSON.stringify(value), 'utf8');
+    }
+    catch (cause) {
+        throw new CodexNotifierEventValidationError('invalid_event', 'event payload is not serializable', { cause });
+    }
+}
+function decodePayload(input, maxBytes) {
+    if (typeof input !== 'string' && !Buffer.isBuffer(input)) {
+        if (byteLengthOfObject(input) > maxBytes) {
+            throw new CodexNotifierEventValidationError('payload_too_large', `event payload exceeds ${maxBytes} bytes`);
+        }
+        return input;
+    }
+    const bytes = Buffer.isBuffer(input) ? input.byteLength : Buffer.byteLength(input, 'utf8');
+    if (bytes > maxBytes) {
+        throw new CodexNotifierEventValidationError('payload_too_large', `event payload exceeds ${maxBytes} bytes`);
+    }
+    try {
+        return JSON.parse(Buffer.isBuffer(input) ? input.toString('utf8') : input);
+    }
+    catch (cause) {
+        throw new CodexNotifierEventValidationError('invalid_json', 'event payload is not valid JSON', { cause });
+    }
+}
+/**
+ * 校验 Codex 完成事件。严格拒绝额外字段、非普通对象和超大输入，避免跨进程边界
+ * 成为原型污染或无界内存入口。
+ */
+export function parseCodexNotifierEvent(input, maxBytes = MAX_CODEX_NOTIFIER_EVENT_BYTES) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) {
+        throw new CodexNotifierEventValidationError('invalid_event', 'maxBytes must be a positive safe integer');
+    }
+    const decoded = decodePayload(input, maxBytes);
+    if (!plainObject(decoded)) {
+        throw new CodexNotifierEventValidationError('invalid_event', 'event payload must be a plain object');
+    }
+    // 这些键即使只是普通 JSON 自有属性也没有业务含义，显式拒绝可让边界策略更清晰。
+    if (['__proto__', 'prototype', 'constructor'].some(key => Object.hasOwn(decoded, key))) {
+        throw new CodexNotifierEventValidationError('invalid_event', 'event payload contains a forbidden property');
+    }
+    const parsed = CodexTaskCompletedEventSchema.safeParse(decoded);
+    if (!parsed.success) {
+        throw new CodexNotifierEventValidationError('invalid_event', `invalid codex completion event: ${parsed.error.issues.map(issue => issue.message).join('; ')}`, { cause: parsed.error });
+    }
+    const expectedId = codexNotifierEventId({
+        source: parsed.data.source,
+        threadId: parsed.data.threadId,
+        nativeTurnId: parsed.data.nativeTurnId,
+        status: parsed.data.status,
+    });
+    if (parsed.data.eventId !== expectedId) {
+        throw new CodexNotifierEventValidationError('invalid_event', 'codex completion event id mismatch');
+    }
+    return parsed.data;
+}
+/** 兼容一个迁移周期的旧插件入口；内建链路直接调用 parseCodexNotifierEvent。 */
+export function parseCodexNotifierPluginEvent(pluginId, input, maxBytes = MAX_CODEX_NOTIFIER_EVENT_BYTES) {
+    if (pluginId !== CODEX_NOTIFIER_PLUGIN_ID) {
+        throw new CodexNotifierEventValidationError('invalid_plugin', `unsupported plugin event source: ${pluginId}`);
+    }
+    return parseCodexNotifierEvent(input, maxBytes);
+}
+function requiredHookText(value, name) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new CodexNotifierEventValidationError('invalid_event', `hook payload is missing ${name}`);
+    }
+    return value.trim();
+}
+function optionalSingleLine(value, maxLength) {
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value.replace(/[\u0000-\u001f\u007f]/g, ' ').replace(/\s+/g, ' ').trim();
+    if (!normalized)
+        return undefined;
+    const chars = Array.from(normalized);
+    return chars.length > maxLength ? `${chars.slice(0, maxLength - 1).join('')}…` : normalized;
+}
+function optionalMultiline(value, maxLength) {
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value
+        .replace(/\r\n?/g, '\n')
+        .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, ' ')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+    if (!normalized)
+        return undefined;
+    const chars = Array.from(normalized);
+    return chars.length > maxLength ? `${chars.slice(0, maxLength - 1).join('')}…` : normalized;
+}
+/** 事件 ID 只依赖 Codex 原生任务身份，Hook 重试不会生成第二条通知。 */
+export function codexNotifierEventId(input) {
+    return createHash('sha256')
+        .update(JSON.stringify([input.source, input.threadId, input.nativeTurnId, input.status]))
+        .digest('hex');
+}
+/** 把 Codex Stop Hook 的稳定字段转换成内建完成事件。 */
+export function createCodexNotifierEvent(payload, options = {}) {
+    if (payload.hook_event_name !== 'Stop') {
+        throw new CodexNotifierEventValidationError('invalid_event', 'unsupported Codex hook event');
+    }
+    const threadId = requiredHookText(payload.session_id, 'session_id');
+    const nativeTurnId = requiredHookText(payload.turn_id, 'turn_id');
+    const cwd = requiredHookText(payload.cwd, 'cwd');
+    return createCodexNotifierCompletionEvent({
+        threadId,
+        nativeTurnId,
+        status: 'completed',
+        cwd,
+        ...options,
+        finalPreview: options.finalPreview
+            ?? (typeof payload.last_assistant_message === 'string'
+                ? payload.last_assistant_message
+                : undefined),
+    });
+}
+/** 从 Hook 或 Codex App IPC 的终态构造同一种可靠完成事件。 */
+export function createCodexNotifierCompletionEvent(input) {
+    const threadId = requiredHookText(input.threadId, 'threadId');
+    const nativeTurnId = requiredHookText(input.nativeTurnId, 'nativeTurnId');
+    const cwd = requiredHookText(input.cwd, 'cwd');
+    const completedAt = input.completedAt ?? new Date().toISOString();
+    if (!Number.isFinite(Date.parse(completedAt))) {
+        throw new CodexNotifierEventValidationError('invalid_event', 'completedAt must be an ISO timestamp');
+    }
+    const identity = {
+        source: 'codex-desktop',
+        threadId,
+        nativeTurnId,
+        status: input.status,
+    };
+    const title = optionalSingleLine(input.title, 300);
+    const finalPreview = optionalMultiline(input.finalPreview, 6500);
+    return parseCodexNotifierEvent({
+        schemaVersion: 1,
+        eventId: codexNotifierEventId(identity),
+        type: 'task.completed',
+        ...identity,
+        ...(input.clientSurface ? { clientSurface: input.clientSurface } : {}),
+        ...(input.conversationKind ? { conversationKind: input.conversationKind } : {}),
+        cwd,
+        completedAt,
+        ...(title ? { title } : {}),
+        ...(finalPreview ? { finalPreview } : {}),
+    });
+}
+//# sourceMappingURL=event.js.map

package/dist/features/codex-notifier/event.js.map

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

package/dist/features/codex-notifier/hook-cli.d.ts

@@ -0,0 +1,23 @@
+import type { Readable } from 'node:stream';
+import { type CodexTurnContext } from './codex-context.js';
+import { type ResolvedCodexNotifierConfig } from './config.js';
+import { enqueueCodexNotifierEvent } from './outbox.js';
+import { type ScreenLockState } from './screen-lock.js';
+import { confirmCodexNotifierTurn, readConfirmedCodexNotifierTurn, removeConfirmedCodexNotifierTurn } from './confirmed-turn.js';
+export type CodexNotifierHookOutcome = 'enqueued' | 'disabled' | 'misconfigured' | 'managed' | 'tracked' | 'subagent' | 'internal' | 'unsupported' | 'screen_unlocked' | 'platform_unsupported';
+export interface CodexNotifierHookDeps {
+    env?: NodeJS.ProcessEnv;
+    dataDir?: string;
+    config?: ResolvedCodexNotifierConfig;
+    lockState?: ScreenLockState;
+    readContext?: (transcriptPath: unknown, turnId: unknown, sessionId: unknown) => CodexTurnContext;
+    enqueue?: typeof enqueueCodexNotifierEvent;
+    confirmTurn?: typeof confirmCodexNotifierTurn;
+    readConfirmedTurn?: typeof readConfirmedCodexNotifierTurn;
+    removeConfirmedTurn?: typeof removeConfirmedCodexNotifierTurn;
+}
+/** 处理一个 Codex 通知 Hook payload；所有跳过原因都显式返回，便于 Dashboard/测试诊断。 */
+export declare function processCodexNotifierHookPayload(payload: Record<string, unknown>, deps?: CodexNotifierHookDeps): CodexNotifierHookOutcome;
+/** CLI Hook 不得阻塞 Codex 流程；失败只在 DEBUG 下输出诊断并返回。 */
+export declare function runCodexNotifierHookCli(stream?: Readable, deps?: CodexNotifierHookDeps): Promise<CodexNotifierHookOutcome | 'error'>;
+//# sourceMappingURL=hook-cli.d.ts.map

package/dist/features/codex-notifier/hook-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-cli.d.ts","sourceRoot":"","sources":["../../../src/features/codex-notifier/hook-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAA8B,KAAK,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAA8C,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,gCAAgC,EAEjC,MAAM,qBAAqB,CAAC;AAK7B,MAAM,MAAM,wBAAwB,GAChC,UAAU,GACV,UAAU,GACV,eAAe,GACf,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,gBAAgB,CAAC;IACjG,OAAO,CAAC,EAAE,OAAO,yBAAyB,CAAC;IAC3C,WAAW,CAAC,EAAE,OAAO,wBAAwB,CAAC;IAC9C,iBAAiB,CAAC,EAAE,OAAO,8BAA8B,CAAC;IAC1D,mBAAmB,CAAC,EAAE,OAAO,gCAAgC,CAAC;CAC/D;AA6BD,gEAAgE;AAChE,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,GAAE,qBAA0B,GAC/B,wBAAwB,CA+E1B;AAcD,kDAAkD;AAClD,wBAAsB,uBAAuB,CAC3C,MAAM,GAAE,QAAwB,EAChC,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,wBAAwB,GAAG,OAAO,CAAC,CAS7C"}

package/dist/features/codex-notifier/hook-cli.js

@@ -0,0 +1,130 @@
+import { resolveBotmuxDataDir } from '../../core/data-dir.js';
+import { createCodexNotifierEvent } from './event.js';
+import { readCodexTurnContext } from './codex-context.js';
+import { resolveCodexNotifierConfig } from './config.js';
+import { enqueueCodexNotifierEvent } from './outbox.js';
+import { detectScreenLock, shouldNotifyForLockState } from './screen-lock.js';
+import { confirmCodexNotifierTurn, readConfirmedCodexNotifierTurn, removeConfirmedCodexNotifierTurn, } from './confirmed-turn.js';
+import { isInternalCodexPrompt } from './internal-turn.js';
+const MAX_STDIN_BYTES = 1024 * 1024;
+function isCodexAmbientSuggestionTurn(context, lastAssistantMessage) {
+    const prompt = context.prompt?.toLowerCase();
+    if (prompt?.includes('generate 0 to 3 hyperpersonalized suggestions for what this user can do with codex')
+        || prompt?.includes('upholding safety and compliance standards for codex ambient suggestions')) {
+        return true;
+    }
+    // Codex 的临时推荐线程当前不落 transcript，只能从其固定 JSON 结果识别。
+    // 已提取到真实用户问题时不能只凭回复形状过滤，避免误伤用户主动请求。
+    if (context.prompt || typeof lastAssistantMessage !== 'string')
+        return false;
+    try {
+        const parsed = JSON.parse(lastAssistantMessage);
+        return parsed !== null
+            && typeof parsed === 'object'
+            && !Array.isArray(parsed)
+            && Object.keys(parsed).length === 1
+            && Array.isArray(parsed.suggestions);
+    }
+    catch {
+        return false;
+    }
+}
+/** 处理一个 Codex 通知 Hook payload；所有跳过原因都显式返回，便于 Dashboard/测试诊断。 */
+export function processCodexNotifierHookPayload(payload, deps = {}) {
+    const env = deps.env ?? process.env;
+    if (env.BOTMUX_SESSION_ID?.trim())
+        return 'managed';
+    const eventName = payload.hook_event_name;
+    const dataDir = deps.dataDir ?? resolveBotmuxDataDir();
+    const removeConfirmedTurn = deps.removeConfirmedTurn ?? removeConfirmedCodexNotifierTurn;
+    const discardConfirmedTurn = () => {
+        if (eventName === 'Stop') {
+            removeConfirmedTurn(dataDir, payload.session_id, payload.turn_id);
+        }
+    };
+    const config = deps.config ?? resolveCodexNotifierConfig();
+    if (!config.enabled) {
+        discardConfirmedTurn();
+        return 'disabled';
+    }
+    if (!config.targetBotAppId) {
+        discardConfirmedTurn();
+        return 'misconfigured';
+    }
+    if (typeof payload.agent_id === 'string'
+        && payload.agent_id.trim()
+        && payload.agent_id !== payload.session_id) {
+        discardConfirmedTurn();
+        return 'subagent';
+    }
+    const readContext = deps.readContext ?? readCodexTurnContext;
+    if (eventName === 'UserPromptSubmit') {
+        const context = readContext(payload.transcript_path, payload.turn_id, payload.session_id);
+        const prompt = typeof payload.prompt === 'string' ? payload.prompt : context.prompt;
+        if (context.internal || isInternalCodexPrompt(prompt))
+            return 'internal';
+        const confirmTurn = deps.confirmTurn ?? confirmCodexNotifierTurn;
+        return confirmTurn(dataDir, payload.session_id, payload.turn_id, prompt) ? 'tracked' : 'internal';
+    }
+    if (eventName !== 'Stop')
+        return 'unsupported';
+    const lockState = deps.lockState ?? detectScreenLock();
+    if (lockState === 'unsupported' && config.notifyWhen === 'locked_only') {
+        discardConfirmedTurn();
+        return 'platform_unsupported';
+    }
+    if (!shouldNotifyForLockState(config.notifyWhen, lockState)) {
+        discardConfirmedTurn();
+        return 'screen_unlocked';
+    }
+    const context = readContext(payload.transcript_path, payload.turn_id, payload.session_id);
+    const readConfirmedTurn = deps.readConfirmedTurn ?? readConfirmedCodexNotifierTurn;
+    const confirmed = readConfirmedTurn(dataDir, payload.session_id, payload.turn_id);
+    const prompt = context.prompt ?? confirmed?.prompt;
+    if (context.internal
+        || isInternalCodexPrompt(prompt)
+        || isCodexAmbientSuggestionTurn(context, payload.last_assistant_message)
+        || !prompt) {
+        discardConfirmedTurn();
+        return 'internal';
+    }
+    const event = createCodexNotifierEvent(payload, {
+        clientSurface: context.clientSurface,
+        // title 只保存用户问题；卡片层统一拼接项目名，避免 project 重复。
+        title: prompt,
+        finalPreview: typeof payload.last_assistant_message === 'string' && payload.last_assistant_message.trim()
+            ? payload.last_assistant_message
+            : context.lastAssistantMessage,
+    });
+    const enqueue = deps.enqueue ?? enqueueCodexNotifierEvent;
+    enqueue(dataDir, config.targetBotAppId, event);
+    discardConfirmedTurn();
+    return 'enqueued';
+}
+async function readStdinJson(stream) {
+    let text = '';
+    for await (const chunk of stream) {
+        text += chunk.toString();
+        if (Buffer.byteLength(text) > MAX_STDIN_BYTES)
+            throw new Error('hook_payload_too_large');
+    }
+    if (!text.trim())
+        throw new Error('hook_payload_empty');
+    const parsed = JSON.parse(text);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        throw new Error('hook_payload_invalid');
+    return parsed;
+}
+/** CLI Hook 不得阻塞 Codex 流程；失败只在 DEBUG 下输出诊断并返回。 */
+export async function runCodexNotifierHookCli(stream = process.stdin, deps = {}) {
+    try {
+        return processCodexNotifierHookPayload(await readStdinJson(stream), deps);
+    }
+    catch (error) {
+        if (process.env.DEBUG === '1') {
+            process.stderr.write(`[codex-notifier] hook failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+        return 'error';
+    }
+}
+//# sourceMappingURL=hook-cli.js.map

package/dist/features/codex-notifier/hook-cli.js.map

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

package/dist/features/codex-notifier/hook-installer.d.ts

@@ -0,0 +1,19 @@
+export declare function codexHooksPath(env?: NodeJS.ProcessEnv, userHome?: string): string;
+export declare function botmuxCodexNotifierHookCommand(userHome?: string, nodePath?: string, platform?: NodeJS.Platform): string;
+/** Stop 与 UserPromptSubmit 都存在时才算完整安装，避免失去真实用户 turn 的强来源证明。 */
+export declare function isCodexNotifierHookInstalled(path?: string): boolean;
+/**
+ * 幂等安装 UserPromptSubmit + Stop Hook。前者确认用户 turn，后者据此过滤内部 turn。
+ * 会替换旧 checkout/旧 Node 路径，同时保留 Flux 和其他 Hook。
+ * 迁移期 legacy-stop 只保留 Stop，避免旧插件收到不认识的 UserPromptSubmit。
+ */
+export declare function installCodexNotifierHook(options?: {
+    path?: string;
+    command?: string;
+    mode?: 'full' | 'legacy-stop';
+}): {
+    path: string;
+    command: string;
+    changed: boolean;
+};
+//# sourceMappingURL=hook-installer.d.ts.map

package/dist/features/codex-notifier/hook-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-installer.d.ts","sourceRoot":"","sources":["../../../src/features/codex-notifier/hook-installer.ts"],"names":[],"mappings":"AAUA,wBAAgB,cAAc,CAAC,GAAG,oBAAc,EAAE,QAAQ,SAAY,GAAG,MAAM,CAK9E;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,SAAY,EACpB,QAAQ,SAAmB,EAC3B,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,CAOR;AAyDD,+DAA+D;AAC/D,wBAAgB,4BAA4B,CAAC,IAAI,SAAmB,GAAG,OAAO,CAQ7E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CAC1B,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA8D3D"}

package/dist/features/codex-notifier/hook-installer.js

@@ -0,0 +1,158 @@
+import { accessSync, constants, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, win32 } from 'node:path';
+import { atomicWriteFileSync } from '../../utils/atomic-write.js';
+function shellWord(value) {
+    if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(value))
+        return value;
+    return `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+export function codexHooksPath(env = process.env, userHome = homedir()) {
+    const codexHome = typeof env.CODEX_HOME === 'string' && env.CODEX_HOME.trim()
+        ? env.CODEX_HOME.trim()
+        : join(userHome, '.codex');
+    return join(codexHome, 'hooks.json');
+}
+export function botmuxCodexNotifierHookCommand(userHome = homedir(), nodePath = process.execPath, platform = process.platform) {
+    if (platform === 'win32') {
+        const shim = win32.join(userHome, '.botmux', 'bin', 'botmux.cmd');
+        return `"${shim.replaceAll('"', '""')}" codex-watch-hook`;
+    }
+    const path = [dirname(nodePath), '/opt/homebrew/bin', '/usr/local/bin', '/usr/bin', '/bin'].join(':');
+    return `/usr/bin/env PATH=${shellWord(path)} ${shellWord(join(userHome, '.botmux', 'bin', 'botmux'))} codex-watch-hook`;
+}
+function plainObject(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function botmuxShimFromCommand(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const match = value.match(/(?:^|\s)(?:'([^']*[\\/]\.botmux[\\/]bin[\\/]botmux(?:\.cmd)?)'|"([^"]*[\\/]\.botmux[\\/]bin[\\/]botmux(?:\.cmd)?)"|([^\s'"]*[\\/]\.botmux[\\/]bin[\\/]botmux(?:\.cmd)?))\s+codex-watch-hook(?:\s|$)/i);
+    return match?.[1] ?? match?.[2] ?? match?.[3];
+}
+function isBotmuxCodexNotifierCommand(value) {
+    return botmuxShimFromCommand(value) !== undefined;
+}
+function isRunnableBotmuxCodexNotifierCommand(value) {
+    const shim = botmuxShimFromCommand(value);
+    if (!shim)
+        return false;
+    try {
+        accessSync(shim, constants.X_OK);
+    }
+    catch {
+        return false;
+    }
+    if (typeof value !== 'string')
+        return false;
+    const pathMatch = value.match(/(?:^|\s)PATH=(?:'([^']*)'|"([^"]*)"|([^\s]+))/);
+    if (!pathMatch)
+        return true;
+    const path = pathMatch[1] ?? pathMatch[2] ?? pathMatch[3] ?? '';
+    return path.split(':').some(dir => {
+        if (!dir)
+            return false;
+        try {
+            accessSync(join(dir, 'node'), constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+function readHooksRoot(path) {
+    if (!existsSync(path))
+        return {};
+    const root = JSON.parse(readFileSync(path, 'utf8'));
+    if (!plainObject(root))
+        throw new Error('hooks_config_invalid_root');
+    return root;
+}
+const CODEX_NOTIFIER_HOOK_EVENTS = ['Stop', 'UserPromptSubmit'];
+function eventHasRunnableHook(root, eventName) {
+    const entries = root.hooks?.[eventName];
+    return Array.isArray(entries) && entries.some((entry) => Array.isArray(entry?.hooks)
+        && entry.hooks.some((hook) => hook?.type === 'command'
+            && isRunnableBotmuxCodexNotifierCommand(hook.command)));
+}
+/** Stop 与 UserPromptSubmit 都存在时才算完整安装，避免失去真实用户 turn 的强来源证明。 */
+export function isCodexNotifierHookInstalled(path = codexHooksPath()) {
+    try {
+        const root = readHooksRoot(path);
+        if (!plainObject(root.hooks))
+            return false;
+        return CODEX_NOTIFIER_HOOK_EVENTS.every(eventName => eventHasRunnableHook(root, eventName));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 幂等安装 UserPromptSubmit + Stop Hook。前者确认用户 turn，后者据此过滤内部 turn。
+ * 会替换旧 checkout/旧 Node 路径，同时保留 Flux 和其他 Hook。
+ * 迁移期 legacy-stop 只保留 Stop，避免旧插件收到不认识的 UserPromptSubmit。
+ */
+export function installCodexNotifierHook(options = {}) {
+    const path = options.path ?? codexHooksPath();
+    const requestedCommand = options.command ?? botmuxCodexNotifierHookCommand();
+    const mode = options.mode ?? 'full';
+    const root = readHooksRoot(path);
+    const original = JSON.stringify(root);
+    if (!Object.hasOwn(root, 'hooks'))
+        root.hooks = {};
+    if (!plainObject(root.hooks))
+        throw new Error('hooks_config_invalid_hooks');
+    let existingCommand;
+    for (const eventName of CODEX_NOTIFIER_HOOK_EVENTS) {
+        const entries = root.hooks[eventName];
+        if (entries !== undefined && !Array.isArray(entries)) {
+            throw new Error(`hooks_config_invalid_${eventName.toLowerCase()}`);
+        }
+        for (const entry of entries ?? []) {
+            for (const hook of Array.isArray(entry?.hooks) ? entry.hooks : []) {
+                if (!existingCommand
+                    && hook?.type === 'command'
+                    && isBotmuxCodexNotifierCommand(hook.command)
+                    && isRunnableBotmuxCodexNotifierCommand(hook.command)) {
+                    existingCommand = hook.command;
+                }
+            }
+        }
+    }
+    // 已信任的旧命令字节保持不变；只去重和收敛分组。新安装使用稳定 PATH。
+    const command = existingCommand ?? requestedCommand;
+    for (const eventName of CODEX_NOTIFIER_HOOK_EVENTS) {
+        const nextEntries = [];
+        for (const entry of root.hooks[eventName] ?? []) {
+            if (!plainObject(entry) || !Array.isArray(entry.hooks)) {
+                nextEntries.push(entry);
+                continue;
+            }
+            const remaining = entry.hooks.filter((hook) => !(hook?.type === 'command' && isBotmuxCodexNotifierCommand(hook.command)));
+            if (remaining.length > 0)
+                nextEntries.push({ ...entry, hooks: remaining });
+        }
+        if (mode === 'full' || eventName === 'Stop') {
+            nextEntries.push({
+                matcher: '*',
+                hooks: [{ type: 'command', command, timeout: 10 }],
+            });
+        }
+        if (nextEntries.length > 0)
+            root.hooks[eventName] = nextEntries;
+        else
+            delete root.hooks[eventName];
+    }
+    const changed = JSON.stringify(root) !== original;
+    if (changed) {
+        mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+        atomicWriteFileSync(path, `${JSON.stringify(root, null, 2)}\n`, {
+            mode: 0o600,
+            durable: true,
+            followTargetSymlink: false,
+        });
+    }
+    return { path, command, changed };
+}
+//# sourceMappingURL=hook-installer.js.map

package/dist/features/codex-notifier/hook-installer.js.map

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

package/dist/features/codex-notifier/index.d.ts

@@ -0,0 +1,21 @@
+export { CODEX_NOTIFIER_PLUGIN_ID, MAX_CODEX_NOTIFIER_EVENT_BYTES, CodexNotifierEventValidationError, codexNotifierEventId, codexNotifierMessageUuid, createCodexNotifierCompletionEvent, createCodexNotifierEvent, parseCodexNotifierEvent, parseCodexNotifierPluginEvent, } from './event.js';
+export { CodexNotifierEventStore, DEFAULT_MAX_CODEX_NOTIFIER_EVENTS, DEFAULT_MAX_CODEX_NOTIFIER_RECEIPTS, } from './event-store.js';
+export type { CodexNotifierDeliveryUpdate, RecordCodexNotifierEventResult, } from './event-store.js';
+export { buildCodexCompletionCard, buildCodexNotifierResultCard, } from './card.js';
+export { createCodexNotifierCardActionHandler, type CodexNotifierCardActionDeps, } from './card-action.js';
+export { canOpenCodexAppThread, isCodexAppThreadId, openCodexAppThread, type CodexAppOpenResult, type CodexAppOpenRunner, } from './app-opener.js';
+export { startCodexNotifierAdoptionSession } from './adoption.js';
+export { resolveCodexNotifierConfig, type ResolvedCodexNotifierConfig, } from './config.js';
+export { parseCodexTurnContext, readCodexTurnContext, type CodexTurnContext, } from './codex-context.js';
+export { CODEX_NOTIFIER_CONFIRMED_TURN_TTL_MS, MAX_CODEX_NOTIFIER_CONFIRMED_TURNS, confirmCodexNotifierTurn, pruneConfirmedCodexNotifierTurns, readConfirmedCodexNotifierTurn, removeConfirmedCodexNotifierTurn, type ConfirmedCodexTurn, } from './confirmed-turn.js';
+export { isInternalCodexPrompt, isInternalCodexSessionMeta, } from './internal-turn.js';
+export { detectScreenLock, parseMacScreenLock, shouldNotifyForLockState, type ScreenLockState, } from './screen-lock.js';
+export { botmuxCodexNotifierHookCommand, codexHooksPath, installCodexNotifierHook, isCodexNotifierHookInstalled, } from './hook-installer.js';
+export { processCodexNotifierHookPayload, runCodexNotifierHookCli, type CodexNotifierHookDeps, type CodexNotifierHookOutcome, } from './hook-cli.js';
+export { enqueueCodexNotifierEvent, listCodexNotifierOutbox, materializeCodexNotifierOutboxEvent, parseCodexNotifierOutboxItem, quarantineCodexNotifierOutboxItem, readCodexNotifierOutboxItem, removeCodexNotifierOutboxItem, type CodexNotifierOutboxItem, } from './outbox.js';
+export { CODEX_NOTIFIER_WORKER_STALE_MS, CodexNotifierOutboxWorker, isCodexNotifierWorkerStateFresh, readCodexNotifierWorkerState, runCodexNotifierWorkerSupervisor, type CodexNotifierDisposition, type CodexNotifierOutboxWorkerOptions, type CodexNotifierWorkerSupervisorOptions, type CodexNotifierWorkerState, } from './outbox-worker.js';
+export { acquireCodexNotifierWorkerLease, type CodexNotifierWorkerLease, } from './worker-lock.js';
+export { applyCodexConversationPatches, CodexSideConversationMonitor, CodexSideConversationTracker, createSideConversationCompletionEvent, listRecentCodexVisualizationThreads, runCodexSideConversationMonitor, type CodexConversationPatch, type CodexSideConversationMonitorOptions, type CodexVisualizationThread, } from './side-conversation-monitor.js';
+export { emitCodexNotifierOutboxItem } from './emitter.js';
+export type { CodexClientSurface, CodexConversationKind, CodexNotifierDelivery, CodexNotifierDeliveryStatus, CodexNotifierEventRecord, CodexTaskCompletedEvent, CodexTaskSource, CodexTaskStatus, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/codex-notifier/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/codex-notifier/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,iCAAiC,EACjC,oBAAoB,EACpB,wBAAwB,EACxB,kCAAkC,EAClC,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,oCAAoC,EACpC,KAAK,2BAA2B,GACjC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,0BAA0B,EAC1B,KAAK,2BAA2B,GACjC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EAClC,wBAAwB,EACxB,gCAAgC,EAChC,8BAA8B,EAC9B,gCAAgC,EAChC,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,8BAA8B,EAC9B,cAAc,EACd,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,+BAA+B,EAC/B,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,mCAAmC,EACnC,4BAA4B,EAC5B,iCAAiC,EACjC,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,4BAA4B,EAC5B,gCAAgC,EAChC,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACrC,KAAK,oCAAoC,EACzC,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,+BAA+B,EAC/B,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,qCAAqC,EACrC,mCAAmC,EACnC,+BAA+B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,mCAAmC,EACxC,KAAK,wBAAwB,GAC9B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/features/codex-notifier/index.js

@@ -0,0 +1,19 @@
+export { CODEX_NOTIFIER_PLUGIN_ID, MAX_CODEX_NOTIFIER_EVENT_BYTES, CodexNotifierEventValidationError, codexNotifierEventId, codexNotifierMessageUuid, createCodexNotifierCompletionEvent, createCodexNotifierEvent, parseCodexNotifierEvent, parseCodexNotifierPluginEvent, } from './event.js';
+export { CodexNotifierEventStore, DEFAULT_MAX_CODEX_NOTIFIER_EVENTS, DEFAULT_MAX_CODEX_NOTIFIER_RECEIPTS, } from './event-store.js';
+export { buildCodexCompletionCard, buildCodexNotifierResultCard, } from './card.js';
+export { createCodexNotifierCardActionHandler, } from './card-action.js';
+export { canOpenCodexAppThread, isCodexAppThreadId, openCodexAppThread, } from './app-opener.js';
+export { startCodexNotifierAdoptionSession } from './adoption.js';
+export { resolveCodexNotifierConfig, } from './config.js';
+export { parseCodexTurnContext, readCodexTurnContext, } from './codex-context.js';
+export { CODEX_NOTIFIER_CONFIRMED_TURN_TTL_MS, MAX_CODEX_NOTIFIER_CONFIRMED_TURNS, confirmCodexNotifierTurn, pruneConfirmedCodexNotifierTurns, readConfirmedCodexNotifierTurn, removeConfirmedCodexNotifierTurn, } from './confirmed-turn.js';
+export { isInternalCodexPrompt, isInternalCodexSessionMeta, } from './internal-turn.js';
+export { detectScreenLock, parseMacScreenLock, shouldNotifyForLockState, } from './screen-lock.js';
+export { botmuxCodexNotifierHookCommand, codexHooksPath, installCodexNotifierHook, isCodexNotifierHookInstalled, } from './hook-installer.js';
+export { processCodexNotifierHookPayload, runCodexNotifierHookCli, } from './hook-cli.js';
+export { enqueueCodexNotifierEvent, listCodexNotifierOutbox, materializeCodexNotifierOutboxEvent, parseCodexNotifierOutboxItem, quarantineCodexNotifierOutboxItem, readCodexNotifierOutboxItem, removeCodexNotifierOutboxItem, } from './outbox.js';
+export { CODEX_NOTIFIER_WORKER_STALE_MS, CodexNotifierOutboxWorker, isCodexNotifierWorkerStateFresh, readCodexNotifierWorkerState, runCodexNotifierWorkerSupervisor, } from './outbox-worker.js';
+export { acquireCodexNotifierWorkerLease, } from './worker-lock.js';
+export { applyCodexConversationPatches, CodexSideConversationMonitor, CodexSideConversationTracker, createSideConversationCompletionEvent, listRecentCodexVisualizationThreads, runCodexSideConversationMonitor, } from './side-conversation-monitor.js';
+export { emitCodexNotifierOutboxItem } from './emitter.js';
+//# sourceMappingURL=index.js.map

package/dist/features/codex-notifier/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/codex-notifier/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,iCAAiC,EACjC,oBAAoB,EACpB,wBAAwB,EACxB,kCAAkC,EAClC,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,oCAAoC,GAErC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GAGnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,0BAA0B,GAE3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EAClC,wBAAwB,EACxB,gCAAgC,EAChC,8BAA8B,EAC9B,gCAAgC,GAEjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,8BAA8B,EAC9B,cAAc,EACd,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,+BAA+B,EAC/B,uBAAuB,GAGxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,mCAAmC,EACnC,4BAA4B,EAC5B,iCAAiC,EACjC,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,4BAA4B,EAC5B,gCAAgC,GAKjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,+BAA+B,GAEhC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,qCAAqC,EACrC,mCAAmC,EACnC,+BAA+B,GAIhC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC"}

package/dist/features/codex-notifier/internal-turn.d.ts

@@ -0,0 +1,5 @@
+/** 识别 Codex Desktop 自动创建的后台任务，避免把内部 Agent 的 Stop 当成用户任务完成。 */
+export declare function isInternalCodexPrompt(prompt: unknown): boolean;
+/** session_meta.source 是协议级来源；出现 internal/subagent 时不属于用户主任务。 */
+export declare function isInternalCodexSessionMeta(meta: unknown): boolean;
+//# sourceMappingURL=internal-turn.d.ts.map