@cleocode/adapters 2026.3.68 → 2026.3.70

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

@@ -6,6 +6,8 @@
  * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
  *
  * @task T5240
+ * @task T144
+ * @epic T134
  */
 import type { AdapterHookProvider } from '@cleocode/contracts';
 /**
@@ -55,5 +57,19 @@ export declare class ClaudeCodeHookProvider implements AdapterHookProvider {
      * Get the full event mapping for introspection/debugging.
      */
     getEventMap(): Readonly<Record<string, string>>;
+    /**
+     * 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
+     */
+    getTranscript(_sessionId: string, _projectDir: string): Promise<string | null>;
 }
 //# sourceMappingURL=hooks.d.ts.map

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;;;;;;;;GAQG;AAEH,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;CAGhD"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.3.68",
+  "version": "2026.3.70",
   "description": "Unified provider adapters for CLEO (Claude Code, OpenCode, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -11,12 +11,8 @@
       "import": "./dist/index.js"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "build:check": "tsc --noEmit"
-  },
   "dependencies": {
-    "@cleocode/contracts": "workspace:*"
+    "@cleocode/contracts": "2026.3.70"
   },
   "license": "MIT",
   "engines": {
@@ -33,5 +29,9 @@
     "type": "git",
     "url": "https://github.com/kryptobaseddev/cleo",
     "directory": "packages/adapters"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:check": "tsc --noEmit"
   }
-}
+}

package/src/providers/claude-code/hooks.ts

@@ -6,8 +6,12 @@
  * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
  *
  * @task T5240
+ * @task T144
+ * @epic T134
  */
 
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
 import type { AdapterHookProvider } from '@cleocode/contracts';
 
 /**
@@ -82,4 +86,77 @@ export class ClaudeCodeHookProvider implements AdapterHookProvider {
   getEventMap(): Readonly<Record<string, string>> {
     return { ...CLAUDE_CODE_EVENT_MAP };
   }
+
+  /**
+   * 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: string, _projectDir: string): Promise<string | null> {
+    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: Array<{ path: string; mtime: number }> = [];
+      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: string[] = [];
+      for (const line of lines) {
+        try {
+          const entry = JSON.parse(line) as Record<string, unknown>;
+          const role = entry.role as string | undefined;
+          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;
+    }
+  }
 }