@dotsetlabs/dotclaw 1.1.0

package/dist/db.d.ts

@@ -0,0 +1,99 @@
+import { NewMessage, ScheduledTask, TaskRunLog } from './types.js';
+export declare function initDatabase(): void;
+/**
+ * Store a message with full content (generic version).
+ * Works with any messaging platform.
+ */
+export declare function storeMessage(msgId: string, chatId: string, senderId: string, senderName: string, content: string, timestamp: string, isFromMe: boolean): void;
+export declare function getMessagesSinceCursor(chatJid: string, sinceTimestamp: string | null, sinceMessageId: string | null): NewMessage[];
+export interface ChatState {
+    chat_jid: string;
+    last_agent_timestamp: string | null;
+    last_agent_message_id: string | null;
+}
+export declare function getChatState(chatJid: string): ChatState | null;
+export declare function updateChatState(chatJid: string, timestamp: string, messageId: string): void;
+export interface GroupSession {
+    group_folder: string;
+    session_id: string;
+    updated_at: string;
+}
+export declare function getAllGroupSessions(): GroupSession[];
+export declare function setGroupSession(groupFolder: string, sessionId: string): void;
+export declare function deleteGroupSession(groupFolder: string): void;
+export declare function pauseTasksForGroup(groupFolder: string): number;
+export declare function createTask(task: Omit<ScheduledTask, 'last_run' | 'last_result'>): void;
+export declare function getTaskById(id: string): ScheduledTask | undefined;
+export declare function getAllTasks(): ScheduledTask[];
+export declare function updateTask(id: string, updates: Partial<Pick<ScheduledTask, 'prompt' | 'schedule_type' | 'schedule_value' | 'next_run' | 'status' | 'state_json' | 'retry_count' | 'last_error' | 'context_mode'>>): void;
+export declare function deleteTask(id: string): void;
+export declare function getDueTasks(): ScheduledTask[];
+export declare function updateTaskAfterRun(id: string, nextRun: string | null, lastResult: string, lastError: string | null, retryCount: number): void;
+export declare function logTaskRun(log: TaskRunLog): void;
+export declare function logToolCalls(params: {
+    traceId: string;
+    chatJid: string;
+    groupFolder: string;
+    userId?: string | null;
+    toolCalls: Array<{
+        name: string;
+        ok: boolean;
+        duration_ms?: number;
+        error?: string;
+        output_bytes?: number;
+        output_truncated?: boolean;
+    }>;
+    source: string;
+}): void;
+export declare function getToolUsageCounts(params: {
+    groupFolder: string;
+    userId?: string | null;
+    since: string;
+}): Array<{
+    tool_name: string;
+    count: number;
+}>;
+export declare function getToolReliability(params: {
+    groupFolder: string;
+    limit?: number;
+}): Array<{
+    tool_name: string;
+    total: number;
+    ok_count: number;
+    avg_duration_ms: number | null;
+}>;
+export interface UserFeedback {
+    id: string;
+    trace_id: string;
+    message_id?: string;
+    chat_jid?: string;
+    feedback_type: 'positive' | 'negative';
+    user_id?: string;
+    reason?: string;
+    created_at: string;
+}
+/**
+ * Link a message to its trace ID for feedback lookup
+ */
+export declare function linkMessageToTrace(messageId: string, chatJid: string, traceId: string): void;
+/**
+ * Get trace ID for a message
+ */
+export declare function getTraceIdForMessage(messageId: string, chatJid: string): string | null;
+/**
+ * Record user feedback (thumbs up/down reaction)
+ */
+export declare function recordUserFeedback(feedback: Omit<UserFeedback, 'id' | 'created_at'>): string;
+/**
+ * Get feedback for a trace
+ */
+export declare function getFeedbackForTrace(traceId: string): UserFeedback | null;
+/**
+ * Get recent feedback for analytics
+ */
+export declare function getRecentFeedback(params: {
+    chatJid?: string;
+    limit?: number;
+    since?: string;
+}): UserFeedback[];
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

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

package/dist/db.js

@@ -0,0 +1,423 @@
+import Database from 'better-sqlite3';
+import fs from 'fs';
+import path from 'path';
+import { STORE_DIR } from './config.js';
+let db;
+let dbInitialized = false;
+export function initDatabase() {
+    if (dbInitialized)
+        return;
+    const dbPath = path.join(STORE_DIR, 'messages.db');
+    fs.mkdirSync(path.dirname(dbPath), { recursive: true });
+    db = new Database(dbPath);
+    dbInitialized = true;
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS chats (
+      jid TEXT PRIMARY KEY,
+      name TEXT,
+      last_message_time TEXT
+    );
+    CREATE TABLE IF NOT EXISTS messages (
+      id TEXT,
+      chat_jid TEXT,
+      sender TEXT,
+      sender_name TEXT,
+      content TEXT,
+      timestamp TEXT,
+      is_from_me INTEGER,
+      PRIMARY KEY (id, chat_jid),
+      FOREIGN KEY (chat_jid) REFERENCES chats(jid)
+    );
+    CREATE INDEX IF NOT EXISTS idx_timestamp ON messages(timestamp);
+
+    CREATE TABLE IF NOT EXISTS scheduled_tasks (
+      id TEXT PRIMARY KEY,
+      group_folder TEXT NOT NULL,
+      chat_jid TEXT NOT NULL,
+      prompt TEXT NOT NULL,
+      schedule_type TEXT NOT NULL,
+      schedule_value TEXT NOT NULL,
+      next_run TEXT,
+      last_run TEXT,
+      last_result TEXT,
+      state_json TEXT,
+      retry_count INTEGER DEFAULT 0,
+      last_error TEXT,
+      status TEXT DEFAULT 'active',
+      created_at TEXT NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_next_run ON scheduled_tasks(next_run);
+    CREATE INDEX IF NOT EXISTS idx_status ON scheduled_tasks(status);
+
+    CREATE TABLE IF NOT EXISTS task_run_logs (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      task_id TEXT NOT NULL,
+      run_at TEXT NOT NULL,
+      duration_ms INTEGER NOT NULL,
+      status TEXT NOT NULL,
+      result TEXT,
+      error TEXT,
+      FOREIGN KEY (task_id) REFERENCES scheduled_tasks(id)
+    );
+    CREATE INDEX IF NOT EXISTS idx_task_run_logs ON task_run_logs(task_id, run_at);
+
+    CREATE TABLE IF NOT EXISTS chat_state (
+      chat_jid TEXT PRIMARY KEY,
+      last_agent_timestamp TEXT,
+      last_agent_message_id TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS group_sessions (
+      group_folder TEXT PRIMARY KEY,
+      session_id TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS tool_audit (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      trace_id TEXT,
+      chat_jid TEXT,
+      group_folder TEXT,
+      user_id TEXT,
+      tool_name TEXT NOT NULL,
+      ok INTEGER NOT NULL,
+      duration_ms INTEGER,
+      error TEXT,
+      created_at TEXT NOT NULL,
+      source TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_tool_audit_trace ON tool_audit(trace_id);
+    CREATE INDEX IF NOT EXISTS idx_tool_audit_group ON tool_audit(group_folder, created_at);
+
+    CREATE TABLE IF NOT EXISTS user_feedback (
+      id TEXT PRIMARY KEY,
+      trace_id TEXT NOT NULL,
+      message_id TEXT,
+      chat_jid TEXT,
+      feedback_type TEXT NOT NULL,
+      user_id TEXT,
+      reason TEXT,
+      created_at TEXT NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_feedback_trace ON user_feedback(trace_id);
+    CREATE INDEX IF NOT EXISTS idx_feedback_chat ON user_feedback(chat_jid, created_at);
+
+    CREATE TABLE IF NOT EXISTS message_traces (
+      message_id TEXT NOT NULL,
+      chat_jid TEXT NOT NULL,
+      trace_id TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      PRIMARY KEY (message_id, chat_jid)
+    );
+    CREATE INDEX IF NOT EXISTS idx_message_traces ON message_traces(trace_id);
+  `);
+    // Add sender_name column if it doesn't exist (migration for existing DBs)
+    try {
+        db.exec(`ALTER TABLE messages ADD COLUMN sender_name TEXT`);
+    }
+    catch { /* column already exists */ }
+    // Add context_mode column if it doesn't exist (migration for existing DBs)
+    try {
+        db.exec(`ALTER TABLE scheduled_tasks ADD COLUMN context_mode TEXT DEFAULT 'isolated'`);
+    }
+    catch { /* column already exists */ }
+    try {
+        db.exec(`ALTER TABLE scheduled_tasks ADD COLUMN state_json TEXT`);
+    }
+    catch { /* column already exists */ }
+    try {
+        db.exec(`ALTER TABLE scheduled_tasks ADD COLUMN retry_count INTEGER DEFAULT 0`);
+    }
+    catch { /* column already exists */ }
+    try {
+        db.exec(`ALTER TABLE scheduled_tasks ADD COLUMN last_error TEXT`);
+    }
+    catch { /* column already exists */ }
+    // Add user_id column to tool_audit if it doesn't exist
+    try {
+        db.exec(`ALTER TABLE tool_audit ADD COLUMN user_id TEXT`);
+    }
+    catch { /* column already exists */ }
+}
+/**
+ * Store a message with full content (generic version).
+ * Works with any messaging platform.
+ */
+export function storeMessage(msgId, chatId, senderId, senderName, content, timestamp, isFromMe) {
+    db.prepare(`INSERT OR REPLACE INTO messages (id, chat_jid, sender, sender_name, content, timestamp, is_from_me) VALUES (?, ?, ?, ?, ?, ?, ?)`)
+        .run(msgId, chatId, senderId, senderName, content, timestamp, isFromMe ? 1 : 0);
+}
+export function getMessagesSinceCursor(chatJid, sinceTimestamp, sinceMessageId) {
+    const timestamp = sinceTimestamp || '1970-01-01T00:00:00.000Z';
+    const messageId = sinceMessageId || '0';
+    const sql = `
+    SELECT id, chat_jid, sender, sender_name, content, timestamp
+    FROM messages
+    WHERE chat_jid = ? AND is_from_me = 0 AND (
+      timestamp > ? OR (timestamp = ? AND CAST(id AS INTEGER) > CAST(? AS INTEGER))
+    )
+    ORDER BY timestamp, CAST(id AS INTEGER)
+  `;
+    return db.prepare(sql).all(chatJid, timestamp, timestamp, messageId);
+}
+export function getChatState(chatJid) {
+    const row = db.prepare(`
+    SELECT chat_jid, last_agent_timestamp, last_agent_message_id
+    FROM chat_state
+    WHERE chat_jid = ?
+  `).get(chatJid);
+    return row || null;
+}
+export function updateChatState(chatJid, timestamp, messageId) {
+    db.prepare(`
+    INSERT INTO chat_state (chat_jid, last_agent_timestamp, last_agent_message_id)
+    VALUES (?, ?, ?)
+    ON CONFLICT(chat_jid) DO UPDATE SET
+      last_agent_timestamp = excluded.last_agent_timestamp,
+      last_agent_message_id = excluded.last_agent_message_id
+  `).run(chatJid, timestamp, messageId);
+}
+export function getAllGroupSessions() {
+    return db.prepare(`SELECT group_folder, session_id, updated_at FROM group_sessions`).all();
+}
+export function setGroupSession(groupFolder, sessionId) {
+    const now = new Date().toISOString();
+    db.prepare(`
+    INSERT INTO group_sessions (group_folder, session_id, updated_at)
+    VALUES (?, ?, ?)
+    ON CONFLICT(group_folder) DO UPDATE SET
+      session_id = excluded.session_id,
+      updated_at = excluded.updated_at
+  `).run(groupFolder, sessionId, now);
+}
+export function deleteGroupSession(groupFolder) {
+    db.prepare(`DELETE FROM group_sessions WHERE group_folder = ?`).run(groupFolder);
+}
+export function pauseTasksForGroup(groupFolder) {
+    const info = db.prepare(`
+    UPDATE scheduled_tasks
+    SET status = 'paused'
+    WHERE group_folder = ? AND status != 'completed'
+  `).run(groupFolder);
+    return info.changes;
+}
+export function createTask(task) {
+    db.prepare(`
+    INSERT INTO scheduled_tasks (
+      id, group_folder, chat_jid, prompt, schedule_type, schedule_value, context_mode,
+      next_run, status, created_at, state_json, retry_count, last_error
+    )
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(task.id, task.group_folder, task.chat_jid, task.prompt, task.schedule_type, task.schedule_value, task.context_mode || 'isolated', task.next_run, task.status, task.created_at, task.state_json ?? null, task.retry_count ?? 0, task.last_error ?? null);
+}
+export function getTaskById(id) {
+    return db.prepare('SELECT * FROM scheduled_tasks WHERE id = ?').get(id);
+}
+export function getAllTasks() {
+    return db.prepare('SELECT * FROM scheduled_tasks ORDER BY created_at DESC').all();
+}
+export function updateTask(id, updates) {
+    const fields = [];
+    const values = [];
+    if (updates.prompt !== undefined) {
+        fields.push('prompt = ?');
+        values.push(updates.prompt);
+    }
+    if (updates.schedule_type !== undefined) {
+        fields.push('schedule_type = ?');
+        values.push(updates.schedule_type);
+    }
+    if (updates.schedule_value !== undefined) {
+        fields.push('schedule_value = ?');
+        values.push(updates.schedule_value);
+    }
+    if (updates.next_run !== undefined) {
+        fields.push('next_run = ?');
+        values.push(updates.next_run);
+    }
+    if (updates.status !== undefined) {
+        fields.push('status = ?');
+        values.push(updates.status);
+    }
+    if (updates.context_mode !== undefined) {
+        fields.push('context_mode = ?');
+        values.push(updates.context_mode);
+    }
+    if (updates.state_json !== undefined) {
+        fields.push('state_json = ?');
+        values.push(updates.state_json);
+    }
+    if (updates.retry_count !== undefined) {
+        fields.push('retry_count = ?');
+        values.push(updates.retry_count);
+    }
+    if (updates.last_error !== undefined) {
+        fields.push('last_error = ?');
+        values.push(updates.last_error);
+    }
+    if (fields.length === 0)
+        return;
+    values.push(id);
+    db.prepare(`UPDATE scheduled_tasks SET ${fields.join(', ')} WHERE id = ?`).run(...values);
+}
+export function deleteTask(id) {
+    // Delete child records first (FK constraint)
+    db.prepare('DELETE FROM task_run_logs WHERE task_id = ?').run(id);
+    db.prepare('DELETE FROM scheduled_tasks WHERE id = ?').run(id);
+}
+export function getDueTasks() {
+    const now = new Date().toISOString();
+    return db.prepare(`
+    SELECT * FROM scheduled_tasks
+    WHERE status = 'active' AND next_run IS NOT NULL AND next_run <= ?
+    ORDER BY next_run
+  `).all(now);
+}
+export function updateTaskAfterRun(id, nextRun, lastResult, lastError, retryCount) {
+    const now = new Date().toISOString();
+    db.prepare(`
+    UPDATE scheduled_tasks
+    SET next_run = ?, last_run = ?, last_result = ?, last_error = ?, retry_count = ?,
+        status = CASE WHEN ? IS NULL THEN 'completed' ELSE status END
+    WHERE id = ?
+  `).run(nextRun, now, lastResult, lastError, retryCount, nextRun, id);
+}
+export function logTaskRun(log) {
+    db.prepare(`
+    INSERT INTO task_run_logs (task_id, run_at, duration_ms, status, result, error)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `).run(log.task_id, log.run_at, log.duration_ms, log.status, log.result, log.error);
+}
+export function logToolCalls(params) {
+    if (!params.toolCalls || params.toolCalls.length === 0)
+        return;
+    if (!dbInitialized) {
+        initDatabase();
+    }
+    const now = new Date().toISOString();
+    const stmt = db.prepare(`
+    INSERT INTO tool_audit (trace_id, chat_jid, group_folder, user_id, tool_name, ok, duration_ms, error, created_at, source)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    const transaction = db.transaction((calls) => {
+        for (const call of calls) {
+            stmt.run(params.traceId, params.chatJid, params.groupFolder, params.userId || null, call.name, call.ok ? 1 : 0, call.duration_ms ?? null, call.error ?? null, now, params.source);
+        }
+    });
+    transaction(params.toolCalls);
+}
+export function getToolUsageCounts(params) {
+    if (!dbInitialized) {
+        initDatabase();
+    }
+    const clauses = ['group_folder = ?', 'created_at >= ?'];
+    const values = [params.groupFolder, params.since];
+    if (params.userId) {
+        clauses.push('user_id = ?');
+        values.push(params.userId);
+    }
+    const rows = db.prepare(`
+    SELECT tool_name, COUNT(*) as count
+    FROM tool_audit
+    WHERE ${clauses.join(' AND ')}
+    GROUP BY tool_name
+  `).all(...values);
+    return rows;
+}
+export function getToolReliability(params) {
+    const limit = params.limit && params.limit > 0 ? params.limit : 200;
+    const rows = db.prepare(`
+    SELECT tool_name,
+           COUNT(*) as total,
+           SUM(ok) as ok_count,
+           AVG(duration_ms) as avg_duration_ms
+    FROM (
+      SELECT tool_name, ok, duration_ms
+      FROM tool_audit
+      WHERE group_folder = ?
+      ORDER BY created_at DESC
+      LIMIT ?
+    )
+    GROUP BY tool_name
+  `).all(params.groupFolder, limit);
+    return rows;
+}
+/**
+ * Link a message to its trace ID for feedback lookup
+ */
+export function linkMessageToTrace(messageId, chatJid, traceId) {
+    if (!dbInitialized)
+        initDatabase();
+    const now = new Date().toISOString();
+    db.prepare(`
+    INSERT OR REPLACE INTO message_traces (message_id, chat_jid, trace_id, created_at)
+    VALUES (?, ?, ?, ?)
+  `).run(messageId, chatJid, traceId, now);
+}
+/**
+ * Get trace ID for a message
+ */
+export function getTraceIdForMessage(messageId, chatJid) {
+    if (!dbInitialized)
+        initDatabase();
+    const row = db.prepare(`
+    SELECT trace_id FROM message_traces
+    WHERE message_id = ? AND chat_jid = ?
+  `).get(messageId, chatJid);
+    return row?.trace_id ?? null;
+}
+/**
+ * Record user feedback (thumbs up/down reaction)
+ */
+export function recordUserFeedback(feedback) {
+    if (!dbInitialized)
+        initDatabase();
+    const id = `fb-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const now = new Date().toISOString();
+    db.prepare(`
+    INSERT INTO user_feedback (id, trace_id, message_id, chat_jid, feedback_type, user_id, reason, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, feedback.trace_id, feedback.message_id ?? null, feedback.chat_jid ?? null, feedback.feedback_type, feedback.user_id ?? null, feedback.reason ?? null, now);
+    return id;
+}
+/**
+ * Get feedback for a trace
+ */
+export function getFeedbackForTrace(traceId) {
+    if (!dbInitialized)
+        initDatabase();
+    const row = db.prepare(`
+    SELECT * FROM user_feedback
+    WHERE trace_id = ?
+    ORDER BY created_at DESC
+    LIMIT 1
+  `).get(traceId);
+    return row ?? null;
+}
+/**
+ * Get recent feedback for analytics
+ */
+export function getRecentFeedback(params) {
+    if (!dbInitialized)
+        initDatabase();
+    const limit = params.limit || 100;
+    const clauses = [];
+    const values = [];
+    if (params.chatJid) {
+        clauses.push('chat_jid = ?');
+        values.push(params.chatJid);
+    }
+    if (params.since) {
+        clauses.push('created_at >= ?');
+        values.push(params.since);
+    }
+    const whereClause = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
+    const sql = `
+    SELECT * FROM user_feedback
+    ${whereClause}
+    ORDER BY created_at DESC
+    LIMIT ?
+  `;
+    return db.prepare(sql).all(...values, limit);
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/error-messages.d.ts

@@ -0,0 +1,17 @@
+/**
+ * User-friendly error message mapping
+ * Converts technical errors to human-readable messages
+ */
+/**
+ * Convert a technical error to a user-friendly message
+ */
+export declare function humanizeError(error: Error | string): string;
+/**
+ * Check if an error is likely transient and worth retrying
+ */
+export declare function isTransientError(error: Error | string): boolean;
+/**
+ * Determine if an error should be logged at error level vs warning
+ */
+export declare function getErrorSeverity(error: Error | string): 'error' | 'warn' | 'info';
+//# sourceMappingURL=error-messages.d.ts.map

package/dist/error-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-messages.d.ts","sourceRoot":"","sources":["../src/error-messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkDH;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAe3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAwB/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAmBjF"}

package/dist/error-messages.js

@@ -0,0 +1,109 @@
+/**
+ * User-friendly error message mapping
+ * Converts technical errors to human-readable messages
+ */
+const ERROR_PATTERNS = [
+    // Network errors
+    { pattern: 'ECONNREFUSED', message: "I'm having trouble connecting to a service. Please try again in a moment." },
+    { pattern: 'ETIMEDOUT', message: "That took too long to complete. Let me try a simpler approach." },
+    { pattern: 'ENOTFOUND', message: "I couldn't reach a required service. Please check your internet connection." },
+    { pattern: 'ECONNRESET', message: "The connection was interrupted. Please try again." },
+    { pattern: 'EAI_AGAIN', message: "There was a temporary network issue. Please try again." },
+    // Rate limiting
+    { pattern: /rate.?limit/i, message: "I need to slow down a bit. Please try again in a few seconds." },
+    { pattern: /too many requests/i, message: "I'm being rate limited. Please wait a moment and try again." },
+    { pattern: /429/i, message: "I'm being rate limited. Please wait a moment and try again." },
+    // Context/token limits
+    { pattern: /context.?length/i, message: "That conversation got too long. Let me summarize and continue." },
+    { pattern: /maximum.?context/i, message: "We've hit the context limit. I'll need to start fresh or summarize." },
+    { pattern: /token.?limit/i, message: "The response was too long. Let me give you a shorter version." },
+    // Authentication
+    { pattern: /invalid.?api.?key/i, message: "There's a configuration issue with the API. Please contact the admin." },
+    { pattern: /unauthorized/i, message: "There's an authentication issue. Please contact the admin." },
+    { pattern: /401/i, message: "There's an authentication issue. Please contact the admin." },
+    { pattern: /403/i, message: "I don't have permission to do that. Please contact the admin." },
+    // Model errors
+    { pattern: /model.?not.?found/i, message: "The AI model isn't available right now. Trying an alternative..." },
+    { pattern: /model.?unavailable/i, message: "The AI model is temporarily unavailable. Please try again later." },
+    { pattern: /overloaded/i, message: "The AI service is busy right now. Please try again in a moment." },
+    // Container errors
+    { pattern: /container.?timeout/i, message: "That task took too long to complete. Please try with a smaller request." },
+    { pattern: /container.?exited/i, message: "Something went wrong while processing. Let me try again." },
+    // Tool errors
+    { pattern: /tool.?call.?limit/i, message: "I hit my limit for operations. Please narrow the scope or ask for a specific subtask." },
+    { pattern: /bash.?timeout/i, message: "A command took too long to run. Please try a simpler operation." },
+    // Generic server errors
+    { pattern: /500/i, message: "The server encountered an error. Please try again." },
+    { pattern: /502/i, message: "There's a temporary server issue. Please try again in a moment." },
+    { pattern: /503/i, message: "The service is temporarily unavailable. Please try again later." },
+    { pattern: /504/i, message: "The request timed out. Please try again." },
+    // Memory/resource errors
+    { pattern: /out of memory/i, message: "That task needed more memory than available. Please try with less data." },
+    { pattern: /memory.?limit/i, message: "That task needed more memory than available. Please try with less data." }
+];
+/**
+ * Convert a technical error to a user-friendly message
+ */
+export function humanizeError(error) {
+    const message = typeof error === 'string' ? error : error.message;
+    for (const { pattern, message: friendlyMessage } of ERROR_PATTERNS) {
+        if (typeof pattern === 'string') {
+            if (message.includes(pattern)) {
+                return friendlyMessage;
+            }
+        }
+        else if (pattern.test(message)) {
+            return friendlyMessage;
+        }
+    }
+    // Default message
+    return "Something went wrong. I'll try to help anyway!";
+}
+/**
+ * Check if an error is likely transient and worth retrying
+ */
+export function isTransientError(error) {
+    const message = typeof error === 'string' ? error : error.message;
+    const transientPatterns = [
+        'ECONNREFUSED',
+        'ETIMEDOUT',
+        'ECONNRESET',
+        'EAI_AGAIN',
+        /rate.?limit/i,
+        /429/i,
+        /overloaded/i,
+        /502/i,
+        /503/i,
+        /504/i
+    ];
+    for (const pattern of transientPatterns) {
+        if (typeof pattern === 'string') {
+            if (message.includes(pattern))
+                return true;
+        }
+        else if (pattern.test(message)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Determine if an error should be logged at error level vs warning
+ */
+export function getErrorSeverity(error) {
+    const message = typeof error === 'string' ? error : error.message;
+    // Transient errors are warnings
+    if (isTransientError(error)) {
+        return 'warn';
+    }
+    // Configuration issues are errors
+    if (/invalid.?api.?key/i.test(message) || /unauthorized/i.test(message)) {
+        return 'error';
+    }
+    // User-caused issues (context too long, etc) are info
+    if (/context.?length/i.test(message) || /token.?limit/i.test(message)) {
+        return 'info';
+    }
+    return 'error';
+}
+//# sourceMappingURL=error-messages.js.map