opc-agent 1.2.1 → 1.3.0

package/src/core/cache.ts

@@ -1,141 +1,141 @@
-/**
- * Caching Layer - Cache LLM responses with configurable TTL.
- * Hash-based key from input messages + system prompt.
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import * as crypto from 'crypto';
-
-export interface CacheEntry {
-  key: string;
-  value: string;
-  createdAt: number;
-  ttlMs: number;
-  hits: number;
-}
-
-export interface CacheConfig {
-  enabled: boolean;
-  ttlMs: number; // default TTL
-  maxEntries: number;
-  dataDir: string;
-}
-
-export class LLMCache {
-  private cache: Map<string, CacheEntry> = new Map();
-  private config: CacheConfig;
-  private filePath: string;
-  private stats = { hits: 0, misses: 0, evictions: 0 };
-
-  constructor(config?: Partial<CacheConfig>) {
-    this.config = {
-      enabled: config?.enabled ?? true,
-      ttlMs: config?.ttlMs ?? 3600_000, // 1 hour default
-      maxEntries: config?.maxEntries ?? 1000,
-      dataDir: config?.dataDir ?? '.',
-    };
-    this.filePath = path.join(this.config.dataDir, 'data', 'cache.json');
-    this.load();
-  }
-
-  private load(): void {
-    try {
-      if (fs.existsSync(this.filePath)) {
-        const raw = fs.readFileSync(this.filePath, 'utf-8');
-        const entries: CacheEntry[] = JSON.parse(raw);
-        for (const entry of entries) {
-          if (!this.isExpired(entry)) {
-            this.cache.set(entry.key, entry);
-          }
-        }
-      }
-    } catch {
-      // ignore
-    }
-  }
-
-  private save(): void {
-    const dir = path.dirname(this.filePath);
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-    const entries = Array.from(this.cache.values());
-    fs.writeFileSync(this.filePath, JSON.stringify(entries));
-  }
-
-  private isExpired(entry: CacheEntry): boolean {
-    return Date.now() - entry.createdAt > entry.ttlMs;
-  }
-
-  /**
-   * Generate a cache key from messages and system prompt.
-   */
-  static makeKey(messages: Array<{ role: string; content: string }>, systemPrompt?: string): string {
-    const payload = JSON.stringify({ systemPrompt, messages: messages.map(m => ({ role: m.role, content: m.content })) });
-    return crypto.createHash('sha256').update(payload).digest('hex').slice(0, 16);
-  }
-
-  /**
-   * Get a cached response. Returns null if not found or expired.
-   */
-  get(key: string): string | null {
-    if (!this.config.enabled) return null;
-    const entry = this.cache.get(key);
-    if (!entry || this.isExpired(entry)) {
-      if (entry) {
-        this.cache.delete(key);
-        this.stats.evictions++;
-      }
-      this.stats.misses++;
-      return null;
-    }
-    entry.hits++;
-    this.stats.hits++;
-    return entry.value;
-  }
-
-  /**
-   * Set a cached response.
-   */
-  set(key: string, value: string, ttlMs?: number): void {
-    if (!this.config.enabled) return;
-
-    // Evict oldest if at capacity
-    if (this.cache.size >= this.config.maxEntries) {
-      let oldestKey: string | null = null;
-      let oldestTime = Infinity;
-      for (const [k, v] of this.cache) {
-        if (v.createdAt < oldestTime) {
-          oldestTime = v.createdAt;
-          oldestKey = k;
-        }
-      }
-      if (oldestKey) {
-        this.cache.delete(oldestKey);
-        this.stats.evictions++;
-      }
-    }
-
-    this.cache.set(key, {
-      key,
-      value,
-      createdAt: Date.now(),
-      ttlMs: ttlMs ?? this.config.ttlMs,
-      hits: 0,
-    });
-    this.save();
-  }
-
-  getStats(): { hits: number; misses: number; evictions: number; size: number; hitRate: string } {
-    const total = this.stats.hits + this.stats.misses;
-    return {
-      ...this.stats,
-      size: this.cache.size,
-      hitRate: total > 0 ? `${((this.stats.hits / total) * 100).toFixed(1)}%` : '0%',
-    };
-  }
-
-  clear(): void {
-    this.cache.clear();
-    this.stats = { hits: 0, misses: 0, evictions: 0 };
-    this.save();
-  }
-}
+/**
+ * Caching Layer - Cache LLM responses with configurable TTL.
+ * Hash-based key from input messages + system prompt.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+
+export interface CacheEntry {
+  key: string;
+  value: string;
+  createdAt: number;
+  ttlMs: number;
+  hits: number;
+}
+
+export interface CacheConfig {
+  enabled: boolean;
+  ttlMs: number; // default TTL
+  maxEntries: number;
+  dataDir: string;
+}
+
+export class LLMCache {
+  private cache: Map<string, CacheEntry> = new Map();
+  private config: CacheConfig;
+  private filePath: string;
+  private stats = { hits: 0, misses: 0, evictions: 0 };
+
+  constructor(config?: Partial<CacheConfig>) {
+    this.config = {
+      enabled: config?.enabled ?? true,
+      ttlMs: config?.ttlMs ?? 3600_000, // 1 hour default
+      maxEntries: config?.maxEntries ?? 1000,
+      dataDir: config?.dataDir ?? '.',
+    };
+    this.filePath = path.join(this.config.dataDir, 'data', 'cache.json');
+    this.load();
+  }
+
+  private load(): void {
+    try {
+      if (fs.existsSync(this.filePath)) {
+        const raw = fs.readFileSync(this.filePath, 'utf-8');
+        const entries: CacheEntry[] = JSON.parse(raw);
+        for (const entry of entries) {
+          if (!this.isExpired(entry)) {
+            this.cache.set(entry.key, entry);
+          }
+        }
+      }
+    } catch {
+      // ignore
+    }
+  }
+
+  private save(): void {
+    const dir = path.dirname(this.filePath);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    const entries = Array.from(this.cache.values());
+    fs.writeFileSync(this.filePath, JSON.stringify(entries));
+  }
+
+  private isExpired(entry: CacheEntry): boolean {
+    return Date.now() - entry.createdAt > entry.ttlMs;
+  }
+
+  /**
+   * Generate a cache key from messages and system prompt.
+   */
+  static makeKey(messages: Array<{ role: string; content: string }>, systemPrompt?: string): string {
+    const payload = JSON.stringify({ systemPrompt, messages: messages.map(m => ({ role: m.role, content: m.content })) });
+    return crypto.createHash('sha256').update(payload).digest('hex').slice(0, 16);
+  }
+
+  /**
+   * Get a cached response. Returns null if not found or expired.
+   */
+  get(key: string): string | null {
+    if (!this.config.enabled) return null;
+    const entry = this.cache.get(key);
+    if (!entry || this.isExpired(entry)) {
+      if (entry) {
+        this.cache.delete(key);
+        this.stats.evictions++;
+      }
+      this.stats.misses++;
+      return null;
+    }
+    entry.hits++;
+    this.stats.hits++;
+    return entry.value;
+  }
+
+  /**
+   * Set a cached response.
+   */
+  set(key: string, value: string, ttlMs?: number): void {
+    if (!this.config.enabled) return;
+
+    // Evict oldest if at capacity
+    if (this.cache.size >= this.config.maxEntries) {
+      let oldestKey: string | null = null;
+      let oldestTime = Infinity;
+      for (const [k, v] of this.cache) {
+        if (v.createdAt < oldestTime) {
+          oldestTime = v.createdAt;
+          oldestKey = k;
+        }
+      }
+      if (oldestKey) {
+        this.cache.delete(oldestKey);
+        this.stats.evictions++;
+      }
+    }
+
+    this.cache.set(key, {
+      key,
+      value,
+      createdAt: Date.now(),
+      ttlMs: ttlMs ?? this.config.ttlMs,
+      hits: 0,
+    });
+    this.save();
+  }
+
+  getStats(): { hits: number; misses: number; evictions: number; size: number; hitRate: string } {
+    const total = this.stats.hits + this.stats.misses;
+    return {
+      ...this.stats,
+      size: this.cache.size,
+      hitRate: total > 0 ? `${((this.stats.hits / total) * 100).toFixed(1)}%` : '0%',
+    };
+  }
+
+  clear(): void {
+    this.cache.clear();
+    this.stats = { hits: 0, misses: 0, evictions: 0 };
+    this.save();
+  }
+}

package/src/core/compose.ts

@@ -1,77 +1,77 @@
-import type { AgentContext, Message } from './types';
-
-/**
- * Agent Composition — v0.8.0
- * Combine multiple agents into a pipeline: Agent A output → Agent B input.
- * Configurable in OAD: `compose: [agent-a, agent-b]`
- */
-
-export type AgentHandler = (context: AgentContext, message: Message) => Promise<Message>;
-
-export interface ComposableAgent {
-  id: string;
-  name: string;
-  handler: AgentHandler;
-}
-
-export interface ComposeOptions {
-  /** Stop pipeline if any agent returns empty content */
-  stopOnEmpty?: boolean;
-  /** Transform output between agents */
-  transform?: (output: Message, nextAgentId: string) => Message;
-  /** Timeout per agent in ms */
-  timeoutMs?: number;
-}
-
-export class AgentPipeline {
-  private agents: ComposableAgent[] = [];
-  private options: ComposeOptions;
-
-  constructor(agents: ComposableAgent[], options: ComposeOptions = {}) {
-    this.agents = agents;
-    this.options = options;
-  }
-
-  /** Run the pipeline sequentially: each agent's output becomes the next agent's input */
-  async execute(context: AgentContext, initialMessage: Message): Promise<Message> {
-    let currentMessage = initialMessage;
-
-    for (const agent of this.agents) {
-      if (this.options.stopOnEmpty && !currentMessage.content.trim()) {
-        break;
-      }
-
-      // Apply transform if provided
-      if (this.options.transform) {
-        currentMessage = this.options.transform(currentMessage, agent.id);
-      }
-
-      if (this.options.timeoutMs) {
-        const result = await Promise.race([
-          agent.handler(context, currentMessage),
-          new Promise<never>((_, reject) =>
-            setTimeout(() => reject(new Error(`Agent ${agent.id} timed out`)), this.options.timeoutMs)
-          ),
-        ]);
-        currentMessage = result;
-      } else {
-        currentMessage = await agent.handler(context, currentMessage);
-      }
-    }
-
-    return currentMessage;
-  }
-
-  /** Get the pipeline agent IDs in order */
-  getAgentIds(): string[] {
-    return this.agents.map((a) => a.id);
-  }
-}
-
-/**
- * Create a pipeline from an array of composable agents.
- * Usage in OAD: `compose: [agent-a, agent-b, agent-c]`
- */
-export function compose(agents: ComposableAgent[], options?: ComposeOptions): AgentPipeline {
-  return new AgentPipeline(agents, options);
-}
+import type { AgentContext, Message } from './types';
+
+/**
+ * Agent Composition — v0.8.0
+ * Combine multiple agents into a pipeline: Agent A output → Agent B input.
+ * Configurable in OAD: `compose: [agent-a, agent-b]`
+ */
+
+export type AgentHandler = (context: AgentContext, message: Message) => Promise<Message>;
+
+export interface ComposableAgent {
+  id: string;
+  name: string;
+  handler: AgentHandler;
+}
+
+export interface ComposeOptions {
+  /** Stop pipeline if any agent returns empty content */
+  stopOnEmpty?: boolean;
+  /** Transform output between agents */
+  transform?: (output: Message, nextAgentId: string) => Message;
+  /** Timeout per agent in ms */
+  timeoutMs?: number;
+}
+
+export class AgentPipeline {
+  private agents: ComposableAgent[] = [];
+  private options: ComposeOptions;
+
+  constructor(agents: ComposableAgent[], options: ComposeOptions = {}) {
+    this.agents = agents;
+    this.options = options;
+  }
+
+  /** Run the pipeline sequentially: each agent's output becomes the next agent's input */
+  async execute(context: AgentContext, initialMessage: Message): Promise<Message> {
+    let currentMessage = initialMessage;
+
+    for (const agent of this.agents) {
+      if (this.options.stopOnEmpty && !currentMessage.content.trim()) {
+        break;
+      }
+
+      // Apply transform if provided
+      if (this.options.transform) {
+        currentMessage = this.options.transform(currentMessage, agent.id);
+      }
+
+      if (this.options.timeoutMs) {
+        const result = await Promise.race([
+          agent.handler(context, currentMessage),
+          new Promise<never>((_, reject) =>
+            setTimeout(() => reject(new Error(`Agent ${agent.id} timed out`)), this.options.timeoutMs)
+          ),
+        ]);
+        currentMessage = result;
+      } else {
+        currentMessage = await agent.handler(context, currentMessage);
+      }
+    }
+
+    return currentMessage;
+  }
+
+  /** Get the pipeline agent IDs in order */
+  getAgentIds(): string[] {
+    return this.agents.map((a) => a.id);
+  }
+}
+
+/**
+ * Create a pipeline from an array of composable agents.
+ * Usage in OAD: `compose: [agent-a, agent-b, agent-c]`
+ */
+export function compose(agents: ComposableAgent[], options?: ComposeOptions): AgentPipeline {
+  return new AgentPipeline(agents, options);
+}

package/src/core/config.ts

@@ -1,14 +1,14 @@
-import * as fs from 'fs';
-import * as yaml from 'js-yaml';
-import { OADSchema, type OADDocument } from '../schema/oad';
-
-export function loadOAD(filePath: string): OADDocument {
-  const raw = fs.readFileSync(filePath, 'utf-8');
-  const ext = filePath.split('.').pop()?.toLowerCase();
-  const data = (ext === 'yaml' || ext === 'yml') ? yaml.load(raw) : JSON.parse(raw);
-  return OADSchema.parse(data);
-}
-
-export function validateOAD(data: unknown): OADDocument {
-  return OADSchema.parse(data);
-}
+import * as fs from 'fs';
+import * as yaml from 'js-yaml';
+import { OADSchema, type OADDocument } from '../schema/oad';
+
+export function loadOAD(filePath: string): OADDocument {
+  const raw = fs.readFileSync(filePath, 'utf-8');
+  const ext = filePath.split('.').pop()?.toLowerCase();
+  const data = (ext === 'yaml' || ext === 'yml') ? yaml.load(raw) : JSON.parse(raw);
+  return OADSchema.parse(data);
+}
+
+export function validateOAD(data: unknown): OADDocument {
+  return OADSchema.parse(data);
+}