circuschief 0.1.0

package/packages/server/src/db/migrations/miscMigrations.js

@@ -0,0 +1,242 @@
+/**
+ * Migrations for miscellaneous tables: command_buttons, session_templates,
+ * app_settings, providers, provider_models, agent_call_logs.
+ * Each export is an array of { name, up(db) } migration objects.
+ */
+import { randomUUID } from 'node:crypto';
+import { addColumnIfMissing, tableExists } from './migrationUtils.js';
+
+/**
+ * Seed the built-in Anthropic provider if it doesn't exist.
+ */
+function seedBuiltInProvider(db) {
+  const providerId = 'anthropic-default';
+
+  const existing = db
+    .prepare('SELECT id FROM providers WHERE id = ?')
+    .get(providerId);
+
+  if (!existing) {
+    const now = Date.now();
+    db.prepare(
+      `INSERT INTO providers (id, name, is_built_in, created_at, updated_at)
+       VALUES (?, ?, 1, ?, ?)`
+    ).run(providerId, 'Anthropic (Official)', now, now);
+  }
+
+  // Seed default Anthropic models if they don't exist
+  const defaultModels = [
+    { id: 'anthropic-haiku', modelId: 'claude-haiku-4-5-20251001', displayName: 'Haiku 4.5', description: 'Fast & lightweight', tier: 'haiku' },
+    { id: 'anthropic-sonnet', modelId: 'claude-sonnet-4-6', displayName: 'Sonnet 4.6', description: 'Balanced', tier: 'sonnet' },
+    { id: 'anthropic-opus', modelId: 'claude-opus-4-6', displayName: 'Opus 4.6', description: 'Most capable (default)', tier: 'opus' },
+  ];
+
+  const insertModel = db.prepare(
+    `INSERT OR IGNORE INTO provider_models (id, provider_id, model_id, display_name, description, tier, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`
+  );
+
+  const now = Date.now();
+  for (const model of defaultModels) {
+    insertModel.run(model.id, providerId, model.modelId, model.displayName, model.description, model.tier, now);
+  }
+}
+
+/**
+ * Update built-in models to 4.6 versions.
+ */
+function updateBuiltInModels(db) {
+  const providerId = 'anthropic-default';
+
+  db.prepare(
+    `UPDATE provider_models
+     SET model_id = ?, display_name = ?
+     WHERE provider_id = ? AND id = ?`
+  ).run('claude-sonnet-4-6', 'Sonnet 4.6', providerId, 'anthropic-sonnet');
+
+  db.prepare(
+    `UPDATE provider_models
+     SET model_id = ?, display_name = ?
+     WHERE provider_id = ? AND id = ?`
+  ).run('claude-opus-4-6', 'Opus 4.6', providerId, 'anthropic-opus');
+}
+
+/**
+ * Seed default global quick responses when the table is empty.
+ */
+function seedDefaultQuickResponses(db) {
+  const count = db.prepare('SELECT COUNT(*) AS cnt FROM quick_responses').get().cnt;
+  if (count > 0) return;
+
+  const defaults = [
+    { label: 'Put a plan on the canvas', content: 'Put a plan on the canvas to get this done', autoSubmit: false, sortOrder: 0 },
+    { label: 'Yes', content: 'Yes', autoSubmit: true, sortOrder: 1 },
+    { label: 'Review the plan', content: `Review the plan on the canvas. Are there any issues that you can find? Is test coverage specified explicitly enough? Does the current code match the assumptions in the plan?\n\nList the issues that you find and then update the plan on the canvas to address any issues that you find. Don't talk about issues with the original plan in the plan itself. Just tell me what the issues are, and update the plan so that the plan doesn't have the issues.`, autoSubmit: true, sortOrder: 2 },
+    { label: 'Implement the plan on the canvas', content: 'Implement the plan on the canvas', autoSubmit: true, sortOrder: 3 },
+    { label: 'Create / Update PR', content: `Ensure all relevant changes are committed and pushed. Then look at the session's summary and create a draft PR if no PR already exists.`, autoSubmit: true, sortOrder: 4 },
+    { label: 'Review PR', content: 'Look at the PR related to the root session. Review the PR. Are there any issues? Are best practices adhered to? Does the PR accomplish the goal? Are all changes covered by tests?', autoSubmit: true, sortOrder: 5 },
+    { label: 'Add tests', content: 'Inspect the changes on our branch. For each change, ensure we have tests that assert the change is working in the expected way. Implement the tests.', autoSubmit: true, sortOrder: 6 },
+    { label: 'Merge in main', content: 'Merge in the latest main branch', autoSubmit: true, sortOrder: 7 },
+    { label: 'Add tests to the plan', content: 'Call out specific test cases in the plan, we should have an assertion for each change called for in the plan', autoSubmit: true, sortOrder: 8 },
+    { label: 'Tests are failing', content: 'Tests are failing. Look at the canvas for details', autoSubmit: true, sortOrder: 9 },
+    { label: 'Continue', content: 'Continue', autoSubmit: true, sortOrder: 10 },
+  ];
+
+  const stmt = db.prepare(
+    `INSERT INTO quick_responses
+     (id, project_id, label, content, auto_submit, category, sort_order, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
+  );
+
+  const now = Date.now();
+  for (const item of defaults) {
+    stmt.run(randomUUID(), null, item.label, item.content, item.autoSubmit ? 1 : 0, null, item.sortOrder, now, now);
+  }
+}
+
+/** @type {Array<{name: string, up: (db: import('better-sqlite3').Database) => void}>} */
+export const miscMigrations = [
+  // --- Command buttons ---
+  {
+    name: 'command_buttons-add-show_on_list',
+    up(db) {
+      addColumnIfMissing(db, 'command_buttons', 'show_on_list', 'INTEGER NOT NULL DEFAULT 0');
+    },
+  },
+
+  // --- Session templates ---
+  {
+    name: 'session_templates-add-model',
+    up(db) { addColumnIfMissing(db, 'session_templates', 'model', 'TEXT'); },
+  },
+  {
+    name: 'session_templates-add-mode',
+    up(db) {
+      addColumnIfMissing(
+        db, 'session_templates', 'mode',
+        "TEXT DEFAULT 'yolo' CHECK(mode IN ('plan', 'standard', 'yolo'))"
+      );
+    },
+  },
+  {
+    name: 'session_templates-add-effort_level',
+    up(db) {
+      addColumnIfMissing(
+        db, 'session_templates', 'effort_level',
+        "TEXT CHECK(effort_level IN ('low', 'medium', 'high', 'max', 'auto'))"
+      );
+    },
+  },
+
+  // --- App settings table ---
+  {
+    name: 'app_settings-create-table',
+    up(db) {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS app_settings (
+          key TEXT PRIMARY KEY,
+          value TEXT NOT NULL,
+          updated_at INTEGER NOT NULL
+        )
+      `);
+    },
+  },
+
+  // --- Legacy model_providers cleanup ---
+  {
+    name: 'model_providers-cleanup-legacy',
+    up(db) {
+      const hasLegacyTable = tableExists(db, 'model_providers');
+      if (hasLegacyTable) {
+        db.exec('DROP TABLE IF EXISTS provider_models');
+        db.exec('DROP TABLE IF EXISTS model_providers');
+      }
+    },
+  },
+
+  // --- Providers and provider_models tables ---
+  {
+    name: 'providers-create-tables',
+    up(db) {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS providers (
+          id TEXT PRIMARY KEY,
+          name TEXT NOT NULL,
+          base_url TEXT,
+          auth_token TEXT,
+          api_timeout_ms INTEGER,
+          additional_env_vars TEXT,
+          is_built_in INTEGER NOT NULL DEFAULT 0,
+          created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+          updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+        );
+
+        CREATE TABLE IF NOT EXISTS provider_models (
+          id TEXT PRIMARY KEY,
+          provider_id TEXT NOT NULL REFERENCES providers(id) ON DELETE CASCADE,
+          model_id TEXT NOT NULL,
+          display_name TEXT NOT NULL,
+          description TEXT,
+          tier TEXT CHECK(tier IN ('opus', 'sonnet', 'haiku', 'custom')),
+          created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+        );
+        CREATE INDEX IF NOT EXISTS idx_provider_models_provider ON provider_models(provider_id);
+      `);
+    },
+  },
+
+  // --- Seed built-in provider ---
+  {
+    name: 'providers-seed-built-in',
+    up(db) { seedBuiltInProvider(db); },
+  },
+
+  // --- Update built-in models to 4.6 ---
+  {
+    name: 'providers-update-built-in-models',
+    up(db) { updateBuiltInModels(db); },
+  },
+
+  // --- Agent call logs table ---
+  {
+    name: 'agent_call_logs-create-table',
+    up(db) {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS agent_call_logs (
+          id TEXT PRIMARY KEY,
+          session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
+          conversation_id TEXT,
+          agent_type TEXT NOT NULL,
+          model TEXT,
+          call_type TEXT NOT NULL,
+          prompt_length INTEGER,
+          input_tokens INTEGER DEFAULT 0,
+          output_tokens INTEGER DEFAULT 0,
+          thinking_tokens INTEGER DEFAULT 0,
+          cache_read_tokens INTEGER DEFAULT 0,
+          cache_write_tokens INTEGER DEFAULT 0,
+          total_tokens INTEGER DEFAULT 0,
+          started_at INTEGER NOT NULL,
+          completed_at INTEGER,
+          duration_ms INTEGER,
+          status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending', 'streaming', 'completed', 'error')),
+          error_message TEXT,
+          metadata TEXT,
+          created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+        );
+        CREATE INDEX IF NOT EXISTS idx_agent_call_logs_session ON agent_call_logs(session_id);
+        CREATE INDEX IF NOT EXISTS idx_agent_call_logs_started ON agent_call_logs(started_at);
+        CREATE INDEX IF NOT EXISTS idx_agent_call_logs_agent_type ON agent_call_logs(agent_type);
+        CREATE INDEX IF NOT EXISTS idx_agent_call_logs_call_type ON agent_call_logs(call_type);
+        CREATE INDEX IF NOT EXISTS idx_agent_call_logs_status ON agent_call_logs(status);
+        CREATE INDEX IF NOT EXISTS idx_agent_call_logs_model ON agent_call_logs(model);
+      `);
+    },
+  },
+
+  // --- Seed default global quick responses ---
+  {
+    name: 'quick_responses-seed-defaults',
+    up(db) { seedDefaultQuickResponses(db); },
+  },
+];

package/packages/server/src/db/migrations/projectsMigrations.js

@@ -0,0 +1,95 @@
+/**
+ * Migrations for the projects table and project-related tables.
+ * Each export is an array of { name, up(db) } migration objects.
+ */
+import { addColumnIfMissing, getColumns, tableExists } from './migrationUtils.js';
+
+/**
+ * Drop legacy project-level summary columns from the projects table.
+ * These settings have been consolidated under global settings (SettingsRepository).
+ */
+function migrateProjectsDropSummaryColumns(db) {
+  const columns = getColumns(db, 'projects');
+
+  const columnsToRemove = [
+    'disable_session_summaries',
+    'disable_conversation_summaries',
+    'summary_debounce_ms',
+    'session_title_prompt',
+  ];
+
+  for (const col of columnsToRemove) {
+    if (columns.includes(col)) {
+      db.exec(`ALTER TABLE projects DROP COLUMN ${col}`);
+    }
+  }
+}
+
+/** @type {Array<{name: string, up: (db: import('better-sqlite3').Database) => void}>} */
+export const projectsMigrations = [
+  {
+    name: 'projects-add-system_prompt',
+    up(db) { addColumnIfMissing(db, 'projects', 'system_prompt', 'TEXT'); },
+  },
+  {
+    name: 'projects-add-on_session_created',
+    up(db) { addColumnIfMissing(db, 'projects', 'on_session_created', 'TEXT'); },
+  },
+  {
+    name: 'projects-add-on_session_deleted',
+    up(db) { addColumnIfMissing(db, 'projects', 'on_session_deleted', 'TEXT'); },
+  },
+  {
+    name: 'projects-add-repo_url',
+    up(db) { addColumnIfMissing(db, 'projects', 'repo_url', 'TEXT'); },
+  },
+  {
+    name: 'projects-drop-summary-columns',
+    up(db) { migrateProjectsDropSummaryColumns(db); },
+  },
+
+  // --- Project session defaults table ---
+  {
+    name: 'project_session_defaults-create-table',
+    up(db) {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS project_session_defaults (
+          id TEXT PRIMARY KEY,
+          project_id TEXT NOT NULL UNIQUE,
+          mode TEXT CHECK(mode IN ('plan', 'standard', 'yolo')),
+          thinking_enabled INTEGER,
+          start_immediately INTEGER,
+          git_mode TEXT CHECK(git_mode IN ('branch', 'worktree')),
+          git_branch TEXT,
+          model TEXT,
+          created_at INTEGER NOT NULL,
+          updated_at INTEGER NOT NULL,
+          FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+        );
+        CREATE INDEX IF NOT EXISTS idx_project_defaults_projectId ON project_session_defaults(project_id);
+      `);
+    },
+  },
+  {
+    name: 'project_session_defaults-add-provider_id',
+    up(db) {
+      if (tableExists(db, 'project_session_defaults')) {
+        addColumnIfMissing(
+          db, 'project_session_defaults', 'provider_id',
+          'TEXT REFERENCES providers(id)'
+        );
+      }
+    },
+  },
+  {
+    name: 'project_session_defaults-add-effort_level',
+    up(db) {
+      if (tableExists(db, 'project_session_defaults')) {
+        addColumnIfMissing(
+          db, 'project_session_defaults', 'effort_level',
+          "TEXT CHECK(effort_level IN ('low', 'medium', 'high', 'max', 'auto'))"
+        );
+      }
+    },
+  },
+];

package/packages/server/src/db/migrations/sessionsMigrations.js

@@ -0,0 +1,282 @@
+/**
+ * Migrations for the sessions table and closely related session tables.
+ * Each export is an array of { name, up(db) } migration objects.
+ */
+import { addColumnIfMissing, getColumns, getTableSql } from './migrationUtils.js';
+
+// Table name constants for migrations
+const TABLE_SESSIONS = 'sessions';
+
+// Column type constants
+const COL_INTEGER_DEFAULT_0 = 'INTEGER DEFAULT 0';
+
+/**
+ * Migrate sessions table to include 'stopped' and 'scheduled' in status CHECK constraint.
+ * SQLite doesn't support ALTER TABLE to modify constraints, so we recreate the table.
+ */
+function migrateSessionsStatusConstraint(db) {
+  const tableSql = getTableSql(db, TABLE_SESSIONS);
+
+  // If schema already includes 'scheduled', no migration needed
+  if (tableSql?.includes("'scheduled'")) {
+    return;
+  }
+
+  // Get all columns from the current table to preserve data
+  const columnNames = getColumns(db, TABLE_SESSIONS);
+
+  const baseColumns = `
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      name TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'starting' CHECK (status IN ('starting', 'running', 'waiting', 'stopped', 'completed', 'error', 'scheduled')),
+      mode TEXT NOT NULL DEFAULT 'standard' CHECK (mode IN ('plan', 'standard', 'yolo')),
+      thinking_enabled INTEGER NOT NULL DEFAULT 0,
+      git_branch TEXT,
+      git_worktree TEXT,
+      pr_url TEXT,
+      error TEXT,
+      effort_level TEXT CHECK(effort_level IN ('low', 'medium', 'high', 'max', 'auto')),
+      cost_usd REAL DEFAULT 0,
+      claude_session_id TEXT,
+      model TEXT,
+      next_template_id TEXT REFERENCES session_templates(id) ON DELETE SET NULL,
+      parent_session_id TEXT REFERENCES sessions(id) ON DELETE SET NULL,
+      input_tokens INTEGER DEFAULT 0,
+      output_tokens INTEGER DEFAULT 0,
+      cache_read_input_tokens INTEGER DEFAULT 0,
+      cache_creation_input_tokens INTEGER DEFAULT 0,
+      web_search_requests INTEGER DEFAULT 0,
+      context_window INTEGER DEFAULT 200000,
+      archived INTEGER NOT NULL DEFAULT 0,
+      starred INTEGER NOT NULL DEFAULT 0,
+      manually_named INTEGER NOT NULL DEFAULT 0,
+      scheduled_at INTEGER DEFAULT NULL,
+      reschedule_delay_minutes INTEGER DEFAULT 15,
+      auto_reschedule_enabled INTEGER DEFAULT 0,
+      reschedule_on_token_limit INTEGER DEFAULT 1,
+      reschedule_on_service_error INTEGER DEFAULT 1,
+      max_reschedule_count INTEGER DEFAULT NULL,
+      max_total_tokens INTEGER DEFAULT NULL,
+      reschedule_count INTEGER DEFAULT 0,
+      reschedule_at_token_count INTEGER DEFAULT NULL,
+      created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+      updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+  `;
+
+  const selectColumns = [
+    'id', 'project_id', 'name', 'status', 'mode', 'thinking_enabled',
+    'git_branch', 'git_worktree', 'pr_url', 'error', 'effort_level',
+    'cost_usd', 'claude_session_id', 'model', 'next_template_id',
+    'parent_session_id', 'input_tokens', 'output_tokens',
+    'cache_read_input_tokens', 'cache_creation_input_tokens',
+    'web_search_requests', 'context_window', 'archived', 'starred',
+    'manually_named', 'scheduled_at', 'reschedule_delay_minutes',
+    'auto_reschedule_enabled', 'reschedule_on_token_limit',
+    'reschedule_on_service_error', 'max_reschedule_count',
+    'max_total_tokens', 'reschedule_count', 'reschedule_at_token_count',
+    'created_at', 'updated_at',
+  ]
+    .filter((col) => columnNames.includes(col))
+    .join(', ');
+
+  db.exec(`
+    CREATE TABLE sessions_new (
+      ${baseColumns}
+    );
+
+    INSERT INTO sessions_new (${selectColumns})
+    SELECT ${selectColumns} FROM sessions;
+
+    DROP TABLE sessions;
+
+    ALTER TABLE sessions_new RENAME TO sessions;
+
+    CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_id);
+    CREATE INDEX IF NOT EXISTS idx_sessions_status ON sessions(status);
+    CREATE INDEX IF NOT EXISTS idx_sessions_archived ON sessions(archived);
+    CREATE INDEX IF NOT EXISTS idx_sessions_starred ON sessions(archived, starred);
+    CREATE INDEX IF NOT EXISTS idx_sessions_next_template ON sessions(next_template_id);
+    CREATE INDEX IF NOT EXISTS idx_sessions_parent ON sessions(parent_session_id);
+    CREATE INDEX IF NOT EXISTS idx_sessions_scheduled ON sessions(scheduled_at) WHERE scheduled_at IS NOT NULL;
+  `);
+}
+
+/** @type {Array<{name: string, up: (db: import('better-sqlite3').Database) => void}>} */
+export const sessionsMigrations = [
+  // --- Initial sessions columns ---
+  {
+    name: 'sessions-add-cost_usd',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'cost_usd', 'REAL DEFAULT 0'); },
+  },
+  {
+    name: 'sessions-add-claude_session_id',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'claude_session_id', 'TEXT'); },
+  },
+  {
+    name: 'sessions-add-model',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'model', 'TEXT'); },
+  },
+  {
+    name: 'sessions-add-provider_id-early',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'provider_id', 'TEXT'); },
+  },
+  {
+    name: 'sessions-add-effort_level',
+    up(db) {
+      addColumnIfMissing(
+        db, TABLE_SESSIONS, 'effort_level',
+        "TEXT CHECK(effort_level IN ('low', 'medium', 'high', 'max', 'auto'))"
+      );
+    },
+  },
+
+  // --- Scheduling columns ---
+  {
+    name: 'sessions-add-scheduled_at',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'scheduled_at', 'INTEGER DEFAULT NULL'); },
+  },
+  {
+    name: 'sessions-add-reschedule_delay_minutes',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'reschedule_delay_minutes', 'INTEGER DEFAULT 15'); },
+  },
+  {
+    name: 'sessions-add-auto_reschedule_enabled',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'auto_reschedule_enabled', COL_INTEGER_DEFAULT_0); },
+  },
+  {
+    name: 'sessions-add-reschedule_on_token_limit',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'reschedule_on_token_limit', 'INTEGER DEFAULT 1'); },
+  },
+  {
+    name: 'sessions-add-reschedule_on_service_error',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'reschedule_on_service_error', 'INTEGER DEFAULT 1'); },
+  },
+  {
+    name: 'sessions-add-max_reschedule_count',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'max_reschedule_count', 'INTEGER DEFAULT NULL'); },
+  },
+  {
+    name: 'sessions-add-max_total_tokens',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'max_total_tokens', 'INTEGER DEFAULT NULL'); },
+  },
+  {
+    name: 'sessions-add-reschedule_count',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'reschedule_count', COL_INTEGER_DEFAULT_0); },
+  },
+  {
+    name: 'sessions-add-reschedule_at_token_count',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'reschedule_at_token_count', 'INTEGER DEFAULT NULL'); },
+  },
+
+  // --- Status constraint migration (table recreation) ---
+  {
+    name: 'sessions-migrate-status-constraint',
+    up(db) { migrateSessionsStatusConstraint(db); },
+  },
+
+  // --- Template chaining ---
+  {
+    name: 'sessions-add-next_template_id',
+    up(db) {
+      addColumnIfMissing(
+        db, TABLE_SESSIONS, 'next_template_id',
+        'TEXT REFERENCES session_templates(id) ON DELETE SET NULL'
+      );
+    },
+  },
+  {
+    name: 'sessions-add-parent_session_id',
+    up(db) {
+      addColumnIfMissing(
+        db, TABLE_SESSIONS, 'parent_session_id',
+        'TEXT REFERENCES sessions(id) ON DELETE SET NULL'
+      );
+    },
+  },
+  {
+    name: 'sessions-template-chaining-indexes',
+    up(db) {
+      db.exec('CREATE INDEX IF NOT EXISTS idx_sessions_next_template ON sessions(next_template_id)');
+      db.exec('CREATE INDEX IF NOT EXISTS idx_sessions_parent ON sessions(parent_session_id)');
+    },
+  },
+
+  // --- Token usage columns ---
+  {
+    name: 'sessions-add-input_tokens',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'input_tokens', COL_INTEGER_DEFAULT_0); },
+  },
+  {
+    name: 'sessions-add-output_tokens',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'output_tokens', COL_INTEGER_DEFAULT_0); },
+  },
+  {
+    name: 'sessions-add-cache_read_input_tokens',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'cache_read_input_tokens', COL_INTEGER_DEFAULT_0); },
+  },
+  {
+    name: 'sessions-add-cache_creation_input_tokens',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'cache_creation_input_tokens', COL_INTEGER_DEFAULT_0); },
+  },
+  {
+    name: 'sessions-add-web_search_requests',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'web_search_requests', COL_INTEGER_DEFAULT_0); },
+  },
+  {
+    name: 'sessions-add-context_window',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'context_window', 'INTEGER DEFAULT 200000'); },
+  },
+
+  // --- Archived / starred / manually_named ---
+  {
+    name: 'sessions-add-archived',
+    up(db) {
+      addColumnIfMissing(db, TABLE_SESSIONS, 'archived', 'INTEGER NOT NULL DEFAULT 0');
+      db.exec('CREATE INDEX IF NOT EXISTS idx_sessions_archived ON sessions(archived)');
+    },
+  },
+  {
+    name: 'sessions-add-starred',
+    up(db) {
+      addColumnIfMissing(db, TABLE_SESSIONS, 'starred', 'INTEGER NOT NULL DEFAULT 0');
+      db.exec('CREATE INDEX IF NOT EXISTS idx_sessions_starred ON sessions(archived, starred)');
+    },
+  },
+  {
+    name: 'sessions-add-manually_named',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'manually_named', 'INTEGER NOT NULL DEFAULT 0'); },
+  },
+
+  // --- Pending prompt / slash commands / pending model / auto send ---
+  {
+    name: 'sessions-add-pending_prompt',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'pending_prompt', 'TEXT'); },
+  },
+  {
+    name: 'sessions-add-slash_commands',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'slash_commands', 'TEXT'); },
+  },
+  {
+    name: 'sessions-add-pending_model',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'pending_model', 'TEXT'); },
+  },
+  {
+    name: 'sessions-add-auto_send_pending_prompt',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'auto_send_pending_prompt', COL_INTEGER_DEFAULT_0); },
+  },
+
+  // --- Provider ID (from providers table, added later in sequence) ---
+  {
+    name: 'sessions-add-provider_id-from-providers',
+    up(db) {
+      addColumnIfMissing(db, TABLE_SESSIONS, 'provider_id', 'TEXT REFERENCES providers(id)');
+    },
+  },
+
+  // --- Agent type ---
+  {
+    name: 'sessions-add-agent_type',
+    up(db) { addColumnIfMissing(db, TABLE_SESSIONS, 'agent_type', "TEXT DEFAULT 'claude-code'"); },
+  },
+];