@a5c-ai/hooks-adapter-opencode 5.1.1-staging.52898ebfc24f

package/README.md

@@ -0,0 +1,29 @@
+# @a5c-ai/hooks-adapter-opencode
+
+OpenCode harness adapter for hooks-adapter.
+
+## Install
+
+```bash
+npm install @a5c-ai/hooks-adapter-opencode @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,
+  normalizeOpenCode,
+} from "@a5c-ai/hooks-adapter-opencode";
+```
+
+The package exposes OpenCode-specific normalization, phase mappings, session utilities, 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,CAqBtF"}

package/dist/adapter.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+const catalog_1 = require("@a5c-ai/atlas/catalog");
+/**
+ * Creates the OpenCode 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.8.
+ */
+const DEFAULT_ADAPTER_NAME = 'opencode';
+function createAdapter(name = DEFAULT_ADAPTER_NAME) {
+    const target = (0, catalog_1.getPluginTargetDescriptor)(name);
+    return {
+        name,
+        family: target?.hooksMuxFamily ?? 'in-process',
+        sessionIdQuality: target?.sessionIdQuality ?? 'native',
+        supportsOrderedFanout: target?.supportsOrderedFanout ?? false,
+        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; no CLI shell-hook mode',
+            'Native env injection via shell.env hook',
+            'Session ID provided natively by the OpenCode runtime',
+        ],
+    };
+}
+//# 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,sCAqBC;AAjCD,mDAAkE;AAElE;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,SAAgB,aAAa,CAAC,OAAe,oBAAoB;IAC/D,MAAM,MAAM,GAAG,IAAA,mCAAyB,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,KAAK;QAC7D,+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,8CAA8C;YAC9C,yCAAyC;YACzC,sDAAsD;SACvD;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createAdapter } from './adapter';
+export { OPENCODE_PHASE_MAPPINGS, SHELL_ENV_NATIVE_HOOK, getOpenCodePhaseMapping, getSupportedPhases, } from './mappings';
+export { createConfiguredEngine } from './integration';
+export { normalizeOpenCode, parseEventData, buildExecutionContext, buildPayload, setAdapterName, } from './normalizer';
+export { renderOpenCodeOutput } from './renderer';
+export { resolveSessionId, deriveSessionId } from './session-resolver';
+export type { OpenCodeEventBase, OpenCodeSessionCreatedPayload, OpenCodeToolExecuteBeforePayload, OpenCodeToolExecuteAfterPayload, OpenCodeShellEnvPayload, } from './normalizer';
+export type { OpenCodeSessionCreatedOutput, OpenCodeToolExecuteBeforeOutput, OpenCodeToolExecuteAfterOutput, OpenCodeShellEnvOutput, } from './renderer';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGvE,YAAY,EACV,iBAAiB,EACjB,6BAA6B,EAC7B,gCAAgC,EAChC,+BAA+B,EAC/B,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,4BAA4B,EAC5B,+BAA+B,EAC/B,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveSessionId = exports.resolveSessionId = exports.renderOpenCodeOutput = exports.setAdapterName = exports.buildPayload = exports.buildExecutionContext = exports.parseEventData = exports.normalizeOpenCode = exports.createConfiguredEngine = exports.getSupportedPhases = exports.getOpenCodePhaseMapping = exports.SHELL_ENV_NATIVE_HOOK = exports.OPENCODE_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, "OPENCODE_PHASE_MAPPINGS", { enumerable: true, get: function () { return mappings_1.OPENCODE_PHASE_MAPPINGS; } });
+Object.defineProperty(exports, "SHELL_ENV_NATIVE_HOOK", { enumerable: true, get: function () { return mappings_1.SHELL_ENV_NATIVE_HOOK; } });
+Object.defineProperty(exports, "getOpenCodePhaseMapping", { enumerable: true, get: function () { return mappings_1.getOpenCodePhaseMapping; } });
+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, "normalizeOpenCode", { enumerable: true, get: function () { return normalizer_1.normalizeOpenCode; } });
+Object.defineProperty(exports, "parseEventData", { enumerable: true, get: function () { return normalizer_1.parseEventData; } });
+Object.defineProperty(exports, "buildExecutionContext", { enumerable: true, get: function () { return normalizer_1.buildExecutionContext; } });
+Object.defineProperty(exports, "buildPayload", { enumerable: true, get: function () { return normalizer_1.buildPayload; } });
+Object.defineProperty(exports, "setAdapterName", { enumerable: true, get: function () { return normalizer_1.setAdapterName; } });
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "renderOpenCodeOutput", { enumerable: true, get: function () { return renderer_1.renderOpenCodeOutput; } });
+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; } });
+//# 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,uCAKoB;AAJlB,mHAAA,uBAAuB,OAAA;AACvB,iHAAA,qBAAqB,OAAA;AACrB,mHAAA,uBAAuB,OAAA;AACvB,8GAAA,kBAAkB,OAAA;AAEpB,6CAAuD;AAA9C,qHAAA,sBAAsB,OAAA;AAC/B,2CAMsB;AALpB,+GAAA,iBAAiB,OAAA;AACjB,4GAAA,cAAc,OAAA;AACd,mHAAA,qBAAqB,OAAA;AACrB,0GAAA,YAAY,OAAA;AACZ,4GAAA,cAAc,OAAA;AAEhB,uCAAkD;AAAzC,gHAAA,oBAAoB,OAAA;AAC7B,uDAAuE;AAA9D,oHAAA,gBAAgB,OAAA;AAAE,mHAAA,eAAe,OAAA"}

package/dist/integration.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Programmatic engine integration for the OpenCode adapter.
+ *
+ * Creates a pre-configured HooksEngine wired to the OpenCode adapter's
+ * capabilities and phase mappings, ready for in-process hook execution.
+ *
+ * Usage:
+ * ```typescript
+ * import { createConfiguredEngine } from '@a5c-ai/hooks-adapter-opencode';
+ *
+ * const engine = createConfiguredEngine();
+ *
+ * engine.registerHandler({
+ *   id: 'my-handler',
+ *   pluginId: 'my-plugin',
+ *   phase: 'tool.before',
+ *   priority: 10,
+ *   handler: async (event) => ({
+ *     decision: 'allow',
+ *   }),
+ * });
+ *
+ * const result = await engine.processEvent({
+ *   nativeEventName: 'tool.execute.before',
+ *   payload: { toolName: 'Bash', command: 'ls' },
+ * });
+ * ```
+ */
+import { type HooksEngine } from '@a5c-ai/hooks-adapter-core';
+/**
+ * Create a pre-configured hooks engine for the OpenCode 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 OpenCode adapter.
+ *
+ * Creates a pre-configured HooksEngine wired to the OpenCode adapter's
+ * capabilities and phase mappings, ready for in-process hook execution.
+ *
+ * Usage:
+ * ```typescript
+ * import { createConfiguredEngine } from '@a5c-ai/hooks-adapter-opencode';
+ *
+ * const engine = createConfiguredEngine();
+ *
+ * engine.registerHandler({
+ *   id: 'my-handler',
+ *   pluginId: 'my-plugin',
+ *   phase: 'tool.before',
+ *   priority: 10,
+ *   handler: async (event) => ({
+ *     decision: 'allow',
+ *   }),
+ * });
+ *
+ * const result = await engine.processEvent({
+ *   nativeEventName: 'tool.execute.before',
+ *   payload: { toolName: 'Bash', command: 'ls' },
+ * });
+ * ```
+ */
+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 OpenCode 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.OPENCODE_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,17 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-adapter-core';
+export declare const OPENCODE_PHASE_MAPPINGS: PhaseMapping[];
+/**
+ * The shell.env event is a special env-injection hook, not a standard
+ * lifecycle phase. We track it separately so the normalizer can handle
+ * it without conflating it with session.start.
+ */
+export declare const SHELL_ENV_NATIVE_HOOK = "shell.env";
+/**
+ * Look up the phase mapping for a given OpenCode native event name.
+ */
+export declare function getOpenCodePhaseMapping(nativeEventName: string): PhaseMapping | undefined;
+/**
+ * Get all canonical phases supported by the OpenCode 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;AAsD/D,eAAO,MAAM,uBAAuB,EAAE,YAAY,EAAuB,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAEjD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEzF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/mappings.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHELL_ENV_NATIVE_HOOK = exports.OPENCODE_PHASE_MAPPINGS = void 0;
+exports.getOpenCodePhaseMapping = getOpenCodePhaseMapping;
+exports.getSupportedPhases = getSupportedPhases;
+const catalog_1 = require("@a5c-ai/atlas/catalog");
+/**
+ * OpenCode 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.8.
+ */
+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'),
+    };
+}
+/** Native hooks excluded from the standard phase mapping table. */
+const EXCLUDED_NATIVE_HOOKS = new Set(['shell.env']);
+function buildFromCatalog() {
+    const mappings = (0, catalog_1.listHookMappingsByAdapterFamily)('opencode');
+    if (mappings.length === 0) {
+        throw new Error('hooks-adapter adapter-opencode: catalog unavailable or returned no mappings for family "opencode"');
+    }
+    const phaseMappings = mappings
+        .map(hookMappingToPhaseMapping)
+        .filter((m) => m !== null)
+        .filter((m) => !EXCLUDED_NATIVE_HOOKS.has(m.nativeHook));
+    const seen = new Set();
+    return phaseMappings.filter((m) => {
+        if (seen.has(m.nativeHook))
+            return false;
+        seen.add(m.nativeHook);
+        return true;
+    });
+}
+exports.OPENCODE_PHASE_MAPPINGS = buildFromCatalog();
+/**
+ * The shell.env event is a special env-injection hook, not a standard
+ * lifecycle phase. We track it separately so the normalizer can handle
+ * it without conflating it with session.start.
+ */
+exports.SHELL_ENV_NATIVE_HOOK = 'shell.env';
+/**
+ * Look up the phase mapping for a given OpenCode native event name.
+ */
+function getOpenCodePhaseMapping(nativeEventName) {
+    return exports.OPENCODE_PHASE_MAPPINGS.find((m) => m.nativeHook === nativeEventName);
+}
+/**
+ * Get all canonical phases supported by the OpenCode adapter.
+ */
+function getSupportedPhases() {
+    return [...new Set(exports.OPENCODE_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":";;;AAkEA,0DAEC;AAKD,gDAEC;AA1ED,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;KAC7D,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAErD,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;SAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3D,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;;;;GAIG;AACU,QAAA,qBAAqB,GAAG,WAAW,CAAC;AAEjD;;GAEG;AACH,SAAgB,uBAAuB,CAAC,eAAuB;IAC7D,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,CAAC,GAAG,IAAI,GAAG,CAAC,+BAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/normalizer.d.ts

@@ -0,0 +1,72 @@
+import type { UnifiedHookEvent, UnifiedExecutionContext } from '@a5c-ai/hooks-adapter-core';
+/** The default adapter name. */
+export declare const ADAPTER_NAME = "opencode";
+/** Override the adapter name used in normalized events. */
+export declare function setAdapterName(name: string): void;
+/**
+ * OpenCode event payload shapes.
+ *
+ * OpenCode passes events programmatically as objects (in-process adapter).
+ */
+/** Common fields present across OpenCode hook events. */
+export interface OpenCodeEventBase {
+    /** Session identifier provided by OpenCode runtime. */
+    sessionId?: string;
+    /** Workspace or project directory. */
+    cwd?: string;
+    /** Model identifier. */
+    model?: string;
+    [key: string]: unknown;
+}
+/** session.created event payload. */
+export interface OpenCodeSessionCreatedPayload extends OpenCodeEventBase {
+    /** Initial user prompt if available. */
+    prompt?: string;
+}
+/** tool.execute.before event payload. */
+export interface OpenCodeToolExecuteBeforePayload extends OpenCodeEventBase {
+    /** Name of the tool being executed. */
+    toolName?: string;
+    /** Input arguments for the tool. */
+    toolInput?: unknown;
+    /** Tool call identifier. */
+    toolCallId?: string;
+}
+/** tool.execute.after event payload. */
+export interface OpenCodeToolExecuteAfterPayload extends OpenCodeEventBase {
+    /** Name of the tool that was executed. */
+    toolName?: string;
+    /** Input arguments for the tool. */
+    toolInput?: unknown;
+    /** Tool execution result. */
+    toolResult?: unknown;
+    /** Tool call identifier. */
+    toolCallId?: string;
+}
+/** shell.env event payload -- used for runtime env injection. */
+export interface OpenCodeShellEnvPayload extends OpenCodeEventBase {
+    /** Environment variables to inject into the runtime. */
+    env?: Record<string, string>;
+}
+/**
+ * Parse raw event input (string or object) into a structured object.
+ */
+export declare function parseEventData(raw: unknown): Record<string, unknown>;
+/**
+ * Build a UnifiedExecutionContext from an OpenCode event payload and environment.
+ */
+export declare function buildExecutionContext(eventData: Record<string, unknown>, nativeEventName: string, env: Record<string, string>): UnifiedExecutionContext;
+/**
+ * Build the payload portion of the unified event from OpenCode event data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+export declare function buildPayload(nativeEventName: string, eventData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Normalize an OpenCode event into a UnifiedHookEvent.
+ *
+ * @param nativeEventName - The OpenCode event name (e.g. 'session.created', 'tool.execute.before').
+ * @param rawEvent - Raw event content (string or object).
+ * @param env - Environment variables at invocation time.
+ */
+export declare function normalizeOpenCode(nativeEventName: string, rawEvent: unknown, env?: Record<string, string>): UnifiedHookEvent;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAI5F,gCAAgC;AAChC,eAAO,MAAM,YAAY,aAAa,CAAC;AAKvC,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qCAAqC;AACrC,MAAM,WAAW,6BAA8B,SAAQ,iBAAiB;IACtE,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,gCAAiC,SAAQ,iBAAiB;IACzE,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,+BAAgC,SAAQ,iBAAiB;IACxE,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,uBAAuB,CAgCzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCzB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,EACjB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,gBAAgB,CAqClB"}

package/dist/normalizer.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_NAME = void 0;
+exports.setAdapterName = setAdapterName;
+exports.parseEventData = parseEventData;
+exports.buildExecutionContext = buildExecutionContext;
+exports.buildPayload = buildPayload;
+exports.normalizeOpenCode = normalizeOpenCode;
+const mappings_1 = require("./mappings");
+const session_resolver_1 = require("./session-resolver");
+/** The default adapter name. */
+exports.ADAPTER_NAME = 'opencode';
+/** Mutable adapter name, defaulting to the opencode adapter identity. */
+let _adapterName = 'opencode';
+/** Override the adapter name used in normalized events. */
+function setAdapterName(name) {
+    _adapterName = name;
+}
+/**
+ * Parse raw event input (string or object) into a structured object.
+ */
+function parseEventData(raw) {
+    if (raw == null) {
+        return {};
+    }
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                return parsed;
+            }
+            return { raw: parsed };
+        }
+        catch {
+            return { raw };
+        }
+    }
+    if (typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    return { raw };
+}
+/**
+ * Build a UnifiedExecutionContext from an OpenCode event payload and environment.
+ */
+function buildExecutionContext(eventData, nativeEventName, env) {
+    const persistedEnv = {};
+    const contextVars = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (key.startsWith('HOOKS_PROXY_PERSIST_')) {
+            persistedEnv[key] = value;
+        }
+    }
+    const sessionId = (0, session_resolver_1.resolveSessionId)(eventData, env);
+    return {
+        sessionId,
+        turnId: env['HOOKS_PROXY_TURN_ID'] ?? null,
+        conversationId: env['HOOKS_PROXY_CONVERSATION_ID'] ?? null,
+        adapter: _adapterName,
+        cwd: eventData['cwd'] ?? env['PWD'] ?? null,
+        worktree: env['HOOKS_PROXY_WORKTREE'] ?? null,
+        transcriptPath: null,
+        source: null,
+        model: eventData['model'] ?? env['HOOKS_PROXY_MODEL'] ?? null,
+        agentType: null,
+        permissionMode: null,
+        toolName: eventData['toolName'] ?? null,
+        toolCallId: eventData['toolCallId'] ?? null,
+        nativeEventName,
+        rawEventScope: null,
+        persistedEnv,
+        contextVars,
+        metadata: {},
+    };
+}
+/**
+ * Build the payload portion of the unified event from OpenCode event data.
+ * Extracts event-specific fields into the normalized payload.
+ */
+function buildPayload(nativeEventName, eventData) {
+    const payload = {};
+    switch (nativeEventName) {
+        case 'session.created':
+            if (eventData['prompt'] != null)
+                payload.initialPrompt = eventData['prompt'];
+            break;
+        case 'tool.execute.before':
+            if (eventData['toolName'] != null)
+                payload.toolName = eventData['toolName'];
+            if (eventData['toolInput'] != null)
+                payload.toolInput = eventData['toolInput'];
+            if (eventData['toolCallId'] != null)
+                payload.toolCallId = eventData['toolCallId'];
+            break;
+        case 'tool.execute.after':
+            if (eventData['toolName'] != null)
+                payload.toolName = eventData['toolName'];
+            if (eventData['toolInput'] != null)
+                payload.toolInput = eventData['toolInput'];
+            if (eventData['toolResult'] != null)
+                payload.toolResponse = eventData['toolResult'];
+            if (eventData['toolCallId'] != null)
+                payload.toolCallId = eventData['toolCallId'];
+            break;
+        case mappings_1.SHELL_ENV_NATIVE_HOOK:
+            if (eventData['env'] != null)
+                payload.env = eventData['env'];
+            break;
+        default:
+            // Unknown event: pass through all non-common fields
+            for (const [key, value] of Object.entries(eventData)) {
+                if (!['sessionId', 'cwd', 'model'].includes(key)) {
+                    payload[key] = value;
+                }
+            }
+            break;
+    }
+    return payload;
+}
+/**
+ * Normalize an OpenCode event into a UnifiedHookEvent.
+ *
+ * @param nativeEventName - The OpenCode event name (e.g. 'session.created', 'tool.execute.before').
+ * @param rawEvent - Raw event content (string or object).
+ * @param env - Environment variables at invocation time.
+ */
+function normalizeOpenCode(nativeEventName, rawEvent, env = {}) {
+    const eventData = parseEventData(rawEvent);
+    const mapping = (0, mappings_1.getOpenCodePhaseMapping)(nativeEventName);
+    // shell.env is a special env-injection event; map to session.start (lossy)
+    const isShellEnv = nativeEventName === mappings_1.SHELL_ENV_NATIVE_HOOK;
+    const phase = isShellEnv ? 'session.start' : (mapping?.canonicalPhase ?? 'unknown');
+    const supportLevel = isShellEnv ? 'lossy' : (mapping?.supportLevel ?? 'unsupported');
+    const execution = buildExecutionContext(eventData, nativeEventName, env);
+    const payload = buildPayload(nativeEventName, eventData);
+    // Split env into input and persisted buckets
+    const inputEnv = {};
+    const persistedEnv = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (key.startsWith('HOOKS_PROXY_PERSIST_')) {
+            persistedEnv[key] = value;
+        }
+        else if (key.startsWith('HOOKS_PROXY_')) {
+            inputEnv[key] = value;
+        }
+    }
+    return {
+        version: 'a5c.hooks.v1',
+        adapter: _adapterName,
+        phase,
+        rawEventName: nativeEventName,
+        supportLevel,
+        execution,
+        payload,
+        env: {
+            input: inputEnv,
+            persisted: persistedEnv,
+        },
+        raw: rawEvent,
+    };
+}
+//# 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,48 @@
+import type { UnifiedHookResult } from '@a5c-ai/hooks-adapter-core';
+/**
+ * OpenCode native hook output formats.
+ *
+ * OpenCode is an in-process adapter; results are returned programmatically
+ * rather than via stdout.
+ */
+/** session.created hook output. */
+export interface OpenCodeSessionCreatedOutput {
+    /** Additional context to provide to the session. */
+    additionalContext?: string;
+    /** Environment variables to persist via shell.env. */
+    persistEnv?: Record<string, string>;
+}
+/** tool.execute.before hook output: permission and mutation. */
+export interface OpenCodeToolExecuteBeforeOutput {
+    /** Permission decision. */
+    decision?: 'allow' | 'deny';
+    /** Reason for the decision. */
+    reason?: string;
+    /** Mutated tool input (replaces original). */
+    toolInput?: unknown;
+    /** Additional context to inject. */
+    additionalContext?: string;
+    /** Environment variables to persist via shell.env. */
+    persistEnv?: Record<string, string>;
+}
+/** tool.execute.after hook output. */
+export interface OpenCodeToolExecuteAfterOutput {
+    /** Additional context to inject. */
+    additionalContext?: string;
+    /** Environment variables to persist via shell.env. */
+    persistEnv?: Record<string, string>;
+}
+/** shell.env hook output: env injection payload. */
+export interface OpenCodeShellEnvOutput {
+    /** Environment variables to inject into the runtime. */
+    env?: Record<string, string>;
+}
+/**
+ * Render a UnifiedHookResult back to OpenCode's native output format.
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original OpenCode event name.
+ * @returns The native output object.
+ */
+export declare function renderOpenCodeOutput(result: UnifiedHookResult, nativeEventName: string): Record<string, unknown>;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;GAKG;AAEH,mCAAmC;AACnC,MAAM,WAAW,4BAA4B;IAC3C,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,gEAAgE;AAChE,MAAM,WAAW,+BAA+B;IAC9C,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,sCAAsC;AACtC,MAAM,WAAW,8BAA8B;IAC7C,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/dist/renderer.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderOpenCodeOutput = renderOpenCodeOutput;
+/**
+ * Render a UnifiedHookResult back to OpenCode's native output format.
+ *
+ * @param result - The unified hook result from handler execution.
+ * @param nativeEventName - The original OpenCode event name.
+ * @returns The native output object.
+ */
+function renderOpenCodeOutput(result, nativeEventName) {
+    switch (nativeEventName) {
+        case 'session.created':
+            return renderSessionCreatedOutput(result);
+        case 'tool.execute.before':
+            return renderToolExecuteBeforeOutput(result);
+        case 'tool.execute.after':
+            return renderToolExecuteAfterOutput(result);
+        case 'shell.env':
+            return renderShellEnvOutput(result);
+        default:
+            return renderGenericOutput(result);
+    }
+}
+function renderSessionCreatedOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    if (result.persistEnv != null && Object.keys(result.persistEnv).length > 0) {
+        output.persistEnv = result.persistEnv;
+    }
+    return output;
+}
+function renderToolExecuteBeforeOutput(result) {
+    const output = {};
+    if (result.decision === 'allow') {
+        output.decision = 'allow';
+    }
+    else if (result.decision === 'deny') {
+        output.decision = 'deny';
+    }
+    // 'ask', 'continue', 'noop' produce no decision
+    if (result.reason != null) {
+        output.reason = result.reason;
+    }
+    // Tool input mutation
+    if (result.toolMutation?.value != null) {
+        output.toolInput = result.toolMutation.value;
+    }
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    if (result.persistEnv != null && Object.keys(result.persistEnv).length > 0) {
+        output.persistEnv = result.persistEnv;
+    }
+    return output;
+}
+function renderToolExecuteAfterOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    if (result.persistEnv != null && Object.keys(result.persistEnv).length > 0) {
+        output.persistEnv = result.persistEnv;
+    }
+    return output;
+}
+function renderShellEnvOutput(result) {
+    const output = {};
+    // The shell.env hook's primary purpose is env injection.
+    // Map persistEnv to the native env field.
+    if (result.persistEnv != null && Object.keys(result.persistEnv).length > 0) {
+        output.env = result.persistEnv;
+    }
+    return output;
+}
+function renderGenericOutput(result) {
+    const output = {};
+    if (result.additionalContext != null) {
+        output.additionalContext = result.additionalContext;
+    }
+    if (result.persistEnv != null && Object.keys(result.persistEnv).length > 0) {
+        output.persistEnv = result.persistEnv;
+    }
+    return output;
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

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

package/dist/session-resolver.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resolve a session ID for OpenCode.
+ *
+ * OpenCode provides a native session ID in the event payload.
+ * Resolution priority:
+ *
+ *   1. Explicit env: AGENT_SESSION_ID or HOOKS_PROXY_SESSION_ID
+ *   2. Native session ID from the event payload (`sessionId`)
+ *   3. OpenCode-specific env: OPENCODE_SESSION_ID
+ *   4. Derived from workspace (cwd) + a date-bucket fallback
+ *
+ * Spec section 9.2 -- session ID quality: 'native'.
+ */
+export declare function resolveSessionId(eventData: Record<string, unknown>, env: Record<string, string>): string | null;
+/**
+ * Derive a deterministic session ID from the workspace directory.
+ *
+ * Uses a 15-minute time bucket so that events within the same working
+ * session are grouped together, while separate launches in different
+ * time windows get different IDs.
+ */
+export declare function deriveSessionId(cwd: string): string;
+//# sourceMappingURL=session-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.d.ts","sourceRoot":"","sources":["../src/session-resolver.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,MAAM,GAAG,IAAI,CA0Bf;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/session-resolver.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = resolveSessionId;
+exports.deriveSessionId = deriveSessionId;
+const crypto = __importStar(require("crypto"));
+/**
+ * Resolve a session ID for OpenCode.
+ *
+ * OpenCode provides a native session ID in the event payload.
+ * Resolution priority:
+ *
+ *   1. Explicit env: AGENT_SESSION_ID or HOOKS_PROXY_SESSION_ID
+ *   2. Native session ID from the event payload (`sessionId`)
+ *   3. OpenCode-specific env: OPENCODE_SESSION_ID
+ *   4. Derived from workspace (cwd) + a date-bucket fallback
+ *
+ * Spec section 9.2 -- session ID quality: 'native'.
+ */
+function resolveSessionId(eventData, env) {
+    // 1. Explicit session ID from env (highest priority)
+    if (env['AGENT_SESSION_ID']) {
+        return env['AGENT_SESSION_ID'];
+    }
+    if (env['HOOKS_PROXY_SESSION_ID']) {
+        return env['HOOKS_PROXY_SESSION_ID'];
+    }
+    // 2. Native session ID from event payload
+    if (typeof eventData['sessionId'] === 'string' && eventData['sessionId']) {
+        return eventData['sessionId'];
+    }
+    // 3. OpenCode-specific env
+    if (env['OPENCODE_SESSION_ID']) {
+        return env['OPENCODE_SESSION_ID'];
+    }
+    // 4. Derive from workspace + date bucket
+    const cwd = eventData['cwd'] ?? env['PWD'] ?? null;
+    if (cwd != null) {
+        return deriveSessionId(cwd);
+    }
+    return null;
+}
+/**
+ * Derive a deterministic session ID from the workspace directory.
+ *
+ * Uses a 15-minute time bucket so that events within the same working
+ * session are grouped together, while separate launches in different
+ * time windows get different IDs.
+ */
+function deriveSessionId(cwd) {
+    const bucketMs = 15 * 60 * 1000; // 15 minutes
+    const timeBucket = Math.floor(Date.now() / bucketMs);
+    const input = `opencode:${cwd}:${timeBucket}`;
+    const hash = crypto.createHash('sha256').update(input).digest('hex').slice(0, 16);
+    return `opencode-derived-${hash}`;
+}
+//# 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,4CA6BC;AASD,0CAMC;AA3DD,+CAAiC;AAEjC;;;;;;;;;;;;GAYG;AACH,SAAgB,gBAAgB,CAC9B,SAAkC,EAClC,GAA2B;IAE3B,qDAAqD;IACrD,IAAI,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAClC,OAAO,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO,SAAS,CAAC,WAAW,CAAC,KAAK,QAAQ,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QACzE,OAAO,SAAS,CAAC,WAAW,CAAW,CAAC;IAC1C,CAAC;IAED,2BAA2B;IAC3B,IAAI,GAAG,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACpC,CAAC;IAED,yCAAyC;IACzC,MAAM,GAAG,GAAI,SAAS,CAAC,KAAK,CAAwB,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC3E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,YAAY,GAAG,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClF,OAAO,oBAAoB,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@a5c-ai/hooks-adapter-opencode",
+  "version": "5.1.1-staging.52898ebfc24f",
+  "description": "OpenCode 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-opencode"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/packages/adapters/hooks/adapter-opencode#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"
+  }
+}