@eddacraft/kindling-adapter-claude-code 0.1.0

package/dist/claude-code/mapping.js

@@ -0,0 +1,234 @@
+/**
+ * Event to observation mapping for Claude Code
+ *
+ * Maps Claude Code hook events to Kindling observations with provenance.
+ */
+import { extractProvenance } from './provenance.js';
+import { filterContent, filterToolResult } from './filter.js';
+/**
+ * Mapping from tool names to observation kinds
+ */
+const TOOL_TO_KIND_MAP = {
+    // File operations -> file_diff
+    Write: 'file_diff',
+    Edit: 'file_diff',
+    // Shell commands -> command
+    Bash: 'command',
+    // Everything else -> tool_call
+    Read: 'tool_call',
+    Glob: 'tool_call',
+    Grep: 'tool_call',
+    Task: 'tool_call',
+    WebFetch: 'tool_call',
+    WebSearch: 'tool_call',
+    AskUserQuestion: 'tool_call',
+    Skill: 'tool_call',
+};
+/**
+ * Map a Claude Code event to a Kindling observation
+ */
+export function mapEvent(event) {
+    switch (event.type) {
+        case 'session_start':
+        case 'pre_compact':
+            // Session lifecycle handled separately
+            return { skip: true };
+        case 'post_tool_use':
+            return mapToolUseEvent(event);
+        case 'user_prompt':
+            return mapUserPromptEvent(event);
+        case 'subagent_stop':
+            return mapSubagentStopEvent(event);
+        case 'stop':
+            // Stop event triggers capsule close, handled separately
+            return { skip: true };
+        default:
+            return { error: `Unknown event type: ${event.type}` };
+    }
+}
+/**
+ * Map a tool use event to an observation
+ */
+function mapToolUseEvent(event) {
+    if (!event.toolName) {
+        return { error: 'Tool use event missing toolName' };
+    }
+    // Determine observation kind
+    const kind = TOOL_TO_KIND_MAP[event.toolName] ?? 'tool_call';
+    // Format content based on tool type
+    const content = formatToolContent(event);
+    // Extract provenance
+    const provenance = extractProvenance(event);
+    // Build scope IDs
+    const scopeIds = {
+        sessionId: event.sessionId,
+        repoId: event.cwd,
+    };
+    return {
+        observation: {
+            kind,
+            content,
+            provenance,
+            scopeIds,
+        },
+    };
+}
+/**
+ * Map a user prompt event to an observation
+ */
+function mapUserPromptEvent(event) {
+    if (!event.userContent) {
+        return { error: 'User prompt event missing content' };
+    }
+    const content = filterContent(event.userContent, { maxLength: 10000 });
+    const provenance = extractProvenance(event);
+    const scopeIds = {
+        sessionId: event.sessionId,
+        repoId: event.cwd,
+    };
+    return {
+        observation: {
+            kind: 'message',
+            content,
+            provenance,
+            scopeIds,
+        },
+    };
+}
+/**
+ * Map a subagent stop event to an observation
+ */
+function mapSubagentStopEvent(event) {
+    const content = formatSubagentContent(event);
+    const provenance = extractProvenance(event);
+    const scopeIds = {
+        sessionId: event.sessionId,
+        repoId: event.cwd,
+    };
+    return {
+        observation: {
+            kind: 'node_end',
+            content,
+            provenance,
+            scopeIds,
+        },
+    };
+}
+/**
+ * Format tool content for human readability
+ */
+function formatToolContent(event) {
+    const toolName = event.toolName ?? 'unknown';
+    const parts = [`Tool: ${toolName}`];
+    // Add tool-specific content
+    switch (toolName) {
+        case 'Read': {
+            const filePath = event.toolInput?.file_path;
+            if (filePath)
+                parts.push(`File: ${filePath}`);
+            break;
+        }
+        case 'Write': {
+            const filePath = event.toolInput?.file_path;
+            if (filePath)
+                parts.push(`File: ${filePath}`);
+            parts.push('Action: Created/overwrote file');
+            break;
+        }
+        case 'Edit': {
+            const filePath = event.toolInput?.file_path;
+            if (filePath)
+                parts.push(`File: ${filePath}`);
+            parts.push('Action: Edited file');
+            break;
+        }
+        case 'Bash': {
+            const command = event.toolInput?.command;
+            if (command)
+                parts.push(`$ ${command}`);
+            const resultStr = filterToolResult(toolName, event.toolResult);
+            if (resultStr)
+                parts.push(resultStr);
+            break;
+        }
+        case 'Glob': {
+            const pattern = event.toolInput?.pattern;
+            const path = event.toolInput?.path;
+            if (pattern)
+                parts.push(`Pattern: ${pattern}`);
+            if (path)
+                parts.push(`Path: ${path}`);
+            break;
+        }
+        case 'Grep': {
+            const pattern = event.toolInput?.pattern;
+            const path = event.toolInput?.path;
+            if (pattern)
+                parts.push(`Pattern: ${pattern}`);
+            if (path)
+                parts.push(`Path: ${path}`);
+            break;
+        }
+        case 'Task': {
+            const agentType = event.toolInput?.subagent_type;
+            const description = event.toolInput?.description;
+            if (agentType)
+                parts.push(`Agent: ${agentType}`);
+            if (description)
+                parts.push(`Task: ${description}`);
+            break;
+        }
+        case 'WebFetch': {
+            const url = event.toolInput?.url;
+            if (url)
+                parts.push(`URL: ${url}`);
+            break;
+        }
+        case 'WebSearch': {
+            const query = event.toolInput?.query;
+            if (query)
+                parts.push(`Query: ${query}`);
+            break;
+        }
+        default: {
+            // For unknown tools, show input keys
+            if (event.toolInput) {
+                const keys = Object.keys(event.toolInput).join(', ');
+                parts.push(`Input keys: ${keys}`);
+            }
+        }
+    }
+    // Add error if present
+    if (event.toolError) {
+        parts.push(`Error: ${event.toolError}`);
+    }
+    return parts.join('\n\n');
+}
+/**
+ * Format subagent content
+ */
+function formatSubagentContent(event) {
+    const parts = [`Subagent: ${event.agentType ?? 'unknown'}`];
+    if (event.agentOutput) {
+        const output = filterContent(event.agentOutput, { maxLength: 5000 });
+        parts.push(`Output:\n${output}`);
+    }
+    return parts.join('\n\n');
+}
+/**
+ * Batch map multiple events
+ */
+export function mapEvents(events) {
+    const observations = [];
+    for (const event of events) {
+        const result = mapEvent(event);
+        if (result.observation) {
+            observations.push(result.observation);
+        }
+        else if (result.error) {
+            console.warn(`Failed to map event: ${result.error}`, event);
+        }
+    }
+    return observations;
+}
+//# sourceMappingURL=mapping.js.map

package/dist/claude-code/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../src/claude-code/mapping.ts"],"names":[],"mappings":"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"}

package/dist/claude-code/provenance.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Provenance extraction for Claude Code events
+ *
+ * Extracts structured metadata from events for queryability and explainability.
+ */
+import type { ClaudeCodeEvent } from './events.js';
+/**
+ * Extract provenance from a tool use event
+ */
+export declare function extractToolUseProvenance(event: ClaudeCodeEvent): Record<string, unknown>;
+/**
+ * Extract provenance from a user prompt event
+ */
+export declare function extractUserPromptProvenance(event: ClaudeCodeEvent): Record<string, unknown>;
+/**
+ * Extract provenance from a subagent stop event
+ */
+export declare function extractSubagentProvenance(event: ClaudeCodeEvent): Record<string, unknown>;
+/**
+ * Extract provenance from a stop event
+ */
+export declare function extractStopProvenance(event: ClaudeCodeEvent): Record<string, unknown>;
+/**
+ * Extract provenance based on event type
+ */
+export declare function extractProvenance(event: ClaudeCodeEvent): Record<string, unknown>;
+//# sourceMappingURL=provenance.d.ts.map

package/dist/claude-code/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/claude-code/provenance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6DxF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS3F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQrF;AAuBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBjF"}

package/dist/claude-code/provenance.js

@@ -0,0 +1,134 @@
+/**
+ * Provenance extraction for Claude Code events
+ *
+ * Extracts structured metadata from events for queryability and explainability.
+ */
+/**
+ * Extract provenance from a tool use event
+ */
+export function extractToolUseProvenance(event) {
+    if (event.type !== 'post_tool_use') {
+        return {};
+    }
+    const provenance = {
+        toolName: event.toolName,
+        hasError: !!event.toolError,
+    };
+    // Extract tool-specific provenance
+    switch (event.toolName) {
+        case 'Read':
+            provenance.filePath = event.toolInput?.file_path;
+            break;
+        case 'Write':
+            provenance.filePath = event.toolInput?.file_path;
+            break;
+        case 'Edit':
+            provenance.filePath = event.toolInput?.file_path;
+            provenance.hasOldString = !!event.toolInput?.old_string;
+            break;
+        case 'Bash':
+            provenance.command = extractCommandName(event.toolInput?.command);
+            provenance.exitCode = extractExitCode(event.toolResult);
+            break;
+        case 'Glob':
+            provenance.pattern = event.toolInput?.pattern;
+            provenance.path = event.toolInput?.path;
+            break;
+        case 'Grep':
+            provenance.pattern = event.toolInput?.pattern;
+            provenance.path = event.toolInput?.path;
+            break;
+        case 'Task':
+            provenance.subagentType = event.toolInput?.subagent_type;
+            provenance.description = event.toolInput?.description;
+            break;
+        case 'WebFetch':
+            provenance.url = event.toolInput?.url;
+            break;
+        case 'WebSearch':
+            provenance.query = event.toolInput?.query;
+            break;
+        default:
+            // For unknown tools, include sanitized input keys
+            if (event.toolInput) {
+                provenance.inputKeys = Object.keys(event.toolInput);
+            }
+    }
+    return provenance;
+}
+/**
+ * Extract provenance from a user prompt event
+ */
+export function extractUserPromptProvenance(event) {
+    if (event.type !== 'user_prompt') {
+        return {};
+    }
+    return {
+        role: 'user',
+        length: event.userContent?.length ?? 0,
+    };
+}
+/**
+ * Extract provenance from a subagent stop event
+ */
+export function extractSubagentProvenance(event) {
+    if (event.type !== 'subagent_stop') {
+        return {};
+    }
+    return {
+        agentType: event.agentType,
+        hasOutput: !!event.agentOutput,
+        outputLength: event.agentOutput?.length ?? 0,
+    };
+}
+/**
+ * Extract provenance from a stop event
+ */
+export function extractStopProvenance(event) {
+    if (event.type !== 'stop') {
+        return {};
+    }
+    return {
+        reason: event.stopReason ?? 'unknown',
+    };
+}
+/**
+ * Extract the command name from a full command string
+ */
+function extractCommandName(command) {
+    if (!command)
+        return undefined;
+    const parts = command.trim().split(/\s+/);
+    return parts[0] || undefined;
+}
+/**
+ * Extract exit code from bash tool result
+ */
+function extractExitCode(result) {
+    if (typeof result === 'object' && result !== null) {
+        const r = result;
+        if (typeof r.exitCode === 'number')
+            return r.exitCode;
+        if (typeof r.exit_code === 'number')
+            return r.exit_code;
+    }
+    return undefined;
+}
+/**
+ * Extract provenance based on event type
+ */
+export function extractProvenance(event) {
+    switch (event.type) {
+        case 'post_tool_use':
+            return extractToolUseProvenance(event);
+        case 'user_prompt':
+            return extractUserPromptProvenance(event);
+        case 'subagent_stop':
+            return extractSubagentProvenance(event);
+        case 'stop':
+            return extractStopProvenance(event);
+        default:
+            return {};
+    }
+}
+//# sourceMappingURL=provenance.js.map

package/dist/claude-code/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../../src/claude-code/provenance.ts"],"names":[],"mappings":"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"}

package/dist/claude-code/session.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Claude Code session lifecycle management
+ *
+ * Manages the lifecycle of session capsules via hooks:
+ * - onSessionStart: Opens a new capsule
+ * - onEvent: Maps events and attaches observations
+ * - onStop: Closes the capsule
+ */
+import type { Capsule, CapsuleStore, Observation, ID } from '@eddacraft/kindling-core';
+import type { ClaudeCodeEvent } from './events.js';
+/**
+ * Session context tracking active session state
+ */
+export interface SessionContext {
+    sessionId: string;
+    cwd: string;
+    activeCapsuleId: ID;
+    eventCount: number;
+    startedAt: number;
+}
+/**
+ * Options for starting a session
+ */
+export interface SessionStartOptions {
+    sessionId: string;
+    cwd: string;
+    intent?: string;
+}
+/**
+ * Signals for ending a session
+ */
+export interface SessionEndSignals {
+    reason?: string;
+    summaryContent?: string;
+    summaryConfidence?: number;
+    evidenceRefs?: ID[];
+}
+/**
+ * Result of processing an event
+ */
+export interface EventProcessingResult {
+    observation?: Observation;
+    skipped?: boolean;
+    error?: string;
+}
+/**
+ * SessionManager manages Claude Code session lifecycles
+ *
+ * Provides hooks for session start, event processing, and session end.
+ * Each session gets its own capsule that collects observations.
+ */
+export declare class SessionManager {
+    private store;
+    private activeSessions;
+    constructor(store: CapsuleStore & {
+        insertObservation(observation: Observation): void;
+        attachObservationToCapsule(capsuleId: ID, observationId: ID): void;
+    });
+    /**
+     * Start a new session
+     *
+     * Opens a capsule for the session. If a session already has an open capsule,
+     * returns the existing context.
+     */
+    onSessionStart(options: SessionStartOptions): SessionContext;
+    /**
+     * Process an event from the session
+     *
+     * Maps the event to an observation and attaches it to the active capsule.
+     */
+    onEvent(event: ClaudeCodeEvent): EventProcessingResult;
+    /**
+     * End a session (called on Stop hook)
+     *
+     * Closes the active capsule for the session.
+     */
+    onStop(sessionId: string, signals?: SessionEndSignals): Capsule;
+    /**
+     * Get active session context
+     */
+    getSession(sessionId: string): SessionContext | undefined;
+    /**
+     * Check if session is active
+     */
+    isSessionActive(sessionId: string): boolean;
+    /**
+     * Get all active session IDs
+     */
+    getActiveSessions(): string[];
+    /**
+     * Get session statistics
+     */
+    getSessionStats(sessionId: string): {
+        eventCount: number;
+        duration: number;
+    } | undefined;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/claude-code/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/claude-code/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,KAAK;IAHf,OAAO,CAAC,cAAc,CAA0C;gBAGtD,KAAK,EAAE,YAAY,GAAG;QAC5B,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;QAClD,0BAA0B,CAAC,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,GAAG,IAAI,CAAC;KACpE;IAGH;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc;IAqD5D;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,qBAAqB;IA+CtD;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO;IA6C/D;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIzD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI3C;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;CASzF"}