@a5c-ai/hooks-mux-adapter-codex 5.0.1-staging.00fa5317c

package/README.md

@@ -0,0 +1,29 @@
+# @a5c-ai/hooks-mux-adapter-codex
+
+Codex harness adapter for hooks-mux.
+
+## Install
+
+```bash
+npm install @a5c-ai/hooks-mux-adapter-codex @a5c-ai/hooks-mux-core
+```
+
+This package ships the built adapter runtime in `dist/` and this package README for npm publish-surface auditing.
+
+## Usage
+
+```ts
+import {
+  createAdapter,
+  normalizeCodexEvent,
+  renderCodexOutput,
+} from "@a5c-ai/hooks-mux-adapter-codex";
+```
+
+The package exposes Codex-specific normalization, phase mappings, rendering helpers, and session-resolution utilities for the hooks-mux execution pipeline.
+
+See [`packages/hooks-mux/README.md`](../README.md) for the workspace overview and `packages/hooks-mux/docs/adapter-integration-guide.md` for end-to-end integration guidance.
+
+## License
+
+MIT © a5c-ai

package/dist/adapter.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterCapabilities } from '@a5c-ai/hooks-mux-core';
+export declare function createAdapter(name?: string): 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;AAalE,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAA6B,GAAG,mBAAmB,CAsBtF"}

package/dist/adapter.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+const agent_catalog_1 = require("@a5c-ai/agent-catalog");
+/**
+ * Creates the Codex adapter with its capability metadata.
+ *
+ * Reads capability data from the Atlas graph via the agent-catalog.
+ * Falls back to hardcoded defaults if the catalog is unavailable.
+ *
+ * Spec section 17.2.
+ */
+const DEFAULT_ADAPTER_NAME = 'codex';
+function createAdapter(name = DEFAULT_ADAPTER_NAME) {
+    const target = (0, agent_catalog_1.getPluginTargetDescriptor)(name);
+    return {
+        name,
+        family: target?.hooksMuxFamily ?? 'shell-hook',
+        sessionIdQuality: target?.sessionIdQuality ?? 'native',
+        supportsOrderedFanout: target?.supportsOrderedFanout ?? true,
+        supportsNativeAdditionalContext: target?.supportsNativeAdditionalContext ?? false,
+        supportsBlock: target?.supportsBlock ?? true,
+        supportsAsk: target?.supportsAsk ?? false,
+        supportsToolInputMutation: target?.supportsToolInputMutation ?? false,
+        supportsToolResultMutation: target?.supportsToolResultMutation ?? false,
+        supportsPersistedEnv: target?.supportsPersistedEnv ?? false,
+        envPersistenceMode: target?.envPersistenceMode ?? 'wrapper_only',
+        toolInterceptionScope: target?.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":";;AAaA,sCAsBC;AAlCD,yDAAkE;AAElE;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAErC,SAAgB,aAAa,CAAC,OAAe,oBAAoB;IAC/D,MAAM,MAAM,GAAG,IAAA,yCAAyB,EAAC,IAAI,CAAC,CAAC;IAC/C,OAAO;QACL,IAAI;QACJ,MAAM,EAAG,MAAM,EAAE,cAAgD,IAAI,YAAY;QACjF,gBAAgB,EAAG,MAAM,EAAE,gBAA4D,IAAI,QAAQ;QACnG,qBAAqB,EAAE,MAAM,EAAE,qBAAqB,IAAI,IAAI;QAC5D,+BAA+B,EAAE,MAAM,EAAE,+BAA+B,IAAI,KAAK;QACjF,aAAa,EAAE,MAAM,EAAE,aAAa,IAAI,IAAI;QAC5C,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,KAAK;QACzC,yBAAyB,EAAE,MAAM,EAAE,yBAAyB,IAAI,KAAK;QACrE,0BAA0B,EAAE,MAAM,EAAE,0BAA0B,IAAI,KAAK;QACvE,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,IAAI,KAAK;QAC3D,kBAAkB,EAAG,MAAM,EAAE,kBAAgE,IAAI,cAAc;QAC/G,qBAAqB,EAAG,MAAM,EAAE,qBAAsE,IAAI,oBAAoB;QAC9H,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, normalizeCodexEvent as normalizeForInvoke, setAdapterName, parseStdin, extractSessionId, ADAPTER_NAME, } from './normalizer';
+export type { CodexSessionStartPayload, CodexUserPromptPayload, CodexStopPayload, CodexToolPayload, } from './normalizer';
+export { renderCodexOutput, renderCodexOutput as renderForInvoke, 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,mBAAmB,IAAI,kBAAkB,EACzC,cAAc,EACd,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,EACL,iBAAiB,EACjB,iBAAiB,IAAI,eAAe,EACpC,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidSessionId = exports.resolveSessionId = exports.isFieldSupportedForEvent = exports.renderForInvoke = exports.renderCodexOutput = exports.ADAPTER_NAME = exports.extractSessionId = exports.parseStdin = exports.setAdapterName = exports.normalizeForInvoke = 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, "normalizeForInvoke", { enumerable: true, get: function () { return normalizer_1.normalizeCodexEvent; } });
+Object.defineProperty(exports, "setAdapterName", { enumerable: true, get: function () { return normalizer_1.setAdapterName; } });
+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, "renderForInvoke", { 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,2CAOsB;AANpB,iHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAsB;AACzC,4GAAA,cAAc,OAAA;AACd,wGAAA,UAAU,OAAA;AACV,8GAAA,gBAAgB,OAAA;AAChB,0GAAA,YAAY,OAAA;AASd,WAAW;AACX,uCAIoB;AAHlB,6GAAA,iBAAiB,OAAA;AACjB,2GAAA,iBAAiB,OAAmB;AACpC,oHAAA,wBAAwB,OAAA;AAG1B,mBAAmB;AACnB,uDAAwE;AAA/D,oHAAA,gBAAgB,OAAA;AAAE,oHAAA,gBAAgB,OAAA"}

package/dist/mappings.d.ts

@@ -0,0 +1,7 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-mux-core';
+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;AAiE3D,eAAO,MAAM,oBAAoB,EAAE,YAAY,EAAuB,CAAC;AAEvE;;GAEG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7E"}

package/dist/mappings.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODEX_PHASE_MAPPINGS = void 0;
+exports.findMapping = findMapping;
+const agent_catalog_1 = require("@a5c-ai/agent-catalog");
+/**
+ * Codex native event to canonical phase mapping table.
+ *
+ * Phase mappings are built from the Atlas graph HookMapping records
+ * via the agent-catalog. Falls back to hardcoded defaults if the
+ * catalog is unavailable.
+ *
+ * Spec section 17.2.
+ */
+const SUPPORT_LEVEL_MAP = {
+    supported: 'native',
+    native: 'native',
+    lossy: 'lossy',
+    emulated: 'emulated',
+    unsupported: 'unsupported',
+};
+const CODEX_COMPATIBILITY_MAPPINGS = [
+    {
+        canonicalPhase: 'tool.before',
+        nativeHook: 'PreToolUse',
+        supportLevel: 'lossy',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'tool',
+        notes: 'Bash-only compatibility alias for legacy Codex hook payloads.',
+    },
+];
+function hookMappingToPhaseMapping(mapping) {
+    if (!mapping.canonicalPhase)
+        return null;
+    return {
+        canonicalPhase: mapping.canonicalPhase,
+        nativeHook: mapping.nativeName,
+        supportLevel: SUPPORT_LEVEL_MAP[mapping.supportLevel] ?? (mapping.requiresRuntimeHooks ? 'native' : 'lossy'),
+        blockCapability: mapping.blockCapability ?? false,
+        mutationCapability: mapping.mutationCapability ?? false,
+        scope: (mapping.scope ?? 'session'),
+    };
+}
+function buildFromCatalog() {
+    const mappings = (0, agent_catalog_1.listHookMappingsByAdapterFamily)('codex');
+    if (mappings.length === 0) {
+        throw new Error('hooks-mux adapter-codex: catalog unavailable or returned no mappings for family "codex"');
+    }
+    const phaseMappings = [
+        ...CODEX_COMPATIBILITY_MAPPINGS,
+        ...mappings
+            .map(hookMappingToPhaseMapping)
+            .filter((m) => m !== null),
+    ];
+    const seen = new Set();
+    return phaseMappings.filter((m) => {
+        if (seen.has(m.nativeHook))
+            return false;
+        seen.add(m.nativeHook);
+        return true;
+    });
+}
+exports.CODEX_PHASE_MAPPINGS = buildFromCatalog();
+/**
+ * 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":";;;AAsEA,kCAEC;AAvED,yDAAwE;AAGxE;;;;;;;;GAQG;AAEH,MAAM,iBAAiB,GAAiD;IACtE,SAAS,EAAE,QAAQ;IACnB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEF,MAAM,4BAA4B,GAAmB;IACnD;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,+DAA+D;KACvE;CACF,CAAC;AAEF,SAAS,yBAAyB,CAAC,OAA8B;IAC/D,IAAI,CAAC,OAAO,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO;QACL,cAAc,EAAE,OAAO,CAAC,cAAgD;QACxE,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,YAAY,EAAE,iBAAiB,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5G,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,KAAK;QACjD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,KAAK;QACvD,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,CAA0B;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,QAAQ,GAAG,IAAA,+CAA+B,EAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,aAAa,GAAG;QACpB,GAAG,4BAA4B;QAC/B,GAAG,QAAQ;aACR,GAAG,CAAC,yBAAyB,CAAC;aAC9B,MAAM,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KAChD,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAEY,QAAA,oBAAoB,GAAmB,gBAAgB,EAAE,CAAC;AAEvE;;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,65 @@
+import { type UnifiedHookEvent } from '@a5c-ai/hooks-mux-core';
+/** The default adapter identifier used in all normalized events. */
+export declare const ADAPTER_NAME = "codex";
+/** Override the adapter name used in normalized events. */
+export declare function setAdapterName(name: string): void;
+/**
+ * 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,oEAAoE;AACpE,eAAO,MAAM,YAAY,UAAU,CAAC;AAKpC,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;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,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_NAME = void 0;
+exports.setAdapterName = setAdapterName;
+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 default adapter identifier used in all normalized events. */
+exports.ADAPTER_NAME = 'codex';
+/** The mutable adapter name, defaulting to the Codex adapter identity. */
+let _adapterName = exports.ADAPTER_NAME;
+/** Override the adapter name used in normalized events. */
+function setAdapterName(name) {
+    _adapterName = name;
+}
+/**
+ * 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: _adapterName,
+        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;AAuDpE;;;;;;;;;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,92 @@
+"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',
+]);
+/** Output fields supported on SessionEnd (mostly ignored). */
+const SESSION_END_FIELDS = new Set([
+    'reason',
+]);
+/** Map native event names to their supported output field sets. */
+const SUPPORTED_FIELDS_BY_EVENT = {
+    SessionStart: SESSION_START_FIELDS,
+    SessionEnd: SESSION_END_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,40 @@
+{
+  "name": "@a5c-ai/hooks-mux-adapter-codex",
+  "version": "5.0.1-staging.00fa5317c",
+  "description": "Codex harness adapter for the hooks-mux system",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a5c-ai/babysitter.git",
+    "directory": "packages/hooks-mux/adapter-codex"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/packages/hooks-mux/adapter-codex#readme",
+  "bugs": {
+    "url": "https://github.com/a5c-ai/babysitter/issues"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "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.00fa5317c"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "rimraf": "^6.0.0"
+  }
+}