@a5c-ai/hooks-adapter-oh-my-pi 5.1.1-staging.52898ebfc24f

package/README.md

@@ -0,0 +1,29 @@
+# @a5c-ai/hooks-adapter-oh-my-pi
+
+oh-my-pi harness adapter for hooks-adapter.
+
+## Install
+
+```bash
+npm install @a5c-ai/hooks-adapter-oh-my-pi @a5c-ai/hooks-adapter-core
+```
+
+This package ships the built adapter runtime in `dist/` and this package README for npm publish-surface auditing.
+
+## Usage
+
+```ts
+import {
+  createAdapter,
+  createConfiguredEngine,
+  normalizeOhMyPiEvent,
+} from "@a5c-ai/hooks-adapter-oh-my-pi";
+```
+
+The package exposes oh-my-pi-specific normalization, phase mappings, session helpers, and an in-process configured engine for hooks-adapter integrations.
+
+See [`packages/adapters/hooks/README.md`](../README.md) for the workspace overview and `packages/adapters/hooks/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-adapter-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,4BAA4B,CAAC;AAatE,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 catalog_1 = require("@a5c-ai/atlas/catalog");
+/**
+ * Creates the Oh-My-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.7.
+ */
+const DEFAULT_ADAPTER_NAME = 'oh-my-pi';
+function createAdapter(name = DEFAULT_ADAPTER_NAME) {
+    const target = (0, catalog_1.getPluginTargetDescriptor)(name === 'oh-my-pi' ? 'oh-my-pi' : name);
+    return {
+        name,
+        family: target?.hooksMuxFamily ?? 'in-process',
+        sessionIdQuality: target?.sessionIdQuality ?? 'native',
+        supportsOrderedFanout: target?.supportsOrderedFanout ?? true,
+        supportsNativeAdditionalContext: target?.supportsNativeAdditionalContext ?? true,
+        supportsBlock: target?.supportsBlock ?? false,
+        supportsAsk: target?.supportsAsk ?? false,
+        supportsToolInputMutation: target?.supportsToolInputMutation ?? false,
+        supportsToolResultMutation: target?.supportsToolResultMutation ?? false,
+        supportsPersistedEnv: target?.supportsPersistedEnv ?? true,
+        envPersistenceMode: target?.envPersistenceMode ?? 'runtime_hook',
+        toolInterceptionScope: target?.toolInterceptionScope ?? 'none',
+        notes: [
+            'library-only adapter, no CLI/shell-hook mode',
+            'supportsToolInputMutation is explicitly false — Pi supports it but Oh-My-Pi does not',
+            'session IDs are natively provided by the Pi runtime',
+            'chained context propagation with session-before short-circuit',
+        ],
+    };
+}
+//# 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,mDAAkE;AAElE;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,SAAgB,aAAa,CAAC,OAAe,oBAAoB;IAC/D,MAAM,MAAM,GAAG,IAAA,mCAAyB,EAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClF,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,IAAI;QAChF,aAAa,EAAE,MAAM,EAAE,aAAa,IAAI,KAAK;QAC7C,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,KAAK;QACzC,yBAAyB,EAAE,MAAM,EAAE,yBAAyB,IAAI,KAAK;QACrE,0BAA0B,EAAE,MAAM,EAAE,0BAA0B,IAAI,KAAK;QACvE,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,IAAI,IAAI;QAC1D,kBAAkB,EAAG,MAAM,EAAE,kBAAgE,IAAI,cAAc;QAC/G,qBAAqB,EAAG,MAAM,EAAE,qBAAsE,IAAI,MAAM;QAChH,KAAK,EAAE;YACL,8CAA8C;YAC9C,sFAAsF;YACtF,qDAAqD;YACrD,+DAA+D;SAChE;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createAdapter } from './adapter';
+export { OH_MY_PI_PHASE_MAPPINGS, findMapping, getSupportedPhases } from './mappings';
+export { createConfiguredEngine } from './integration';
+export { normalizeOhMyPiEvent, parseEventContext, setAdapterName, ADAPTER_NAME, } from './normalizer';
+export type { OhMyPiEventContext, OhMyPiSessionStartPayload, OhMyPiSessionEndPayload, OhMyPiPromptPayload, OhMyPiToolCallPayload, OhMyPiToolResultPayload, OhMyPiErrorPayload, } from './normalizer';
+export { renderOhMyPiOutput, isFieldSupportedForEvent } from './renderer';
+export { resolveSessionId, deriveSessionId, isValidSessionId } from './session-resolver';
+export type { SessionResolutionResult } from './session-resolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzF,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidSessionId = exports.deriveSessionId = exports.resolveSessionId = exports.isFieldSupportedForEvent = exports.renderOhMyPiOutput = exports.ADAPTER_NAME = exports.setAdapterName = exports.parseEventContext = exports.normalizeOhMyPiEvent = exports.createConfiguredEngine = exports.getSupportedPhases = exports.findMapping = exports.OH_MY_PI_PHASE_MAPPINGS = exports.createAdapter = void 0;
+// Adapter capabilities
+var adapter_1 = require("./adapter");
+Object.defineProperty(exports, "createAdapter", { enumerable: true, get: function () { return adapter_1.createAdapter; } });
+// Phase mappings
+var mappings_1 = require("./mappings");
+Object.defineProperty(exports, "OH_MY_PI_PHASE_MAPPINGS", { enumerable: true, get: function () { return mappings_1.OH_MY_PI_PHASE_MAPPINGS; } });
+Object.defineProperty(exports, "findMapping", { enumerable: true, get: function () { return mappings_1.findMapping; } });
+Object.defineProperty(exports, "getSupportedPhases", { enumerable: true, get: function () { return mappings_1.getSupportedPhases; } });
+// Programmatic integration
+var integration_1 = require("./integration");
+Object.defineProperty(exports, "createConfiguredEngine", { enumerable: true, get: function () { return integration_1.createConfiguredEngine; } });
+// Normalizer
+var normalizer_1 = require("./normalizer");
+Object.defineProperty(exports, "normalizeOhMyPiEvent", { enumerable: true, get: function () { return normalizer_1.normalizeOhMyPiEvent; } });
+Object.defineProperty(exports, "parseEventContext", { enumerable: true, get: function () { return normalizer_1.parseEventContext; } });
+Object.defineProperty(exports, "setAdapterName", { enumerable: true, get: function () { return normalizer_1.setAdapterName; } });
+Object.defineProperty(exports, "ADAPTER_NAME", { enumerable: true, get: function () { return normalizer_1.ADAPTER_NAME; } });
+// Renderer
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "renderOhMyPiOutput", { enumerable: true, get: function () { return renderer_1.renderOhMyPiOutput; } });
+Object.defineProperty(exports, "isFieldSupportedForEvent", { enumerable: true, get: function () { return renderer_1.isFieldSupportedForEvent; } });
+// Session resolver
+var session_resolver_1 = require("./session-resolver");
+Object.defineProperty(exports, "resolveSessionId", { enumerable: true, get: function () { return session_resolver_1.resolveSessionId; } });
+Object.defineProperty(exports, "deriveSessionId", { enumerable: true, get: function () { return session_resolver_1.deriveSessionId; } });
+Object.defineProperty(exports, "isValidSessionId", { enumerable: true, get: function () { return session_resolver_1.isValidSessionId; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uBAAuB;AACvB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AAEtB,iBAAiB;AACjB,uCAAsF;AAA7E,mHAAA,uBAAuB,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAEjE,2BAA2B;AAC3B,6CAAuD;AAA9C,qHAAA,sBAAsB,OAAA;AAE/B,aAAa;AACb,2CAKsB;AAJpB,kHAAA,oBAAoB,OAAA;AACpB,+GAAA,iBAAiB,OAAA;AACjB,4GAAA,cAAc,OAAA;AACd,0GAAA,YAAY,OAAA;AAYd,WAAW;AACX,uCAA0E;AAAjE,8GAAA,kBAAkB,OAAA;AAAE,oHAAA,wBAAwB,OAAA;AAErD,mBAAmB;AACnB,uDAAyF;AAAhF,oHAAA,gBAAgB,OAAA;AAAE,mHAAA,eAAe,OAAA;AAAE,oHAAA,gBAAgB,OAAA"}

package/dist/integration.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Programmatic engine integration for the Oh-My-Pi adapter.
+ *
+ * Creates a pre-configured HooksEngine wired to the Oh-My-Pi adapter's
+ * capabilities and phase mappings, ready for in-process hook execution.
+ *
+ * Usage:
+ * ```typescript
+ * import { createConfiguredEngine } from '@a5c-ai/hooks-adapter-oh-my-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' },
+ *   }),
+ * });
+ *
+ * const result = await engine.processEvent({
+ *   nativeEventName: 'session_start',
+ *   payload: { sessionId: 'abc', cwd: '/project' },
+ * });
+ * ```
+ */
+import { type HooksEngine } from '@a5c-ai/hooks-adapter-core';
+/**
+ * Create a pre-configured hooks engine for the Oh-My-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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAIjF;;;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,48 @@
+"use strict";
+/**
+ * Programmatic engine integration for the Oh-My-Pi adapter.
+ *
+ * Creates a pre-configured HooksEngine wired to the Oh-My-Pi adapter's
+ * capabilities and phase mappings, ready for in-process hook execution.
+ *
+ * Usage:
+ * ```typescript
+ * import { createConfiguredEngine } from '@a5c-ai/hooks-adapter-oh-my-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' },
+ *   }),
+ * });
+ *
+ * const result = await engine.processEvent({
+ *   nativeEventName: 'session_start',
+ *   payload: { sessionId: 'abc', cwd: '/project' },
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfiguredEngine = createConfiguredEngine;
+const hooks_adapter_core_1 = require("@a5c-ai/hooks-adapter-core");
+const adapter_1 = require("./adapter");
+const mappings_1 = require("./mappings");
+/**
+ * Create a pre-configured hooks engine for the Oh-My-Pi adapter.
+ * Ready to register handlers and process events.
+ */
+function createConfiguredEngine(options) {
+    const name = options.adapterName;
+    return (0, hooks_adapter_core_1.createHooksEngine)({
+        adapter: name,
+        capabilities: (0, adapter_1.createAdapter)(name),
+        phaseMappings: mappings_1.OH_MY_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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;AAUH,wDAQC;AAhBD,mEAAiF;AACjF,uCAA0C;AAC1C,yCAAqD;AAErD;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,OAAqD;IAC1F,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IACjC,OAAO,IAAA,sCAAiB,EAAC;QACvB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAA,uBAAa,EAAC,IAAI,CAAC;QACjC,aAAa,EAAE,kCAAuB;QACtC,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-adapter-core';
+export declare const OH_MY_PI_PHASE_MAPPINGS: PhaseMapping[];
+/**
+ * Quick lookup from native event name to phase mapping.
+ */
+export declare function findMapping(nativeEventName: string): PhaseMapping | undefined;
+/**
+ * Get all canonical phases supported by the Oh-My-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,4BAA4B,CAAC;AAqD/D,eAAO,MAAM,uBAAuB,EAAE,YAAY,EAAuB,CAAC;AAE1E;;GAEG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/mappings.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OH_MY_PI_PHASE_MAPPINGS = void 0;
+exports.findMapping = findMapping;
+exports.getSupportedPhases = getSupportedPhases;
+const catalog_1 = require("@a5c-ai/atlas/catalog");
+/**
+ * Oh-My-Pi native event to canonical phase mapping table.
+ *
+ * Phase mappings are built from the Atlas graph HookMapping records
+ * via the agent-catalog. Falls back to hardcoded defaults if the
+ * catalog is unavailable.
+ *
+ * Spec section 17.7.
+ */
+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'),
+        notes: mapping.nativeName === 'tool_call'
+            ? 'Mutation is NOT supported by Oh-My-Pi tool_call hooks.'
+            : undefined,
+    };
+}
+function buildFromCatalog() {
+    const mappings = (0, catalog_1.listHookMappingsByAdapterFamily)('oh-my-pi');
+    if (mappings.length === 0) {
+        throw new Error('hooks-adapter adapter-oh-my-pi: catalog unavailable or returned no mappings for family "oh-my-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.OH_MY_PI_PHASE_MAPPINGS = buildFromCatalog();
+/**
+ * Quick lookup from native event name to phase mapping.
+ */
+function findMapping(nativeEventName) {
+    return exports.OH_MY_PI_PHASE_MAPPINGS.find((m) => m.nativeHook === nativeEventName);
+}
+/**
+ * Get all canonical phases supported by the Oh-My-Pi adapter.
+ */
+function getSupportedPhases() {
+    return exports.OH_MY_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":";;;AA0DA,kCAEC;AAKD,gDAEC;AAlED,mDAAwE;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;QAC5D,KAAK,EAAE,OAAO,CAAC,UAAU,KAAK,WAAW;YACvC,CAAC,CAAC,wDAAwD;YAC1D,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,QAAQ,GAAG,IAAA,yCAA+B,EAAC,UAAU,CAAC,CAAC;IAC7D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,mGAAmG,CAAC,CAAC;IACvH,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,uBAAuB,GAAmB,gBAAgB,EAAE,CAAC;AAE1E;;GAEG;AACH,SAAgB,WAAW,CAAC,eAAuB;IACjD,OAAO,+BAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,eAAe,CAAC,CAAC;AAC/E,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,68 @@
+import { type UnifiedHookEvent } from '@a5c-ai/hooks-adapter-core';
+/** The default adapter identifier used in all normalized events. */
+export declare const ADAPTER_NAME = "oh-my-pi";
+/** Override the adapter name used in normalized events. */
+export declare function setAdapterName(name: string): void;
+/**
+ * Common fields that may be present on Oh-My-Pi extension event contexts.
+ * Oh-My-Pi events are delivered in-process as typed objects, not stdin.
+ */
+export interface OhMyPiEventContext {
+    sessionId?: string;
+    cwd?: string;
+    workspace?: string;
+    model?: string;
+    [key: string]: unknown;
+}
+/** session_start-specific fields. */
+export interface OhMyPiSessionStartPayload extends OhMyPiEventContext {
+    source?: string;
+}
+/** session_end-specific fields. */
+export interface OhMyPiSessionEndPayload extends OhMyPiEventContext {
+    reason?: string;
+}
+/** prompt-specific fields. */
+export interface OhMyPiPromptPayload extends OhMyPiEventContext {
+    text?: string;
+}
+/** tool_call-specific fields. */
+export interface OhMyPiToolCallPayload extends OhMyPiEventContext {
+    tool_name?: string;
+    tool_call_id?: string;
+    tool_input?: unknown;
+}
+/** tool_result-specific fields. */
+export interface OhMyPiToolResultPayload extends OhMyPiEventContext {
+    tool_name?: string;
+    tool_call_id?: string;
+    tool_input?: unknown;
+    tool_result?: unknown;
+}
+/** error-specific fields. */
+export interface OhMyPiErrorPayload extends OhMyPiEventContext {
+    error?: string;
+    code?: string;
+}
+/**
+ * Parse raw event context into a typed object.
+ * Oh-My-Pi events are delivered in-process as objects, but we
+ * handle string/null/undefined gracefully for robustness.
+ */
+export declare function parseEventContext(raw: unknown): Record<string, unknown>;
+/**
+ * Normalize a raw Oh-My-Pi extension event into a UnifiedHookEvent.
+ *
+ * Oh-My-Pi is a library-only adapter. Events arrive as in-process
+ * objects from the Pi extension API, not via stdin. The normalizer:
+ * - Parses event context gracefully
+ * - Enriches env from context fields
+ * - Extracts native session ID when available
+ * - Annotates events with mutability limitation metadata
+ *
+ * @param rawEventName - The native Oh-My-Pi event name (e.g. 'session_start', 'tool_call')
+ * @param eventContext - In-process event context object
+ * @param env - Environment variables at invocation time
+ */
+export declare function normalizeOhMyPiEvent(rawEventName: string, eventContext: unknown, env?: Record<string, string>): UnifiedHookEvent;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,gBAAgB,EAAyB,MAAM,4BAA4B,CAAC;AAG1G,oEAAoE;AACpE,eAAO,MAAM,YAAY,aAAa,CAAC;AAKvC,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qCAAqC;AACrC,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,mCAAmC;AACnC,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8BAA8B;AAC9B,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iCAAiC;AACjC,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,6BAA6B;AAC7B,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBvE;AAgBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,OAAO,EACrB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,gBAAgB,CAyDlB"}

package/dist/normalizer.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_NAME = void 0;
+exports.setAdapterName = setAdapterName;
+exports.parseEventContext = parseEventContext;
+exports.normalizeOhMyPiEvent = normalizeOhMyPiEvent;
+const hooks_adapter_core_1 = require("@a5c-ai/hooks-adapter-core");
+const mappings_1 = require("./mappings");
+/** The default adapter identifier used in all normalized events. */
+exports.ADAPTER_NAME = 'oh-my-pi';
+/** Mutable adapter name, defaulting to the oh-my-pi adapter identity. */
+let _adapterName = 'oh-my-pi';
+/** Override the adapter name used in normalized events. */
+function setAdapterName(name) {
+    _adapterName = name;
+}
+/**
+ * Parse raw event context into a typed object.
+ * Oh-My-Pi events are delivered in-process as objects, but we
+ * handle string/null/undefined gracefully for robustness.
+ */
+function parseEventContext(raw) {
+    if (raw == null)
+        return {};
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // fail open for robustness
+        }
+        return {};
+    }
+    if (typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    return {};
+}
+/**
+ * Extract tool metadata from a tool_call/tool_result event context.
+ */
+function extractToolFields(ctx) {
+    const fields = {};
+    if (typeof ctx['tool_name'] === 'string') {
+        fields['HOOKS_PROXY_TOOL_NAME'] = ctx['tool_name'];
+    }
+    if (typeof ctx['tool_call_id'] === 'string') {
+        fields['HOOKS_PROXY_TOOL_CALL_ID'] = ctx['tool_call_id'];
+    }
+    return fields;
+}
+/**
+ * Normalize a raw Oh-My-Pi extension event into a UnifiedHookEvent.
+ *
+ * Oh-My-Pi is a library-only adapter. Events arrive as in-process
+ * objects from the Pi extension API, not via stdin. The normalizer:
+ * - Parses event context gracefully
+ * - Enriches env from context fields
+ * - Extracts native session ID when available
+ * - Annotates events with mutability limitation metadata
+ *
+ * @param rawEventName - The native Oh-My-Pi event name (e.g. 'session_start', 'tool_call')
+ * @param eventContext - In-process event context object
+ * @param env - Environment variables at invocation time
+ */
+function normalizeOhMyPiEvent(rawEventName, eventContext, env = {}) {
+    const parsed = parseEventContext(eventContext);
+    // Enrich env with Oh-My-Pi-specific fields extracted from context
+    const enrichedEnv = { ...env };
+    // Oh-My-Pi provides native session IDs via the Pi runtime
+    if (typeof parsed['sessionId'] === 'string' && !enrichedEnv['HOOKS_PROXY_SESSION_ID']) {
+        enrichedEnv['HOOKS_PROXY_SESSION_ID'] = parsed['sessionId'];
+    }
+    if (typeof parsed['cwd'] === 'string' && !enrichedEnv['HOOKS_PROXY_CWD']) {
+        enrichedEnv['HOOKS_PROXY_CWD'] = parsed['cwd'];
+    }
+    if (typeof parsed['workspace'] === 'string' && !enrichedEnv['HOOKS_PROXY_WORKTREE']) {
+        enrichedEnv['HOOKS_PROXY_WORKTREE'] = parsed['workspace'];
+    }
+    if (typeof parsed['model'] === 'string' && !enrichedEnv['HOOKS_PROXY_MODEL']) {
+        enrichedEnv['HOOKS_PROXY_MODEL'] = parsed['model'];
+    }
+    if (typeof parsed['source'] === 'string' && !enrichedEnv['HOOKS_PROXY_SOURCE']) {
+        enrichedEnv['HOOKS_PROXY_SOURCE'] = parsed['source'];
+    }
+    // Tool-specific env enrichment
+    if (rawEventName === 'tool_call' || rawEventName === 'tool_result') {
+        const toolFields = extractToolFields(parsed);
+        for (const [k, v] of Object.entries(toolFields)) {
+            if (!enrichedEnv[k]) {
+                enrichedEnv[k] = v;
+            }
+        }
+    }
+    const options = {
+        adapter: _adapterName,
+        rawEventName,
+        stdinPayload: parsed,
+        env: enrichedEnv,
+        adapterMappings: mappings_1.OH_MY_PI_PHASE_MAPPINGS,
+    };
+    const event = (0, hooks_adapter_core_1.normalizeEvent)(options);
+    // Annotate with Oh-My-Pi-specific metadata
+    event.execution.metadata = {
+        ...event.execution.metadata,
+        adapterFamily: 'in-process',
+        supportsToolInputMutation: false,
+        chainedContext: true,
+        sessionBeforeShortCircuit: true,
+    };
+    return event;
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/normalizer.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,21 @@
+import type { MergedExecutionResult } from '@a5c-ai/hooks-adapter-core';
+/**
+ * Render a merged execution result into Oh-My-Pi native output.
+ *
+ * Only includes fields that are meaningful for the given native event
+ * type. Unsupported fields are silently dropped. Tool input mutation
+ * is never emitted (explicit Oh-My-Pi limitation).
+ *
+ * @param mergedResult - The merged result from multi-hook fan-out
+ * @param nativeEventName - The original Oh-My-Pi event name
+ * @returns Oh-My-Pi native output object, and list of dropped fields
+ */
+export declare function renderOhMyPiOutput(mergedResult: MergedExecutionResult, nativeEventName: string): {
+    output: Record<string, unknown>;
+    droppedFields: string[];
+};
+/**
+ * Check whether a given output field is supported for a native event.
+ */
+export declare function isFieldSupportedForEvent(field: string, nativeEventName: string): boolean;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAsExE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,qBAAqB,EACnC,eAAe,EAAE,MAAM,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CA0B9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAGxF"}

package/dist/renderer.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderOhMyPiOutput = renderOhMyPiOutput;
+exports.isFieldSupportedForEvent = isFieldSupportedForEvent;
+/**
+ * Oh-My-Pi native output fields that are supported per event type.
+ *
+ * Oh-My-Pi is an in-process adapter. Output is returned directly
+ * to the Pi extension runtime, not written to stdout. Only emit
+ * fields that are meaningful for the Pi extension API to process.
+ *
+ * Spec section 17.7: Oh-My-Pi does not support tool input mutation,
+ * so toolMutation fields are never emitted.
+ */
+/** Output fields supported on session_start. */
+const SESSION_START_FIELDS = new Set([
+    'reason',
+    'additionalContext',
+]);
+/** Output fields supported on session_end (observer-only). */
+const SESSION_END_FIELDS = new Set([
+    'reason',
+]);
+/** Output fields supported on prompt. */
+const PROMPT_FIELDS = new Set([
+    'reason',
+    'additionalContext',
+]);
+/** Output fields supported on tool_call (no mutation). */
+const TOOL_CALL_FIELDS = new Set([
+    'reason',
+]);
+/** Output fields supported on tool_result. */
+const TOOL_RESULT_FIELDS = new Set([
+    'reason',
+]);
+/** Output fields supported on error. */
+const ERROR_FIELDS = new Set([
+    'reason',
+]);
+/** Output fields supported on context. */
+const CONTEXT_FIELDS = new Set([
+    'reason',
+    'additionalContext',
+]);
+/** Output fields supported on before_provider_request. */
+const BEFORE_PROVIDER_REQUEST_FIELDS = new Set([
+    'reason',
+    'additionalContext',
+    'systemMessage',
+]);
+/** Map native event names to their supported output field sets. */
+const SUPPORTED_FIELDS_BY_EVENT = {
+    session_start: SESSION_START_FIELDS,
+    session_end: SESSION_END_FIELDS,
+    prompt: PROMPT_FIELDS,
+    tool_call: TOOL_CALL_FIELDS,
+    tool_result: TOOL_RESULT_FIELDS,
+    error: ERROR_FIELDS,
+    context: CONTEXT_FIELDS,
+    before_provider_request: BEFORE_PROVIDER_REQUEST_FIELDS,
+};
+/**
+ * Render a merged execution result into Oh-My-Pi native output.
+ *
+ * Only includes fields that are meaningful for the given native event
+ * type. Unsupported fields are silently dropped. Tool input mutation
+ * is never emitted (explicit Oh-My-Pi limitation).
+ *
+ * @param mergedResult - The merged result from multi-hook fan-out
+ * @param nativeEventName - The original Oh-My-Pi event name
+ * @returns Oh-My-Pi native output object, and list of dropped fields
+ */
+function renderOhMyPiOutput(mergedResult, nativeEventName) {
+    const supportedFields = SUPPORTED_FIELDS_BY_EVENT[nativeEventName] ?? new Set();
+    const output = {};
+    const droppedFields = [];
+    // Candidate output fields from the merged result
+    const candidates = [
+        { key: 'decision', value: mergedResult.decision, isEmpty: mergedResult.decision === 'noop' },
+        { key: 'reason', value: mergedResult.reason, isEmpty: !mergedResult.reason },
+        { key: 'additionalContext', value: mergedResult.additionalContext, isEmpty: !mergedResult.additionalContext },
+        { key: 'systemMessage', value: mergedResult.systemMessage, isEmpty: !mergedResult.systemMessage },
+        { key: 'continueSession', value: mergedResult.continueSession, isEmpty: mergedResult.continueSession === true },
+        { key: 'stopReason', value: mergedResult.stopReason, isEmpty: !mergedResult.stopReason },
+    ];
+    for (const candidate of candidates) {
+        if (candidate.isEmpty)
+            continue;
+        if (supportedFields.has(candidate.key)) {
+            output[candidate.key] = candidate.value;
+        }
+        else {
+            droppedFields.push(candidate.key);
+        }
+    }
+    return { output, droppedFields };
+}
+/**
+ * Check whether a given output field is supported for a native event.
+ */
+function isFieldSupportedForEvent(field, nativeEventName) {
+    const supported = SUPPORTED_FIELDS_BY_EVENT[nativeEventName];
+    return supported ? supported.has(field) : false;
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

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

package/dist/session-resolver.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Resolve session ID from Oh-My-Pi extension event context.
+ *
+ * Oh-My-Pi provides NATIVE session IDs via the Pi runtime, giving
+ * it 'native' sessionIdQuality in the capability model. When
+ * a native session ID is not available, derivation from workspace
+ * or cwd is used as a fallback.
+ *
+ * Resolution precedence (per spec 9.2):
+ *   1. Explicit AGENT_SESSION_ID env var
+ *   2. Native sessionId from event context (Pi runtime)
+ *   3. OMP_SESSION_ID env var (harness-specific)
+ *   4. Derived from workspace or cwd via stable hash
+ *   5. null (no session available)
+ */
+export interface SessionResolutionResult {
+    sessionId: string | null;
+    source: 'explicit_env' | 'native' | 'harness_env' | 'derived' | 'none';
+    /** Whether the ID was derived (hashed) rather than provided natively. */
+    isDerived: boolean;
+}
+/**
+ * Resolve the session ID for an Oh-My-Pi extension event.
+ *
+ * @param eventContext - Parsed event context object from the Pi extension API
+ * @param env - Environment variables at invocation time
+ */
+export declare function resolveSessionId(eventContext: Record<string, unknown>, env?: Record<string, string>): SessionResolutionResult;
+/**
+ * Derive a stable session ID from a workspace or directory path.
+ * Uses a truncated SHA-256 hash prefixed with 'omp-' for identifiability.
+ */
+export declare function deriveSessionId(path: string): string;
+/**
+ * Validate that a session ID looks reasonable.
+ */
+export declare function isValidSessionId(sessionId: string): boolean;
+//# sourceMappingURL=session-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.d.ts","sourceRoot":"","sources":["../src/session-resolver.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,cAAc,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,CAAC;IACvE,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,uBAAuB,CAmCzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/session-resolver.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = resolveSessionId;
+exports.deriveSessionId = deriveSessionId;
+exports.isValidSessionId = isValidSessionId;
+const crypto_1 = require("crypto");
+/**
+ * Resolve the session ID for an Oh-My-Pi extension event.
+ *
+ * @param eventContext - Parsed event context object from the Pi extension API
+ * @param env - Environment variables at invocation time
+ */
+function resolveSessionId(eventContext, env = {}) {
+    // Priority 1: explicit env override
+    const explicit = env['AGENT_SESSION_ID'];
+    if (typeof explicit === 'string' && explicit.length > 0) {
+        return { sessionId: explicit, source: 'explicit_env', isDerived: false };
+    }
+    // Priority 2: native session ID from event context (Pi runtime)
+    const nativeSessionId = eventContext['sessionId'];
+    if (typeof nativeSessionId === 'string' && nativeSessionId.length > 0) {
+        return { sessionId: nativeSessionId, source: 'native', isDerived: false };
+    }
+    // Priority 3: harness-specific env var
+    const harnessEnv = env['OMP_SESSION_ID'];
+    if (typeof harnessEnv === 'string' && harnessEnv.length > 0) {
+        return { sessionId: harnessEnv, source: 'harness_env', isDerived: false };
+    }
+    // Priority 4: derive from workspace or cwd
+    const workspace = typeof eventContext['workspace'] === 'string'
+        ? eventContext['workspace']
+        : undefined;
+    const cwd = typeof eventContext['cwd'] === 'string'
+        ? eventContext['cwd']
+        : env['PWD'] ?? env['HOMEDRIVE'] ?? undefined;
+    const derivationSource = workspace ?? cwd;
+    if (derivationSource) {
+        const derived = deriveSessionId(derivationSource);
+        return { sessionId: derived, source: 'derived', isDerived: true };
+    }
+    // Priority 5: no session
+    return { sessionId: null, source: 'none', isDerived: false };
+}
+/**
+ * Derive a stable session ID from a workspace or directory path.
+ * Uses a truncated SHA-256 hash prefixed with 'omp-' for identifiability.
+ */
+function deriveSessionId(path) {
+    const hash = (0, crypto_1.createHash)('sha256').update(path).digest('hex').slice(0, 16);
+    return `omp-${hash}`;
+}
+/**
+ * Validate that a session ID looks reasonable.
+ */
+function isValidSessionId(sessionId) {
+    return sessionId.length > 0 && sessionId.length <= 256;
+}
+//# sourceMappingURL=session-resolver.js.map

package/dist/session-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.js","sourceRoot":"","sources":["../src/session-resolver.ts"],"names":[],"mappings":";;AA+BA,4CAsCC;AAMD,0CAGC;AAKD,4CAEC;AArFD,mCAAoC;AAyBpC;;;;;GAKG;AACH,SAAgB,gBAAgB,CAC9B,YAAqC,EACrC,MAA8B,EAAE;IAEhC,oCAAoC;IACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACzC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC3E,CAAC;IAED,gEAAgE;IAChE,MAAM,eAAe,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC5E,CAAC;IAED,uCAAuC;IACvC,MAAM,UAAU,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACzC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC5E,CAAC;IAED,2CAA2C;IAC3C,MAAM,SAAS,GAAG,OAAO,YAAY,CAAC,WAAW,CAAC,KAAK,QAAQ;QAC7D,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC;QAC3B,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,GAAG,GAAG,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,QAAQ;QACjD,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;QACrB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC;IAEhD,MAAM,gBAAgB,GAAG,SAAS,IAAI,GAAG,CAAC;IAC1C,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;QAClD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACpE,CAAC;IAED,yBAAyB;IACzB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,OAAO,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,SAAiB;IAChD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC;AACzD,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@a5c-ai/hooks-adapter-oh-my-pi",
+  "version": "5.1.1-staging.52898ebfc24f",
+  "description": "oh-my-pi harness adapter for the hooks-adapter 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/adapters/hooks/adapter-oh-my-pi"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/packages/adapters/hooks/adapter-oh-my-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-adapter-core": "5.1.1-staging.52898ebfc24f"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.8"
+  }
+}