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

package/README.md

@@ -0,0 +1,29 @@
+# @a5c-ai/hooks-mux-adapter-gemini
+
+Gemini CLI harness adapter for hooks-mux.
+
+## Install
+
+```bash
+npm install @a5c-ai/hooks-mux-adapter-gemini @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,
+  normalizeGemini,
+  renderGeminiOutput,
+} from "@a5c-ai/hooks-mux-adapter-gemini";
+```
+
+The package exposes Gemini-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,13 @@
+import type { AdapterCapabilities } from '@a5c-ai/hooks-mux-core';
+/**
+ * Creates the Gemini CLI adapter capability descriptor.
+ *
+ * Gemini CLI is a shell-hook harness with derived session IDs
+ * (from GEMINI_SESSION_ID env or workspace-based derivation),
+ * wrapper-only env persistence, and support for blocking, asking,
+ * and tool input mutation.
+ *
+ * Spec section 17.3.
+ */
+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;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAoBnD"}

package/dist/adapter.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+/**
+ * Creates the Gemini CLI adapter capability descriptor.
+ *
+ * Gemini CLI is a shell-hook harness with derived session IDs
+ * (from GEMINI_SESSION_ID env or workspace-based derivation),
+ * wrapper-only env persistence, and support for blocking, asking,
+ * and tool input mutation.
+ *
+ * Spec section 17.3.
+ */
+function createAdapter() {
+    return {
+        name: 'gemini',
+        family: 'shell-hook',
+        sessionIdQuality: 'derived',
+        supportsOrderedFanout: true,
+        supportsNativeAdditionalContext: true,
+        supportsBlock: true,
+        supportsAsk: true,
+        supportsToolInputMutation: true,
+        supportsToolResultMutation: false,
+        supportsPersistedEnv: false,
+        envPersistenceMode: 'wrapper_only',
+        toolInterceptionScope: 'all',
+        notes: [
+            'BeforeToolSelection has union-style aggregation',
+            'Logs must go to stderr; final JSON to stdout only',
+            'Session ID derived from GEMINI_SESSION_ID env or workspace + timestamp',
+        ],
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":";;AAYA,sCAoBC;AA9BD;;;;;;;;;GASG;AACH,SAAgB,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,YAAY;QACpB,gBAAgB,EAAE,SAAS;QAC3B,qBAAqB,EAAE,IAAI;QAC3B,+BAA+B,EAAE,IAAI;QACrC,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;QACjB,yBAAyB,EAAE,IAAI;QAC/B,0BAA0B,EAAE,KAAK;QACjC,oBAAoB,EAAE,KAAK;QAC3B,kBAAkB,EAAE,cAAc;QAClC,qBAAqB,EAAE,KAAK;QAC5B,KAAK,EAAE;YACL,iDAAiD;YACjD,mDAAmD;YACnD,wEAAwE;SACzE;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createAdapter } from './adapter';
+export { GEMINI_PHASE_MAPPINGS, getGeminiPhaseMapping, getSupportedPhases } from './mappings';
+export { normalizeGemini, parseStdin, buildExecutionContext, buildPayload } from './normalizer';
+export { renderGeminiOutput, emitOutput, logToStderr } from './renderer';
+export { resolveSessionId, deriveSessionId } from './session-resolver';
+export type { GeminiStdinBase, GeminiSessionStartPayload, GeminiBeforeToolSelectionPayload, GeminiBeforeModelPayload, GeminiAfterModelPayload, GeminiBeforeAgentPayload, GeminiAfterAgentPayload, GeminiBeforeToolPayload, GeminiAfterToolPayload, } from './normalizer';
+export type { GeminiBeforeToolSelectionOutput, GeminiBeforeModelOutput, GeminiAfterModelOutput, GeminiBeforeAgentOutput, GeminiAfterAgentOutput, GeminiBeforeToolOutput, GeminiAfterToolOutput, GeminiSessionStartOutput, } from './renderer';
+//# 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,MAAM,cAAc,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGvE,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,gCAAgC,EAChC,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,+BAA+B,EAC/B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveSessionId = exports.resolveSessionId = exports.logToStderr = exports.emitOutput = exports.renderGeminiOutput = exports.buildPayload = exports.buildExecutionContext = exports.parseStdin = exports.normalizeGemini = exports.getSupportedPhases = exports.getGeminiPhaseMapping = exports.GEMINI_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, "GEMINI_PHASE_MAPPINGS", { enumerable: true, get: function () { return mappings_1.GEMINI_PHASE_MAPPINGS; } });
+Object.defineProperty(exports, "getGeminiPhaseMapping", { enumerable: true, get: function () { return mappings_1.getGeminiPhaseMapping; } });
+Object.defineProperty(exports, "getSupportedPhases", { enumerable: true, get: function () { return mappings_1.getSupportedPhases; } });
+var normalizer_1 = require("./normalizer");
+Object.defineProperty(exports, "normalizeGemini", { enumerable: true, get: function () { return normalizer_1.normalizeGemini; } });
+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; } });
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "renderGeminiOutput", { enumerable: true, get: function () { return renderer_1.renderGeminiOutput; } });
+Object.defineProperty(exports, "emitOutput", { enumerable: true, get: function () { return renderer_1.emitOutput; } });
+Object.defineProperty(exports, "logToStderr", { enumerable: true, get: function () { return renderer_1.logToStderr; } });
+var session_resolver_1 = require("./session-resolver");
+Object.defineProperty(exports, "resolveSessionId", { enumerable: true, get: function () { return session_resolver_1.resolveSessionId; } });
+Object.defineProperty(exports, "deriveSessionId", { enumerable: true, get: function () { return session_resolver_1.deriveSessionId; } });
+//# 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,2CAAgG;AAAvF,6GAAA,eAAe,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAAE,0GAAA,YAAY,OAAA;AACzE,uCAAyE;AAAhE,8GAAA,kBAAkB,OAAA;AAAE,sGAAA,UAAU,OAAA;AAAE,uGAAA,WAAW,OAAA;AACpD,uDAAuE;AAA9D,oHAAA,gBAAgB,OAAA;AAAE,mHAAA,eAAe,OAAA"}

package/dist/mappings.d.ts

@@ -0,0 +1,21 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-mux-core';
+/**
+ * Gemini CLI native event name to canonical phase mappings.
+ *
+ * Gemini CLI hook events cover a richer lifecycle than some other harnesses,
+ * including planner, model, and agent-level events:
+ *   SessionStart, SessionEnd, BeforeToolSelection, BeforeModel, AfterModel,
+ *   BeforeAgent, AfterAgent, BeforeTool, AfterTool
+ *
+ * Spec section 8.2 / 17.3.
+ */
+export declare const GEMINI_PHASE_MAPPINGS: PhaseMapping[];
+/**
+ * Look up the phase mapping for a given Gemini native event name.
+ */
+export declare function getGeminiPhaseMapping(nativeEventName: string): PhaseMapping | undefined;
+/**
+ * Get all canonical phases supported by the Gemini 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;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAAY,EA+F/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,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEMINI_PHASE_MAPPINGS = void 0;
+exports.getGeminiPhaseMapping = getGeminiPhaseMapping;
+exports.getSupportedPhases = getSupportedPhases;
+/**
+ * Gemini CLI native event name to canonical phase mappings.
+ *
+ * Gemini CLI hook events cover a richer lifecycle than some other harnesses,
+ * including planner, model, and agent-level events:
+ *   SessionStart, SessionEnd, BeforeToolSelection, BeforeModel, AfterModel,
+ *   BeforeAgent, AfterAgent, BeforeTool, AfterTool
+ *
+ * Spec section 8.2 / 17.3.
+ */
+exports.GEMINI_PHASE_MAPPINGS = [
+    // --- Session lifecycle ---
+    {
+        canonicalPhase: 'session.start',
+        nativeHook: 'SessionStart',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'Fires when the Gemini CLI session begins.',
+    },
+    {
+        canonicalPhase: 'session.end',
+        nativeHook: 'SessionEnd',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'Observer-only; fires when session is torn down.',
+    },
+    // --- Planner lifecycle ---
+    {
+        canonicalPhase: 'planner.before_tool_selection',
+        nativeHook: 'BeforeToolSelection',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: true,
+        scope: 'planner',
+        notes: 'Union-style aggregation: multiple hooks return tool subsets that are unioned. ' +
+            'Can influence which tools are available for the current turn.',
+    },
+    // --- Model lifecycle ---
+    {
+        canonicalPhase: 'model.before_request',
+        nativeHook: 'BeforeModel',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: true,
+        scope: 'model',
+        notes: 'Fires before the model request is sent. Can mutate the request payload.',
+    },
+    {
+        canonicalPhase: 'model.after_response',
+        nativeHook: 'AfterModel',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'model',
+        notes: 'Observer-only; fires after model response is received.',
+    },
+    // --- Turn / agent lifecycle ---
+    {
+        canonicalPhase: 'turn.before_agent',
+        nativeHook: 'BeforeAgent',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'turn',
+        notes: 'Fires before the agent turn begins. Can block execution.',
+    },
+    {
+        canonicalPhase: 'turn.after_agent',
+        nativeHook: 'AfterAgent',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'turn',
+        notes: 'Fires after the agent turn completes. Can continue session ' +
+            'by providing a follow-up prompt.',
+    },
+    // --- Tool lifecycle ---
+    {
+        canonicalPhase: 'tool.before',
+        nativeHook: 'BeforeTool',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: true,
+        scope: 'tool',
+        notes: 'Fires before tool execution. Can block (deny) or mutate tool input.',
+    },
+    {
+        canonicalPhase: 'tool.after',
+        nativeHook: 'AfterTool',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'tool',
+        notes: 'Observer-only post-tool hook.',
+    },
+];
+/**
+ * Look up the phase mapping for a given Gemini native event name.
+ */
+function getGeminiPhaseMapping(nativeEventName) {
+    return exports.GEMINI_PHASE_MAPPINGS.find((m) => m.nativeHook === nativeEventName);
+}
+/**
+ * Get all canonical phases supported by the Gemini adapter.
+ */
+function getSupportedPhases() {
+    return exports.GEMINI_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":";;;AAgHA,sDAEC;AAKD,gDAEC;AAvHD;;;;;;;;;GASG;AACU,QAAA,qBAAqB,GAAmB;IACnD,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,2CAA2C;KACnD;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,iDAAiD;KACzD;IAED,4BAA4B;IAC5B;QACE,cAAc,EAAE,+BAA+B;QAC/C,UAAU,EAAE,qBAAqB;QACjC,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,IAAI;QACxB,KAAK,EAAE,SAAS;QAChB,KAAK,EACH,gFAAgF;YAChF,+DAA+D;KAClE;IAED,0BAA0B;IAC1B;QACE,cAAc,EAAE,sBAAsB;QACtC,UAAU,EAAE,aAAa;QACzB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,IAAI;QACxB,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,yEAAyE;KACjF;IACD;QACE,cAAc,EAAE,sBAAsB;QACtC,UAAU,EAAE,YAAY;QACxB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,wDAAwD;KAChE;IAED,iCAAiC;IACjC;QACE,cAAc,EAAE,mBAAmB;QACnC,UAAU,EAAE,aAAa;QACzB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,0DAA0D;KAClE;IACD;QACE,cAAc,EAAE,kBAAkB;QAClC,UAAU,EAAE,YAAY;QACxB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EACH,6DAA6D;YAC7D,kCAAkC;KACrC;IAED,yBAAyB;IACzB;QACE,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,YAAY;QACxB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,IAAI;QACxB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,qEAAqE;KAC7E;IACD;QACE,cAAc,EAAE,YAAY;QAC5B,UAAU,EAAE,WAAW;QACvB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,+BAA+B;KACvC;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,100 @@
+import type { UnifiedHookEvent, UnifiedExecutionContext } from '@a5c-ai/hooks-mux-core';
+/**
+ * Gemini CLI stdin JSON payload shapes.
+ *
+ * Gemini CLI passes hook input as JSON on stdin with fields varying by event type.
+ */
+/** Common fields present across most Gemini hook events. */
+export interface GeminiStdinBase {
+    /** Workspace or project directory. */
+    cwd?: string;
+    /** Model identifier. */
+    model?: string;
+    /** Extension path for the calling extension. */
+    extensionPath?: string;
+    [key: string]: unknown;
+}
+/** SessionStart-specific fields. */
+export interface GeminiSessionStartPayload extends GeminiStdinBase {
+    /** Initial user prompt if available. */
+    prompt?: string;
+}
+/** BeforeToolSelection-specific fields. */
+export interface GeminiBeforeToolSelectionPayload extends GeminiStdinBase {
+    /** List of available tool names. */
+    availableTools?: string[];
+    /** The user prompt or current context driving tool selection. */
+    prompt?: string;
+}
+/** BeforeModel-specific fields. */
+export interface GeminiBeforeModelPayload extends GeminiStdinBase {
+    /** The request about to be sent to the model. */
+    request?: unknown;
+    /** Messages in the conversation so far. */
+    messages?: unknown[];
+}
+/** AfterModel-specific fields. */
+export interface GeminiAfterModelPayload extends GeminiStdinBase {
+    /** The model's response. */
+    response?: unknown;
+    /** Token usage information. */
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+}
+/** BeforeAgent-specific fields. */
+export interface GeminiBeforeAgentPayload extends GeminiStdinBase {
+    /** The prompt that will drive the agent turn. */
+    prompt?: string;
+}
+/** AfterAgent-specific fields. */
+export interface GeminiAfterAgentPayload extends GeminiStdinBase {
+    /** The agent's last output message. */
+    lastMessage?: string;
+    /** Reason the agent turn ended. */
+    reason?: string;
+}
+/** BeforeTool-specific fields. */
+export interface GeminiBeforeToolPayload extends GeminiStdinBase {
+    /** Name of the tool being executed. */
+    toolName?: string;
+    /** Input arguments for the tool. */
+    toolInput?: unknown;
+    /** Tool call identifier. */
+    toolCallId?: string;
+}
+/** AfterTool-specific fields. */
+export interface GeminiAfterToolPayload extends GeminiStdinBase {
+    /** Name of the tool that was executed. */
+    toolName?: string;
+    /** Input arguments for the tool. */
+    toolInput?: unknown;
+    /** Tool execution result. */
+    toolResult?: unknown;
+    /** Tool call identifier. */
+    toolCallId?: 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 Gemini 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 Gemini stdin data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+export declare function buildPayload(nativeEventName: string, stdinData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Normalize a Gemini CLI hook invocation into a UnifiedHookEvent.
+ *
+ * @param nativeEventName - The Gemini event name (e.g. 'BeforeToolSelection', 'AfterAgent').
+ * @param rawStdin - Raw stdin content (string or parsed object).
+ * @param env - Environment variables at invocation time.
+ */
+export declare function normalizeGemini(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":"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"}

package/dist/normalizer.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStdin = parseStdin;
+exports.buildExecutionContext = buildExecutionContext;
+exports.buildPayload = buildPayload;
+exports.normalizeGemini = normalizeGemini;
+const mappings_1 = require("./mappings");
+const session_resolver_1 = require("./session-resolver");
+/**
+ * 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 Gemini stdin payload and environment.
+ */
+function buildExecutionContext(stdinData, nativeEventName, env) {
+    const persistedEnv = {};
+    const contextVars = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (key.startsWith('HOOKS_PROXY_PERSIST_')) {
+            persistedEnv[key] = value;
+        }
+    }
+    const sessionId = (0, session_resolver_1.resolveSessionId)(stdinData, env);
+    return {
+        sessionId,
+        turnId: env['HOOKS_PROXY_TURN_ID'] ?? null,
+        conversationId: env['HOOKS_PROXY_CONVERSATION_ID'] ?? null,
+        adapter: 'gemini',
+        cwd: stdinData.cwd ?? env['PWD'] ?? null,
+        worktree: env['HOOKS_PROXY_WORKTREE'] ?? null,
+        transcriptPath: null,
+        source: null,
+        model: stdinData.model ?? env['HOOKS_PROXY_MODEL'] ?? null,
+        agentType: null,
+        permissionMode: null,
+        toolName: stdinData.toolName ?? null,
+        toolCallId: stdinData.toolCallId ?? null,
+        nativeEventName,
+        rawEventScope: null,
+        persistedEnv,
+        contextVars,
+        metadata: {
+            ...(stdinData.extensionPath != null ? { extensionPath: stdinData.extensionPath } : {}),
+        },
+    };
+}
+/**
+ * Build the payload portion of the unified event from Gemini stdin data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+function buildPayload(nativeEventName, stdinData) {
+    const payload = {};
+    switch (nativeEventName) {
+        case 'SessionStart':
+            if (stdinData.prompt != null)
+                payload.initialPrompt = stdinData.prompt;
+            break;
+        case 'SessionEnd':
+            // No event-specific fields beyond common ones
+            break;
+        case 'BeforeToolSelection':
+            if (stdinData.availableTools != null)
+                payload.availableTools = stdinData.availableTools;
+            if (stdinData.prompt != null)
+                payload.prompt = stdinData.prompt;
+            break;
+        case 'BeforeModel':
+            if (stdinData.request != null)
+                payload.llmRequest = stdinData.request;
+            if (stdinData.messages != null)
+                payload.messages = stdinData.messages;
+            break;
+        case 'AfterModel':
+            if (stdinData.response != null)
+                payload.llmResponse = stdinData.response;
+            if (stdinData.usage != null)
+                payload.usage = stdinData.usage;
+            break;
+        case 'BeforeAgent':
+            if (stdinData.prompt != null)
+                payload.prompt = stdinData.prompt;
+            break;
+        case 'AfterAgent':
+            if (stdinData.lastMessage != null)
+                payload.lastAssistantMessage = stdinData.lastMessage;
+            if (stdinData.reason != null)
+                payload.reason = stdinData.reason;
+            break;
+        case 'BeforeTool':
+            if (stdinData.toolName != null)
+                payload.toolName = stdinData.toolName;
+            if (stdinData.toolInput != null)
+                payload.toolInput = stdinData.toolInput;
+            if (stdinData.toolCallId != null)
+                payload.toolCallId = stdinData.toolCallId;
+            break;
+        case 'AfterTool':
+            if (stdinData.toolName != null)
+                payload.toolName = stdinData.toolName;
+            if (stdinData.toolInput != null)
+                payload.toolInput = stdinData.toolInput;
+            if (stdinData.toolResult != null)
+                payload.toolResponse = stdinData.toolResult;
+            if (stdinData.toolCallId != null)
+                payload.toolCallId = stdinData.toolCallId;
+            break;
+        default:
+            // Unknown event: pass through all non-common fields
+            for (const [key, value] of Object.entries(stdinData)) {
+                if (!['cwd', 'model', 'extensionPath'].includes(key)) {
+                    payload[key] = value;
+                }
+            }
+            break;
+    }
+    return payload;
+}
+/**
+ * Normalize a Gemini CLI hook invocation into a UnifiedHookEvent.
+ *
+ * @param nativeEventName - The Gemini event name (e.g. 'BeforeToolSelection', 'AfterAgent').
+ * @param rawStdin - Raw stdin content (string or parsed object).
+ * @param env - Environment variables at invocation time.
+ */
+function normalizeGemini(nativeEventName, rawStdin, env = {}) {
+    const stdinData = parseStdin(rawStdin);
+    const mapping = (0, mappings_1.getGeminiPhaseMapping)(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: 'gemini',
+        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,94 @@
+import type { UnifiedHookResult } from '@a5c-ai/hooks-mux-core';
+/**
+ * Gemini CLI native hook output formats.
+ *
+ * Gemini CLI hooks communicate results via JSON on stdout only.
+ * All diagnostic/log output MUST go to stderr.
+ */
+/** BeforeToolSelection hook output: tool filtering via union aggregation. */
+export interface GeminiBeforeToolSelectionOutput {
+    /** Tools to include — unioned across multiple hook responses. */
+    selectedTools?: string[];
+    /** Additional context to inject. */
+    additionalContext?: string;
+}
+/** BeforeModel hook output: request mutation. */
+export interface GeminiBeforeModelOutput {
+    /** System message to prepend or inject. */
+    systemMessage?: string;
+    /** Additional context to inject. */
+    additionalContext?: string;
+    /** Whether to block the model request entirely. */
+    block?: boolean;
+    /** Reason for blocking. */
+    reason?: string;
+}
+/** AfterModel hook output. */
+export interface GeminiAfterModelOutput {
+    /** Additional context to inject. */
+    additionalContext?: string;
+}
+/** BeforeAgent hook output. */
+export interface GeminiBeforeAgentOutput {
+    /** Additional context to inject. */
+    additionalContext?: string;
+    /** Whether to block the agent turn. */
+    block?: boolean;
+    /** Reason for blocking. */
+    reason?: string;
+}
+/** AfterAgent hook output: continuation control. */
+export interface GeminiAfterAgentOutput {
+    /** If true, continue the session with a follow-up. */
+    continueSession?: boolean;
+    /** Follow-up prompt to inject if continuing. */
+    followUpMessage?: string;
+    /** Additional context to inject. */
+    additionalContext?: string;
+    /** Reason for the decision. */
+    reason?: string;
+}
+/** BeforeTool hook output: permission and mutation. */
+export interface GeminiBeforeToolOutput {
+    /** Permission decision. */
+    decision?: 'allow' | 'deny';
+    /** Reason for the decision. */
+    reason?: string;
+    /** Mutated tool input (replaces original). */
+    toolInput?: unknown;
+    /** Additional context to inject. */
+    additionalContext?: string;
+}
+/** AfterTool hook output. */
+export interface GeminiAfterToolOutput {
+    /** Additional context to inject. */
+    additionalContext?: string;
+}
+/** SessionStart hook output. */
+export interface GeminiSessionStartOutput {
+    /** Additional context to inject. */
+    additionalContext?: string;
+}
+/**
+ * Render a UnifiedHookResult back to Gemini's native JSON output format.
+ *
+ * Output JSON goes to stdout. Any diagnostic or log output must go to stderr
+ * (handled by the caller, not here).
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original Gemini event name.
+ * @returns The native JSON output to write to stdout.
+ */
+export declare function renderGeminiOutput(result: UnifiedHookResult, nativeEventName: string): Record<string, unknown>;
+/**
+ * Write JSON output to stdout and log message to stderr.
+ *
+ * Gemini CLI requires that only the final JSON result goes to stdout.
+ * All diagnostic messages must go to stderr.
+ */
+export declare function emitOutput(output: Record<string, unknown>, log?: string): void;
+/**
+ * Write a log/diagnostic message to stderr (never stdout).
+ */
+export declare function logToStderr(message: string): void;
+//# 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,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;GAKG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,+BAA+B;IAC9C,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8BAA8B;AAC9B,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,+BAA+B;AAC/B,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,6BAA6B;AAC7B,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,gCAAgC;AAChC,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB;AAqJD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAK9E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD"}

package/dist/renderer.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderGeminiOutput = renderGeminiOutput;
+exports.emitOutput = emitOutput;
+exports.logToStderr = logToStderr;
+/**
+ * Render a UnifiedHookResult back to Gemini's native JSON output format.
+ *
+ * Output JSON goes to stdout. Any diagnostic or log output must go to stderr
+ * (handled by the caller, not here).
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original Gemini event name.
+ * @returns The native JSON output to write to stdout.
+ */
+function renderGeminiOutput(result, nativeEventName) {
+    switch (nativeEventName) {
+        case 'BeforeToolSelection':
+            return renderBeforeToolSelectionOutput(result);
+        case 'BeforeModel':
+            return renderBeforeModelOutput(result);
+        case 'AfterModel':
+            return renderAfterModelOutput(result);
+        case 'BeforeAgent':
+            return renderBeforeAgentOutput(result);
+        case 'AfterAgent':
+            return renderAfterAgentOutput(result);
+        case 'BeforeTool':
+            return renderBeforeToolOutput(result);
+        case 'AfterTool':
+            return renderAfterToolOutput(result);
+        case 'SessionStart':
+            return renderSessionStartOutput(result);
+        default:
+            return renderGenericOutput(result);
+    }
+}
+function renderBeforeToolSelectionOutput(result) {
+    const output = {};
+    // toolMutation for BeforeToolSelection carries the selected tool list
+    if (result.toolMutation?.value != null && Array.isArray(result.toolMutation.value)) {
+        output.selectedTools = result.toolMutation.value;
+    }
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    return output;
+}
+function renderBeforeModelOutput(result) {
+    const output = {};
+    if (result.systemMessage != null) {
+        output.systemMessage = result.systemMessage;
+    }
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    if (result.decision === 'deny') {
+        output.block = true;
+        if (result.reason != null) {
+            output.reason = result.reason;
+        }
+    }
+    return output;
+}
+function renderAfterModelOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    return output;
+}
+function renderBeforeAgentOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    if (result.decision === 'deny') {
+        output.block = true;
+        if (result.reason != null) {
+            output.reason = result.reason;
+        }
+    }
+    return output;
+}
+function renderAfterAgentOutput(result) {
+    const output = {};
+    if (result.continueSession != null) {
+        output.continueSession = result.continueSession;
+    }
+    if (result.followUpMessage != null) {
+        output.followUpMessage = result.followUpMessage;
+    }
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    if (result.stopReason != null) {
+        output.reason = result.stopReason;
+    }
+    else if (result.reason != null) {
+        output.reason = result.reason;
+    }
+    return output;
+}
+function renderBeforeToolOutput(result) {
+    const output = {};
+    if (result.decision === 'allow') {
+        output.decision = 'allow';
+    }
+    else if (result.decision === 'deny') {
+        output.decision = 'deny';
+    }
+    // 'ask', 'continue', 'noop' produce no decision — Gemini defaults to allow
+    if (result.reason != null) {
+        output.reason = result.reason;
+    }
+    // Tool input mutation
+    if (result.toolMutation?.value != null) {
+        output.toolInput = result.toolMutation.value;
+    }
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    return output;
+}
+function renderAfterToolOutput(result) {
+    const output = {};
+    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;
+}
+/**
+ * Write JSON output to stdout and log message to stderr.
+ *
+ * Gemini CLI requires that only the final JSON result goes to stdout.
+ * All diagnostic messages must go to stderr.
+ */
+function emitOutput(output, log) {
+    if (log != null) {
+        process.stderr.write(log + '\n');
+    }
+    process.stdout.write(JSON.stringify(output) + '\n');
+}
+/**
+ * Write a log/diagnostic message to stderr (never stdout).
+ */
+function logToStderr(message) {
+    process.stderr.write(message + '\n');
+}
+//# 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,26 @@
+/**
+ * Resolve a session ID for Gemini CLI.
+ *
+ * Gemini CLI does not provide a native session ID on stdin.
+ * The session ID is derived from available signals:
+ *
+ *   1. Explicit env: AGENT_SESSION_ID or HOOKS_PROXY_SESSION_ID
+ *   2. Gemini-specific env: GEMINI_SESSION_ID
+ *   3. Derived from workspace (cwd) + a date-bucket to avoid accidental
+ *      cross-session merging while keeping the ID stable within a session window.
+ *
+ * Spec section 9.2 — session ID quality: 'derived'.
+ */
+export declare function resolveSessionId(stdinData: Record<string, unknown>, env: Record<string, string>): string | null;
+/**
+ * Derive a deterministic session ID from the workspace directory.
+ *
+ * Uses a 15-minute time bucket so that hooks fired within the same
+ * working session are grouped together, while separate launches
+ * in different time windows get different IDs.
+ *
+ * The bucket window is intentionally coarse to keep the same session ID
+ * stable across rapid hook invocations within a single CLI session.
+ */
+export declare function deriveSessionId(cwd: string): string;
+//# 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":"AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,MAAM,GAAG,IAAI,CAqBf;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/session-resolver.js

@@ -0,0 +1,88 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = resolveSessionId;
+exports.deriveSessionId = deriveSessionId;
+const crypto = __importStar(require("crypto"));
+/**
+ * Resolve a session ID for Gemini CLI.
+ *
+ * Gemini CLI does not provide a native session ID on stdin.
+ * The session ID is derived from available signals:
+ *
+ *   1. Explicit env: AGENT_SESSION_ID or HOOKS_PROXY_SESSION_ID
+ *   2. Gemini-specific env: GEMINI_SESSION_ID
+ *   3. Derived from workspace (cwd) + a date-bucket to avoid accidental
+ *      cross-session merging while keeping the ID stable within a session window.
+ *
+ * Spec section 9.2 — session ID quality: 'derived'.
+ */
+function resolveSessionId(stdinData, env) {
+    // 1. Explicit session ID from env (highest priority)
+    if (env['AGENT_SESSION_ID']) {
+        return env['AGENT_SESSION_ID'];
+    }
+    if (env['HOOKS_PROXY_SESSION_ID']) {
+        return env['HOOKS_PROXY_SESSION_ID'];
+    }
+    // 2. Gemini-specific session env
+    if (env['GEMINI_SESSION_ID']) {
+        return env['GEMINI_SESSION_ID'];
+    }
+    // 3. Derive from workspace + date bucket
+    const cwd = stdinData.cwd ?? env['PWD'] ?? null;
+    if (cwd != null) {
+        return deriveSessionId(cwd);
+    }
+    return null;
+}
+/**
+ * Derive a deterministic session ID from the workspace directory.
+ *
+ * Uses a 15-minute time bucket so that hooks fired within the same
+ * working session are grouped together, while separate launches
+ * in different time windows get different IDs.
+ *
+ * The bucket window is intentionally coarse to keep the same session ID
+ * stable across rapid hook invocations within a single CLI session.
+ */
+function deriveSessionId(cwd) {
+    const bucketMs = 15 * 60 * 1000; // 15 minutes
+    const timeBucket = Math.floor(Date.now() / bucketMs);
+    const input = `gemini:${cwd}:${timeBucket}`;
+    const hash = crypto.createHash('sha256').update(input).digest('hex').slice(0, 16);
+    return `gemini-derived-${hash}`;
+}
+//# 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,4CAwBC;AAYD,0CAMC;AAzDD,+CAAiC;AAEjC;;;;;;;;;;;;GAYG;AACH,SAAgB,gBAAgB,CAC9B,SAAkC,EAClC,GAA2B;IAE3B,qDAAqD;IACrD,IAAI,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAClC,OAAO,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;IAED,iCAAiC;IACjC,IAAI,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAClC,CAAC;IAED,yCAAyC;IACzC,MAAM,GAAG,GAAI,SAAS,CAAC,GAA0B,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACxE,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClF,OAAO,kBAAkB,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@a5c-ai/hooks-mux-adapter-gemini",
+  "version": "5.0.1-staging.048a6d1f",
+  "description": "Gemini CLI 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-gemini"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/packages/hooks-mux/adapter-gemini#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"
+  }
+}