opc-agent 4.0.44 → 4.1.1

package/src/tools/builtin/vision.ts

@@ -1,64 +1,64 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-import { VisionManager } from '../../core/vision';
-import type { ImageInput } from '../../core/vision';
-
-const manager = new VisionManager();
-
-export const visionAnalyzeTool: MCPTool = {
-  name: 'vision_analyze',
-  description: 'Analyze an image using vision AI. Provide image as URL or base64.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      image_url: { type: 'string', description: 'URL of the image to analyze' },
-      image_base64: { type: 'string', description: 'Base64-encoded image data' },
-      prompt: { type: 'string', description: 'Optional prompt for analysis' },
-    },
-  },
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const imgInput: ImageInput = input.image_url
-      ? { type: 'url', data: input.image_url as string }
-      : { type: 'base64', data: input.image_base64 as string };
-    const result = await manager.analyze(imgInput, input.prompt as string | undefined);
-    return { content: JSON.stringify(result) };
-  },
-};
-
-export const visionExtractTextTool: MCPTool = {
-  name: 'vision_extract_text',
-  description: 'Extract text (OCR) from an image.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      image_url: { type: 'string', description: 'URL of the image' },
-      image_base64: { type: 'string', description: 'Base64-encoded image data' },
-    },
-  },
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const imgInput: ImageInput = input.image_url
-      ? { type: 'url', data: input.image_url as string }
-      : { type: 'base64', data: input.image_base64 as string };
-    const text = await manager.extractText(imgInput);
-    return { content: text };
-  },
-};
-
-export const visionCompareTool: MCPTool = {
-  name: 'vision_compare',
-  description: 'Compare multiple images.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      image_urls: { type: 'array', items: { type: 'string' }, description: 'URLs of images to compare' },
-      prompt: { type: 'string', description: 'Optional comparison prompt' },
-    },
-  },
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const urls = input.image_urls as string[];
-    const images: ImageInput[] = urls.map(url => ({ type: 'url' as const, data: url }));
-    const result = await manager.compareImages(images, input.prompt as string | undefined);
-    return { content: result };
-  },
-};
-
-export const visionTools: MCPTool[] = [visionAnalyzeTool, visionExtractTextTool, visionCompareTool];
+import type { MCPTool, MCPToolResult } from '../mcp';
+import { VisionManager } from '../../core/vision';
+import type { ImageInput } from '../../core/vision';
+
+const manager = new VisionManager();
+
+export const visionAnalyzeTool: MCPTool = {
+  name: 'vision_analyze',
+  description: 'Analyze an image using vision AI. Provide image as URL or base64.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      image_url: { type: 'string', description: 'URL of the image to analyze' },
+      image_base64: { type: 'string', description: 'Base64-encoded image data' },
+      prompt: { type: 'string', description: 'Optional prompt for analysis' },
+    },
+  },
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const imgInput: ImageInput = input.image_url
+      ? { type: 'url', data: input.image_url as string }
+      : { type: 'base64', data: input.image_base64 as string };
+    const result = await manager.analyze(imgInput, input.prompt as string | undefined);
+    return { content: JSON.stringify(result) };
+  },
+};
+
+export const visionExtractTextTool: MCPTool = {
+  name: 'vision_extract_text',
+  description: 'Extract text (OCR) from an image.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      image_url: { type: 'string', description: 'URL of the image' },
+      image_base64: { type: 'string', description: 'Base64-encoded image data' },
+    },
+  },
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const imgInput: ImageInput = input.image_url
+      ? { type: 'url', data: input.image_url as string }
+      : { type: 'base64', data: input.image_base64 as string };
+    const text = await manager.extractText(imgInput);
+    return { content: text };
+  },
+};
+
+export const visionCompareTool: MCPTool = {
+  name: 'vision_compare',
+  description: 'Compare multiple images.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      image_urls: { type: 'array', items: { type: 'string' }, description: 'URLs of images to compare' },
+      prompt: { type: 'string', description: 'Optional comparison prompt' },
+    },
+  },
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const urls = input.image_urls as string[];
+    const images: ImageInput[] = urls.map(url => ({ type: 'url' as const, data: url }));
+    const result = await manager.compareImages(images, input.prompt as string | undefined);
+    return { content: result };
+  },
+};
+
+export const visionTools: MCPTool[] = [visionAnalyzeTool, visionExtractTextTool, visionCompareTool];

package/src/tools/builtin/web-search.ts

@@ -1,126 +1,126 @@
-/**
- * Web Search & Read Built-in Tools - v0.10.0
- * Registers web_search and web_read as agent-callable tools.
- */
-
-import type { MCPTool, MCPToolResult } from '../mcp';
-import { webSearch, DEFAULT_SEARCH_CONFIG, type WebSearchConfig, type SearchEngine } from '../web-search';
-import { scrapeUrl } from '../web-scraper';
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-import * as os from 'os';
-
-function loadSearchConfig(): WebSearchConfig {
-  try {
-    const cfgPath = join(os.homedir(), '.opc', 'config.json');
-    if (existsSync(cfgPath)) {
-      const cfg = JSON.parse(readFileSync(cfgPath, 'utf-8'));
-      if (cfg.webSearch) {
-        return { ...DEFAULT_SEARCH_CONFIG, ...cfg.webSearch };
-      }
-    }
-  } catch { /* ignore */ }
-  return DEFAULT_SEARCH_CONFIG;
-}
-
-export const webSearchTool: MCPTool = {
-  name: 'web_search',
-  description: 'Search the internet for information. Returns titles, URLs, and snippets from search results. Use when you need current information or facts you\'re unsure about.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      query: {
-        type: 'string',
-        description: 'Search query string',
-      },
-      maxResults: {
-        type: 'number',
-        description: 'Maximum number of results to return (default: 5)',
-      },
-      engine: {
-        type: 'string',
-        enum: ['duckduckgo', 'brave', 'searxng', 'google'],
-        description: 'Search engine to use (default: configured engine)',
-      },
-    },
-    required: ['query'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const query = String(input.query ?? '');
-    if (!query.trim()) {
-      return { content: 'Error: empty search query', isError: true };
-    }
-
-    const config = loadSearchConfig();
-    if (!config.enabled) {
-      return { content: 'Web search is disabled in settings.', isError: true };
-    }
-
-    try {
-      const results = await webSearch(query, config, {
-        maxResults: (input.maxResults as number) || 5,
-        engine: input.engine as SearchEngine | undefined,
-      });
-
-      if (results.length === 0) {
-        return { content: `No results found for: ${query}` };
-      }
-
-      const formatted = results.map((r, i) =>
-        `${i + 1}. **${r.title}**\n   ${r.url}\n   ${r.snippet}`
-      ).join('\n\n');
-
-      return {
-        content: `Search results for "${query}":\n\n${formatted}`,
-        metadata: { resultCount: results.length, query },
-      };
-    } catch (err) {
-      return {
-        content: `Search error: ${err instanceof Error ? err.message : String(err)}`,
-        isError: true,
-      };
-    }
-  },
-};
-
-export const webReadTool: MCPTool = {
-  name: 'web_read',
-  description: 'Read and extract the main content from a web page URL. Returns clean markdown text. Use to get detailed information from a specific page.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      url: {
-        type: 'string',
-        description: 'URL of the web page to read',
-      },
-      maxLength: {
-        type: 'number',
-        description: 'Maximum content length in characters (default: 5000)',
-      },
-    },
-    required: ['url'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const url = String(input.url ?? '');
-    if (!url.trim()) {
-      return { content: 'Error: empty URL', isError: true };
-    }
-
-    try {
-      const result = await scrapeUrl(url, (input.maxLength as number) || 5000);
-      return {
-        content: `# ${result.title}\n\nSource: ${result.url}\nWords: ${result.wordCount}\n\n---\n\n${result.content}`,
-        metadata: { title: result.title, url: result.url, wordCount: result.wordCount },
-      };
-    } catch (err) {
-      return {
-        content: `Scrape error: ${err instanceof Error ? err.message : String(err)}`,
-        isError: true,
-      };
-    }
-  },
-};
-
-export const webSearchTools: MCPTool[] = [webSearchTool, webReadTool];
+/**
+ * Web Search & Read Built-in Tools - v0.10.0
+ * Registers web_search and web_read as agent-callable tools.
+ */
+
+import type { MCPTool, MCPToolResult } from '../mcp';
+import { webSearch, DEFAULT_SEARCH_CONFIG, type WebSearchConfig, type SearchEngine } from '../web-search';
+import { scrapeUrl } from '../web-scraper';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import * as os from 'os';
+
+function loadSearchConfig(): WebSearchConfig {
+  try {
+    const cfgPath = join(os.homedir(), '.opc', 'config.json');
+    if (existsSync(cfgPath)) {
+      const cfg = JSON.parse(readFileSync(cfgPath, 'utf-8'));
+      if (cfg.webSearch) {
+        return { ...DEFAULT_SEARCH_CONFIG, ...cfg.webSearch };
+      }
+    }
+  } catch { /* ignore */ }
+  return DEFAULT_SEARCH_CONFIG;
+}
+
+export const webSearchTool: MCPTool = {
+  name: 'web_search',
+  description: 'Search the internet for information. Returns titles, URLs, and snippets from search results. Use when you need current information or facts you\'re unsure about.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: {
+        type: 'string',
+        description: 'Search query string',
+      },
+      maxResults: {
+        type: 'number',
+        description: 'Maximum number of results to return (default: 5)',
+      },
+      engine: {
+        type: 'string',
+        enum: ['duckduckgo', 'brave', 'searxng', 'google'],
+        description: 'Search engine to use (default: configured engine)',
+      },
+    },
+    required: ['query'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const query = String(input.query ?? '');
+    if (!query.trim()) {
+      return { content: 'Error: empty search query', isError: true };
+    }
+
+    const config = loadSearchConfig();
+    if (!config.enabled) {
+      return { content: 'Web search is disabled in settings.', isError: true };
+    }
+
+    try {
+      const results = await webSearch(query, config, {
+        maxResults: (input.maxResults as number) || 5,
+        engine: input.engine as SearchEngine | undefined,
+      });
+
+      if (results.length === 0) {
+        return { content: `No results found for: ${query}` };
+      }
+
+      const formatted = results.map((r, i) =>
+        `${i + 1}. **${r.title}**\n   ${r.url}\n   ${r.snippet}`
+      ).join('\n\n');
+
+      return {
+        content: `Search results for "${query}":\n\n${formatted}`,
+        metadata: { resultCount: results.length, query },
+      };
+    } catch (err) {
+      return {
+        content: `Search error: ${err instanceof Error ? err.message : String(err)}`,
+        isError: true,
+      };
+    }
+  },
+};
+
+export const webReadTool: MCPTool = {
+  name: 'web_read',
+  description: 'Read and extract the main content from a web page URL. Returns clean markdown text. Use to get detailed information from a specific page.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      url: {
+        type: 'string',
+        description: 'URL of the web page to read',
+      },
+      maxLength: {
+        type: 'number',
+        description: 'Maximum content length in characters (default: 5000)',
+      },
+    },
+    required: ['url'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const url = String(input.url ?? '');
+    if (!url.trim()) {
+      return { content: 'Error: empty URL', isError: true };
+    }
+
+    try {
+      const result = await scrapeUrl(url, (input.maxLength as number) || 5000);
+      return {
+        content: `# ${result.title}\n\nSource: ${result.url}\nWords: ${result.wordCount}\n\n---\n\n${result.content}`,
+        metadata: { title: result.title, url: result.url, wordCount: result.wordCount },
+      };
+    } catch (err) {
+      return {
+        content: `Scrape error: ${err instanceof Error ? err.message : String(err)}`,
+        isError: true,
+      };
+    }
+  },
+};
+
+export const webSearchTools: MCPTool[] = [webSearchTool, webReadTool];

package/src/tools/builtin/web.ts

@@ -1,35 +1,35 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const webTool: MCPTool = {
-  name: 'web_fetch',
-  description: 'Fetch content from a URL',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      url: { type: 'string' },
-      method: { type: 'string', enum: ['GET', 'POST'], default: 'GET' },
-      maxLength: { type: 'number', default: 5000 },
-    },
-    required: ['url'],
-  },
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const url = input.url as string;
-    const method = (input.method as string) || 'GET';
-    const maxLength = (input.maxLength as number) || 5000;
-
-    try {
-      const response = await fetch(url, { method, signal: AbortSignal.timeout(15000) });
-      const text = await response.text();
-      const truncated = text.length > maxLength ? text.slice(0, maxLength) + '\n...[truncated]' : text;
-      return {
-        content: `Status: ${response.status}\n\n${truncated}`,
-        isError: false,
-      };
-    } catch (err) {
-      return {
-        content: `Fetch error: ${err instanceof Error ? err.message : String(err)}`,
-        isError: true,
-      };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const webTool: MCPTool = {
+  name: 'web_fetch',
+  description: 'Fetch content from a URL',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      url: { type: 'string' },
+      method: { type: 'string', enum: ['GET', 'POST'], default: 'GET' },
+      maxLength: { type: 'number', default: 5000 },
+    },
+    required: ['url'],
+  },
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const url = input.url as string;
+    const method = (input.method as string) || 'GET';
+    const maxLength = (input.maxLength as number) || 5000;
+
+    try {
+      const response = await fetch(url, { method, signal: AbortSignal.timeout(15000) });
+      const text = await response.text();
+      const truncated = text.length > maxLength ? text.slice(0, maxLength) + '\n...[truncated]' : text;
+      return {
+        content: `Status: ${response.status}\n\n${truncated}`,
+        isError: false,
+      };
+    } catch (err) {
+      return {
+        content: `Fetch error: ${err instanceof Error ? err.message : String(err)}`,
+        isError: true,
+      };
+    }
+  },
+};