opc-agent 4.1.1 → 4.1.3

package/src/tools/web-scraper.ts

@@ -1,179 +0,0 @@
-/**
- * Web Scraper - v0.10.0
- * Fetch URL content and extract readable text in markdown format.
- * Uses a simple readability-style extraction (no external dependencies).
- */
-
-export interface ScrapedContent {
-  title: string;
-  content: string;  // markdown
-  url: string;
-  wordCount: number;
-}
-
-const MAX_CONTENT_LENGTH = 5000;
-
-/**
- * Fetch a URL and extract readable content as markdown.
- */
-export async function scrapeUrl(url: string, maxLength = MAX_CONTENT_LENGTH): Promise<ScrapedContent> {
-  const response = await fetch(url, {
-    headers: {
-      'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
-      Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
-    },
-    signal: AbortSignal.timeout(15000),
-    redirect: 'follow',
-  });
-
-  const contentType = response.headers.get('content-type') || '';
-  const text = await response.text();
-
-  // If not HTML, return raw text
-  if (!contentType.includes('html')) {
-    const truncated = text.slice(0, maxLength);
-    return {
-      title: url,
-      content: truncated,
-      url,
-      wordCount: truncated.split(/\s+/).length,
-    };
-  }
-
-  return extractReadableContent(text, url, maxLength);
-}
-
-/**
- * Extract readable content from HTML using simple heuristics.
- */
-export function extractReadableContent(html: string, url: string, maxLength = MAX_CONTENT_LENGTH): ScrapedContent {
-  // Extract title
-  const titleMatch = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
-  const title = titleMatch ? decodeEntities(titleMatch[1]).trim() : url;
-
-  // Remove non-content elements
-  let content = html;
-
-  // Remove script, style, nav, header, footer, aside, iframe
-  const removePatterns = [
-    /<script[\s\S]*?<\/script>/gi,
-    /<style[\s\S]*?<\/style>/gi,
-    /<nav[\s\S]*?<\/nav>/gi,
-    /<footer[\s\S]*?<\/footer>/gi,
-    /<aside[\s\S]*?<\/aside>/gi,
-    /<iframe[\s\S]*?<\/iframe>/gi,
-    /<noscript[\s\S]*?<\/noscript>/gi,
-    /<!--[\s\S]*?-->/g,
-  ];
-
-  for (const pattern of removePatterns) {
-    content = content.replace(pattern, '');
-  }
-
-  // Try to find main content area
-  const mainContent = findMainContent(content);
-  content = mainContent || content;
-
-  // Convert to markdown-ish text
-  content = htmlToMarkdown(content);
-
-  // Clean up whitespace
-  content = content
-    .replace(/\n{3,}/g, '\n\n')
-    .replace(/[ \t]+/g, ' ')
-    .trim();
-
-  // Truncate
-  if (content.length > maxLength) {
-    content = content.slice(0, maxLength) + '\n\n...[truncated]';
-  }
-
-  return {
-    title,
-    content,
-    url,
-    wordCount: content.split(/\s+/).filter(Boolean).length,
-  };
-}
-
-/**
- * Try to find the main content area of the page.
- */
-function findMainContent(html: string): string | null {
-  // Try common content selectors
-  const patterns = [
-    /<article[^>]*>([\s\S]*?)<\/article>/i,
-    /<main[^>]*>([\s\S]*?)<\/main>/i,
-    /<div[^>]*class="[^"]*(?:content|article|post|entry|main)[^"]*"[^>]*>([\s\S]*?)<\/div>/i,
-    /<div[^>]*id="[^"]*(?:content|article|post|entry|main)[^"]*"[^>]*>([\s\S]*?)<\/div>/i,
-  ];
-
-  for (const pattern of patterns) {
-    const match = html.match(pattern);
-    if (match && match[1] && match[1].length > 200) {
-      return match[1];
-    }
-  }
-
-  // Fallback: find body content
-  const bodyMatch = html.match(/<body[^>]*>([\s\S]*?)<\/body>/i);
-  return bodyMatch ? bodyMatch[1] : null;
-}
-
-/**
- * Simple HTML to Markdown conversion.
- */
-function htmlToMarkdown(html: string): string {
-  let md = html;
-
-  // Headers
-  md = md.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, '\n# $1\n');
-  md = md.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, '\n## $1\n');
-  md = md.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, '\n### $1\n');
-  md = md.replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, '\n#### $1\n');
-  md = md.replace(/<h5[^>]*>([\s\S]*?)<\/h5>/gi, '\n##### $1\n');
-  md = md.replace(/<h6[^>]*>([\s\S]*?)<\/h6>/gi, '\n###### $1\n');
-
-  // Paragraphs and line breaks
-  md = md.replace(/<p[^>]*>/gi, '\n');
-  md = md.replace(/<\/p>/gi, '\n');
-  md = md.replace(/<br\s*\/?>/gi, '\n');
-
-  // Links
-  md = md.replace(/<a[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, '[$2]($1)');
-
-  // Bold and italic
-  md = md.replace(/<(?:strong|b)[^>]*>([\s\S]*?)<\/(?:strong|b)>/gi, '**$1**');
-  md = md.replace(/<(?:em|i)[^>]*>([\s\S]*?)<\/(?:em|i)>/gi, '*$1*');
-
-  // Code
-  md = md.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, '`$1`');
-  md = md.replace(/<pre[^>]*>([\s\S]*?)<\/pre>/gi, '\n```\n$1\n```\n');
-
-  // Lists
-  md = md.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, '- $1\n');
-
-  // Blockquote
-  md = md.replace(/<blockquote[^>]*>([\s\S]*?)<\/blockquote>/gi, '\n> $1\n');
-
-  // Remove remaining HTML tags
-  md = md.replace(/<[^>]+>/g, '');
-
-  // Decode entities
-  md = decodeEntities(md);
-
-  return md;
-}
-
-function decodeEntities(text: string): string {
-  return text
-    .replace(/&amp;/g, '&')
-    .replace(/&lt;/g, '<')
-    .replace(/&gt;/g, '>')
-    .replace(/&quot;/g, '"')
-    .replace(/&#x27;/g, "'")
-    .replace(/&#39;/g, "'")
-    .replace(/&nbsp;/g, ' ')
-    .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(parseInt(n)))
-    .replace(/&#x([0-9a-fA-F]+);/g, (_, n) => String.fromCharCode(parseInt(n, 16)));
-}

package/src/tools/web-search.ts

@@ -1,180 +0,0 @@
-/**
- * Web Search Engine Manager - v0.10.0
- * Supports multiple search backends with automatic fallback.
- * Default: DuckDuckGo (free, no API key required).
- */
-
-export interface SearchResult {
-  title: string;
-  url: string;
-  snippet: string;
-}
-
-export interface SearchOptions {
-  maxResults?: number;
-  engine?: SearchEngine;
-}
-
-export type SearchEngine = 'duckduckgo' | 'brave' | 'searxng' | 'google';
-
-export interface SearchEngineConfig {
-  enabled: boolean;
-  apiKey?: string;
-  baseUrl?: string;  // For SearXNG self-hosted
-}
-
-export interface WebSearchConfig {
-  defaultEngine: SearchEngine;
-  enabled: boolean;
-  engines: Partial<Record<SearchEngine, SearchEngineConfig>>;
-}
-
-export const DEFAULT_SEARCH_CONFIG: WebSearchConfig = {
-  defaultEngine: 'duckduckgo',
-  enabled: true,
-  engines: {
-    duckduckgo: { enabled: true },
-  },
-};
-
-/**
- * Parse DuckDuckGo HTML search results.
- */
-export function parseDuckDuckGoHTML(html: string): SearchResult[] {
-  const results: SearchResult[] = [];
-  // Match result blocks: <a class="result__a" href="...">title</a> ... <a class="result__snippet">snippet</a>
-  const resultBlocks = html.split(/class="result__body"/);
-
-  for (let i = 1; i < resultBlocks.length && results.length < 10; i++) {
-    const block = resultBlocks[i];
-
-    // Extract URL and title from result__a
-    const linkMatch = block.match(/class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/);
-    if (!linkMatch) continue;
-
-    let url = linkMatch[1];
-    const title = stripHTML(linkMatch[2]).trim();
-
-    // DuckDuckGo wraps URLs in redirect, extract actual URL
-    const uddgMatch = url.match(/[?&]uddg=([^&]+)/);
-    if (uddgMatch) {
-      url = decodeURIComponent(uddgMatch[1]);
-    }
-
-    // Extract snippet
-    const snippetMatch = block.match(/class="result__snippet"[^>]*>([\s\S]*?)<\/a>/);
-    const snippet = snippetMatch ? stripHTML(snippetMatch[1]).trim() : '';
-
-    if (title && url) {
-      results.push({ title, url, snippet });
-    }
-  }
-
-  return results;
-}
-
-/**
- * Search using DuckDuckGo HTML interface (no API key needed).
- */
-export async function searchDuckDuckGo(query: string, maxResults = 5): Promise<SearchResult[]> {
-  const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
-  const response = await fetch(url, {
-    headers: {
-      'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
-    },
-    signal: AbortSignal.timeout(15000),
-  });
-  const html = await response.text();
-  return parseDuckDuckGoHTML(html).slice(0, maxResults);
-}
-
-/**
- * Search using Brave Search API.
- */
-export async function searchBrave(query: string, apiKey: string, maxResults = 5): Promise<SearchResult[]> {
-  const url = `https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(query)}&count=${maxResults}`;
-  const response = await fetch(url, {
-    headers: { 'X-Subscription-Token': apiKey, Accept: 'application/json' },
-    signal: AbortSignal.timeout(15000),
-  });
-  const data = await response.json() as any;
-  return (data.web?.results || []).slice(0, maxResults).map((r: any) => ({
-    title: r.title || '',
-    url: r.url || '',
-    snippet: r.description || '',
-  }));
-}
-
-/**
- * Search using SearXNG instance.
- */
-export async function searchSearXNG(query: string, baseUrl: string, maxResults = 5): Promise<SearchResult[]> {
-  const url = `${baseUrl.replace(/\/$/, '')}/search?q=${encodeURIComponent(query)}&format=json`;
-  const response = await fetch(url, { signal: AbortSignal.timeout(15000) });
-  const data = await response.json() as any;
-  return (data.results || []).slice(0, maxResults).map((r: any) => ({
-    title: r.title || '',
-    url: r.url || '',
-    snippet: r.content || '',
-  }));
-}
-
-/**
- * Search using Google Custom Search API.
- */
-export async function searchGoogle(query: string, apiKey: string, maxResults = 5): Promise<SearchResult[]> {
-  // apiKey format: "key:cx" (API key and Custom Search Engine ID)
-  const [key, cx] = apiKey.split(':');
-  const url = `https://www.googleapis.com/customsearch/v1?q=${encodeURIComponent(query)}&key=${key}&cx=${cx}&num=${maxResults}`;
-  const response = await fetch(url, { signal: AbortSignal.timeout(15000) });
-  const data = await response.json() as any;
-  return (data.items || []).slice(0, maxResults).map((r: any) => ({
-    title: r.title || '',
-    url: r.link || '',
-    snippet: r.snippet || '',
-  }));
-}
-
-/**
- * Unified search function with fallback.
- */
-export async function webSearch(query: string, config?: WebSearchConfig, options?: SearchOptions): Promise<SearchResult[]> {
-  const cfg = config || DEFAULT_SEARCH_CONFIG;
-  if (!cfg.enabled) return [];
-
-  const maxResults = options?.maxResults || 5;
-  const engine = options?.engine || cfg.defaultEngine;
-
-  // Try requested engine first, then fallback chain
-  const fallbackOrder: SearchEngine[] = [engine, 'duckduckgo', 'brave', 'searxng', 'google']
-    .filter((e, i, arr) => arr.indexOf(e) === i) as SearchEngine[];
-
-  for (const eng of fallbackOrder) {
-    const engCfg = cfg.engines[eng];
-    if (engCfg && !engCfg.enabled) continue;
-
-    try {
-      switch (eng) {
-        case 'duckduckgo':
-          return await searchDuckDuckGo(query, maxResults);
-        case 'brave':
-          if (engCfg?.apiKey) return await searchBrave(query, engCfg.apiKey, maxResults);
-          continue;
-        case 'searxng':
-          if (engCfg?.baseUrl) return await searchSearXNG(query, engCfg.baseUrl, maxResults);
-          continue;
-        case 'google':
-          if (engCfg?.apiKey) return await searchGoogle(query, engCfg.apiKey, maxResults);
-          continue;
-      }
-    } catch {
-      continue; // Fallback to next engine
-    }
-  }
-
-  return [];
-}
-
-function stripHTML(html: string): string {
-  return html.replace(/<[^>]+>/g, '').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#x27;/g, "'").replace(/&nbsp;/g, ' ');
-}

package/src/traces/index.ts

@@ -1,132 +0,0 @@
-/**
- * OPC Agent Traces — Structured logging for agent actions.
- * 
- * Collects traces that can be fed to DeepBrain's learn() API.
- * Inspired by OpenTelemetry spans.
- */
-
-export interface Span {
-  traceId: string;
-  spanId: string;
-  name: string;
-  startTime: Date;
-  endTime?: Date;
-  attributes: Record<string, string | number | boolean>;
-  events: SpanEvent[];
-  status: 'ok' | 'error' | 'unset';
-}
-
-export interface SpanEvent {
-  name: string;
-  timestamp: Date;
-  attributes?: Record<string, string | number | boolean>;
-}
-
-export interface TraceExporter {
-  export(spans: Span[]): Promise<void>;
-}
-
-/** In-memory buffer that holds spans until flushed */
-export class TraceCollector {
-  private spans: Span[] = [];
-  private exporters: TraceExporter[] = [];
-  private maxBufferSize: number;
-
-  constructor(maxBufferSize = 100) {
-    this.maxBufferSize = maxBufferSize;
-  }
-
-  addExporter(exporter: TraceExporter): void {
-    this.exporters.push(exporter);
-  }
-
-  startSpan(name: string, attributes: Record<string, string | number | boolean> = {}): Span {
-    const span: Span = {
-      traceId: crypto.randomUUID(),
-      spanId: crypto.randomUUID().slice(0, 16),
-      name,
-      startTime: new Date(),
-      attributes,
-      events: [],
-      status: 'unset',
-    };
-    this.spans.push(span);
-    
-    if (this.spans.length >= this.maxBufferSize) {
-      this.flush().catch(() => {}); // Best effort
-    }
-    
-    return span;
-  }
-
-  endSpan(span: Span, status: 'ok' | 'error' = 'ok'): void {
-    span.endTime = new Date();
-    span.status = status;
-  }
-
-  addEvent(span: Span, name: string, attributes?: Record<string, string | number | boolean>): void {
-    span.events.push({ name, timestamp: new Date(), attributes });
-  }
-
-  async flush(): Promise<number> {
-    const toExport = [...this.spans];
-    this.spans = [];
-    
-    for (const exporter of this.exporters) {
-      await exporter.export(toExport);
-    }
-    
-    return toExport.length;
-  }
-
-  getBufferedSpans(): readonly Span[] {
-    return this.spans;
-  }
-
-  get bufferedCount(): number {
-    return this.spans.length;
-  }
-}
-
-/** Console exporter for development */
-export class ConsoleExporter implements TraceExporter {
-  async export(spans: Span[]): Promise<void> {
-    for (const span of spans) {
-      const duration = span.endTime 
-        ? `${span.endTime.getTime() - span.startTime.getTime()}ms`
-        : 'ongoing';
-      console.log(`[TRACE] ${span.name} (${duration}) [${span.status}]`);
-    }
-  }
-}
-
-/** DeepBrain exporter — sends traces to DeepBrain learn() */
-export class DeepBrainExporter implements TraceExporter {
-  private learnEndpoint: string;
-
-  constructor(deepbrainUrl: string = 'http://localhost:3333') {
-    this.learnEndpoint = `${deepbrainUrl}/api/learn`;
-  }
-
-  async export(spans: Span[]): Promise<void> {
-    for (const span of spans) {
-      try {
-        await fetch(this.learnEndpoint, {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({
-            action: span.name,
-            result: span.status === 'ok' ? 'success' : 'error',
-            context: {
-              ...span.attributes,
-              duration: span.endTime ? span.endTime.getTime() - span.startTime.getTime() : null,
-              events: span.events.map(e => e.name),
-            },
-          }),
-        });
-      } catch {
-        // Best effort — don't break agent if brain is down
-      }
-    }
-  }
-}

package/src/types/agent-workstation.d.ts

@@ -1,2 +0,0 @@
-declare module "agent-workstation";
-declare module "deepbrain";

package/src/ui/components.ts

@@ -1,127 +0,0 @@
-/**
- * Chat Widget — self-contained HTML+CSS+JS for embedding
- */
-
-export interface ChatWidgetConfig {
-  endpoint: string;
-  theme?: 'dark' | 'light';
-  title?: string;
-}
-
-export function generateChatWidget(config: ChatWidgetConfig): string {
-  const { endpoint, theme = 'dark', title = 'OPC Chat' } = config;
-  const isDark = theme === 'dark';
-  const bg = isDark ? '#1a1a2e' : '#ffffff';
-  const fg = isDark ? '#e0e0e0' : '#1a1a2e';
-  const inputBg = isDark ? '#16213e' : '#f0f0f0';
-  const msgUser = isDark ? '#0f3460' : '#e3f2fd';
-  const msgBot = isDark ? '#1a1a2e' : '#f5f5f5';
-  const accent = '#00d2ff';
-
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>${title}</title>
-<style>
-* { margin: 0; padding: 0; box-sizing: border-box; }
-body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: ${bg}; color: ${fg}; height: 100vh; display: flex; flex-direction: column; }
-.chat-header { padding: 16px 20px; background: ${isDark ? '#16213e' : '#fafafa'}; border-bottom: 1px solid ${isDark ? '#2a2a4a' : '#e0e0e0'}; font-weight: 600; font-size: 16px; display: flex; align-items: center; gap: 8px; }
-.chat-header::before { content: '💬'; }
-.chat-messages { flex: 1; overflow-y: auto; padding: 16px; display: flex; flex-direction: column; gap: 12px; }
-.msg { max-width: 80%; padding: 10px 14px; border-radius: 12px; line-height: 1.5; font-size: 14px; white-space: pre-wrap; word-wrap: break-word; }
-.msg.user { align-self: flex-end; background: ${msgUser}; border-bottom-right-radius: 4px; }
-.msg.assistant { align-self: flex-start; background: ${msgBot}; border: 1px solid ${isDark ? '#2a2a4a' : '#e0e0e0'}; border-bottom-left-radius: 4px; }
-.msg.streaming::after { content: '▊'; animation: blink 0.7s infinite; }
-@keyframes blink { 50% { opacity: 0; } }
-.chat-input { display: flex; gap: 8px; padding: 12px 16px; border-top: 1px solid ${isDark ? '#2a2a4a' : '#e0e0e0'}; background: ${isDark ? '#16213e' : '#fafafa'}; }
-.chat-input textarea { flex: 1; resize: none; border: 1px solid ${isDark ? '#2a2a4a' : '#ccc'}; border-radius: 8px; padding: 10px; font-size: 14px; background: ${inputBg}; color: ${fg}; outline: none; font-family: inherit; min-height: 42px; max-height: 120px; }
-.chat-input textarea:focus { border-color: ${accent}; }
-.chat-input button { background: ${accent}; color: #000; border: none; border-radius: 8px; padding: 0 20px; cursor: pointer; font-weight: 600; font-size: 14px; }
-.chat-input button:hover { opacity: 0.85; }
-.chat-input button:disabled { opacity: 0.4; cursor: not-allowed; }
-</style>
-</head>
-<body>
-<div class="chat-header">${title}</div>
-<div class="chat-messages" id="messages"></div>
-<div class="chat-input">
-  <textarea id="input" rows="1" placeholder="Type a message..." onkeydown="if(event.key==='Enter'&&!event.shiftKey){event.preventDefault();sendMessage()}"></textarea>
-  <button id="sendBtn" onclick="sendMessage()">Send</button>
-</div>
-<script>
-const ENDPOINT = ${JSON.stringify(endpoint)};
-const messages = [];
-const $msgs = document.getElementById('messages');
-const $input = document.getElementById('input');
-const $btn = document.getElementById('sendBtn');
-
-function addMsg(role, text) {
-  const div = document.createElement('div');
-  div.className = 'msg ' + role;
-  div.textContent = text;
-  $msgs.appendChild(div);
-  $msgs.scrollTop = $msgs.scrollHeight;
-  return div;
-}
-
-async function sendMessage() {
-  const text = $input.value.trim();
-  if (!text) return;
-  $input.value = '';
-  $btn.disabled = true;
-  messages.push({ role: 'user', content: text });
-  addMsg('user', text);
-
-  const div = addMsg('assistant', '');
-  div.classList.add('streaming');
-  let full = '';
-
-  try {
-    const res = await fetch(ENDPOINT, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ messages }),
-    });
-
-    if (res.headers.get('content-type')?.includes('text/event-stream')) {
-      const reader = res.body.getReader();
-      const decoder = new TextDecoder();
-      let buf = '';
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-        buf += decoder.decode(value, { stream: true });
-        const lines = buf.split('\\n');
-        buf = lines.pop() || '';
-        for (const line of lines) {
-          if (line.startsWith('data: ')) {
-            const data = line.slice(6);
-            if (data === '[DONE]') break;
-            try { const j = JSON.parse(data); full += j.content || j.delta || ''; div.textContent = full; } catch {}
-          }
-        }
-        $msgs.scrollTop = $msgs.scrollHeight;
-      }
-    } else {
-      const data = await res.json();
-      full = data.content || data.message || JSON.stringify(data);
-      div.textContent = full;
-    }
-  } catch (e) {
-    full = 'Error: ' + e.message;
-    div.textContent = full;
-  }
-
-  div.classList.remove('streaming');
-  messages.push({ role: 'assistant', content: full });
-  $btn.disabled = false;
-  $input.focus();
-}
-
-$input.focus();
-</script>
-</body>
-</html>`;
-}

package/srv-out.txt

@@ -1 +0,0 @@
-Studio test server ready: http://localhost:4449

package/test-agent/Dockerfile

@@ -1,9 +0,0 @@
-FROM node:22-alpine
-WORKDIR /app
-COPY package.json package-lock.json* ./
-RUN npm ci --production 2>/dev/null || npm install --production
-COPY oad.yaml agent.yaml .env* ./
-COPY src/ ./src/
-COPY prompts/ ./prompts/ 2>/dev/null || true
-EXPOSE 3000
-CMD ["npx", "opc", "run"]

package/test-agent/README.md

@@ -1,50 +0,0 @@
-# test-agent
-
-Created with [OPC Agent](https://github.com/Deepleaper/opc-agent) using the `customer-service` template.
-
-## Quick Start
-
-1. **Install dependencies:**
-   ```bash
-   npm install
-   ```
-
-2. **Run with Ollama (default):**
-   ```bash
-   # Make sure Ollama is running with qwen2.5 model
-   ollama pull qwen2.5
-   npx tsx src/index.ts
-   ```
-
-3. **Or use OpenAI/other providers:**
-   ```bash
-   # Edit .env and set your API key
-   npx opc run
-   ```
-
-4. **Open browser:** [http://localhost:3000](http://localhost:3000)
-
-## Development
-
-```bash
-npx opc dev    # Hot-reload mode
-npx opc chat   # CLI chat
-```
-
-## Project Structure
-
-```
-test-agent/
-├── agent.yaml          # OAD agent config (used by src/index.ts)
-├── oad.yaml            # OAD config (used by opc CLI)
-├── src/
-│   ├── index.ts        # Entry point
-│   └── skills/
-│       └── echo.ts     # Example skill
-├── package.json
-└── tsconfig.json
-```
-
-## Configuration
-
-Edit `agent.yaml` to customize your agent's personality, skills, and behavior.