opc-agent 1.3.2 → 1.4.0

package/src/core/types.ts

@@ -1,68 +1,68 @@
-import { EventEmitter } from 'events';
-
-// ─── Core Types ──────────────────────────────────────────────
-
-export type AgentState = 'init' | 'ready' | 'running' | 'stopped' | 'error';
-
-export interface Message {
-  id: string;
-  role: 'user' | 'assistant' | 'system';
-  content: string;
-  timestamp: number;
-  metadata?: Record<string, unknown>;
-}
-
-export interface AgentContext {
-  agentName: string;
-  sessionId: string;
-  messages: Message[];
-  memory: MemoryStore;
-  metadata: Record<string, unknown>;
-}
-
-export interface SkillResult {
-  handled: boolean;
-  response?: string;
-  confidence: number;
-  metadata?: Record<string, unknown>;
-}
-
-export interface ISkill {
-  name: string;
-  description: string;
-  execute(context: AgentContext, message: Message): Promise<SkillResult>;
-}
-
-export interface IChannel {
-  type: string;
-  start(): Promise<void>;
-  stop(): Promise<void>;
-  onMessage(handler: (message: Message) => Promise<Message>): void;
-}
-
-export interface MemoryStore {
-  get(key: string): Promise<unknown>;
-  set(key: string, value: unknown): Promise<void>;
-  getConversation(sessionId: string): Promise<Message[]>;
-  addMessage(sessionId: string, message: Message): Promise<void>;
-  clear(sessionId?: string): Promise<void>;
-}
-
-export interface AgentEvents {
-  'state:change': (from: AgentState, to: AgentState) => void;
-  'message:in': (message: Message) => void;
-  'message:out': (message: Message) => void;
-  'skill:execute': (skill: string, result: SkillResult) => void;
-  'error': (error: Error) => void;
-}
-
-export interface IAgent extends EventEmitter {
-  readonly name: string;
-  readonly state: AgentState;
-  init(): Promise<void>;
-  start(): Promise<void>;
-  stop(): Promise<void>;
-  handleMessage(message: Message): Promise<Message>;
-  registerSkill(skill: ISkill): void;
-  bindChannel(channel: IChannel): void;
-}
+import { EventEmitter } from 'events';
+
+// ─── Core Types ──────────────────────────────────────────────
+
+export type AgentState = 'init' | 'ready' | 'running' | 'stopped' | 'error';
+
+export interface Message {
+  id: string;
+  role: 'user' | 'assistant' | 'system';
+  content: string;
+  timestamp: number;
+  metadata?: Record<string, unknown>;
+}
+
+export interface AgentContext {
+  agentName: string;
+  sessionId: string;
+  messages: Message[];
+  memory: MemoryStore;
+  metadata: Record<string, unknown>;
+}
+
+export interface SkillResult {
+  handled: boolean;
+  response?: string;
+  confidence: number;
+  metadata?: Record<string, unknown>;
+}
+
+export interface ISkill {
+  name: string;
+  description: string;
+  execute(context: AgentContext, message: Message): Promise<SkillResult>;
+}
+
+export interface IChannel {
+  type: string;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  onMessage(handler: (message: Message) => Promise<Message>): void;
+}
+
+export interface MemoryStore {
+  get(key: string): Promise<unknown>;
+  set(key: string, value: unknown): Promise<void>;
+  getConversation(sessionId: string): Promise<Message[]>;
+  addMessage(sessionId: string, message: Message): Promise<void>;
+  clear(sessionId?: string): Promise<void>;
+}
+
+export interface AgentEvents {
+  'state:change': (from: AgentState, to: AgentState) => void;
+  'message:in': (message: Message) => void;
+  'message:out': (message: Message) => void;
+  'skill:execute': (skill: string, result: SkillResult) => void;
+  'error': (error: Error) => void;
+}
+
+export interface IAgent extends EventEmitter {
+  readonly name: string;
+  readonly state: AgentState;
+  init(): Promise<void>;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  handleMessage(message: Message): Promise<Message>;
+  registerSkill(skill: ISkill): void;
+  bindChannel(channel: IChannel): void;
+}

package/src/core/versioning.ts

@@ -1,106 +1,106 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { Logger } from './logger';
-
-// ── Versioning Types ────────────────────────────────────────
-
-export interface VersionEntry {
-  version: string;
-  timestamp: number;
-  description?: string;
-  oadSnapshot: string; // serialized OAD YAML
-}
-
-export interface Migration {
-  fromVersion: string;
-  toVersion: string;
-  migrate: (oad: Record<string, unknown>) => Record<string, unknown>;
-}
-
-// ── Version Manager ─────────────────────────────────────────
-
-export class VersionManager {
-  private versions: VersionEntry[] = [];
-  private migrations: Migration[] = [];
-  private storePath: string;
-  private logger = new Logger('versioning');
-
-  constructor(storePath?: string) {
-    this.storePath = storePath ?? '.opc-versions.json';
-    this.load();
-  }
-
-  private load(): void {
-    try {
-      if (fs.existsSync(this.storePath)) {
-        const data = JSON.parse(fs.readFileSync(this.storePath, 'utf-8'));
-        this.versions = data.versions ?? [];
-      }
-    } catch {
-      this.versions = [];
-    }
-  }
-
-  private save(): void {
-    fs.writeFileSync(this.storePath, JSON.stringify({ versions: this.versions }, null, 2));
-  }
-
-  snapshot(version: string, oadYaml: string, description?: string): void {
-    this.versions.push({
-      version,
-      timestamp: Date.now(),
-      description,
-      oadSnapshot: oadYaml,
-    });
-    this.save();
-    this.logger.info('Version snapshot saved', { version });
-  }
-
-  list(): VersionEntry[] {
-    return [...this.versions];
-  }
-
-  get(version: string): VersionEntry | undefined {
-    return this.versions.find(v => v.version === version);
-  }
-
-  getCurrent(): VersionEntry | undefined {
-    return this.versions[this.versions.length - 1];
-  }
-
-  rollback(version: string): string | null {
-    const entry = this.get(version);
-    if (!entry) {
-      this.logger.warn('Version not found', { version });
-      return null;
-    }
-    this.logger.info('Rolling back to version', { version });
-    return entry.oadSnapshot;
-  }
-
-  registerMigration(migration: Migration): void {
-    this.migrations.push(migration);
-  }
-
-  migrate(oad: Record<string, unknown>, fromVersion: string, toVersion: string): Record<string, unknown> {
-    let current = fromVersion;
-    let result = { ...oad };
-
-    while (current !== toVersion) {
-      const migration = this.migrations.find(m => m.fromVersion === current);
-      if (!migration) {
-        throw new Error(`No migration path from ${current} to ${toVersion}`);
-      }
-      result = migration.migrate(result);
-      current = migration.toVersion;
-      this.logger.info('Migration applied', { from: migration.fromVersion, to: migration.toVersion });
-    }
-
-    return result;
-  }
-
-  clear(): void {
-    this.versions = [];
-    this.save();
-  }
-}
+import * as fs from 'fs';
+import * as path from 'path';
+import { Logger } from './logger';
+
+// ── Versioning Types ────────────────────────────────────────
+
+export interface VersionEntry {
+  version: string;
+  timestamp: number;
+  description?: string;
+  oadSnapshot: string; // serialized OAD YAML
+}
+
+export interface Migration {
+  fromVersion: string;
+  toVersion: string;
+  migrate: (oad: Record<string, unknown>) => Record<string, unknown>;
+}
+
+// ── Version Manager ─────────────────────────────────────────
+
+export class VersionManager {
+  private versions: VersionEntry[] = [];
+  private migrations: Migration[] = [];
+  private storePath: string;
+  private logger = new Logger('versioning');
+
+  constructor(storePath?: string) {
+    this.storePath = storePath ?? '.opc-versions.json';
+    this.load();
+  }
+
+  private load(): void {
+    try {
+      if (fs.existsSync(this.storePath)) {
+        const data = JSON.parse(fs.readFileSync(this.storePath, 'utf-8'));
+        this.versions = data.versions ?? [];
+      }
+    } catch {
+      this.versions = [];
+    }
+  }
+
+  private save(): void {
+    fs.writeFileSync(this.storePath, JSON.stringify({ versions: this.versions }, null, 2));
+  }
+
+  snapshot(version: string, oadYaml: string, description?: string): void {
+    this.versions.push({
+      version,
+      timestamp: Date.now(),
+      description,
+      oadSnapshot: oadYaml,
+    });
+    this.save();
+    this.logger.info('Version snapshot saved', { version });
+  }
+
+  list(): VersionEntry[] {
+    return [...this.versions];
+  }
+
+  get(version: string): VersionEntry | undefined {
+    return this.versions.find(v => v.version === version);
+  }
+
+  getCurrent(): VersionEntry | undefined {
+    return this.versions[this.versions.length - 1];
+  }
+
+  rollback(version: string): string | null {
+    const entry = this.get(version);
+    if (!entry) {
+      this.logger.warn('Version not found', { version });
+      return null;
+    }
+    this.logger.info('Rolling back to version', { version });
+    return entry.oadSnapshot;
+  }
+
+  registerMigration(migration: Migration): void {
+    this.migrations.push(migration);
+  }
+
+  migrate(oad: Record<string, unknown>, fromVersion: string, toVersion: string): Record<string, unknown> {
+    let current = fromVersion;
+    let result = { ...oad };
+
+    while (current !== toVersion) {
+      const migration = this.migrations.find(m => m.fromVersion === current);
+      if (!migration) {
+        throw new Error(`No migration path from ${current} to ${toVersion}`);
+      }
+      result = migration.migrate(result);
+      current = migration.toVersion;
+      this.logger.info('Migration applied', { from: migration.fromVersion, to: migration.toVersion });
+    }
+
+    return result;
+  }
+
+  clear(): void {
+    this.versions = [];
+    this.save();
+  }
+}