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

package/README.md

@@ -0,0 +1,29 @@
+# @a5c-ai/hooks-mux-adapter-pi
+
+Pi harness adapter for hooks-mux.
+
+## Install
+
+```bash
+npm install @a5c-ai/hooks-mux-adapter-pi @a5c-ai/hooks-mux-core
+```
+
+This package ships the built adapter runtime in `dist/` and this package README for npm publish-surface auditing.
+
+## Usage
+
+```ts
+import {
+  createAdapter,
+  createConfiguredEngine,
+  normalizePi,
+} from "@a5c-ai/hooks-mux-adapter-pi";
+```
+
+The package exposes Pi-specific normalization, phase mappings, session helpers, rendering utilities, and an in-process configured engine for hooks-mux integrations.
+
+See [`packages/hooks-mux/README.md`](../README.md) for the workspace overview and `packages/hooks-mux/docs/adapter-integration-guide.md` for end-to-end integration guidance.
+
+## License
+
+MIT © a5c-ai

package/dist/adapter.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterCapabilities } from '@a5c-ai/hooks-mux-core';
+export declare function createAdapter(name?: string): AdapterCapabilities;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

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

package/dist/adapter.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+const agent_catalog_1 = require("@a5c-ai/agent-catalog");
+/**
+ * Creates the Pi adapter capability descriptor.
+ *
+ * Reads capability data from the Atlas graph via the agent-catalog.
+ * Falls back to hardcoded defaults if the catalog is unavailable.
+ *
+ * Spec section 17.6.
+ */
+const DEFAULT_ADAPTER_NAME = 'pi';
+function createAdapter(name = DEFAULT_ADAPTER_NAME) {
+    const target = (0, agent_catalog_1.getPluginTargetDescriptor)(name);
+    return {
+        name,
+        family: target?.hooksMuxFamily ?? 'in-process',
+        sessionIdQuality: target?.sessionIdQuality ?? 'native',
+        supportsOrderedFanout: target?.supportsOrderedFanout ?? true,
+        supportsNativeAdditionalContext: target?.supportsNativeAdditionalContext ?? false,
+        supportsBlock: target?.supportsBlock ?? true,
+        supportsAsk: target?.supportsAsk ?? false,
+        supportsToolInputMutation: target?.supportsToolInputMutation ?? true,
+        supportsToolResultMutation: target?.supportsToolResultMutation ?? false,
+        supportsPersistedEnv: target?.supportsPersistedEnv ?? true,
+        envPersistenceMode: target?.envPersistenceMode ?? 'runtime_hook',
+        toolInterceptionScope: target?.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":";;AAaA,sCAsBC;AAlCD,yDAAkE;AAElE;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC,SAAgB,aAAa,CAAC,OAAe,oBAAoB;IAC/D,MAAM,MAAM,GAAG,IAAA,yCAAyB,EAAC,IAAI,CAAC,CAAC;IAC/C,OAAO;QACL,IAAI;QACJ,MAAM,EAAG,MAAM,EAAE,cAAgD,IAAI,YAAY;QACjF,gBAAgB,EAAG,MAAM,EAAE,gBAA4D,IAAI,QAAQ;QACnG,qBAAqB,EAAE,MAAM,EAAE,qBAAqB,IAAI,IAAI;QAC5D,+BAA+B,EAAE,MAAM,EAAE,+BAA+B,IAAI,KAAK;QACjF,aAAa,EAAE,MAAM,EAAE,aAAa,IAAI,IAAI;QAC5C,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,KAAK;QACzC,yBAAyB,EAAE,MAAM,EAAE,yBAAyB,IAAI,IAAI;QACpE,0BAA0B,EAAE,MAAM,EAAE,0BAA0B,IAAI,KAAK;QACvE,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,IAAI,IAAI;QAC1D,kBAAkB,EAAG,MAAM,EAAE,kBAAgE,IAAI,cAAc;QAC/G,qBAAqB,EAAG,MAAM,EAAE,qBAAsE,IAAI,KAAK;QAC/G,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, setAdapterName } 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,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7G,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,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = exports.buildExtensionState = exports.renderPiOutput = exports.setAdapterName = 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; } });
+Object.defineProperty(exports, "setAdapterName", { enumerable: true, get: function () { return normalizer_1.setAdapterName; } });
+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,2CAA6G;AAApG,yGAAA,WAAW,OAAA;AAAE,yGAAA,WAAW,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,4GAAA,cAAc,OAAA;AAQtF,uCAAiE;AAAxD,0GAAA,cAAc,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAQ5C,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/integration.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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;
+    adapterName: 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,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAQzG"}

package/dist/integration.js

@@ -0,0 +1,49 @@
+"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) {
+    const name = options.adapterName;
+    return (0, hooks_mux_core_1.createHooksEngine)({
+        adapter: name,
+        capabilities: (0, adapter_1.createAdapter)(name),
+        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,wDAQC;AAhBD,2DAA6E;AAC7E,uCAA0C;AAC1C,yCAA+C;AAE/C;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,OAAqD;IAC1F,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IACjC,OAAO,IAAA,kCAAiB,EAAC;QACvB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAA,uBAAa,EAAC,IAAI,CAAC;QACjC,aAAa,EAAE,4BAAiB;QAChC,UAAU,EAAE,OAAO,EAAE,UAAU;KAChC,CAAC,CAAC;AACL,CAAC"}

package/dist/mappings.d.ts

@@ -0,0 +1,11 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-mux-core';
+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;AAkD3D,eAAO,MAAM,iBAAiB,EAAE,YAAY,EAAuB,CAAC;AAEpE;;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;
+const agent_catalog_1 = require("@a5c-ai/agent-catalog");
+/**
+ * Pi native event name to canonical phase mappings.
+ *
+ * Phase mappings are built from the Atlas graph HookMapping records
+ * via the agent-catalog. Falls back to hardcoded defaults if the
+ * catalog is unavailable.
+ *
+ * Spec section 8.2 / 17.6.
+ */
+const SUPPORT_LEVEL_MAP = {
+    supported: 'native',
+    native: 'native',
+    lossy: 'lossy',
+    emulated: 'emulated',
+    unsupported: 'unsupported',
+};
+function hookMappingToPhaseMapping(mapping) {
+    if (!mapping.canonicalPhase)
+        return null;
+    return {
+        canonicalPhase: mapping.canonicalPhase,
+        nativeHook: mapping.nativeName,
+        supportLevel: SUPPORT_LEVEL_MAP[mapping.supportLevel] ?? 'native',
+        blockCapability: mapping.blockCapability ?? false,
+        mutationCapability: mapping.mutationCapability ?? false,
+        scope: (mapping.scope ?? 'session'),
+    };
+}
+function buildFromCatalog() {
+    const mappings = (0, agent_catalog_1.listHookMappingsByAdapterFamily)('pi');
+    if (mappings.length === 0) {
+        throw new Error('hooks-mux adapter-pi: catalog unavailable or returned no mappings for family "pi"');
+    }
+    const phaseMappings = mappings
+        .map(hookMappingToPhaseMapping)
+        .filter((m) => m !== null);
+    const seen = new Set();
+    return phaseMappings.filter((m) => {
+        if (seen.has(m.nativeHook))
+            return false;
+        seen.add(m.nativeHook);
+        return true;
+    });
+}
+exports.PI_PHASE_MAPPINGS = buildFromCatalog();
+/**
+ * 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":";;;AAuDA,8CAEC;AAKD,gDAEC;AA/DD,yDAAwE;AAGxE;;;;;;;;GAQG;AAEH,MAAM,iBAAiB,GAAiD;IACtE,SAAS,EAAE,QAAQ;IACnB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEF,SAAS,yBAAyB,CAAC,OAA8B;IAC/D,IAAI,CAAC,OAAO,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO;QACL,cAAc,EAAE,OAAO,CAAC,cAAgD;QACxE,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,YAAY,EAAE,iBAAiB,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,QAAQ;QACjE,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,KAAK;QACjD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,KAAK;QACvD,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,CAA0B;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,QAAQ,GAAG,IAAA,+CAA+B,EAAC,IAAI,CAAC,CAAC;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,aAAa,GAAG,QAAQ;SAC3B,GAAG,CAAC,yBAAyB,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAEY,QAAA,iBAAiB,GAAmB,gBAAgB,EAAE,CAAC;AAEpE;;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,68 @@
+import type { UnifiedHookEvent, UnifiedExecutionContext } from '@a5c-ai/hooks-mux-core';
+/** The default adapter name. */
+export declare const ADAPTER_NAME = "pi";
+/** Override the adapter name used in normalized events. */
+export declare function setAdapterName(name: string): void;
+/**
+ * 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,gCAAgC;AAChC,eAAO,MAAM,YAAY,OAAO,CAAC;AAKjC,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;;;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,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_NAME = void 0;
+exports.setAdapterName = setAdapterName;
+exports.coerceInput = coerceInput;
+exports.buildExecutionContext = buildExecutionContext;
+exports.buildPayload = buildPayload;
+exports.normalizePi = normalizePi;
+const mappings_1 = require("./mappings");
+/** The default adapter name. */
+exports.ADAPTER_NAME = 'pi';
+/** Mutable adapter name, defaulting to the pi adapter identity. */
+let _adapterName = 'pi';
+/** Override the adapter name used in normalized events. */
+function setAdapterName(name) {
+    _adapterName = name;
+}
+/**
+ * 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: _adapterName,
+        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: _adapterName,
+        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,40 @@
+{
+  "name": "@a5c-ai/hooks-mux-adapter-pi",
+  "version": "5.0.1-staging.00fa5317c",
+  "description": "Pi harness adapter for the hooks-mux system",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a5c-ai/babysitter.git",
+    "directory": "packages/hooks-mux/adapter-pi"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/packages/hooks-mux/adapter-pi#readme",
+  "bugs": {
+    "url": "https://github.com/a5c-ai/babysitter/issues"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rimraf dist",
+    "lint": "eslint \"src/**/*.ts\" --max-warnings=0",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@a5c-ai/hooks-mux-core": "5.0.1-staging.00fa5317c"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "rimraf": "^6.0.0"
+  }
+}