opc-agent 1.3.2 → 2.0.0

package/src/core/workflow.ts

@@ -1,235 +1,235 @@
-import { EventEmitter } from 'events';
-import type { Message, AgentContext, ISkill, IAgent } from './types';
-import { Logger } from './logger';
-
-// ── Workflow Types ──────────────────────────────────────────
-
-export type StepType = 'skill' | 'tool' | 'agent' | 'condition' | 'parallel';
-
-export interface WorkflowStep {
-  id: string;
-  type: StepType;
-  name: string;
-  config?: Record<string, unknown>;
-  /** For condition steps */
-  condition?: string;
-  branches?: { if: WorkflowStep[]; else?: WorkflowStep[] };
-  /** For parallel steps */
-  parallel?: WorkflowStep[];
-  /** Timeout in ms */
-  timeout?: number;
-  /** Retry count */
-  retries?: number;
-}
-
-export interface WorkflowDefinition {
-  name: string;
-  description?: string;
-  version?: string;
-  steps: WorkflowStep[];
-  onError?: 'stop' | 'skip' | 'retry';
-}
-
-export interface StepResult {
-  stepId: string;
-  status: 'success' | 'skipped' | 'error';
-  output?: string;
-  error?: string;
-  durationMs: number;
-}
-
-export interface WorkflowResult {
-  workflow: string;
-  status: 'completed' | 'failed' | 'partial';
-  steps: StepResult[];
-  totalDurationMs: number;
-}
-
-// ── Workflow Engine ─────────────────────────────────────────
-
-export class WorkflowEngine extends EventEmitter {
-  private workflows: Map<string, WorkflowDefinition> = new Map();
-  private skills: Map<string, ISkill> = new Map();
-  private agents: Map<string, IAgent> = new Map();
-  private logger = new Logger('workflow');
-
-  registerWorkflow(workflow: WorkflowDefinition): void {
-    this.workflows.set(workflow.name, workflow);
-    this.logger.info('Workflow registered', { name: workflow.name, steps: workflow.steps.length });
-  }
-
-  unregisterWorkflow(name: string): void {
-    this.workflows.delete(name);
-  }
-
-  getWorkflow(name: string): WorkflowDefinition | undefined {
-    return this.workflows.get(name);
-  }
-
-  listWorkflows(): WorkflowDefinition[] {
-    return Array.from(this.workflows.values());
-  }
-
-  registerSkill(skill: ISkill): void {
-    this.skills.set(skill.name, skill);
-  }
-
-  registerAgent(agent: IAgent): void {
-    this.agents.set(agent.name, agent);
-  }
-
-  async run(name: string, context: AgentContext, input?: string): Promise<WorkflowResult> {
-    const workflow = this.workflows.get(name);
-    if (!workflow) throw new Error(`Workflow "${name}" not found`);
-
-    const startTime = Date.now();
-    const results: StepResult[] = [];
-    let failed = false;
-
-    this.emit('workflow:start', { name, input });
-
-    try {
-      await this.executeSteps(workflow.steps, context, input ?? '', results, workflow.onError ?? 'stop');
-    } catch (err) {
-      failed = true;
-      this.logger.error('Workflow failed', { name, error: (err as Error).message });
-    }
-
-    const result: WorkflowResult = {
-      workflow: name,
-      status: failed ? 'failed' : results.some(r => r.status === 'error') ? 'partial' : 'completed',
-      steps: results,
-      totalDurationMs: Date.now() - startTime,
-    };
-
-    this.emit('workflow:end', result);
-    return result;
-  }
-
-  private async executeSteps(
-    steps: WorkflowStep[],
-    context: AgentContext,
-    input: string,
-    results: StepResult[],
-    onError: string,
-  ): Promise<string> {
-    let currentInput = input;
-
-    for (const step of steps) {
-      const stepStart = Date.now();
-
-      try {
-        if (step.type === 'parallel' && step.parallel) {
-          const parallelResults = await Promise.all(
-            step.parallel.map(s => this.executeSingleStep(s, context, currentInput)),
-          );
-          const combined = parallelResults.map(r => r.output ?? '').join('\n');
-          for (const r of parallelResults) results.push(r);
-          currentInput = combined;
-        } else if (step.type === 'condition' && step.branches) {
-          const conditionMet = this.evaluateCondition(step.condition ?? '', currentInput, context);
-          const branch = conditionMet ? step.branches.if : (step.branches.else ?? []);
-          results.push({
-            stepId: step.id,
-            status: 'success',
-            output: `condition=${conditionMet}`,
-            durationMs: Date.now() - stepStart,
-          });
-          currentInput = await this.executeSteps(branch, context, currentInput, results, onError);
-        } else {
-          const result = await this.executeSingleStep(step, context, currentInput);
-          results.push(result);
-          if (result.status === 'success' && result.output) {
-            currentInput = result.output;
-          }
-          if (result.status === 'error' && onError === 'stop') {
-            throw new Error(`Step "${step.id}" failed: ${result.error}`);
-          }
-        }
-      } catch (err) {
-        if (onError === 'stop') throw err;
-        // skip: continue
-      }
-    }
-
-    return currentInput;
-  }
-
-  private async executeSingleStep(
-    step: WorkflowStep,
-    context: AgentContext,
-    input: string,
-  ): Promise<StepResult> {
-    const startTime = Date.now();
-    let retries = step.retries ?? 0;
-
-    while (true) {
-      try {
-        const output = await this.executeStepAction(step, context, input);
-        return {
-          stepId: step.id,
-          status: 'success',
-          output,
-          durationMs: Date.now() - startTime,
-        };
-      } catch (err) {
-        if (retries > 0) {
-          retries--;
-          continue;
-        }
-        return {
-          stepId: step.id,
-          status: 'error',
-          error: (err as Error).message,
-          durationMs: Date.now() - startTime,
-        };
-      }
-    }
-  }
-
-  private async executeStepAction(step: WorkflowStep, context: AgentContext, input: string): Promise<string> {
-    const message: Message = {
-      id: `wf_${step.id}_${Date.now()}`,
-      role: 'user',
-      content: input,
-      timestamp: Date.now(),
-      metadata: { workflowStep: step.id },
-    };
-
-    switch (step.type) {
-      case 'skill': {
-        const skill = this.skills.get(step.name);
-        if (!skill) throw new Error(`Skill "${step.name}" not found`);
-        const result = await skill.execute(context, message);
-        return result.response ?? '';
-      }
-      case 'agent': {
-        const agent = this.agents.get(step.name);
-        if (!agent) throw new Error(`Agent "${step.name}" not found`);
-        const response = await agent.handleMessage(message);
-        return response.content;
-      }
-      case 'tool': {
-        // Tools are executed via config callback
-        const toolFn = step.config?.handler as ((input: string) => Promise<string>) | undefined;
-        if (toolFn) return await toolFn(input);
-        return `[tool:${step.name}] executed`;
-      }
-      default:
-        return input;
-    }
-  }
-
-  private evaluateCondition(condition: string, input: string, _context: AgentContext): boolean {
-    // Simple condition evaluator: supports "contains:keyword", "length>N", "true", "false"
-    if (condition === 'true') return true;
-    if (condition === 'false') return false;
-    if (condition.startsWith('contains:')) {
-      return input.toLowerCase().includes(condition.slice(9).toLowerCase());
-    }
-    if (condition.startsWith('length>')) {
-      return input.length > parseInt(condition.slice(7), 10);
-    }
-    return !!condition;
-  }
-}
+import { EventEmitter } from 'events';
+import type { Message, AgentContext, ISkill, IAgent } from './types';
+import { Logger } from './logger';
+
+// ── Workflow Types ──────────────────────────────────────────
+
+export type StepType = 'skill' | 'tool' | 'agent' | 'condition' | 'parallel';
+
+export interface WorkflowStep {
+  id: string;
+  type: StepType;
+  name: string;
+  config?: Record<string, unknown>;
+  /** For condition steps */
+  condition?: string;
+  branches?: { if: WorkflowStep[]; else?: WorkflowStep[] };
+  /** For parallel steps */
+  parallel?: WorkflowStep[];
+  /** Timeout in ms */
+  timeout?: number;
+  /** Retry count */
+  retries?: number;
+}
+
+export interface WorkflowDefinition {
+  name: string;
+  description?: string;
+  version?: string;
+  steps: WorkflowStep[];
+  onError?: 'stop' | 'skip' | 'retry';
+}
+
+export interface StepResult {
+  stepId: string;
+  status: 'success' | 'skipped' | 'error';
+  output?: string;
+  error?: string;
+  durationMs: number;
+}
+
+export interface WorkflowResult {
+  workflow: string;
+  status: 'completed' | 'failed' | 'partial';
+  steps: StepResult[];
+  totalDurationMs: number;
+}
+
+// ── Workflow Engine ─────────────────────────────────────────
+
+export class WorkflowEngine extends EventEmitter {
+  private workflows: Map<string, WorkflowDefinition> = new Map();
+  private skills: Map<string, ISkill> = new Map();
+  private agents: Map<string, IAgent> = new Map();
+  private logger = new Logger('workflow');
+
+  registerWorkflow(workflow: WorkflowDefinition): void {
+    this.workflows.set(workflow.name, workflow);
+    this.logger.info('Workflow registered', { name: workflow.name, steps: workflow.steps.length });
+  }
+
+  unregisterWorkflow(name: string): void {
+    this.workflows.delete(name);
+  }
+
+  getWorkflow(name: string): WorkflowDefinition | undefined {
+    return this.workflows.get(name);
+  }
+
+  listWorkflows(): WorkflowDefinition[] {
+    return Array.from(this.workflows.values());
+  }
+
+  registerSkill(skill: ISkill): void {
+    this.skills.set(skill.name, skill);
+  }
+
+  registerAgent(agent: IAgent): void {
+    this.agents.set(agent.name, agent);
+  }
+
+  async run(name: string, context: AgentContext, input?: string): Promise<WorkflowResult> {
+    const workflow = this.workflows.get(name);
+    if (!workflow) throw new Error(`Workflow "${name}" not found`);
+
+    const startTime = Date.now();
+    const results: StepResult[] = [];
+    let failed = false;
+
+    this.emit('workflow:start', { name, input });
+
+    try {
+      await this.executeSteps(workflow.steps, context, input ?? '', results, workflow.onError ?? 'stop');
+    } catch (err) {
+      failed = true;
+      this.logger.error('Workflow failed', { name, error: (err as Error).message });
+    }
+
+    const result: WorkflowResult = {
+      workflow: name,
+      status: failed ? 'failed' : results.some(r => r.status === 'error') ? 'partial' : 'completed',
+      steps: results,
+      totalDurationMs: Date.now() - startTime,
+    };
+
+    this.emit('workflow:end', result);
+    return result;
+  }
+
+  private async executeSteps(
+    steps: WorkflowStep[],
+    context: AgentContext,
+    input: string,
+    results: StepResult[],
+    onError: string,
+  ): Promise<string> {
+    let currentInput = input;
+
+    for (const step of steps) {
+      const stepStart = Date.now();
+
+      try {
+        if (step.type === 'parallel' && step.parallel) {
+          const parallelResults = await Promise.all(
+            step.parallel.map(s => this.executeSingleStep(s, context, currentInput)),
+          );
+          const combined = parallelResults.map(r => r.output ?? '').join('\n');
+          for (const r of parallelResults) results.push(r);
+          currentInput = combined;
+        } else if (step.type === 'condition' && step.branches) {
+          const conditionMet = this.evaluateCondition(step.condition ?? '', currentInput, context);
+          const branch = conditionMet ? step.branches.if : (step.branches.else ?? []);
+          results.push({
+            stepId: step.id,
+            status: 'success',
+            output: `condition=${conditionMet}`,
+            durationMs: Date.now() - stepStart,
+          });
+          currentInput = await this.executeSteps(branch, context, currentInput, results, onError);
+        } else {
+          const result = await this.executeSingleStep(step, context, currentInput);
+          results.push(result);
+          if (result.status === 'success' && result.output) {
+            currentInput = result.output;
+          }
+          if (result.status === 'error' && onError === 'stop') {
+            throw new Error(`Step "${step.id}" failed: ${result.error}`);
+          }
+        }
+      } catch (err) {
+        if (onError === 'stop') throw err;
+        // skip: continue
+      }
+    }
+
+    return currentInput;
+  }
+
+  private async executeSingleStep(
+    step: WorkflowStep,
+    context: AgentContext,
+    input: string,
+  ): Promise<StepResult> {
+    const startTime = Date.now();
+    let retries = step.retries ?? 0;
+
+    while (true) {
+      try {
+        const output = await this.executeStepAction(step, context, input);
+        return {
+          stepId: step.id,
+          status: 'success',
+          output,
+          durationMs: Date.now() - startTime,
+        };
+      } catch (err) {
+        if (retries > 0) {
+          retries--;
+          continue;
+        }
+        return {
+          stepId: step.id,
+          status: 'error',
+          error: (err as Error).message,
+          durationMs: Date.now() - startTime,
+        };
+      }
+    }
+  }
+
+  private async executeStepAction(step: WorkflowStep, context: AgentContext, input: string): Promise<string> {
+    const message: Message = {
+      id: `wf_${step.id}_${Date.now()}`,
+      role: 'user',
+      content: input,
+      timestamp: Date.now(),
+      metadata: { workflowStep: step.id },
+    };
+
+    switch (step.type) {
+      case 'skill': {
+        const skill = this.skills.get(step.name);
+        if (!skill) throw new Error(`Skill "${step.name}" not found`);
+        const result = await skill.execute(context, message);
+        return result.response ?? '';
+      }
+      case 'agent': {
+        const agent = this.agents.get(step.name);
+        if (!agent) throw new Error(`Agent "${step.name}" not found`);
+        const response = await agent.handleMessage(message);
+        return response.content;
+      }
+      case 'tool': {
+        // Tools are executed via config callback
+        const toolFn = step.config?.handler as ((input: string) => Promise<string>) | undefined;
+        if (toolFn) return await toolFn(input);
+        return `[tool:${step.name}] executed`;
+      }
+      default:
+        return input;
+    }
+  }
+
+  private evaluateCondition(condition: string, input: string, _context: AgentContext): boolean {
+    // Simple condition evaluator: supports "contains:keyword", "length>N", "true", "false"
+    if (condition === 'true') return true;
+    if (condition === 'false') return false;
+    if (condition.startsWith('contains:')) {
+      return input.toLowerCase().includes(condition.slice(9).toLowerCase());
+    }
+    if (condition.startsWith('length>')) {
+      return input.length > parseInt(condition.slice(7), 10);
+    }
+    return !!condition;
+  }
+}

package/src/daemon.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/**
+ * Daemon entry point — spawned by `opc start` as a detached background process.
+ * Loads agent.yaml, creates runtime, starts all channels, writes heartbeat.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { AgentRuntime } from './core/runtime';
+
+const OPC_DIR = path.resolve('.opc');
+const HEARTBEAT_FILE = path.join(OPC_DIR, 'heartbeat');
+const LOG_FILE = path.join(OPC_DIR, 'agent.log');
+const PID_FILE = path.join(OPC_DIR, 'agent.pid');
+const HEARTBEAT_INTERVAL = 30_000;
+
+function ensureDir(dir: string) {
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+}
+
+function log(msg: string) {
+  const line = `[${new Date().toISOString()}] ${msg}\n`;
+  try { fs.appendFileSync(LOG_FILE, line); } catch { /* ignore */ }
+}
+
+async function main() {
+  ensureDir(OPC_DIR);
+
+  // Redirect stdout/stderr to log file
+  const logStream = fs.createWriteStream(LOG_FILE, { flags: 'a' });
+  process.stdout.write = logStream.write.bind(logStream) as any;
+  process.stderr.write = logStream.write.bind(logStream) as any;
+
+  // Write PID
+  fs.writeFileSync(PID_FILE, String(process.pid));
+  log(`Daemon started, PID=${process.pid}`);
+
+  // Write start time for uptime calculation
+  fs.writeFileSync(path.join(OPC_DIR, 'started'), String(Date.now()));
+
+  // Heartbeat
+  const heartbeatTimer = setInterval(() => {
+    try { fs.writeFileSync(HEARTBEAT_FILE, String(Date.now())); } catch { /* ignore */ }
+  }, HEARTBEAT_INTERVAL);
+  fs.writeFileSync(HEARTBEAT_FILE, String(Date.now()));
+
+  // Load .env
+  const envPath = path.resolve('.env');
+  if (fs.existsSync(envPath)) {
+    try {
+      const content = fs.readFileSync(envPath, 'utf-8');
+      for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1) continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        const value = trimmed.slice(eqIdx + 1).trim();
+        if (!process.env[key]) process.env[key] = value;
+      }
+    } catch { /* ignore */ }
+  }
+
+  // Determine config file
+  const configFile = fs.existsSync('agent.yaml') ? 'agent.yaml' : 'oad.yaml';
+
+  const runtime = new AgentRuntime();
+  await runtime.loadConfig(configFile);
+  await runtime.initialize();
+  await runtime.start();
+
+  log(`Agent running (config=${configFile})`);
+
+  // Graceful shutdown
+  const shutdown = async (signal: string) => {
+    log(`Received ${signal}, shutting down...`);
+    clearInterval(heartbeatTimer);
+    await runtime.stop();
+    try { fs.unlinkSync(PID_FILE); } catch { /* ignore */ }
+    log('Daemon stopped');
+    process.exit(0);
+  };
+
+  process.on('SIGTERM', () => shutdown('SIGTERM'));
+  process.on('SIGINT', () => shutdown('SIGINT'));
+
+  // On Windows, handle the message-based kill
+  process.on('message', (msg) => {
+    if (msg === 'shutdown') shutdown('message:shutdown');
+  });
+}
+
+main().catch((err) => {
+  log(`Fatal error: ${err instanceof Error ? err.message : String(err)}`);
+  try { fs.unlinkSync(PID_FILE); } catch { /* ignore */ }
+  process.exit(1);
+});