web-agent-bridge 2.4.0 → 2.6.0

package/server/llm/index.js

@@ -0,0 +1,404 @@
+'use strict';
+
+/**
+ * WAB LLM Abstraction Layer
+ *
+ * Model-agnostic LLM interface. Supports:
+ * - OpenAI (GPT-4, GPT-3.5)
+ * - Anthropic (Claude)
+ * - Ollama (local models)
+ * - Custom providers
+ *
+ * Provides a unified API with automatic fallback,
+ * cost tracking, and response caching.
+ */
+
+const { metrics, logger } = require('../observability');
+
+// ─── Provider Interface ─────────────────────────────────────────────────────
+
+class LLMProvider {
+  constructor(name, config = {}) {
+    this.name = name;
+    this.config = config;
+    this.available = false;
+    this.models = [];
+  }
+
+  async initialize() { throw new Error('Not implemented'); }
+  async complete(prompt, options) { throw new Error('Not implemented'); }
+  async embed(text) { throw new Error('Not implemented'); }
+  async listModels() { return this.models; }
+}
+
+// ─── OpenAI Provider ────────────────────────────────────────────────────────
+
+class OpenAIProvider extends LLMProvider {
+  constructor(config) {
+    super('openai', config);
+    this.apiKey = config.apiKey || process.env.OPENAI_API_KEY;
+    this.baseUrl = config.baseUrl || 'https://api.openai.com/v1';
+    this.models = ['gpt-4o', 'gpt-4o-mini', 'gpt-4-turbo', 'gpt-3.5-turbo'];
+  }
+
+  async initialize() {
+    this.available = !!this.apiKey;
+    return this.available;
+  }
+
+  async complete(prompt, options = {}) {
+    if (!this.available) throw new Error('OpenAI provider not initialized');
+
+    const model = options.model || 'gpt-4o-mini';
+    const messages = [];
+    if (options.systemPrompt) messages.push({ role: 'system', content: options.systemPrompt });
+    messages.push({ role: 'user', content: prompt });
+
+    const body = {
+      model,
+      messages,
+      temperature: options.temperature ?? 0.7,
+      max_tokens: options.maxTokens || 2048,
+    };
+
+    const res = await fetch(`${this.baseUrl}/chat/completions`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${this.apiKey}`,
+      },
+      body: JSON.stringify(body),
+    });
+
+    if (!res.ok) {
+      const err = await res.text();
+      throw new Error(`OpenAI error ${res.status}: ${err}`);
+    }
+
+    const data = await res.json();
+    return {
+      text: data.choices[0]?.message?.content || '',
+      model,
+      provider: 'openai',
+      usage: {
+        promptTokens: data.usage?.prompt_tokens || 0,
+        completionTokens: data.usage?.completion_tokens || 0,
+        totalTokens: data.usage?.total_tokens || 0,
+      },
+      finishReason: data.choices[0]?.finish_reason,
+    };
+  }
+
+  async embed(text) {
+    if (!this.available) throw new Error('OpenAI provider not initialized');
+
+    const res = await fetch(`${this.baseUrl}/embeddings`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${this.apiKey}`,
+      },
+      body: JSON.stringify({ model: 'text-embedding-3-small', input: text }),
+    });
+
+    if (!res.ok) throw new Error(`OpenAI embed error ${res.status}`);
+    const data = await res.json();
+    return { embedding: data.data[0]?.embedding || [], model: 'text-embedding-3-small', provider: 'openai' };
+  }
+}
+
+// ─── Anthropic Provider ─────────────────────────────────────────────────────
+
+class AnthropicProvider extends LLMProvider {
+  constructor(config) {
+    super('anthropic', config);
+    this.apiKey = config.apiKey || process.env.ANTHROPIC_API_KEY;
+    this.baseUrl = config.baseUrl || 'https://api.anthropic.com/v1';
+    this.models = ['claude-sonnet-4-20250514', 'claude-3-5-haiku-20241022', 'claude-3-5-sonnet-20241022'];
+  }
+
+  async initialize() {
+    this.available = !!this.apiKey;
+    return this.available;
+  }
+
+  async complete(prompt, options = {}) {
+    if (!this.available) throw new Error('Anthropic provider not initialized');
+
+    const model = options.model || 'claude-3-5-haiku-20241022';
+    const body = {
+      model,
+      max_tokens: options.maxTokens || 2048,
+      messages: [{ role: 'user', content: prompt }],
+    };
+    if (options.systemPrompt) body.system = options.systemPrompt;
+    if (options.temperature !== undefined) body.temperature = options.temperature;
+
+    const res = await fetch(`${this.baseUrl}/messages`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': this.apiKey,
+        'anthropic-version': '2023-06-01',
+      },
+      body: JSON.stringify(body),
+    });
+
+    if (!res.ok) {
+      const err = await res.text();
+      throw new Error(`Anthropic error ${res.status}: ${err}`);
+    }
+
+    const data = await res.json();
+    return {
+      text: data.content?.[0]?.text || '',
+      model,
+      provider: 'anthropic',
+      usage: {
+        promptTokens: data.usage?.input_tokens || 0,
+        completionTokens: data.usage?.output_tokens || 0,
+        totalTokens: (data.usage?.input_tokens || 0) + (data.usage?.output_tokens || 0),
+      },
+      finishReason: data.stop_reason,
+    };
+  }
+}
+
+// ─── Ollama Provider (Local) ────────────────────────────────────────────────
+
+class OllamaProvider extends LLMProvider {
+  constructor(config) {
+    super('ollama', config);
+    this.baseUrl = config.baseUrl || process.env.OLLAMA_URL || 'http://localhost:11434';
+  }
+
+  async initialize() {
+    try {
+      const res = await fetch(`${this.baseUrl}/api/tags`, { signal: AbortSignal.timeout(3000) });
+      if (res.ok) {
+        const data = await res.json();
+        this.models = (data.models || []).map(m => m.name);
+        this.available = true;
+      }
+    } catch (_) {
+      this.available = false;
+    }
+    return this.available;
+  }
+
+  async complete(prompt, options = {}) {
+    if (!this.available) throw new Error('Ollama not available');
+
+    const model = options.model || this.models[0] || 'llama3.2';
+    const body = {
+      model,
+      prompt: options.systemPrompt ? `${options.systemPrompt}\n\n${prompt}` : prompt,
+      stream: false,
+      options: {},
+    };
+    if (options.temperature !== undefined) body.options.temperature = options.temperature;
+
+    const res = await fetch(`${this.baseUrl}/api/generate`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    });
+
+    if (!res.ok) throw new Error(`Ollama error ${res.status}`);
+    const data = await res.json();
+
+    return {
+      text: data.response || '',
+      model,
+      provider: 'ollama',
+      usage: {
+        promptTokens: data.prompt_eval_count || 0,
+        completionTokens: data.eval_count || 0,
+        totalTokens: (data.prompt_eval_count || 0) + (data.eval_count || 0),
+      },
+      finishReason: data.done ? 'stop' : 'length',
+    };
+  }
+
+  async embed(text) {
+    if (!this.available) throw new Error('Ollama not available');
+
+    const model = this.models.find(m => m.includes('embed')) || 'nomic-embed-text';
+    const res = await fetch(`${this.baseUrl}/api/embeddings`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ model, prompt: text }),
+    });
+
+    if (!res.ok) throw new Error(`Ollama embed error ${res.status}`);
+    const data = await res.json();
+    return { embedding: data.embedding || [], model, provider: 'ollama' };
+  }
+}
+
+// ─── LLM Manager (Unified Interface) ───────────────────────────────────────
+
+class LLMManager {
+  constructor() {
+    this._providers = new Map();
+    this._defaultProvider = null;
+    this._fallbackOrder = [];
+    this._cache = new Map();
+    this._maxCache = 500;
+    this._stats = { requests: 0, cacheHits: 0, failures: 0, totalTokens: 0 };
+  }
+
+  /**
+   * Register a provider
+   */
+  registerProvider(provider) {
+    this._providers.set(provider.name, provider);
+    if (!this._defaultProvider) this._defaultProvider = provider.name;
+    this._fallbackOrder.push(provider.name);
+  }
+
+  /**
+   * Initialize all providers
+   */
+  async initialize() {
+    const results = {};
+    for (const [name, provider] of this._providers) {
+      try {
+        results[name] = await provider.initialize();
+      } catch (_) {
+        results[name] = false;
+      }
+    }
+
+    // Set default to first available
+    for (const name of this._fallbackOrder) {
+      if (this._providers.get(name)?.available) {
+        this._defaultProvider = name;
+        break;
+      }
+    }
+
+    return results;
+  }
+
+  /**
+   * Complete a prompt (with automatic fallback)
+   */
+  async complete(prompt, options = {}) {
+    this._stats.requests++;
+
+    // Check cache
+    if (options.cache !== false) {
+      const cacheKey = this._cacheKey(prompt, options);
+      const cached = this._cache.get(cacheKey);
+      if (cached && (Date.now() - cached.timestamp < 300_000)) {
+        this._stats.cacheHits++;
+        return { ...cached.result, cached: true };
+      }
+    }
+
+    const providerName = options.provider || this._defaultProvider;
+    const providers = [providerName, ...this._fallbackOrder.filter(p => p !== providerName)];
+
+    const endTimer = metrics.startTimer('llm.request.duration');
+
+    for (const name of providers) {
+      const provider = this._providers.get(name);
+      if (!provider?.available) continue;
+
+      try {
+        const result = await provider.complete(prompt, options);
+
+        endTimer();
+        metrics.increment('llm.requests.success', 1, { provider: name });
+        this._stats.totalTokens += result.usage?.totalTokens || 0;
+
+        // Cache result
+        if (options.cache !== false) {
+          const cacheKey = this._cacheKey(prompt, options);
+          this._cache.set(cacheKey, { result, timestamp: Date.now() });
+          if (this._cache.size > this._maxCache) {
+            const oldest = this._cache.keys().next().value;
+            this._cache.delete(oldest);
+          }
+        }
+
+        return { ...result, duration: endTimer() };
+      } catch (err) {
+        metrics.increment('llm.requests.failure', 1, { provider: name });
+        this._stats.failures++;
+        // Try next provider
+        continue;
+      }
+    }
+
+    endTimer();
+    throw new Error('All LLM providers failed');
+  }
+
+  /**
+   * Generate embeddings
+   */
+  async embed(text, options = {}) {
+    const providerName = options.provider || this._defaultProvider;
+    const provider = this._providers.get(providerName);
+    if (!provider?.available) throw new Error(`Provider ${providerName} not available`);
+    if (!provider.embed) throw new Error(`Provider ${providerName} does not support embeddings`);
+    return provider.embed(text);
+  }
+
+  /**
+   * List available models across all providers
+   */
+  listModels() {
+    const models = [];
+    for (const [name, provider] of this._providers) {
+      if (!provider.available) continue;
+      for (const model of provider.models) {
+        models.push({ model, provider: name });
+      }
+    }
+    return models;
+  }
+
+  /**
+   * Get provider status
+   */
+  getStatus() {
+    const providers = {};
+    for (const [name, provider] of this._providers) {
+      providers[name] = {
+        available: provider.available,
+        models: provider.models,
+      };
+    }
+    return {
+      defaultProvider: this._defaultProvider,
+      providers,
+      stats: { ...this._stats },
+    };
+  }
+
+  _cacheKey(prompt, options) {
+    const key = `${options.provider || ''}:${options.model || ''}:${prompt.slice(0, 200)}`;
+    return require('crypto').createHash('md5').update(key).digest('hex');
+  }
+}
+
+// ─── Singleton ──────────────────────────────────────────────────────────────
+
+const llm = new LLMManager();
+
+// Register default providers
+llm.registerProvider(new OpenAIProvider({}));
+llm.registerProvider(new AnthropicProvider({}));
+llm.registerProvider(new OllamaProvider({}));
+
+module.exports = {
+  LLMProvider,
+  OpenAIProvider,
+  AnthropicProvider,
+  OllamaProvider,
+  LLMManager,
+  llm,
+};

package/server/migrations/004_agent_os.sql

@@ -0,0 +1,158 @@
+-- Agent OS persistence layer
+-- Stores agents, tasks, deployments, registry data, and audit logs
+
+-- Agent identities
+CREATE TABLE IF NOT EXISTS os_agents (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL DEFAULT 'autonomous',
+  status TEXT NOT NULL DEFAULT 'active',
+  capabilities TEXT DEFAULT '[]',
+  api_key_hash TEXT,
+  public_key TEXT,
+  metadata TEXT DEFAULT '{}',
+  ip_allowlist TEXT DEFAULT '[]',
+  command_count INTEGER DEFAULT 0,
+  created_at INTEGER NOT NULL,
+  last_seen INTEGER
+);
+
+-- Agent sessions
+CREATE TABLE IF NOT EXISTS os_sessions (
+  token TEXT PRIMARY KEY,
+  agent_id TEXT NOT NULL,
+  ip TEXT,
+  expires_at INTEGER NOT NULL,
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (agent_id) REFERENCES os_agents(id) ON DELETE CASCADE
+);
+
+-- Tasks
+CREATE TABLE IF NOT EXISTS os_tasks (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  state TEXT NOT NULL DEFAULT 'queued',
+  priority INTEGER DEFAULT 5,
+  agent_id TEXT,
+  params TEXT DEFAULT '{}',
+  result TEXT,
+  error TEXT,
+  retry_count INTEGER DEFAULT 0,
+  max_retries INTEGER DEFAULT 3,
+  depends_on TEXT DEFAULT '[]',
+  created_at INTEGER NOT NULL,
+  started_at INTEGER,
+  completed_at INTEGER,
+  timeout INTEGER DEFAULT 30000
+);
+
+CREATE INDEX IF NOT EXISTS idx_os_tasks_state ON os_tasks(state);
+CREATE INDEX IF NOT EXISTS idx_os_tasks_agent ON os_tasks(agent_id);
+
+-- Deployments
+CREATE TABLE IF NOT EXISTS os_deployments (
+  id TEXT PRIMARY KEY,
+  agent_id TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'active',
+  config TEXT DEFAULT '{}',
+  sites TEXT DEFAULT '[]',
+  health_status TEXT DEFAULT 'unknown',
+  last_health_check INTEGER,
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (agent_id) REFERENCES os_agents(id) ON DELETE CASCADE
+);
+
+-- Registry: commands
+CREATE TABLE IF NOT EXISTS os_registry_commands (
+  id TEXT PRIMARY KEY,
+  site_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT DEFAULT '',
+  category TEXT DEFAULT 'general',
+  version TEXT DEFAULT '1.0.0',
+  input_schema TEXT DEFAULT '{}',
+  output_schema TEXT DEFAULT '{}',
+  capabilities TEXT DEFAULT '[]',
+  tags TEXT DEFAULT '[]',
+  usage_count INTEGER DEFAULT 0,
+  last_used INTEGER,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_os_reg_cmd_site ON os_registry_commands(site_id);
+CREATE INDEX IF NOT EXISTS idx_os_reg_cmd_cat ON os_registry_commands(category);
+
+-- Registry: sites
+CREATE TABLE IF NOT EXISTS os_registry_sites (
+  domain TEXT PRIMARY KEY,
+  name TEXT,
+  description TEXT DEFAULT '',
+  tier TEXT DEFAULT 'free',
+  protocol_version TEXT DEFAULT '1.0.0',
+  capabilities TEXT DEFAULT '[]',
+  endpoints TEXT DEFAULT '{}',
+  verified INTEGER DEFAULT 0,
+  agent_visits INTEGER DEFAULT 0,
+  last_seen INTEGER,
+  created_at INTEGER NOT NULL
+);
+
+-- Registry: templates
+CREATE TABLE IF NOT EXISTS os_registry_templates (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT DEFAULT '',
+  category TEXT DEFAULT 'general',
+  author TEXT DEFAULT 'system',
+  version TEXT DEFAULT '1.0.0',
+  steps TEXT DEFAULT '[]',
+  variables TEXT DEFAULT '{}',
+  required_capabilities TEXT DEFAULT '[]',
+  tags TEXT DEFAULT '[]',
+  downloads INTEGER DEFAULT 0,
+  created_at INTEGER NOT NULL
+);
+
+-- Audit log (immutable append-only)
+CREATE TABLE IF NOT EXISTS os_audit_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  timestamp INTEGER NOT NULL,
+  agent_id TEXT,
+  action TEXT NOT NULL,
+  resource TEXT,
+  resource_id TEXT,
+  details TEXT DEFAULT '{}',
+  ip TEXT,
+  outcome TEXT DEFAULT 'success'
+);
+
+CREATE INDEX IF NOT EXISTS idx_os_audit_ts ON os_audit_log(timestamp);
+CREATE INDEX IF NOT EXISTS idx_os_audit_agent ON os_audit_log(agent_id);
+
+-- Capability grants
+CREATE TABLE IF NOT EXISTS os_capability_grants (
+  id TEXT PRIMARY KEY,
+  agent_id TEXT NOT NULL,
+  capability TEXT NOT NULL,
+  site_id TEXT DEFAULT '*',
+  max_calls INTEGER,
+  used_calls INTEGER DEFAULT 0,
+  rate_limit TEXT,
+  expires_at INTEGER,
+  status TEXT DEFAULT 'active',
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (agent_id) REFERENCES os_agents(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_os_cap_agent ON os_capability_grants(agent_id);
+
+-- Policies
+CREATE TABLE IF NOT EXISTS os_policies (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT DEFAULT '',
+  priority INTEGER DEFAULT 0,
+  rules TEXT DEFAULT '[]',
+  entity_bindings TEXT DEFAULT '[]',
+  created_at INTEGER NOT NULL
+);