@gaia-ai/addon-claude 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 keytec GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @gaia-ai/addon-claude
+
+GAIA agent plugin for the Claude CLI.
+
+Part of the GAIA CLI. Install the meta package `@gaia-ai/gaia` to get the `gaia` CLI with all addons. Source: https://git.key-tec.de/keytec/gaia (gaia-cli/).

package/dist/src/footprint.d.ts

@@ -0,0 +1,17 @@
+import { type AgentFootprint } from '@gaia-ai/conductor/contract';
+/**
+ * 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.
+ *
+ * `duration_s` is the run's wall-clock length: the span between the first and
+ * last entry that carries a parseable `timestamp` (GAIA-151). This makes the
+ * transcript the single source of the run length — no `started_at` re-read, no
+ * JSON:API timestamp round-trip to mis-parse. Fewer than two timestamps → 0.
+ */
+export declare function parseClaudeTranscript(jsonl: string): AgentFootprint;

package/dist/src/footprint.js

@@ -0,0 +1,90 @@
+import { emptyAgentFootprint, } from '@gaia-ai/conductor/contract';
+/** 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.
+ *
+ * `duration_s` is the run's wall-clock length: the span between the first and
+ * last entry that carries a parseable `timestamp` (GAIA-151). This makes the
+ * transcript the single source of the run length — no `started_at` re-read, no
+ * JSON:API timestamp round-trip to mis-parse. Fewer than two timestamps → 0.
+ */
+export function parseClaudeTranscript(jsonl) {
+    const footprint = emptyAgentFootprint();
+    let minTs = Number.POSITIVE_INFINITY;
+    let maxTs = Number.NEGATIVE_INFINITY;
+    for (const raw of jsonl.split('\n')) {
+        const line = raw.trim();
+        if (line === '') {
+            continue;
+        }
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        // Track the run span across ANY timestamped entry (user, assistant,
+        // system, …) — not just the turns we meter for tokens.
+        if (typeof entry.timestamp === 'string') {
+            const ts = Date.parse(entry.timestamp);
+            if (Number.isFinite(ts)) {
+                if (ts < minTs)
+                    minTs = ts;
+                if (ts > maxTs)
+                    maxTs = ts;
+            }
+        }
+        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);
+        }
+    }
+    if (Number.isFinite(minTs) && Number.isFinite(maxTs) && maxTs > minTs) {
+        footprint.duration_s = Math.floor((maxTs - minTs) / 1000);
+    }
+    return footprint;
+}

package/dist/src/index.d.ts

@@ -0,0 +1,22 @@
+import type { AgentFootprint, AgentPlugin, GaiaAgent } from '@gaia-ai/conductor/contract';
+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 → `-`.
+ */
+export declare function encodeClaudeProjectDir(cwd: string): string;
+export interface ClaudeAgentOptions {
+    model?: string;
+}
+export declare class ClaudeAgent implements GaiaAgent {
+    private readonly options;
+    private readonly home;
+    readonly id = "claude";
+    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;
+export default claudeAgent;

package/dist/src/index.js

@@ -0,0 +1,88 @@
+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 { 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 → `-`.
+ */
+export function encodeClaudeProjectDir(cwd) {
+    return cwd.replace(/[^a-zA-Z0-9]/g, '-');
+}
+export class ClaudeAgent {
+    options;
+    home;
+    id = 'claude';
+    constructor(options, home = homedir()) {
+        this.options = options;
+        this.home = home;
+    }
+    launchCommand(prompt) {
+        if (prompt === '') {
+            return 'claude';
+        }
+        const parts = ['claude', shellQuote(prompt)];
+        if (this.options.model) {
+            parts.push('--model', this.options.model);
+        }
+        parts.push('--dangerously-skip-permissions');
+        return parts.join(' ');
+    }
+    async getRunLog(worktreePath) {
+        const dir = join(this.home, '.claude', 'projects', encodeClaudeProjectDir(worktreePath));
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch {
+            return '';
+        }
+        let latest = null;
+        for (const name of entries) {
+            if (!name.endsWith('.jsonl')) {
+                continue;
+            }
+            const full = join(dir, name);
+            try {
+                const s = await stat(full);
+                if (!latest || s.mtimeMs > latest.mtimeMs) {
+                    latest = { path: full, mtimeMs: s.mtimeMs };
+                }
+            }
+            catch {
+                // entry vanished between readdir and stat — skip.
+            }
+        }
+        if (!latest) {
+            return '';
+        }
+        try {
+            return await readFile(latest.path, 'utf8');
+        }
+        catch {
+            return '';
+        }
+    }
+    parseFootprint(log) {
+        return parseClaudeTranscript(log);
+    }
+}
+/** Config-facing factory: `claudeAgent({ model: 'claude-opus-4-8' })`. */
+export function claudeAgent(options = {}) {
+    const agent = new ClaudeAgent(options);
+    return {
+        kind: 'agent',
+        id: 'claude',
+        requiredModules: [],
+        async createAgent() {
+            return agent;
+        },
+    };
+}
+// Default export: this module also exports the `ClaudeAgent` class, so the
+// config resolver's auto-pick (no `export:`) sees 2 function exports and
+// would otherwise throw "specify export" — see conductor/src/config.ts
+// `loadNamedPlugin`. The default export makes the factory win.
+export default claudeAgent;

package/dist/src/preset.d.ts

@@ -0,0 +1,2 @@
+import type { Preset } from '@gaia-ai/conductor/contract';
+export declare const agents: Preset['agents'];

package/dist/src/preset.js

@@ -0,0 +1,5 @@
+import claudeAgent from './index.js';
+export const agents = (acc, opts) => [
+    ...acc,
+    { agent: claudeAgent(opts) },
+];

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@gaia-ai/addon-claude",
+  "version": "0.6.1",
+  "description": "GAIA agent plugin for the Claude CLI.",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": "./dist/src/index.js",
+    "./preset": "./dist/src/preset.js"
+  },
+  "files": [
+    "dist/src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.key-tec.de/keytec/gaia.git",
+    "directory": "gaia-cli/addons/claude"
+  },
+  "peerDependencies": {
+    "@gaia-ai/conductor": "^0.6.1",
+    "@gaia-ai/core": "^0.6.1"
+  }
+}