@mndrk/agx 2.0.0 → 2.0.2

package/cloud-runtime/standalone/Projects/Agents/agx-cloud/hooks/useNotifications.ts

@@ -1,115 +0,0 @@
-"use client";
-
-import { useCallback, useEffect, useRef, useState } from "react";
-
-export interface Notification {
-  id: string;
-  user_id: string;
-  task_id: string | null;
-  event_id: string | null;
-  type: string;
-  tier: string | null;
-  title: string;
-  body: string | null;
-  created_at: string;
-  read_at: string | null;
-}
-
-interface UseNotificationsOptions {
-  pollInterval?: number;
-  limit?: number;
-}
-
-export function useNotifications({ pollInterval = 15000, limit = 20 }: UseNotificationsOptions = {}) {
-  const [notifications, setNotifications] = useState<Notification[]>([]);
-  const [unreadCount, setUnreadCount] = useState(0);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState<string | null>(null);
-  const [nextCursor, setNextCursor] = useState<string | null>(null);
-  const timerRef = useRef<ReturnType<typeof setInterval> | null>(null);
-
-  const fetchUnreadCount = useCallback(async () => {
-    try {
-      const res = await fetch("/api/notifications/unread-count");
-      if (!res.ok) return;
-      const data = await res.json();
-      setUnreadCount(data.count ?? 0);
-    } catch {
-      // swallow — badge will be stale
-    }
-  }, []);
-
-  const fetchNotifications = useCallback(async (replace = true) => {
-    try {
-      if (replace) setLoading(true);
-      const url = replace
-        ? `/api/notifications?limit=${limit}`
-        : `/api/notifications?limit=${limit}&cursor=${nextCursor}`;
-      const res = await fetch(url);
-      if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      const data = await res.json();
-      const items: Notification[] = data.notifications ?? [];
-      if (replace) {
-        setNotifications(items);
-      } else {
-        setNotifications((prev) => [...prev, ...items]);
-      }
-      setNextCursor(data.next_cursor ?? null);
-      setError(null);
-    } catch (err) {
-      setError(err instanceof Error ? err.message : "Failed to load notifications");
-    } finally {
-      if (replace) setLoading(false);
-    }
-  }, [limit, nextCursor]);
-
-  const refresh = useCallback(async () => {
-    await Promise.all([fetchNotifications(true), fetchUnreadCount()]);
-  }, [fetchNotifications, fetchUnreadCount]);
-
-  const loadMore = useCallback(async () => {
-    if (!nextCursor) return;
-    await fetchNotifications(false);
-  }, [nextCursor, fetchNotifications]);
-
-  const markAsRead = useCallback(async (id: string) => {
-    // Optimistic update
-    setNotifications((prev) =>
-      prev.map((n) => (n.id === id ? { ...n, read_at: new Date().toISOString() } : n))
-    );
-    setUnreadCount((c) => Math.max(0, c - 1));
-
-    try {
-      const res = await fetch(`/api/notifications/${id}/read`, { method: "PATCH" });
-      if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    } catch {
-      // Roll back on failure
-      await refresh();
-    }
-  }, [refresh]);
-
-  // Initial fetch + polling
-  useEffect(() => {
-    void refresh();
-
-    timerRef.current = setInterval(() => {
-      void refresh();
-    }, pollInterval);
-
-    return () => {
-      if (timerRef.current) clearInterval(timerRef.current);
-    };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [pollInterval]);
-
-  return {
-    notifications,
-    unreadCount,
-    loading,
-    error,
-    hasMore: nextCursor !== null,
-    refresh,
-    loadMore,
-    markAsRead,
-  };
-}

package/cloud-runtime/standalone/Projects/Agents/agx-cloud/lib/db/cursors.js

@@ -1,75 +0,0 @@
-/**
- * lib/db/cursors.js
- *
- * Durable per-consumer cursor helpers for event-stream projectors.
- * Cursors are stored in the projector_cursors table keyed by consumer_id.
- * The cursor value is the rowid (integer) of the last processed event.
- */
-
-'use strict';
-
-const { getSQLiteDb } = require('../sqlite-query-adapter');
-
-/**
- * Read the current cursor position for a consumer.
- * Returns 0 if the consumer has no recorded position (process from beginning).
- *
- * @param {string} consumerId - Unique consumer identifier (e.g. 'notification_projector')
- * @returns {number} Last processed rowid, or 0
- */
-function readCursor(consumerId) {
-  const db = getSQLiteDb();
-  const row = db.prepare(
-    'SELECT last_event_id FROM projector_cursors WHERE consumer_id = ?'
-  ).get(consumerId);
-  if (!row) return 0;
-  const pos = parseInt(row.last_event_id, 10);
-  return Number.isFinite(pos) ? pos : 0;
-}
-
-/**
- * Advance the cursor to a new position within an existing transaction.
- * The caller is responsible for wrapping this in a transaction so the cursor
- * update and the projection writes are committed atomically.
- *
- * @param {import('better-sqlite3').Database} db - SQLite connection (same one used in txn)
- * @param {string} consumerId
- * @param {number} newRowid - rowid of the last event that was successfully processed
- */
-function advanceCursorInTxn(db, consumerId, newRowid) {
-  db.prepare(`
-    INSERT INTO projector_cursors (consumer_id, last_event_id, updated_at)
-    VALUES (?, ?, strftime('%Y-%m-%dT%H:%M:%fZ','now'))
-    ON CONFLICT(consumer_id) DO UPDATE SET
-      last_event_id = excluded.last_event_id,
-      updated_at    = excluded.updated_at
-  `).run(consumerId, String(newRowid));
-}
-
-/**
- * Reset a consumer's cursor back to 0 (triggers full replay on next run).
- * Useful for testing and forced replay.
- *
- * @param {string} consumerId
- */
-function resetCursor(consumerId) {
-  const db = getSQLiteDb();
-  db.prepare(`
-    INSERT INTO projector_cursors (consumer_id, last_event_id, updated_at)
-    VALUES (?, '0', strftime('%Y-%m-%dT%H:%M:%fZ','now'))
-    ON CONFLICT(consumer_id) DO UPDATE SET
-      last_event_id = '0',
-      updated_at    = excluded.updated_at
-  `).run(consumerId);
-}
-
-/**
- * List all known consumers and their cursor positions.
- * @returns {Array<{consumer_id: string, last_event_id: string, updated_at: string}>}
- */
-function listCursors() {
-  const db = getSQLiteDb();
-  return db.prepare('SELECT * FROM projector_cursors ORDER BY consumer_id').all();
-}
-
-module.exports = { readCursor, advanceCursorInTxn, resetCursor, listCursors };

package/cloud-runtime/standalone/Projects/Agents/agx-cloud/lib/db/notifications.js

@@ -1,70 +0,0 @@
-'use strict';
-
-/**
- * lib/db/notifications.js
- *
- * Query helpers for the notifications read-model table.
- */
-
-const { getSQLiteDb } = require('../sqlite-query-adapter');
-
-const DEFAULT_UNREAD_CAP = 500;
-
-/**
- * Return up to `cap` unread notifications for a user, newest first.
- *
- * @param {string} userId
- * @param {number} [cap=500]
- * @returns {Array<{id, task_id, event_id, type, tier, title, body, created_at}>}
- */
-function getUnreadSummary(userId, cap = DEFAULT_UNREAD_CAP) {
-  const db = getSQLiteDb();
-  return db.prepare(`
-    SELECT id, task_id, event_id, type, tier, title, body, created_at
-    FROM notifications
-    WHERE user_id = ? AND read_at IS NULL
-    ORDER BY created_at DESC
-    LIMIT ?
-  `).all(userId, cap);
-}
-
-/**
- * Count unread notifications for a user.
- *
- * @param {string} userId
- * @returns {number}
- */
-function countUnread(userId) {
-  const db = getSQLiteDb();
-  return db.prepare(
-    'SELECT COUNT(*) AS n FROM notifications WHERE user_id = ? AND read_at IS NULL'
-  ).get(userId)?.n ?? 0;
-}
-
-/**
- * Delete notifications older than minDays (read) or maxDays (any).
- * Returns the total number of rows deleted.
- *
- * @param {object} [opts]
- * @param {number} [opts.minDays=60] - prune read notifications older than this
- * @param {number} [opts.maxDays=90] - prune all notifications older than this
- * @returns {{ deleted: number }}
- */
-function pruneOldNotifications({ minDays = 60, maxDays = 90 } = {}) {
-  const db = getSQLiteDb();
-
-  const r1 = db.prepare(`
-    DELETE FROM notifications
-    WHERE created_at < strftime('%Y-%m-%dT%H:%M:%fZ', 'now', '-${minDays} days')
-      AND read_at IS NOT NULL
-  `).run();
-
-  const r2 = db.prepare(`
-    DELETE FROM notifications
-    WHERE created_at < strftime('%Y-%m-%dT%H:%M:%fZ', 'now', '-${maxDays} days')
-  `).run();
-
-  return { deleted: r1.changes + r2.changes };
-}
-
-module.exports = { getUnreadSummary, countUnread, pruneOldNotifications };

package/cloud-runtime/standalone/Projects/Agents/agx-cloud/lib/db/preferences.js

@@ -1,110 +0,0 @@
-/**
- * lib/db/preferences.js
- *
- * Notification preference helpers.
- *
- * Preference resolution order (highest priority first):
- *  1. Task-level: tasks.stage_decisions → { notifications: { [type]: bool } }
- *  2. User-level: user_settings.notification_prefs → { [type]: bool }  (if table exists)
- *  3. Global default: true (notify for everything)
- *
- * Schema convention for task-level prefs (stored in tasks.stage_decisions JSON):
- *   { "notifications": { "task.completed": true, "task.failed": false } }
- *
- * Schema convention for user-level prefs (stored in user_settings.notification_prefs JSON):
- *   { "task.completed": true, "task.failed": false }
- */
-
-'use strict';
-
-const { getSQLiteDb } = require('../sqlite-query-adapter');
-
-/**
- * Read task-level notification preferences for a specific notification type.
- * Returns null if no task-level override exists for this type.
- *
- * @param {import('better-sqlite3').Database} db
- * @param {string} taskId
- * @param {string} notificationType - e.g. 'task.completed'
- * @returns {boolean|null} explicit preference, or null if not set at task level
- */
-function getTaskLevelPref(db, taskId, notificationType) {
-  const row = db.prepare(
-    "SELECT json_extract(stage_decisions, '$.notifications') AS notif_prefs FROM tasks WHERE id = ?"
-  ).get(taskId);
-
-  if (!row || !row.notif_prefs) return null;
-
-  try {
-    const prefs = typeof row.notif_prefs === 'string'
-      ? JSON.parse(row.notif_prefs)
-      : row.notif_prefs;
-    if (prefs && typeof prefs[notificationType] === 'boolean') {
-      return prefs[notificationType];
-    }
-  } catch {
-    // Malformed JSON — treat as no preference
-  }
-  return null;
-}
-
-/**
- * Read user-level notification preferences for a specific notification type.
- * Returns null if no user-level preference exists for this type.
- *
- * Reads from user_settings.notification_prefs (JSON column).
- * Gracefully handles missing table (returns null).
- *
- * @param {import('better-sqlite3').Database} db
- * @param {string} userId
- * @param {string} notificationType - e.g. 'task.completed'
- * @returns {boolean|null} explicit preference, or null if not set
- */
-function getUserLevelPref(db, userId, notificationType) {
-  try {
-    const row = db.prepare(
-      "SELECT json_extract(notification_prefs, '$.' || ?) AS pref FROM user_settings WHERE user_id = ?"
-    ).get(notificationType, userId);
-
-    if (row && typeof row.pref === 'integer') {
-      // SQLite stores JSON booleans as integers (0/1)
-      return row.pref !== 0;
-    }
-    if (row && typeof row.pref === 'string') {
-      if (row.pref === 'true') return true;
-      if (row.pref === 'false') return false;
-    }
-  } catch {
-    // user_settings table may not exist yet — return null (default)
-  }
-  return null;
-}
-
-/**
- * Determine whether a notification should be emitted for a given task + type.
- *
- * Resolution order:
- *  1. Task-level preference (tasks.stage_decisions.notifications[type])
- *  2. User-level preference (user_settings.notification_prefs[type])
- *  3. Global default → true
- *
- * @param {import('better-sqlite3').Database} db
- * @param {string} taskId
- * @param {string} userId
- * @param {string} notificationType - e.g. 'task.completed'
- * @returns {boolean}
- */
-function shouldNotify(db, taskId, userId, notificationType) {
-  // 1. Task-level override
-  const taskPref = getTaskLevelPref(db, taskId, notificationType);
-  if (taskPref !== null) return taskPref;
-
-  // 2. User-level default
-  const userPref = getUserLevelPref(db, userId, notificationType);
-  if (userPref !== null) return userPref;
-
-  // 3. Global default — notify
-  return true;
-}
-
-module.exports = { shouldNotify, getTaskLevelPref, getUserLevelPref };

package/cloud-runtime/standalone/Projects/Agents/agx-cloud/lib/demo-threads.ts

@@ -1,76 +0,0 @@
-import type { GroupMessage, Participant } from "@/lib/types";
-
-export const DEMO_PARTICIPANTS: Participant[] = [
-  { id: "jane", name: "Jane", provider: "claude", model: "claude-opus-4-6", color: "#6366f1" },
-  { id: "cody", name: "Cody", provider: "claude", model: "gpt-5.3", color: "#f59e0b" },
-  { id: "flint", name: "Flint", provider: "ollama", model: "gemini-3.1-pro", color: "#10b981" },
-  { id: "jewel", name: "Jewel", provider: "claude", model: "glm-5", color: "#ec4899" },
-];
-
-const now = Date.now();
-
-export const DEMO_MESSAGES: GroupMessage[] = [
-  {
-    id: "demo-0",
-    role: "user",
-    participantId: null,
-    content: "We're losing 40% of users at the onboarding config screen. How should we fix this?",
-    timestamp: now - 9000,
-  },
-  {
-    id: "demo-1",
-    role: "assistant",
-    participantId: "jane",
-    content: "The core problem is we're asking for setup before showing value. Users don't know *why* they need an API key yet. Flip the order — let them see the product working first, then ask for config when they actually need it.",
-    timestamp: now - 8000,
-  },
-  {
-    id: "demo-2",
-    role: "assistant",
-    participantId: "cody",
-    content: "We can prove that with a zero-config starter task: detect `package.json` or `.git` on load, run a local project analysis. No API key needed, instant result. That alone should cut the drop-off significantly.",
-    timestamp: now - 7000,
-  },
-  {
-    id: "demo-3",
-    role: "assistant",
-    participantId: "flint",
-    content: "Risk: if we defer config entirely, the *second* interaction fails when there's no provider configured. We'd just move the drop-off from step 1 to step 2. Need to handle that transition carefully.",
-    timestamp: now - 6000,
-  },
-  {
-    id: "demo-4",
-    role: "assistant",
-    participantId: "jewel",
-    content: "Graduated fidelity solves this. First task is local-only and always succeeds. When they trigger something that needs an LLM, prompt for the key *inline* — right where they need it, not on a separate page. Context-sensitive setup.",
-    timestamp: now - 5000,
-  },
-  {
-    id: "demo-5",
-    role: "assistant",
-    participantId: "jane",
-    content: "Exactly. Setup instructions are only useful at the moment you need them. Front-loading them is just anxiety. I'd also suggest we track `welcome_view → first_action → first_result` to measure the actual impact.",
-    timestamp: now - 4000,
-  },
-  {
-    id: "demo-6",
-    role: "assistant",
-    participantId: "cody",
-    content: "Here's a concrete implementation plan:\n1. Add framework detection on page load\n2. Show \"Map this project\" as default starter task\n3. Run it client-side with zero dependencies\n4. Persist the result so they land in a live session, not a blank page",
-    timestamp: now - 3000,
-  },
-  {
-    id: "demo-7",
-    role: "assistant",
-    participantId: "flint",
-    content: "One more thing — keep state from that first task. When they transition to the real workspace, they should land mid-session. Starting over after the demo kills momentum and trust.",
-    timestamp: now - 2000,
-  },
-  {
-    id: "demo-8",
-    role: "assistant",
-    participantId: "jewel",
-    content: "Summary: land → see agents working → join with one click → first task runs instantly → setup happens only when needed. Every step earns the next. Shall I draft the implementation spec?",
-    timestamp: now - 1000,
-  },
-];

package/cloud-runtime/standalone/Projects/Agents/agx-cloud/lib/jobs/pruneNotifications.js

@@ -1,87 +0,0 @@
-'use strict';
-
-/**
- * lib/jobs/pruneNotifications.js
- *
- * Scheduled job that prunes old notifications from the read-model table.
- *
- * Retention policy:
- *   - Read notifications older than TTL_DAYS_MIN (60 days) are deleted.
- *   - All notifications older than TTL_DAYS_MAX (90 days) are deleted.
- *
- * Usage:
- *   const pruneJob = require('./pruneNotifications');
- *   pruneJob.start();   // begin scheduled runs
- *   pruneJob.stop();    // cancel scheduled runs
- *   pruneJob.runOnce(); // run immediately (useful in tests / CLI)
- */
-
-const { pruneOldNotifications } = require('../db/notifications');
-
-// ── Configuration ────────────────────────────────────────────────────────────
-
-const TTL_DAYS_MIN = 60;  // delete read notifications older than this
-const TTL_DAYS_MAX = 90;  // delete all notifications older than this
-const DEFAULT_INTERVAL_MS = 6 * 60 * 60 * 1000; // 6 hours
-
-// ── Job implementation ───────────────────────────────────────────────────────
-
-/**
- * Run the prune job once and log the outcome.
- *
- * @returns {{ deleted: number }}
- */
-function runOnce() {
-  try {
-    const { deleted } = pruneOldNotifications({ minDays: TTL_DAYS_MIN, maxDays: TTL_DAYS_MAX });
-    if (deleted > 0) {
-      console.log(`[pruneNotifications] deleted ${deleted} notifications (min=${TTL_DAYS_MIN}d, max=${TTL_DAYS_MAX}d)`);
-    } else {
-      console.debug('[pruneNotifications] nothing to prune');
-    }
-    return { deleted };
-  } catch (err) {
-    console.error('[pruneNotifications] error during prune run', err);
-    return { deleted: 0 };
-  }
-}
-
-// ── Scheduler ────────────────────────────────────────────────────────────────
-
-let _timer = null;
-
-/**
- * Start the scheduled prune job.
- * Safe to call multiple times — subsequent calls are no-ops.
- *
- * @param {object} [opts]
- * @param {number} [opts.intervalMs] - override the default 6-hour interval
- */
-function start({ intervalMs = DEFAULT_INTERVAL_MS } = {}) {
-  if (_timer) return;
-
-  // Run once immediately on start, then on interval
-  runOnce();
-
-  _timer = setInterval(() => {
-    runOnce();
-  }, intervalMs);
-
-  // Allow the process to exit even if this timer is still active
-  if (_timer.unref) _timer.unref();
-
-  console.log(`[pruneNotifications] scheduler started (interval=${intervalMs}ms)`);
-}
-
-/**
- * Stop the scheduled prune job.
- */
-function stop() {
-  if (_timer) {
-    clearInterval(_timer);
-    _timer = null;
-    console.log('[pruneNotifications] scheduler stopped');
-  }
-}
-
-module.exports = { start, stop, runOnce, TTL_DAYS_MIN, TTL_DAYS_MAX };