@stevederico/dotbot 0.27.0 → 0.29.0

package/core/cdp.js

@@ -184,35 +184,22 @@ export class CDPClient {
     return result.result?.value;
   }
 
-  /**
-   * Get the page title.
-   * @returns {Promise<string>}
-   */
+  /** Get the page title. */
   async getTitle() {
     return this.evaluate('document.title');
   }
 
-  /**
-   * Get the current URL.
-   * @returns {Promise<string>}
-   */
+  /** Get the current URL. */
   async getUrl() {
     return this.evaluate('window.location.href');
   }
 
-  /**
-   * Get text content of the page body.
-   * @returns {Promise<string>}
-   */
+  /** Get text content of the page body. */
   async getBodyText() {
     return this.evaluate('document.body?.innerText || ""');
   }
 
-  /**
-   * Get text content of an element by CSS selector.
-   * @param {string} selector - CSS selector
-   * @returns {Promise<string>}
-   */
+  /** Get text content of an element by CSS selector. */
   async getText(selector) {
     const escaped = selector.replace(/"/g, '\\"');
     return this.evaluate(`document.querySelector("${escaped}")?.innerText || ""`);
@@ -308,26 +295,6 @@ export class CDPClient {
     });
   }
 
-  /**
-   * Click an element by CSS selector.
-   * @param {string} selector - CSS selector
-   */
-  async clickSelector(selector) {
-    const el = await this.querySelector(selector);
-    if (!el) throw new Error(`Element not found: ${selector}`);
-    await this.click(el.x, el.y);
-  }
-
-  /**
-   * Click an element by visible text.
-   * @param {string} text - Text content to find
-   */
-  async clickText(text) {
-    const el = await this.getByText(text);
-    if (!el) throw new Error(`Element with text "${text}" not found`);
-    await this.click(el.x, el.y);
-  }
-
   /**
    * Type text character by character.
    * @param {string} text - Text to type
@@ -453,9 +420,7 @@ export class CDPClient {
     });
   }
 
-  /**
-   * Close the connection.
-   */
+  /** Close the CDP connection. */
   close() {
     if (this.ws) {
       this.ws.close();
@@ -490,24 +455,6 @@ export class CDPClient {
     throw lastError;
   }
 
-  /**
-   * Wait for an element to appear in the DOM.
-   * @param {string} selector - CSS selector
-   * @param {Object} options - Wait options
-   * @param {number} options.timeout - Timeout in ms (default: 5000)
-   * @param {number} options.interval - Poll interval in ms (default: 100)
-   * @returns {Promise<{x: number, y: number, nodeId: number}>} Element info
-   */
-  async waitForSelector(selector, { timeout = 5000, interval = 100 } = {}) {
-    const start = Date.now();
-    while (Date.now() - start < timeout) {
-      const el = await this.querySelector(selector);
-      if (el) return el;
-      await new Promise(r => setTimeout(r, interval));
-    }
-    throw new Error(`Timeout waiting for selector: ${selector}`);
-  }
-
   /**
    * Wait for network to be idle (no requests for a period).
    * @param {Object} options - Wait options

package/index.js

@@ -18,10 +18,8 @@ import {
   notifyTools,
   createBrowserTools,
   taskTools,
-  goalTools,
   triggerTools,
   jobTools,
-  cronTools,
   eventTools,
   appgenTools,
 } from './tools/index.js';
@@ -40,9 +38,6 @@ export {
   runWithConcurrency,
   TaskStore,
   SQLiteTaskStore,
-  // Backwards compatibility aliases
-  GoalStore,
-  SQLiteGoalStore,
   TriggerStore,
   SQLiteTriggerStore,
   SQLiteMemoryStore,
@@ -65,10 +60,8 @@ export {
   browserTools,
   createBrowserTools,
   taskTools,
-  goalTools,   // backwards compatibility alias
   triggerTools,
   jobTools,
-  cronTools,   // backwards compatibility alias
   eventTools,
   appgenTools,
 } from './tools/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stevederico/dotbot",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "AI agent CLI and library for Node.js — streaming, multi-provider, tool execution, autonomous tasks",
   "type": "module",
   "main": "index.js",

package/storage/SQLiteCronAdapter.js

@@ -220,16 +220,7 @@ export class SQLiteCronStore extends CronStore {
       "SELECT * FROM cron_tasks WHERE session_id = ? AND name != 'heartbeat' ORDER BY next_run_at ASC"
     ).all(sessionId || 'default');
 
-    return rows.map(r => ({
-      id: r.id,
-      name: r.name,
-      prompt: r.prompt,
-      nextRunAt: new Date(r.next_run_at),
-      recurring: !!r.recurring,
-      intervalMs: r.interval_ms,
-      enabled: !!r.enabled,
-      lastRunAt: r.last_run_at ? new Date(r.last_run_at) : null,
-    }));
+    return rows.map(r => this._rowToTask(r));
   }
 
   /**
@@ -257,18 +248,7 @@ export class SQLiteCronStore extends CronStore {
 
     const rows = this.db.prepare(query).all(...params);
 
-    return rows.map(r => ({
-      id: r.id,
-      name: r.name,
-      prompt: r.prompt,
-      sessionId: r.session_id,
-      nextRunAt: new Date(r.next_run_at),
-      recurring: !!r.recurring,
-      intervalMs: r.interval_ms,
-      enabled: !!r.enabled,
-      lastRunAt: r.last_run_at ? new Date(r.last_run_at) : null,
-      createdAt: new Date(r.created_at),
-    }));
+    return rows.map(r => this._rowToTask(r));
   }
 
   /**
@@ -374,53 +354,6 @@ export class SQLiteCronStore extends CronStore {
     return null;
   }
 
-  /**
-   * Ensure a Morning Brief job exists for the user (disabled by default).
-   * Creates a daily recurring job at 8:00 AM if not present.
-   *
-   * @param {string} userId - User ID
-   * @returns {Promise<Object|null>} Created task or null if already exists
-   */
-  async ensureMorningBrief(userId) {
-    if (!this.db || !userId) return null;
-
-    // Check if Morning Brief already exists for this user
-    const existing = this.db.prepare(
-      `SELECT id FROM cron_tasks WHERE user_id = ? AND name = 'Morning Brief' LIMIT 1`
-    ).get(userId);
-    if (existing) return null;
-
-    const DAY_MS = 24 * 60 * 60 * 1000;
-    const MORNING_BRIEF_PROMPT = `Good morning! Give me a brief summary to start my day:
-1. What's on my calendar today?
-2. Any important reminders or tasks due?
-3. A quick weather update for my location.
-Keep it concise and actionable.`;
-
-    // Calculate next 8:00 AM
-    const now = new Date();
-    const today8AM = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 8, 0, 0, 0);
-    const nextRun = now.getTime() < today8AM.getTime()
-      ? today8AM.getTime()
-      : today8AM.getTime() + DAY_MS;
-
-    const id = crypto.randomUUID();
-    const nowMs = Date.now();
-
-    const result = this.db.prepare(`
-      INSERT OR IGNORE INTO cron_tasks (id, name, prompt, session_id, user_id, next_run_at, interval_ms, recurring, enabled, created_at, last_run_at)
-      VALUES (?, 'Morning Brief', ?, 'default', ?, ?, ?, 1, 0, ?, NULL)
-    `).run(id, MORNING_BRIEF_PROMPT, userId, nextRun, DAY_MS, nowMs);
-
-    if (result.changes > 0) {
-      const runTime = new Date(nextRun);
-      console.log(`[cron] created Morning Brief for user ${userId}, next run at ${runTime.toLocaleTimeString()} (disabled by default)`);
-      return { id };
-    }
-
-    return null;
-  }
-
   /**
    * Get heartbeat status for a user
    *
@@ -455,35 +388,18 @@ Keep it concise and actionable.`;
   async resetHeartbeat(userId) {
     if (!this.db || !userId) return null;
 
-    const deleted = this.db.prepare(
+    this.db.prepare(
       "DELETE FROM cron_tasks WHERE user_id = ? AND name = 'heartbeat'"
     ).run(userId);
     console.log(`[cron] deleted existing heartbeat(s) for user ${userId}`);
 
-    const jitter = Math.floor(Math.random() * HEARTBEAT_INTERVAL_MS);
-    const now = Date.now();
-    const id = crypto.randomUUID();
+    const result = await this.ensureHeartbeat(userId);
 
-    this.db.prepare(`
-      INSERT INTO cron_tasks (id, name, prompt, session_id, user_id, next_run_at, interval_ms, recurring, enabled, created_at, last_run_at)
-      VALUES (?, 'heartbeat', ?, 'default', ?, ?, ?, 1, 1, ?, NULL)
-    `).run(id, HEARTBEAT_PROMPT, userId, now + jitter, HEARTBEAT_INTERVAL_MS, now);
-
-    console.log(`[cron] created new heartbeat for user ${userId}, first run in ${Math.round(jitter / 60000)}m`);
+    if (!result) return null;
 
-    return {
-      id,
-      name: 'heartbeat',
-      prompt: HEARTBEAT_PROMPT,
-      userId,
-      sessionId: 'default',
-      nextRunAt: new Date(now + jitter),
-      intervalMs: HEARTBEAT_INTERVAL_MS,
-      recurring: true,
-      enabled: true,
-      createdAt: new Date(now),
-      lastRunAt: null,
-    };
+    // Return the full task object for the newly created heartbeat
+    const row = this.db.prepare('SELECT * FROM cron_tasks WHERE id = ?').get(result.id);
+    return row ? this._rowToTask(row) : null;
   }
 
   /**

package/storage/index.js

@@ -5,9 +5,6 @@ export { CronStore } from './CronStore.js';
 export { SQLiteCronStore, parseInterval, HEARTBEAT_INTERVAL_MS, HEARTBEAT_PROMPT } from './SQLiteCronAdapter.js';
 export { TaskStore } from './TaskStore.js';
 export { SQLiteTaskStore } from './SQLiteTaskAdapter.js';
-// Backwards compatibility aliases
-export { TaskStore as GoalStore } from './TaskStore.js';
-export { SQLiteTaskStore as SQLiteGoalStore } from './SQLiteTaskAdapter.js';
 export { TriggerStore } from './TriggerStore.js';
 export { SQLiteTriggerStore } from './SQLiteTriggerAdapter.js';
 export { SQLiteMemoryStore } from './SQLiteMemoryAdapter.js';

package/tools/appgen.js

@@ -57,14 +57,7 @@ export function cleanGeneratedCode(code) {
   if (!code) return { code: '', windowSize: { width: 800, height: 650 } };
 
   let cleanCode = code
-    // Remove markdown code blocks
-    .replace(/```javascript/gi, '')
-    .replace(/```jsx/gi, '')
-    .replace(/```js/gi, '')
-    .replace(/```react/gi, '')
-    .replace(/```typescript/gi, '')
-    .replace(/```tsx/gi, '')
-    .replace(/```/g, '')
+    .replace(/```(?:javascript|jsx|js|react|typescript|tsx)?/gi, '')
     // Remove HTML document wrappers
     .replace(/<html[^>]*>[\s\S]*<\/html>/gi, '')
     .replace(/<head[^>]*>[\s\S]*<\/head>/gi, '')
@@ -307,5 +300,3 @@ export const appgenTools = [
     }
   }
 ];
-
-export default appgenTools;

package/tools/browser.js

@@ -616,21 +616,6 @@ export function createBrowserTools(screenshotUrlPattern = (filename) => `/api/ag
             pageSummary += `\n\nPage structure:\n${trimmed}`;
           }
 
-          // Log to activity so Photos app can list the screenshot
-          if (context?.databaseManager) {
-            try {
-              await context.databaseManager.logAgentActivity(
-                context.dbConfig.dbType,
-                context.dbConfig.db,
-                context.dbConfig.connectionString,
-                context.userID,
-                { type: 'image_generation', prompt: `Screenshot: ${title}`, url: screenshotUrl, source: 'browser' }
-              );
-            } catch {
-              /* best effort */
-            }
-          }
-
           // Return image JSON so frontend renders the screenshot inline
           return JSON.stringify({ type: 'image', url: screenshotUrl, prompt: pageSummary });
         } catch (err) {

package/tools/code.js

@@ -52,20 +52,6 @@ export const codeTools = [
 
         await unlink(tmpFile).catch(() => {});
 
-        if (context?.databaseManager) {
-          try {
-            await context.databaseManager.logAgentActivity(
-              context.dbConfig.dbType, context.dbConfig.db, context.dbConfig.connectionString,
-              context.userID, {
-                type: 'code_execution',
-                code: input.code.slice(0, 500),
-                output: (stdout || stderr || '').slice(0, 500),
-                success: !stderr
-              }
-            );
-          } catch (e) { /* best effort */ }
-        }
-
         if (stderr) {
           return `Stderr:\n${stderr}\n\nStdout:\n${stdout}`;
         }
@@ -74,20 +60,6 @@ export const codeTools = [
       } catch (err) {
         await unlink(tmpFile).catch(() => {});
 
-        if (context?.databaseManager) {
-          try {
-            await context.databaseManager.logAgentActivity(
-              context.dbConfig.dbType, context.dbConfig.db, context.dbConfig.connectionString,
-              context.userID, {
-                type: 'code_execution',
-                code: input.code.slice(0, 500),
-                output: (err.stderr || err.message || '').slice(0, 500),
-                success: false
-              }
-            );
-          } catch (e) { /* best effort */ }
-        }
-
         if (err.killed) {
           return "Error: code execution timed out (10s limit)";
         }

package/tools/images.js

@@ -176,16 +176,6 @@ export const imageTools = [
         return result.error;
       }
 
-      // Log to activity for persistence
-      if (context?.databaseManager) {
-        try {
-          await context.databaseManager.logAgentActivity(
-            context.dbConfig.dbType, context.dbConfig.db, context.dbConfig.connectionString,
-            context.userID, { type: 'image_generation', prompt: input.prompt, url: result.url, source: 'agent' }
-          );
-        } catch (e) { /* best effort */ }
-      }
-
       return JSON.stringify({ type: 'image', url: result.url, prompt: input.prompt });
     },
   },

package/tools/index.js

@@ -13,9 +13,9 @@ import { imageTools } from './images.js';
 import { weatherTools } from './weather.js';
 import { notifyTools } from './notify.js';
 import { browserTools, createBrowserTools } from './browser.js';
-import { taskTools, goalTools } from './tasks.js';
+import { taskTools } from './tasks.js';
 import { triggerTools } from './triggers.js';
-import { jobTools, cronTools } from './jobs.js';
+import { jobTools } from './jobs.js';
 import { eventTools } from './events.js';
 import { appgenTools } from './appgen.js';
 
@@ -88,10 +88,8 @@ export {
   browserTools,
   createBrowserTools,
   taskTools,
-  goalTools,   // backwards compatibility alias
   triggerTools,
   jobTools,
-  cronTools,   // backwards compatibility alias
   eventTools,
   appgenTools,
 };

package/tools/jobs.js

@@ -155,5 +155,3 @@ export const jobTools = [
   },
 ];
 
-// Backwards compatibility alias
-export const cronTools = jobTools;

package/tools/tasks.js

@@ -400,5 +400,3 @@ export const taskTools = [
   },
 ];
 
-// Backwards compatibility: export goalTools as alias
-export const goalTools = taskTools;

package/tools/web.js

@@ -70,15 +70,6 @@ export const webTools = [
               result += "\n\nSources:\n" + [...citations].slice(0, 5).map((url, i) => `${i + 1}. ${url}`).join("\n");
             }
 
-            if (context?.databaseManager) {
-              try {
-                await context.databaseManager.logAgentActivity(
-                  context.dbConfig.dbType, context.dbConfig.db, context.dbConfig.connectionString,
-                  context.userID, { type: 'web_search', query: input.query, provider: 'grok', resultPreview: result.slice(0, 300) }
-                );
-              } catch (e) { /* best effort */ }
-            }
-
             return result || "No results found.";
           } else {
             const errText = await res.text();
@@ -120,15 +111,6 @@ export const webTools = [
 
       const result = parts.join("\n\n");
 
-      if (context?.databaseManager) {
-        try {
-          await context.databaseManager.logAgentActivity(
-            context.dbConfig.dbType, context.dbConfig.db, context.dbConfig.connectionString,
-            context.userID, { type: 'web_search', query: input.query, provider: 'duckduckgo', resultPreview: parts.slice(0, 2).join('\n').slice(0, 300) }
-          );
-        } catch (e) { /* best effort */ }
-      }
-
       return result;
     },
   },
@@ -176,15 +158,6 @@ export const webTools = [
           text = text.slice(0, maxChars) + `\n\n... [truncated, ${text.length} chars total]`;
         }
 
-        if (context?.databaseManager) {
-          try {
-            await context.databaseManager.logAgentActivity(
-              context.dbConfig.dbType, context.dbConfig.db, context.dbConfig.connectionString,
-              context.userID, { type: 'grokipedia_search', query: input.query, url }
-            );
-          } catch (e) { /* best effort */ }
-        }
-
         return text;
       } catch (err) {
         return `Error looking up Grokipedia: ${err.message}`;
@@ -260,15 +233,6 @@ export const webTools = [
             .trim();
         }
 
-        if (context?.databaseManager) {
-          try {
-            await context.databaseManager.logAgentActivity(
-              context.dbConfig.dbType, context.dbConfig.db, context.dbConfig.connectionString,
-              context.userID, { type: 'web_fetch', url: input.url, status: res.status }
-            );
-          } catch (e) { /* best effort */ }
-        }
-
         const maxChars = 8000;
         if (text.length > maxChars) {
           return text.slice(0, maxChars) + `\n\n... [truncated, ${text.length} chars total]`;

package/examples/sqlite-session-example.js

@@ -1,69 +0,0 @@
-/**
- * SQLiteSessionStore Usage Example
- *
- * Demonstrates how to use SQLite as a session storage backend
- * for the @dottie/agent library. Requires Node.js 22.5+.
- */
-
-import { createAgent, SQLiteSessionStore, coreTools } from '@dottie/agent';
-
-// Initialize SQLite session store
-const sessionStore = new SQLiteSessionStore();
-await sessionStore.init('./sessions.db', {
-  // Optional: Fetch user preferences from your database
-  prefsFetcher: async (userId) => {
-    // Example: fetch from a user database
-    return {
-      agentName: 'Dottie',
-      agentPersonality: 'helpful and concise',
-    };
-  },
-  // Optional: Ensure user heartbeat for cron tasks
-  heartbeatEnsurer: async (userId) => {
-    // Example: update last_seen timestamp in user database
-    console.log(`User ${userId} active`);
-    return null;
-  },
-});
-
-// Create agent with SQLite session storage
-const agent = createAgent({
-  sessionStore,
-  providers: {
-    anthropic: { apiKey: process.env.ANTHROPIC_API_KEY },
-  },
-  tools: coreTools,
-});
-
-// Example 1: Create a new session
-const session = await agent.createSession('user-123', 'claude-sonnet-4-5', 'anthropic');
-console.log('Created session:', session.id);
-
-// Example 2: Chat with the agent
-for await (const event of agent.chat({
-  sessionId: session.id,
-  message: 'What can you help me with?',
-  provider: 'anthropic',
-  model: 'claude-sonnet-4-5',
-})) {
-  if (event.type === 'content_block_delta' && event.delta?.type === 'text_delta') {
-    process.stdout.write(event.delta.text);
-  }
-}
-console.log('\n');
-
-// Example 3: List all sessions for a user
-const sessions = await sessionStore.listSessions('user-123');
-console.log('User sessions:', sessions);
-
-// Example 4: Get or create default session
-const defaultSession = await sessionStore.getOrCreateDefaultSession('user-123');
-console.log('Default session:', defaultSession.id);
-
-// Example 5: Clear session history
-await sessionStore.clearSession(session.id);
-console.log('Session cleared');
-
-// Example 6: Delete a session
-await sessionStore.deleteSession(session.id, 'user-123');
-console.log('Session deleted');