@build-astron-co/nimbus 0.4.1 → 0.4.3

package/src/sharing/sync.ts

@@ -1,300 +0,0 @@
-/**
- * Session Sharing — Generate share IDs and sync session data
- *
- * Provides local sharing via the nimbus serve API.
- * Shares are persisted to the SQLite `shares` table so they survive restarts.
- * For hosted sharing via Supabase, the astron-landing web UI handles
- * the sync directly using its existing Supabase integration.
- */
-
-import { getConversation as _getConversation } from '../state/conversations';
-import { SessionManager as _SessionManager } from '../sessions/manager';
-import type { LLMMessage } from '../llm/types';
-
-/**
- * Dependency overrides for testing. Set these before calling shareSession/etc.
- * In production code these remain undefined and the real implementations are used.
- */
-export const _deps = {
-  getConversation: undefined as ((id: string) => any) | undefined,
-  getSessionManager: undefined as (() => { get: (id: string) => any }) | undefined,
-  getDb: undefined as (() => any) | undefined,
-};
-
-function getConversation(id: string) {
-  return (_deps.getConversation ?? _getConversation)(id);
-}
-
-function getSessionManager() {
-  return _deps.getSessionManager ? _deps.getSessionManager() : _SessionManager.getInstance();
-}
-
-/** A shared session snapshot. */
-export interface SharedSession {
-  /** Unique share ID. */
-  id: string;
-  /** Session ID this share was created from. */
-  sessionId: string;
-  /** Session name. */
-  name: string;
-  /** Conversation messages at time of sharing. */
-  messages: LLMMessage[];
-  /** Model used. */
-  model: string;
-  /** Session mode. */
-  mode: string;
-  /** Total cost. */
-  costUSD: number;
-  /** Total tokens used. */
-  tokenCount: number;
-  /** When the share was created. */
-  createdAt: string;
-  /** When the share expires (30-day TTL). */
-  expiresAt: string;
-  /** Whether this is a live-updating share. */
-  isLive: boolean;
-  /** Access token for write access (optional). */
-  writeToken?: string;
-}
-
-/**
- * Lazily import the DB to avoid circular dependency.
- */
-function getDb() {
-  if (_deps.getDb) {
-    return _deps.getDb();
-  }
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    const { getDb: _getDb } = require('../state/db');
-    return _getDb();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Generate a short, URL-safe share ID.
- */
-function generateShareId(): string {
-  const bytes = crypto.getRandomValues(new Uint8Array(9));
-  return btoa(String.fromCharCode(...bytes))
-    .replace(/\+/g, '-')
-    .replace(/\//g, '_')
-    .replace(/=/g, '');
-}
-
-/**
- * Generate a secure write token for controlling write access.
- */
-function generateWriteToken(): string {
-  return crypto.randomUUID();
-}
-
-/**
- * Create a share for a session.
- */
-export function shareSession(
-  sessionId: string,
-  options?: {
-    isLive?: boolean;
-    ttlDays?: number;
-  }
-): SharedSession | null {
-  const sessionManager = getSessionManager();
-  const session = sessionManager.get(sessionId);
-  if (!session) {
-    return null;
-  }
-
-  const conversation = getConversation(sessionId);
-  if (!conversation) {
-    return null;
-  }
-
-  const ttlDays = options?.ttlDays ?? 30;
-  const now = new Date();
-  const expiresAt = new Date(now.getTime() + ttlDays * 24 * 60 * 60 * 1000);
-
-  const shared: SharedSession = {
-    id: generateShareId(),
-    sessionId,
-    name: session.name,
-    messages: conversation.messages,
-    model: session.model,
-    mode: session.mode,
-    costUSD: session.costUSD,
-    tokenCount: session.tokenCount,
-    createdAt: now.toISOString(),
-    expiresAt: expiresAt.toISOString(),
-    isLive: options?.isLive ?? false,
-    writeToken: generateWriteToken(),
-  };
-
-  // Persist to SQLite
-  const db = getDb();
-  if (db) {
-    try {
-      db.run(
-        `INSERT INTO shares (id, session_id, name, messages, model, mode, cost_usd, token_count, is_live, write_token, created_at, expires_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-        [
-          shared.id,
-          shared.sessionId,
-          shared.name,
-          JSON.stringify(shared.messages),
-          shared.model,
-          shared.mode,
-          shared.costUSD,
-          shared.tokenCount,
-          shared.isLive ? 1 : 0,
-          shared.writeToken,
-          shared.createdAt,
-          shared.expiresAt,
-        ]
-      );
-    } catch {
-      // Non-critical — share is still returned but won't survive restart
-    }
-  }
-
-  return shared;
-}
-
-/**
- * Convert a raw SQLite row to a SharedSession object.
- */
-function rowToSharedSession(row: any, includeWriteToken = false): SharedSession {
-  const result: SharedSession = {
-    id: row.id,
-    sessionId: row.session_id,
-    name: row.name,
-    messages: JSON.parse(row.messages),
-    model: row.model || '',
-    mode: row.mode || '',
-    costUSD: row.cost_usd || 0,
-    tokenCount: row.token_count || 0,
-    createdAt: row.created_at,
-    expiresAt: row.expires_at,
-    isLive: !!row.is_live,
-  };
-  if (includeWriteToken) {
-    result.writeToken = row.write_token;
-  }
-  return result;
-}
-
-/**
- * Get a shared session by share ID.
- * If the share is live, refresh the messages from the current session.
- */
-export function getSharedSession(shareId: string): SharedSession | null {
-  const db = getDb();
-  if (!db) {
-    return null;
-  }
-
-  try {
-    const now = new Date().toISOString();
-    const row = db
-      .query(`SELECT * FROM shares WHERE id = ? AND expires_at > ?`)
-      .get(shareId, now) as any;
-
-    if (!row) {
-      return null;
-    }
-
-    const shared = rowToSharedSession(row);
-
-    // Refresh messages for live shares
-    if (shared.isLive) {
-      const conversation = getConversation(shared.sessionId);
-      if (conversation) {
-        shared.messages = conversation.messages;
-        // Update stored messages
-        try {
-          db.run(`UPDATE shares SET messages = ? WHERE id = ?`, [
-            JSON.stringify(shared.messages),
-            shareId,
-          ]);
-        } catch {
-          /* non-critical */
-        }
-      }
-    }
-
-    return shared;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * List all active shares.
- */
-export function listShares(): SharedSession[] {
-  const db = getDb();
-  if (!db) {
-    return [];
-  }
-
-  try {
-    // Clean up expired shares first
-    const now = new Date().toISOString();
-    db.run(`DELETE FROM shares WHERE expires_at <= ?`, [now]);
-
-    const rows = db
-      .query(
-        `SELECT id, session_id, name, messages, model, mode, cost_usd, token_count, is_live, created_at, expires_at
-       FROM shares ORDER BY created_at DESC`
-      )
-      .all() as any[];
-
-    return rows.map(row => rowToSharedSession(row));
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Delete a share.
- */
-export function deleteShare(shareId: string): boolean {
-  const db = getDb();
-  if (!db) {
-    return false;
-  }
-
-  try {
-    const result = db.run(`DELETE FROM shares WHERE id = ?`, [shareId]);
-    return result.changes > 0;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Get the share URL for a shared session.
- */
-export function getShareUrl(shareId: string, baseUrl?: string): string {
-  const base = baseUrl ?? 'http://localhost:6001';
-  return `${base}/nimbus/share/${shareId}`;
-}
-
-/**
- * Clean up expired shares.
- */
-export function cleanupExpiredShares(): number {
-  const db = getDb();
-  if (!db) {
-    return 0;
-  }
-
-  try {
-    const now = new Date().toISOString();
-    const result = db.run(`DELETE FROM shares WHERE expires_at <= ?`, [now]);
-    return result.changes;
-  } catch {
-    return 0;
-  }
-}

package/src/sharing/viewer.ts

@@ -1,163 +0,0 @@
-/**
- * Minimal HTML viewer for shared sessions.
- *
- * Generates a standalone HTML page that can be served by nimbus serve
- * for viewing shared sessions when the Web UI is not available.
- */
-
-import type { SharedSession } from './sync';
-
-/**
- * Generate a standalone HTML page for viewing a shared session.
- */
-export function generateShareViewer(shared: SharedSession): string {
-  const messagesHtml = shared.messages
-    .filter(m => m.role === 'user' || m.role === 'assistant')
-    .map(m => {
-      const isUser = m.role === 'user';
-      const bgColor = isUser ? '#3b82f6' : '#1e293b';
-      const align = isUser ? 'flex-end' : 'flex-start';
-      const content =
-        typeof m.content === 'string'
-          ? escapeHtml(m.content)
-          : escapeHtml(JSON.stringify(m.content));
-
-      return `
-        <div style="display:flex;justify-content:${align};margin:8px 0">
-          <div style="max-width:75%;padding:12px 16px;border-radius:16px;background:${bgColor};color:#e2e8f0;font-size:14px;line-height:1.6;white-space:pre-wrap;word-break:break-word">
-            ${content}
-          </div>
-        </div>`;
-    })
-    .join('\n');
-
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Nimbus Session: ${escapeHtml(shared.name)}</title>
-  <style>
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-    body {
-      background: #0a0e1a;
-      color: #e2e8f0;
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      min-height: 100vh;
-    }
-    .header {
-      border-bottom: 1px solid rgba(255,255,255,0.1);
-      padding: 16px 24px;
-      display: flex;
-      align-items: center;
-      gap: 12px;
-    }
-    .logo { color: #22d3ee; font-weight: bold; font-size: 18px; }
-    .title { color: #94a3b8; font-size: 14px; }
-    .meta { color: #64748b; font-size: 12px; margin-left: auto; }
-    .messages { max-width: 800px; margin: 0 auto; padding: 24px; }
-    .badge {
-      display: inline-block; padding: 2px 8px; border-radius: 9999px;
-      font-size: 11px; font-weight: 500; background: rgba(34,211,238,0.1);
-      color: #22d3ee; border: 1px solid rgba(34,211,238,0.2);
-    }
-    .footer {
-      border-top: 1px solid rgba(255,255,255,0.1);
-      padding: 16px 24px; text-align: center;
-      color: #64748b; font-size: 12px;
-    }
-  </style>
-</head>
-<body>
-  <div class="header">
-    <span class="logo">Nimbus</span>
-    <span class="title">${escapeHtml(shared.name)}</span>
-    <span class="badge">${escapeHtml(shared.mode)}</span>
-    ${shared.isLive ? '<span class="badge" style="background:rgba(16,185,129,0.1);color:#10b981;border-color:rgba(16,185,129,0.2)">LIVE</span>' : ''}
-    <span class="meta">${shared.model} &bull; $${shared.costUSD.toFixed(4)} &bull; ${shared.tokenCount.toLocaleString()} tokens</span>
-  </div>
-  <div class="messages">
-    ${messagesHtml}
-  </div>
-  <div class="footer">
-    Shared via Nimbus &bull; Created ${new Date(shared.createdAt).toLocaleString()} &bull; Expires ${new Date(shared.expiresAt).toLocaleString()}
-  </div>
-</body>
-</html>`;
-}
-
-/** Escape HTML special characters. */
-function escapeHtml(text: string): string {
-  return text
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&#39;');
-}
-
-// ---------------------------------------------------------------------------
-// Gap 4: Runbook / Session Export
-// ---------------------------------------------------------------------------
-
-export interface RunbookMessage {
-  role: 'user' | 'assistant' | 'system';
-  content: string;
-  timestamp?: Date;
-}
-
-export interface RunbookSession {
-  id?: string;
-  model?: string;
-  mode?: string;
-  costUSD?: number;
-  tokenCount?: number;
-}
-
-/**
- * Format a chat session as a Markdown runbook for team documentation.
- *
- * Produces a self-contained `.md` file with:
- * - Session metadata header (model, date, mode, cost)
- * - Each user message as a `## User` section
- * - Each assistant message as an `## Agent` section
- * - Tool calls as collapsible `<details>` blocks
- * - System messages skipped (they are implementation details)
- */
-export function formatSessionAsRunbook(
-  messages: RunbookMessage[],
-  session?: RunbookSession
-): string {
-  const date = new Date().toISOString().slice(0, 19).replace('T', ' ');
-  const lines: string[] = [
-    '# Nimbus Session Runbook',
-    '',
-    '| Field | Value |',
-    '|-------|-------|',
-    `| Date | ${date} |`,
-    `| Model | ${session?.model ?? 'default'} |`,
-    `| Mode | ${session?.mode ?? 'build'} |`,
-    `| Tokens | ${session?.tokenCount?.toLocaleString() ?? 'N/A'} |`,
-    `| Cost | $${session?.costUSD?.toFixed(4) ?? '0.0000'} |`,
-    '',
-    '---',
-    '',
-  ];
-
-  for (const msg of messages) {
-    if (msg.role === 'system') continue;
-
-    const heading = msg.role === 'user' ? '## User' : '## Agent';
-    lines.push(heading);
-    lines.push('');
-
-    // Preserve code blocks; escape HTML outside them
-    const content = msg.content.trim();
-    lines.push(content);
-    lines.push('');
-    lines.push('---');
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}

package/src/snapshots/index.ts

@@ -1,2 +0,0 @@
-export { SnapshotManager } from './manager';
-export type { Snapshot, SnapshotManagerOptions } from './manager';