opc-agent 4.1.0 → 4.1.2

package/src/protocols/a2a/types.ts

@@ -1,88 +1,88 @@
-// Google A2A Protocol Types — https://google.github.io/A2A/
-
-export interface A2AAgentCard {
-  name: string;
-  description: string;
-  url: string;
-  version: string;
-  capabilities: {
-    streaming: boolean;
-    pushNotifications: boolean;
-    stateTransitionHistory: boolean;
-  };
-  skills: A2AAgentSkill[];
-  defaultInputModes: string[];
-  defaultOutputModes: string[];
-  authentication?: {
-    schemes: string[];
-  };
-}
-
-export interface A2AAgentSkill {
-  id: string;
-  name: string;
-  description: string;
-  tags: string[];
-  examples?: string[];
-}
-
-export interface A2ATask {
-  id: string;
-  sessionId: string;
-  status: A2ATaskStatus;
-  history: A2AMessage[];
-  artifacts: A2AArtifact[];
-  metadata?: Record<string, any>;
-}
-
-export type A2ATaskState = 'submitted' | 'working' | 'input-required' | 'completed' | 'canceled' | 'failed';
-
-export interface A2ATaskStatus {
-  state: A2ATaskState;
-  message?: A2AMessage;
-  timestamp: string;
-}
-
-export interface A2AMessage {
-  role: 'user' | 'agent';
-  parts: A2AMessagePart[];
-}
-
-export type A2AMessagePart =
-  | { type: 'text'; text: string }
-  | { type: 'file'; file: { name: string; mimeType: string; bytes?: string; uri?: string } }
-  | { type: 'data'; data: Record<string, any> };
-
-export interface A2AArtifact {
-  name: string;
-  description?: string;
-  parts: A2AMessagePart[];
-  index: number;
-  append?: boolean;
-  lastChunk?: boolean;
-}
-
-export interface JsonRpcRequest {
-  jsonrpc: '2.0';
-  id: string | number;
-  method: string;
-  params?: any;
-}
-
-export interface JsonRpcResponse {
-  jsonrpc: '2.0';
-  id: string | number | null;
-  result?: any;
-  error?: { code: number; message: string; data?: any };
-}
-
-// Standard JSON-RPC error codes
-export const JSON_RPC_ERRORS = {
-  PARSE_ERROR: -32700,
-  INVALID_REQUEST: -32600,
-  METHOD_NOT_FOUND: -32601,
-  INVALID_PARAMS: -32602,
-  INTERNAL_ERROR: -32603,
-  TASK_NOT_FOUND: -32001,
-  TASK_CANCELED: -32002,
-} as const;
+// Google A2A Protocol Types — https://google.github.io/A2A/
+
+export interface A2AAgentCard {
+  name: string;
+  description: string;
+  url: string;
+  version: string;
+  capabilities: {
+    streaming: boolean;
+    pushNotifications: boolean;
+    stateTransitionHistory: boolean;
+  };
+  skills: A2AAgentSkill[];
+  defaultInputModes: string[];
+  defaultOutputModes: string[];
+  authentication?: {
+    schemes: string[];
+  };
+}
+
+export interface A2AAgentSkill {
+  id: string;
+  name: string;
+  description: string;
+  tags: string[];
+  examples?: string[];
+}
+
+export interface A2ATask {
+  id: string;
+  sessionId: string;
+  status: A2ATaskStatus;
+  history: A2AMessage[];
+  artifacts: A2AArtifact[];
+  metadata?: Record<string, any>;
+}
+
+export type A2ATaskState = 'submitted' | 'working' | 'input-required' | 'completed' | 'canceled' | 'failed';
+
+export interface A2ATaskStatus {
+  state: A2ATaskState;
+  message?: A2AMessage;
+  timestamp: string;
+}
+
+export interface A2AMessage {
+  role: 'user' | 'agent';
+  parts: A2AMessagePart[];
+}
+
+export type A2AMessagePart =
+  | { type: 'text'; text: string }
+  | { type: 'file'; file: { name: string; mimeType: string; bytes?: string; uri?: string } }
+  | { type: 'data'; data: Record<string, any> };
+
+export interface A2AArtifact {
+  name: string;
+  description?: string;
+  parts: A2AMessagePart[];
+  index: number;
+  append?: boolean;
+  lastChunk?: boolean;
+}
+
+export interface JsonRpcRequest {
+  jsonrpc: '2.0';
+  id: string | number;
+  method: string;
+  params?: any;
+}
+
+export interface JsonRpcResponse {
+  jsonrpc: '2.0';
+  id: string | number | null;
+  result?: any;
+  error?: { code: number; message: string; data?: any };
+}
+
+// Standard JSON-RPC error codes
+export const JSON_RPC_ERRORS = {
+  PARSE_ERROR: -32700,
+  INVALID_REQUEST: -32600,
+  METHOD_NOT_FOUND: -32601,
+  INVALID_PARAMS: -32602,
+  INTERNAL_ERROR: -32603,
+  TASK_NOT_FOUND: -32001,
+  TASK_CANCELED: -32002,
+} as const;

package/src/protocols/a2a/utils.ts

@@ -1,50 +1,50 @@
-import type { A2AAgentCard, A2AAgentSkill } from './types';
-
-/**
- * Convert an OAD (Open Agent Definition) document to an A2A AgentCard.
- */
-export function oadToAgentCard(oad: any, baseUrl: string): A2AAgentCard {
-  const meta = oad?.metadata || {};
-  const spec = oad?.spec || {};
-
-  // Extract skills from OAD
-  const skills: A2AAgentSkill[] = (spec.skills || []).map((s: any, i: number) => ({
-    id: s.id || s.name || `skill-${i}`,
-    name: s.name || `Skill ${i}`,
-    description: s.description || '',
-    tags: s.tags || [],
-    examples: s.examples || [],
-  }));
-
-  // If no skills defined, create one from the agent description
-  if (skills.length === 0 && (spec.systemPrompt || meta.description)) {
-    skills.push({
-      id: 'default',
-      name: meta.name || 'default',
-      description: meta.description || spec.systemPrompt?.slice(0, 200) || 'General agent capability',
-      tags: ['general'],
-    });
-  }
-
-  // Detect capabilities from OAD
-  const channels = spec.channels || [];
-  const hasStreaming = channels.some((c: any) => c.type === 'websocket' || c.type === 'web');
-
-  const url = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
-
-  return {
-    name: meta.name || 'opc-agent',
-    description: meta.description || '',
-    url,
-    version: meta.version || '1.0.0',
-    capabilities: {
-      streaming: hasStreaming,
-      pushNotifications: false,
-      stateTransitionHistory: true,
-    },
-    skills,
-    defaultInputModes: ['text'],
-    defaultOutputModes: ['text'],
-    authentication: spec.auth ? { schemes: [spec.auth.type || 'bearer'] } : undefined,
-  };
-}
+import type { A2AAgentCard, A2AAgentSkill } from './types';
+
+/**
+ * Convert an OAD (Open Agent Definition) document to an A2A AgentCard.
+ */
+export function oadToAgentCard(oad: any, baseUrl: string): A2AAgentCard {
+  const meta = oad?.metadata || {};
+  const spec = oad?.spec || {};
+
+  // Extract skills from OAD
+  const skills: A2AAgentSkill[] = (spec.skills || []).map((s: any, i: number) => ({
+    id: s.id || s.name || `skill-${i}`,
+    name: s.name || `Skill ${i}`,
+    description: s.description || '',
+    tags: s.tags || [],
+    examples: s.examples || [],
+  }));
+
+  // If no skills defined, create one from the agent description
+  if (skills.length === 0 && (spec.systemPrompt || meta.description)) {
+    skills.push({
+      id: 'default',
+      name: meta.name || 'default',
+      description: meta.description || spec.systemPrompt?.slice(0, 200) || 'General agent capability',
+      tags: ['general'],
+    });
+  }
+
+  // Detect capabilities from OAD
+  const channels = spec.channels || [];
+  const hasStreaming = channels.some((c: any) => c.type === 'websocket' || c.type === 'web');
+
+  const url = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+
+  return {
+    name: meta.name || 'opc-agent',
+    description: meta.description || '',
+    url,
+    version: meta.version || '1.0.0',
+    capabilities: {
+      streaming: hasStreaming,
+      pushNotifications: false,
+      stateTransitionHistory: true,
+    },
+    skills,
+    defaultInputModes: ['text'],
+    defaultOutputModes: ['text'],
+    authentication: spec.auth ? { schemes: [spec.auth.type || 'bearer'] } : undefined,
+  };
+}

package/src/protocols/agui/client.ts

@@ -1,83 +1,83 @@
-// AG-UI Client — Connects to AG-UI SSE endpoint
-import type { AGUIEvent, AGUIRunRequest, AGUIMessage } from './types';
-import { isValidEventType } from './types';
-
-export class AGUIClient {
-  private endpoint: string;
-  private controller?: AbortController;
-
-  constructor(endpoint: string) {
-    this.endpoint = endpoint;
-  }
-
-  async run(request: AGUIRunRequest, onEvent: (event: AGUIEvent) => void): Promise<void> {
-    this.controller = new AbortController();
-
-    const res = await fetch(this.endpoint, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(request),
-      signal: this.controller.signal,
-    });
-
-    if (!res.ok) {
-      throw new Error(`AG-UI request failed: ${res.status} ${res.statusText}`);
-    }
-
-    if (!res.body) {
-      throw new Error('No response body');
-    }
-
-    const reader = res.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = '';
-
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split('\n');
-        buffer = lines.pop() || '';
-
-        for (const line of lines) {
-          if (line.startsWith('data: ')) {
-            try {
-              const event: AGUIEvent = JSON.parse(line.slice(6));
-              if (event.type && isValidEventType(event.type)) {
-                onEvent(event);
-              }
-            } catch {
-              // skip malformed events
-            }
-          }
-        }
-      }
-    } finally {
-      reader.releaseLock();
-    }
-  }
-
-  async sendText(text: string, onChunk: (text: string) => void): Promise<string> {
-    let fullText = '';
-    const request: AGUIRunRequest = {
-      messages: [{ id: `msg_${Date.now()}`, role: 'user', content: text }],
-    };
-
-    await this.run(request, (event) => {
-      if (event.type === 'TEXT_MESSAGE_CONTENT') {
-        const delta = (event as any).delta as string;
-        fullText += delta;
-        onChunk(delta);
-      }
-    });
-
-    return fullText;
-  }
-
-  abort(): void {
-    this.controller?.abort();
-    this.controller = undefined;
-  }
-}
+// AG-UI Client — Connects to AG-UI SSE endpoint
+import type { AGUIEvent, AGUIRunRequest, AGUIMessage } from './types';
+import { isValidEventType } from './types';
+
+export class AGUIClient {
+  private endpoint: string;
+  private controller?: AbortController;
+
+  constructor(endpoint: string) {
+    this.endpoint = endpoint;
+  }
+
+  async run(request: AGUIRunRequest, onEvent: (event: AGUIEvent) => void): Promise<void> {
+    this.controller = new AbortController();
+
+    const res = await fetch(this.endpoint, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(request),
+      signal: this.controller.signal,
+    });
+
+    if (!res.ok) {
+      throw new Error(`AG-UI request failed: ${res.status} ${res.statusText}`);
+    }
+
+    if (!res.body) {
+      throw new Error('No response body');
+    }
+
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+
+        for (const line of lines) {
+          if (line.startsWith('data: ')) {
+            try {
+              const event: AGUIEvent = JSON.parse(line.slice(6));
+              if (event.type && isValidEventType(event.type)) {
+                onEvent(event);
+              }
+            } catch {
+              // skip malformed events
+            }
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+
+  async sendText(text: string, onChunk: (text: string) => void): Promise<string> {
+    let fullText = '';
+    const request: AGUIRunRequest = {
+      messages: [{ id: `msg_${Date.now()}`, role: 'user', content: text }],
+    };
+
+    await this.run(request, (event) => {
+      if (event.type === 'TEXT_MESSAGE_CONTENT') {
+        const delta = (event as any).delta as string;
+        fullText += delta;
+        onChunk(delta);
+      }
+    });
+
+    return fullText;
+  }
+
+  abort(): void {
+    this.controller?.abort();
+    this.controller = undefined;
+  }
+}

package/src/protocols/agui/index.ts

@@ -1,4 +1,4 @@
-// AG-UI Protocol — barrel export
-export * from './types';
-export { AGUIServer, AGUIEventEmitter } from './server';
-export { AGUIClient } from './client';
+// AG-UI Protocol — barrel export
+export * from './types';
+export { AGUIServer, AGUIEventEmitter } from './server';
+export { AGUIClient } from './client';