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

package/README.md

@@ -0,0 +1,29 @@
+# @a5c-ai/hooks-mux-adapter-cursor
+
+Cursor harness adapter for hooks-mux.
+
+## Install
+
+```bash
+npm install @a5c-ai/hooks-mux-adapter-cursor @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,
+  normalizeCursorEvent,
+  getActiveProfile,
+} from "@a5c-ai/hooks-mux-adapter-cursor";
+```
+
+The package exposes Cursor-specific normalization, capability profiles, 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,CAoBtF"}

package/dist/adapter.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+const agent_catalog_1 = require("@a5c-ai/agent-catalog");
+/**
+ * Creates the Cursor adapter capability descriptor.
+ *
+ * Reads capability data from the Atlas graph via the agent-catalog.
+ * Falls back to hardcoded defaults if the catalog is unavailable.
+ *
+ * Spec section 17.5.
+ */
+const DEFAULT_ADAPTER_NAME = 'cursor';
+function createAdapter(name = DEFAULT_ADAPTER_NAME) {
+    const target = (0, agent_catalog_1.getPluginTargetDescriptor)(name);
+    return {
+        name,
+        family: target?.hooksMuxFamily ?? 'shell-hook',
+        sessionIdQuality: target?.sessionIdQuality ?? 'derived',
+        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 ?? 'all',
+        notes: [
+            'Hook surface is stable as of Cursor 3.0',
+            'IDE and CLI share the same hook surface',
+        ],
+    };
+}
+//# 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,sCAoBC;AAhCD,yDAAkE;AAElE;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAEtC,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,SAAS;QACpG,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,KAAK;QAC/G,KAAK,EAAE;YACL,yCAAyC;YACzC,yCAAyC;SAC1C;KACF,CAAC;AACJ,CAAC"}

package/dist/capability-profile.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Capability profiles for the Cursor adapter.
+ *
+ * Cursor's hook surface evolves rapidly. This module allows
+ * overriding the default capability assumptions when the
+ * adapter's built-in profile doesn't match the actual Cursor
+ * version/mode being used.
+ *
+ * Spec section 17.5: "allow adapter version/profile overrides
+ * if Cursor behavior changes rapidly."
+ */
+/**
+ * Describes what the current Cursor version/mode supports.
+ */
+export interface CursorCapabilityProfile {
+    /** Profile name for diagnostics. */
+    name: string;
+    /** Cursor version range this profile applies to (informational). */
+    cursorVersion?: string;
+    /** Whether Cursor is running as IDE or CLI. */
+    mode: 'ide' | 'cli' | 'unknown';
+    /** Which native hook events are known to fire reliably. */
+    reliableEvents: string[];
+    /** Which native hook events exist but are unreliable or undocumented. */
+    unreliableEvents: string[];
+    /** Whether stop hook can actually continue the session. */
+    stopCanContinue: boolean;
+    /** Whether tool-level hooks are available at all. */
+    toolHooksAvailable: boolean;
+    /** Free-form notes about this profile's known limitations. */
+    notes: string[];
+}
+/**
+ * The default profile: based on the documented/stable Cursor
+ * hook surface as of mid-2026. All listed events are now
+ * documented as native hooks per Cursor's official docs.
+ */
+export declare const DEFAULT_PROFILE: CursorCapabilityProfile;
+/**
+ * A CLI-specific profile with the same capabilities as default.
+ * Retained for backward compatibility.
+ */
+export declare const CLI_PERMISSIVE_PROFILE: CursorCapabilityProfile;
+/**
+ * Get the currently active capability profile.
+ */
+export declare function getActiveProfile(): CursorCapabilityProfile;
+/**
+ * Override the active capability profile.
+ * Use this when deploying against a known Cursor version/mode
+ * that differs from the default conservative assumptions.
+ *
+ * @param profile - The profile to activate.
+ */
+export declare function setActiveProfile(profile: CursorCapabilityProfile): void;
+/**
+ * Reset to the default conservative profile.
+ */
+export declare function resetProfile(): void;
+/**
+ * Check whether a given native event name is considered reliable
+ * under the current profile.
+ */
+export declare function isEventReliable(nativeEventName: string): boolean;
+/**
+ * Check whether a given native event name is known at all
+ * (reliable or unreliable) under the current profile.
+ */
+export declare function isEventKnown(nativeEventName: string): boolean;
+/**
+ * Build a diagnostics summary of profile-related uncertainty
+ * for a given event. Used by the normalizer to annotate events.
+ */
+export declare function getEventDiagnostics(nativeEventName: string): {
+    isReliable: boolean;
+    isKnown: boolean;
+    profileName: string;
+    mode: string;
+    warnings: string[];
+};
+//# sourceMappingURL=capability-profile.d.ts.map

package/dist/capability-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-profile.d.ts","sourceRoot":"","sources":["../src/capability-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAChC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,2DAA2D;IAC3D,eAAe,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,uBAW7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,uBAUpC,CAAC;AAKF;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,uBAAuB,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG;IAC5D,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CA8BA"}

package/dist/capability-profile.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Capability profiles for the Cursor adapter.
+ *
+ * Cursor's hook surface evolves rapidly. This module allows
+ * overriding the default capability assumptions when the
+ * adapter's built-in profile doesn't match the actual Cursor
+ * version/mode being used.
+ *
+ * Spec section 17.5: "allow adapter version/profile overrides
+ * if Cursor behavior changes rapidly."
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_PERMISSIVE_PROFILE = exports.DEFAULT_PROFILE = void 0;
+exports.getActiveProfile = getActiveProfile;
+exports.setActiveProfile = setActiveProfile;
+exports.resetProfile = resetProfile;
+exports.isEventReliable = isEventReliable;
+exports.isEventKnown = isEventKnown;
+exports.getEventDiagnostics = getEventDiagnostics;
+/**
+ * The default profile: based on the documented/stable Cursor
+ * hook surface as of mid-2026. All listed events are now
+ * documented as native hooks per Cursor's official docs.
+ */
+exports.DEFAULT_PROFILE = {
+    name: 'default',
+    mode: 'unknown',
+    reliableEvents: ['sessionStart', 'sessionEnd', 'stop', 'preToolUse', 'postToolUse'],
+    unreliableEvents: [],
+    stopCanContinue: true,
+    toolHooksAvailable: true,
+    notes: [
+        'All hook events are documented and stable as of Cursor 3.0',
+        'IDE and CLI share the same event surface',
+    ],
+};
+/**
+ * A CLI-specific profile with the same capabilities as default.
+ * Retained for backward compatibility.
+ */
+exports.CLI_PERMISSIVE_PROFILE = {
+    name: 'cli-permissive',
+    mode: 'cli',
+    reliableEvents: ['sessionStart', 'sessionEnd', 'stop', 'preToolUse', 'postToolUse'],
+    unreliableEvents: [],
+    stopCanContinue: true,
+    toolHooksAvailable: true,
+    notes: [
+        'CLI mode with full hook support',
+    ],
+};
+/** Active profile — defaults to conservative. */
+let activeProfile = { ...exports.DEFAULT_PROFILE };
+/**
+ * Get the currently active capability profile.
+ */
+function getActiveProfile() {
+    return activeProfile;
+}
+/**
+ * Override the active capability profile.
+ * Use this when deploying against a known Cursor version/mode
+ * that differs from the default conservative assumptions.
+ *
+ * @param profile - The profile to activate.
+ */
+function setActiveProfile(profile) {
+    activeProfile = { ...profile };
+}
+/**
+ * Reset to the default conservative profile.
+ */
+function resetProfile() {
+    activeProfile = { ...exports.DEFAULT_PROFILE };
+}
+/**
+ * Check whether a given native event name is considered reliable
+ * under the current profile.
+ */
+function isEventReliable(nativeEventName) {
+    return activeProfile.reliableEvents.includes(nativeEventName);
+}
+/**
+ * Check whether a given native event name is known at all
+ * (reliable or unreliable) under the current profile.
+ */
+function isEventKnown(nativeEventName) {
+    return (activeProfile.reliableEvents.includes(nativeEventName) ||
+        activeProfile.unreliableEvents.includes(nativeEventName));
+}
+/**
+ * Build a diagnostics summary of profile-related uncertainty
+ * for a given event. Used by the normalizer to annotate events.
+ */
+function getEventDiagnostics(nativeEventName) {
+    const isReliable = activeProfile.reliableEvents.includes(nativeEventName);
+    const isKnown = isReliable || activeProfile.unreliableEvents.includes(nativeEventName);
+    const warnings = [];
+    if (!isKnown) {
+        warnings.push(`Event '${nativeEventName}' is not recognized by the '${activeProfile.name}' capability profile`);
+    }
+    else if (!isReliable) {
+        warnings.push(`Event '${nativeEventName}' is known but unreliable under the '${activeProfile.name}' profile`);
+    }
+    if (activeProfile.mode === 'unknown') {
+        warnings.push('Cursor mode (IDE vs CLI) is unknown; event behavior may vary');
+    }
+    return {
+        isReliable,
+        isKnown,
+        profileName: activeProfile.name,
+        mode: activeProfile.mode,
+        warnings,
+    };
+}
+//# sourceMappingURL=capability-profile.js.map

package/dist/capability-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-profile.js","sourceRoot":"","sources":["../src/capability-profile.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAgEH,4CAEC;AASD,4CAEC;AAKD,oCAEC;AAMD,0CAEC;AAMD,oCAKC;AAMD,kDAoCC;AAzHD;;;;GAIG;AACU,QAAA,eAAe,GAA4B;IACtD,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,cAAc,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC;IACnF,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,KAAK,EAAE;QACL,4DAA4D;QAC5D,0CAA0C;KAC3C;CACF,CAAC;AAEF;;;GAGG;AACU,QAAA,sBAAsB,GAA4B;IAC7D,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,KAAK;IACX,cAAc,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC;IACnF,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,KAAK,EAAE;QACL,iCAAiC;KAClC;CACF,CAAC;AAEF,iDAAiD;AACjD,IAAI,aAAa,GAA4B,EAAE,GAAG,uBAAe,EAAE,CAAC;AAEpE;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,OAAgC;IAC/D,aAAa,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY;IAC1B,aAAa,GAAG,EAAE,GAAG,uBAAe,EAAE,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,eAAuB;IACrD,OAAO,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,eAAuB;IAClD,OAAO,CACL,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC;QACtD,aAAa,CAAC,gBAAgB,CAAC,QAAQ,CAAC,eAAe,CAAC,CACzD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,eAAuB;IAOzD,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC1E,MAAM,OAAO,GACX,UAAU,IAAI,aAAa,CAAC,gBAAgB,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CACX,UAAU,eAAe,+BAA+B,aAAa,CAAC,IAAI,sBAAsB,CACjG,CAAC;IACJ,CAAC;SAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,UAAU,eAAe,wCAAwC,aAAa,CAAC,IAAI,WAAW,CAC/F,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CACX,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU;QACV,OAAO;QACP,WAAW,EAAE,aAAa,CAAC,IAAI;QAC/B,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { createAdapter } from './adapter';
+export { getActiveProfile, setActiveProfile, resetProfile, isEventReliable, isEventKnown, getEventDiagnostics, DEFAULT_PROFILE, CLI_PERMISSIVE_PROFILE, } from './capability-profile';
+export type { CursorCapabilityProfile } from './capability-profile';
+export { CURSOR_PHASE_MAPPINGS, findMapping, getSupportedPhases } from './mappings';
+export { normalizeCursorEvent, parseStdin, setAdapterName, ADAPTER_NAME, } from './normalizer';
+export type { CursorStdinBase, CursorSessionStartPayload, CursorStopPayload, CursorPreToolUsePayload, CursorPostToolUsePayload, } from './normalizer';
+export { renderCursorOutput, isFieldSupportedForEvent } from './renderer';
+export { resolveSessionId, deriveSessionId, isValidSessionId } 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":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGpF,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzF,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidSessionId = exports.deriveSessionId = exports.resolveSessionId = exports.isFieldSupportedForEvent = exports.renderCursorOutput = exports.ADAPTER_NAME = exports.setAdapterName = exports.parseStdin = exports.normalizeCursorEvent = exports.getSupportedPhases = exports.findMapping = exports.CURSOR_PHASE_MAPPINGS = exports.CLI_PERMISSIVE_PROFILE = exports.DEFAULT_PROFILE = exports.getEventDiagnostics = exports.isEventKnown = exports.isEventReliable = exports.resetProfile = exports.setActiveProfile = exports.getActiveProfile = exports.createAdapter = void 0;
+// Adapter capabilities
+var adapter_1 = require("./adapter");
+Object.defineProperty(exports, "createAdapter", { enumerable: true, get: function () { return adapter_1.createAdapter; } });
+// Capability profile
+var capability_profile_1 = require("./capability-profile");
+Object.defineProperty(exports, "getActiveProfile", { enumerable: true, get: function () { return capability_profile_1.getActiveProfile; } });
+Object.defineProperty(exports, "setActiveProfile", { enumerable: true, get: function () { return capability_profile_1.setActiveProfile; } });
+Object.defineProperty(exports, "resetProfile", { enumerable: true, get: function () { return capability_profile_1.resetProfile; } });
+Object.defineProperty(exports, "isEventReliable", { enumerable: true, get: function () { return capability_profile_1.isEventReliable; } });
+Object.defineProperty(exports, "isEventKnown", { enumerable: true, get: function () { return capability_profile_1.isEventKnown; } });
+Object.defineProperty(exports, "getEventDiagnostics", { enumerable: true, get: function () { return capability_profile_1.getEventDiagnostics; } });
+Object.defineProperty(exports, "DEFAULT_PROFILE", { enumerable: true, get: function () { return capability_profile_1.DEFAULT_PROFILE; } });
+Object.defineProperty(exports, "CLI_PERMISSIVE_PROFILE", { enumerable: true, get: function () { return capability_profile_1.CLI_PERMISSIVE_PROFILE; } });
+// Phase mappings
+var mappings_1 = require("./mappings");
+Object.defineProperty(exports, "CURSOR_PHASE_MAPPINGS", { enumerable: true, get: function () { return mappings_1.CURSOR_PHASE_MAPPINGS; } });
+Object.defineProperty(exports, "findMapping", { enumerable: true, get: function () { return mappings_1.findMapping; } });
+Object.defineProperty(exports, "getSupportedPhases", { enumerable: true, get: function () { return mappings_1.getSupportedPhases; } });
+// Normalizer
+var normalizer_1 = require("./normalizer");
+Object.defineProperty(exports, "normalizeCursorEvent", { enumerable: true, get: function () { return normalizer_1.normalizeCursorEvent; } });
+Object.defineProperty(exports, "parseStdin", { enumerable: true, get: function () { return normalizer_1.parseStdin; } });
+Object.defineProperty(exports, "setAdapterName", { enumerable: true, get: function () { return normalizer_1.setAdapterName; } });
+Object.defineProperty(exports, "ADAPTER_NAME", { enumerable: true, get: function () { return normalizer_1.ADAPTER_NAME; } });
+// Renderer
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "renderCursorOutput", { enumerable: true, get: function () { return renderer_1.renderCursorOutput; } });
+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, "deriveSessionId", { enumerable: true, get: function () { return session_resolver_1.deriveSessionId; } });
+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,qBAAqB;AACrB,2DAS8B;AAR5B,sHAAA,gBAAgB,OAAA;AAChB,sHAAA,gBAAgB,OAAA;AAChB,kHAAA,YAAY,OAAA;AACZ,qHAAA,eAAe,OAAA;AACf,kHAAA,YAAY,OAAA;AACZ,yHAAA,mBAAmB,OAAA;AACnB,qHAAA,eAAe,OAAA;AACf,4HAAA,sBAAsB,OAAA;AAIxB,iBAAiB;AACjB,uCAAoF;AAA3E,iHAAA,qBAAqB,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAE/D,aAAa;AACb,2CAKsB;AAJpB,kHAAA,oBAAoB,OAAA;AACpB,wGAAA,UAAU,OAAA;AACV,4GAAA,cAAc,OAAA;AACd,0GAAA,YAAY,OAAA;AAUd,WAAW;AACX,uCAA0E;AAAjE,8GAAA,kBAAkB,OAAA;AAAE,oHAAA,wBAAwB,OAAA;AAErD,mBAAmB;AACnB,uDAAyF;AAAhF,oHAAA,gBAAgB,OAAA;AAAE,mHAAA,eAAe,OAAA;AAAE,oHAAA,gBAAgB,OAAA"}

package/dist/mappings.d.ts

@@ -0,0 +1,11 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-mux-core';
+export declare const CURSOR_PHASE_MAPPINGS: PhaseMapping[];
+/**
+ * Quick lookup from native event name to phase mapping.
+ */
+export declare function findMapping(nativeEventName: string): PhaseMapping | undefined;
+/**
+ * Get all canonical phases supported by the Cursor 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;AAkD3D,eAAO,MAAM,qBAAqB,EAAE,YAAY,EAAuB,CAAC;AAExE;;GAEG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/mappings.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURSOR_PHASE_MAPPINGS = void 0;
+exports.findMapping = findMapping;
+exports.getSupportedPhases = getSupportedPhases;
+const agent_catalog_1 = require("@a5c-ai/agent-catalog");
+/**
+ * Cursor 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.5.
+ */
+const SUPPORT_LEVEL_MAP = {
+    supported: 'native',
+    native: 'native',
+    lossy: 'lossy',
+    emulated: 'emulated',
+    unsupported: 'unsupported',
+};
+function hookMappingToPhaseMapping(mapping) {
+    if (!mapping.canonicalPhase)
+        return null;
+    return {
+        canonicalPhase: mapping.canonicalPhase,
+        nativeHook: mapping.nativeName,
+        supportLevel: SUPPORT_LEVEL_MAP[mapping.supportLevel] ?? 'native',
+        blockCapability: mapping.blockCapability ?? false,
+        mutationCapability: mapping.mutationCapability ?? false,
+        scope: (mapping.scope ?? 'session'),
+    };
+}
+function buildFromCatalog() {
+    const mappings = (0, agent_catalog_1.listHookMappingsByAdapterFamily)('cursor');
+    if (mappings.length === 0) {
+        throw new Error('hooks-mux adapter-cursor: catalog unavailable or returned no mappings for family "cursor"');
+    }
+    const phaseMappings = 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.CURSOR_PHASE_MAPPINGS = buildFromCatalog();
+/**
+ * Quick lookup from native event name to phase mapping.
+ */
+function findMapping(nativeEventName) {
+    return exports.CURSOR_PHASE_MAPPINGS.find((m) => m.nativeHook === nativeEventName);
+}
+/**
+ * Get all canonical phases supported by the Cursor adapter.
+ */
+function getSupportedPhases() {
+    return exports.CURSOR_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":";;;AAuDA,kCAEC;AAKD,gDAEC;AA/DD,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,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,QAAQ;QACjE,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,QAAQ,CAAC,CAAC;IAC3D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAC;IAC/G,CAAC;IACD,MAAM,aAAa,GAAG,QAAQ;SAC3B,GAAG,CAAC,yBAAyB,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAChD,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,qBAAqB,GAAmB,gBAAgB,EAAE,CAAC;AAExE;;GAEG;AACH,SAAgB,WAAW,CAAC,eAAuB;IACjD,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,58 @@
+import { type UnifiedHookEvent } from '@a5c-ai/hooks-mux-core';
+/** The default adapter identifier used in all normalized events. */
+export declare const ADAPTER_NAME = "cursor";
+/** Override the adapter name used in normalized events. */
+export declare function setAdapterName(name: string): void;
+/**
+ * Common fields that may be present on Cursor hook stdin payloads.
+ * Cursor's stdin format is not fully documented; fields may be
+ * absent or undefined. The normalizer handles all cases gracefully.
+ */
+export interface CursorStdinBase {
+    cwd?: string;
+    workspace?: string;
+    model?: string;
+    [key: string]: unknown;
+}
+/** SessionStart-specific fields. */
+export interface CursorSessionStartPayload extends CursorStdinBase {
+    source?: string;
+}
+/** Stop-specific fields. */
+export interface CursorStopPayload extends CursorStdinBase {
+    reason?: string;
+    stop_hook_active?: boolean;
+}
+/** PreToolUse-specific fields (when available). */
+export interface CursorPreToolUsePayload extends CursorStdinBase {
+    tool_name?: string;
+    tool_call_id?: string;
+    tool_input?: unknown;
+}
+/** PostToolUse-specific fields (when available). */
+export interface CursorPostToolUsePayload extends CursorStdinBase {
+    tool_name?: string;
+    tool_call_id?: string;
+    tool_input?: unknown;
+    tool_response?: unknown;
+}
+/**
+ * Parse raw stdin input into a typed object.
+ * Cursor hooks receive JSON on stdin. If parsing fails, return empty
+ * object (fail-open: Cursor's payload format is not fully documented).
+ */
+export declare function parseStdin(raw: unknown): Record<string, unknown>;
+/**
+ * Normalize a raw Cursor hook invocation into a UnifiedHookEvent.
+ *
+ * Cursor's hook surface is experimental. The normalizer:
+ * - Parses stdin gracefully (fail-open on missing/malformed fields)
+ * - Annotates events with capability profile diagnostics
+ * - Enriches env from stdin payload fields
+ *
+ * @param rawEventName - The native Cursor 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 normalizeCursorEvent(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;AAItG,oEAAoE;AACpE,eAAO,MAAM,YAAY,WAAW,CAAC;AAKrC,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,4BAA4B;AAC5B,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,mDAAmD;AACnD,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,oDAAoD;AACpD,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;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBhE;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,OAAO,EACrB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,gBAAgB,CAoDlB"}

package/dist/normalizer.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_NAME = void 0;
+exports.setAdapterName = setAdapterName;
+exports.parseStdin = parseStdin;
+exports.normalizeCursorEvent = normalizeCursorEvent;
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+const mappings_1 = require("./mappings");
+const capability_profile_1 = require("./capability-profile");
+/** The default adapter identifier used in all normalized events. */
+exports.ADAPTER_NAME = 'cursor';
+/** Mutable adapter name, defaulting to the cursor adapter identity. */
+let _adapterName = 'cursor';
+/** Override the adapter name used in normalized events. */
+function setAdapterName(name) {
+    _adapterName = name;
+}
+/**
+ * Parse raw stdin input into a typed object.
+ * Cursor hooks receive JSON on stdin. If parsing fails, return empty
+ * object (fail-open: Cursor's payload format is not fully documented).
+ */
+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 -- Cursor payload format is uncertain
+        }
+        return {};
+    }
+    if (typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    return {};
+}
+/**
+ * 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 Cursor hook invocation into a UnifiedHookEvent.
+ *
+ * Cursor's hook surface is experimental. The normalizer:
+ * - Parses stdin gracefully (fail-open on missing/malformed fields)
+ * - Annotates events with capability profile diagnostics
+ * - Enriches env from stdin payload fields
+ *
+ * @param rawEventName - The native Cursor event name (e.g. 'sessionStart', 'stop')
+ * @param stdinPayload - Raw stdin content (string or parsed object)
+ * @param env - Environment variables at invocation time
+ */
+function normalizeCursorEvent(rawEventName, stdinPayload, env = {}) {
+    const parsed = parseStdin(stdinPayload);
+    // Enrich env with Cursor-specific fields extracted from stdin
+    const enrichedEnv = { ...env };
+    // Cursor does not provide a native session_id -- derive from workspace/cwd
+    if (typeof parsed['cwd'] === 'string' && !enrichedEnv['HOOKS_PROXY_CWD']) {
+        enrichedEnv['HOOKS_PROXY_CWD'] = parsed['cwd'];
+    }
+    if (typeof parsed['workspace'] === 'string' && !enrichedEnv['HOOKS_PROXY_WORKTREE']) {
+        enrichedEnv['HOOKS_PROXY_WORKTREE'] = parsed['workspace'];
+    }
+    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.CURSOR_PHASE_MAPPINGS,
+    };
+    const event = (0, hooks_mux_core_1.normalizeEvent)(options);
+    // Annotate with capability profile diagnostics
+    const diagnostics = (0, capability_profile_1.getEventDiagnostics)(rawEventName);
+    event.execution.metadata = {
+        ...event.execution.metadata,
+        cursorDiagnostics: diagnostics,
+        experimental: true,
+    };
+    return event;
+}
+//# 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 Cursor-native output JSON.
+ *
+ * Only includes fields that are known to be processed for the given
+ * native event type. Unsupported fields are silently dropped.
+ *
+ * @param mergedResult - The merged result from multi-hook fan-out
+ * @param nativeEventName - The original Cursor event name
+ * @returns Cursor-native output object, and list of dropped fields
+ */
+export declare function renderCursorOutput(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;AA4CpE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,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,CAwB9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAGxF"}

package/dist/renderer.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderCursorOutput = renderCursorOutput;
+exports.isFieldSupportedForEvent = isFieldSupportedForEvent;
+/**
+ * Cursor native output fields that are documented/supported per event type.
+ *
+ * Cursor output semantics are limited and not fully documented.
+ * Only emit fields that are known to be processed by the Cursor runtime.
+ * Unknown/unsupported fields are silently dropped (fail-open, conservative).
+ *
+ * Spec section 17.5: "render output conservatively, only emitting fields
+ * known to be processed."
+ */
+/** Output fields supported on stop. */
+const STOP_FIELDS = new Set([
+    'continueSession',
+    'stopReason',
+    'reason',
+]);
+/** Output fields supported on sessionStart (mostly ignored). */
+const SESSION_START_FIELDS = new Set([
+    'reason',
+]);
+/** Output fields supported on preToolUse (when available). */
+const PRE_TOOL_USE_FIELDS = new Set([
+    'decision',
+    'reason',
+]);
+/** Output fields supported on postToolUse (when available). */
+const POST_TOOL_USE_FIELDS = new Set([
+    'reason',
+]);
+/** Map native event names to their supported output field sets. */
+const SUPPORTED_FIELDS_BY_EVENT = {
+    sessionStart: SESSION_START_FIELDS,
+    stop: STOP_FIELDS,
+    preToolUse: PRE_TOOL_USE_FIELDS,
+    postToolUse: POST_TOOL_USE_FIELDS,
+};
+/**
+ * Render a merged execution result into Cursor-native output JSON.
+ *
+ * Only includes fields that are known to be processed for the given
+ * native event type. Unsupported fields are silently dropped.
+ *
+ * @param mergedResult - The merged result from multi-hook fan-out
+ * @param nativeEventName - The original Cursor event name
+ * @returns Cursor-native output object, and list of dropped fields
+ */
+function renderCursorOutput(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: 'continueSession', value: mergedResult.continueSession, isEmpty: mergedResult.continueSession === true },
+        { key: 'stopReason', value: mergedResult.stopReason, isEmpty: !mergedResult.stopReason },
+    ];
+    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":";;AAsDA,gDA2BC;AAKD,4DAGC;AAvFD;;;;;;;;;GASG;AAEH,uCAAuC;AACvC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,iBAAiB;IACjB,YAAY;IACZ,QAAQ;CACT,CAAC,CAAC;AAEH,gEAAgE;AAChE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,QAAQ;CACT,CAAC,CAAC;AAEH,8DAA8D;AAC9D,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,UAAU;IACV,QAAQ;CACT,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,QAAQ;CACT,CAAC,CAAC;AAEH,mEAAmE;AACnE,MAAM,yBAAyB,GAAgC;IAC7D,YAAY,EAAE,oBAAoB;IAClC,IAAI,EAAE,WAAW;IACjB,UAAU,EAAE,mBAAmB;IAC/B,WAAW,EAAE,oBAAoB;CAClC,CAAC;AAEF;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAChC,YAAmC,EACnC,eAAuB;IAEvB,MAAM,eAAe,GAAG,yBAAyB,CAAC,eAAe,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;IACxF,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,iDAAiD;IACjD,MAAM,UAAU,GAA6D;QAC3E,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,QAAQ,KAAK,MAAM,EAAE;QAC5F,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE;QAC5E,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,YAAY,CAAC,eAAe,EAAE,OAAO,EAAE,YAAY,CAAC,eAAe,KAAK,IAAI,EAAE;QAC/G,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE;KACzF,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,OAAO;YAAE,SAAS;QAEhC,IAAI,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CAAC,KAAa,EAAE,eAAuB;IAC7E,MAAM,SAAS,GAAG,yBAAyB,CAAC,eAAe,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAClD,CAAC"}

package/dist/session-resolver.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Resolve session ID from Cursor hook invocation context.
+ *
+ * Cursor does NOT provide a native session_id in stdin payloads,
+ * giving it 'derived' sessionIdQuality in the capability model.
+ * The session ID is derived from workspace/cwd as a stable hash.
+ *
+ * Resolution precedence (per spec 9.2):
+ *   1. Explicit AGENT_SESSION_ID env var
+ *   2. CURSOR_SESSION_ID env var (Cursor-specific, if ever provided)
+ *   3. Derived from workspace or cwd via stable hash
+ *   4. null (no session available)
+ */
+export interface SessionResolutionResult {
+    sessionId: string | null;
+    source: 'explicit_env' | 'cursor_env' | 'derived' | 'none';
+    /** Whether the ID was derived (hashed) rather than provided natively. */
+    isDerived: boolean;
+}
+/**
+ * Resolve the session ID for a Cursor hook invocation.
+ *
+ * @param stdinPayload - Parsed stdin JSON payload from Cursor
+ * @param env - Environment variables at invocation time
+ */
+export declare function resolveSessionId(stdinPayload: Record<string, unknown>, env?: Record<string, string>): SessionResolutionResult;
+/**
+ * Derive a stable session ID from a workspace or directory path.
+ * Uses a truncated SHA-256 hash prefixed with 'cursor-' for identifiability.
+ */
+export declare function deriveSessionId(path: string): string;
+/**
+ * Validate that a session ID looks reasonable.
+ */
+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":"AAEA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3D,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,uBAAuB,CA6BzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/session-resolver.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = resolveSessionId;
+exports.deriveSessionId = deriveSessionId;
+exports.isValidSessionId = isValidSessionId;
+const crypto_1 = require("crypto");
+/**
+ * Resolve the session ID for a Cursor hook invocation.
+ *
+ * @param stdinPayload - Parsed stdin JSON payload from Cursor
+ * @param env - Environment variables at invocation time
+ */
+function resolveSessionId(stdinPayload, env = {}) {
+    // Priority 1: explicit env override
+    const explicit = env['AGENT_SESSION_ID'];
+    if (typeof explicit === 'string' && explicit.length > 0) {
+        return { sessionId: explicit, source: 'explicit_env', isDerived: false };
+    }
+    // Priority 2: Cursor-specific env var (if Cursor ever adds one)
+    const cursorEnv = env['CURSOR_SESSION_ID'];
+    if (typeof cursorEnv === 'string' && cursorEnv.length > 0) {
+        return { sessionId: cursorEnv, source: 'cursor_env', isDerived: false };
+    }
+    // Priority 3: derive from workspace or cwd
+    const workspace = typeof stdinPayload['workspace'] === 'string'
+        ? stdinPayload['workspace']
+        : undefined;
+    const cwd = typeof stdinPayload['cwd'] === 'string'
+        ? stdinPayload['cwd']
+        : env['PWD'] ?? env['HOMEDRIVE'] ?? undefined;
+    const derivationSource = workspace ?? cwd;
+    if (derivationSource) {
+        const derived = deriveSessionId(derivationSource);
+        return { sessionId: derived, source: 'derived', isDerived: true };
+    }
+    // Priority 4: no session
+    return { sessionId: null, source: 'none', isDerived: false };
+}
+/**
+ * Derive a stable session ID from a workspace or directory path.
+ * Uses a truncated SHA-256 hash prefixed with 'cursor-' for identifiability.
+ */
+function deriveSessionId(path) {
+    const hash = (0, crypto_1.createHash)('sha256').update(path).digest('hex').slice(0, 16);
+    return `cursor-${hash}`;
+}
+/**
+ * Validate that a session ID looks reasonable.
+ */
+function isValidSessionId(sessionId) {
+    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":";;AA6BA,4CAgCC;AAMD,0CAGC;AAKD,4CAEC;AA7ED,mCAAoC;AAuBpC;;;;;GAKG;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,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC3E,CAAC;IAED,gEAAgE;IAChE,MAAM,SAAS,GAAG,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC3C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC1E,CAAC;IAED,2CAA2C;IAC3C,MAAM,SAAS,GAAG,OAAO,YAAY,CAAC,WAAW,CAAC,KAAK,QAAQ;QAC7D,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC;QAC3B,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,GAAG,GAAG,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,QAAQ;QACjD,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;QACrB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC;IAEhD,MAAM,gBAAgB,GAAG,SAAS,IAAI,GAAG,CAAC;IAC1C,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;QAClD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACpE,CAAC;IAED,yBAAyB;IACzB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,UAAU,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,SAAiB;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-cursor",
+  "version": "5.0.1-staging.00fa5317c",
+  "description": "Cursor 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-cursor"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/packages/hooks-mux/adapter-cursor#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"
+  }
+}