@a5c-ai/hooks-mux-adapter-codex 5.0.1-staging.37ca18bd

package/dist/adapter.d.ts

@@ -0,0 +1,12 @@
+import type { AdapterCapabilities } from '@a5c-ai/hooks-mux-core';
+/**
+ * Creates the Codex adapter with its capability metadata.
+ *
+ * Codex CLI is a shell-hook adapter with experimental status.
+ * Tool interception is partial (Bash-only), and env propagation
+ * is wrapper-based only -- there is no native env file mechanism.
+ *
+ * Spec section 17.2.
+ */
+export declare function createAdapter(): AdapterCapabilities;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAqBnD"}

package/dist/adapter.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+/**
+ * Creates the Codex adapter with its capability metadata.
+ *
+ * Codex CLI is a shell-hook adapter with experimental status.
+ * Tool interception is partial (Bash-only), and env propagation
+ * is wrapper-based only -- there is no native env file mechanism.
+ *
+ * Spec section 17.2.
+ */
+function createAdapter() {
+    return {
+        name: 'codex',
+        family: 'shell-hook',
+        sessionIdQuality: 'native',
+        supportsOrderedFanout: true,
+        supportsNativeAdditionalContext: false,
+        supportsBlock: true,
+        supportsAsk: false,
+        supportsToolInputMutation: false,
+        supportsToolResultMutation: false,
+        supportsPersistedEnv: false,
+        envPersistenceMode: 'wrapper_only',
+        toolInterceptionScope: 'partial_shell_only',
+        notes: [
+            'experimental',
+            'tool interception is bash-only',
+            'multiple matching hooks can launch concurrently',
+            'many parsed output fields currently fail open',
+        ],
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":";;AAWA,sCAqBC;AA9BD;;;;;;;;GAQG;AACH,SAAgB,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,YAAY;QACpB,gBAAgB,EAAE,QAAQ;QAC1B,qBAAqB,EAAE,IAAI;QAC3B,+BAA+B,EAAE,KAAK;QACtC,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,yBAAyB,EAAE,KAAK;QAChC,0BAA0B,EAAE,KAAK;QACjC,oBAAoB,EAAE,KAAK;QAC3B,kBAAkB,EAAE,cAAc;QAClC,qBAAqB,EAAE,oBAAoB;QAC3C,KAAK,EAAE;YACL,cAAc;YACd,gCAAgC;YAChC,iDAAiD;YACjD,+CAA+C;SAChD;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createAdapter } from './adapter';
+export { CODEX_PHASE_MAPPINGS, findMapping } from './mappings';
+export { normalizeCodexEvent, parseStdin, extractSessionId, ADAPTER_NAME, } from './normalizer';
+export type { CodexSessionStartPayload, CodexUserPromptPayload, CodexStopPayload, CodexToolPayload, } from './normalizer';
+export { renderCodexOutput, isFieldSupportedForEvent } from './renderer';
+export { resolveSessionId, isValidSessionId } from './session-resolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG/D,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidSessionId = exports.resolveSessionId = exports.isFieldSupportedForEvent = exports.renderCodexOutput = exports.ADAPTER_NAME = exports.extractSessionId = exports.parseStdin = exports.normalizeCodexEvent = exports.findMapping = exports.CODEX_PHASE_MAPPINGS = exports.createAdapter = void 0;
+// Adapter capabilities
+var adapter_1 = require("./adapter");
+Object.defineProperty(exports, "createAdapter", { enumerable: true, get: function () { return adapter_1.createAdapter; } });
+// Phase mappings
+var mappings_1 = require("./mappings");
+Object.defineProperty(exports, "CODEX_PHASE_MAPPINGS", { enumerable: true, get: function () { return mappings_1.CODEX_PHASE_MAPPINGS; } });
+Object.defineProperty(exports, "findMapping", { enumerable: true, get: function () { return mappings_1.findMapping; } });
+// Normalizer
+var normalizer_1 = require("./normalizer");
+Object.defineProperty(exports, "normalizeCodexEvent", { enumerable: true, get: function () { return normalizer_1.normalizeCodexEvent; } });
+Object.defineProperty(exports, "parseStdin", { enumerable: true, get: function () { return normalizer_1.parseStdin; } });
+Object.defineProperty(exports, "extractSessionId", { enumerable: true, get: function () { return normalizer_1.extractSessionId; } });
+Object.defineProperty(exports, "ADAPTER_NAME", { enumerable: true, get: function () { return normalizer_1.ADAPTER_NAME; } });
+// Renderer
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "renderCodexOutput", { enumerable: true, get: function () { return renderer_1.renderCodexOutput; } });
+Object.defineProperty(exports, "isFieldSupportedForEvent", { enumerable: true, get: function () { return renderer_1.isFieldSupportedForEvent; } });
+// Session resolver
+var session_resolver_1 = require("./session-resolver");
+Object.defineProperty(exports, "resolveSessionId", { enumerable: true, get: function () { return session_resolver_1.resolveSessionId; } });
+Object.defineProperty(exports, "isValidSessionId", { enumerable: true, get: function () { return session_resolver_1.isValidSessionId; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uBAAuB;AACvB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AAEtB,iBAAiB;AACjB,uCAA+D;AAAtD,gHAAA,oBAAoB,OAAA;AAAE,uGAAA,WAAW,OAAA;AAE1C,aAAa;AACb,2CAKsB;AAJpB,iHAAA,mBAAmB,OAAA;AACnB,wGAAA,UAAU,OAAA;AACV,8GAAA,gBAAgB,OAAA;AAChB,0GAAA,YAAY,OAAA;AASd,WAAW;AACX,uCAAyE;AAAhE,6GAAA,iBAAiB,OAAA;AAAE,oHAAA,wBAAwB,OAAA;AAEpD,mBAAmB;AACnB,uDAAwE;AAA/D,oHAAA,gBAAgB,OAAA;AAAE,oHAAA,gBAAgB,OAAA"}

package/dist/mappings.d.ts

@@ -0,0 +1,17 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-mux-core';
+/**
+ * Codex native event to canonical phase mapping table.
+ *
+ * Codex CLI hooks use a similar event naming scheme to Claude Code,
+ * but with an experimental/limited surface. Tool-level hooks only
+ * cover Bash execution and are incomplete (spec section 17.2).
+ *
+ * Events documented in Codex hooks.json: SessionStart, UserPromptSubmit,
+ * Stop, PreToolUse, PostToolUse (Bash commands only).
+ */
+export declare const CODEX_PHASE_MAPPINGS: PhaseMapping[];
+/**
+ * Quick lookup from native event name to phase mapping.
+ */
+export declare function findMapping(nativeEventName: string): PhaseMapping | undefined;
+//# sourceMappingURL=mappings.d.ts.map

package/dist/mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.d.ts","sourceRoot":"","sources":["../src/mappings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,YAAY,EA0D9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7E"}

package/dist/mappings.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODEX_PHASE_MAPPINGS = void 0;
+exports.findMapping = findMapping;
+/**
+ * Codex native event to canonical phase mapping table.
+ *
+ * Codex CLI hooks use a similar event naming scheme to Claude Code,
+ * but with an experimental/limited surface. Tool-level hooks only
+ * cover Bash execution and are incomplete (spec section 17.2).
+ *
+ * Events documented in Codex hooks.json: SessionStart, UserPromptSubmit,
+ * Stop, PreToolUse, PostToolUse (Bash commands only).
+ */
+exports.CODEX_PHASE_MAPPINGS = [
+    // --- Session lifecycle ---
+    {
+        canonicalPhase: 'session.start',
+        nativeHook: 'SessionStart',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'Bootstrap event; output is largely ignored by Codex runtime',
+    },
+    {
+        canonicalPhase: 'session.end',
+        nativeHook: 'SessionEnd',
+        supportLevel: 'lossy',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'Codex may not reliably fire SessionEnd in all exit paths',
+    },
+    // --- Turn lifecycle ---
+    {
+        canonicalPhase: 'turn.user_prompt_submitted',
+        nativeHook: 'UserPromptSubmit',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'turn',
+    },
+    {
+        canonicalPhase: 'turn.stop',
+        nativeHook: 'Stop',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'turn',
+    },
+    // --- Tool lifecycle (Bash-only, incomplete) ---
+    {
+        canonicalPhase: 'tool.before',
+        nativeHook: 'PreToolUse',
+        supportLevel: 'lossy',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'tool',
+        notes: 'Bash-only; non-Bash tool calls are not intercepted',
+    },
+    {
+        canonicalPhase: 'tool.after',
+        nativeHook: 'PostToolUse',
+        supportLevel: 'lossy',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'tool',
+        notes: 'Bash-only; non-Bash tool calls are not intercepted',
+    },
+];
+/**
+ * Quick lookup from native event name to phase mapping.
+ */
+function findMapping(nativeEventName) {
+    return exports.CODEX_PHASE_MAPPINGS.find((m) => m.nativeHook === nativeEventName);
+}
+//# sourceMappingURL=mappings.js.map

package/dist/mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.js","sourceRoot":"","sources":["../src/mappings.ts"],"names":[],"mappings":";;;AA2EA,kCAEC;AA3ED;;;;;;;;;GASG;AACU,QAAA,oBAAoB,GAAmB;IAClD,4BAA4B;IAC5B;QACE,cAAc,EAAE,eAAe;QAC/B,UAAU,EAAE,cAAc;QAC1B,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,6DAA6D;KACrE;IACD;QACE,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,YAAY;QACxB,YAAY,EAAE,OAAO;QACrB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,0DAA0D;KAClE;IAED,yBAAyB;IACzB;QACE,cAAc,EAAE,4BAA4B;QAC5C,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;KACd;IACD;QACE,cAAc,EAAE,WAAW;QAC3B,UAAU,EAAE,MAAM;QAClB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;KACd;IAED,iDAAiD;IACjD;QACE,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,YAAY;QACxB,YAAY,EAAE,OAAO;QACrB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,oDAAoD;KAC5D;IACD;QACE,cAAc,EAAE,YAAY;QAC5B,UAAU,EAAE,aAAa;QACzB,YAAY,EAAE,OAAO;QACrB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,oDAAoD;KAC5D;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,WAAW,CAAC,eAAuB;IACjD,OAAO,4BAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,eAAe,CAAC,CAAC;AAC5E,CAAC"}

package/dist/normalizer.d.ts

@@ -0,0 +1,63 @@
+import { type UnifiedHookEvent } from '@a5c-ai/hooks-mux-core';
+/** The adapter identifier used in all normalized events. */
+export declare const ADAPTER_NAME = "codex";
+/**
+ * Shape of a Codex SessionStart stdin payload.
+ * Fields may be absent or null -- fail open per spec 17.2.
+ */
+export interface CodexSessionStartPayload {
+    session_id?: string;
+    cwd?: string;
+    model?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+/**
+ * Shape of a Codex UserPromptSubmit stdin payload.
+ */
+export interface CodexUserPromptPayload {
+    session_id?: string;
+    prompt?: string;
+    cwd?: string;
+    [key: string]: unknown;
+}
+/**
+ * Shape of a Codex Stop stdin payload.
+ */
+export interface CodexStopPayload {
+    session_id?: string;
+    reason?: string;
+    stop_hook_active?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Shape of a Codex PreToolUse / PostToolUse stdin payload.
+ */
+export interface CodexToolPayload {
+    session_id?: string;
+    tool_name?: string;
+    tool_call_id?: string;
+    tool_input?: unknown;
+    tool_output?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Parse raw stdin input into a typed object.
+ * Codex hooks receive JSON on stdin. If parsing fails, return empty object
+ * (fail-open per spec 17.2).
+ */
+export declare function parseStdin(raw: unknown): Record<string, unknown>;
+/**
+ * Extract session_id from stdin payload.
+ * Codex provides a native session_id in most events.
+ */
+export declare function extractSessionId(payload: Record<string, unknown>): string | null;
+/**
+ * Normalize a raw Codex hook invocation into a UnifiedHookEvent.
+ *
+ * @param rawEventName - The native Codex event name (e.g. 'SessionStart', 'Stop')
+ * @param stdinPayload - Raw stdin content (string or parsed object)
+ * @param env - Environment variables at invocation time
+ */
+export declare function normalizeCodexEvent(rawEventName: string, stdinPayload: unknown, env?: Record<string, string>): UnifiedHookEvent;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,gBAAgB,EAAyB,MAAM,wBAAwB,CAAC;AAGtG,4DAA4D;AAC5D,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBhE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAKhF;AAgBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,OAAO,EACrB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,gBAAgB,CA0ClB"}

package/dist/normalizer.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_NAME = void 0;
+exports.parseStdin = parseStdin;
+exports.extractSessionId = extractSessionId;
+exports.normalizeCodexEvent = normalizeCodexEvent;
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+const mappings_1 = require("./mappings");
+/** The adapter identifier used in all normalized events. */
+exports.ADAPTER_NAME = 'codex';
+/**
+ * Parse raw stdin input into a typed object.
+ * Codex hooks receive JSON on stdin. If parsing fails, return empty object
+ * (fail-open per spec 17.2).
+ */
+function parseStdin(raw) {
+    if (raw == null)
+        return {};
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // fail open
+        }
+        return {};
+    }
+    if (typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    return {};
+}
+/**
+ * Extract session_id from stdin payload.
+ * Codex provides a native session_id in most events.
+ */
+function extractSessionId(payload) {
+    if (typeof payload['session_id'] === 'string' && payload['session_id'].length > 0) {
+        return payload['session_id'];
+    }
+    return null;
+}
+/**
+ * Extract tool metadata from a PreToolUse/PostToolUse payload.
+ */
+function extractToolFields(payload) {
+    const fields = {};
+    if (typeof payload['tool_name'] === 'string') {
+        fields['HOOKS_PROXY_TOOL_NAME'] = payload['tool_name'];
+    }
+    if (typeof payload['tool_call_id'] === 'string') {
+        fields['HOOKS_PROXY_TOOL_CALL_ID'] = payload['tool_call_id'];
+    }
+    return fields;
+}
+/**
+ * Normalize a raw Codex hook invocation into a UnifiedHookEvent.
+ *
+ * @param rawEventName - The native Codex event name (e.g. 'SessionStart', 'Stop')
+ * @param stdinPayload - Raw stdin content (string or parsed object)
+ * @param env - Environment variables at invocation time
+ */
+function normalizeCodexEvent(rawEventName, stdinPayload, env = {}) {
+    const parsed = parseStdin(stdinPayload);
+    // Enrich env with Codex-specific fields extracted from stdin
+    const enrichedEnv = { ...env };
+    const sessionId = extractSessionId(parsed);
+    if (sessionId && !enrichedEnv['HOOKS_PROXY_SESSION_ID']) {
+        enrichedEnv['HOOKS_PROXY_SESSION_ID'] = sessionId;
+    }
+    if (typeof parsed['cwd'] === 'string' && !enrichedEnv['HOOKS_PROXY_CWD']) {
+        enrichedEnv['HOOKS_PROXY_CWD'] = parsed['cwd'];
+    }
+    if (typeof parsed['model'] === 'string' && !enrichedEnv['HOOKS_PROXY_MODEL']) {
+        enrichedEnv['HOOKS_PROXY_MODEL'] = parsed['model'];
+    }
+    if (typeof parsed['source'] === 'string' && !enrichedEnv['HOOKS_PROXY_SOURCE']) {
+        enrichedEnv['HOOKS_PROXY_SOURCE'] = parsed['source'];
+    }
+    // Tool-specific env enrichment
+    if (rawEventName === 'PreToolUse' || rawEventName === 'PostToolUse') {
+        const toolFields = extractToolFields(parsed);
+        for (const [k, v] of Object.entries(toolFields)) {
+            if (!enrichedEnv[k]) {
+                enrichedEnv[k] = v;
+            }
+        }
+    }
+    const options = {
+        adapter: exports.ADAPTER_NAME,
+        rawEventName,
+        stdinPayload: parsed,
+        env: enrichedEnv,
+        adapterMappings: mappings_1.CODEX_PHASE_MAPPINGS,
+    };
+    return (0, hooks_mux_core_1.normalizeEvent)(options);
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/normalizer.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,20 @@
+import type { MergedExecutionResult } from '@a5c-ai/hooks-mux-core';
+/**
+ * Render a merged execution result into Codex-native output JSON.
+ *
+ * Only includes fields that are documented for the given native event type.
+ * Unsupported fields are silently dropped (fail-open behavior per spec).
+ *
+ * @param mergedResult - The merged result from multi-hook fan-out
+ * @param nativeEventName - The original Codex event name
+ * @returns Codex-native output object, and list of dropped fields
+ */
+export declare function renderCodexOutput(mergedResult: MergedExecutionResult, nativeEventName: string): {
+    output: Record<string, unknown>;
+    droppedFields: string[];
+};
+/**
+ * Check whether a given output field is supported for a native event.
+ */
+export declare function isFieldSupportedForEvent(field: string, nativeEventName: string): boolean;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAiDpE;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,EACnC,eAAe,EAAE,MAAM,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CA0B9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAGxF"}

package/dist/renderer.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderCodexOutput = renderCodexOutput;
+exports.isFieldSupportedForEvent = isFieldSupportedForEvent;
+/**
+ * Codex native output fields that are documented/supported per event type.
+ *
+ * Codex output semantics are limited -- many fields fail open
+ * (spec section 17.2). Only emit fields that are documented.
+ */
+/** Output fields supported on UserPromptSubmit. */
+const USER_PROMPT_SUBMIT_FIELDS = new Set([
+    'decision',
+    'reason',
+    'systemMessage',
+]);
+/** Output fields supported on Stop. */
+const STOP_FIELDS = new Set([
+    'continueSession',
+    'stopReason',
+    'reason',
+]);
+/** Output fields supported on PreToolUse. */
+const TOOL_BEFORE_FIELDS = new Set([
+    'decision',
+    'reason',
+]);
+/** Output fields supported on PostToolUse. */
+const TOOL_AFTER_FIELDS = new Set([
+    'suppressOutput',
+    'reason',
+]);
+/** Output fields supported on SessionStart (mostly ignored). */
+const SESSION_START_FIELDS = new Set([
+    'reason',
+]);
+/** Map native event names to their supported output field sets. */
+const SUPPORTED_FIELDS_BY_EVENT = {
+    SessionStart: SESSION_START_FIELDS,
+    UserPromptSubmit: USER_PROMPT_SUBMIT_FIELDS,
+    Stop: STOP_FIELDS,
+    PreToolUse: TOOL_BEFORE_FIELDS,
+    PostToolUse: TOOL_AFTER_FIELDS,
+};
+/**
+ * Render a merged execution result into Codex-native output JSON.
+ *
+ * Only includes fields that are documented for the given native event type.
+ * Unsupported fields are silently dropped (fail-open behavior per spec).
+ *
+ * @param mergedResult - The merged result from multi-hook fan-out
+ * @param nativeEventName - The original Codex event name
+ * @returns Codex-native output object, and list of dropped fields
+ */
+function renderCodexOutput(mergedResult, nativeEventName) {
+    const supportedFields = SUPPORTED_FIELDS_BY_EVENT[nativeEventName] ?? new Set();
+    const output = {};
+    const droppedFields = [];
+    // Candidate output fields from the merged result
+    const candidates = [
+        { key: 'decision', value: mergedResult.decision, isEmpty: mergedResult.decision === 'noop' },
+        { key: 'reason', value: mergedResult.reason, isEmpty: !mergedResult.reason },
+        { key: 'systemMessage', value: mergedResult.systemMessage, isEmpty: !mergedResult.systemMessage },
+        { key: 'continueSession', value: mergedResult.continueSession, isEmpty: mergedResult.continueSession === true },
+        { key: 'stopReason', value: mergedResult.stopReason, isEmpty: !mergedResult.stopReason },
+        { key: 'suppressOutput', value: mergedResult.suppressOutput, isEmpty: !mergedResult.suppressOutput },
+    ];
+    for (const candidate of candidates) {
+        if (candidate.isEmpty)
+            continue;
+        if (supportedFields.has(candidate.key)) {
+            output[candidate.key] = candidate.value;
+        }
+        else {
+            droppedFields.push(candidate.key);
+        }
+    }
+    return { output, droppedFields };
+}
+/**
+ * Check whether a given output field is supported for a native event.
+ */
+function isFieldSupportedForEvent(field, nativeEventName) {
+    const supported = SUPPORTED_FIELDS_BY_EVENT[nativeEventName];
+    return supported ? supported.has(field) : false;
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

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

package/dist/session-resolver.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Resolve session ID from Codex hook invocation context.
+ *
+ * Codex provides a native session_id in stdin payloads, giving it
+ * 'native' sessionIdQuality in the capability model.
+ *
+ * Resolution precedence (per spec 9.2):
+ *   1. Explicit --session-id CLI flag (handled upstream)
+ *   2. Explicit AGENT_SESSION_ID env var
+ *   3. Native session_id from stdin payload
+ *   4. CODEX_THREAD_ID env var (Codex-specific)
+ *   5. null (no session; caller decides fallback)
+ */
+/**
+ * Extract session ID from Codex stdin payload and environment.
+ *
+ * @param stdinPayload - Parsed stdin JSON from Codex hook
+ * @param env - Environment variables at invocation time
+ * @returns Resolved session ID or null
+ */
+export declare function resolveSessionId(stdinPayload: Record<string, unknown>, env?: Record<string, string>): string | null;
+/**
+ * Validate that a session ID looks reasonable.
+ * Codex session IDs are typically UUIDs or similar opaque strings.
+ */
+export declare function isValidSessionId(sessionId: string): boolean;
+//# sourceMappingURL=session-resolver.d.ts.map

package/dist/session-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.d.ts","sourceRoot":"","sources":["../src/session-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,MAAM,GAAG,IAAI,CAoBf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG3D"}

package/dist/session-resolver.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Resolve session ID from Codex hook invocation context.
+ *
+ * Codex provides a native session_id in stdin payloads, giving it
+ * 'native' sessionIdQuality in the capability model.
+ *
+ * Resolution precedence (per spec 9.2):
+ *   1. Explicit --session-id CLI flag (handled upstream)
+ *   2. Explicit AGENT_SESSION_ID env var
+ *   3. Native session_id from stdin payload
+ *   4. CODEX_THREAD_ID env var (Codex-specific)
+ *   5. null (no session; caller decides fallback)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = resolveSessionId;
+exports.isValidSessionId = isValidSessionId;
+/**
+ * Extract session ID from Codex stdin payload and environment.
+ *
+ * @param stdinPayload - Parsed stdin JSON from Codex hook
+ * @param env - Environment variables at invocation time
+ * @returns Resolved session ID or null
+ */
+function resolveSessionId(stdinPayload, env = {}) {
+    // Priority 1: explicit env override
+    const explicit = env['AGENT_SESSION_ID'];
+    if (typeof explicit === 'string' && explicit.length > 0) {
+        return explicit;
+    }
+    // Priority 2: native session_id from stdin payload
+    const native = stdinPayload['session_id'];
+    if (typeof native === 'string' && native.length > 0) {
+        return native;
+    }
+    // Priority 3: Codex-specific env var
+    const codexThreadId = env['CODEX_THREAD_ID'];
+    if (typeof codexThreadId === 'string' && codexThreadId.length > 0) {
+        return codexThreadId;
+    }
+    return null;
+}
+/**
+ * Validate that a session ID looks reasonable.
+ * Codex session IDs are typically UUIDs or similar opaque strings.
+ */
+function isValidSessionId(sessionId) {
+    // Accept non-empty strings of reasonable length
+    return sessionId.length > 0 && sessionId.length <= 256;
+}
+//# sourceMappingURL=session-resolver.js.map

package/dist/session-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.js","sourceRoot":"","sources":["../src/session-resolver.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AASH,4CAuBC;AAMD,4CAGC;AAvCD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,YAAqC,EACrC,MAA8B,EAAE;IAEhC,oCAAoC;IACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACzC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mDAAmD;IACnD,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qCAAqC;IACrC,MAAM,aAAa,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7C,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,SAAiB;IAChD,gDAAgD;IAChD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC;AACzD,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@a5c-ai/hooks-mux-adapter-codex",
+  "version": "5.0.1-staging.37ca18bd",
+  "description": "Codex harness adapter for the hooks-mux system",
+  "license": "UNLICENSED",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a5c-ai/babysitter.git",
+    "directory": "packages/hooks-mux/adapter-codex"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rimraf dist",
+    "lint": "eslint \"src/**/*.ts\" --max-warnings=0",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@a5c-ai/hooks-mux-core": "5.0.1-staging.37ca18bd"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "rimraf": "^6.0.0"
+  }
+}