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

package/dist/adapter.d.ts

@@ -0,0 +1,12 @@
+import type { AdapterCapabilities } from '@a5c-ai/hooks-mux-core';
+/**
+ * Creates the Pi adapter capability descriptor.
+ *
+ * Pi is an in-process harness with native session IDs,
+ * extension-state persistence, and mutable tool input semantics
+ * (later handlers see earlier mutations).
+ *
+ * Spec section 17.6.
+ */
+export declare function createAdapter(): AdapterCapabilities;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAqBnD"}

package/dist/adapter.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+/**
+ * Creates the Pi adapter capability descriptor.
+ *
+ * Pi is an in-process harness with native session IDs,
+ * extension-state persistence, and mutable tool input semantics
+ * (later handlers see earlier mutations).
+ *
+ * Spec section 17.6.
+ */
+function createAdapter() {
+    return {
+        name: 'pi',
+        family: 'in-process',
+        sessionIdQuality: 'native',
+        supportsOrderedFanout: true,
+        supportsNativeAdditionalContext: false,
+        supportsBlock: true,
+        supportsAsk: false,
+        supportsToolInputMutation: true,
+        supportsToolResultMutation: false,
+        supportsPersistedEnv: true,
+        envPersistenceMode: 'runtime_hook',
+        toolInterceptionScope: 'all',
+        notes: [
+            'Library-only adapter — Pi hooks are in-process, not shell subprocesses',
+            'Tool input mutation is in-place; later handlers see earlier mutations',
+            'Session persistence via native extension-state; does not automatically enter model context',
+            'No stdin parsing required — input arrives as programmatic objects',
+        ],
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":";;AAWA,sCAqBC;AA9BD;;;;;;;;GAQG;AACH,SAAgB,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,YAAY;QACpB,gBAAgB,EAAE,QAAQ;QAC1B,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,IAAI;QAC1B,kBAAkB,EAAE,cAAc;QAClC,qBAAqB,EAAE,KAAK;QAC5B,KAAK,EAAE;YACL,wEAAwE;YACxE,uEAAuE;YACvE,4FAA4F;YAC5F,mEAAmE;SACpE;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { createAdapter } from './adapter';
+export { PI_PHASE_MAPPINGS, getPiPhaseMapping, getSupportedPhases } from './mappings';
+export { createConfiguredEngine } from './integration';
+export { normalizePi, coerceInput, buildExecutionContext, buildPayload } from './normalizer';
+export type { PiEventBase, PiSessionStartPayload, PiToolCallPayload, PiContextPayload, PiBeforeProviderRequestPayload, } from './normalizer';
+export { renderPiOutput, buildExtensionState } from './renderer';
+export type { PiToolCallOutput, PiSessionStartOutput, PiContextOutput, PiBeforeProviderRequestOutput, PiGenericOutput, } from './renderer';
+export { resolveSessionId } from './session-resolver';
+export type { SessionResolutionResult } from './session-resolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7F,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,8BAA8B,GAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,6BAA6B,EAC7B,eAAe,GAChB,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,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = exports.buildExtensionState = exports.renderPiOutput = exports.buildPayload = exports.buildExecutionContext = exports.coerceInput = exports.normalizePi = exports.createConfiguredEngine = exports.getSupportedPhases = exports.getPiPhaseMapping = exports.PI_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, "PI_PHASE_MAPPINGS", { enumerable: true, get: function () { return mappings_1.PI_PHASE_MAPPINGS; } });
+Object.defineProperty(exports, "getPiPhaseMapping", { enumerable: true, get: function () { return mappings_1.getPiPhaseMapping; } });
+Object.defineProperty(exports, "getSupportedPhases", { enumerable: true, get: function () { return mappings_1.getSupportedPhases; } });
+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, "normalizePi", { enumerable: true, get: function () { return normalizer_1.normalizePi; } });
+Object.defineProperty(exports, "coerceInput", { enumerable: true, get: function () { return normalizer_1.coerceInput; } });
+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, "renderPiOutput", { enumerable: true, get: function () { return renderer_1.renderPiOutput; } });
+Object.defineProperty(exports, "buildExtensionState", { enumerable: true, get: function () { return renderer_1.buildExtensionState; } });
+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,uCAAsF;AAA7E,6GAAA,iBAAiB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AACjE,6CAAuD;AAA9C,qHAAA,sBAAsB,OAAA;AAC/B,2CAA6F;AAApF,yGAAA,WAAW,OAAA;AAAE,yGAAA,WAAW,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAAE,0GAAA,YAAY,OAAA;AAQtE,uCAAiE;AAAxD,0GAAA,cAAc,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAQ5C,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/integration.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Programmatic engine integration for the Pi adapter.
+ *
+ * Creates a pre-configured HooksEngine wired to the Pi adapter's
+ * capabilities and phase mappings, ready for in-process hook execution.
+ *
+ * Usage:
+ * ```typescript
+ * import { createConfiguredEngine } from '@a5c-ai/hooks-mux-adapter-pi';
+ *
+ * const engine = createConfiguredEngine();
+ *
+ * engine.registerHandler({
+ *   id: 'my-handler',
+ *   pluginId: 'my-plugin',
+ *   phase: 'session.start',
+ *   priority: 10,
+ *   handler: async (event) => ({
+ *     persistEnv: { MY_PLUGIN_READY: '1' },
+ *   }),
+ * });
+ *
+ * // When Pi fires a session_start event:
+ * const result = await engine.processEvent({
+ *   nativeEventName: 'session_start',
+ *   payload: { sessionId: 'abc', cwd: '/project' },
+ * });
+ * ```
+ */
+import { type HooksEngine } from '@a5c-ai/hooks-mux-core';
+/**
+ * Create a pre-configured hooks engine for the Pi 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;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,48 @@
+"use strict";
+/**
+ * Programmatic engine integration for the Pi adapter.
+ *
+ * Creates a pre-configured HooksEngine wired to the Pi adapter's
+ * capabilities and phase mappings, ready for in-process hook execution.
+ *
+ * Usage:
+ * ```typescript
+ * import { createConfiguredEngine } from '@a5c-ai/hooks-mux-adapter-pi';
+ *
+ * const engine = createConfiguredEngine();
+ *
+ * engine.registerHandler({
+ *   id: 'my-handler',
+ *   pluginId: 'my-plugin',
+ *   phase: 'session.start',
+ *   priority: 10,
+ *   handler: async (event) => ({
+ *     persistEnv: { MY_PLUGIN_READY: '1' },
+ *   }),
+ * });
+ *
+ * // When Pi fires a session_start event:
+ * const result = await engine.processEvent({
+ *   nativeEventName: 'session_start',
+ *   payload: { sessionId: 'abc', cwd: '/project' },
+ * });
+ * ```
+ */
+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 Pi adapter.
+ * Ready to register handlers and process events.
+ */
+function createConfiguredEngine(options) {
+    return (0, hooks_mux_core_1.createHooksEngine)({
+        adapter: 'pi',
+        capabilities: (0, adapter_1.createAdapter)(),
+        phaseMappings: mappings_1.PI_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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;AAUH,wDAOC;AAfD,2DAA6E;AAC7E,uCAA0C;AAC1C,yCAA+C;AAE/C;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,OAAiC;IACtE,OAAO,IAAA,kCAAiB,EAAC;QACvB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAA,uBAAa,GAAE;QAC7B,aAAa,EAAE,4BAAiB;QAChC,UAAU,EAAE,OAAO,EAAE,UAAU;KAChC,CAAC,CAAC;AACL,CAAC"}

package/dist/mappings.d.ts

@@ -0,0 +1,19 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-mux-core';
+/**
+ * Pi native event name to canonical phase mappings.
+ *
+ * Pi extension events:
+ *   session_start, tool_call, context, before_provider_request
+ *
+ * Spec section 8.2 / 17.6.
+ */
+export declare const PI_PHASE_MAPPINGS: PhaseMapping[];
+/**
+ * Look up the phase mapping for a given Pi native event name.
+ */
+export declare function getPiPhaseMapping(nativeEventName: string): PhaseMapping | undefined;
+/**
+ * Get all canonical phases supported by the Pi adapter.
+ */
+export declare function getSupportedPhases(): string[];
+//# sourceMappingURL=mappings.d.ts.map

package/dist/mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.d.ts","sourceRoot":"","sources":["../src/mappings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAAY,EAqC3C,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEnF;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.PI_PHASE_MAPPINGS = void 0;
+exports.getPiPhaseMapping = getPiPhaseMapping;
+exports.getSupportedPhases = getSupportedPhases;
+/**
+ * Pi native event name to canonical phase mappings.
+ *
+ * Pi extension events:
+ *   session_start, tool_call, context, before_provider_request
+ *
+ * Spec section 8.2 / 17.6.
+ */
+exports.PI_PHASE_MAPPINGS = [
+    {
+        canonicalPhase: 'session.start',
+        nativeHook: 'session_start',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'session',
+        notes: 'Fires when a Pi session begins. Extension-state is available for persistence.',
+    },
+    {
+        canonicalPhase: 'tool.before',
+        nativeHook: 'tool_call',
+        supportLevel: 'native',
+        blockCapability: true,
+        mutationCapability: true,
+        scope: 'tool',
+        notes: 'Tool input mutation is in-place; later handlers see earlier mutations.',
+    },
+    {
+        canonicalPhase: 'turn.before_agent',
+        nativeHook: 'context',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'turn',
+        notes: 'Context injection point before the agent processes a turn.',
+    },
+    {
+        canonicalPhase: 'model.before_request',
+        nativeHook: 'before_provider_request',
+        supportLevel: 'native',
+        blockCapability: false,
+        mutationCapability: false,
+        scope: 'model',
+        notes: 'Fires before the provider (LLM) request is sent.',
+    },
+];
+/**
+ * Look up the phase mapping for a given Pi native event name.
+ */
+function getPiPhaseMapping(nativeEventName) {
+    return exports.PI_PHASE_MAPPINGS.find((m) => m.nativeHook === nativeEventName);
+}
+/**
+ * Get all canonical phases supported by the Pi adapter.
+ */
+function getSupportedPhases() {
+    return exports.PI_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":";;;AAoDA,8CAEC;AAKD,gDAEC;AA3DD;;;;;;;GAOG;AACU,QAAA,iBAAiB,GAAmB;IAC/C;QACE,cAAc,EAAE,eAAe;QAC/B,UAAU,EAAE,eAAe;QAC3B,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,+EAA+E;KACvF;IACD;QACE,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,WAAW;QACvB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,IAAI;QACrB,kBAAkB,EAAE,IAAI;QACxB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,wEAAwE;KAChF;IACD;QACE,cAAc,EAAE,mBAAmB;QACnC,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,4DAA4D;KACpE;IACD;QACE,cAAc,EAAE,sBAAsB;QACtC,UAAU,EAAE,yBAAyB;QACrC,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,kDAAkD;KAC1D;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,iBAAiB,CAAC,eAAuB;IACvD,OAAO,yBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,eAAe,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,yBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;AACxD,CAAC"}

package/dist/normalizer.d.ts

@@ -0,0 +1,64 @@
+import type { UnifiedHookEvent, UnifiedExecutionContext } from '@a5c-ai/hooks-mux-core';
+/**
+ * Pi programmatic event payload shapes.
+ *
+ * Pi passes hook input as in-process objects (not stdin),
+ * so no stdin parsing is needed.
+ */
+/** Common fields present across Pi hook events. */
+export interface PiEventBase {
+    sessionId?: string;
+    cwd?: string;
+    model?: string;
+    [key: string]: unknown;
+}
+/** session_start-specific fields. */
+export interface PiSessionStartPayload extends PiEventBase {
+    /** Initial prompt or message that started the session. */
+    initialPrompt?: string;
+}
+/** tool_call-specific fields. */
+export interface PiToolCallPayload extends PiEventBase {
+    toolName?: string;
+    toolCallId?: string;
+    /** Mutable tool input — later handlers see earlier mutations. */
+    toolInput?: unknown;
+}
+/** context-specific fields. */
+export interface PiContextPayload extends PiEventBase {
+    /** Context content to inject into the turn. */
+    contextContent?: string;
+}
+/** before_provider_request-specific fields. */
+export interface PiBeforeProviderRequestPayload extends PiEventBase {
+    /** The messages about to be sent to the provider. */
+    messages?: unknown[];
+    /** Provider configuration. */
+    providerConfig?: Record<string, unknown>;
+}
+/**
+ * Coerce raw input to a record. Pi input is always programmatic objects,
+ * but we handle edge cases defensively.
+ */
+export declare function coerceInput(raw: unknown): Record<string, unknown>;
+/**
+ * Build a UnifiedExecutionContext from a Pi event payload.
+ */
+export declare function buildExecutionContext(data: Record<string, unknown>, nativeEventName: string, extensionState?: Record<string, string>): UnifiedExecutionContext;
+/**
+ * Build the payload portion of the unified event from Pi event data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+export declare function buildPayload(nativeEventName: string, data: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Normalize a Pi hook invocation into a UnifiedHookEvent.
+ *
+ * Unlike shell-hook adapters, Pi events arrive as in-process objects.
+ * No stdin parsing is required.
+ *
+ * @param nativeEventName - The Pi event name (e.g. 'session_start', 'tool_call').
+ * @param rawInput - The programmatic event object from Pi.
+ * @param extensionState - Extension-state key-value pairs for session persistence.
+ */
+export declare function normalizePi(nativeEventName: string, rawInput: unknown, extensionState?: Record<string, string>): UnifiedHookEvent;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGxF;;;;;GAKG;AAEH,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qCAAqC;AACrC,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,+CAA+C;AAC/C,MAAM,WAAW,8BAA+B,SAAQ,WAAW;IACjE,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,eAAe,EAAE,MAAM,EACvB,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC1C,uBAAuB,CAmCzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,EACjB,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC1C,gBAAgB,CAmClB"}

package/dist/normalizer.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coerceInput = coerceInput;
+exports.buildExecutionContext = buildExecutionContext;
+exports.buildPayload = buildPayload;
+exports.normalizePi = normalizePi;
+const mappings_1 = require("./mappings");
+/**
+ * Coerce raw input to a record. Pi input is always programmatic objects,
+ * but we handle edge cases defensively.
+ */
+function coerceInput(raw) {
+    if (raw == null) {
+        return {};
+    }
+    if (typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    return { raw };
+}
+/**
+ * Build a UnifiedExecutionContext from a Pi event payload.
+ */
+function buildExecutionContext(data, nativeEventName, extensionState = {}) {
+    const persistedEnv = {};
+    const contextVars = {};
+    // Collect persisted state from extension-state
+    for (const [key, value] of Object.entries(extensionState)) {
+        if (key.startsWith('HOOKS_PROXY_PERSIST_')) {
+            persistedEnv[key] = value;
+        }
+    }
+    const sessionId = data.sessionId
+        ?? extensionState['AGENT_SESSION_ID']
+        ?? null;
+    return {
+        sessionId,
+        turnId: extensionState['HOOKS_PROXY_TURN_ID'] ?? null,
+        conversationId: extensionState['HOOKS_PROXY_CONVERSATION_ID'] ?? null,
+        adapter: 'pi',
+        cwd: data.cwd ?? null,
+        worktree: extensionState['HOOKS_PROXY_WORKTREE'] ?? null,
+        transcriptPath: null,
+        source: null,
+        model: data.model ?? extensionState['HOOKS_PROXY_MODEL'] ?? null,
+        agentType: null,
+        permissionMode: null,
+        toolName: data.toolName ?? null,
+        toolCallId: data.toolCallId ?? null,
+        nativeEventName,
+        rawEventScope: null,
+        persistedEnv,
+        contextVars,
+        metadata: {},
+    };
+}
+/**
+ * Build the payload portion of the unified event from Pi event data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+function buildPayload(nativeEventName, data) {
+    const payload = {};
+    switch (nativeEventName) {
+        case 'session_start':
+            if (data.initialPrompt != null)
+                payload.initialPrompt = data.initialPrompt;
+            break;
+        case 'tool_call':
+            if (data.toolName != null)
+                payload.toolName = data.toolName;
+            if (data.toolCallId != null)
+                payload.toolCallId = data.toolCallId;
+            if (data.toolInput != null)
+                payload.toolInput = data.toolInput;
+            break;
+        case 'context':
+            if (data.contextContent != null)
+                payload.contextContent = data.contextContent;
+            break;
+        case 'before_provider_request':
+            if (data.messages != null)
+                payload.messages = data.messages;
+            if (data.providerConfig != null)
+                payload.providerConfig = data.providerConfig;
+            break;
+        default:
+            // Unknown event: pass through all non-common fields
+            for (const [key, value] of Object.entries(data)) {
+                if (!['sessionId', 'cwd', 'model'].includes(key)) {
+                    payload[key] = value;
+                }
+            }
+            break;
+    }
+    return payload;
+}
+/**
+ * Normalize a Pi hook invocation into a UnifiedHookEvent.
+ *
+ * Unlike shell-hook adapters, Pi events arrive as in-process objects.
+ * No stdin parsing is required.
+ *
+ * @param nativeEventName - The Pi event name (e.g. 'session_start', 'tool_call').
+ * @param rawInput - The programmatic event object from Pi.
+ * @param extensionState - Extension-state key-value pairs for session persistence.
+ */
+function normalizePi(nativeEventName, rawInput, extensionState = {}) {
+    const data = coerceInput(rawInput);
+    const mapping = (0, mappings_1.getPiPhaseMapping)(nativeEventName);
+    const phase = mapping?.canonicalPhase ?? 'unknown';
+    const supportLevel = mapping?.supportLevel ?? 'unsupported';
+    const execution = buildExecutionContext(data, nativeEventName, extensionState);
+    const payload = buildPayload(nativeEventName, data);
+    // Split extension-state into input and persisted buckets
+    const inputEnv = {};
+    const persistedEnv = {};
+    for (const [key, value] of Object.entries(extensionState)) {
+        if (key.startsWith('HOOKS_PROXY_PERSIST_')) {
+            persistedEnv[key] = value;
+        }
+        else if (key.startsWith('HOOKS_PROXY_')) {
+            inputEnv[key] = value;
+        }
+    }
+    return {
+        version: 'a5c.hooks.v1',
+        adapter: 'pi',
+        phase,
+        rawEventName: nativeEventName,
+        supportLevel,
+        execution,
+        payload,
+        env: {
+            input: inputEnv,
+            persisted: persistedEnv,
+        },
+        raw: rawInput,
+    };
+}
+//# 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,55 @@
+import type { UnifiedHookResult } from '@a5c-ai/hooks-mux-core';
+/**
+ * Pi native hook output formats.
+ *
+ * Pi hooks communicate results as in-process return objects.
+ * The shape depends on the event type.
+ */
+/** tool_call hook output: permission decision and optional tool input mutation. */
+export interface PiToolCallOutput {
+    decision?: 'allow' | 'deny';
+    reason?: string;
+    /** Mutated tool input — Pi supports in-place mutation. */
+    toolInput?: unknown;
+}
+/** session_start hook output. */
+export interface PiSessionStartOutput {
+    /** Additional context to inject (not native — must be handled by the hook layer). */
+    additionalContext?: string;
+    /** State to persist via extension-state. */
+    persistState?: Record<string, string>;
+}
+/** context hook output. */
+export interface PiContextOutput {
+    /** Context content to inject into the model context. */
+    contextContent?: string;
+}
+/** before_provider_request hook output. */
+export interface PiBeforeProviderRequestOutput {
+    /** Modified messages to send to the provider. */
+    messages?: unknown[];
+}
+/** Generic output shape for unrecognized events. */
+export interface PiGenericOutput {
+    [key: string]: unknown;
+}
+/**
+ * Render a UnifiedHookResult back to Pi's native output format.
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original Pi event name.
+ * @returns The native output object to return to Pi.
+ */
+export declare function renderPiOutput(result: UnifiedHookResult, nativeEventName: string): Record<string, unknown>;
+/**
+ * Build extension-state entries for Pi session persistence.
+ *
+ * Pi uses its native extension-state mechanism for key-value persistence
+ * across hook invocations. Unlike Claude's env-file approach, this is
+ * an in-process API — no file I/O needed.
+ *
+ * @param persistEnv - Key-value pairs to persist.
+ * @returns Record of key-value pairs to store in extension-state.
+ */
+export declare function buildExtensionState(persistEnv: Record<string, string>): Record<string, string>;
+//# 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,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,2BAA2B;AAC3B,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,2CAA2C;AAC3C,MAAM,WAAW,6BAA6B;IAC5C,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAuED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE9F"}

package/dist/renderer.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPiOutput = renderPiOutput;
+exports.buildExtensionState = buildExtensionState;
+/**
+ * Render a UnifiedHookResult back to Pi's native output format.
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original Pi event name.
+ * @returns The native output object to return to Pi.
+ */
+function renderPiOutput(result, nativeEventName) {
+    switch (nativeEventName) {
+        case 'tool_call':
+            return renderToolCallOutput(result);
+        case 'session_start':
+            return renderSessionStartOutput(result);
+        case 'context':
+            return renderContextOutput(result);
+        case 'before_provider_request':
+            return renderBeforeProviderRequestOutput(result);
+        default:
+            return renderGenericOutput(result);
+    }
+}
+function renderToolCallOutput(result) {
+    const output = {};
+    // Map unified decision to Pi's permission decision
+    if (result.decision === 'allow') {
+        output['decision'] = 'allow';
+    }
+    else if (result.decision === 'deny') {
+        output['decision'] = 'deny';
+    }
+    // 'ask', 'continue', and 'noop' are not natively supported by Pi;
+    // 'ask' falls through to no decision (Pi defaults to allow)
+    if (result.reason != null) {
+        output['reason'] = result.reason;
+    }
+    // Tool input mutation: Pi supports in-place mutation via toolMutation
+    if (result.toolMutation != null) {
+        output['toolInput'] = result.toolMutation.value;
+    }
+    return output;
+}
+function renderSessionStartOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output['additionalContext'] = result.additionalContext;
+    }
+    // Collect env to persist via extension-state
+    if (result.persistEnv != null && Object.keys(result.persistEnv).length > 0) {
+        output['persistState'] = result.persistEnv;
+    }
+    return output;
+}
+function renderContextOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output['contextContent'] = result.additionalContext;
+    }
+    return output;
+}
+function renderBeforeProviderRequestOutput(result) {
+    const output = {};
+    if (result.systemMessage != null) {
+        output['systemMessage'] = result.systemMessage;
+    }
+    return output;
+}
+function renderGenericOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output['additionalContext'] = result.additionalContext;
+    }
+    return output;
+}
+/**
+ * Build extension-state entries for Pi session persistence.
+ *
+ * Pi uses its native extension-state mechanism for key-value persistence
+ * across hook invocations. Unlike Claude's env-file approach, this is
+ * an in-process API — no file I/O needed.
+ *
+ * @param persistEnv - Key-value pairs to persist.
+ * @returns Record of key-value pairs to store in extension-state.
+ */
+function buildExtensionState(persistEnv) {
+    return { ...persistEnv };
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

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

package/dist/session-resolver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Session ID resolution for Pi.
+ *
+ * Pi provides a native session ID via its programmatic API,
+ * so the resolution quality is 'native'.
+ *
+ * Resolution precedence (spec section 9.2):
+ *   1. Explicit override (e.g. from caller)
+ *   2. Explicit env/extension-state AGENT_SESSION_ID
+ *   3. Native sessionId from Pi event payload
+ *   4. PI_SESSION_ID from extension-state
+ *   5. Fallback: null
+ */
+export interface SessionResolutionResult {
+    sessionId: string | null;
+    source: 'explicit_override' | 'explicit_env' | 'native' | 'harness_env' | 'none';
+}
+/**
+ * Resolve the session ID for a Pi hook invocation.
+ *
+ * @param data - Parsed event payload from Pi.
+ * @param extensionState - Extension-state key-value pairs.
+ * @param explicitSessionId - Explicit session ID override from caller, if any.
+ */
+export declare function resolveSessionId(data: Record<string, unknown>, extensionState?: 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;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,mBAAmB,GAAG,cAAc,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;CAClF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAC3C,iBAAiB,CAAC,EAAE,MAAM,GACzB,uBAAuB,CA0BzB"}

package/dist/session-resolver.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Session ID resolution for Pi.
+ *
+ * Pi provides a native session ID via its programmatic API,
+ * so the resolution quality is 'native'.
+ *
+ * Resolution precedence (spec section 9.2):
+ *   1. Explicit override (e.g. from caller)
+ *   2. Explicit env/extension-state AGENT_SESSION_ID
+ *   3. Native sessionId from Pi event payload
+ *   4. PI_SESSION_ID from extension-state
+ *   5. Fallback: null
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = resolveSessionId;
+/**
+ * Resolve the session ID for a Pi hook invocation.
+ *
+ * @param data - Parsed event payload from Pi.
+ * @param extensionState - Extension-state key-value pairs.
+ * @param explicitSessionId - Explicit session ID override from caller, if any.
+ */
+function resolveSessionId(data, extensionState = {}, explicitSessionId) {
+    // 1. Explicit override
+    if (explicitSessionId) {
+        return { sessionId: explicitSessionId, source: 'explicit_override' };
+    }
+    // 2. Explicit env
+    const envSessionId = extensionState['AGENT_SESSION_ID'];
+    if (envSessionId) {
+        return { sessionId: envSessionId, source: 'explicit_env' };
+    }
+    // 3. Native sessionId from Pi event
+    const nativeSessionId = data.sessionId;
+    if (typeof nativeSessionId === 'string' && nativeSessionId.length > 0) {
+        return { sessionId: nativeSessionId, source: 'native' };
+    }
+    // 4. PI_SESSION_ID from extension-state
+    const piSessionId = extensionState['PI_SESSION_ID'];
+    if (piSessionId) {
+        return { sessionId: piSessionId, source: 'harness_env' };
+    }
+    // 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;;;;;;;;;;;;GAYG;;AAcH,4CA8BC;AArCD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,IAA6B,EAC7B,iBAAyC,EAAE,EAC3C,iBAA0B;IAE1B,uBAAuB;IACvB,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACvE,CAAC;IAED,kBAAkB;IAClB,MAAM,YAAY,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC;IACxD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC7D,CAAC;IAED,oCAAoC;IACpC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC;IACvC,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,wCAAwC;IACxC,MAAM,WAAW,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAC3D,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-pi",
+  "version": "5.0.1-staging.37ca18bd",
+  "description": "Pi 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-pi"
+  },
+  "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"
+  }
+}