opc-agent 1.1.0 → 1.1.2

package/src/providers/index.ts

@@ -1,183 +1,183 @@
-import type { Message } from '../core/types';
-import * as https from 'https';
-import * as http from 'http';
-
-export interface LLMProvider {
-  name: string;
-  chat(messages: Message[], systemPrompt?: string): Promise<string>;
-  chatStream(messages: Message[], systemPrompt?: string): AsyncIterable<string>;
-}
-
-interface OpenAIMessage {
-  role: 'system' | 'user' | 'assistant';
-  content: string;
-}
-
-function getApiKey(): string {
-  return process.env.OPC_LLM_API_KEY || process.env.OPENAI_API_KEY || '';
-}
-
-function getBaseUrl(): string {
-  return process.env.OPC_LLM_BASE_URL || 'https://api.openai.com/v1';
-}
-
-class OpenAICompatibleProvider implements LLMProvider {
-  name: string;
-  private model: string;
-  private baseUrl: string;
-  private apiKey: string;
-
-  constructor(name: string, model: string, baseUrl?: string, apiKey?: string) {
-    this.name = name;
-    this.model = model;
-    this.baseUrl = baseUrl || getBaseUrl();
-    this.apiKey = apiKey || getApiKey();
-  }
-
-  private formatMessages(messages: Message[], systemPrompt?: string): OpenAIMessage[] {
-    const formatted: OpenAIMessage[] = [];
-    if (systemPrompt) {
-      formatted.push({ role: 'system', content: systemPrompt });
-    }
-    for (const m of messages) {
-      formatted.push({ role: m.role as 'user' | 'assistant', content: m.content });
-    }
-    return formatted;
-  }
-
-  private async request(body: any): Promise<any> {
-    if (!this.apiKey) {
-      throw new Error('No API key configured. Set OPC_LLM_API_KEY or OPENAI_API_KEY environment variable.');
-    }
-
-    const url = new URL(`${this.baseUrl}/chat/completions`);
-    const isHttps = url.protocol === 'https:';
-    const lib = isHttps ? https : http;
-
-    const postData = JSON.stringify(body);
-
-    return new Promise((resolve, reject) => {
-      const req = lib.request(
-        {
-          hostname: url.hostname,
-          port: url.port || (isHttps ? 443 : 80),
-          path: url.pathname,
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json',
-            Authorization: `Bearer ${this.apiKey}`,
-            'Content-Length': Buffer.byteLength(postData),
-          },
-        },
-        (res) => {
-          let data = '';
-          res.on('data', (chunk: Buffer) => (data += chunk.toString()));
-          res.on('end', () => {
-            if (res.statusCode && res.statusCode >= 400) {
-              reject(new Error(`LLM API error ${res.statusCode}: ${data}`));
-              return;
-            }
-            try {
-              resolve(JSON.parse(data));
-            } catch {
-              reject(new Error(`Invalid JSON response: ${data.slice(0, 200)}`));
-            }
-          });
-        },
-      );
-      req.on('error', reject);
-      req.write(postData);
-      req.end();
-    });
-  }
-
-  async chat(messages: Message[], systemPrompt?: string): Promise<string> {
-    if (!this.apiKey) {
-      // Stub mode when no API key
-      const last = messages[messages.length - 1];
-      return `[${this.name}/${this.model} - no API key] Echo: ${last?.content ?? ''}`;
-    }
-    const formatted = this.formatMessages(messages, systemPrompt);
-    const result = await this.request({
-      model: this.model,
-      messages: formatted,
-      temperature: 0.7,
-      max_tokens: 2048,
-    });
-    return result.choices?.[0]?.message?.content ?? '';
-  }
-
-  async *chatStream(messages: Message[], systemPrompt?: string): AsyncIterable<string> {
-    if (!this.apiKey) {
-      const last = messages[messages.length - 1];
-      yield `[${this.name}/${this.model} - no API key] Echo: ${last?.content ?? ''}`;
-      return;
-    }
-
-    const formatted = this.formatMessages(messages, systemPrompt);
-    const url = new URL(`${this.baseUrl}/chat/completions`);
-    const isHttps = url.protocol === 'https:';
-    const lib = isHttps ? https : http;
-    const postData = JSON.stringify({
-      model: this.model,
-      messages: formatted,
-      temperature: 0.7,
-      max_tokens: 2048,
-      stream: true,
-    });
-
-    const response = await new Promise<http.IncomingMessage>((resolve, reject) => {
-      const req = lib.request(
-        {
-          hostname: url.hostname,
-          port: url.port || (isHttps ? 443 : 80),
-          path: url.pathname,
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json',
-            Authorization: `Bearer ${this.apiKey}`,
-            'Content-Length': Buffer.byteLength(postData),
-          },
-        },
-        resolve,
-      );
-      req.on('error', reject);
-      req.write(postData);
-      req.end();
-    });
-
-    if (response.statusCode && response.statusCode >= 400) {
-      let data = '';
-      for await (const chunk of response) data += chunk.toString();
-      throw new Error(`LLM API error ${response.statusCode}: ${data}`);
-    }
-
-    let buffer = '';
-    for await (const chunk of response) {
-      buffer += chunk.toString();
-      const lines = buffer.split('\n');
-      buffer = lines.pop() ?? '';
-
-      for (const line of lines) {
-        const trimmed = line.trim();
-        if (!trimmed || !trimmed.startsWith('data: ')) continue;
-        const data = trimmed.slice(6);
-        if (data === '[DONE]') return;
-        try {
-          const parsed = JSON.parse(data);
-          const content = parsed.choices?.[0]?.delta?.content;
-          if (content) yield content;
-        } catch {
-          // skip malformed lines
-        }
-      }
-    }
-  }
-}
-
-export function createProvider(name: string = 'openai', model?: string, baseUrl?: string, apiKey?: string): LLMProvider {
-  const finalModel = model || process.env.OPC_LLM_MODEL || 'gpt-4o-mini';
-  return new OpenAICompatibleProvider(name, finalModel, baseUrl, apiKey);
-}
-
-export const SUPPORTED_PROVIDERS = ['openai', 'deepseek', 'qwen'] as const;
+import type { Message } from '../core/types';
+import * as https from 'https';
+import * as http from 'http';
+
+export interface LLMProvider {
+  name: string;
+  chat(messages: Message[], systemPrompt?: string): Promise<string>;
+  chatStream(messages: Message[], systemPrompt?: string): AsyncIterable<string>;
+}
+
+interface OpenAIMessage {
+  role: 'system' | 'user' | 'assistant';
+  content: string;
+}
+
+function getApiKey(): string {
+  return process.env.OPC_LLM_API_KEY || process.env.OPENAI_API_KEY || '';
+}
+
+function getBaseUrl(): string {
+  return process.env.OPC_LLM_BASE_URL || 'https://api.openai.com/v1';
+}
+
+class OpenAICompatibleProvider implements LLMProvider {
+  name: string;
+  private model: string;
+  private baseUrl: string;
+  private apiKey: string;
+
+  constructor(name: string, model: string, baseUrl?: string, apiKey?: string) {
+    this.name = name;
+    this.model = model;
+    this.baseUrl = baseUrl || getBaseUrl();
+    this.apiKey = apiKey || getApiKey();
+  }
+
+  private formatMessages(messages: Message[], systemPrompt?: string): OpenAIMessage[] {
+    const formatted: OpenAIMessage[] = [];
+    if (systemPrompt) {
+      formatted.push({ role: 'system', content: systemPrompt });
+    }
+    for (const m of messages) {
+      formatted.push({ role: m.role as 'user' | 'assistant', content: m.content });
+    }
+    return formatted;
+  }
+
+  private async request(body: any): Promise<any> {
+    if (!this.apiKey) {
+      throw new Error('No API key configured. Set OPC_LLM_API_KEY or OPENAI_API_KEY environment variable.');
+    }
+
+    const url = new URL(`${this.baseUrl}/chat/completions`);
+    const isHttps = url.protocol === 'https:';
+    const lib = isHttps ? https : http;
+
+    const postData = JSON.stringify(body);
+
+    return new Promise((resolve, reject) => {
+      const req = lib.request(
+        {
+          hostname: url.hostname,
+          port: url.port || (isHttps ? 443 : 80),
+          path: url.pathname,
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.apiKey}`,
+            'Content-Length': Buffer.byteLength(postData),
+          },
+        },
+        (res) => {
+          let data = '';
+          res.on('data', (chunk: Buffer) => (data += chunk.toString()));
+          res.on('end', () => {
+            if (res.statusCode && res.statusCode >= 400) {
+              reject(new Error(`LLM API error ${res.statusCode}: ${data}`));
+              return;
+            }
+            try {
+              resolve(JSON.parse(data));
+            } catch {
+              reject(new Error(`Invalid JSON response: ${data.slice(0, 200)}`));
+            }
+          });
+        },
+      );
+      req.on('error', reject);
+      req.write(postData);
+      req.end();
+    });
+  }
+
+  async chat(messages: Message[], systemPrompt?: string): Promise<string> {
+    if (!this.apiKey) {
+      // Stub mode when no API key
+      const last = messages[messages.length - 1];
+      return `[${this.name}/${this.model} - no API key] Echo: ${last?.content ?? ''}`;
+    }
+    const formatted = this.formatMessages(messages, systemPrompt);
+    const result = await this.request({
+      model: this.model,
+      messages: formatted,
+      temperature: 0.7,
+      max_tokens: 2048,
+    });
+    return result.choices?.[0]?.message?.content ?? '';
+  }
+
+  async *chatStream(messages: Message[], systemPrompt?: string): AsyncIterable<string> {
+    if (!this.apiKey) {
+      const last = messages[messages.length - 1];
+      yield `[${this.name}/${this.model} - no API key] Echo: ${last?.content ?? ''}`;
+      return;
+    }
+
+    const formatted = this.formatMessages(messages, systemPrompt);
+    const url = new URL(`${this.baseUrl}/chat/completions`);
+    const isHttps = url.protocol === 'https:';
+    const lib = isHttps ? https : http;
+    const postData = JSON.stringify({
+      model: this.model,
+      messages: formatted,
+      temperature: 0.7,
+      max_tokens: 2048,
+      stream: true,
+    });
+
+    const response = await new Promise<http.IncomingMessage>((resolve, reject) => {
+      const req = lib.request(
+        {
+          hostname: url.hostname,
+          port: url.port || (isHttps ? 443 : 80),
+          path: url.pathname,
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.apiKey}`,
+            'Content-Length': Buffer.byteLength(postData),
+          },
+        },
+        resolve,
+      );
+      req.on('error', reject);
+      req.write(postData);
+      req.end();
+    });
+
+    if (response.statusCode && response.statusCode >= 400) {
+      let data = '';
+      for await (const chunk of response) data += chunk.toString();
+      throw new Error(`LLM API error ${response.statusCode}: ${data}`);
+    }
+
+    let buffer = '';
+    for await (const chunk of response) {
+      buffer += chunk.toString();
+      const lines = buffer.split('\n');
+      buffer = lines.pop() ?? '';
+
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || !trimmed.startsWith('data: ')) continue;
+        const data = trimmed.slice(6);
+        if (data === '[DONE]') return;
+        try {
+          const parsed = JSON.parse(data);
+          const content = parsed.choices?.[0]?.delta?.content;
+          if (content) yield content;
+        } catch {
+          // skip malformed lines
+        }
+      }
+    }
+  }
+}
+
+export function createProvider(name: string = 'openai', model?: string, baseUrl?: string, apiKey?: string): LLMProvider {
+  const finalModel = model || process.env.OPC_LLM_MODEL || 'gpt-4o-mini';
+  return new OpenAICompatibleProvider(name, finalModel, baseUrl, apiKey);
+}
+
+export const SUPPORTED_PROVIDERS = ['openai', 'deepseek', 'qwen'] as const;

package/src/schema/oad.ts

@@ -1,155 +1,155 @@
-import { z } from 'zod';
-
-// ─── OAD Schema v1 ───────────────────────────────────────────
-
-export const SkillRefSchema = z.object({
-  name: z.string(),
-  description: z.string().optional(),
-  config: z.record(z.unknown()).optional(),
-});
-
-export const WorkflowStepSchema: z.ZodType<any> = z.lazy(() => z.object({
-  id: z.string(),
-  type: z.enum(['skill', 'tool', 'agent', 'condition', 'parallel']),
-  name: z.string(),
-  config: z.record(z.unknown()).optional(),
-  condition: z.string().optional(),
-  branches: z.object({ if: z.array(WorkflowStepSchema), else: z.array(WorkflowStepSchema).optional() }).optional(),
-  parallel: z.array(WorkflowStepSchema).optional(),
-  timeout: z.number().optional(),
-  retries: z.number().optional(),
-}));
-
-export const WorkflowSchema = z.object({
-  name: z.string(),
-  description: z.string().optional(),
-  version: z.string().optional(),
-  steps: z.array(WorkflowStepSchema).default([]),
-  onError: z.enum(['stop', 'skip', 'retry']).optional(),
-});
-
-export const VoiceSchema = z.object({
-  enabled: z.boolean().default(false),
-  sttProvider: z.string().optional(),
-  ttsProvider: z.string().optional(),
-  language: z.string().optional(),
-});
-
-export const WebhookSchema = z.object({
-  path: z.string().optional(),
-  secret: z.string().optional(),
-  retryAttempts: z.number().optional(),
-});
-
-export const HITLSchema = z.object({
-  enabled: z.boolean().default(false),
-  requireApproval: z.array(z.string()).default([]),
-  defaultTimeoutMs: z.number().default(60000),
-  defaultAction: z.enum(['approve', 'deny']).default('deny'),
-});
-
-export const PluginRefSchema = z.object({
-  name: z.string(),
-  config: z.record(z.unknown()).optional(),
-});
-
-export const AuthSchema = z.object({
-  enabled: z.boolean().default(false),
-  apiKeys: z.array(z.string()).default([]),
-  sessionIsolation: z.boolean().default(true),
-});
-
-export const ChannelSchema = z.object({
-  type: z.enum(['web', 'websocket', 'telegram', 'cli', 'voice', 'webhook']),
-  port: z.number().optional(),
-  config: z.record(z.unknown()).optional(),
-});
-
-export const LongTermMemorySchema = z.object({
-  provider: z.enum(['in-memory', 'deepbrain']).default('in-memory'),
-  collection: z.string().optional(),
-  config: z.record(z.unknown()).optional(),
-});
-
-export const MemorySchema = z.object({
-  shortTerm: z.boolean().default(true),
-  longTerm: z.union([z.boolean(), LongTermMemorySchema]).default(false),
-  provider: z.string().optional(),
-});
-
-export const TrustLevel = z.enum(['sandbox', 'verified', 'certified', 'listed']);
-
-export const DTVSchema = z.object({
-  trust: z.object({
-    level: TrustLevel.default('sandbox'),
-  }).optional(),
-  value: z.object({
-    metrics: z.array(z.string()).default([]),
-  }).optional(),
-});
-
-export const ProviderSchema = z.object({
-  default: z.string().default('deepseek'),
-  allowed: z.array(z.string()).default(['openai', 'deepseek', 'qwen']),
-});
-
-export const MarketplaceSchema = z.object({
-  certified: z.boolean().default(false),
-  category: z.string().optional(),
-  pricing: z.enum(['free', 'freemium', 'paid', 'enterprise']).optional(),
-  tags: z.array(z.string()).optional(),
-});
-
-export const MetadataSchema = z.object({
-  name: z.string(),
-  version: z.string().default('1.0.0'),
-  description: z.string().optional(),
-  author: z.string().optional(),
-  license: z.string().default('Apache-2.0'),
-  marketplace: MarketplaceSchema.optional(),
-});
-
-export const RoomSchema = z.object({
-  name: z.string(),
-  agents: z.array(z.string()).default([]),
-  topics: z.array(z.string()).default([]),
-});
-
-export const StreamingSchema = z.object({
-  enabled: z.boolean().default(false),
-  chunkSize: z.number().optional(),
-});
-
-export const SpecSchema = z.object({
-  provider: ProviderSchema.optional(),
-  model: z.string().default('deepseek-chat'),
-  systemPrompt: z.string().optional(),
-  skills: z.array(SkillRefSchema).default([]),
-  channels: z.array(ChannelSchema).default([]),
-  memory: MemorySchema.optional(),
-  dtv: DTVSchema.optional(),
-  room: RoomSchema.optional(),
-  streaming: z.union([z.boolean(), StreamingSchema]).default(false),
-  locale: z.enum(['en', 'zh-CN']).optional(),
-  workflows: z.array(WorkflowSchema).optional(),
-  voice: VoiceSchema.optional(),
-  webhook: WebhookSchema.optional(),
-  hitl: HITLSchema.optional(),
-  auth: AuthSchema.optional(),
-  plugins: z.array(PluginRefSchema).optional(),
-});
-
-export const OADSchema = z.object({
-  apiVersion: z.literal('opc/v1'),
-  kind: z.literal('Agent'),
-  metadata: MetadataSchema,
-  spec: SpecSchema,
-});
-
-export type OADDocument = z.infer<typeof OADSchema>;
-export type SkillRef = z.infer<typeof SkillRefSchema>;
-export type Channel = z.infer<typeof ChannelSchema>;
-export type Metadata = z.infer<typeof MetadataSchema>;
-export type Spec = z.infer<typeof SpecSchema>;
-export type DTVConfig = z.infer<typeof DTVSchema>;
-export type TrustLevelType = z.infer<typeof TrustLevel>;
+import { z } from 'zod';
+
+// ─── OAD Schema v1 ───────────────────────────────────────────
+
+export const SkillRefSchema = z.object({
+  name: z.string(),
+  description: z.string().optional(),
+  config: z.record(z.unknown()).optional(),
+});
+
+export const WorkflowStepSchema: z.ZodType<any> = z.lazy(() => z.object({
+  id: z.string(),
+  type: z.enum(['skill', 'tool', 'agent', 'condition', 'parallel']),
+  name: z.string(),
+  config: z.record(z.unknown()).optional(),
+  condition: z.string().optional(),
+  branches: z.object({ if: z.array(WorkflowStepSchema), else: z.array(WorkflowStepSchema).optional() }).optional(),
+  parallel: z.array(WorkflowStepSchema).optional(),
+  timeout: z.number().optional(),
+  retries: z.number().optional(),
+}));
+
+export const WorkflowSchema = z.object({
+  name: z.string(),
+  description: z.string().optional(),
+  version: z.string().optional(),
+  steps: z.array(WorkflowStepSchema).default([]),
+  onError: z.enum(['stop', 'skip', 'retry']).optional(),
+});
+
+export const VoiceSchema = z.object({
+  enabled: z.boolean().default(false),
+  sttProvider: z.string().optional(),
+  ttsProvider: z.string().optional(),
+  language: z.string().optional(),
+});
+
+export const WebhookSchema = z.object({
+  path: z.string().optional(),
+  secret: z.string().optional(),
+  retryAttempts: z.number().optional(),
+});
+
+export const HITLSchema = z.object({
+  enabled: z.boolean().default(false),
+  requireApproval: z.array(z.string()).default([]),
+  defaultTimeoutMs: z.number().default(60000),
+  defaultAction: z.enum(['approve', 'deny']).default('deny'),
+});
+
+export const PluginRefSchema = z.object({
+  name: z.string(),
+  config: z.record(z.unknown()).optional(),
+});
+
+export const AuthSchema = z.object({
+  enabled: z.boolean().default(false),
+  apiKeys: z.array(z.string()).default([]),
+  sessionIsolation: z.boolean().default(true),
+});
+
+export const ChannelSchema = z.object({
+  type: z.enum(['web', 'websocket', 'telegram', 'cli', 'voice', 'webhook']),
+  port: z.number().optional(),
+  config: z.record(z.unknown()).optional(),
+});
+
+export const LongTermMemorySchema = z.object({
+  provider: z.enum(['in-memory', 'deepbrain']).default('in-memory'),
+  collection: z.string().optional(),
+  config: z.record(z.unknown()).optional(),
+});
+
+export const MemorySchema = z.object({
+  shortTerm: z.boolean().default(true),
+  longTerm: z.union([z.boolean(), LongTermMemorySchema]).default(false),
+  provider: z.string().optional(),
+});
+
+export const TrustLevel = z.enum(['sandbox', 'verified', 'certified', 'listed']);
+
+export const DTVSchema = z.object({
+  trust: z.object({
+    level: TrustLevel.default('sandbox'),
+  }).optional(),
+  value: z.object({
+    metrics: z.array(z.string()).default([]),
+  }).optional(),
+});
+
+export const ProviderSchema = z.object({
+  default: z.string().default('deepseek'),
+  allowed: z.array(z.string()).default(['openai', 'deepseek', 'qwen']),
+});
+
+export const MarketplaceSchema = z.object({
+  certified: z.boolean().default(false),
+  category: z.string().optional(),
+  pricing: z.enum(['free', 'freemium', 'paid', 'enterprise']).optional(),
+  tags: z.array(z.string()).optional(),
+});
+
+export const MetadataSchema = z.object({
+  name: z.string(),
+  version: z.string().default('1.0.0'),
+  description: z.string().optional(),
+  author: z.string().optional(),
+  license: z.string().default('Apache-2.0'),
+  marketplace: MarketplaceSchema.optional(),
+});
+
+export const RoomSchema = z.object({
+  name: z.string(),
+  agents: z.array(z.string()).default([]),
+  topics: z.array(z.string()).default([]),
+});
+
+export const StreamingSchema = z.object({
+  enabled: z.boolean().default(false),
+  chunkSize: z.number().optional(),
+});
+
+export const SpecSchema = z.object({
+  provider: ProviderSchema.optional(),
+  model: z.string().default('deepseek-chat'),
+  systemPrompt: z.string().optional(),
+  skills: z.array(SkillRefSchema).default([]),
+  channels: z.array(ChannelSchema).default([]),
+  memory: MemorySchema.optional(),
+  dtv: DTVSchema.optional(),
+  room: RoomSchema.optional(),
+  streaming: z.union([z.boolean(), StreamingSchema]).default(false),
+  locale: z.enum(['en', 'zh-CN']).optional(),
+  workflows: z.array(WorkflowSchema).optional(),
+  voice: VoiceSchema.optional(),
+  webhook: WebhookSchema.optional(),
+  hitl: HITLSchema.optional(),
+  auth: AuthSchema.optional(),
+  plugins: z.array(PluginRefSchema).optional(),
+});
+
+export const OADSchema = z.object({
+  apiVersion: z.literal('opc/v1'),
+  kind: z.literal('Agent'),
+  metadata: MetadataSchema,
+  spec: SpecSchema,
+});
+
+export type OADDocument = z.infer<typeof OADSchema>;
+export type SkillRef = z.infer<typeof SkillRefSchema>;
+export type Channel = z.infer<typeof ChannelSchema>;
+export type Metadata = z.infer<typeof MetadataSchema>;
+export type Spec = z.infer<typeof SpecSchema>;
+export type DTVConfig = z.infer<typeof DTVSchema>;
+export type TrustLevelType = z.infer<typeof TrustLevel>;