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

package/README.md

@@ -0,0 +1,29 @@
+# @a5c-ai/hooks-adapter-copilot
+
+GitHub Copilot harness adapter for hooks-adapter.
+
+## Install
+
+```bash
+npm install @a5c-ai/hooks-adapter-copilot @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,
+  normalizeCopilotEvent,
+  renderCopilotOutput,
+} from "@a5c-ai/hooks-adapter-copilot";
+```
+
+The package exposes Copilot-specific normalization, phase mappings, rendering helpers, and session-resolution utilities for the hooks-adapter execution pipeline.
+
+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;AAiBtE,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAA6B,GAAG,mBAAmB,CAoBtF"}

package/dist/adapter.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+const catalog_1 = require("@a5c-ai/atlas/catalog");
+/**
+ * Creates the GitHub Copilot adapter with its capability metadata.
+ *
+ * Reads capability data from the Atlas graph via the agent-catalog.
+ * Falls back to hardcoded defaults if the catalog is unavailable.
+ *
+ * Key characteristics:
+ * - Shell-hook family (stdin JSON / stdout JSON)
+ * - Synthetic session ID (no stable native session ID exposed)
+ * - Pre-tool deny is the only blocking path
+ * - Session-start output is ignored by Copilot CLI
+ */
+const DEFAULT_ADAPTER_NAME = 'copilot';
+function createAdapter(name = DEFAULT_ADAPTER_NAME) {
+    const target = (0, catalog_1.getPluginTargetDescriptor)(name === 'copilot' ? 'github-copilot' : name);
+    return {
+        name,
+        family: target?.hooksMuxFamily ?? 'shell-hook',
+        sessionIdQuality: target?.sessionIdQuality ?? 'synthetic',
+        supportsOrderedFanout: target?.supportsOrderedFanout ?? true,
+        supportsNativeAdditionalContext: target?.supportsNativeAdditionalContext ?? false,
+        supportsBlock: target?.supportsBlock ?? true,
+        supportsAsk: target?.supportsAsk ?? false,
+        supportsToolInputMutation: target?.supportsToolInputMutation ?? false,
+        supportsToolResultMutation: target?.supportsToolResultMutation ?? false,
+        supportsPersistedEnv: target?.supportsPersistedEnv ?? false,
+        envPersistenceMode: target?.envPersistenceMode ?? 'wrapper_only',
+        toolInterceptionScope: target?.toolInterceptionScope ?? 'all',
+        notes: [
+            'session-start output ignored',
+            'only deny processed for permissionDecision',
+        ],
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":";;AAiBA,sCAoBC;AApCD,mDAAkE;AAElE;;;;;;;;;;;GAWG;AACH,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAEvC,SAAgB,aAAa,CAAC,OAAe,oBAAoB;IAC/D,MAAM,MAAM,GAAG,IAAA,mCAAyB,EAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvF,OAAO;QACL,IAAI;QACJ,MAAM,EAAG,MAAM,EAAE,cAAgD,IAAI,YAAY;QACjF,gBAAgB,EAAG,MAAM,EAAE,gBAA4D,IAAI,WAAW;QACtG,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,KAAK;QACrE,0BAA0B,EAAE,MAAM,EAAE,0BAA0B,IAAI,KAAK;QACvE,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,IAAI,KAAK;QAC3D,kBAAkB,EAAG,MAAM,EAAE,kBAAgE,IAAI,cAAc;QAC/G,qBAAqB,EAAG,MAAM,EAAE,qBAAsE,IAAI,KAAK;QAC/G,KAAK,EAAE;YACL,8BAA8B;YAC9B,4CAA4C;SAC7C;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createAdapter } from './adapter';
+export { COPILOT_PHASE_MAPPINGS, getMappingByNativeHook, getMappingByPhase } from './mappings';
+export { parseStdin, normalizeCopilotEvent, setAdapterName } from './normalizer';
+export type { CopilotRawInput } from './normalizer';
+export { renderCopilotOutput, serializeOutput } from './renderer';
+export type { CopilotPreToolOutput, CopilotNoopOutput, CopilotNativeOutput } from './renderer';
+export { resolveSyntheticSessionId } 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,sBAAsB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSyntheticSessionId = exports.serializeOutput = exports.renderCopilotOutput = exports.setAdapterName = exports.normalizeCopilotEvent = exports.parseStdin = exports.getMappingByPhase = exports.getMappingByNativeHook = exports.COPILOT_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, "COPILOT_PHASE_MAPPINGS", { enumerable: true, get: function () { return mappings_1.COPILOT_PHASE_MAPPINGS; } });
+Object.defineProperty(exports, "getMappingByNativeHook", { enumerable: true, get: function () { return mappings_1.getMappingByNativeHook; } });
+Object.defineProperty(exports, "getMappingByPhase", { enumerable: true, get: function () { return mappings_1.getMappingByPhase; } });
+var normalizer_1 = require("./normalizer");
+Object.defineProperty(exports, "parseStdin", { enumerable: true, get: function () { return normalizer_1.parseStdin; } });
+Object.defineProperty(exports, "normalizeCopilotEvent", { enumerable: true, get: function () { return normalizer_1.normalizeCopilotEvent; } });
+Object.defineProperty(exports, "setAdapterName", { enumerable: true, get: function () { return normalizer_1.setAdapterName; } });
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "renderCopilotOutput", { enumerable: true, get: function () { return renderer_1.renderCopilotOutput; } });
+Object.defineProperty(exports, "serializeOutput", { enumerable: true, get: function () { return renderer_1.serializeOutput; } });
+var session_resolver_1 = require("./session-resolver");
+Object.defineProperty(exports, "resolveSyntheticSessionId", { enumerable: true, get: function () { return session_resolver_1.resolveSyntheticSessionId; } });
+//# 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,uCAA+F;AAAtF,kHAAA,sBAAsB,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAC1E,2CAAiF;AAAxE,wGAAA,UAAU,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAAE,4GAAA,cAAc,OAAA;AAE1D,uCAAkE;AAAzD,+GAAA,mBAAmB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAE7C,uDAA+D;AAAtD,6HAAA,yBAAyB,OAAA"}

package/dist/mappings.d.ts

@@ -0,0 +1,11 @@
+import type { PhaseMapping } from '@a5c-ai/hooks-adapter-core';
+export declare const COPILOT_PHASE_MAPPINGS: PhaseMapping[];
+/**
+ * Lookup a phase mapping by native hook name.
+ */
+export declare function getMappingByNativeHook(nativeHook: string): PhaseMapping | undefined;
+/**
+ * Lookup a phase mapping by canonical phase.
+ */
+export declare function getMappingByPhase(phase: string): PhaseMapping | undefined;
+//# 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;AAgD/D,eAAO,MAAM,sBAAsB,EAAE,YAAY,EAAuB,CAAC;AAEzE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEzE"}

package/dist/mappings.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COPILOT_PHASE_MAPPINGS = void 0;
+exports.getMappingByNativeHook = getMappingByNativeHook;
+exports.getMappingByPhase = getMappingByPhase;
+const catalog_1 = require("@a5c-ai/atlas/catalog");
+/**
+ * Copilot native hook names mapped to canonical lifecycle phases.
+ *
+ * Phase mappings are built from the Atlas graph HookMapping records
+ * via the agent-catalog. Falls back to hardcoded defaults if the
+ * catalog is unavailable.
+ */
+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, catalog_1.listHookMappingsByAdapterFamily)('copilot');
+    if (mappings.length === 0) {
+        throw new Error('hooks-adapter adapter-copilot: catalog unavailable or returned no mappings for family "copilot"');
+    }
+    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.COPILOT_PHASE_MAPPINGS = buildFromCatalog();
+/**
+ * Lookup a phase mapping by native hook name.
+ */
+function getMappingByNativeHook(nativeHook) {
+    return exports.COPILOT_PHASE_MAPPINGS.find((m) => m.nativeHook === nativeHook);
+}
+/**
+ * Lookup a phase mapping by canonical phase.
+ */
+function getMappingByPhase(phase) {
+    return exports.COPILOT_PHASE_MAPPINGS.find((m) => m.canonicalPhase === phase);
+}
+//# sourceMappingURL=mappings.js.map

package/dist/mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.js","sourceRoot":"","sources":["../src/mappings.ts"],"names":[],"mappings":";;;AAqDA,wDAEC;AAKD,8CAEC;AA7DD,mDAAwE;AAGxE;;;;;;GAMG;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,yCAA+B,EAAC,SAAS,CAAC,CAAC;IAC5D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,iGAAiG,CAAC,CAAC;IACrH,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,sBAAsB,GAAmB,gBAAgB,EAAE,CAAC;AAEzE;;GAEG;AACH,SAAgB,sBAAsB,CAAC,UAAkB;IACvD,OAAO,8BAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,OAAO,8BAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC;AACxE,CAAC"}

package/dist/normalizer.d.ts

@@ -0,0 +1,48 @@
+import type { UnifiedHookEvent } from '@a5c-ai/hooks-adapter-core';
+/** The default adapter name. */
+export declare const ADAPTER_NAME = "copilot";
+/** Override the adapter name used in normalized events. */
+export declare function setAdapterName(name: string): void;
+/**
+ * Shape of raw Copilot stdin JSON for hook events.
+ *
+ * Copilot delivers JSON on stdin with at least these fields.
+ * Additional fields vary by event type.
+ */
+export interface CopilotRawInput {
+    /** The native hook event name (e.g. 'sessionStart', 'preToolUse'). */
+    event?: string;
+    /** Working directory at time of invocation. */
+    cwd?: string;
+    /** Workspace or project root path. */
+    workspace?: string;
+    /** User prompt text (on userPromptSubmitted). */
+    prompt?: string;
+    /** Tool name (on preToolUse / postToolUse). */
+    toolName?: string;
+    /** Tool call ID (on preToolUse / postToolUse). */
+    toolCallId?: string;
+    /** Tool input data (on preToolUse). */
+    toolInput?: unknown;
+    /** Tool response data (on postToolUse). */
+    toolResponse?: unknown;
+    /** Error message (on error events). */
+    error?: string;
+    /** Arbitrary additional fields. */
+    [key: string]: unknown;
+}
+/**
+ * Parse raw stdin string into a CopilotRawInput.
+ *
+ * Returns null if the input is empty or unparseable.
+ */
+export declare function parseStdin(raw: string): CopilotRawInput | null;
+/**
+ * Normalize a raw Copilot hook input into a UnifiedHookEvent.
+ *
+ * @param rawInput - Parsed JSON from stdin
+ * @param nativeEventName - The native event name (from stdin or CLI flag)
+ * @param env - Environment variables at invocation
+ */
+export declare function normalizeCopilotEvent(rawInput: CopilotRawInput, nativeEventName: string, 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,MAAM,4BAA4B,CAAC;AAKnE,gCAAgC;AAChC,eAAO,MAAM,YAAY,YAAY,CAAC;AAKtC,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAa9D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EACzB,eAAe,EAAE,MAAM,EACvB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,gBAAgB,CAmClB"}

package/dist/normalizer.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_NAME = void 0;
+exports.setAdapterName = setAdapterName;
+exports.parseStdin = parseStdin;
+exports.normalizeCopilotEvent = normalizeCopilotEvent;
+const hooks_adapter_core_1 = require("@a5c-ai/hooks-adapter-core");
+const mappings_1 = require("./mappings");
+const session_resolver_1 = require("./session-resolver");
+/** The default adapter name. */
+exports.ADAPTER_NAME = 'copilot';
+/** Mutable adapter name, defaulting to the Copilot adapter identity. */
+let _copilotAdapterName = 'copilot';
+/** Override the adapter name used in normalized events. */
+function setAdapterName(name) {
+    _copilotAdapterName = name;
+}
+/**
+ * Parse raw stdin string into a CopilotRawInput.
+ *
+ * Returns null if the input is empty or unparseable.
+ */
+function parseStdin(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Normalize a raw Copilot hook input into a UnifiedHookEvent.
+ *
+ * @param rawInput - Parsed JSON from stdin
+ * @param nativeEventName - The native event name (from stdin or CLI flag)
+ * @param env - Environment variables at invocation
+ */
+function normalizeCopilotEvent(rawInput, nativeEventName, env = {}) {
+    // Derive session ID: check env overrides, then synthesize from cwd/workspace
+    const sessionId = env['AGENT_SESSION_ID'] ??
+        env['HOOKS_PROXY_SESSION_ID'] ??
+        (0, session_resolver_1.resolveSyntheticSessionId)(rawInput.cwd, rawInput.workspace);
+    // Build enriched env with session context
+    const enrichedEnv = {
+        ...env,
+        HOOKS_PROXY_SESSION_ID: sessionId,
+    };
+    if (rawInput.cwd) {
+        enrichedEnv['HOOKS_PROXY_CWD'] = rawInput.cwd;
+    }
+    if (rawInput.toolName) {
+        enrichedEnv['HOOKS_PROXY_TOOL_NAME'] = rawInput.toolName;
+    }
+    if (rawInput.toolCallId) {
+        enrichedEnv['HOOKS_PROXY_TOOL_CALL_ID'] = rawInput.toolCallId;
+    }
+    // Build payload from raw input, preserving native detail
+    const payload = { ...rawInput };
+    // Remove the event field from payload since it's the event name
+    delete payload['event'];
+    return (0, hooks_adapter_core_1.normalizeEvent)({
+        adapter: _copilotAdapterName,
+        rawEventName: nativeEventName,
+        stdinPayload: payload,
+        env: enrichedEnv,
+        adapterMappings: mappings_1.COPILOT_PHASE_MAPPINGS,
+    });
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.js","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":";;;AAYA,wCAEC;AAoCD,gCAaC;AASD,sDAuCC;AA9GD,mEAA4D;AAC5D,yCAAoD;AACpD,yDAA+D;AAE/D,gCAAgC;AACnB,QAAA,YAAY,GAAG,SAAS,CAAC;AAEtC,wEAAwE;AACxE,IAAI,mBAAmB,GAAW,SAAS,CAAC;AAE5C,2DAA2D;AAC3D,SAAgB,cAAc,CAAC,IAAY;IACzC,mBAAmB,GAAG,IAAI,CAAC;AAC7B,CAAC;AA+BD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,MAAyB,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CACnC,QAAyB,EACzB,eAAuB,EACvB,MAA8B,EAAE;IAEhC,6EAA6E;IAC7E,MAAM,SAAS,GACb,GAAG,CAAC,kBAAkB,CAAC;QACvB,GAAG,CAAC,wBAAwB,CAAC;QAC7B,IAAA,4CAAyB,EAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE9D,0CAA0C;IAC1C,MAAM,WAAW,GAA2B;QAC1C,GAAG,GAAG;QACN,sBAAsB,EAAE,SAAS;KAClC,CAAC;IAEF,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjB,WAAW,CAAC,iBAAiB,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC;IAChD,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,WAAW,CAAC,uBAAuB,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC3D,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,WAAW,CAAC,0BAA0B,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC;IAChE,CAAC;IAED,yDAAyD;IACzD,MAAM,OAAO,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzD,gEAAgE;IAChE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAExB,OAAO,IAAA,mCAAc,EAAC;QACpB,OAAO,EAAE,mBAAmB;QAC5B,YAAY,EAAE,eAAe;QAC7B,YAAY,EAAE,OAAO;QACrB,GAAG,EAAE,WAAW;QAChB,eAAe,EAAE,iCAAsB;KACxC,CAAC,CAAC;AACL,CAAC"}

package/dist/renderer.d.ts

@@ -0,0 +1,37 @@
+import type { MergedExecutionResult } from '@a5c-ai/hooks-adapter-core';
+/**
+ * Copilot native output shape for pre-tool-use hooks.
+ *
+ * Only the preTool event actually processes output.
+ * permissionDecision supports allow|deny|ask in the schema,
+ * but only deny is currently processed by Copilot CLI.
+ */
+export interface CopilotPreToolOutput {
+    permissionDecision?: 'allow' | 'deny' | 'ask';
+    reason?: string;
+}
+/**
+ * Copilot native output shape for all other events.
+ * Output is ignored by Copilot CLI on non-preTool events,
+ * so we emit a minimal success object.
+ */
+export interface CopilotNoopOutput {
+    ok: true;
+}
+export type CopilotNativeOutput = CopilotPreToolOutput | CopilotNoopOutput;
+/**
+ * Render a merged execution result into Copilot-native JSON output.
+ *
+ * Copilot only processes output on preTool events (permissionDecision: deny).
+ * All other events get a no-op success response since their output is ignored.
+ *
+ * @param mergedResult - The merged result from hook handler execution
+ * @param nativeEventName - The original native event name
+ * @returns JSON-serializable native output
+ */
+export declare function renderCopilotOutput(mergedResult: MergedExecutionResult, nativeEventName: string): CopilotNativeOutput;
+/**
+ * Serialize Copilot native output to a stdout-ready JSON string.
+ */
+export declare function serializeOutput(output: CopilotNativeOutput): 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,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,IAAI,CAAC;CACV;AAED,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,iBAAiB,CAAC;AAE3E;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,qBAAqB,EACnC,eAAe,EAAE,MAAM,GACtB,mBAAmB,CAUrB;AAuBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAEnE"}

package/dist/renderer.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderCopilotOutput = renderCopilotOutput;
+exports.serializeOutput = serializeOutput;
+const mappings_1 = require("./mappings");
+/**
+ * Render a merged execution result into Copilot-native JSON output.
+ *
+ * Copilot only processes output on preTool events (permissionDecision: deny).
+ * All other events get a no-op success response since their output is ignored.
+ *
+ * @param mergedResult - The merged result from hook handler execution
+ * @param nativeEventName - The original native event name
+ * @returns JSON-serializable native output
+ */
+function renderCopilotOutput(mergedResult, nativeEventName) {
+    const mapping = (0, mappings_1.getMappingByNativeHook)(nativeEventName);
+    // Only preTool events can block
+    if (mapping?.blockCapability && nativeEventName === 'preToolUse') {
+        return renderPreToolOutput(mergedResult);
+    }
+    // All other events: output is ignored by Copilot
+    return { ok: true };
+}
+/**
+ * Render output for preTool events.
+ *
+ * Maps the unified decision to Copilot's permissionDecision field.
+ * Only 'deny' is actually processed by Copilot CLI.
+ */
+function renderPreToolOutput(mergedResult) {
+    const output = {};
+    if (mergedResult.decision === 'deny') {
+        output.permissionDecision = 'deny';
+        if (mergedResult.reason) {
+            output.reason = mergedResult.reason;
+        }
+    }
+    // allow and ask are in the schema but not processed;
+    // omit permissionDecision to let Copilot proceed with default behavior
+    return output;
+}
+/**
+ * Serialize Copilot native output to a stdout-ready JSON string.
+ */
+function serializeOutput(output) {
+    return JSON.stringify(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":";;AAoCA,kDAaC;AA0BD,0CAEC;AA5ED,yCAAoD;AAyBpD;;;;;;;;;GASG;AACH,SAAgB,mBAAmB,CACjC,YAAmC,EACnC,eAAuB;IAEvB,MAAM,OAAO,GAAG,IAAA,iCAAsB,EAAC,eAAe,CAAC,CAAC;IAExD,gCAAgC;IAChC,IAAI,OAAO,EAAE,eAAe,IAAI,eAAe,KAAK,YAAY,EAAE,CAAC;QACjE,OAAO,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED,iDAAiD;IACjD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,YAAmC;IAC9D,MAAM,MAAM,GAAyB,EAAE,CAAC;IAExC,IAAI,YAAY,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACrC,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC;QACnC,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QACtC,CAAC;IACH,CAAC;IACD,qDAAqD;IACrD,uEAAuE;IAEvE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAA2B;IACzD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/session-resolver.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Resolve a synthetic session ID for GitHub Copilot.
+ *
+ * Copilot CLI does not expose a stable native session ID.
+ * We derive a deterministic synthetic ID from cwd + workspace,
+ * producing a stable session key for a given project context.
+ *
+ * Derivation strategy:
+ * - Primary key: workspace path (if available), else cwd
+ * - Hashed with SHA-256 to produce a fixed-length, filesystem-safe ID
+ * - Prefixed with 'copilot-' for easy identification
+ *
+ * This means all sessions in the same workspace share context,
+ * which is acceptable since Copilot hooks are short-lived.
+ * The session store handles timestamp-based staleness if needed.
+ *
+ * @param cwd - Current working directory
+ * @param workspace - Workspace or project root path
+ * @returns A deterministic synthetic session ID string
+ */
+export declare function resolveSyntheticSessionId(cwd?: string, workspace?: 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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,CAAC,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAKR"}

package/dist/session-resolver.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSyntheticSessionId = resolveSyntheticSessionId;
+const crypto_1 = require("crypto");
+/**
+ * Resolve a synthetic session ID for GitHub Copilot.
+ *
+ * Copilot CLI does not expose a stable native session ID.
+ * We derive a deterministic synthetic ID from cwd + workspace,
+ * producing a stable session key for a given project context.
+ *
+ * Derivation strategy:
+ * - Primary key: workspace path (if available), else cwd
+ * - Hashed with SHA-256 to produce a fixed-length, filesystem-safe ID
+ * - Prefixed with 'copilot-' for easy identification
+ *
+ * This means all sessions in the same workspace share context,
+ * which is acceptable since Copilot hooks are short-lived.
+ * The session store handles timestamp-based staleness if needed.
+ *
+ * @param cwd - Current working directory
+ * @param workspace - Workspace or project root path
+ * @returns A deterministic synthetic session ID string
+ */
+function resolveSyntheticSessionId(cwd, workspace) {
+    const key = workspace ?? cwd ?? 'unknown';
+    const normalized = normalizePath(key);
+    const hash = (0, crypto_1.createHash)('sha256').update(`copilot:${normalized}`).digest('hex').slice(0, 16);
+    return `copilot-${hash}`;
+}
+/**
+ * Normalize a file path for consistent hashing across platforms.
+ * Lowercases on Windows-style paths and normalizes separators.
+ */
+function normalizePath(p) {
+    // Normalize backslashes to forward slashes
+    let normalized = p.replace(/\\/g, '/');
+    // Remove trailing slash
+    normalized = normalized.replace(/\/$/, '');
+    // Lowercase drive letter on Windows paths (e.g. C:/ -> c:/)
+    if (/^[A-Z]:\//.test(normalized)) {
+        normalized = normalized[0].toLowerCase() + normalized.slice(1);
+    }
+    return normalized;
+}
+//# 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":";;AAsBA,8DAQC;AA9BD,mCAAoC;AAEpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,yBAAyB,CACvC,GAAY,EACZ,SAAkB;IAElB,MAAM,GAAG,GAAG,SAAS,IAAI,GAAG,IAAI,SAAS,CAAC;IAC1C,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7F,OAAO,WAAW,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,CAAS;IAC9B,2CAA2C;IAC3C,IAAI,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,wBAAwB;IACxB,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3C,4DAA4D;IAC5D,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/package.json

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