opc-agent 4.1.0 → 4.1.2

package/src/tools/integrations/notion.ts

@@ -1,71 +1,71 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const NotionTool: MCPTool = {
-  name: 'notion',
-  description: 'Interact with Notion API: create pages, search, append blocks. Requires NOTION_API_KEY env var.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      action: { type: 'string', enum: ['create_page', 'search', 'append_block'], description: 'Action to perform' },
-      parent_id: { type: 'string', description: 'Parent page/database ID' },
-      title: { type: 'string', description: 'Page title (for create_page)' },
-      content: { type: 'string', description: 'Content text (for create_page or append_block)' },
-      query: { type: 'string', description: 'Search query (for search)' },
-      block_id: { type: 'string', description: 'Block ID (for append_block)' },
-    },
-    required: ['action'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const apiKey = process.env.NOTION_API_KEY;
-    if (!apiKey) return { content: 'Error: NOTION_API_KEY required', isError: true };
-
-    const action = String(input.action ?? '');
-    const headers = {
-      'Authorization': `Bearer ${apiKey}`,
-      'Content-Type': 'application/json',
-      'Notion-Version': '2022-06-28',
-    };
-
-    try {
-      if (action === 'create_page') {
-        if (!input.parent_id) return { content: 'Error: parent_id required', isError: true };
-        const res = await fetch('https://api.notion.com/v1/pages', {
-          method: 'POST', headers,
-          body: JSON.stringify({
-            parent: { page_id: input.parent_id },
-            properties: { title: { title: [{ text: { content: String(input.title ?? 'Untitled') } }] } },
-            children: input.content ? [{ object: 'block', type: 'paragraph', paragraph: { rich_text: [{ text: { content: String(input.content) } }] } }] : [],
-          }),
-        });
-        const data = await res.json() as Record<string, unknown>;
-        return { content: `Page created: ${data.id ?? 'unknown'}` };
-      }
-
-      if (action === 'search') {
-        const res = await fetch('https://api.notion.com/v1/search', {
-          method: 'POST', headers,
-          body: JSON.stringify({ query: String(input.query ?? '') }),
-        });
-        const data = await res.json() as Record<string, unknown>;
-        return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
-      }
-
-      if (action === 'append_block') {
-        if (!input.block_id) return { content: 'Error: block_id required', isError: true };
-        const res = await fetch(`https://api.notion.com/v1/blocks/${input.block_id}/children`, {
-          method: 'PATCH', headers,
-          body: JSON.stringify({
-            children: [{ object: 'block', type: 'paragraph', paragraph: { rich_text: [{ text: { content: String(input.content ?? '') } }] } }],
-          }),
-        });
-        const data = await res.json() as Record<string, unknown>;
-        return { content: `Block appended: ${JSON.stringify(data).slice(0, 500)}` };
-      }
-
-      return { content: `Unknown action: ${action}`, isError: true };
-    } catch (err) {
-      return { content: `Notion error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const NotionTool: MCPTool = {
+  name: 'notion',
+  description: 'Interact with Notion API: create pages, search, append blocks. Requires NOTION_API_KEY env var.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', enum: ['create_page', 'search', 'append_block'], description: 'Action to perform' },
+      parent_id: { type: 'string', description: 'Parent page/database ID' },
+      title: { type: 'string', description: 'Page title (for create_page)' },
+      content: { type: 'string', description: 'Content text (for create_page or append_block)' },
+      query: { type: 'string', description: 'Search query (for search)' },
+      block_id: { type: 'string', description: 'Block ID (for append_block)' },
+    },
+    required: ['action'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const apiKey = process.env.NOTION_API_KEY;
+    if (!apiKey) return { content: 'Error: NOTION_API_KEY required', isError: true };
+
+    const action = String(input.action ?? '');
+    const headers = {
+      'Authorization': `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+      'Notion-Version': '2022-06-28',
+    };
+
+    try {
+      if (action === 'create_page') {
+        if (!input.parent_id) return { content: 'Error: parent_id required', isError: true };
+        const res = await fetch('https://api.notion.com/v1/pages', {
+          method: 'POST', headers,
+          body: JSON.stringify({
+            parent: { page_id: input.parent_id },
+            properties: { title: { title: [{ text: { content: String(input.title ?? 'Untitled') } }] } },
+            children: input.content ? [{ object: 'block', type: 'paragraph', paragraph: { rich_text: [{ text: { content: String(input.content) } }] } }] : [],
+          }),
+        });
+        const data = await res.json() as Record<string, unknown>;
+        return { content: `Page created: ${data.id ?? 'unknown'}` };
+      }
+
+      if (action === 'search') {
+        const res = await fetch('https://api.notion.com/v1/search', {
+          method: 'POST', headers,
+          body: JSON.stringify({ query: String(input.query ?? '') }),
+        });
+        const data = await res.json() as Record<string, unknown>;
+        return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
+      }
+
+      if (action === 'append_block') {
+        if (!input.block_id) return { content: 'Error: block_id required', isError: true };
+        const res = await fetch(`https://api.notion.com/v1/blocks/${input.block_id}/children`, {
+          method: 'PATCH', headers,
+          body: JSON.stringify({
+            children: [{ object: 'block', type: 'paragraph', paragraph: { rich_text: [{ text: { content: String(input.content ?? '') } }] } }],
+          }),
+        });
+        const data = await res.json() as Record<string, unknown>;
+        return { content: `Block appended: ${JSON.stringify(data).slice(0, 500)}` };
+      }
+
+      return { content: `Unknown action: ${action}`, isError: true };
+    } catch (err) {
+      return { content: `Notion error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};

package/src/tools/integrations/npm-tool.ts

@@ -1,48 +1,48 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const NpmTool: MCPTool = {
-  name: 'npm',
-  description: 'Search npm registry, get package info, or list installed packages.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      action: { type: 'string', enum: ['search', 'info', 'install'], description: 'Action' },
-      package: { type: 'string', description: 'Package name' },
-      query: { type: 'string', description: 'Search query (for search)' },
-    },
-    required: ['action'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const action = String(input.action ?? '');
-
-    try {
-      if (action === 'search') {
-        const q = String(input.query ?? input.package ?? '');
-        if (!q) return { content: 'Error: query required', isError: true };
-        const res = await fetch(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(q)}&size=10`);
-        const data = await res.json() as { objects?: Array<{ package: { name: string; version: string; description: string } }> };
-        const results = (data.objects ?? []).map((o) => `${o.package.name}@${o.package.version} — ${o.package.description}`).join('\n');
-        return { content: results || 'No results' };
-      }
-
-      if (action === 'info') {
-        const pkg = String(input.package ?? '');
-        if (!pkg) return { content: 'Error: package required', isError: true };
-        const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(pkg)}`);
-        if (!res.ok) return { content: `Package not found: ${pkg}`, isError: true };
-        const data = await res.json() as Record<string, unknown>;
-        const latest = (data['dist-tags'] as Record<string, string>)?.latest;
-        return { content: `${data.name}@${latest}\n${data.description}\nLicense: ${data.license}\nHomepage: ${data.homepage}` };
-      }
-
-      if (action === 'install') {
-        return { content: 'Error: npm install is not supported via this tool for security. Use shell access instead.', isError: true };
-      }
-
-      return { content: `Unknown action: ${action}`, isError: true };
-    } catch (err) {
-      return { content: `NPM error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const NpmTool: MCPTool = {
+  name: 'npm',
+  description: 'Search npm registry, get package info, or list installed packages.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', enum: ['search', 'info', 'install'], description: 'Action' },
+      package: { type: 'string', description: 'Package name' },
+      query: { type: 'string', description: 'Search query (for search)' },
+    },
+    required: ['action'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const action = String(input.action ?? '');
+
+    try {
+      if (action === 'search') {
+        const q = String(input.query ?? input.package ?? '');
+        if (!q) return { content: 'Error: query required', isError: true };
+        const res = await fetch(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(q)}&size=10`);
+        const data = await res.json() as { objects?: Array<{ package: { name: string; version: string; description: string } }> };
+        const results = (data.objects ?? []).map((o) => `${o.package.name}@${o.package.version} — ${o.package.description}`).join('\n');
+        return { content: results || 'No results' };
+      }
+
+      if (action === 'info') {
+        const pkg = String(input.package ?? '');
+        if (!pkg) return { content: 'Error: package required', isError: true };
+        const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(pkg)}`);
+        if (!res.ok) return { content: `Package not found: ${pkg}`, isError: true };
+        const data = await res.json() as Record<string, unknown>;
+        const latest = (data['dist-tags'] as Record<string, string>)?.latest;
+        return { content: `${data.name}@${latest}\n${data.description}\nLicense: ${data.license}\nHomepage: ${data.homepage}` };
+      }
+
+      if (action === 'install') {
+        return { content: 'Error: npm install is not supported via this tool for security. Use shell access instead.', isError: true };
+      }
+
+      return { content: `Unknown action: ${action}`, isError: true };
+    } catch (err) {
+      return { content: `NPM error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};

package/src/tools/integrations/pdf-reader.ts

@@ -1,58 +1,58 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-import * as fs from 'fs';
-
-export const PDFReaderTool: MCPTool = {
-  name: 'pdf-reader',
-  description: 'Extract text content from a PDF file. Uses basic binary parsing (no external deps).',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      file_path: { type: 'string', description: 'Path to PDF file' },
-      url: { type: 'string', description: 'URL of PDF file (alternative to file_path)' },
-      max_length: { type: 'number', description: 'Max characters to return (default: 5000)' },
-    },
-    required: [],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const maxLen = Number(input.max_length ?? 5000);
-
-    try {
-      let buffer: Buffer;
-
-      if (input.url) {
-        const res = await fetch(String(input.url));
-        if (!res.ok) return { content: `HTTP ${res.status}`, isError: true };
-        buffer = Buffer.from(await res.arrayBuffer());
-      } else if (input.file_path) {
-        buffer = fs.readFileSync(String(input.file_path));
-      } else {
-        return { content: 'Error: file_path or url required', isError: true };
-      }
-
-      // Basic PDF text extraction — find text between BT/ET markers and decode
-      const content = buffer.toString('latin1');
-      const textParts: string[] = [];
-
-      // Extract text from stream objects
-      const streamRegex = /stream\r?\n([\s\S]*?)\r?\nendstream/g;
-      let match: RegExpExecArray | null;
-      while ((match = streamRegex.exec(content)) !== null) {
-        const stream = match[1];
-        // Extract text shown with Tj or TJ operators
-        const tjRegex = /\(([^)]*)\)\s*Tj/g;
-        let tjMatch: RegExpExecArray | null;
-        while ((tjMatch = tjRegex.exec(stream)) !== null) {
-          textParts.push(tjMatch[1]);
-        }
-      }
-
-      const text = textParts.join(' ').replace(/\\n/g, '\n').replace(/\\\(/g, '(').replace(/\\\)/g, ')');
-      if (!text.trim()) return { content: '(No extractable text found — PDF may use compressed streams. Consider using a dedicated PDF library.)' };
-
-      return { content: text.slice(0, maxLen), metadata: { pages_approx: (content.match(/\/Type\s*\/Page[^s]/g) || []).length } };
-    } catch (err) {
-      return { content: `PDF error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+import * as fs from 'fs';
+
+export const PDFReaderTool: MCPTool = {
+  name: 'pdf-reader',
+  description: 'Extract text content from a PDF file. Uses basic binary parsing (no external deps).',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: 'Path to PDF file' },
+      url: { type: 'string', description: 'URL of PDF file (alternative to file_path)' },
+      max_length: { type: 'number', description: 'Max characters to return (default: 5000)' },
+    },
+    required: [],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const maxLen = Number(input.max_length ?? 5000);
+
+    try {
+      let buffer: Buffer;
+
+      if (input.url) {
+        const res = await fetch(String(input.url));
+        if (!res.ok) return { content: `HTTP ${res.status}`, isError: true };
+        buffer = Buffer.from(await res.arrayBuffer());
+      } else if (input.file_path) {
+        buffer = fs.readFileSync(String(input.file_path));
+      } else {
+        return { content: 'Error: file_path or url required', isError: true };
+      }
+
+      // Basic PDF text extraction — find text between BT/ET markers and decode
+      const content = buffer.toString('latin1');
+      const textParts: string[] = [];
+
+      // Extract text from stream objects
+      const streamRegex = /stream\r?\n([\s\S]*?)\r?\nendstream/g;
+      let match: RegExpExecArray | null;
+      while ((match = streamRegex.exec(content)) !== null) {
+        const stream = match[1];
+        // Extract text shown with Tj or TJ operators
+        const tjRegex = /\(([^)]*)\)\s*Tj/g;
+        let tjMatch: RegExpExecArray | null;
+        while ((tjMatch = tjRegex.exec(stream)) !== null) {
+          textParts.push(tjMatch[1]);
+        }
+      }
+
+      const text = textParts.join(' ').replace(/\\n/g, '\n').replace(/\\\(/g, '(').replace(/\\\)/g, ')');
+      if (!text.trim()) return { content: '(No extractable text found — PDF may use compressed streams. Consider using a dedicated PDF library.)' };
+
+      return { content: text.slice(0, maxLen), metadata: { pages_approx: (content.match(/\/Type\s*\/Page[^s]/g) || []).length } };
+    } catch (err) {
+      return { content: `PDF error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};

package/src/tools/integrations/slack.ts

@@ -1,65 +1,65 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const SlackTool: MCPTool = {
-  name: 'slack',
-  description: 'Send messages to Slack channels, list channels, or search messages. Requires SLACK_WEBHOOK_URL or SLACK_BOT_TOKEN env var.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      action: { type: 'string', enum: ['send_message', 'list_channels', 'search'], description: 'Action to perform' },
-      channel: { type: 'string', description: 'Channel name or ID (for send_message)' },
-      text: { type: 'string', description: 'Message text (for send_message) or search query (for search)' },
-    },
-    required: ['action'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const action = String(input.action ?? '');
-    const token = process.env.SLACK_BOT_TOKEN;
-    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
-
-    try {
-      if (action === 'send_message') {
-        if (!input.text) return { content: 'Error: text is required', isError: true };
-        if (webhookUrl) {
-          const res = await fetch(webhookUrl, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ channel: input.channel, text: input.text }),
-          });
-          return { content: `Message sent (status: ${res.status})` };
-        }
-        if (!token) return { content: 'Error: SLACK_BOT_TOKEN or SLACK_WEBHOOK_URL required', isError: true };
-        const res = await fetch('https://slack.com/api/chat.postMessage', {
-          method: 'POST',
-          headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
-          body: JSON.stringify({ channel: input.channel, text: input.text }),
-        });
-        const data = await res.json() as Record<string, unknown>;
-        return { content: data.ok ? 'Message sent' : `Error: ${data.error}`, isError: !data.ok };
-      }
-
-      if (action === 'list_channels') {
-        if (!token) return { content: 'Error: SLACK_BOT_TOKEN required', isError: true };
-        const res = await fetch('https://slack.com/api/conversations.list', {
-          headers: { 'Authorization': `Bearer ${token}` },
-        });
-        const data = await res.json() as Record<string, unknown>;
-        return { content: JSON.stringify(data, null, 2) };
-      }
-
-      if (action === 'search') {
-        if (!token) return { content: 'Error: SLACK_BOT_TOKEN required', isError: true };
-        const res = await fetch(`https://slack.com/api/search.messages?query=${encodeURIComponent(String(input.text ?? ''))}`, {
-          headers: { 'Authorization': `Bearer ${token}` },
-        });
-        const data = await res.json() as Record<string, unknown>;
-        return { content: JSON.stringify(data, null, 2) };
-      }
-
-      return { content: `Unknown action: ${action}`, isError: true };
-    } catch (err) {
-      return { content: `Slack error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const SlackTool: MCPTool = {
+  name: 'slack',
+  description: 'Send messages to Slack channels, list channels, or search messages. Requires SLACK_WEBHOOK_URL or SLACK_BOT_TOKEN env var.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', enum: ['send_message', 'list_channels', 'search'], description: 'Action to perform' },
+      channel: { type: 'string', description: 'Channel name or ID (for send_message)' },
+      text: { type: 'string', description: 'Message text (for send_message) or search query (for search)' },
+    },
+    required: ['action'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const action = String(input.action ?? '');
+    const token = process.env.SLACK_BOT_TOKEN;
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+
+    try {
+      if (action === 'send_message') {
+        if (!input.text) return { content: 'Error: text is required', isError: true };
+        if (webhookUrl) {
+          const res = await fetch(webhookUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ channel: input.channel, text: input.text }),
+          });
+          return { content: `Message sent (status: ${res.status})` };
+        }
+        if (!token) return { content: 'Error: SLACK_BOT_TOKEN or SLACK_WEBHOOK_URL required', isError: true };
+        const res = await fetch('https://slack.com/api/chat.postMessage', {
+          method: 'POST',
+          headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ channel: input.channel, text: input.text }),
+        });
+        const data = await res.json() as Record<string, unknown>;
+        return { content: data.ok ? 'Message sent' : `Error: ${data.error}`, isError: !data.ok };
+      }
+
+      if (action === 'list_channels') {
+        if (!token) return { content: 'Error: SLACK_BOT_TOKEN required', isError: true };
+        const res = await fetch('https://slack.com/api/conversations.list', {
+          headers: { 'Authorization': `Bearer ${token}` },
+        });
+        const data = await res.json() as Record<string, unknown>;
+        return { content: JSON.stringify(data, null, 2) };
+      }
+
+      if (action === 'search') {
+        if (!token) return { content: 'Error: SLACK_BOT_TOKEN required', isError: true };
+        const res = await fetch(`https://slack.com/api/search.messages?query=${encodeURIComponent(String(input.text ?? ''))}`, {
+          headers: { 'Authorization': `Bearer ${token}` },
+        });
+        const data = await res.json() as Record<string, unknown>;
+        return { content: JSON.stringify(data, null, 2) };
+      }
+
+      return { content: `Unknown action: ${action}`, isError: true };
+    } catch (err) {
+      return { content: `Slack error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};

package/src/tools/integrations/summarizer.ts

@@ -1,49 +1,49 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const SummarizerTool: MCPTool = {
-  name: 'summarizer',
-  description: 'Summarize long text using an LLM API. Requires OPENAI_API_KEY or LLM_API_URL env var.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      text: { type: 'string', description: 'Text to summarize' },
-      max_length: { type: 'number', description: 'Approximate max summary length in words (default: 200)' },
-      style: { type: 'string', enum: ['brief', 'detailed', 'bullets'], description: 'Summary style (default: brief)' },
-    },
-    required: ['text'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const text = String(input.text ?? '');
-    if (!text) return { content: 'Error: text required', isError: true };
-
-    const style = String(input.style ?? 'brief');
-    const maxLen = Number(input.max_length ?? 200);
-    const prompt = `Summarize the following text in a ${style} style, approximately ${maxLen} words:\n\n${text.slice(0, 15000)}`;
-
-    try {
-      const apiKey = process.env.OPENAI_API_KEY;
-      const apiUrl = process.env.LLM_API_URL || 'https://api.openai.com/v1/chat/completions';
-      if (!apiKey && apiUrl === 'https://api.openai.com/v1/chat/completions') {
-        return { content: 'Error: OPENAI_API_KEY or LLM_API_URL required', isError: true };
-      }
-
-      const headers: Record<string, string> = { 'Content-Type': 'application/json' };
-      if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
-
-      const res = await fetch(apiUrl, {
-        method: 'POST', headers,
-        body: JSON.stringify({
-          model: process.env.LLM_MODEL || 'gpt-4o-mini',
-          messages: [{ role: 'user', content: prompt }],
-          max_tokens: maxLen * 3,
-        }),
-      });
-      const data = await res.json() as { choices?: Array<{ message: { content: string } }> };
-      const summary = data.choices?.[0]?.message?.content ?? 'No summary generated';
-      return { content: summary };
-    } catch (err) {
-      return { content: `Summarizer error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const SummarizerTool: MCPTool = {
+  name: 'summarizer',
+  description: 'Summarize long text using an LLM API. Requires OPENAI_API_KEY or LLM_API_URL env var.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      text: { type: 'string', description: 'Text to summarize' },
+      max_length: { type: 'number', description: 'Approximate max summary length in words (default: 200)' },
+      style: { type: 'string', enum: ['brief', 'detailed', 'bullets'], description: 'Summary style (default: brief)' },
+    },
+    required: ['text'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const text = String(input.text ?? '');
+    if (!text) return { content: 'Error: text required', isError: true };
+
+    const style = String(input.style ?? 'brief');
+    const maxLen = Number(input.max_length ?? 200);
+    const prompt = `Summarize the following text in a ${style} style, approximately ${maxLen} words:\n\n${text.slice(0, 15000)}`;
+
+    try {
+      const apiKey = process.env.OPENAI_API_KEY;
+      const apiUrl = process.env.LLM_API_URL || 'https://api.openai.com/v1/chat/completions';
+      if (!apiKey && apiUrl === 'https://api.openai.com/v1/chat/completions') {
+        return { content: 'Error: OPENAI_API_KEY or LLM_API_URL required', isError: true };
+      }
+
+      const headers: Record<string, string> = { 'Content-Type': 'application/json' };
+      if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
+
+      const res = await fetch(apiUrl, {
+        method: 'POST', headers,
+        body: JSON.stringify({
+          model: process.env.LLM_MODEL || 'gpt-4o-mini',
+          messages: [{ role: 'user', content: prompt }],
+          max_tokens: maxLen * 3,
+        }),
+      });
+      const data = await res.json() as { choices?: Array<{ message: { content: string } }> };
+      const summary = data.choices?.[0]?.message?.content ?? 'No summary generated';
+      return { content: summary };
+    } catch (err) {
+      return { content: `Summarizer error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};