tarsk 0.4.4 → 0.4.6

package/dist/core/crypto.js

@@ -1,166 +0,0 @@
-/**
- * Crypto utilities for encrypting/decrypting sensitive data
- *
- * Uses AES-256-GCM encryption with a machine-specific key derived from
- * unchanging machine identifiers.
- */
-import { createCipheriv, createDecipheriv, randomBytes, createHash } from "crypto";
-import { networkInterfaces, hostname } from "os";
-import { getDatabase } from '../database/database.js';
-const ALGORITHM = "aes-256-gcm";
-const IV_LENGTH = 16; // 128 bits
-/**
- * Generate a machine-specific encryption key
- *
- * This creates a deterministic key based on unchanging machine identifiers:
- * - MAC address of the first network interface (if available)
- * - Hostname
- * - User home directory path (as fallback)
- *
- * The fallback to home directory ensures the key works on Windows VMs,
- * containers, and other environments where MAC address may not be available.
- *
- * @returns A 32-byte encryption key
- */
-function getMachineKey() {
-    try {
-        // Get MAC address from first available network interface
-        const interfaces = networkInterfaces();
-        let macAddress = "";
-        for (const name of Object.keys(interfaces)) {
-            const iface = interfaces[name];
-            if (iface) {
-                for (const addr of iface) {
-                    // Skip loopback and null MAC addresses
-                    if (addr.mac && addr.mac !== "00:00:00:00:00:00" && !addr.internal) {
-                        macAddress = addr.mac;
-                        break;
-                    }
-                }
-                if (macAddress)
-                    break;
-            }
-        }
-        // Get hostname
-        const host = hostname();
-        // Get home directory as additional identifier (works on Windows, macOS, Linux)
-        // Windows uses USERPROFILE, Unix-like systems use HOME
-        const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? "";
-        // Combine all available identifiers
-        // Format: mac-hostname-homedir
-        const machineId = `${macAddress}-${host}-${homeDir}`;
-        // Hash to create a 256-bit key
-        return createHash("sha256").update(machineId).digest();
-    }
-    catch {
-        return Buffer.from("Invalid", "utf8");
-    }
-}
-/**
- * Get the encryption key from database state table or generate machine key
- * @returns A 32-byte encryption key
- */
-async function getEncryptionKey() {
-    try {
-        const db = await getDatabase();
-        // Try to get existing encryption key from state table directly
-        const result = await db.execute({
-            sql: "SELECT value FROM state WHERE key = ?",
-            args: ["encryption_key"],
-        });
-        if (result.rows.length > 0 && result.rows[0].value) {
-            const storedValue = result.rows[0].value;
-            try {
-                // Try to parse as JSON first (in case it was stored that way)
-                const parsed = JSON.parse(storedValue);
-                return Buffer.from(parsed, "base64");
-            }
-            catch {
-                // If not JSON, treat as direct base64 string
-                return Buffer.from(storedValue, "base64");
-            }
-        }
-        // Generate new machine key and store it
-        const machineKey = getMachineKey();
-        // Store the key in the state table as base64 string (not JSON)
-        await db.execute({
-            sql: "INSERT OR REPLACE INTO state (key, value) VALUES (?, ?)",
-            args: ["encryption_key", machineKey.toString("base64")],
-        });
-        return machineKey;
-    }
-    catch {
-        // Fallback to machine key if database fails
-        return getMachineKey();
-    }
-}
-/**
- * Encrypt a string value
- *
- * @param plaintext - The string to encrypt
- * @returns Base64-encoded encrypted data in format: iv:authTag:ciphertext
- */
-export async function encrypt(plaintext) {
-    if (!plaintext) {
-        return "";
-    }
-    const key = await getEncryptionKey();
-    const iv = randomBytes(IV_LENGTH);
-    const cipher = createCipheriv(ALGORITHM, key, iv);
-    let encrypted = cipher.update(plaintext, "utf8", "base64");
-    encrypted += cipher.final("base64");
-    const authTag = cipher.getAuthTag();
-    // Combine iv, authTag, and encrypted data
-    const result = `${iv.toString("base64")}:${authTag.toString("base64")}:${encrypted}`;
-    return result;
-}
-/**
- * Decrypt an encrypted string value
- *
- * @param encryptedData - Base64-encoded encrypted data in format: iv:authTag:ciphertext
- * @returns The decrypted plaintext string
- * @throws Error if decryption fails (wrong key, corrupted data, etc.)
- */
-export async function decrypt(encryptedData) {
-    if (!encryptedData) {
-        return "";
-    }
-    try {
-        const parts = encryptedData.split(":");
-        if (parts.length !== 3) {
-            throw new Error("Invalid encrypted data format");
-        }
-        const [ivBase64, authTagBase64, encrypted] = parts;
-        const key = await getEncryptionKey();
-        const iv = Buffer.from(ivBase64, "base64");
-        const authTag = Buffer.from(authTagBase64, "base64");
-        const decipher = createDecipheriv(ALGORITHM, key, iv);
-        decipher.setAuthTag(authTag);
-        let decrypted = decipher.update(encrypted, "base64", "utf8");
-        decrypted += decipher.final("utf8");
-        return decrypted;
-    }
-    catch (error) {
-        throw new Error(`Decryption failed: ${error instanceof Error ? error.message : "Unknown error"}`);
-    }
-}
-/**
- * Check if a string appears to be encrypted
- *
- * @param value - The string to check
- * @returns true if the string appears to be in encrypted format
- */
-export function isEncrypted(value) {
-    if (!value) {
-        return false;
-    }
-    // Check if it matches the format: base64:base64:base64
-    const parts = value.split(":");
-    if (parts.length !== 3) {
-        return false;
-    }
-    // Basic check that each part looks like base64
-    const base64Regex = /^[A-Za-z0-9+/]+=*$/;
-    return parts.every((part) => base64Regex.test(part));
-}
-//# sourceMappingURL=crypto.js.map

package/dist/core/dev-server-cache.d.ts

@@ -1,46 +0,0 @@
-/**
- * DevServerCache manages in-memory caching of dev server URLs indexed by thread ID
- *
- * This cache is responsible for:
- * - Storing dev server URLs by thread ID
- * - Retrieving URLs for specific threads
- * - Clearing URLs when dev servers are stopped
- */
-export declare class DevServerCache {
-    private cache;
-    /**
-     * Store a dev server URL for a specific thread
-     * @param threadId - The thread ID
-     * @param url - The dev server URL
-     */
-    setUrl(threadId: string, url: string): void;
-    /**
-     * Get the dev server URL for a specific thread
-     * @param threadId - The thread ID
-     * @returns The URL if found, undefined otherwise
-     */
-    getUrl(threadId: string): string | undefined;
-    /**
-     * Clear the dev server URL for a specific thread
-     * @param threadId - The thread ID
-     * @returns true if URL was cleared, false if no URL was stored for that thread
-     */
-    clearUrl(threadId: string): boolean;
-    /**
-     * Check if a thread has a cached dev server URL
-     * @param threadId - The thread ID
-     * @returns true if URL exists for the thread
-     */
-    hasUrl(threadId: string): boolean;
-    /**
-     * Clear all cached URLs (useful for testing or cleanup)
-     */
-    clearAll(): void;
-    /**
-     * Get all cached thread IDs and their URLs
-     * @returns Map of threadId -> url entries
-     */
-    getAllUrls(): Map<string, string>;
-}
-export declare const devServerCache: DevServerCache;
-//# sourceMappingURL=dev-server-cache.d.ts.map

package/dist/core/dev-server-cache.js

@@ -1,59 +0,0 @@
-/**
- * DevServerCache manages in-memory caching of dev server URLs indexed by thread ID
- *
- * This cache is responsible for:
- * - Storing dev server URLs by thread ID
- * - Retrieving URLs for specific threads
- * - Clearing URLs when dev servers are stopped
- */
-export class DevServerCache {
-    cache = new Map();
-    /**
-     * Store a dev server URL for a specific thread
-     * @param threadId - The thread ID
-     * @param url - The dev server URL
-     */
-    setUrl(threadId, url) {
-        this.cache.set(threadId, url);
-    }
-    /**
-     * Get the dev server URL for a specific thread
-     * @param threadId - The thread ID
-     * @returns The URL if found, undefined otherwise
-     */
-    getUrl(threadId) {
-        return this.cache.get(threadId);
-    }
-    /**
-     * Clear the dev server URL for a specific thread
-     * @param threadId - The thread ID
-     * @returns true if URL was cleared, false if no URL was stored for that thread
-     */
-    clearUrl(threadId) {
-        return this.cache.delete(threadId);
-    }
-    /**
-     * Check if a thread has a cached dev server URL
-     * @param threadId - The thread ID
-     * @returns true if URL exists for the thread
-     */
-    hasUrl(threadId) {
-        return this.cache.has(threadId);
-    }
-    /**
-     * Clear all cached URLs (useful for testing or cleanup)
-     */
-    clearAll() {
-        this.cache.clear();
-    }
-    /**
-     * Get all cached thread IDs and their URLs
-     * @returns Map of threadId -> url entries
-     */
-    getAllUrls() {
-        return new Map(this.cache);
-    }
-}
-// Singleton instance for global access
-export const devServerCache = new DevServerCache();
-//# sourceMappingURL=dev-server-cache.js.map

package/dist/core/env-manager.d.ts

@@ -1,3 +0,0 @@
-export declare function updateEnvFile(keyNames: Record<string, string>): Promise<void>;
-export declare function readEnvFile(): Promise<Record<string, string>>;
-//# sourceMappingURL=env-manager.d.ts.map

package/dist/core/env-manager.js

@@ -1,60 +0,0 @@
-import { promises as fs } from "fs";
-import { join } from "path";
-export async function updateEnvFile(keyNames) {
-    const envPath = join(process.cwd(), ".env");
-    let content = "";
-    try {
-        content = await fs.readFile(envPath, "utf-8");
-    }
-    catch {
-        // If file doesn't exist, start with empty content
-    }
-    const lines = content.split("\n");
-    const envMap = {};
-    // Parse existing content
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (trimmed && !trimmed.startsWith("#") && trimmed.includes("=")) {
-            const index = trimmed.indexOf("=");
-            const key = trimmed.substring(0, index).trim();
-            const value = trimmed.substring(index + 1).trim();
-            envMap[key] = value;
-        }
-    }
-    // Update with new values
-    for (const [key, value] of Object.entries(keyNames)) {
-        if (key) {
-            envMap[key] = value;
-        }
-    }
-    // Serialize back to file
-    const newLines = [];
-    // Try to preserve some order if keys already existed, or just rebuild
-    // For simplicity, we'll just rebuild based on current keys
-    for (const [key, value] of Object.entries(envMap)) {
-        newLines.push(`${key}=${value}`);
-    }
-    await fs.writeFile(envPath, newLines.join("\n") + "\n", "utf-8");
-}
-export async function readEnvFile() {
-    const envPath = join(process.cwd(), ".env");
-    const envMap = {};
-    try {
-        const content = await fs.readFile(envPath, "utf-8");
-        const lines = content.split("\n");
-        for (const line of lines) {
-            const trimmed = line.trim();
-            if (trimmed && !trimmed.startsWith("#") && trimmed.includes("=")) {
-                const index = trimmed.indexOf("=");
-                const key = trimmed.substring(0, index).trim();
-                const value = trimmed.substring(index + 1).trim();
-                envMap[key] = value;
-            }
-        }
-    }
-    catch {
-        // If file doesn't exist, return empty map
-    }
-    return envMap;
-}
-//# sourceMappingURL=env-manager.js.map

package/dist/core/error-responses.d.ts

@@ -1,61 +0,0 @@
-/**
- * Error response codes used across the API
- *
- * Provides type-safe error code constants to ensure consistency
- * across all route handlers and prevent typos in error responses.
- */
-/**
- * Error codes for API responses
- *
- * Organized by category for easier maintenance:
- * - General request validation errors
- * - Thread-related errors
- * - Project-related errors
- * - Conversation/history errors
- * - Process/command execution errors
- * - Git operation errors
- */
-export declare const ErrorCodes: {
-    readonly INVALID_REQUEST: "INVALID_REQUEST";
-    readonly REQUEST_PARSE_ERROR: "REQUEST_PARSE_ERROR";
-    readonly THREAD_NOT_FOUND: "THREAD_NOT_FOUND";
-    readonly UPDATE_THREAD_ERROR: "UPDATE_THREAD_ERROR";
-    readonly DELETE_THREAD_ERROR: "DELETE_THREAD_ERROR";
-    readonly SELECT_THREAD_ERROR: "SELECT_THREAD_ERROR";
-    readonly GET_THREAD_MESSAGES_ERROR: "GET_THREAD_MESSAGES_ERROR";
-    readonly LIST_THREADS_ERROR: "LIST_THREADS_ERROR";
-    readonly LIST_THREAD_FILES_ERROR: "LIST_THREAD_FILES_ERROR";
-    readonly PATH_ERROR: "PATH_ERROR";
-    readonly OPEN_PROGRAM_ERROR: "OPEN_PROGRAM_ERROR";
-    readonly PROJECT_NOT_FOUND: "PROJECT_NOT_FOUND";
-    readonly UPDATE_PROJECT_ERROR: "UPDATE_PROJECT_ERROR";
-    readonly DELETE_PROJECT_ERROR: "DELETE_PROJECT_ERROR";
-    readonly GET_PROJECT_ERROR: "GET_PROJECT_ERROR";
-    readonly LIST_PROJECTS_ERROR: "LIST_PROJECTS_ERROR";
-    readonly NO_CONVERSATION: "NO_CONVERSATION";
-    readonly NO_HISTORY: "NO_HISTORY";
-    readonly NO_RESPONSE: "NO_RESPONSE";
-    readonly NEW_CONVERSATION_ERROR: "NEW_CONVERSATION_ERROR";
-    readonly HISTORY_FETCH_ERROR: "HISTORY_FETCH_ERROR";
-    readonly HISTORY_CLEAR_ERROR: "HISTORY_CLEAR_ERROR";
-    readonly DELETED_HISTORY_FETCH_ERROR: "DELETED_HISTORY_FETCH_ERROR";
-    readonly STREAM_ERROR: "STREAM_ERROR";
-    readonly NO_PROCESS_RUNNING: "NO_PROCESS_RUNNING";
-    readonly RUN_PROCESS_ERROR: "RUN_PROCESS_ERROR";
-    readonly STOP_PROCESS_ERROR: "STOP_PROCESS_ERROR";
-    readonly START_PROCESS_ERROR: "START_PROCESS_ERROR";
-    readonly CHECK_RUNNING_ERROR: "CHECK_RUNNING_ERROR";
-    readonly CHECK_PROCESS_ERROR: "CHECK_PROCESS_ERROR";
-    readonly RUN_COMMAND_ERROR: "RUN_COMMAND_ERROR";
-    readonly SUGGEST_RUN_COMMAND_ERROR: "SUGGEST_RUN_COMMAND_ERROR";
-    readonly UPDATE_RUN_COMMAND_ERROR: "UPDATE_RUN_COMMAND_ERROR";
-    readonly SAVE_COMMAND_ERROR: "SAVE_COMMAND_ERROR";
-    readonly DELETE_COMMAND_ERROR: "DELETE_COMMAND_ERROR";
-    readonly DUPLICATE_BRANCH: "DUPLICATE_BRANCH";
-    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
-};
-/**
- * Type representing all valid error codes
- */
-export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
-//# sourceMappingURL=error-responses.d.ts.map

package/dist/core/error-responses.js

@@ -1,64 +0,0 @@
-/**
- * Error response codes used across the API
- *
- * Provides type-safe error code constants to ensure consistency
- * across all route handlers and prevent typos in error responses.
- */
-/**
- * Error codes for API responses
- *
- * Organized by category for easier maintenance:
- * - General request validation errors
- * - Thread-related errors
- * - Project-related errors
- * - Conversation/history errors
- * - Process/command execution errors
- * - Git operation errors
- */
-export const ErrorCodes = {
-    // General request errors
-    INVALID_REQUEST: "INVALID_REQUEST",
-    REQUEST_PARSE_ERROR: "REQUEST_PARSE_ERROR",
-    // Thread errors
-    THREAD_NOT_FOUND: "THREAD_NOT_FOUND",
-    UPDATE_THREAD_ERROR: "UPDATE_THREAD_ERROR",
-    DELETE_THREAD_ERROR: "DELETE_THREAD_ERROR",
-    SELECT_THREAD_ERROR: "SELECT_THREAD_ERROR",
-    GET_THREAD_MESSAGES_ERROR: "GET_THREAD_MESSAGES_ERROR",
-    LIST_THREADS_ERROR: "LIST_THREADS_ERROR",
-    LIST_THREAD_FILES_ERROR: "LIST_THREAD_FILES_ERROR",
-    PATH_ERROR: "PATH_ERROR",
-    OPEN_PROGRAM_ERROR: "OPEN_PROGRAM_ERROR",
-    // Project errors
-    PROJECT_NOT_FOUND: "PROJECT_NOT_FOUND",
-    UPDATE_PROJECT_ERROR: "UPDATE_PROJECT_ERROR",
-    DELETE_PROJECT_ERROR: "DELETE_PROJECT_ERROR",
-    GET_PROJECT_ERROR: "GET_PROJECT_ERROR",
-    LIST_PROJECTS_ERROR: "LIST_PROJECTS_ERROR",
-    // Conversation/history errors
-    NO_CONVERSATION: "NO_CONVERSATION",
-    NO_HISTORY: "NO_HISTORY",
-    NO_RESPONSE: "NO_RESPONSE",
-    NEW_CONVERSATION_ERROR: "NEW_CONVERSATION_ERROR",
-    HISTORY_FETCH_ERROR: "HISTORY_FETCH_ERROR",
-    HISTORY_CLEAR_ERROR: "HISTORY_CLEAR_ERROR",
-    DELETED_HISTORY_FETCH_ERROR: "DELETED_HISTORY_FETCH_ERROR",
-    STREAM_ERROR: "STREAM_ERROR",
-    // Process/command errors
-    NO_PROCESS_RUNNING: "NO_PROCESS_RUNNING",
-    RUN_PROCESS_ERROR: "RUN_PROCESS_ERROR",
-    STOP_PROCESS_ERROR: "STOP_PROCESS_ERROR",
-    START_PROCESS_ERROR: "START_PROCESS_ERROR",
-    CHECK_RUNNING_ERROR: "CHECK_RUNNING_ERROR",
-    CHECK_PROCESS_ERROR: "CHECK_PROCESS_ERROR",
-    RUN_COMMAND_ERROR: "RUN_COMMAND_ERROR",
-    SUGGEST_RUN_COMMAND_ERROR: "SUGGEST_RUN_COMMAND_ERROR",
-    UPDATE_RUN_COMMAND_ERROR: "UPDATE_RUN_COMMAND_ERROR",
-    SAVE_COMMAND_ERROR: "SAVE_COMMAND_ERROR",
-    DELETE_COMMAND_ERROR: "DELETE_COMMAND_ERROR",
-    // Git operation errors
-    DUPLICATE_BRANCH: "DUPLICATE_BRANCH",
-    // General server errors
-    INTERNAL_ERROR: "INTERNAL_ERROR",
-};
-//# sourceMappingURL=error-responses.js.map

package/dist/core/logger.d.ts

@@ -1,10 +0,0 @@
-declare class Logger {
-    private originalConsole;
-    constructor();
-    private writeToFile;
-    setupLogging(): void;
-    getLogFilePath(): string;
-}
-export declare const logger: Logger;
-export {};
-//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.js

@@ -1,47 +0,0 @@
-import fs from "fs";
-import path from "path";
-const LOG_FILE_PATH = path.join(process.cwd(), "tarsk-logs.txt");
-class Logger {
-    originalConsole;
-    constructor() {
-        this.originalConsole = {
-            log: console.log,
-            error: console.error,
-            warn: console.warn,
-        };
-    }
-    writeToFile(level, ...args) {
-        const timestamp = new Date().toISOString();
-        const message = args
-            .map((arg) => (typeof arg === "object" ? JSON.stringify(arg, null, 2) : JSON.stringify(arg)))
-            .join(" ");
-        const logEntry = `[${timestamp}] ${level}: ${message}\n`;
-        try {
-            fs.appendFileSync(LOG_FILE_PATH, logEntry);
-        }
-        catch (error) {
-            // Fallback to original console if file writing fails
-            this.originalConsole.error("Failed to write to log file:", error);
-        }
-    }
-    setupLogging() {
-        // Override console methods
-        console.log = (...args) => {
-            this.originalConsole.log(...args);
-            this.writeToFile("LOG", ...args);
-        };
-        console.error = (...args) => {
-            this.originalConsole.error(...args);
-            this.writeToFile("ERROR", ...args);
-        };
-        console.warn = (...args) => {
-            this.originalConsole.warn(...args);
-            this.writeToFile("WARN", ...args);
-        };
-    }
-    getLogFilePath() {
-        return LOG_FILE_PATH;
-    }
-}
-export const logger = new Logger();
-//# sourceMappingURL=logger.js.map

package/dist/core/paths.d.ts

@@ -1,22 +0,0 @@
-/**
- * Centralized path configuration for Tarsk
- *
- * Application data is stored in ~/Library/Application Support/Tarsk/data/
- * This includes projects.json, threads.json, state.json, and thread directories.
- */
-/**
- * The root application support directory for Tarsk.
- * On macOS: ~/Library/Application Support/Tarsk
- */
-export declare const APP_SUPPORT_DIR: string;
-/**
- * The data directory where metadata files are stored.
- * ~/Library/Application Support/Tarsk/data
- */
-export declare const DATA_DIR: string;
-/**
- * Get the data directory path for storing metadata.
- * @returns The absolute path to ~/Library/Application Support/Tarsk/data
- */
-export declare function getDataDir(): string;
-//# sourceMappingURL=paths.d.ts.map

package/dist/core/paths.js

@@ -1,26 +0,0 @@
-/**
- * Centralized path configuration for Tarsk
- *
- * Application data is stored in ~/Library/Application Support/Tarsk/data/
- * This includes projects.json, threads.json, state.json, and thread directories.
- */
-import { join } from "path";
-import { homedir } from "os";
-/**
- * The root application support directory for Tarsk.
- * On macOS: ~/Library/Application Support/Tarsk
- */
-export const APP_SUPPORT_DIR = join(homedir(), "Library", "Application Support", "Tarsk");
-/**
- * The data directory where metadata files are stored.
- * ~/Library/Application Support/Tarsk/data
- */
-export const DATA_DIR = join(APP_SUPPORT_DIR, "data");
-/**
- * Get the data directory path for storing metadata.
- * @returns The absolute path to ~/Library/Application Support/Tarsk/data
- */
-export function getDataDir() {
-    return DATA_DIR;
-}
-//# sourceMappingURL=paths.js.map

package/dist/core/random-words.d.ts

@@ -1,18 +0,0 @@
-/**
- * Random word generator for thread names
- *
- * Generates fun, quirky thread names using two random words
- */
-/**
- * Get a random word from the word list
- * @returns A random word
- */
-export declare function getRandomWord(): string;
-/**
- * Generate a random thread name using two random words
- * Format: {word1}-{word2}
- *
- * @returns A thread name like "bouncy-panda" or "sparkly-taco"
- */
-export declare function generateRandomThreadName(): string;
-//# sourceMappingURL=random-words.d.ts.map