opc-agent 4.1.0 → 4.1.2

package/src/protocols/agui/types.ts

@@ -1,153 +1,153 @@
-// AG-UI Protocol Types — Agent-User Interaction Protocol
-// https://docs.ag-ui.com
-
-export type AGUIEventType =
-  | 'TEXT_MESSAGE_START'
-  | 'TEXT_MESSAGE_CONTENT'
-  | 'TEXT_MESSAGE_END'
-  | 'TOOL_CALL_START'
-  | 'TOOL_CALL_ARGS'
-  | 'TOOL_CALL_END'
-  | 'STATE_SNAPSHOT'
-  | 'STATE_DELTA'
-  | 'MESSAGES_SNAPSHOT'
-  | 'RUN_STARTED'
-  | 'RUN_FINISHED'
-  | 'RUN_ERROR'
-  | 'STEP_STARTED'
-  | 'STEP_FINISHED'
-  | 'CUSTOM';
-
-export const AGUI_EVENT_TYPES: AGUIEventType[] = [
-  'TEXT_MESSAGE_START', 'TEXT_MESSAGE_CONTENT', 'TEXT_MESSAGE_END',
-  'TOOL_CALL_START', 'TOOL_CALL_ARGS', 'TOOL_CALL_END',
-  'STATE_SNAPSHOT', 'STATE_DELTA', 'MESSAGES_SNAPSHOT',
-  'RUN_STARTED', 'RUN_FINISHED', 'RUN_ERROR',
-  'STEP_STARTED', 'STEP_FINISHED', 'CUSTOM',
-];
-
-export interface AGUIEvent {
-  type: AGUIEventType;
-  timestamp: string;
-  [key: string]: any;
-}
-
-export interface TextMessageStartEvent extends AGUIEvent {
-  type: 'TEXT_MESSAGE_START';
-  messageId: string;
-  role: 'assistant';
-}
-
-export interface TextMessageContentEvent extends AGUIEvent {
-  type: 'TEXT_MESSAGE_CONTENT';
-  messageId: string;
-  delta: string;
-}
-
-export interface TextMessageEndEvent extends AGUIEvent {
-  type: 'TEXT_MESSAGE_END';
-  messageId: string;
-}
-
-export interface ToolCallStartEvent extends AGUIEvent {
-  type: 'TOOL_CALL_START';
-  toolCallId: string;
-  toolCallName: string;
-}
-
-export interface ToolCallArgsEvent extends AGUIEvent {
-  type: 'TOOL_CALL_ARGS';
-  toolCallId: string;
-  delta: string;
-}
-
-export interface ToolCallEndEvent extends AGUIEvent {
-  type: 'TOOL_CALL_END';
-  toolCallId: string;
-}
-
-export interface StateSnapshotEvent extends AGUIEvent {
-  type: 'STATE_SNAPSHOT';
-  snapshot: Record<string, any>;
-}
-
-export interface StateDeltaEvent extends AGUIEvent {
-  type: 'STATE_DELTA';
-  delta: any[]; // JSON Patch (RFC 6902)
-}
-
-export interface MessagesSnapshotEvent extends AGUIEvent {
-  type: 'MESSAGES_SNAPSHOT';
-  messages: AGUIMessage[];
-}
-
-export interface RunStartedEvent extends AGUIEvent {
-  type: 'RUN_STARTED';
-  runId: string;
-  threadId?: string;
-}
-
-export interface RunFinishedEvent extends AGUIEvent {
-  type: 'RUN_FINISHED';
-  runId: string;
-}
-
-export interface RunErrorEvent extends AGUIEvent {
-  type: 'RUN_ERROR';
-  runId: string;
-  message: string;
-  code?: string;
-}
-
-export interface StepStartedEvent extends AGUIEvent {
-  type: 'STEP_STARTED';
-  stepId: string;
-  stepName?: string;
-}
-
-export interface StepFinishedEvent extends AGUIEvent {
-  type: 'STEP_FINISHED';
-  stepId: string;
-}
-
-export interface CustomEvent extends AGUIEvent {
-  type: 'CUSTOM';
-  name: string;
-  value: any;
-}
-
-// ─── Message & Request Types ─────────────────────────────────
-
-export interface AGUIMessage {
-  id: string;
-  role: 'user' | 'assistant' | 'system' | 'tool';
-  content: string;
-  name?: string;
-  toolCallId?: string;
-  toolCalls?: AGUIToolCall[];
-}
-
-export interface AGUIToolCall {
-  id: string;
-  type: 'function';
-  function: { name: string; arguments: string };
-}
-
-export interface AGUIRunRequest {
-  threadId?: string;
-  runId?: string;
-  messages: AGUIMessage[];
-  tools?: AGUIToolDefinition[];
-  context?: any[];
-  forwardedProps?: Record<string, any>;
-}
-
-export interface AGUIToolDefinition {
-  name: string;
-  description: string;
-  parameters: Record<string, any>; // JSON Schema
-}
-
-export function isValidEventType(type: string): type is AGUIEventType {
-  return AGUI_EVENT_TYPES.includes(type as AGUIEventType);
-}
+// AG-UI Protocol Types — Agent-User Interaction Protocol
+// https://docs.ag-ui.com
+
+export type AGUIEventType =
+  | 'TEXT_MESSAGE_START'
+  | 'TEXT_MESSAGE_CONTENT'
+  | 'TEXT_MESSAGE_END'
+  | 'TOOL_CALL_START'
+  | 'TOOL_CALL_ARGS'
+  | 'TOOL_CALL_END'
+  | 'STATE_SNAPSHOT'
+  | 'STATE_DELTA'
+  | 'MESSAGES_SNAPSHOT'
+  | 'RUN_STARTED'
+  | 'RUN_FINISHED'
+  | 'RUN_ERROR'
+  | 'STEP_STARTED'
+  | 'STEP_FINISHED'
+  | 'CUSTOM';
+
+export const AGUI_EVENT_TYPES: AGUIEventType[] = [
+  'TEXT_MESSAGE_START', 'TEXT_MESSAGE_CONTENT', 'TEXT_MESSAGE_END',
+  'TOOL_CALL_START', 'TOOL_CALL_ARGS', 'TOOL_CALL_END',
+  'STATE_SNAPSHOT', 'STATE_DELTA', 'MESSAGES_SNAPSHOT',
+  'RUN_STARTED', 'RUN_FINISHED', 'RUN_ERROR',
+  'STEP_STARTED', 'STEP_FINISHED', 'CUSTOM',
+];
+
+export interface AGUIEvent {
+  type: AGUIEventType;
+  timestamp: string;
+  [key: string]: any;
+}
+
+export interface TextMessageStartEvent extends AGUIEvent {
+  type: 'TEXT_MESSAGE_START';
+  messageId: string;
+  role: 'assistant';
+}
+
+export interface TextMessageContentEvent extends AGUIEvent {
+  type: 'TEXT_MESSAGE_CONTENT';
+  messageId: string;
+  delta: string;
+}
+
+export interface TextMessageEndEvent extends AGUIEvent {
+  type: 'TEXT_MESSAGE_END';
+  messageId: string;
+}
+
+export interface ToolCallStartEvent extends AGUIEvent {
+  type: 'TOOL_CALL_START';
+  toolCallId: string;
+  toolCallName: string;
+}
+
+export interface ToolCallArgsEvent extends AGUIEvent {
+  type: 'TOOL_CALL_ARGS';
+  toolCallId: string;
+  delta: string;
+}
+
+export interface ToolCallEndEvent extends AGUIEvent {
+  type: 'TOOL_CALL_END';
+  toolCallId: string;
+}
+
+export interface StateSnapshotEvent extends AGUIEvent {
+  type: 'STATE_SNAPSHOT';
+  snapshot: Record<string, any>;
+}
+
+export interface StateDeltaEvent extends AGUIEvent {
+  type: 'STATE_DELTA';
+  delta: any[]; // JSON Patch (RFC 6902)
+}
+
+export interface MessagesSnapshotEvent extends AGUIEvent {
+  type: 'MESSAGES_SNAPSHOT';
+  messages: AGUIMessage[];
+}
+
+export interface RunStartedEvent extends AGUIEvent {
+  type: 'RUN_STARTED';
+  runId: string;
+  threadId?: string;
+}
+
+export interface RunFinishedEvent extends AGUIEvent {
+  type: 'RUN_FINISHED';
+  runId: string;
+}
+
+export interface RunErrorEvent extends AGUIEvent {
+  type: 'RUN_ERROR';
+  runId: string;
+  message: string;
+  code?: string;
+}
+
+export interface StepStartedEvent extends AGUIEvent {
+  type: 'STEP_STARTED';
+  stepId: string;
+  stepName?: string;
+}
+
+export interface StepFinishedEvent extends AGUIEvent {
+  type: 'STEP_FINISHED';
+  stepId: string;
+}
+
+export interface CustomEvent extends AGUIEvent {
+  type: 'CUSTOM';
+  name: string;
+  value: any;
+}
+
+// ─── Message & Request Types ─────────────────────────────────
+
+export interface AGUIMessage {
+  id: string;
+  role: 'user' | 'assistant' | 'system' | 'tool';
+  content: string;
+  name?: string;
+  toolCallId?: string;
+  toolCalls?: AGUIToolCall[];
+}
+
+export interface AGUIToolCall {
+  id: string;
+  type: 'function';
+  function: { name: string; arguments: string };
+}
+
+export interface AGUIRunRequest {
+  threadId?: string;
+  runId?: string;
+  messages: AGUIMessage[];
+  tools?: AGUIToolDefinition[];
+  context?: any[];
+  forwardedProps?: Record<string, any>;
+}
+
+export interface AGUIToolDefinition {
+  name: string;
+  description: string;
+  parameters: Record<string, any>; // JSON Schema
+}
+
+export function isValidEventType(type: string): type is AGUIEventType {
+  return AGUI_EVENT_TYPES.includes(type as AGUIEventType);
+}

package/src/protocols/index.ts

@@ -1,2 +1,2 @@
-// Protocols barrel export
-export * from './agui';
+// Protocols barrel export
+export * from './agui';

package/src/protocols/mcp/agent-tools.ts

@@ -1,134 +1,134 @@
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-import type { MCPServerToolDefinition, MCPResourceDefinition } from './types';
-
-/**
- * Convert an OPC agent into MCP tool definitions.
- * Works with any agent-like object that has name/handleMessage/brain.
- */
-export function agentToMCPTools(agent: any): MCPServerToolDefinition[] {
-  const tools: MCPServerToolDefinition[] = [];
-  const agentName = agent?.name || agent?.config?.name || 'agent';
-
-  // 1. Chat tool
-  tools.push({
-    name: 'chat',
-    description: `Chat with ${agentName} agent`,
-    inputSchema: {
-      type: 'object',
-      properties: { message: { type: 'string', description: 'Message to send to the agent' } },
-      required: ['message'],
-    },
-    handler: async (args: any) => {
-      if (typeof agent.handleMessage === 'function') {
-        const result = await agent.handleMessage({
-          role: 'user', content: args.message, channel: 'mcp',
-        });
-        return typeof result === 'string' ? result : result?.content || JSON.stringify(result);
-      }
-      return `Agent ${agentName} does not support handleMessage`;
-    },
-  });
-
-  // 2. Memory search
-  tools.push({
-    name: 'memory_search',
-    description: 'Search agent memory/knowledge',
-    inputSchema: {
-      type: 'object',
-      properties: { query: { type: 'string', description: 'Search query' } },
-      required: ['query'],
-    },
-    handler: async (args: any) => {
-      const brain = agent.brain || agent.memory || agent.memoryStore;
-      if (brain && typeof brain.query === 'function') {
-        return await brain.query(args.query);
-      }
-      if (brain && typeof brain.search === 'function') {
-        return await brain.search(args.query);
-      }
-      return 'Memory search not available';
-    },
-  });
-
-  // 3. Memory store
-  tools.push({
-    name: 'memory_store',
-    description: 'Store knowledge in agent memory',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        slug: { type: 'string', description: 'Identifier/key for the memory entry' },
-        content: { type: 'string', description: 'Content to store' },
-      },
-      required: ['slug', 'content'],
-    },
-    handler: async (args: any) => {
-      const brain = agent.brain || agent.memory || agent.memoryStore;
-      if (brain && typeof brain.put === 'function') {
-        await brain.put(args.slug, args.content);
-        return `Stored: ${args.slug}`;
-      }
-      if (brain && typeof brain.store === 'function') {
-        await brain.store(args.slug, args.content);
-        return `Stored: ${args.slug}`;
-      }
-      return 'Memory store not available';
-    },
-  });
-
-  // 4. Expose agent skills as individual tools
-  const skills = agent.skills || agent.skillRegistry?.list?.() || [];
-  for (const skill of Array.isArray(skills) ? skills : []) {
-    const skillName = skill.name || skill.id;
-    if (!skillName) continue;
-    tools.push({
-      name: `skill_${skillName}`,
-      description: skill.description || `Execute ${skillName} skill`,
-      inputSchema: skill.inputSchema || {
-        type: 'object',
-        properties: { input: { type: 'string' } },
-        required: ['input'],
-      },
-      handler: async (args: any) => {
-        if (typeof skill.execute === 'function') {
-          return await skill.execute(args);
-        }
-        return `Skill ${skillName} not executable`;
-      },
-    });
-  }
-
-  return tools;
-}
-
-/**
- * Expose agent files and brain pages as MCP resources.
- */
-export function agentToMCPResources(agent: any, agentDir: string): MCPResourceDefinition[] {
-  const resources: MCPResourceDefinition[] = [];
-
-  // Standard agent files
-  const standardFiles = [
-    { name: 'SOUL.md', desc: 'Agent personality and identity' },
-    { name: 'CONTEXT.md', desc: 'Agent context' },
-    { name: 'AGENTS.md', desc: 'Agent instructions' },
-    { name: 'USER.md', desc: 'User profile' },
-    { name: 'agent.yaml', desc: 'Agent OAD configuration' },
-  ];
-
-  for (const file of standardFiles) {
-    const filePath = join(agentDir, file.name);
-    if (existsSync(filePath)) {
-      resources.push({
-        uri: `agent:///${file.name}`,
-        name: file.name,
-        description: file.desc,
-        mimeType: file.name.endsWith('.yaml') ? 'text/yaml' : 'text/markdown',
-        handler: async () => readFileSync(filePath, 'utf-8'),
-      });
-    }
-  }
-
-  return resources;
-}
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import type { MCPServerToolDefinition, MCPResourceDefinition } from './types';
+
+/**
+ * Convert an OPC agent into MCP tool definitions.
+ * Works with any agent-like object that has name/handleMessage/brain.
+ */
+export function agentToMCPTools(agent: any): MCPServerToolDefinition[] {
+  const tools: MCPServerToolDefinition[] = [];
+  const agentName = agent?.name || agent?.config?.name || 'agent';
+
+  // 1. Chat tool
+  tools.push({
+    name: 'chat',
+    description: `Chat with ${agentName} agent`,
+    inputSchema: {
+      type: 'object',
+      properties: { message: { type: 'string', description: 'Message to send to the agent' } },
+      required: ['message'],
+    },
+    handler: async (args: any) => {
+      if (typeof agent.handleMessage === 'function') {
+        const result = await agent.handleMessage({
+          role: 'user', content: args.message, channel: 'mcp',
+        });
+        return typeof result === 'string' ? result : result?.content || JSON.stringify(result);
+      }
+      return `Agent ${agentName} does not support handleMessage`;
+    },
+  });
+
+  // 2. Memory search
+  tools.push({
+    name: 'memory_search',
+    description: 'Search agent memory/knowledge',
+    inputSchema: {
+      type: 'object',
+      properties: { query: { type: 'string', description: 'Search query' } },
+      required: ['query'],
+    },
+    handler: async (args: any) => {
+      const brain = agent.brain || agent.memory || agent.memoryStore;
+      if (brain && typeof brain.query === 'function') {
+        return await brain.query(args.query);
+      }
+      if (brain && typeof brain.search === 'function') {
+        return await brain.search(args.query);
+      }
+      return 'Memory search not available';
+    },
+  });
+
+  // 3. Memory store
+  tools.push({
+    name: 'memory_store',
+    description: 'Store knowledge in agent memory',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        slug: { type: 'string', description: 'Identifier/key for the memory entry' },
+        content: { type: 'string', description: 'Content to store' },
+      },
+      required: ['slug', 'content'],
+    },
+    handler: async (args: any) => {
+      const brain = agent.brain || agent.memory || agent.memoryStore;
+      if (brain && typeof brain.put === 'function') {
+        await brain.put(args.slug, args.content);
+        return `Stored: ${args.slug}`;
+      }
+      if (brain && typeof brain.store === 'function') {
+        await brain.store(args.slug, args.content);
+        return `Stored: ${args.slug}`;
+      }
+      return 'Memory store not available';
+    },
+  });
+
+  // 4. Expose agent skills as individual tools
+  const skills = agent.skills || agent.skillRegistry?.list?.() || [];
+  for (const skill of Array.isArray(skills) ? skills : []) {
+    const skillName = skill.name || skill.id;
+    if (!skillName) continue;
+    tools.push({
+      name: `skill_${skillName}`,
+      description: skill.description || `Execute ${skillName} skill`,
+      inputSchema: skill.inputSchema || {
+        type: 'object',
+        properties: { input: { type: 'string' } },
+        required: ['input'],
+      },
+      handler: async (args: any) => {
+        if (typeof skill.execute === 'function') {
+          return await skill.execute(args);
+        }
+        return `Skill ${skillName} not executable`;
+      },
+    });
+  }
+
+  return tools;
+}
+
+/**
+ * Expose agent files and brain pages as MCP resources.
+ */
+export function agentToMCPResources(agent: any, agentDir: string): MCPResourceDefinition[] {
+  const resources: MCPResourceDefinition[] = [];
+
+  // Standard agent files
+  const standardFiles = [
+    { name: 'SOUL.md', desc: 'Agent personality and identity' },
+    { name: 'CONTEXT.md', desc: 'Agent context' },
+    { name: 'AGENTS.md', desc: 'Agent instructions' },
+    { name: 'USER.md', desc: 'User profile' },
+    { name: 'agent.yaml', desc: 'Agent OAD configuration' },
+  ];
+
+  for (const file of standardFiles) {
+    const filePath = join(agentDir, file.name);
+    if (existsSync(filePath)) {
+      resources.push({
+        uri: `agent:///${file.name}`,
+        name: file.name,
+        description: file.desc,
+        mimeType: file.name.endsWith('.yaml') ? 'text/yaml' : 'text/markdown',
+        handler: async () => readFileSync(filePath, 'utf-8'),
+      });
+    }
+  }
+
+  return resources;
+}

package/src/protocols/mcp/index.ts

@@ -1,8 +1,8 @@
-export type {
-  MCPServerConfig, MCPServerToolDefinition, MCPResourceDefinition,
-  MCPPromptDefinition, MCPPromptArgument, MCPPromptMessage,
-  JsonRpcRequest, JsonRpcResponse,
-} from './types';
-export { MCP_ERRORS } from './types';
-export { MCPServer } from './server';
-export { agentToMCPTools, agentToMCPResources } from './agent-tools';
+export type {
+  MCPServerConfig, MCPServerToolDefinition, MCPResourceDefinition,
+  MCPPromptDefinition, MCPPromptArgument, MCPPromptMessage,
+  JsonRpcRequest, JsonRpcResponse,
+} from './types';
+export { MCP_ERRORS } from './types';
+export { MCPServer } from './server';
+export { agentToMCPTools, agentToMCPResources } from './agent-tools';