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

package/dist/adapter.d.ts

@@ -0,0 +1,25 @@
+import type { AdapterCapabilities } from '@a5c-ai/hooks-mux-core';
+/**
+ * Creates the OpenClaw adapter capability descriptor.
+ *
+ * OpenClaw is a library-first (in-process) harness that exposes two distinct
+ * hook layers:
+ *
+ *   1. **Gateway hooks** — internal lifecycle events fired by the OpenClaw
+ *      gateway/router (e.g. request routing, auth, rate-limiting). These are
+ *      infrastructure-level and do NOT map to canonical agent-lifecycle phases.
+ *
+ *   2. **Plugin hooks** — lifecycle events fired by OpenClaw plugins that
+ *      participate in the agent conversation loop (session, tool, turn).
+ *      These map cleanly to canonical phases.
+ *
+ * The adapter preserves this distinction by tagging normalized events with
+ * an `origin` field ('gateway' | 'plugin') in execution metadata, and by
+ * mapping only plugin hooks to canonical phases. Gateway hooks are mapped
+ * to scope 'gateway' with supportLevel 'lossy' to signal they are not
+ * semantically equivalent to agent-lifecycle phases.
+ *
+ * Spec section 17.9.
+ */
+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;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAqBnD"}

package/dist/adapter.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+/**
+ * Creates the OpenClaw adapter capability descriptor.
+ *
+ * OpenClaw is a library-first (in-process) harness that exposes two distinct
+ * hook layers:
+ *
+ *   1. **Gateway hooks** — internal lifecycle events fired by the OpenClaw
+ *      gateway/router (e.g. request routing, auth, rate-limiting). These are
+ *      infrastructure-level and do NOT map to canonical agent-lifecycle phases.
+ *
+ *   2. **Plugin hooks** — lifecycle events fired by OpenClaw plugins that
+ *      participate in the agent conversation loop (session, tool, turn).
+ *      These map cleanly to canonical phases.
+ *
+ * The adapter preserves this distinction by tagging normalized events with
+ * an `origin` field ('gateway' | 'plugin') in execution metadata, and by
+ * mapping only plugin hooks to canonical phases. Gateway hooks are mapped
+ * to scope 'gateway' with supportLevel 'lossy' to signal they are not
+ * semantically equivalent to agent-lifecycle phases.
+ *
+ * Spec section 17.9.
+ */
+function createAdapter() {
+    return {
+        name: 'openclaw',
+        family: 'in-process',
+        sessionIdQuality: 'derived',
+        supportsOrderedFanout: true,
+        supportsNativeAdditionalContext: false,
+        supportsBlock: true,
+        supportsAsk: false,
+        supportsToolInputMutation: true,
+        supportsToolResultMutation: false,
+        supportsPersistedEnv: false,
+        envPersistenceMode: 'runtime_hook',
+        toolInterceptionScope: 'all',
+        notes: [
+            'Gateway hooks (request.received, request.routed, request.completed, auth.check) are infrastructure-level; do not treat as agent lifecycle',
+            'Plugin hooks (plugin.session.start, plugin.session.end, plugin.tool.before, plugin.tool.after, plugin.turn.stop) map to canonical phases',
+            'Session ID derived from plugin context or gateway request correlation ID',
+            'Library-first: designed for in-process integration, not shell subprocess invocation',
+        ],
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":";;AAwBA,sCAqBC;AA3CD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,YAAY;QACpB,gBAAgB,EAAE,SAAS;QAC3B,qBAAqB,EAAE,IAAI;QAC3B,+BAA+B,EAAE,KAAK;QACtC,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,yBAAyB,EAAE,IAAI;QAC/B,0BAA0B,EAAE,KAAK;QACjC,oBAAoB,EAAE,KAAK;QAC3B,kBAAkB,EAAE,cAAc;QAClC,qBAAqB,EAAE,KAAK;QAC5B,KAAK,EAAE;YACL,2IAA2I;YAC3I,0IAA0I;YAC1I,0EAA0E;YAC1E,qFAAqF;SACtF;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createAdapter } from './adapter';
+export { OPENCLAW_PHASE_MAPPINGS, OPENCLAW_PLUGIN_MAPPINGS, OPENCLAW_GATEWAY_MAPPINGS, getOpenClawPhaseMapping, getSupportedPhases, getSupportedPluginPhases, classifyHookOrigin, } from './mappings';
+export { createConfiguredEngine } from './integration';
+export type { OpenClawHookOrigin } from './mappings';
+export { normalizeOpenClaw, parseEventData, buildExecutionContext, buildPayload, } from './normalizer';
+export type { OpenClawEventBase, OpenClawPluginSessionStartPayload, OpenClawPluginToolPayload, OpenClawPluginTurnStopPayload, OpenClawGatewayPayload, } from './normalizer';
+export { renderOpenClawOutput } from './renderer';
+export type { OpenClawToolBeforeOutput, OpenClawToolAfterOutput, OpenClawTurnStopOutput, OpenClawSessionStartOutput, OpenClawGatewayAuthOutput, OpenClawGenericOutput, } from './renderer';
+export { resolveSessionId } from './session-resolver';
+export type { SessionResolutionResult } from './session-resolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,iBAAiB,EACjB,iCAAiC,EACjC,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = exports.renderOpenClawOutput = exports.buildPayload = exports.buildExecutionContext = exports.parseEventData = exports.normalizeOpenClaw = exports.createConfiguredEngine = exports.classifyHookOrigin = exports.getSupportedPluginPhases = exports.getSupportedPhases = exports.getOpenClawPhaseMapping = exports.OPENCLAW_GATEWAY_MAPPINGS = exports.OPENCLAW_PLUGIN_MAPPINGS = exports.OPENCLAW_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, "OPENCLAW_PHASE_MAPPINGS", { enumerable: true, get: function () { return mappings_1.OPENCLAW_PHASE_MAPPINGS; } });
+Object.defineProperty(exports, "OPENCLAW_PLUGIN_MAPPINGS", { enumerable: true, get: function () { return mappings_1.OPENCLAW_PLUGIN_MAPPINGS; } });
+Object.defineProperty(exports, "OPENCLAW_GATEWAY_MAPPINGS", { enumerable: true, get: function () { return mappings_1.OPENCLAW_GATEWAY_MAPPINGS; } });
+Object.defineProperty(exports, "getOpenClawPhaseMapping", { enumerable: true, get: function () { return mappings_1.getOpenClawPhaseMapping; } });
+Object.defineProperty(exports, "getSupportedPhases", { enumerable: true, get: function () { return mappings_1.getSupportedPhases; } });
+Object.defineProperty(exports, "getSupportedPluginPhases", { enumerable: true, get: function () { return mappings_1.getSupportedPluginPhases; } });
+Object.defineProperty(exports, "classifyHookOrigin", { enumerable: true, get: function () { return mappings_1.classifyHookOrigin; } });
+var integration_1 = require("./integration");
+Object.defineProperty(exports, "createConfiguredEngine", { enumerable: true, get: function () { return integration_1.createConfiguredEngine; } });
+var normalizer_1 = require("./normalizer");
+Object.defineProperty(exports, "normalizeOpenClaw", { enumerable: true, get: function () { return normalizer_1.normalizeOpenClaw; } });
+Object.defineProperty(exports, "parseEventData", { enumerable: true, get: function () { return normalizer_1.parseEventData; } });
+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, "renderOpenClawOutput", { enumerable: true, get: function () { return renderer_1.renderOpenClawOutput; } });
+var session_resolver_1 = require("./session-resolver");
+Object.defineProperty(exports, "resolveSessionId", { enumerable: true, get: function () { return session_resolver_1.resolveSessionId; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,uCAQoB;AAPlB,mHAAA,uBAAuB,OAAA;AACvB,oHAAA,wBAAwB,OAAA;AACxB,qHAAA,yBAAyB,OAAA;AACzB,mHAAA,uBAAuB,OAAA;AACvB,8GAAA,kBAAkB,OAAA;AAClB,oHAAA,wBAAwB,OAAA;AACxB,8GAAA,kBAAkB,OAAA;AAEpB,6CAAuD;AAA9C,qHAAA,sBAAsB,OAAA;AAE/B,2CAKsB;AAJpB,+GAAA,iBAAiB,OAAA;AACjB,4GAAA,cAAc,OAAA;AACd,mHAAA,qBAAqB,OAAA;AACrB,0GAAA,YAAY,OAAA;AASd,uCAAkD;AAAzC,gHAAA,oBAAoB,OAAA;AAS7B,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/integration.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Programmatic engine integration for the OpenClaw adapter.
+ *
+ * Creates a pre-configured HooksEngine wired to the OpenClaw adapter's
+ * capabilities and phase mappings, ready for in-process hook execution.
+ *
+ * OpenClaw has a dual-layer hook system (gateway + plugin). The configured
+ * engine includes both mapping sets so that plugin hooks map to canonical
+ * phases and gateway hooks are available for observability.
+ *
+ * Usage:
+ * ```typescript
+ * import { createConfiguredEngine } from '@a5c-ai/hooks-mux-adapter-openclaw';
+ *
+ * const engine = createConfiguredEngine();
+ *
+ * engine.registerHandler({
+ *   id: 'my-handler',
+ *   pluginId: 'my-plugin',
+ *   phase: 'tool.before',
+ *   priority: 10,
+ *   handler: async (event) => ({
+ *     decision: 'allow',
+ *   }),
+ * });
+ *
+ * const result = await engine.processEvent({
+ *   nativeEventName: 'plugin.tool.before',
+ *   payload: { toolName: 'Bash' },
+ * });
+ * ```
+ */
+import { type HooksEngine } from '@a5c-ai/hooks-mux-core';
+/**
+ * Create a pre-configured hooks engine for the OpenClaw adapter.
+ * Ready to register handlers and process events.
+ */
+export declare function createConfiguredEngine(options?: {
+    sessionDir?: string;
+}): HooksEngine;
+//# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI7E;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAOrF"}

package/dist/integration.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Programmatic engine integration for the OpenClaw adapter.
+ *
+ * Creates a pre-configured HooksEngine wired to the OpenClaw adapter's
+ * capabilities and phase mappings, ready for in-process hook execution.
+ *
+ * OpenClaw has a dual-layer hook system (gateway + plugin). The configured
+ * engine includes both mapping sets so that plugin hooks map to canonical
+ * phases and gateway hooks are available for observability.
+ *
+ * Usage:
+ * ```typescript
+ * import { createConfiguredEngine } from '@a5c-ai/hooks-mux-adapter-openclaw';
+ *
+ * const engine = createConfiguredEngine();
+ *
+ * engine.registerHandler({
+ *   id: 'my-handler',
+ *   pluginId: 'my-plugin',
+ *   phase: 'tool.before',
+ *   priority: 10,
+ *   handler: async (event) => ({
+ *     decision: 'allow',
+ *   }),
+ * });
+ *
+ * const result = await engine.processEvent({
+ *   nativeEventName: 'plugin.tool.before',
+ *   payload: { toolName: 'Bash' },
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfiguredEngine = createConfiguredEngine;
+const hooks_mux_core_1 = require("@a5c-ai/hooks-mux-core");
+const adapter_1 = require("./adapter");
+const mappings_1 = require("./mappings");
+/**
+ * Create a pre-configured hooks engine for the OpenClaw adapter.
+ * Ready to register handlers and process events.
+ */
+function createConfiguredEngine(options) {
+    return (0, hooks_mux_core_1.createHooksEngine)({
+        adapter: 'openclaw',
+        capabilities: (0, adapter_1.createAdapter)(),
+        phaseMappings: mappings_1.OPENCLAW_PHASE_MAPPINGS,
+        sessionDir: options?.sessionDir,
+    });
+}
+//# sourceMappingURL=integration.js.map

package/dist/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;AAUH,wDAOC;AAfD,2DAA6E;AAC7E,uCAA0C;AAC1C,yCAAqD;AAErD;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,OAAiC;IACtE,OAAO,IAAA,kCAAiB,EAAC;QACvB,OAAO,EAAE,UAAU;QACnB,YAAY,EAAE,IAAA,uBAAa,GAAE;QAC7B,aAAa,EAAE,kCAAuB;QACtC,UAAU,EAAE,OAAO,EAAE,UAAU;KAChC,CAAC,CAAC;AACL,CAAC"}

package/dist/mappings.d.ts

@@ -0,0 +1,42 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-mux-core';
+/**
+ * OpenClaw hook origin type.
+ *
+ * Gateway hooks are infrastructure-level (request routing, auth, rate-limiting).
+ * Plugin hooks are agent-lifecycle (session, tool, turn).
+ */
+export type OpenClawHookOrigin = 'gateway' | 'plugin';
+/**
+ * OpenClaw native event to canonical phase mappings.
+ *
+ * KEY DESIGN DECISION: Gateway hooks and plugin hooks are mapped separately.
+ * Gateway hooks use scope 'gateway' and supportLevel 'lossy' because they
+ * are NOT semantically equivalent to agent-lifecycle phases. Plugin hooks
+ * use standard scopes and 'native' support level.
+ *
+ * Spec section 8.2 / 17.9.
+ */
+export declare const OPENCLAW_PLUGIN_MAPPINGS: PhaseMapping[];
+export declare const OPENCLAW_GATEWAY_MAPPINGS: PhaseMapping[];
+/**
+ * All OpenClaw phase mappings (plugin + gateway).
+ */
+export declare const OPENCLAW_PHASE_MAPPINGS: PhaseMapping[];
+/**
+ * Determine the origin of an OpenClaw native event.
+ */
+export declare function classifyHookOrigin(nativeEventName: string): OpenClawHookOrigin;
+/**
+ * Look up the phase mapping for a given OpenClaw native event name.
+ * Searches plugin mappings first (preferred), then gateway mappings.
+ */
+export declare function getOpenClawPhaseMapping(nativeEventName: string): PhaseMapping | undefined;
+/**
+ * Get all canonical phases supported by plugin hooks (the true agent-lifecycle mappings).
+ */
+export declare function getSupportedPluginPhases(): string[];
+/**
+ * Get all canonical phases across both plugin and gateway mappings.
+ */
+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;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtD;;;;;;;;;GASG;AAMH,eAAO,MAAM,wBAAwB,EAAE,YAAY,EAuDlD,CAAC;AAMF,eAAO,MAAM,yBAAyB,EAAE,YAAY,EA4CnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,YAAY,EAGjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,kBAAkB,CAK9E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAMzF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/mappings.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPENCLAW_PHASE_MAPPINGS = exports.OPENCLAW_GATEWAY_MAPPINGS = exports.OPENCLAW_PLUGIN_MAPPINGS = void 0;
+exports.classifyHookOrigin = classifyHookOrigin;
+exports.getOpenClawPhaseMapping = getOpenClawPhaseMapping;
+exports.getSupportedPluginPhases = getSupportedPluginPhases;
+exports.getSupportedPhases = getSupportedPhases;
+/**
+ * OpenClaw native event to canonical phase mappings.
+ *
+ * KEY DESIGN DECISION: Gateway hooks and plugin hooks are mapped separately.
+ * Gateway hooks use scope 'gateway' and supportLevel 'lossy' because they
+ * are NOT semantically equivalent to agent-lifecycle phases. Plugin hooks
+ * use standard scopes and 'native' support level.
+ *
+ * Spec section 8.2 / 17.9.
+ */
+// ---------------------------------------------------------------------------
+// Plugin hooks — these map to canonical agent-lifecycle phases
+// ---------------------------------------------------------------------------
+exports.OPENCLAW_PLUGIN_MAPPINGS = [
+    {
+        canonicalPhase: 'session.start',
+        nativeHook: 'plugin.session.start',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'Fires when a plugin session begins within OpenClaw.',
+    },
+    {
+        canonicalPhase: 'session.end',
+        nativeHook: 'plugin.session.end',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'Observer-only; fires when a plugin session is torn down.',
+    },
+    {
+        canonicalPhase: 'tool.before',
+        nativeHook: 'plugin.tool.before',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: true,
+        scope: 'tool',
+        notes: 'Fires before tool execution in plugin context. Can block or mutate tool input.',
+    },
+    {
+        canonicalPhase: 'tool.after',
+        nativeHook: 'plugin.tool.after',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'tool',
+        notes: 'Observer-only post-tool hook in plugin context.',
+    },
+    {
+        canonicalPhase: 'turn.stop',
+        nativeHook: 'plugin.turn.stop',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'turn',
+        notes: 'Fires when plugin turn completes. Can continue or stop.',
+    },
+    {
+        canonicalPhase: 'turn.user_prompt_submitted',
+        nativeHook: 'plugin.prompt.submitted',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'turn',
+        notes: 'Fires when user submits a prompt through the plugin.',
+    },
+];
+// ---------------------------------------------------------------------------
+// Gateway hooks — infrastructure-level, NOT agent-lifecycle equivalents
+// ---------------------------------------------------------------------------
+exports.OPENCLAW_GATEWAY_MAPPINGS = [
+    {
+        canonicalPhase: 'session.start',
+        nativeHook: 'gateway.request.received',
+        supportLevel: 'lossy',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'gateway',
+        notes: 'Gateway request receipt is NOT equivalent to session.start. ' +
+            'Mapped with lossy fidelity for observability only.',
+    },
+    {
+        canonicalPhase: 'session.start',
+        nativeHook: 'gateway.request.routed',
+        supportLevel: 'lossy',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'gateway',
+        notes: 'Gateway routing decision. Infrastructure-level, not an agent session start.',
+    },
+    {
+        canonicalPhase: 'session.end',
+        nativeHook: 'gateway.request.completed',
+        supportLevel: 'lossy',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'gateway',
+        notes: 'Gateway request completion is NOT equivalent to session.end. ' +
+            'Mapped with lossy fidelity for observability only.',
+    },
+    {
+        canonicalPhase: 'tool.permission_request',
+        nativeHook: 'gateway.auth.check',
+        supportLevel: 'lossy',
+        blockCapability: true,
+        mutationCapability: false,
+        scope: 'gateway',
+        notes: 'Gateway auth check loosely maps to tool permission but is infrastructure-level. ' +
+            'Do not treat as an agent-level permission gate.',
+    },
+];
+/**
+ * All OpenClaw phase mappings (plugin + gateway).
+ */
+exports.OPENCLAW_PHASE_MAPPINGS = [
+    ...exports.OPENCLAW_PLUGIN_MAPPINGS,
+    ...exports.OPENCLAW_GATEWAY_MAPPINGS,
+];
+/**
+ * Determine the origin of an OpenClaw native event.
+ */
+function classifyHookOrigin(nativeEventName) {
+    if (nativeEventName.startsWith('gateway.')) {
+        return 'gateway';
+    }
+    return 'plugin';
+}
+/**
+ * Look up the phase mapping for a given OpenClaw native event name.
+ * Searches plugin mappings first (preferred), then gateway mappings.
+ */
+function getOpenClawPhaseMapping(nativeEventName) {
+    // Plugin mappings take priority
+    const pluginMatch = exports.OPENCLAW_PLUGIN_MAPPINGS.find((m) => m.nativeHook === nativeEventName);
+    if (pluginMatch)
+        return pluginMatch;
+    return exports.OPENCLAW_GATEWAY_MAPPINGS.find((m) => m.nativeHook === nativeEventName);
+}
+/**
+ * Get all canonical phases supported by plugin hooks (the true agent-lifecycle mappings).
+ */
+function getSupportedPluginPhases() {
+    return exports.OPENCLAW_PLUGIN_MAPPINGS.map((m) => m.canonicalPhase);
+}
+/**
+ * Get all canonical phases across both plugin and gateway mappings.
+ */
+function getSupportedPhases() {
+    return exports.OPENCLAW_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":";;;AA+IA,gDAKC;AAMD,0DAMC;AAKD,4DAEC;AAKD,gDAEC;AApKD;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAEjE,QAAA,wBAAwB,GAAmB;IACtD;QACE,cAAc,EAAE,eAAe;QAC/B,UAAU,EAAE,sBAAsB;QAClC,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,qDAAqD;KAC7D;IACD;QACE,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,oBAAoB;QAChC,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,0DAA0D;KAClE;IACD;QACE,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,oBAAoB;QAChC,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,IAAI;QACxB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,gFAAgF;KACxF;IACD;QACE,cAAc,EAAE,YAAY;QAC5B,UAAU,EAAE,mBAAmB;QAC/B,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,iDAAiD;KACzD;IACD;QACE,cAAc,EAAE,WAAW;QAC3B,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,yDAAyD;KACjE;IACD;QACE,cAAc,EAAE,4BAA4B;QAC5C,UAAU,EAAE,yBAAyB;QACrC,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,sDAAsD;KAC9D;CACF,CAAC;AAEF,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAEjE,QAAA,yBAAyB,GAAmB;IACvD;QACE,cAAc,EAAE,eAAe;QAC/B,UAAU,EAAE,0BAA0B;QACtC,YAAY,EAAE,OAAO;QACrB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EACH,8DAA8D;YAC9D,oDAAoD;KACvD;IACD;QACE,cAAc,EAAE,eAAe;QAC/B,UAAU,EAAE,wBAAwB;QACpC,YAAY,EAAE,OAAO;QACrB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EACH,6EAA6E;KAChF;IACD;QACE,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,2BAA2B;QACvC,YAAY,EAAE,OAAO;QACrB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EACH,+DAA+D;YAC/D,oDAAoD;KACvD;IACD;QACE,cAAc,EAAE,yBAAyB;QACzC,UAAU,EAAE,oBAAoB;QAChC,YAAY,EAAE,OAAO;QACrB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EACH,kFAAkF;YAClF,iDAAiD;KACpD;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,uBAAuB,GAAmB;IACrD,GAAG,gCAAwB;IAC3B,GAAG,iCAAyB;CAC7B,CAAC;AAEF;;GAEG;AACH,SAAgB,kBAAkB,CAAC,eAAuB;IACxD,IAAI,eAAe,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,eAAuB;IAC7D,gCAAgC;IAChC,MAAM,WAAW,GAAG,gCAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,eAAe,CAAC,CAAC;IAC3F,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,OAAO,iCAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,eAAe,CAAC,CAAC;AACjF,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB;IACtC,OAAO,gCAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,+BAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;AAC9D,CAAC"}

package/dist/normalizer.d.ts

@@ -0,0 +1,78 @@
+import type { UnifiedHookEvent, UnifiedExecutionContext } from '@a5c-ai/hooks-mux-core';
+import type { OpenClawHookOrigin } from './mappings';
+/**
+ * OpenClaw in-process hook payload shapes.
+ *
+ * OpenClaw passes hook data as in-process objects (not stdin JSON),
+ * with fields varying by origin (gateway vs plugin) and event type.
+ */
+/** Common fields present across OpenClaw hook events. */
+export interface OpenClawEventBase {
+    /** Correlation ID from the gateway or plugin session. */
+    correlationId?: string;
+    /** Plugin-level session identifier. */
+    sessionId?: string;
+    /** Working directory or workspace path. */
+    workspace?: string;
+    /** Model identifier, if available. */
+    model?: string;
+    /** Timestamp of the event. */
+    timestamp?: string;
+    [key: string]: unknown;
+}
+/** Plugin session start payload. */
+export interface OpenClawPluginSessionStartPayload extends OpenClawEventBase {
+    source?: string;
+    initialPrompt?: string;
+    pluginId?: string;
+}
+/** Plugin tool before/after payload. */
+export interface OpenClawPluginToolPayload extends OpenClawEventBase {
+    toolName?: string;
+    toolCallId?: string;
+    toolInput?: unknown;
+    toolResponse?: unknown;
+    pluginId?: string;
+}
+/** Plugin turn stop payload. */
+export interface OpenClawPluginTurnStopPayload extends OpenClawEventBase {
+    reason?: string;
+    lastMessage?: string;
+    pluginId?: string;
+}
+/** Gateway request payload. */
+export interface OpenClawGatewayPayload extends OpenClawEventBase {
+    requestId?: string;
+    route?: string;
+    method?: string;
+    statusCode?: number;
+    authResult?: string;
+}
+/**
+ * Parse raw event input into a structured object.
+ * OpenClaw is in-process so payloads are typically already objects,
+ * but we handle string input for robustness.
+ */
+export declare function parseEventData(raw: unknown): Record<string, unknown>;
+/**
+ * Build a UnifiedExecutionContext from an OpenClaw event payload.
+ */
+export declare function buildExecutionContext(eventData: Record<string, unknown>, nativeEventName: string, origin: OpenClawHookOrigin, env: Record<string, string>): UnifiedExecutionContext;
+/**
+ * Build the payload portion of the unified event from OpenClaw event data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+export declare function buildPayload(nativeEventName: string, eventData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Normalize an OpenClaw hook invocation into a UnifiedHookEvent.
+ *
+ * Tags each event with its origin (gateway vs plugin) in execution metadata
+ * so downstream consumers can distinguish infrastructure-level hooks from
+ * agent-lifecycle hooks.
+ *
+ * @param nativeEventName - The OpenClaw event name (e.g. 'plugin.tool.before', 'gateway.request.received').
+ * @param rawData - Raw event data (object or string).
+ * @param env - Environment variables at invocation time.
+ */
+export declare function normalizeOpenClaw(nativeEventName: string, rawData: unknown, env?: Record<string, string>): UnifiedHookEvent;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAExF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;GAKG;AAEH,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,iCAAkC,SAAQ,iBAAiB;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gCAAgC;AAChC,MAAM,WAAW,6BAA8B,SAAQ,iBAAiB;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,uBAAuB,CA0CzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0EzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,OAAO,EAChB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,gBAAgB,CAoClB"}

package/dist/normalizer.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseEventData = parseEventData;
+exports.buildExecutionContext = buildExecutionContext;
+exports.buildPayload = buildPayload;
+exports.normalizeOpenClaw = normalizeOpenClaw;
+const mappings_1 = require("./mappings");
+/**
+ * Parse raw event input into a structured object.
+ * OpenClaw is in-process so payloads are typically already objects,
+ * but we handle string input for robustness.
+ */
+function parseEventData(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 an OpenClaw event payload.
+ */
+function buildExecutionContext(eventData, nativeEventName, origin, env) {
+    const persistedEnv = {};
+    const contextVars = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (key.startsWith('HOOKS_PROXY_PERSIST_')) {
+            persistedEnv[key] = value;
+        }
+    }
+    // Session ID: prefer plugin sessionId, fall back to gateway correlationId
+    const sessionId = eventData.sessionId ??
+        env['AGENT_SESSION_ID'] ??
+        eventData.correlationId ??
+        null;
+    return {
+        sessionId,
+        turnId: env['HOOKS_PROXY_TURN_ID'] ?? null,
+        conversationId: env['HOOKS_PROXY_CONVERSATION_ID'] ?? null,
+        adapter: 'openclaw',
+        cwd: eventData.workspace ?? env['PWD'] ?? null,
+        worktree: env['HOOKS_PROXY_WORKTREE'] ?? null,
+        transcriptPath: null,
+        source: eventData.source ?? null,
+        model: eventData.model ?? env['HOOKS_PROXY_MODEL'] ?? null,
+        agentType: null,
+        permissionMode: null,
+        toolName: eventData.toolName ?? null,
+        toolCallId: eventData.toolCallId ?? null,
+        nativeEventName,
+        rawEventScope: origin,
+        persistedEnv,
+        contextVars,
+        metadata: {
+            origin,
+            ...(eventData.pluginId != null ? { pluginId: eventData.pluginId } : {}),
+            ...(eventData.correlationId != null ? { correlationId: eventData.correlationId } : {}),
+            ...(eventData.requestId != null ? { requestId: eventData.requestId } : {}),
+        },
+    };
+}
+/**
+ * Build the payload portion of the unified event from OpenClaw event data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+function buildPayload(nativeEventName, eventData) {
+    const payload = {};
+    switch (nativeEventName) {
+        // --- Plugin hooks ---
+        case 'plugin.session.start':
+            if (eventData.source != null)
+                payload.source = eventData.source;
+            if (eventData.initialPrompt != null)
+                payload.initialPrompt = eventData.initialPrompt;
+            if (eventData.pluginId != null)
+                payload.pluginId = eventData.pluginId;
+            break;
+        case 'plugin.session.end':
+            if (eventData.pluginId != null)
+                payload.pluginId = eventData.pluginId;
+            break;
+        case 'plugin.tool.before':
+            if (eventData.toolName != null)
+                payload.toolName = eventData.toolName;
+            if (eventData.toolCallId != null)
+                payload.toolCallId = eventData.toolCallId;
+            if (eventData.toolInput != null)
+                payload.toolInput = eventData.toolInput;
+            if (eventData.pluginId != null)
+                payload.pluginId = eventData.pluginId;
+            break;
+        case 'plugin.tool.after':
+            if (eventData.toolName != null)
+                payload.toolName = eventData.toolName;
+            if (eventData.toolCallId != null)
+                payload.toolCallId = eventData.toolCallId;
+            if (eventData.toolInput != null)
+                payload.toolInput = eventData.toolInput;
+            if (eventData.toolResponse != null)
+                payload.toolResponse = eventData.toolResponse;
+            if (eventData.pluginId != null)
+                payload.pluginId = eventData.pluginId;
+            break;
+        case 'plugin.turn.stop':
+            if (eventData.reason != null)
+                payload.reason = eventData.reason;
+            if (eventData.lastMessage != null)
+                payload.lastMessage = eventData.lastMessage;
+            if (eventData.pluginId != null)
+                payload.pluginId = eventData.pluginId;
+            break;
+        case 'plugin.prompt.submitted':
+            if (eventData.prompt != null)
+                payload.prompt = eventData.prompt;
+            if (eventData.pluginId != null)
+                payload.pluginId = eventData.pluginId;
+            break;
+        // --- Gateway hooks ---
+        case 'gateway.request.received':
+            if (eventData.requestId != null)
+                payload.requestId = eventData.requestId;
+            if (eventData.route != null)
+                payload.route = eventData.route;
+            if (eventData.method != null)
+                payload.method = eventData.method;
+            break;
+        case 'gateway.request.routed':
+            if (eventData.requestId != null)
+                payload.requestId = eventData.requestId;
+            if (eventData.route != null)
+                payload.route = eventData.route;
+            break;
+        case 'gateway.request.completed':
+            if (eventData.requestId != null)
+                payload.requestId = eventData.requestId;
+            if (eventData.statusCode != null)
+                payload.statusCode = eventData.statusCode;
+            break;
+        case 'gateway.auth.check':
+            if (eventData.requestId != null)
+                payload.requestId = eventData.requestId;
+            if (eventData.authResult != null)
+                payload.authResult = eventData.authResult;
+            break;
+        default:
+            // Unknown event: pass through all non-common fields
+            for (const [key, value] of Object.entries(eventData)) {
+                if (!['correlationId', 'sessionId', 'workspace', 'model', 'timestamp'].includes(key)) {
+                    payload[key] = value;
+                }
+            }
+            break;
+    }
+    return payload;
+}
+/**
+ * Normalize an OpenClaw hook invocation into a UnifiedHookEvent.
+ *
+ * Tags each event with its origin (gateway vs plugin) in execution metadata
+ * so downstream consumers can distinguish infrastructure-level hooks from
+ * agent-lifecycle hooks.
+ *
+ * @param nativeEventName - The OpenClaw event name (e.g. 'plugin.tool.before', 'gateway.request.received').
+ * @param rawData - Raw event data (object or string).
+ * @param env - Environment variables at invocation time.
+ */
+function normalizeOpenClaw(nativeEventName, rawData, env = {}) {
+    const eventData = parseEventData(rawData);
+    const origin = (0, mappings_1.classifyHookOrigin)(nativeEventName);
+    const mapping = (0, mappings_1.getOpenClawPhaseMapping)(nativeEventName);
+    const phase = mapping?.canonicalPhase ?? 'unknown';
+    const supportLevel = mapping?.supportLevel ?? 'unsupported';
+    const execution = buildExecutionContext(eventData, nativeEventName, origin, env);
+    const payload = buildPayload(nativeEventName, eventData);
+    // 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: 'openclaw',
+        phase,
+        rawEventName: nativeEventName,
+        supportLevel,
+        execution,
+        payload,
+        env: {
+            input: inputEnv,
+            persisted: persistedEnv,
+        },
+        raw: rawData,
+    };
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.js","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":";;AA+DA,wCAmBC;AAKD,sDA+CC;AAMD,oCA6EC;AAaD,8CAwCC;AA7QD,yCAAyE;AAyDzE;;;;GAIG;AACH,SAAgB,cAAc,CAAC,GAAY;IACzC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5E,OAAO,MAAiC,CAAC;YAC3C,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,OAAO,GAA8B,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CACnC,SAAkC,EAClC,eAAuB,EACvB,MAA0B,EAC1B,GAA2B;IAE3B,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAC3C,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,MAAM,SAAS,GACZ,SAAS,CAAC,SAAgC;QAC3C,GAAG,CAAC,kBAAkB,CAAC;QACtB,SAAS,CAAC,aAAoC;QAC/C,IAAI,CAAC;IAEP,OAAO;QACL,SAAS;QACT,MAAM,EAAE,GAAG,CAAC,qBAAqB,CAAC,IAAI,IAAI;QAC1C,cAAc,EAAE,GAAG,CAAC,6BAA6B,CAAC,IAAI,IAAI;QAC1D,OAAO,EAAE,UAAU;QACnB,GAAG,EAAG,SAAS,CAAC,SAAgC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI;QACtE,QAAQ,EAAE,GAAG,CAAC,sBAAsB,CAAC,IAAI,IAAI;QAC7C,cAAc,EAAE,IAAI;QACpB,MAAM,EAAG,SAAS,CAAC,MAA6B,IAAI,IAAI;QACxD,KAAK,EAAG,SAAS,CAAC,KAA4B,IAAI,GAAG,CAAC,mBAAmB,CAAC,IAAI,IAAI;QAClF,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAG,SAAS,CAAC,QAA+B,IAAI,IAAI;QAC5D,UAAU,EAAG,SAAS,CAAC,UAAiC,IAAI,IAAI;QAChE,eAAe;QACf,aAAa,EAAE,MAAM;QACrB,YAAY;QACZ,WAAW;QACX,QAAQ,EAAE;YACR,MAAM;YACN,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,SAAS,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3E;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAC1B,eAAuB,EACvB,SAAkC;IAElC,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,QAAQ,eAAe,EAAE,CAAC;QACxB,uBAAuB;QACvB,KAAK,sBAAsB;YACzB,IAAI,SAAS,CAAC,MAAM,IAAI,IAAI;gBAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YAChE,IAAI,SAAS,CAAC,aAAa,IAAI,IAAI;gBAAE,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;YACrF,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI;gBAAE,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YACtE,MAAM;QAER,KAAK,oBAAoB;YACvB,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI;gBAAE,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YACtE,MAAM;QAER,KAAK,oBAAoB;YACvB,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI;gBAAE,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YACtE,IAAI,SAAS,CAAC,UAAU,IAAI,IAAI;gBAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;YAC5E,IAAI,SAAS,CAAC,SAAS,IAAI,IAAI;gBAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;YACzE,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI;gBAAE,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YACtE,MAAM;QAER,KAAK,mBAAmB;YACtB,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI;gBAAE,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YACtE,IAAI,SAAS,CAAC,UAAU,IAAI,IAAI;gBAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;YAC5E,IAAI,SAAS,CAAC,SAAS,IAAI,IAAI;gBAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;YACzE,IAAI,SAAS,CAAC,YAAY,IAAI,IAAI;gBAAE,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;YAClF,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI;gBAAE,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YACtE,MAAM;QAER,KAAK,kBAAkB;YACrB,IAAI,SAAS,CAAC,MAAM,IAAI,IAAI;gBAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YAChE,IAAI,SAAS,CAAC,WAAW,IAAI,IAAI;gBAAE,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;YAC/E,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI;gBAAE,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YACtE,MAAM;QAER,KAAK,yBAAyB;YAC5B,IAAI,SAAS,CAAC,MAAM,IAAI,IAAI;gBAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YAChE,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI;gBAAE,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YACtE,MAAM;QAER,wBAAwB;QACxB,KAAK,0BAA0B;YAC7B,IAAI,SAAS,CAAC,SAAS,IAAI,IAAI;gBAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;YACzE,IAAI,SAAS,CAAC,KAAK,IAAI,IAAI;gBAAE,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;YAC7D,IAAI,SAAS,CAAC,MAAM,IAAI,IAAI;gBAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YAChE,MAAM;QAER,KAAK,wBAAwB;YAC3B,IAAI,SAAS,CAAC,SAAS,IAAI,IAAI;gBAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;YACzE,IAAI,SAAS,CAAC,KAAK,IAAI,IAAI;gBAAE,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;YAC7D,MAAM;QAER,KAAK,2BAA2B;YAC9B,IAAI,SAAS,CAAC,SAAS,IAAI,IAAI;gBAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;YACzE,IAAI,SAAS,CAAC,UAAU,IAAI,IAAI;gBAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;YAC5E,MAAM;QAER,KAAK,oBAAoB;YACvB,IAAI,SAAS,CAAC,SAAS,IAAI,IAAI;gBAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;YACzE,IAAI,SAAS,CAAC,UAAU,IAAI,IAAI;gBAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;YAC5E,MAAM;QAER;YACE,oDAAoD;YACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrD,IAAI,CAAC,CAAC,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrF,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACvB,CAAC;YACH,CAAC;YACD,MAAM;IACV,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,iBAAiB,CAC/B,eAAuB,EACvB,OAAgB,EAChB,MAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAA,6BAAkB,EAAC,eAAe,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAA,kCAAuB,EAAC,eAAe,CAAC,CAAC;IAEzD,MAAM,KAAK,GAAG,OAAO,EAAE,cAAc,IAAI,SAAS,CAAC;IACnD,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,aAAa,CAAC;IAE5D,MAAM,SAAS,GAAG,qBAAqB,CAAC,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAEzD,6CAA6C;IAC7C,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAC3C,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAC1C,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,OAAO,EAAE,UAAU;QACnB,KAAK;QACL,YAAY,EAAE,eAAe;QAC7B,YAAY;QACZ,SAAS;QACT,OAAO;QACP,GAAG,EAAE;YACH,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,YAAY;SACxB;QACD,GAAG,EAAE,OAAO;KACb,CAAC;AACJ,CAAC"}

package/dist/renderer.d.ts

@@ -0,0 +1,45 @@
+import type { UnifiedHookResult } from '@a5c-ai/hooks-mux-core';
+/**
+ * OpenClaw native hook output formats.
+ *
+ * OpenClaw is in-process, so results are returned as structured objects
+ * rather than stdout JSON. The shape varies by event origin and type.
+ */
+/** Plugin tool.before output: permission/mutation decision. */
+export interface OpenClawToolBeforeOutput {
+    decision?: 'allow' | 'deny';
+    reason?: string;
+    toolInput?: unknown;
+}
+/** Plugin tool.after output. */
+export interface OpenClawToolAfterOutput {
+    metadata?: Record<string, unknown>;
+}
+/** Plugin turn.stop output. */
+export interface OpenClawTurnStopOutput {
+    continueSession?: boolean;
+    reason?: string;
+    followUpMessage?: string;
+}
+/** Plugin session.start output. */
+export interface OpenClawSessionStartOutput {
+    metadata?: Record<string, unknown>;
+}
+/** Gateway auth output. */
+export interface OpenClawGatewayAuthOutput {
+    allowed?: boolean;
+    reason?: string;
+}
+/** Generic output for unrecognized events. */
+export interface OpenClawGenericOutput {
+    [key: string]: unknown;
+}
+/**
+ * Render a UnifiedHookResult back to OpenClaw's native output format.
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original OpenClaw event name.
+ * @returns The native output object.
+ */
+export declare function renderOpenClawOutput(result: UnifiedHookResult, nativeEventName: string): Record<string, unknown>;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;GAKG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,gCAAgC;AAChC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,+BAA+B;AAC/B,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,mCAAmC;AACnC,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,2BAA2B;AAC3B,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB"}

package/dist/renderer.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderOpenClawOutput = renderOpenClawOutput;
+/**
+ * Render a UnifiedHookResult back to OpenClaw's native output format.
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original OpenClaw event name.
+ * @returns The native output object.
+ */
+function renderOpenClawOutput(result, nativeEventName) {
+    switch (nativeEventName) {
+        case 'plugin.tool.before':
+            return renderToolBeforeOutput(result);
+        case 'plugin.tool.after':
+            return renderToolAfterOutput(result);
+        case 'plugin.turn.stop':
+            return renderTurnStopOutput(result);
+        case 'plugin.session.start':
+            return renderSessionStartOutput(result);
+        case 'gateway.auth.check':
+            return renderGatewayAuthOutput(result);
+        default:
+            return renderGenericOutput(result);
+    }
+}
+function renderToolBeforeOutput(result) {
+    const output = {};
+    if (result.decision === 'allow') {
+        output['decision'] = 'allow';
+    }
+    else if (result.decision === 'deny') {
+        output['decision'] = 'deny';
+    }
+    // 'continue', 'noop', 'ask' → no decision field (OpenClaw defaults to allow)
+    if (result.reason != null) {
+        output['reason'] = result.reason;
+    }
+    // OpenClaw supports tool input mutation
+    if (result.toolMutation != null) {
+        output['toolInput'] = result.toolMutation.value;
+    }
+    return output;
+}
+function renderToolAfterOutput(result) {
+    const output = {};
+    if (result.metadata != null) {
+        output['metadata'] = result.metadata;
+    }
+    return output;
+}
+function renderTurnStopOutput(result) {
+    const output = {};
+    if (result.continueSession != null) {
+        output['continueSession'] = result.continueSession;
+    }
+    if (result.stopReason != null) {
+        output['reason'] = result.stopReason;
+    }
+    else if (result.reason != null) {
+        output['reason'] = result.reason;
+    }
+    if (result.followUpMessage != null) {
+        output['followUpMessage'] = result.followUpMessage;
+    }
+    return output;
+}
+function renderSessionStartOutput(result) {
+    const output = {};
+    if (result.metadata != null) {
+        output['metadata'] = result.metadata;
+    }
+    return output;
+}
+function renderGatewayAuthOutput(result) {
+    const output = {};
+    if (result.decision === 'allow') {
+        output['allowed'] = true;
+    }
+    else if (result.decision === 'deny') {
+        output['allowed'] = false;
+    }
+    if (result.reason != null) {
+        output['reason'] = result.reason;
+    }
+    return output;
+}
+function renderGenericOutput(result) {
+    const output = {};
+    if (result.metadata != null) {
+        output['metadata'] = result.metadata;
+    }
+    return output;
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

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

package/dist/session-resolver.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Session ID resolution for OpenClaw.
+ *
+ * OpenClaw provides session IDs through two channels:
+ *   - Plugin hooks: sessionId field in event data
+ *   - Gateway hooks: correlationId field (NOT a true session ID)
+ *
+ * Resolution quality is 'derived' because the session ID comes from
+ * plugin context rather than a native harness session mechanism.
+ *
+ * Resolution precedence (spec section 9.2):
+ *   1. Explicit CLI flag --session-id
+ *   2. Explicit env AGENT_SESSION_ID
+ *   3. Plugin sessionId from event data
+ *   4. Gateway correlationId as fallback (tagged as 'derived')
+ *   5. null
+ */
+export interface SessionResolutionResult {
+    sessionId: string | null;
+    source: 'explicit_flag' | 'explicit_env' | 'plugin' | 'gateway_correlation' | 'none';
+}
+/**
+ * Resolve the session ID for an OpenClaw hook invocation.
+ *
+ * @param eventData - Parsed event data from OpenClaw.
+ * @param env - Environment variables at invocation time.
+ * @param explicitSessionId - Session ID from explicit CLI flag, if any.
+ */
+export declare function resolveSessionId(eventData: Record<string, unknown>, env?: Record<string, string>, explicitSessionId?: string): SessionResolutionResult;
+//# sourceMappingURL=session-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.d.ts","sourceRoot":"","sources":["../src/session-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,eAAe,GAAG,cAAc,GAAG,QAAQ,GAAG,qBAAqB,GAAG,MAAM,CAAC;CACtF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAChC,iBAAiB,CAAC,EAAE,MAAM,GACzB,uBAAuB,CA0BzB"}

package/dist/session-resolver.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Session ID resolution for OpenClaw.
+ *
+ * OpenClaw provides session IDs through two channels:
+ *   - Plugin hooks: sessionId field in event data
+ *   - Gateway hooks: correlationId field (NOT a true session ID)
+ *
+ * Resolution quality is 'derived' because the session ID comes from
+ * plugin context rather than a native harness session mechanism.
+ *
+ * Resolution precedence (spec section 9.2):
+ *   1. Explicit CLI flag --session-id
+ *   2. Explicit env AGENT_SESSION_ID
+ *   3. Plugin sessionId from event data
+ *   4. Gateway correlationId as fallback (tagged as 'derived')
+ *   5. null
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = resolveSessionId;
+/**
+ * Resolve the session ID for an OpenClaw hook invocation.
+ *
+ * @param eventData - Parsed event data from OpenClaw.
+ * @param env - Environment variables at invocation time.
+ * @param explicitSessionId - Session ID from explicit CLI flag, if any.
+ */
+function resolveSessionId(eventData, env = {}, explicitSessionId) {
+    // 1. Explicit CLI flag
+    if (explicitSessionId) {
+        return { sessionId: explicitSessionId, source: 'explicit_flag' };
+    }
+    // 2. Explicit env
+    const envSessionId = env['AGENT_SESSION_ID'];
+    if (envSessionId) {
+        return { sessionId: envSessionId, source: 'explicit_env' };
+    }
+    // 3. Plugin sessionId
+    const pluginSessionId = eventData.sessionId;
+    if (typeof pluginSessionId === 'string' && pluginSessionId.length > 0) {
+        return { sessionId: pluginSessionId, source: 'plugin' };
+    }
+    // 4. Gateway correlationId as fallback
+    const correlationId = eventData.correlationId;
+    if (typeof correlationId === 'string' && correlationId.length > 0) {
+        return { sessionId: correlationId, source: 'gateway_correlation' };
+    }
+    // 5. No session ID available
+    return { sessionId: null, source: 'none' };
+}
+//# sourceMappingURL=session-resolver.js.map

package/dist/session-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.js","sourceRoot":"","sources":["../src/session-resolver.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAcH,4CA8BC;AArCD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,SAAkC,EAClC,MAA8B,EAAE,EAChC,iBAA0B;IAE1B,uBAAuB;IACvB,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACnE,CAAC;IAED,kBAAkB;IAClB,MAAM,YAAY,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC7C,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC7D,CAAC;IAED,sBAAsB;IACtB,MAAM,eAAe,GAAG,SAAS,CAAC,SAAS,CAAC;IAC5C,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED,uCAAuC;IACvC,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;IAC9C,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACrE,CAAC;IAED,6BAA6B;IAC7B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC"}

package/package.json

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