@weavelogic/knowledge-graph-agent 0.8.8 → 0.10.0

package/dist/claude/hook-capture.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Hook Capture System
+ *
+ * Captures all Claude interactions (prompts, responses, tool calls)
+ * and stores them in the knowledge graph with hierarchical structure.
+ *
+ * @module claude/hook-capture
+ */
+import { SessionId, ClaudeSession, ClaudeConversation } from './types.js';
+/**
+ * Hook event types from Claude Code
+ */
+export type HookEventType = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'Stop' | 'PreCompact';
+/**
+ * Raw hook event data received from Claude Code
+ */
+export interface HookEventData {
+    event: HookEventType;
+    timestamp: string;
+    sessionId?: string;
+    toolName?: string;
+    toolInput?: Record<string, unknown>;
+    toolOutput?: string;
+    userPrompt?: string;
+    exitCode?: number;
+    duration?: number;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Capture configuration options
+ */
+export interface CaptureConfig {
+    /** Base directory for storing captured data */
+    storageDir: string;
+    /** Whether to store in knowledge graph format */
+    useKnowledgeGraph: boolean;
+    /** Whether to create markdown documents */
+    createMarkdown: boolean;
+    /** Whether to track tool outputs separately */
+    separateToolOutputs: boolean;
+    /** Maximum content length to store (truncates if exceeded) */
+    maxContentLength: number;
+    /** Whether to capture sub-agent spawns */
+    captureSubAgents: boolean;
+    /** Whether to capture swarm operations */
+    captureSwarms: boolean;
+    /** Whether to capture workflow executions */
+    captureWorkflows: boolean;
+    /** Tags to add to all captured items */
+    defaultTags: string[];
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_CAPTURE_CONFIG: CaptureConfig;
+/**
+ * Hook Capture System
+ *
+ * Manages the capture and storage of all Claude interactions.
+ */
+export declare class HookCaptureSystem {
+    private config;
+    private state;
+    private projectRoot;
+    constructor(projectRoot: string, config?: Partial<CaptureConfig>);
+    /**
+     * Ensure storage directory exists
+     */
+    private ensureStorageDir;
+    /**
+     * Create empty token usage
+     */
+    private createEmptyTokenUsage;
+    /**
+     * Create empty aggregated token usage
+     */
+    private createEmptyAggregatedTokenUsage;
+    /**
+     * Create base metadata
+     */
+    private createBaseMetadata;
+    /**
+     * Get current git branch
+     */
+    private getGitBranch;
+    /**
+     * Start a new session
+     */
+    startSession(name?: string, purpose?: string): ClaudeSession;
+    /**
+     * End the current session
+     */
+    endSession(): ClaudeSession | null;
+    /**
+     * Start a new conversation
+     */
+    startConversation(model?: string, systemPrompt?: string): ClaudeConversation;
+    /**
+     * Handle hook events
+     */
+    handleHookEvent(event: HookEventData): void;
+    /**
+     * Handle user prompt submission
+     */
+    private handleUserPrompt;
+    /**
+     * Handle pre-tool use event
+     */
+    private handlePreToolUse;
+    /**
+     * Handle post-tool use event
+     */
+    private handlePostToolUse;
+    /**
+     * Handle session stop event
+     */
+    private handleSessionStop;
+    /**
+     * Handle pre-compact event
+     */
+    private handlePreCompact;
+    /**
+     * Handle sub-agent spawn
+     */
+    private handleSubAgentSpawn;
+    /**
+     * Handle sub-agent completion
+     */
+    private handleSubAgentComplete;
+    /**
+     * Handle swarm operation
+     */
+    private handleSwarmOperation;
+    /**
+     * Categorize tool calls
+     */
+    private categorizeToolCall;
+    /**
+     * Aggregate session tokens
+     */
+    private aggregateSessionTokens;
+    /**
+     * Truncate content to max length
+     */
+    private truncateContent;
+    /**
+     * Get storage path for an entity
+     */
+    private getStoragePath;
+    /**
+     * Get markdown path for an entity
+     */
+    private getMarkdownPath;
+    /**
+     * Save session to storage
+     */
+    private saveSession;
+    /**
+     * Save session as markdown
+     */
+    private saveSessionMarkdown;
+    /**
+     * Save message to storage
+     */
+    private saveMessage;
+    /**
+     * Append message to conversation log
+     */
+    private appendToConversationLog;
+    /**
+     * Save tool call to storage
+     */
+    private saveToolCall;
+    /**
+     * Save sub-agent to storage
+     */
+    private saveSubAgent;
+    /**
+     * Save sub-agent as markdown
+     */
+    private saveSubAgentMarkdown;
+    /**
+     * Get current session
+     */
+    getCurrentSession(): ClaudeSession | null;
+    /**
+     * Get current conversation
+     */
+    getCurrentConversation(): ClaudeConversation | null;
+    /**
+     * Load session from storage
+     */
+    loadSession(sessionId: SessionId): ClaudeSession | null;
+    /**
+     * List all stored sessions
+     */
+    listSessions(): SessionId[];
+}
+/**
+ * Process hook event from stdin (for use as CLI hook)
+ */
+export declare function processHookEvent(projectRoot: string, eventType: HookEventType, config?: Partial<CaptureConfig>): Promise<void>;
+/**
+ * Generate Claude Code hook configuration
+ */
+export declare function generateHookConfig(projectRoot: string): Record<string, unknown>;
+export default HookCaptureSystem;
+//# sourceMappingURL=hook-capture.d.ts.map

package/dist/claude/hook-capture.d.ts.map

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