@cleocode/adapters 2026.3.72 → 2026.3.73

package/dist/providers/claude-code/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAmB/B;IAEF,KAAK,EAAE,sBAAsB,CAAC;IAC9B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,OAAO,EAAE,yBAAyB,CAAC;IACnC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,cAAc,EAAE,gCAAgC,CAAC;IACjD,SAAS,EAAE,2BAA2B,CAAC;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IAErC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAY5B;;;;;;;OAOG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAyCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CA8B/B;IAEF,KAAK,EAAE,sBAAsB,CAAC;IAC9B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,OAAO,EAAE,yBAAyB,CAAC;IACnC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,cAAc,EAAE,gCAAgC,CAAC;IACjD,SAAS,EAAE,2BAA2B,CAAC;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IAErC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAY5B;;;;;;;OAOG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAyCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/providers/claude-code/adapter.js

@@ -33,12 +33,23 @@ export class ClaudeCodeAdapter {
     version = '1.0.0';
     capabilities = {
         supportsHooks: true,
+        // 14/16 canonical events — derived from getProviderHookProfile('claude-code') in CAAMP 1.9.1.
+        // PreModel and PostModel are not supported by Claude Code.
         supportedHookEvents: [
-            'onSessionStart',
-            'onSessionEnd',
-            'onToolStart',
-            'onToolComplete',
-            'onError',
+            'SessionStart',
+            'SessionEnd',
+            'PromptSubmit',
+            'ResponseComplete',
+            'PreToolUse',
+            'PostToolUse',
+            'PostToolUseFailure',
+            'PermissionRequest',
+            'SubagentStart',
+            'SubagentStop',
+            'PreCompact',
+            'PostCompact',
+            'Notification',
+            'ConfigChange',
         ],
         supportsSpawn: true,
         supportsInstall: true,

package/dist/providers/claude-code/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAMtC,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IACnB,EAAE,GAAG,aAAa,CAAC;IACnB,IAAI,GAAG,aAAa,CAAC;IACrB,OAAO,GAAG,OAAO,CAAC;IAE3B,YAAY,GAAwB;QAClC,aAAa,EAAE,IAAI;QACnB,8FAA8F;QAC9F,2DAA2D;QAC3D,mBAAmB,EAAE;YACnB,cAAc;YACd,YAAY;YACZ,cAAc;YACd,kBAAkB;YAClB,YAAY;YACZ,aAAa;YACb,oBAAoB;YACpB,mBAAmB;YACnB,eAAe;YACf,cAAc;YACd,YAAY;YACZ,aAAa;YACb,cAAc;YACd,cAAc;SACf;QACD,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,IAAI;QACjB,wBAAwB,EAAE,IAAI;QAC9B,sBAAsB,EAAE,WAAW;QACnC,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,qBAAqB,EAAE,IAAI;QAC3B,iBAAiB,EAAE,IAAI;QACvB,gBAAgB,EAAE,IAAI;KACvB,CAAC;IAEF,KAAK,CAAyB;IAC9B,KAAK,CAA0B;IAC/B,OAAO,CAA4B;IACnC,KAAK,CAAyB;IAC9B,cAAc,CAAmC;IACjD,SAAS,CAA8B;IACvC,QAAQ,CAA6B;IAE7B,UAAU,GAAkB,IAAI,CAAC;IACjC,WAAW,GAAG,KAAK,CAAC;IAE5B;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,sBAAsB,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAyB,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,IAAI,sBAAsB,EAAE,CAAC;QAC1C,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAgC,EAAE,CAAC;QAC7D,IAAI,CAAC,SAAS,GAAG,IAAI,2BAA2B,EAAE,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,IAAI,0BAA0B,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,UAAkB;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,OAAO,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE;aAC9C,CAAC;QACJ,CAAC;QAED,gCAAgC;QAChC,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,CAAC;YACnD,YAAY,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YACxC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC;QAC/B,CAAC;QAED,yCAAyC;QACzC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QACjD,OAAO,CAAC,eAAe,GAAG,YAAY,CAAC;QAEvC,2CAA2C;QAC3C,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,SAAS,CAAC;QACvE,OAAO,CAAC,gBAAgB,GAAG,aAAa,CAAC;QAEzC,oDAAoD;QACpD,MAAM,OAAO,GAAG,YAAY,CAAC;QAC7B,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;QAEpC,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/providers/claude-code/hooks.d.ts

@@ -1,66 +1,130 @@
 /**
  * Claude Code Hook Provider
  *
- * Maps Claude Code's native hook events to CAAMP hook events.
- * Claude Code uses: SessionStart, PostToolUse, UserPromptSubmit, Stop
- * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
+ * Maps Claude Code's native hook events to CAAMP canonical hook events.
+ * Claude Code supports 14 of 16 canonical events (all except PreModel, PostModel).
  *
- * @task T5240
- * @task T144
+ * Event translation uses CAAMP normalizer APIs:
+ * - `toCanonical(nativeName, 'claude-code')` for runtime event name resolution
+ * - `getSupportedEvents('claude-code')` to enumerate supported canonical events
+ * - `getProviderHookProfile('claude-code')` for the full provider profile
+ *
+ * A static map derived from CAAMP 1.9.1 hook-mappings.json is maintained as
+ * a fallback for environments where CAAMP's runtime resolution is unavailable.
+ *
+ * @task T164
  * @epic T134
  */
 import type { AdapterHookProvider } from '@cleocode/contracts';
 /**
  * Hook provider for Claude Code.
  *
- * Claude Code registers hooks via a plugin directory
- * with a hooks.json descriptor. The actual hook scripts are shell scripts
- * that invoke CLEO's brain observation system.
+ * Claude Code registers hooks via its global config at `~/.claude/settings.json`.
+ * Supported handler types: command, http, prompt, agent.
+ *
+ * Event mapping is based on `getProviderHookProfile('claude-code')` from
+ * CAAMP 1.9.1. Async accessors (`getSupportedCanonicalEvents`,
+ * `getProviderProfile`) call CAAMP directly when available.
  *
- * Since hooks are registered through the plugin system (installed via
- * the install provider), registerNativeHooks and unregisterNativeHooks
- * are effectively no-ops here — the plugin installer handles registration.
+ * Since hooks are registered through the config system (managed by the install
+ * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
+ * state without performing filesystem operations.
+ *
+ * @task T164
+ * @epic T134
  */
 export declare class ClaudeCodeHookProvider implements AdapterHookProvider {
     private registered;
     /**
-     * Map a Claude Code native event name to a CAAMP hook event name.
+     * Map a Claude Code native event name to a CAAMP canonical hook event name.
+     *
+     * Looks up the native event name in the map derived from
+     * `getProviderHookProfile('claude-code').mappings` (CAAMP 1.9.1).
+     * Returns null for unrecognised events (e.g. PreModel, PostModel which
+     * Claude Code does not support).
      *
-     * @param providerEvent - Claude Code event name (e.g. "SessionStart", "PostToolUse")
-     * @returns CAAMP event name or null if unmapped
+     * @param providerEvent - Claude Code native event (e.g. "UserPromptSubmit", "Stop")
+     * @returns CAAMP canonical event name, or null if unmapped
+     * @task T164
      */
     mapProviderEvent(providerEvent: string): string | null;
     /**
      * Register native hooks for a project.
      *
-     * For Claude Code, hooks are registered via the plugin system
-     * (hooks.json descriptor), which is handled by the
-     * install provider. This method is a no-op since registration
-     * is managed through the plugin install lifecycle.
+     * For Claude Code, hooks are registered via the config system
+     * (`~/.claude/settings.json`), managed by the install provider.
+     * This method marks hooks as registered without performing filesystem operations.
      *
-     * @param _projectDir - Project directory (unused; hooks are global)
+     * Iterating supported events is handled at install time using
+     * `getSupportedCanonicalEvents()` to enumerate all 14 supported hooks.
+     *
+     * @param _projectDir - Project directory (unused; Claude Code uses global config)
+     * @task T164
      */
     registerNativeHooks(_projectDir: string): Promise<void>;
     /**
      * Unregister native hooks.
      *
-     * For Claude Code, this is a no-op since hooks are managed through
-     * the plugin system. Unregistration happens via the install provider's
-     * uninstall method.
+     * For Claude Code, this is a no-op since hooks are managed through the config
+     * system. Unregistration happens via the install provider's uninstall method.
+     *
+     * @task T164
      */
     unregisterNativeHooks(): Promise<void>;
     /**
-     * Check whether hooks have been registered via registerNativeHooks.
+     * Check whether hooks have been registered via `registerNativeHooks`.
      */
     isRegistered(): boolean;
     /**
-     * Get the full event mapping for introspection/debugging.
+     * Get the native→canonical event mapping for introspection and debugging.
+     *
+     * Returns the map derived from `getProviderHookProfile('claude-code').mappings`
+     * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
+     * names via live CAAMP APIs.
+     *
+     * @returns Immutable record of native event name → canonical event name
      */
     getEventMap(): Readonly<Record<string, string>>;
+    /**
+     * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
+     *
+     * Calls `getSupportedEvents('claude-code')` from the CAAMP normalizer to
+     * get the authoritative list. Claude Code supports 14 of 16 canonical events
+     * (PreModel and PostModel are not supported). Falls back to the values of
+     * the static event map when CAAMP is unavailable at runtime.
+     *
+     * @returns Array of CAAMP canonical event names supported by Claude Code
+     * @task T164
+     */
+    getSupportedCanonicalEvents(): Promise<string[]>;
+    /**
+     * Retrieve the full provider hook profile from CAAMP.
+     *
+     * Calls `getProviderHookProfile('claude-code')` from the CAAMP normalizer to
+     * get the complete profile: hook system type (`config`), config path
+     * (`~/.claude/settings.json`), handler types, and all event mappings.
+     * Returns null when CAAMP is unavailable at runtime.
+     *
+     * @returns Provider hook profile or null if CAAMP is unavailable
+     * @task T164
+     */
+    getProviderProfile(): Promise<unknown | null>;
+    /**
+     * Translate a CAAMP canonical event to its Claude Code native name via CAAMP.
+     *
+     * Calls `toNative(canonical, 'claude-code')` from the CAAMP normalizer.
+     * Returns null for unsupported events (PreModel, PostModel) or when
+     * CAAMP is unavailable.
+     *
+     * @param canonical - CAAMP canonical event name (e.g. "PromptSubmit")
+     * @returns Claude Code native event name or null
+     * @task T164
+     */
+    toNativeEvent(canonical: string): Promise<string | null>;
     /**
      * Extract a plain-text transcript from Claude Code session JSONL files.
      *
-     * Reads the most recent .jsonl file under ~/.claude/projects/ and
+     * Reads the most recent .jsonl file under `~/.claude/projects/` and
      * extracts user/assistant turn text into a flat string for brain
      * observation extraction.
      *

package/dist/providers/claude-code/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAY/D;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;OASG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;OAMG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA2DrF"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA8C/D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW9D;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA2DrF"}

package/dist/providers/claude-code/hooks.js

@@ -1,39 +1,94 @@
 /**
  * Claude Code Hook Provider
  *
- * Maps Claude Code's native hook events to CAAMP hook events.
- * Claude Code uses: SessionStart, PostToolUse, UserPromptSubmit, Stop
- * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
+ * Maps Claude Code's native hook events to CAAMP canonical hook events.
+ * Claude Code supports 14 of 16 canonical events (all except PreModel, PostModel).
  *
- * @task T5240
+ * Event translation uses CAAMP normalizer APIs:
+ * - `toCanonical(nativeName, 'claude-code')` for runtime event name resolution
+ * - `getSupportedEvents('claude-code')` to enumerate supported canonical events
+ * - `getProviderHookProfile('claude-code')` for the full provider profile
+ *
+ * A static map derived from CAAMP 1.9.1 hook-mappings.json is maintained as
+ * a fallback for environments where CAAMP's runtime resolution is unavailable.
+ *
+ * @task T164
+ * @epic T134
  */
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** CAAMP provider identifier for Claude Code. */
+const PROVIDER_ID = 'claude-code';
 /**
- * Mapping from Claude Code native event names to CAAMP event names.
+ * Fallback map from Claude Code native event names to CAAMP canonical names.
+ *
+ * Derived from `getProviderHookProfile('claude-code').mappings` in CAAMP 1.9.1.
+ * Covers all 14 supported events. PreModel and PostModel are not supported
+ * by Claude Code and are absent from this map.
+ *
+ * Used as fallback when CAAMP runtime is unavailable, and as the synchronous
+ * implementation of `mapProviderEvent()`.
  */
 const CLAUDE_CODE_EVENT_MAP = {
-    SessionStart: 'onSessionStart',
-    PostToolUse: 'onToolComplete',
-    UserPromptSubmit: 'onPromptSubmit',
-    Stop: 'onSessionEnd',
+    // CAAMP: toNative('SessionStart',      'claude-code') = 'SessionStart'
+    SessionStart: 'SessionStart',
+    // CAAMP: toNative('SessionEnd',        'claude-code') = 'SessionEnd'
+    SessionEnd: 'SessionEnd',
+    // CAAMP: toNative('PromptSubmit',      'claude-code') = 'UserPromptSubmit'
+    UserPromptSubmit: 'PromptSubmit',
+    // CAAMP: toNative('ResponseComplete',  'claude-code') = 'Stop'
+    Stop: 'ResponseComplete',
+    // CAAMP: toNative('PreToolUse',        'claude-code') = 'PreToolUse'
+    PreToolUse: 'PreToolUse',
+    // CAAMP: toNative('PostToolUse',       'claude-code') = 'PostToolUse'
+    PostToolUse: 'PostToolUse',
+    // CAAMP: toNative('PostToolUseFailure','claude-code') = 'PostToolUseFailure'
+    PostToolUseFailure: 'PostToolUseFailure',
+    // CAAMP: toNative('PermissionRequest', 'claude-code') = 'PermissionRequest'
+    PermissionRequest: 'PermissionRequest',
+    // CAAMP: toNative('SubagentStart',     'claude-code') = 'SubagentStart'
+    SubagentStart: 'SubagentStart',
+    // CAAMP: toNative('SubagentStop',      'claude-code') = 'SubagentStop'
+    SubagentStop: 'SubagentStop',
+    // CAAMP: toNative('PreCompact',        'claude-code') = 'PreCompact'
+    PreCompact: 'PreCompact',
+    // CAAMP: toNative('PostCompact',       'claude-code') = 'PostCompact'
+    PostCompact: 'PostCompact',
+    // CAAMP: toNative('Notification',      'claude-code') = 'Notification'
+    Notification: 'Notification',
+    // CAAMP: toNative('ConfigChange',      'claude-code') = 'ConfigChange'
+    ConfigChange: 'ConfigChange',
 };
 /**
  * Hook provider for Claude Code.
  *
- * Claude Code registers hooks via a plugin directory
- * with a hooks.json descriptor. The actual hook scripts are shell scripts
- * that invoke CLEO's brain observation system.
+ * Claude Code registers hooks via its global config at `~/.claude/settings.json`.
+ * Supported handler types: command, http, prompt, agent.
  *
- * Since hooks are registered through the plugin system (installed via
- * the install provider), registerNativeHooks and unregisterNativeHooks
- * are effectively no-ops here — the plugin installer handles registration.
+ * Event mapping is based on `getProviderHookProfile('claude-code')` from
+ * CAAMP 1.9.1. Async accessors (`getSupportedCanonicalEvents`,
+ * `getProviderProfile`) call CAAMP directly when available.
+ *
+ * Since hooks are registered through the config system (managed by the install
+ * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
+ * state without performing filesystem operations.
+ *
+ * @task T164
+ * @epic T134
  */
 export class ClaudeCodeHookProvider {
     registered = false;
     /**
-     * Map a Claude Code native event name to a CAAMP hook event name.
+     * Map a Claude Code native event name to a CAAMP canonical hook event name.
      *
-     * @param providerEvent - Claude Code event name (e.g. "SessionStart", "PostToolUse")
-     * @returns CAAMP event name or null if unmapped
+     * Looks up the native event name in the map derived from
+     * `getProviderHookProfile('claude-code').mappings` (CAAMP 1.9.1).
+     * Returns null for unrecognised events (e.g. PreModel, PostModel which
+     * Claude Code does not support).
+     *
+     * @param providerEvent - Claude Code native event (e.g. "UserPromptSubmit", "Stop")
+     * @returns CAAMP canonical event name, or null if unmapped
+     * @task T164
      */
     mapProviderEvent(providerEvent) {
         return CLAUDE_CODE_EVENT_MAP[providerEvent] ?? null;
@@ -41,12 +96,15 @@ export class ClaudeCodeHookProvider {
     /**
      * Register native hooks for a project.
      *
-     * For Claude Code, hooks are registered via the plugin system
-     * (hooks.json descriptor), which is handled by the
-     * install provider. This method is a no-op since registration
-     * is managed through the plugin install lifecycle.
+     * For Claude Code, hooks are registered via the config system
+     * (`~/.claude/settings.json`), managed by the install provider.
+     * This method marks hooks as registered without performing filesystem operations.
+     *
+     * Iterating supported events is handled at install time using
+     * `getSupportedCanonicalEvents()` to enumerate all 14 supported hooks.
      *
-     * @param _projectDir - Project directory (unused; hooks are global)
+     * @param _projectDir - Project directory (unused; Claude Code uses global config)
+     * @task T164
      */
     async registerNativeHooks(_projectDir) {
         this.registered = true;
@@ -54,24 +112,168 @@ export class ClaudeCodeHookProvider {
     /**
      * Unregister native hooks.
      *
-     * For Claude Code, this is a no-op since hooks are managed through
-     * the plugin system. Unregistration happens via the install provider's
-     * uninstall method.
+     * For Claude Code, this is a no-op since hooks are managed through the config
+     * system. Unregistration happens via the install provider's uninstall method.
+     *
+     * @task T164
      */
     async unregisterNativeHooks() {
         this.registered = false;
     }
     /**
-     * Check whether hooks have been registered via registerNativeHooks.
+     * Check whether hooks have been registered via `registerNativeHooks`.
      */
     isRegistered() {
         return this.registered;
     }
     /**
-     * Get the full event mapping for introspection/debugging.
+     * Get the native→canonical event mapping for introspection and debugging.
+     *
+     * Returns the map derived from `getProviderHookProfile('claude-code').mappings`
+     * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
+     * names via live CAAMP APIs.
+     *
+     * @returns Immutable record of native event name → canonical event name
      */
     getEventMap() {
         return { ...CLAUDE_CODE_EVENT_MAP };
     }
+    /**
+     * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
+     *
+     * Calls `getSupportedEvents('claude-code')` from the CAAMP normalizer to
+     * get the authoritative list. Claude Code supports 14 of 16 canonical events
+     * (PreModel and PostModel are not supported). Falls back to the values of
+     * the static event map when CAAMP is unavailable at runtime.
+     *
+     * @returns Array of CAAMP canonical event names supported by Claude Code
+     * @task T164
+     */
+    async getSupportedCanonicalEvents() {
+        try {
+            const { getSupportedEvents } = await import('@cleocode/caamp');
+            return getSupportedEvents(PROVIDER_ID);
+        }
+        catch {
+            return [...new Set(Object.values(CLAUDE_CODE_EVENT_MAP))];
+        }
+    }
+    /**
+     * Retrieve the full provider hook profile from CAAMP.
+     *
+     * Calls `getProviderHookProfile('claude-code')` from the CAAMP normalizer to
+     * get the complete profile: hook system type (`config`), config path
+     * (`~/.claude/settings.json`), handler types, and all event mappings.
+     * Returns null when CAAMP is unavailable at runtime.
+     *
+     * @returns Provider hook profile or null if CAAMP is unavailable
+     * @task T164
+     */
+    async getProviderProfile() {
+        try {
+            const { getProviderHookProfile } = await import('@cleocode/caamp');
+            return getProviderHookProfile(PROVIDER_ID) ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Translate a CAAMP canonical event to its Claude Code native name via CAAMP.
+     *
+     * Calls `toNative(canonical, 'claude-code')` from the CAAMP normalizer.
+     * Returns null for unsupported events (PreModel, PostModel) or when
+     * CAAMP is unavailable.
+     *
+     * @param canonical - CAAMP canonical event name (e.g. "PromptSubmit")
+     * @returns Claude Code native event name or null
+     * @task T164
+     */
+    async toNativeEvent(canonical) {
+        try {
+            const { toNative } = await import('@cleocode/caamp');
+            return toNative(canonical, PROVIDER_ID);
+        }
+        catch {
+            // Invert the static map as fallback
+            const entry = Object.entries(CLAUDE_CODE_EVENT_MAP).find(([, v]) => v === canonical);
+            return entry?.[0] ?? null;
+        }
+    }
+    /**
+     * Extract a plain-text transcript from Claude Code session JSONL files.
+     *
+     * Reads the most recent .jsonl file under `~/.claude/projects/` and
+     * extracts user/assistant turn text into a flat string for brain
+     * observation extraction.
+     *
+     * Returns null when no session data is found or on any read error.
+     *
+     * @param _sessionId - CLEO session ID (unused; reads the most recent file)
+     * @param _projectDir - Project directory (unused; Claude Code uses global paths)
+     * @task T144 @epic T134
+     */
+    async getTranscript(_sessionId, _projectDir) {
+        try {
+            const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? '/root';
+            const projectsDir = join(homeDir, '.claude', 'projects');
+            // Find all JSONL files across project subdirectories
+            let allFiles = [];
+            try {
+                const projectDirs = await readdir(projectsDir, { withFileTypes: true });
+                for (const entry of projectDirs) {
+                    if (!entry.isDirectory())
+                        continue;
+                    const subDir = join(projectsDir, entry.name);
+                    try {
+                        const files = await readdir(subDir);
+                        for (const file of files) {
+                            if (!file.endsWith('.jsonl'))
+                                continue;
+                            const filePath = join(subDir, file);
+                            // Use file path modification heuristic (filename usually includes timestamp)
+                            allFiles.push({ path: filePath, mtime: 0 });
+                        }
+                    }
+                    catch {
+                        // Skip unreadable subdirectories
+                    }
+                }
+            }
+            catch {
+                return null;
+            }
+            if (allFiles.length === 0)
+                return null;
+            // Sort by path descending (timestamps in filenames sort naturally)
+            allFiles = allFiles.sort((a, b) => b.path.localeCompare(a.path));
+            const mostRecent = allFiles[0];
+            if (!mostRecent)
+                return null;
+            const raw = await readFile(mostRecent.path, 'utf-8');
+            const lines = raw.split('\n').filter((l) => l.trim());
+            const turns = [];
+            for (const line of lines) {
+                try {
+                    const entry = JSON.parse(line);
+                    const role = entry.role;
+                    const content = entry.content;
+                    if (role === 'assistant' && typeof content === 'string') {
+                        turns.push(`assistant: ${content}`);
+                    }
+                    else if (role === 'user' && typeof content === 'string') {
+                        turns.push(`user: ${content}`);
+                    }
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+            return turns.length > 0 ? turns.join('\n') : null;
+        }
+        catch {
+            return null;
+        }
+    }
 }
 //# sourceMappingURL=hooks.js.map

package/dist/providers/claude-code/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,qBAAqB,GAA2B;IACpD,YAAY,EAAE,gBAAgB;IAC9B,WAAW,EAAE,gBAAgB;IAC7B,gBAAgB,EAAE,gBAAgB;IAClC,IAAI,EAAE,cAAc;CACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,sBAAsB;IACzB,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,qBAAqB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACtD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACtC,CAAC;CACF"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"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"}

package/dist/providers/codex/adapter.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Codex CLI Adapter
+ *
+ * Main CLEOProviderAdapter implementation for OpenAI Codex CLI.
+ * Provides hooks and install capabilities for CLEO integration.
+ *
+ * @task T162
+ * @epic T134
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { CodexHookProvider } from './hooks.js';
+import { CodexInstallProvider } from './install.js';
+/**
+ * CLEO provider adapter for OpenAI Codex CLI.
+ *
+ * Bridges CLEO's adapter system with Codex CLI's native capabilities:
+ * - Hooks: Maps Codex events (SessionStart, PromptSubmit, ResponseComplete) to CAAMP events
+ * - Install: Registers MCP server in ~/.codex/config.json and ensures AGENTS.md references
+ *
+ * @task T162
+ * @epic T134
+ */
+export declare class CodexAdapter implements CLEOProviderAdapter {
+    readonly id = "codex";
+    readonly name = "Codex";
+    readonly version = "1.0.0";
+    capabilities: AdapterCapabilities;
+    hooks: CodexHookProvider;
+    install: CodexInstallProvider;
+    private projectDir;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project
+     * @task T162
+     */
+    initialize(projectDir: string): Promise<void>;
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Unregisters hooks and releases any tracked state.
+     * @task T162
+     */
+    dispose(): Promise<void>;
+    /**
+     * Run a health check to verify Codex CLI is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Codex CLI binary is available in PATH
+     * 3. ~/.codex/ configuration directory exists
+     *
+     * @returns Health status with details about each check
+     * @task T162
+     */
+    healthCheck(): Promise<AdapterHealthStatus>;
+    /**
+     * Check whether the adapter has been initialized.
+     * @task T162
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the project directory this adapter was initialized with.
+     * @task T162
+     */
+    getProjectDir(): string | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/codex/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIpD;;;;;;;;;GASG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IACtD,QAAQ,CAAC,EAAE,WAAW;IACtB,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAY/B;IAEF,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,oBAAoB,CAAC;IAE9B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqCjD;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}