@gaia-ai/plugin-claude 0.4.3 → 0.4.4

package/dist/src/footprint.d.ts

@@ -0,0 +1,12 @@
+import { type AgentFootprint } from '@gaia-ai/core';
+/**
+ * Parse a Claude-Code JSONL transcript into an agent footprint (GAIA-132).
+ *
+ * This is Claude's transcript format specifically — the transcript is one JSON
+ * object per line. Assistant turns carry a `message.usage` token breakdown and
+ * `message.content` blocks (text / tool_use); genuine user prompts are user
+ * messages whose `message.content` is a plain string (tool results come back
+ * as an array and are ignored). Blank or malformed lines are skipped — never
+ * throws.
+ */
+export declare function parseClaudeTranscript(jsonl: string): AgentFootprint;

package/dist/src/footprint.js

@@ -0,0 +1,69 @@
+import { emptyAgentFootprint } from '@gaia-ai/core';
+/** Token buckets summed into the total; each defaults to 0 when absent. */
+const TOKEN_KEYS = [
+    'input_tokens',
+    'output_tokens',
+    'cache_creation_input_tokens',
+    'cache_read_input_tokens',
+];
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+function countWords(text) {
+    const trimmed = text.trim();
+    return trimmed === '' ? 0 : trimmed.split(/\s+/).length;
+}
+/**
+ * Parse a Claude-Code JSONL transcript into an agent footprint (GAIA-132).
+ *
+ * This is Claude's transcript format specifically — the transcript is one JSON
+ * object per line. Assistant turns carry a `message.usage` token breakdown and
+ * `message.content` blocks (text / tool_use); genuine user prompts are user
+ * messages whose `message.content` is a plain string (tool results come back
+ * as an array and are ignored). Blank or malformed lines are skipped — never
+ * throws.
+ */
+export function parseClaudeTranscript(jsonl) {
+    const footprint = emptyAgentFootprint();
+    for (const raw of jsonl.split('\n')) {
+        const line = raw.trim();
+        if (line === '') {
+            continue;
+        }
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const message = entry.message;
+        if (!message || typeof message !== 'object') {
+            continue;
+        }
+        if (entry.type === 'assistant') {
+            footprint.agent_turns += 1;
+            const usage = message.usage ?? {};
+            for (const key of TOKEN_KEYS) {
+                footprint.tokens += num(usage[key]);
+            }
+            if (Array.isArray(message.content)) {
+                for (const block of message.content) {
+                    if (block &&
+                        typeof block === 'object' &&
+                        block.type === 'tool_use') {
+                        footprint.tool_calls += 1;
+                    }
+                }
+            }
+            if (typeof message.model === 'string') {
+                footprint.model = message.model;
+            }
+        }
+        else if (entry.type === 'user' && typeof message.content === 'string') {
+            footprint.user_prompts += 1;
+            footprint.user_prompt_words += countWords(message.content);
+        }
+    }
+    return footprint;
+}

package/dist/src/index.d.ts

@@ -1,4 +1,5 @@
-import { type AgentPlugin, type GaiaAgent } from '@gaia-ai/core';
+import { type AgentFootprint, type AgentPlugin, type GaiaAgent } from '@gaia-ai/core';
+export { parseClaudeTranscript } from './footprint.js';
 /**
  * Encode an absolute cwd the way Claude Code names its per-project transcript
  * directory under `~/.claude/projects/`: every non-alphanumeric char → `-`.
@@ -14,6 +15,7 @@ export declare class ClaudeAgent implements GaiaAgent {
     constructor(options: ClaudeAgentOptions, home?: string);
     launchCommand(prompt: string): string;
     getRunLog(worktreePath: string): Promise<string>;
+    parseFootprint(log: string): AgentFootprint;
 }
 /** Config-facing factory: `claudeAgent({ model: 'claude-opus-4-8' })`. */
 export declare function claudeAgent(options?: ClaudeAgentOptions): AgentPlugin;

package/dist/src/index.js

@@ -1,7 +1,9 @@
 import { readdir, readFile, stat } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
-import { shellQuote } from '@gaia-ai/core';
+import { shellQuote, } from '@gaia-ai/core';
+import { parseClaudeTranscript } from './footprint.js';
+export { parseClaudeTranscript } from './footprint.js';
 /**
  * Encode an absolute cwd the way Claude Code names its per-project transcript
  * directory under `~/.claude/projects/`: every non-alphanumeric char → `-`.
@@ -63,6 +65,9 @@ export class ClaudeAgent {
             return '';
         }
     }
+    parseFootprint(log) {
+        return parseClaudeTranscript(log);
+    }
 }
 /** Config-facing factory: `claudeAgent({ model: 'claude-opus-4-8' })`. */
 export function claudeAgent(options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaia-ai/plugin-claude",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "GAIA agent plugin for the Claude CLI.",
   "type": "module",
   "license": "MIT",
@@ -19,6 +19,6 @@
     "directory": "conductor/plugins/claude"
   },
   "peerDependencies": {
-    "@gaia-ai/core": "^0.4.3"
+    "@gaia-ai/core": "^0.4.4"
   }
 }