tarsk 0.4.4 → 0.4.6

package/dist/features/conversations/conversations.database.d.ts

@@ -1,108 +0,0 @@
-/**
- * SQLite Database Operations for Conversation History
- *
- * This module handles all operations for storing and retrieving conversation
- * history in the SQLite database.
- */
-import { ConversationMessage, ConversationHistory, AgentEvent, FileData } from "@tarsk/shared";
-import { Database } from "../../database/database.types";
-/**
- * Insert a new conversation message (incomplete)
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @param conversationId Conversation ID (groups messages into separate conversations)
- * @param message User message content
- * @param model Model used
- * @param attachments Optional file attachments
- * @param planMode Optional plan mode flag
- * @returns Message ID
- */
-export declare function insertMessage(db: Database, threadId: string, conversationId: string, message: string, model: string, attachments?: FileData[], planMode?: boolean): Promise<string>;
-/**
- * Update a conversation message with response data
- * @param db SQLite database instance
- * @param messageId Message ID
- * @param content Response content
- * @param events Events captured during execution
- * @throws Error if message not found
- */
-export declare function updateMessage(db: Database, messageId: string, content: string, events: AgentEvent[]): Promise<void>;
-/**
- * Get conversation history for a thread (all conversations)
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @returns ConversationHistory object or null if not found
- */
-export declare function getConversationHistory(db: Database, threadId: string): Promise<ConversationHistory | null>;
-export declare function getDeletedConversationHistory(db: Database, threadId: string): Promise<ConversationHistory | null>;
-/**
- * Get conversation history for a specific conversation within a thread
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @param conversationId Conversation ID
- * @returns ConversationHistory object or null if not found
- */
-export declare function getConversationHistoryByConversationId(db: Database, threadId: string, conversationId: string): Promise<ConversationHistory | null>;
-/**
- * Get the last N messages from conversation history for a specific conversation
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @param conversationId Conversation ID
- * @param count Number of messages to retrieve
- * @returns Array of conversation messages
- */
-export declare function getLastMessages(db: Database, threadId: string, conversationId: string, count?: number): Promise<ConversationMessage[]>;
-/**
- * Mark conversation history for a specific conversation as deleted
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @param conversationId Conversation ID
- */
-export declare function clearConversationHistory(db: Database, threadId: string, conversationId: string): Promise<void>;
-/**
- * Get message count for a thread
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @returns Number of messages
- */
-export declare function getMessageCount(db: Database, threadId: string): Promise<number>;
-/**
- * Check if a message exists
- * @param db SQLite database instance
- * @param messageId Message ID
- * @returns True if message exists
- */
-export declare function messageExists(db: Database, messageId: string): Promise<boolean>;
-/**
- * Mark a specific message as deleted
- * @param db SQLite database instance
- * @param messageId Message ID
- */
-export declare function deleteMessage(db: Database, messageId: string): Promise<void>;
-/**
- * Get total message count across all threads
- * @param db SQLite database instance
- * @returns Total number of messages
- */
-export declare function getTotalMessageCount(db: Database): Promise<number>;
-/**
- * Mark all conversation history for a specific thread as deleted
- * @param db SQLite database instance
- * @param threadId Thread ID
- */
-export declare function markConversationHistoryAsDeleted(db: Database, threadId: string): Promise<void>;
-/**
- * Mark all conversation history for a specific thread as deleted
- * @param db SQLite database instance
- * @param threadId Thread ID
- */
-export declare function deleteConversationHistoryForThread(db: Database, threadId: string): Promise<void>;
-/**
- * Get all unique conversation IDs for a thread
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @returns Array of conversation IDs
- */
-export declare function getConversationIds(db: Database, threadId: string): Promise<string[]>;
-export declare function getDeletedConversationIds(db: Database, threadId: string): Promise<string[]>;
-//# sourceMappingURL=conversations.database.d.ts.map

package/dist/features/conversations/conversations.database.js

@@ -1,373 +0,0 @@
-/**
- * SQLite Database Operations for Conversation History
- *
- * This module handles all operations for storing and retrieving conversation
- * history in the SQLite database.
- */
-import { randomUUID } from "crypto";
-/**
- * Insert a new conversation message (incomplete)
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @param conversationId Conversation ID (groups messages into separate conversations)
- * @param message User message content
- * @param model Model used
- * @param attachments Optional file attachments
- * @param planMode Optional plan mode flag
- * @returns Message ID
- */
-export async function insertMessage(db, threadId, conversationId, message, model, attachments, planMode) {
-    try {
-        const messageId = randomUUID();
-        const timestamp = new Date().toISOString();
-        await db.execute(`
-      INSERT INTO conversation_history (
-        id, threadId, conversationId, timestamp, status,
-        request_message, request_model, request_attachments, request_planMode
-      )
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `, [
-            messageId,
-            threadId,
-            conversationId,
-            timestamp,
-            "active",
-            message,
-            model,
-            attachments ? JSON.stringify(attachments) : null,
-            planMode ? 1 : 0,
-        ]);
-        return messageId;
-    }
-    catch (error) {
-        console.error("Failed to insert conversation message:", error);
-        throw error;
-    }
-}
-/**
- * Update a conversation message with response data
- * @param db SQLite database instance
- * @param messageId Message ID
- * @param content Response content
- * @param events Events captured during execution
- * @throws Error if message not found
- */
-export async function updateMessage(db, messageId, content, events) {
-    try {
-        const completedAt = new Date().toISOString();
-        // Calculate token usage from events.
-        // Prefer `message` events (from message_start) as the authoritative source for usage data.
-        // Only fall back to `toolcall_delta` events if no `message` events carry real usage,
-        // to avoid double-counting when both event types report the same API call's tokens.
-        let inputTokens = 0;
-        let outputTokens = 0;
-        const hasMessageUsage = events.some((e) => e.type === "message" &&
-            e.message?.usage &&
-            ((e.message?.usage?.input ?? 0) > 0 ||
-                (e.message?.usage?.output ?? 0) > 0 ||
-                (e.message?.usage?.cacheRead ?? 0) > 0 ||
-                (e.message?.usage?.cacheWrite ?? 0) > 0));
-        for (const event of events) {
-            if (hasMessageUsage) {
-                // Use message events as the single source of truth
-                if (event.type === "message" && event.message?.usage) {
-                    const usage = event.message.usage;
-                    inputTokens += usage.input ?? 0;
-                    outputTokens += usage.output ?? 0;
-                }
-            }
-            else {
-                // Fall back to toolcall_delta events if no message events have real usage
-                if (event.type === "toolcall_delta" && event.partial?.usage) {
-                    inputTokens += event.partial.usage.input ?? 0;
-                    outputTokens += event.partial.usage.output ?? 0;
-                }
-            }
-        }
-        // Fallback: Estimate output tokens from response content if no usage data was found
-        if (inputTokens === 0 && outputTokens === 0 && content) {
-            // Rough estimate: ~4 characters per token for English text.
-            // Only estimate output tokens from the response content; we cannot reliably
-            // derive input tokens here since the original request is not available.
-            outputTokens = Math.ceil(content.length / 4);
-        }
-        const result = await db.execute(`
-      UPDATE conversation_history
-      SET response_content = ?, response_events = ?, response_completedAt = ?, input_tokens = ?, output_tokens = ?
-      WHERE id = ?
-    `, [content, JSON.stringify(events), completedAt, inputTokens, outputTokens, messageId]);
-        // Check if any rows were actually updated
-        if (result.rowsAffected === 0) {
-            console.warn(`[updateMessage] No message found with ID: ${messageId}`);
-        }
-    }
-    catch (error) {
-        console.error("Failed to update conversation message:", error);
-        throw error;
-    }
-}
-/**
- * Get conversation history for a thread (all conversations)
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @returns ConversationHistory object or null if not found
- */
-export async function getConversationHistory(db, threadId) {
-    try {
-        const result = await db.execute(`
-      SELECT * FROM conversation_history
-      WHERE threadId = ?
-      ORDER BY timestamp ASC
-    `, [threadId]);
-        const rows = result.rows;
-        if (rows.length === 0) {
-            return null;
-        }
-        const messages = rows.map(deserializeMessage);
-        return {
-            threadId,
-            messages,
-            lastUpdated: messages.length > 0 ? messages[messages.length - 1].timestamp : new Date().toISOString(),
-        };
-    }
-    catch (error) {
-        console.error("Failed to get conversation history:", error);
-        throw error;
-    }
-}
-export async function getDeletedConversationHistory(db, threadId) {
-    try {
-        const result = await db.execute(`
-      SELECT * FROM conversation_history
-      WHERE threadId = ? AND status = ?
-      ORDER BY timestamp ASC
-    `, [threadId, "deleted"]);
-        const rows = result.rows;
-        if (rows.length === 0) {
-            return null;
-        }
-        const messages = rows.map(deserializeMessage);
-        return {
-            threadId,
-            messages,
-            lastUpdated: messages.length > 0 ? messages[messages.length - 1].timestamp : new Date().toISOString(),
-        };
-    }
-    catch (error) {
-        console.error("Failed to get deleted conversation history:", error);
-        throw error;
-    }
-}
-/**
- * Get conversation history for a specific conversation within a thread
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @param conversationId Conversation ID
- * @returns ConversationHistory object or null if not found
- */
-export async function getConversationHistoryByConversationId(db, threadId, conversationId) {
-    try {
-        const result = await db.execute(`
-      SELECT * FROM conversation_history
-      WHERE threadId = ? AND conversationId = ? AND status = ?
-      ORDER BY timestamp ASC
-    `, [threadId, conversationId, "active"]);
-        const rows = result.rows;
-        if (rows.length === 0) {
-            return null;
-        }
-        const messages = rows.map(deserializeMessage);
-        return {
-            threadId,
-            messages,
-            lastUpdated: messages.length > 0 ? messages[messages.length - 1].timestamp : new Date().toISOString(),
-        };
-    }
-    catch (error) {
-        console.error("Failed to get conversation history by conversation ID:", error);
-        throw error;
-    }
-}
-/**
- * Get the last N messages from conversation history for a specific conversation
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @param conversationId Conversation ID
- * @param count Number of messages to retrieve
- * @returns Array of conversation messages
- */
-export async function getLastMessages(db, threadId, conversationId, count = 1) {
-    try {
-        const result = await db.execute(`
-      SELECT * FROM conversation_history
-      WHERE threadId = ? AND conversationId = ? AND status = ?
-      ORDER BY timestamp DESC
-      LIMIT ?
-    `, [threadId, conversationId, "active", count]);
-        const rows = result.rows;
-        // Reverse to get chronological order
-        return rows.reverse().map(deserializeMessage);
-    }
-    catch (error) {
-        console.error("Failed to get last messages:", error);
-        throw error;
-    }
-}
-/**
- * Mark conversation history for a specific conversation as deleted
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @param conversationId Conversation ID
- */
-export async function clearConversationHistory(db, threadId, conversationId) {
-    try {
-        await db.execute("UPDATE conversation_history SET status = ? WHERE threadId = ? AND conversationId = ?", ["deleted", threadId, conversationId]);
-    }
-    catch (error) {
-        console.error("Failed to mark conversation history as deleted:", error);
-        throw error;
-    }
-}
-/**
- * Get message count for a thread
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @returns Number of messages
- */
-export async function getMessageCount(db, threadId) {
-    const result = await db.execute("SELECT COUNT(*) as count FROM conversation_history WHERE threadId = ? AND status = ?", [threadId, "active"]);
-    return result.rows[0].count;
-}
-/**
- * Check if a message exists
- * @param db SQLite database instance
- * @param messageId Message ID
- * @returns True if message exists
- */
-export async function messageExists(db, messageId) {
-    const result = await db.execute("SELECT 1 FROM conversation_history WHERE id = ? LIMIT 1", [
-        messageId,
-    ]);
-    return result.rows.length > 0;
-}
-/**
- * Deserialize a conversation message row from the database
- * @param row Database row
- * @returns ConversationMessage object
- */
-function deserializeMessage(row) {
-    return {
-        id: row.id,
-        timestamp: row.timestamp,
-        conversationId: row.conversationId,
-        status: row.status,
-        request: {
-            message: row.request_message,
-            model: row.request_model,
-            ...(row.request_attachments && { attachments: JSON.parse(row.request_attachments) }),
-            ...(row.request_planMode === 1 && { planMode: true }),
-        },
-        response: row.response_content
-            ? {
-                content: row.response_content,
-                events: row.response_events ? JSON.parse(row.response_events) : [],
-                completedAt: row.response_completedAt ?? "",
-            }
-            : null,
-        inputTokens: row.input_tokens,
-        outputTokens: row.output_tokens,
-    };
-}
-/**
- * Mark a specific message as deleted
- * @param db SQLite database instance
- * @param messageId Message ID
- */
-export async function deleteMessage(db, messageId) {
-    await db.execute("UPDATE conversation_history SET status = ? WHERE id = ?", [
-        "deleted",
-        messageId,
-    ]);
-}
-/**
- * Get total message count across all threads
- * @param db SQLite database instance
- * @returns Total number of messages
- */
-export async function getTotalMessageCount(db) {
-    const result = await db.execute("SELECT COUNT(*) as count FROM conversation_history");
-    return result.rows[0].count;
-}
-/**
- * Mark all conversation history for a specific thread as deleted
- * @param db SQLite database instance
- * @param threadId Thread ID
- */
-export async function markConversationHistoryAsDeleted(db, threadId) {
-    try {
-        await db.execute("UPDATE conversation_history SET status = ? WHERE threadId = ?", [
-            "deleted",
-            threadId,
-        ]);
-    }
-    catch (error) {
-        console.error("Failed to mark conversation history as deleted:", error);
-        throw error;
-    }
-}
-/**
- * Mark all conversation history for a specific thread as deleted
- * @param db SQLite database instance
- * @param threadId Thread ID
- */
-export async function deleteConversationHistoryForThread(db, threadId) {
-    try {
-        await db.execute("UPDATE conversation_history SET status = ? WHERE threadId = ?", [
-            "deleted",
-            threadId,
-        ]);
-    }
-    catch (error) {
-        console.error("Failed to mark conversation history as deleted for thread:", error);
-        throw error;
-    }
-}
-/**
- * Get all unique conversation IDs for a thread
- * @param db SQLite database instance
- * @param threadId Thread ID
- * @returns Array of conversation IDs
- */
-export async function getConversationIds(db, threadId) {
-    try {
-        const result = await db.execute(`
-      SELECT conversationId FROM conversation_history
-      WHERE threadId = ?
-      GROUP BY conversationId
-      ORDER BY conversationId DESC
-    `, [threadId]);
-        const rows = result.rows;
-        return rows.map((row) => row.conversationId);
-    }
-    catch (error) {
-        console.error("Failed to get conversation IDs:", error);
-        throw error;
-    }
-}
-export async function getDeletedConversationIds(db, threadId) {
-    try {
-        const result = await db.execute(`
-      SELECT conversationId FROM conversation_history
-      WHERE threadId = ? AND status = ?
-      GROUP BY conversationId
-      ORDER BY conversationId DESC
-    `, [threadId, "deleted"]);
-        const rows = result.rows;
-        return rows.map((row) => row.conversationId);
-    }
-    catch (error) {
-        console.error("Failed to get deleted conversation IDs:", error);
-        throw error;
-    }
-}
-//# sourceMappingURL=conversations.database.js.map

package/dist/features/conversations/conversations.manager.d.ts

@@ -1,130 +0,0 @@
-/**
- * ConversationManager handles conversation history storage and retrieval
- *
- * This manager is responsible for:
- * - Storing request/response pairs in SQLite database
- * - Retrieving conversation history for a thread
- * - Managing conversation persistence
- */
-import { ConversationHistory, ConversationMessage, AgentEvent, FileData } from "@tarsk/shared";
-/**
- * ConversationManager interface defines the contract for conversation operations
- */
-export interface ConversationManager {
-    /**
-     * Starts a new conversation message (request captured)
-     * @param threadId - The thread ID
-     * @param threadPath - The absolute path to the thread directory
-     * @param conversationId - The conversation ID (groups messages into separate conversations)
-     * @param message - The user's message
-     * @param model - The model being used
-     * @param attachments - Optional file attachments
-     * @param planMode - Optional plan mode flag
-     * @returns The message ID for this conversation
-     */
-    startMessage(threadId: string, threadPath: string, conversationId: string, message: string, model: string, attachments?: FileData[], planMode?: boolean): Promise<string>;
-    /**
-     * Completes a conversation message (response captured)
-     * @param messageId - The message ID to complete
-     * @param content - The complete response content
-     * @param events - All events captured during execution
-     */
-    completeMessage(messageId: string, content: string, events: AgentEvent[]): Promise<void>;
-    /**
-     * Gets the conversation history for a thread (all conversations)
-     * @param threadPath - The absolute path to the thread directory
-     * @returns The conversation history or null if not found
-     */
-    getConversationHistory(threadPath: string): Promise<ConversationHistory | null>;
-    /**
-     * Gets the conversation history for a specific conversation
-     * @param threadPath - The absolute path to the thread directory
-     * @param conversationId - The conversation ID
-     * @returns The conversation history or null if not found
-     */
-    getConversationHistoryByConversationId(threadPath: string, conversationId: string): Promise<ConversationHistory | null>;
-    /**
-     * Gets the last N messages from conversation history for a specific conversation
-     * @param threadPath - The absolute path to the thread directory
-     * @param conversationId - The conversation ID
-     * @param count - Number of messages to retrieve (default: 1)
-     * @returns Array of conversation messages
-     */
-    getLastMessages(threadPath: string, conversationId: string, count?: number): Promise<ConversationMessage[]>;
-    /**
-     * Clears conversation history for a specific conversation
-     * @param threadPath - The absolute path to the thread directory
-     * @param conversationId - The conversation ID
-     */
-    clearChatHistory(threadPath: string, conversationId: string): Promise<void>;
-    /**
-     * Gets all conversation IDs for a thread
-     * @param threadPath - The absolute path to the thread directory
-     * @returns Array of conversation IDs
-     */
-    getConversationIds(threadPath: string): Promise<string[]>;
-    /**
-     * Gets deleted conversation history for a thread
-     * @param threadPath - The absolute path to the thread directory
-     * @returns The deleted conversation history or null if not found
-     */
-    getDeletedConversationHistory(threadPath: string): Promise<ConversationHistory | null>;
-    /**
-     * Gets deleted conversation IDs for a thread
-     * @param threadPath - The absolute path to the thread directory
-     * @returns Array of deleted conversation IDs
-     */
-    getDeletedConversationIds(threadPath: string): Promise<string[]>;
-}
-/**
- * ConversationManagerImpl provides the implementation for conversation operations
- */
-export declare class ConversationManagerImpl implements ConversationManager {
-    private db;
-    /**
-     * Create a new ConversationManagerImpl
-     * @param _dataDir - Directory where metadata files are stored (unused, kept for interface compatibility)
-     */
-    constructor(_dataDir: string);
-    /**
-     * Initialize the conversation manager
-     */
-    initialize(): Promise<void>;
-    /**
-     * Starts a new conversation message
-     */
-    startMessage(threadId: string, _threadPath: string, conversationId: string, message: string, model: string, attachments?: FileData[], planMode?: boolean): Promise<string>;
-    /**
-     * Completes a conversation message
-     */
-    completeMessage(messageId: string, content: string, events: AgentEvent[]): Promise<void>;
-    /**
-     * Gets the conversation history for a thread (all conversations)
-     */
-    getConversationHistory(threadPath: string): Promise<ConversationHistory | null>;
-    /**
-     * Gets the conversation history for a specific conversation
-     */
-    getConversationHistoryByConversationId(threadPath: string, conversationId: string): Promise<ConversationHistory | null>;
-    /**
-     * Gets the last N messages from conversation history for a specific conversation
-     */
-    getLastMessages(threadPath: string, conversationId: string, count?: number): Promise<ConversationMessage[]>;
-    /**
-     * Clears conversation history for a specific conversation
-     */
-    clearChatHistory(threadPath: string, conversationId: string): Promise<void>;
-    /**
-     * Gets all conversation IDs for a thread
-     */
-    getConversationIds(threadPath: string): Promise<string[]>;
-    /**
-     * Gets deleted conversation history for a thread
-     */
-    getDeletedConversationHistory(threadPath: string): Promise<ConversationHistory | null>;
-    /**
-     * Gets deleted conversation IDs for a thread
-     */
-    getDeletedConversationIds(threadPath: string): Promise<string[]>;
-}
-//# sourceMappingURL=conversations.manager.d.ts.map