web-agent-bridge 2.4.0 → 2.6.0

package/server/runtime/session-engine.js

@@ -0,0 +1,293 @@
+'use strict';
+
+/**
+ * Session Engine
+ *
+ * Manages browser execution sessions with cookies, tokens,
+ * and state persistence across navigation.
+ */
+
+const crypto = require('crypto');
+const { bus } = require('../runtime/event-bus');
+
+class SessionEngine {
+  constructor() {
+    this._sessions = new Map();   // sessionId → BrowserSession
+    this._cookieJars = new Map(); // sessionId → CookieJar
+    this._maxSessions = 500;
+    this._defaultTTL = 3600_000;  // 1 hour
+  }
+
+  /**
+   * Create a new browser execution session
+   */
+  create(config = {}) {
+    const sessionId = `sess_${crypto.randomBytes(16).toString('hex')}`;
+
+    const session = {
+      id: sessionId,
+      agentId: config.agentId || null,
+      siteId: config.siteId || null,
+      state: 'active',
+      viewport: config.viewport || { width: 1920, height: 1080 },
+      userAgent: config.userAgent || null,
+      proxy: config.proxy || null,
+      localStorage: {},
+      sessionStorage: {},
+      variables: {},    // Arbitrary key-value store for the agent
+      history: [],
+      createdAt: Date.now(),
+      expiresAt: Date.now() + (config.ttl || this._defaultTTL),
+      lastActivity: Date.now(),
+    };
+
+    this._sessions.set(sessionId, session);
+    this._cookieJars.set(sessionId, new CookieJar());
+    this._evict();
+
+    bus.emit('session.created', { sessionId, agentId: session.agentId, siteId: session.siteId });
+    return session;
+  }
+
+  /**
+   * Get session
+   */
+  get(sessionId) {
+    const session = this._sessions.get(sessionId);
+    if (!session) return null;
+    if (session.expiresAt < Date.now()) {
+      this.destroy(sessionId);
+      return null;
+    }
+    return session;
+  }
+
+  /**
+   * Update session last activity
+   */
+  touch(sessionId) {
+    const session = this._sessions.get(sessionId);
+    if (session) session.lastActivity = Date.now();
+  }
+
+  /**
+   * Set cookies for a session
+   */
+  setCookies(sessionId, cookies) {
+    const jar = this._cookieJars.get(sessionId);
+    if (!jar) return;
+    for (const cookie of cookies) {
+      jar.set(cookie);
+    }
+    this.touch(sessionId);
+  }
+
+  /**
+   * Get cookies for a session/domain
+   */
+  getCookies(sessionId, domain = null) {
+    const jar = this._cookieJars.get(sessionId);
+    if (!jar) return [];
+    return jar.getAll(domain);
+  }
+
+  /**
+   * Set localStorage value
+   */
+  setStorage(sessionId, key, value, type = 'local') {
+    const session = this._sessions.get(sessionId);
+    if (!session) return;
+    const store = type === 'session' ? session.sessionStorage : session.localStorage;
+    store[key] = value;
+    this.touch(sessionId);
+  }
+
+  /**
+   * Get localStorage value
+   */
+  getStorage(sessionId, key, type = 'local') {
+    const session = this._sessions.get(sessionId);
+    if (!session) return null;
+    const store = type === 'session' ? session.sessionStorage : session.localStorage;
+    return store[key] || null;
+  }
+
+  /**
+   * Set variable in session
+   */
+  setVariable(sessionId, key, value) {
+    const session = this._sessions.get(sessionId);
+    if (session) {
+      session.variables[key] = value;
+      this.touch(sessionId);
+    }
+  }
+
+  /**
+   * Get variable from session
+   */
+  getVariable(sessionId, key) {
+    const session = this._sessions.get(sessionId);
+    return session?.variables[key] || null;
+  }
+
+  /**
+   * Record navigation in session history
+   */
+  recordNavigation(sessionId, url, title = '') {
+    const session = this._sessions.get(sessionId);
+    if (!session) return;
+    session.history.push({
+      url,
+      title,
+      timestamp: Date.now(),
+      index: session.history.length,
+    });
+    this.touch(sessionId);
+  }
+
+  /**
+   * Export session state (for transfer/persistence)
+   */
+  export(sessionId) {
+    const session = this._sessions.get(sessionId);
+    if (!session) return null;
+    return {
+      id: session.id,
+      agentId: session.agentId,
+      siteId: session.siteId,
+      viewport: session.viewport,
+      userAgent: session.userAgent,
+      localStorage: { ...session.localStorage },
+      sessionStorage: { ...session.sessionStorage },
+      variables: { ...session.variables },
+      cookies: this.getCookies(sessionId),
+      history: [...session.history],
+      createdAt: session.createdAt,
+    };
+  }
+
+  /**
+   * Import session state (restore from exported data)
+   */
+  import(data) {
+    const session = this.create({
+      agentId: data.agentId,
+      siteId: data.siteId,
+      viewport: data.viewport,
+      userAgent: data.userAgent,
+    });
+
+    session.localStorage = data.localStorage || {};
+    session.sessionStorage = data.sessionStorage || {};
+    session.variables = data.variables || {};
+    session.history = data.history || [];
+
+    if (data.cookies) {
+      this.setCookies(session.id, data.cookies);
+    }
+
+    return session;
+  }
+
+  /**
+   * Destroy session
+   */
+  destroy(sessionId) {
+    this._sessions.delete(sessionId);
+    this._cookieJars.delete(sessionId);
+    bus.emit('session.destroyed', { sessionId });
+  }
+
+  /**
+   * List sessions
+   */
+  list(filters = {}, limit = 50) {
+    const now = Date.now();
+    let sessions = Array.from(this._sessions.values()).filter(s => s.expiresAt >= now);
+
+    if (filters.agentId) sessions = sessions.filter(s => s.agentId === filters.agentId);
+    if (filters.siteId) sessions = sessions.filter(s => s.siteId === filters.siteId);
+    if (filters.state) sessions = sessions.filter(s => s.state === filters.state);
+
+    return sessions.slice(0, limit).map(s => ({
+      id: s.id,
+      agentId: s.agentId,
+      siteId: s.siteId,
+      state: s.state,
+      historyLength: s.history.length,
+      createdAt: s.createdAt,
+      lastActivity: s.lastActivity,
+    }));
+  }
+
+  getStats() {
+    return {
+      activeSessions: this._sessions.size,
+      maxSessions: this._maxSessions,
+    };
+  }
+
+  _evict() {
+    const now = Date.now();
+    for (const [id, session] of this._sessions) {
+      if (session.expiresAt < now) this.destroy(id);
+    }
+    if (this._sessions.size > this._maxSessions) {
+      const sorted = Array.from(this._sessions.entries())
+        .sort((a, b) => a[1].lastActivity - b[1].lastActivity);
+      const toRemove = sorted.slice(0, sorted.length - this._maxSessions);
+      for (const [id] of toRemove) this.destroy(id);
+    }
+  }
+}
+
+// ─── Cookie Jar ─────────────────────────────────────────────────────────────
+
+class CookieJar {
+  constructor() {
+    this._cookies = new Map();  // domain:name → cookie
+  }
+
+  set(cookie) {
+    const key = `${cookie.domain || '*'}:${cookie.name}`;
+    this._cookies.set(key, {
+      name: cookie.name,
+      value: cookie.value,
+      domain: cookie.domain || '*',
+      path: cookie.path || '/',
+      expires: cookie.expires || null,
+      httpOnly: cookie.httpOnly || false,
+      secure: cookie.secure || false,
+      sameSite: cookie.sameSite || 'Lax',
+      setAt: Date.now(),
+    });
+  }
+
+  get(name, domain = '*') {
+    return this._cookies.get(`${domain}:${name}`) || null;
+  }
+
+  getAll(domain = null) {
+    const now = Date.now();
+    const result = [];
+    for (const cookie of this._cookies.values()) {
+      if (cookie.expires && cookie.expires < now) continue;
+      if (domain && cookie.domain !== '*' && cookie.domain !== domain) continue;
+      result.push({ ...cookie });
+    }
+    return result;
+  }
+
+  delete(name, domain = '*') {
+    this._cookies.delete(`${domain}:${name}`);
+  }
+
+  clear() {
+    this._cookies.clear();
+  }
+}
+
+const sessionEngine = new SessionEngine();
+
+module.exports = { SessionEngine, CookieJar, sessionEngine };

package/server/runtime/state-manager.js

@@ -0,0 +1,188 @@
+'use strict';
+
+/**
+ * WAB Runtime - State Manager
+ * 
+ * Manages agent state, task checkpoints, and long-running task persistence.
+ * Provides rollback capabilities and state snapshots.
+ */
+
+const crypto = require('crypto');
+
+class StateManager {
+  constructor(options = {}) {
+    this._states = new Map();        // entityId → current state
+    this._checkpoints = new Map();   // entityId → [checkpoint, ...]
+    this._maxCheckpoints = options.maxCheckpoints || 50;
+    this._ttl = options.ttl || 24 * 3600_000; // 24h default
+    this._stats = { saves: 0, restores: 0, checkpoints: 0, rollbacks: 0 };
+  }
+
+  /**
+   * Save state for an entity (agent or task)
+   */
+  save(entityId, state) {
+    const entry = {
+      state: _deepClone(state),
+      updatedAt: Date.now(),
+      version: (this._states.get(entityId)?.version || 0) + 1,
+    };
+    this._states.set(entityId, entry);
+    this._stats.saves++;
+    return entry.version;
+  }
+
+  /**
+   * Get current state
+   */
+  get(entityId) {
+    const entry = this._states.get(entityId);
+    if (!entry) return null;
+    if (Date.now() - entry.updatedAt > this._ttl) {
+      this._states.delete(entityId);
+      return null;
+    }
+    return _deepClone(entry.state);
+  }
+
+  /**
+   * Create a checkpoint (point-in-time snapshot for rollback)
+   */
+  checkpoint(entityId, label = '') {
+    const entry = this._states.get(entityId);
+    if (!entry) throw new Error(`No state found for entity: ${entityId}`);
+
+    const cp = {
+      id: `cp_${crypto.randomBytes(8).toString('hex')}`,
+      label,
+      state: _deepClone(entry.state),
+      version: entry.version,
+      createdAt: Date.now(),
+    };
+
+    if (!this._checkpoints.has(entityId)) this._checkpoints.set(entityId, []);
+    const cps = this._checkpoints.get(entityId);
+    cps.push(cp);
+
+    // Limit checkpoints
+    if (cps.length > this._maxCheckpoints) {
+      cps.splice(0, cps.length - this._maxCheckpoints);
+    }
+
+    this._stats.checkpoints++;
+    return cp.id;
+  }
+
+  /**
+   * Rollback to a checkpoint
+   */
+  rollback(entityId, checkpointId) {
+    const cps = this._checkpoints.get(entityId);
+    if (!cps) throw new Error(`No checkpoints for entity: ${entityId}`);
+
+    const idx = cps.findIndex(cp => cp.id === checkpointId);
+    if (idx === -1) throw new Error(`Checkpoint not found: ${checkpointId}`);
+
+    const cp = cps[idx];
+    this._states.set(entityId, {
+      state: _deepClone(cp.state),
+      updatedAt: Date.now(),
+      version: (this._states.get(entityId)?.version || 0) + 1,
+    });
+
+    // Remove checkpoints after the restored one
+    cps.splice(idx + 1);
+    this._stats.rollbacks++;
+    return cp;
+  }
+
+  /**
+   * List checkpoints for an entity
+   */
+  listCheckpoints(entityId) {
+    const cps = this._checkpoints.get(entityId) || [];
+    return cps.map(cp => ({
+      id: cp.id,
+      label: cp.label,
+      version: cp.version,
+      createdAt: cp.createdAt,
+    }));
+  }
+
+  /**
+   * Delete state and checkpoints for an entity
+   */
+  delete(entityId) {
+    this._states.delete(entityId);
+    this._checkpoints.delete(entityId);
+  }
+
+  /**
+   * Get all active entity IDs
+   */
+  listEntities() {
+    const entities = [];
+    const now = Date.now();
+    for (const [id, entry] of this._states) {
+      if (now - entry.updatedAt > this._ttl) {
+        this._states.delete(id);
+        continue;
+      }
+      entities.push({ id, version: entry.version, updatedAt: entry.updatedAt });
+    }
+    return entities;
+  }
+
+  /**
+   * Merge partial state update
+   */
+  merge(entityId, partial) {
+    const current = this.get(entityId) || {};
+    const merged = { ...current, ...partial };
+    return this.save(entityId, merged);
+  }
+
+  /**
+   * Transition state with validation
+   */
+  transition(entityId, field, from, to) {
+    const state = this.get(entityId);
+    if (!state) throw new Error(`No state for: ${entityId}`);
+    if (state[field] !== from) {
+      throw new Error(`Invalid transition: ${field} is ${state[field]}, expected ${from}`);
+    }
+    state[field] = to;
+    return this.save(entityId, state);
+  }
+
+  getStats() {
+    return {
+      ...this._stats,
+      activeEntities: this._states.size,
+      totalCheckpoints: Array.from(this._checkpoints.values()).reduce((s, c) => s + c.length, 0),
+    };
+  }
+
+  /**
+   * Cleanup expired states
+   */
+  cleanup() {
+    const now = Date.now();
+    let cleaned = 0;
+    for (const [id, entry] of this._states) {
+      if (now - entry.updatedAt > this._ttl) {
+        this._states.delete(id);
+        this._checkpoints.delete(id);
+        cleaned++;
+      }
+    }
+    return cleaned;
+  }
+}
+
+function _deepClone(obj) {
+  if (obj === null || typeof obj !== 'object') return obj;
+  return JSON.parse(JSON.stringify(obj));
+}
+
+module.exports = { StateManager };