@a5c-ai/hooks-mux-adapter-claude 5.0.1-staging.048a6d1f

package/README.md

@@ -0,0 +1,29 @@
+# @a5c-ai/hooks-mux-adapter-claude
+
+Claude Code harness adapter for hooks-mux.
+
+## Install
+
+```bash
+npm install @a5c-ai/hooks-mux-adapter-claude @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,
+  normalizeClaude,
+  renderClaudeOutput,
+} from "@a5c-ai/hooks-mux-adapter-claude";
+```
+
+The package exposes Claude-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,12 @@
+import type { AdapterCapabilities } from '@a5c-ai/hooks-mux-core';
+/**
+ * Creates the Claude Code adapter capability descriptor.
+ *
+ * Claude Code is a shell-hook harness with native session IDs,
+ * native env-file persistence via CLAUDE_ENV_FILE, and full
+ * tool interception scope.
+ *
+ * Spec section 17.1.
+ */
+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,CAoBnD"}

package/dist/adapter.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+/**
+ * Creates the Claude Code adapter capability descriptor.
+ *
+ * Claude Code is a shell-hook harness with native session IDs,
+ * native env-file persistence via CLAUDE_ENV_FILE, and full
+ * tool interception scope.
+ *
+ * Spec section 17.1.
+ */
+function createAdapter() {
+    return {
+        name: 'claude',
+        family: 'shell-hook',
+        sessionIdQuality: 'native',
+        supportsOrderedFanout: true,
+        supportsNativeAdditionalContext: true,
+        supportsBlock: true,
+        supportsAsk: true,
+        supportsToolInputMutation: false,
+        supportsToolResultMutation: false,
+        supportsPersistedEnv: true,
+        envPersistenceMode: 'native_env_file',
+        toolInterceptionScope: 'all',
+        notes: [
+            'CLAUDE_ENV_FILE is only available on specific events; append semantics required',
+            'turn.stop can recurse if not guarded; stop_hook_active must be checked',
+            'session.start source values: startup, resume, clear, compact',
+        ],
+    };
+}
+//# 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,sCAoBC;AA7BD;;;;;;;;GAQG;AACH,SAAgB,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,YAAY;QACpB,gBAAgB,EAAE,QAAQ;QAC1B,qBAAqB,EAAE,IAAI;QAC3B,+BAA+B,EAAE,IAAI;QACrC,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;QACjB,yBAAyB,EAAE,KAAK;QAChC,0BAA0B,EAAE,KAAK;QACjC,oBAAoB,EAAE,IAAI;QAC1B,kBAAkB,EAAE,iBAAiB;QACrC,qBAAqB,EAAE,KAAK;QAC5B,KAAK,EAAE;YACL,iFAAiF;YACjF,wEAAwE;YACxE,8DAA8D;SAC/D;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createAdapter } from './adapter';
+export { CLAUDE_PHASE_MAPPINGS, getClaudePhaseMapping, getSupportedPhases } from './mappings';
+export { normalizeClaude, parseStdin, buildExecutionContext, buildPayload, isStopHookRecursion } from './normalizer';
+export { normalizeClaude as normalizeForInvoke } from './normalizer';
+export type { ClaudeStdinBase, ClaudeSessionStartPayload, ClaudePreToolUsePayload, ClaudePostToolUsePayload, ClaudeStopPayload, ClaudeUserPromptSubmitPayload, ClaudeSubagentStopPayload, } from './normalizer';
+export { renderClaudeOutput } from './renderer';
+export { renderClaudeOutput as renderForInvoke } from './renderer';
+export type { ClaudePreToolUseOutput, ClaudePostToolUseOutput, ClaudeStopOutput, ClaudeSessionStartOutput, ClaudeGenericOutput, } from './renderer';
+export { resolveSessionId } from './session-resolver';
+export type { SessionResolutionResult } 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":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,qBAAqB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACrH,OAAO,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,IAAI,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = exports.renderForInvoke = exports.renderClaudeOutput = exports.normalizeForInvoke = exports.isStopHookRecursion = exports.buildPayload = exports.buildExecutionContext = exports.parseStdin = exports.normalizeClaude = exports.getSupportedPhases = exports.getClaudePhaseMapping = exports.CLAUDE_PHASE_MAPPINGS = exports.createAdapter = void 0;
+var adapter_1 = require("./adapter");
+Object.defineProperty(exports, "createAdapter", { enumerable: true, get: function () { return adapter_1.createAdapter; } });
+var mappings_1 = require("./mappings");
+Object.defineProperty(exports, "CLAUDE_PHASE_MAPPINGS", { enumerable: true, get: function () { return mappings_1.CLAUDE_PHASE_MAPPINGS; } });
+Object.defineProperty(exports, "getClaudePhaseMapping", { enumerable: true, get: function () { return mappings_1.getClaudePhaseMapping; } });
+Object.defineProperty(exports, "getSupportedPhases", { enumerable: true, get: function () { return mappings_1.getSupportedPhases; } });
+var normalizer_1 = require("./normalizer");
+Object.defineProperty(exports, "normalizeClaude", { enumerable: true, get: function () { return normalizer_1.normalizeClaude; } });
+Object.defineProperty(exports, "parseStdin", { enumerable: true, get: function () { return normalizer_1.parseStdin; } });
+Object.defineProperty(exports, "buildExecutionContext", { enumerable: true, get: function () { return normalizer_1.buildExecutionContext; } });
+Object.defineProperty(exports, "buildPayload", { enumerable: true, get: function () { return normalizer_1.buildPayload; } });
+Object.defineProperty(exports, "isStopHookRecursion", { enumerable: true, get: function () { return normalizer_1.isStopHookRecursion; } });
+var normalizer_2 = require("./normalizer");
+Object.defineProperty(exports, "normalizeForInvoke", { enumerable: true, get: function () { return normalizer_2.normalizeClaude; } });
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "renderClaudeOutput", { enumerable: true, get: function () { return renderer_1.renderClaudeOutput; } });
+var renderer_2 = require("./renderer");
+Object.defineProperty(exports, "renderForInvoke", { enumerable: true, get: function () { return renderer_2.renderClaudeOutput; } });
+var session_resolver_1 = require("./session-resolver");
+Object.defineProperty(exports, "resolveSessionId", { enumerable: true, get: function () { return session_resolver_1.resolveSessionId; } });
+//# 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,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,uCAA8F;AAArF,iHAAA,qBAAqB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AACzE,2CAAqH;AAA5G,6GAAA,eAAe,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAC9F,2CAAqE;AAA5D,gHAAA,eAAe,OAAsB;AAU9C,uCAAgD;AAAvC,8GAAA,kBAAkB,OAAA;AAC3B,uCAAmE;AAA1D,2GAAA,kBAAkB,OAAmB;AAQ9C,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/mappings.d.ts

@@ -0,0 +1,20 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-mux-core';
+/**
+ * Claude Code native event name to canonical phase mappings.
+ *
+ * Claude Code hook events:
+ *   SessionStart, PreToolUse, PostToolUse, Stop, SubagentStop,
+ *   Notification, UserPromptSubmit, PreCompact, SessionEnd
+ *
+ * Spec section 8.2 / 17.1.
+ */
+export declare const CLAUDE_PHASE_MAPPINGS: PhaseMapping[];
+/**
+ * Look up the phase mapping for a given Claude native event name.
+ */
+export declare function getClaudePhaseMapping(nativeEventName: string): PhaseMapping | undefined;
+/**
+ * Get all canonical phases supported by the Claude adapter.
+ */
+export declare function getSupportedPhases(): string[];
+//# 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;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAAY,EAkF/C,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEvF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/mappings.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLAUDE_PHASE_MAPPINGS = void 0;
+exports.getClaudePhaseMapping = getClaudePhaseMapping;
+exports.getSupportedPhases = getSupportedPhases;
+/**
+ * Claude Code native event name to canonical phase mappings.
+ *
+ * Claude Code hook events:
+ *   SessionStart, PreToolUse, PostToolUse, Stop, SubagentStop,
+ *   Notification, UserPromptSubmit, PreCompact, SessionEnd
+ *
+ * Spec section 8.2 / 17.1.
+ */
+exports.CLAUDE_PHASE_MAPPINGS = [
+    {
+        canonicalPhase: 'session.start',
+        nativeHook: 'SessionStart',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'source values: startup, resume, clear, compact. CLAUDE_ENV_FILE available.',
+    },
+    {
+        canonicalPhase: 'session.end',
+        nativeHook: 'SessionEnd',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'Observer-only; no blocking or mutation.',
+    },
+    {
+        canonicalPhase: 'session.compact.before',
+        nativeHook: 'PreCompact',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'Fires before context compaction. Observer-only.',
+    },
+    {
+        canonicalPhase: 'turn.user_prompt_submitted',
+        nativeHook: 'UserPromptSubmit',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'turn',
+        notes: 'Fires when user submits a prompt.',
+    },
+    {
+        canonicalPhase: 'tool.before',
+        nativeHook: 'PreToolUse',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'tool',
+        notes: 'Can block (deny) or ask for permission. Tool input mutation not supported.',
+    },
+    {
+        canonicalPhase: 'tool.after',
+        nativeHook: 'PostToolUse',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'tool',
+        notes: 'Observer-only post-tool hook. CLAUDE_ENV_FILE available.',
+    },
+    {
+        canonicalPhase: 'turn.stop',
+        nativeHook: 'Stop',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'turn',
+        notes: 'Can continue session or stop. Guard against recursion via stop_hook_active.',
+    },
+    {
+        canonicalPhase: 'subagent.end',
+        nativeHook: 'SubagentStop',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'subagent',
+        notes: 'Fires when a subagent completes.',
+    },
+    {
+        canonicalPhase: 'notification',
+        nativeHook: 'Notification',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'notification',
+        notes: 'Observer-only notification event.',
+    },
+];
+/**
+ * Look up the phase mapping for a given Claude native event name.
+ */
+function getClaudePhaseMapping(nativeEventName) {
+    return exports.CLAUDE_PHASE_MAPPINGS.find((m) => m.nativeHook === nativeEventName);
+}
+/**
+ * Get all canonical phases supported by the Claude adapter.
+ */
+function getSupportedPhases() {
+    return exports.CLAUDE_PHASE_MAPPINGS.map((m) => m.canonicalPhase);
+}
+//# sourceMappingURL=mappings.js.map

package/dist/mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.js","sourceRoot":"","sources":["../src/mappings.ts"],"names":[],"mappings":";;;AAkGA,sDAEC;AAKD,gDAEC;AAzGD;;;;;;;;GAQG;AACU,QAAA,qBAAqB,GAAmB;IACnD;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,4EAA4E;KACpF;IACD;QACE,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,YAAY;QACxB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,yCAAyC;KACjD;IACD;QACE,cAAc,EAAE,wBAAwB;QACxC,UAAU,EAAE,YAAY;QACxB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,iDAAiD;KACzD;IACD;QACE,cAAc,EAAE,4BAA4B;QAC5C,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,mCAAmC;KAC3C;IACD;QACE,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,YAAY;QACxB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,4EAA4E;KACpF;IACD;QACE,cAAc,EAAE,YAAY;QAC5B,UAAU,EAAE,aAAa;QACzB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,0DAA0D;KAClE;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;QACb,KAAK,EAAE,6EAA6E;KACrF;IACD;QACE,cAAc,EAAE,cAAc;QAC9B,UAAU,EAAE,cAAc;QAC1B,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,kCAAkC;KAC1C;IACD;QACE,cAAc,EAAE,cAAc;QAC9B,UAAU,EAAE,cAAc;QAC1B,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,mCAAmC;KAC3C;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,qBAAqB,CAAC,eAAuB;IAC3D,OAAO,6BAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,eAAe,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,6BAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;AAC5D,CAAC"}

package/dist/normalizer.d.ts

@@ -0,0 +1,88 @@
+import type { UnifiedHookEvent, UnifiedExecutionContext } from '@a5c-ai/hooks-mux-core';
+/**
+ * Claude Code stdin JSON payload shapes.
+ *
+ * Claude passes hook input as JSON on stdin with fields varying by event type.
+ */
+/** Common fields present across most Claude hook events. */
+export interface ClaudeStdinBase {
+    session_id?: string;
+    session_type?: string;
+    cwd?: string;
+    transcript_path?: string;
+    model?: string;
+    permission_mode?: string;
+    /** Present on Stop events to indicate recursion guard. */
+    stop_hook_active?: boolean;
+    [key: string]: unknown;
+}
+/** SessionStart-specific fields. */
+export interface ClaudeSessionStartPayload extends ClaudeStdinBase {
+    /** Source of session start: startup, resume, clear, compact. */
+    source?: string;
+    initial_prompt?: string;
+}
+/** PreToolUse-specific fields. */
+export interface ClaudePreToolUsePayload extends ClaudeStdinBase {
+    tool_name?: string;
+    tool_call_id?: string;
+    tool_input?: unknown;
+}
+/** PostToolUse-specific fields. */
+export interface ClaudePostToolUsePayload extends ClaudeStdinBase {
+    tool_name?: string;
+    tool_call_id?: string;
+    tool_input?: unknown;
+    tool_response?: unknown;
+}
+/** Stop-specific fields. */
+export interface ClaudeStopPayload extends ClaudeStdinBase {
+    reason?: string;
+    last_assistant_message?: string;
+    stop_hook_active?: boolean;
+}
+/** UserPromptSubmit-specific fields. */
+export interface ClaudeUserPromptSubmitPayload extends ClaudeStdinBase {
+    prompt?: string;
+}
+/** SubagentStop-specific fields. */
+export interface ClaudeSubagentStopPayload extends ClaudeStdinBase {
+    agent_type?: string;
+    reason?: string;
+    last_assistant_message?: string;
+}
+/**
+ * Parse raw stdin input (string or object) into a structured object.
+ */
+export declare function parseStdin(raw: unknown): Record<string, unknown>;
+/**
+ * Build a UnifiedExecutionContext from a Claude stdin payload and environment.
+ */
+export declare function buildExecutionContext(stdinData: Record<string, unknown>, nativeEventName: string, env: Record<string, string>): UnifiedExecutionContext;
+/**
+ * Build the payload portion of the unified event from Claude stdin data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+export declare function buildPayload(nativeEventName: string, stdinData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Check whether a normalized event represents a stop-hook recursion scenario.
+ *
+ * Claude Code sets `stop_hook_active: true` on Stop events that fire *inside*
+ * a stop hook's continued session.  Responding with `continueSession: true`
+ * in this situation would trigger infinite recursion, so callers must detect
+ * this and emit a safe no-op instead.
+ *
+ * @param event - A normalized UnifiedHookEvent (or any object with an
+ *   `execution.metadata` bag).
+ * @returns `true` when the event indicates stop-hook recursion.
+ */
+export declare function isStopHookRecursion(event: Pick<UnifiedHookEvent, 'execution'>): boolean;
+/**
+ * Normalize a Claude Code hook invocation into a UnifiedHookEvent.
+ *
+ * @param nativeEventName - The Claude event name (e.g. 'SessionStart', 'PreToolUse').
+ * @param rawStdin - Raw stdin content (string or parsed object).
+ * @param env - Environment variables at invocation time.
+ */
+export declare function normalizeClaude(nativeEventName: string, rawStdin: 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,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGxF;;;;GAIG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,kCAAkC;AAClC,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,4BAA4B;AAC5B,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wCAAwC;AACxC,MAAM,WAAW,6BAA8B,SAAQ,eAAe;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oCAAoC;AACpC,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBhE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,uBAAuB,CAsCzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8DzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GACzC,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,EACjB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,gBAAgB,CAmClB"}

package/dist/normalizer.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStdin = parseStdin;
+exports.buildExecutionContext = buildExecutionContext;
+exports.buildPayload = buildPayload;
+exports.isStopHookRecursion = isStopHookRecursion;
+exports.normalizeClaude = normalizeClaude;
+const mappings_1 = require("./mappings");
+/**
+ * Parse raw stdin input (string or object) into a structured object.
+ */
+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;
+            }
+            return { raw: parsed };
+        }
+        catch {
+            return { raw };
+        }
+    }
+    if (typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    return { raw };
+}
+/**
+ * Build a UnifiedExecutionContext from a Claude stdin payload and environment.
+ */
+function buildExecutionContext(stdinData, nativeEventName, env) {
+    const persistedEnv = {};
+    const contextVars = {};
+    // Collect persisted env from environment
+    for (const [key, value] of Object.entries(env)) {
+        if (key.startsWith('HOOKS_PROXY_PERSIST_')) {
+            persistedEnv[key] = value;
+        }
+    }
+    // Claude provides session_id natively
+    const sessionId = stdinData.session_id
+        ?? env['AGENT_SESSION_ID']
+        ?? null;
+    return {
+        sessionId,
+        turnId: env['HOOKS_PROXY_TURN_ID'] ?? null,
+        conversationId: env['HOOKS_PROXY_CONVERSATION_ID'] ?? null,
+        adapter: 'claude',
+        cwd: stdinData.cwd ?? env['PWD'] ?? null,
+        worktree: env['HOOKS_PROXY_WORKTREE'] ?? null,
+        transcriptPath: stdinData.transcript_path ?? null,
+        source: stdinData.source ?? null,
+        model: stdinData.model ?? env['HOOKS_PROXY_MODEL'] ?? null,
+        agentType: stdinData.agent_type ?? null,
+        permissionMode: stdinData.permission_mode ?? null,
+        toolName: stdinData.tool_name ?? null,
+        toolCallId: stdinData.tool_call_id ?? null,
+        nativeEventName,
+        rawEventScope: stdinData.session_type ?? null,
+        persistedEnv,
+        contextVars,
+        metadata: {
+            ...(stdinData.stop_hook_active != null ? { stop_hook_active: stdinData.stop_hook_active } : {}),
+        },
+    };
+}
+/**
+ * Build the payload portion of the unified event from Claude stdin data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+function buildPayload(nativeEventName, stdinData) {
+    const payload = {};
+    switch (nativeEventName) {
+        case 'SessionStart':
+            if (stdinData.source != null)
+                payload.source = stdinData.source;
+            if (stdinData.initial_prompt != null)
+                payload.initialPrompt = stdinData.initial_prompt;
+            break;
+        case 'PreToolUse':
+            if (stdinData.tool_name != null)
+                payload.toolName = stdinData.tool_name;
+            if (stdinData.tool_call_id != null)
+                payload.toolCallId = stdinData.tool_call_id;
+            if (stdinData.tool_input != null)
+                payload.toolInput = stdinData.tool_input;
+            break;
+        case 'PostToolUse':
+            if (stdinData.tool_name != null)
+                payload.toolName = stdinData.tool_name;
+            if (stdinData.tool_call_id != null)
+                payload.toolCallId = stdinData.tool_call_id;
+            if (stdinData.tool_input != null)
+                payload.toolInput = stdinData.tool_input;
+            if (stdinData.tool_response != null)
+                payload.toolResponse = stdinData.tool_response;
+            break;
+        case 'Stop':
+            if (stdinData.reason != null)
+                payload.reason = stdinData.reason;
+            if (stdinData.last_assistant_message != null)
+                payload.lastAssistantMessage = stdinData.last_assistant_message;
+            if (stdinData.stop_hook_active != null)
+                payload.stopHookActive = stdinData.stop_hook_active;
+            break;
+        case 'UserPromptSubmit':
+            if (stdinData.prompt != null)
+                payload.prompt = stdinData.prompt;
+            break;
+        case 'SubagentStop':
+            if (stdinData.agent_type != null)
+                payload.agentType = stdinData.agent_type;
+            if (stdinData.reason != null)
+                payload.reason = stdinData.reason;
+            if (stdinData.last_assistant_message != null)
+                payload.lastAssistantMessage = stdinData.last_assistant_message;
+            break;
+        case 'PreCompact':
+            // No event-specific fields beyond common ones
+            break;
+        case 'SessionEnd':
+            // No event-specific fields beyond common ones
+            break;
+        case 'Notification':
+            if (stdinData.message != null)
+                payload.message = stdinData.message;
+            if (stdinData.title != null)
+                payload.title = stdinData.title;
+            break;
+        default:
+            // Unknown event: pass through all non-common fields
+            for (const [key, value] of Object.entries(stdinData)) {
+                if (!['session_id', 'session_type', 'cwd', 'transcript_path', 'model', 'permission_mode'].includes(key)) {
+                    payload[key] = value;
+                }
+            }
+            break;
+    }
+    return payload;
+}
+/**
+ * Check whether a normalized event represents a stop-hook recursion scenario.
+ *
+ * Claude Code sets `stop_hook_active: true` on Stop events that fire *inside*
+ * a stop hook's continued session.  Responding with `continueSession: true`
+ * in this situation would trigger infinite recursion, so callers must detect
+ * this and emit a safe no-op instead.
+ *
+ * @param event - A normalized UnifiedHookEvent (or any object with an
+ *   `execution.metadata` bag).
+ * @returns `true` when the event indicates stop-hook recursion.
+ */
+function isStopHookRecursion(event) {
+    return event.execution.metadata?.stop_hook_active === true;
+}
+/**
+ * Normalize a Claude Code hook invocation into a UnifiedHookEvent.
+ *
+ * @param nativeEventName - The Claude event name (e.g. 'SessionStart', 'PreToolUse').
+ * @param rawStdin - Raw stdin content (string or parsed object).
+ * @param env - Environment variables at invocation time.
+ */
+function normalizeClaude(nativeEventName, rawStdin, env = {}) {
+    const stdinData = parseStdin(rawStdin);
+    const mapping = (0, mappings_1.getClaudePhaseMapping)(nativeEventName);
+    const phase = mapping?.canonicalPhase ?? 'unknown';
+    const supportLevel = mapping?.supportLevel ?? 'unsupported';
+    const execution = buildExecutionContext(stdinData, nativeEventName, env);
+    const payload = buildPayload(nativeEventName, stdinData);
+    // Split env into input and persisted buckets
+    const inputEnv = {};
+    const persistedEnv = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (key.startsWith('HOOKS_PROXY_PERSIST_')) {
+            persistedEnv[key] = value;
+        }
+        else if (key.startsWith('HOOKS_PROXY_')) {
+            inputEnv[key] = value;
+        }
+    }
+    return {
+        version: 'a5c.hooks.v1',
+        adapter: 'claude',
+        phase,
+        rawEventName: nativeEventName,
+        supportLevel,
+        execution,
+        payload,
+        env: {
+            input: inputEnv,
+            persisted: persistedEnv,
+        },
+        raw: rawStdin,
+    };
+}
+//# 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,54 @@
+import type { UnifiedHookEvent, UnifiedHookResult } from '@a5c-ai/hooks-mux-core';
+/**
+ * Claude Code native hook output formats.
+ *
+ * Claude Code hooks communicate results via JSON on stdout.
+ * The shape depends on the event type.
+ */
+/** PreToolUse hook output: permission decision. */
+export interface ClaudePreToolUseOutput {
+    decision?: 'allow' | 'deny' | 'ask';
+    reason?: string;
+    /** Additional context injected into the model's context window. */
+    additionalContext?: string;
+}
+/** PostToolUse hook output. */
+export interface ClaudePostToolUseOutput {
+    /** Additional context injected into the model's context window. */
+    additionalContext?: string;
+}
+/** Stop hook output: continue/stop decision. */
+export interface ClaudeStopOutput {
+    /** If true, the session continues instead of stopping. */
+    continue?: boolean;
+    /** Optional reason for the decision. */
+    reason?: string;
+    /** Follow-up message to send if continuing. */
+    followUpMessage?: string;
+    /** Additional context injected into the model's context window. */
+    additionalContext?: string;
+}
+/** SessionStart hook output. */
+export interface ClaudeSessionStartOutput {
+    /** Additional context injected into the model's context window. */
+    additionalContext?: string;
+}
+/** Generic output shape for events with no specific output contract. */
+export interface ClaudeGenericOutput {
+    [key: string]: unknown;
+}
+/**
+ * Render a UnifiedHookResult back to Claude's native JSON output format.
+ *
+ * If the optional `event` parameter is provided and indicates stop-hook
+ * recursion (`execution.metadata.stop_hook_active === true`), the renderer
+ * short-circuits to a safe no-op (`continueSession: false`) to prevent
+ * infinite recursion (spec 17.1).
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original Claude event name.
+ * @param event - Optional normalized event; used for recursion detection.
+ * @returns The native JSON output to write to stdout.
+ */
+export declare function renderClaudeOutput(result: UnifiedHookResult, nativeEventName: string, event?: Pick<UnifiedHookEvent, 'execution'>): Record<string, unknown>;
+//# 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,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;;;GAKG;AAEH,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,+BAA+B;AAC/B,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,gCAAgC;AAChC,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,MAAM,EACvB,KAAK,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}

package/dist/renderer.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderClaudeOutput = renderClaudeOutput;
+/**
+ * Safe no-op response for Stop events during stop-hook recursion.
+ *
+ * When `stop_hook_active` is true, the hook is firing inside a session that
+ * was already continued by a previous stop hook.  Emitting
+ * `continueSession: true` here would create an infinite loop, so the only
+ * safe response is to let the session stop naturally.
+ */
+const SAFE_STOP_NOOP = Object.freeze({
+    continue: false,
+});
+/**
+ * Render a UnifiedHookResult back to Claude's native JSON output format.
+ *
+ * If the optional `event` parameter is provided and indicates stop-hook
+ * recursion (`execution.metadata.stop_hook_active === true`), the renderer
+ * short-circuits to a safe no-op (`continueSession: false`) to prevent
+ * infinite recursion (spec 17.1).
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original Claude event name.
+ * @param event - Optional normalized event; used for recursion detection.
+ * @returns The native JSON output to write to stdout.
+ */
+function renderClaudeOutput(result, nativeEventName, event) {
+    // Recursion guard: if stop_hook_active is set, emit safe no-op for Stop events
+    if (nativeEventName === 'Stop' &&
+        event?.execution.metadata?.stop_hook_active === true) {
+        return { ...SAFE_STOP_NOOP };
+    }
+    switch (nativeEventName) {
+        case 'PreToolUse':
+            return renderPreToolUseOutput(result);
+        case 'PostToolUse':
+            return renderPostToolUseOutput(result);
+        case 'Stop':
+            return renderStopOutput(result);
+        case 'SessionStart':
+            return renderSessionStartOutput(result);
+        default:
+            return renderGenericOutput(result);
+    }
+}
+function renderPreToolUseOutput(result) {
+    const output = {};
+    // Map unified decision to Claude's permission decision
+    if (result.decision === 'allow') {
+        output['decision'] = 'allow';
+    }
+    else if (result.decision === 'deny') {
+        output['decision'] = 'deny';
+    }
+    else if (result.decision === 'ask') {
+        output['decision'] = 'ask';
+    }
+    // 'continue' and 'noop' produce no decision field — Claude defaults to allow
+    if (result.reason != null) {
+        output['reason'] = result.reason;
+    }
+    if (result.additionalContext != null) {
+        output['additionalContext'] = result.additionalContext;
+    }
+    return output;
+}
+function renderPostToolUseOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output['additionalContext'] = result.additionalContext;
+    }
+    return output;
+}
+function renderStopOutput(result) {
+    const output = {};
+    if (result.continueSession != null) {
+        output['continue'] = result.continueSession;
+    }
+    if (result.stopReason != null) {
+        output['reason'] = result.stopReason;
+    }
+    else if (result.reason != null) {
+        output['reason'] = result.reason;
+    }
+    if (result.followUpMessage != null) {
+        output['followUpMessage'] = result.followUpMessage;
+    }
+    if (result.additionalContext != null) {
+        output['additionalContext'] = result.additionalContext;
+    }
+    return output;
+}
+function renderSessionStartOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output['additionalContext'] = result.additionalContext;
+    }
+    return output;
+}
+function renderGenericOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    return output;
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":";;AAuEA,gDAyBC;AAlDD;;;;;;;GAOG;AACH,MAAM,cAAc,GAAsC,MAAM,CAAC,MAAM,CAAC;IACtE,QAAQ,EAAE,KAAK;CAChB,CAAC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,SAAgB,kBAAkB,CAChC,MAAyB,EACzB,eAAuB,EACvB,KAA2C;IAE3C,+EAA+E;IAC/E,IACE,eAAe,KAAK,MAAM;QAC1B,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,EACpD,CAAC;QACD,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;IAED,QAAQ,eAAe,EAAE,CAAC;QACxB,KAAK,YAAY;YACf,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,aAAa;YAChB,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;QACzC,KAAK,MAAM;YACT,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,cAAc;YACjB,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAC1C;YACE,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAyB;IACvD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,uDAAuD;IACvD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;IAC/B,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACtC,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;IAC9B,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IACD,6EAA6E;IAE7E,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC;QACrC,MAAM,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACzD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAyB;IACxD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,IAAI,MAAM,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC;QACrC,MAAM,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACzD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAyB;IACjD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,IAAI,MAAM,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;QACnC,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC;IAC9C,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;QACnC,MAAM,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC;IACrD,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC;QACrC,MAAM,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACzD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAyB;IACzD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,IAAI,MAAM,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC;QACrC,MAAM,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACzD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAyB;IACpD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,IAAI,MAAM,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC;QACrC,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACtD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/session-resolver.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Session ID resolution for Claude Code.
+ *
+ * Claude Code provides a native session_id in stdin JSON payloads,
+ * so the resolution quality is 'native'.
+ *
+ * Resolution precedence (spec section 9.2):
+ *   1. Explicit CLI flag --session-id
+ *   2. Explicit env AGENT_SESSION_ID
+ *   3. Native session_id from Claude stdin payload
+ *   4. Fallback: null (no synthetic generation — Claude always provides session_id)
+ */
+export interface SessionResolutionResult {
+    sessionId: string | null;
+    source: 'explicit_flag' | 'explicit_env' | 'native' | 'none';
+}
+/**
+ * Resolve the session ID for a Claude Code hook invocation.
+ *
+ * @param stdinData - Parsed stdin JSON payload from Claude.
+ * @param env - Environment variables at invocation time.
+ * @param explicitSessionId - Session ID from explicit CLI flag, if any.
+ */
+export declare function resolveSessionId(stdinData: Record<string, unknown>, env?: Record<string, string>, explicitSessionId?: string): SessionResolutionResult;
+//# 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;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,eAAe,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC9D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAChC,iBAAiB,CAAC,EAAE,MAAM,GACzB,uBAAuB,CAoBzB"}

package/dist/session-resolver.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Session ID resolution for Claude Code.
+ *
+ * Claude Code provides a native session_id in stdin JSON payloads,
+ * so the resolution quality is 'native'.
+ *
+ * Resolution precedence (spec section 9.2):
+ *   1. Explicit CLI flag --session-id
+ *   2. Explicit env AGENT_SESSION_ID
+ *   3. Native session_id from Claude stdin payload
+ *   4. Fallback: null (no synthetic generation — Claude always provides session_id)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = resolveSessionId;
+/**
+ * Resolve the session ID for a Claude Code hook invocation.
+ *
+ * @param stdinData - Parsed stdin JSON payload from Claude.
+ * @param env - Environment variables at invocation time.
+ * @param explicitSessionId - Session ID from explicit CLI flag, if any.
+ */
+function resolveSessionId(stdinData, env = {}, explicitSessionId) {
+    // 1. Explicit CLI flag
+    if (explicitSessionId) {
+        return { sessionId: explicitSessionId, source: 'explicit_flag' };
+    }
+    // 2. Explicit env
+    const envSessionId = env['AGENT_SESSION_ID'];
+    if (envSessionId) {
+        return { sessionId: envSessionId, source: 'explicit_env' };
+    }
+    // 3. Native session_id from Claude stdin
+    const nativeSessionId = stdinData.session_id;
+    if (typeof nativeSessionId === 'string' && nativeSessionId.length > 0) {
+        return { sessionId: nativeSessionId, source: 'native' };
+    }
+    // 4. No session ID available
+    return { sessionId: null, source: 'none' };
+}
+//# 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;;;;;;;;;;;GAWG;;AAcH,4CAwBC;AA/BD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,SAAkC,EAClC,MAA8B,EAAE,EAChC,iBAA0B;IAE1B,uBAAuB;IACvB,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACnE,CAAC;IAED,kBAAkB;IAClB,MAAM,YAAY,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC7C,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC7D,CAAC;IAED,yCAAyC;IACzC,MAAM,eAAe,GAAG,SAAS,CAAC,UAAU,CAAC;IAC7C,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED,6BAA6B;IAC7B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@a5c-ai/hooks-mux-adapter-claude",
+  "version": "5.0.1-staging.048a6d1f",
+  "description": "Claude Code 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-claude"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/packages/hooks-mux/adapter-claude#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.048a6d1f"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "rimraf": "^6.0.0"
+  }
+}