opc-agent 4.1.1 → 4.1.3

package/src/deploy/hermes.ts

@@ -1,156 +0,0 @@
-/**
- * Hermes Agent Adapter - Convert OAD → Hermes Agent config
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import type { OADDocument } from '../schema/oad';
-
-export interface HermesDeployOptions {
-  oad: OADDocument;
-  outputDir: string;
-}
-
-export interface HermesDeployResult {
-  outputDir: string;
-  files: string[];
-}
-
-interface HermesCharacter {
-  name: string;
-  description: string;
-  personality: string;
-  system: string;
-  bio: string[];
-  lore: string[];
-  messageExamples: Array<Array<{ user: string; content: { text: string } }>>;
-  postExamples: string[];
-  topics: string[];
-  adjectives: string[];
-  style: {
-    all: string[];
-    chat: string[];
-    post: string[];
-  };
-  plugins: string[];
-  settings: {
-    model: string;
-    voice: { model: string };
-    secrets: Record<string, string>;
-  };
-}
-
-function oadToHermesCharacter(oad: OADDocument): HermesCharacter {
-  const m = oad.metadata;
-  const s = oad.spec;
-  const prompt = s.systemPrompt ?? 'You are a helpful AI agent.';
-
-  // Extract personality traits from system prompt
-  const lines = prompt.split('\n').filter(l => l.trim());
-  const bio = lines.slice(0, 3).map(l => l.replace(/^[-*#]\s*/, '').trim());
-
-  return {
-    name: m.name,
-    description: m.description ?? `${m.name} - AI Agent`,
-    personality: prompt.slice(0, 500),
-    system: prompt,
-    bio: bio.length > 0 ? bio : [`${m.name} is an AI agent built with OPC Agent framework.`],
-    lore: [`Created with OPC Agent v${m.version}`, `Licensed under ${m.license}`],
-    messageExamples: [
-      [
-        { user: '{{user1}}', content: { text: 'Hello!' } },
-        { user: m.name, content: { text: 'Hi there! How can I help you today?' } },
-      ],
-    ],
-    postExamples: [],
-    topics: s.skills.map(sk => sk.name),
-    adjectives: ['helpful', 'knowledgeable', 'professional'],
-    style: {
-      all: ['Be helpful and professional', 'Use clear language'],
-      chat: ['Respond conversationally', 'Be concise but thorough'],
-      post: ['Share useful insights', 'Be informative'],
-    },
-    plugins: s.skills.map(sk => sk.name),
-    settings: {
-      model: s.model,
-      voice: { model: 'en_US-neutral' },
-      secrets: {},
-    },
-  };
-}
-
-function generateHermesSettings(oad: OADDocument): Record<string, any> {
-  return {
-    name: oad.metadata.name,
-    version: oad.metadata.version,
-    runtime: {
-      provider: oad.spec.provider?.default ?? 'openai',
-      model: oad.spec.model,
-      temperature: 0.7,
-      maxTokens: 2048,
-    },
-    channels: oad.spec.channels.map(ch => ({
-      type: ch.type,
-      enabled: true,
-      config: ch.config ?? {},
-    })),
-    memory: {
-      enabled: !!oad.spec.memory,
-      provider: typeof oad.spec.memory?.longTerm === 'object'
-        ? oad.spec.memory.longTerm.provider
-        : 'in-memory',
-    },
-  };
-}
-
-export function deployToHermes(options: HermesDeployOptions): HermesDeployResult {
-  const { oad, outputDir } = options;
-  const files: string[] = [];
-
-  fs.mkdirSync(outputDir, { recursive: true });
-
-  // character.json
-  const character = oadToHermesCharacter(oad);
-  const charPath = path.join(outputDir, 'character.json');
-  fs.writeFileSync(charPath, JSON.stringify(character, null, 2), 'utf-8');
-  files.push('character.json');
-
-  // settings.json
-  const settings = generateHermesSettings(oad);
-  const settingsPath = path.join(outputDir, 'settings.json');
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
-  files.push('settings.json');
-
-  // .env template
-  const envContent = `# Hermes Agent Environment
-HERMES_CHARACTER=${oad.metadata.name}
-HERMES_MODEL=${oad.spec.model}
-HERMES_PROVIDER=${oad.spec.provider?.default ?? 'openai'}
-# Add your API keys below:
-# OPENAI_API_KEY=
-# DEEPSEEK_API_KEY=
-`;
-  fs.writeFileSync(path.join(outputDir, '.env.hermes'), envContent, 'utf-8');
-  files.push('.env.hermes');
-
-  // README
-  const readme = `# ${oad.metadata.name} - Hermes Agent
-
-Converted from OAD format using \`opc deploy --target hermes\`.
-
-## Usage
-
-1. Copy \`character.json\` to your Hermes agents directory
-2. Configure \`.env.hermes\` with your API keys
-3. Start Hermes with this character
-
-## Files
-
-- \`character.json\` - Agent character definition
-- \`settings.json\` - Runtime settings
-- \`.env.hermes\` - Environment template
-`;
-  fs.writeFileSync(path.join(outputDir, 'README.md'), readme, 'utf-8');
-  files.push('README.md');
-
-  return { outputDir, files };
-}

package/src/deploy/index.ts

@@ -1,255 +0,0 @@
-/**
- * AgentDeployer - Deploy agents to Docker, Railway, Fly.io
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { execSync } from 'child_process';
-
-export interface DeployOptions {
-  port?: number;
-  env?: Record<string, string>;
-  platform?: 'docker' | 'railway' | 'fly' | 'render';
-  replicas?: number;
-}
-
-export interface DeployResult {
-  platform: string;
-  success: boolean;
-  url?: string;
-  message: string;
-  files?: string[];
-}
-
-export class AgentDeployer {
-  /**
-   * Generate Dockerfile for the agent
-   */
-  async generateDockerfile(agentDir: string, options?: DeployOptions): Promise<string> {
-    const port = options?.port || 3000;
-    const pkgPath = path.join(agentDir, 'package.json');
-    let startCmd = 'node src/index.js';
-    
-    if (fs.existsSync(pkgPath)) {
-      try {
-        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-        if (pkg.scripts?.start) {
-          startCmd = pkg.scripts.start;
-        }
-        if (pkg.main) {
-          startCmd = `node ${pkg.main}`;
-        }
-      } catch {}
-    }
-
-    return `FROM node:22-slim
-WORKDIR /app
-
-# Install dependencies
-COPY package*.json ./
-RUN npm ci --production
-
-# Copy source
-COPY . .
-
-# Build if needed
-RUN if [ -f "tsconfig.json" ]; then npx tsc || true; fi
-
-EXPOSE ${port}
-
-ENV NODE_ENV=production
-ENV PORT=${port}
-
-CMD ["${startCmd.split(' ')[0]}", ${startCmd.split(' ').slice(1).map(s => `"${s}"`).join(', ')}]
-`;
-  }
-
-  /**
-   * Generate docker-compose.yml
-   */
-  async generateCompose(agentDir: string, options?: DeployOptions): Promise<string> {
-    const port = options?.port || 3000;
-    const replicas = options?.replicas || 1;
-    const agentName = path.basename(agentDir).toLowerCase().replace(/[^a-z0-9-]/g, '-') || 'opc-agent';
-    
-    const envLines = options?.env 
-      ? Object.entries(options.env).map(([k, v]) => `      - ${k}=${v}`).join('\n')
-      : '';
-
-    return `version: "3.8"
-
-services:
-  ${agentName}:
-    build: .
-    ports:
-      - "${port}:${port}"
-    environment:
-      - NODE_ENV=production
-      - PORT=${port}
-${envLines ? envLines + '\n' : ''}    restart: unless-stopped
-${replicas > 1 ? `    deploy:\n      replicas: ${replicas}` : ''}
-    volumes:
-      - agent-data:/app/data
-
-volumes:
-  agent-data:
-`;
-  }
-
-  /**
-   * Deploy to Railway (via CLI)
-   */
-  async deployRailway(agentDir: string): Promise<DeployResult> {
-    try {
-      execSync('railway version', { stdio: 'pipe' });
-    } catch {
-      return { platform: 'railway', success: false, message: 'Railway CLI not installed. Run: npm i -g @railway/cli' };
-    }
-
-    try {
-      // Ensure Dockerfile exists
-      const dockerfilePath = path.join(agentDir, 'Dockerfile');
-      if (!fs.existsSync(dockerfilePath)) {
-        const content = await this.generateDockerfile(agentDir);
-        fs.writeFileSync(dockerfilePath, content);
-      }
-
-      const output = execSync('railway up --detach', { cwd: agentDir, encoding: 'utf-8' });
-      const urlMatch = output.match(/(https:\/\/[^\s]+)/);
-      return { 
-        platform: 'railway', 
-        success: true, 
-        url: urlMatch?.[1],
-        message: 'Deployed to Railway successfully' 
-      };
-    } catch (e: any) {
-      return { platform: 'railway', success: false, message: e.message };
-    }
-  }
-
-  /**
-   * Deploy to Fly.io
-   */
-  async deployFly(agentDir: string): Promise<DeployResult> {
-    try {
-      execSync('fly version', { stdio: 'pipe' });
-    } catch {
-      return { platform: 'fly', success: false, message: 'Fly CLI not installed. Run: curl -L https://fly.io/install.sh | sh' };
-    }
-
-    try {
-      const agentName = path.basename(agentDir).toLowerCase().replace(/[^a-z0-9-]/g, '-');
-      
-      // Generate fly.toml if not exists
-      const flyTomlPath = path.join(agentDir, 'fly.toml');
-      if (!fs.existsSync(flyTomlPath)) {
-        fs.writeFileSync(flyTomlPath, `app = "${agentName}"
-primary_region = "sjc"
-
-[build]
-
-[http_service]
-  internal_port = 3000
-  force_https = true
-  auto_stop_machines = true
-  auto_start_machines = true
-
-[checks]
-  [checks.alive]
-    type = "tcp"
-    port = 3000
-`);
-      }
-
-      // Ensure Dockerfile exists
-      const dockerfilePath = path.join(agentDir, 'Dockerfile');
-      if (!fs.existsSync(dockerfilePath)) {
-        const content = await this.generateDockerfile(agentDir);
-        fs.writeFileSync(dockerfilePath, content);
-      }
-
-      const output = execSync('fly deploy', { cwd: agentDir, encoding: 'utf-8' });
-      return { 
-        platform: 'fly', 
-        success: true, 
-        url: `https://${agentName}.fly.dev`,
-        message: 'Deployed to Fly.io successfully' 
-      };
-    } catch (e: any) {
-      return { platform: 'fly', success: false, message: e.message };
-    }
-  }
-
-  /**
-   * Deploy locally via Docker
-   */
-  async deployLocal(agentDir: string, options?: DeployOptions): Promise<DeployResult> {
-    try {
-      execSync('docker version', { stdio: 'pipe' });
-    } catch {
-      return { platform: 'docker', success: false, message: 'Docker not installed or not running' };
-    }
-
-    const files: string[] = [];
-
-    // Generate Dockerfile
-    const dockerfilePath = path.join(agentDir, 'Dockerfile');
-    if (!fs.existsSync(dockerfilePath)) {
-      fs.writeFileSync(dockerfilePath, await this.generateDockerfile(agentDir, options));
-      files.push('Dockerfile');
-    }
-
-    // Generate docker-compose.yml
-    const composePath = path.join(agentDir, 'docker-compose.yml');
-    if (!fs.existsSync(composePath)) {
-      fs.writeFileSync(composePath, await this.generateCompose(agentDir, options));
-      files.push('docker-compose.yml');
-    }
-
-    try {
-      execSync('docker compose up -d --build', { cwd: agentDir, stdio: 'inherit' });
-      const port = options?.port || 3000;
-      return { 
-        platform: 'docker', 
-        success: true, 
-        url: `http://localhost:${port}`,
-        message: 'Running locally via Docker',
-        files 
-      };
-    } catch (e: any) {
-      return { platform: 'docker', success: false, message: e.message, files };
-    }
-  }
-
-  /**
-   * Generate deployment files without deploying
-   */
-  async generateFiles(agentDir: string, options?: DeployOptions): Promise<DeployResult> {
-    const files: string[] = [];
-    const port = options?.port || 3000;
-
-    const dockerfile = await this.generateDockerfile(agentDir, options);
-    fs.writeFileSync(path.join(agentDir, 'Dockerfile'), dockerfile);
-    files.push('Dockerfile');
-
-    const compose = await this.generateCompose(agentDir, options);
-    fs.writeFileSync(path.join(agentDir, 'docker-compose.yml'), compose);
-    files.push('docker-compose.yml');
-
-    // Generate .dockerignore
-    const dockerignore = `node_modules
-.git
-.env
-*.log
-dist
-`;
-    fs.writeFileSync(path.join(agentDir, '.dockerignore'), dockerignore);
-    files.push('.dockerignore');
-
-    return {
-      platform: 'docker',
-      success: true,
-      message: `Generated ${files.length} deployment files`,
-      files,
-    };
-  }
-}

package/src/deploy/openclaw.ts

@@ -1,190 +0,0 @@
-/**
- * OpenClaw Deployer - Convert OAD → OpenClaw agent workspace
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import type { OADDocument } from '../schema/oad';
-
-export interface DeployOptions {
-  oad: OADDocument;
-  outputDir: string;
-  install?: boolean; // also register in openclaw.json
-}
-
-export interface DeployResult {
-  outputDir: string;
-  files: string[];
-  installed: boolean;
-  configPath?: string;
-}
-
-function generateIdentityMd(oad: OADDocument): string {
-  const m = oad.metadata;
-  return `# IDENTITY.md
-
-- **Name:** ${m.name}
-- **Version:** ${m.version}
-- **Description:** ${m.description ?? 'An AI agent'}
-- **Author:** ${m.author ?? 'Unknown'}
-- **License:** ${m.license}
-`;
-}
-
-function generateSoulMd(oad: OADDocument): string {
-  const prompt = oad.spec.systemPrompt ?? 'You are a helpful AI assistant.';
-  return `# SOUL.md - ${oad.metadata.name}
-
-## System Prompt
-
-${prompt}
-
-## Model Configuration
-
-- **Model:** ${oad.spec.model}
-- **Provider:** ${oad.spec.provider?.default ?? 'deepseek'}
-`;
-}
-
-function generateAgentsMd(oad: OADDocument): string {
-  const skills = oad.spec.skills;
-  const memory = oad.spec.memory;
-  const dtv = oad.spec.dtv;
-
-  let md = `# AGENTS.md - ${oad.metadata.name}\n\n`;
-
-  // Skills
-  md += `## Skills\n\n`;
-  if (skills.length === 0) {
-    md += `No skills configured.\n\n`;
-  } else {
-    for (const sk of skills) {
-      md += `### ${sk.name}\n`;
-      if (sk.description) md += `${sk.description}\n`;
-      if (sk.config) md += `\nConfig:\n\`\`\`json\n${JSON.stringify(sk.config, null, 2)}\n\`\`\`\n`;
-      md += `\n`;
-    }
-  }
-
-  // Memory
-  md += `## Memory\n\n`;
-  if (memory) {
-    md += `- Short-term: ${memory.shortTerm ? 'enabled' : 'disabled'}\n`;
-    const lt = memory.longTerm;
-    if (typeof lt === 'object' && lt) {
-      md += `- Long-term: ${lt.provider} (collection: ${lt.collection ?? 'default'})\n`;
-    } else {
-      md += `- Long-term: ${lt ? 'enabled' : 'disabled'}\n`;
-    }
-  } else {
-    md += `Default memory settings.\n`;
-  }
-  md += `\n`;
-
-  return md;
-}
-
-function generateUserMd(oad: OADDocument): string {
-  return `# USER.md
-
-- **Name:** (your name)
-- **Role:** User
-- **Notes:** Configure this file with your preferences for ${oad.metadata.name}.
-`;
-}
-
-function generateMemoryMd(oad: OADDocument): string {
-  return `# MEMORY.md - ${oad.metadata.name}
-
-## Persistent Knowledge
-
-(Agent will store learned information here)
-
-## User Preferences
-
-(Discovered user preferences will be noted here)
-`;
-}
-
-function generateOpenClawConfig(oad: OADDocument, agentDir: string): Record<string, any> {
-  const channels = oad.spec.channels;
-  const channelConfig: Record<string, any> = {};
-
-  for (const ch of channels) {
-    if (ch.type === 'telegram') {
-      channelConfig.telegram = {
-        enabled: true,
-        note: 'Configure bot token in OpenClaw gateway settings',
-      };
-    } else if (ch.type === 'web' || ch.type === 'websocket') {
-      channelConfig.web = { enabled: true, port: ch.port ?? 3000 };
-    }
-  }
-
-  return {
-    name: oad.metadata.name,
-    workspace: agentDir,
-    channels: channelConfig,
-  };
-}
-
-export function deployToOpenClaw(options: DeployOptions): DeployResult {
-  const { oad, outputDir, install } = options;
-  const files: string[] = [];
-
-  // Create output directory
-  fs.mkdirSync(outputDir, { recursive: true });
-
-  // Generate all workspace files
-  const fileMap: Record<string, string> = {
-    'IDENTITY.md': generateIdentityMd(oad),
-    'SOUL.md': generateSoulMd(oad),
-    'AGENTS.md': generateAgentsMd(oad),
-    'USER.md': generateUserMd(oad),
-    'MEMORY.md': generateMemoryMd(oad),
-  };
-
-  for (const [name, content] of Object.entries(fileMap)) {
-    const filePath = path.join(outputDir, name);
-    fs.writeFileSync(filePath, content, 'utf-8');
-    files.push(name);
-  }
-
-  // Generate suggested channel config
-  const channelSuggestion = generateOpenClawConfig(oad, outputDir);
-  const configNote = path.join(outputDir, 'openclaw-config-suggestion.json');
-  fs.writeFileSync(configNote, JSON.stringify(channelSuggestion, null, 2), 'utf-8');
-  files.push('openclaw-config-suggestion.json');
-
-  const result: DeployResult = { outputDir, files, installed: false };
-
-  // Install mode: register in openclaw.json
-  if (install) {
-    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
-    const configPath = path.join(homeDir, '.openclaw', 'openclaw.json');
-
-    if (fs.existsSync(configPath)) {
-      try {
-        const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-        if (!config.agents) config.agents = {};
-
-        const agentId = oad.metadata.name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
-        config.agents[agentId] = {
-          workspace: outputDir,
-          description: oad.metadata.description ?? '',
-        };
-
-        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
-        result.installed = true;
-        result.configPath = configPath;
-      } catch (err) {
-        // Config exists but couldn't be updated - not fatal
-        console.error(`Warning: Could not update ${configPath}:`, err);
-      }
-    } else {
-      console.error(`Warning: OpenClaw config not found at ${configPath}`);
-      console.error(`Run 'openclaw init' first, then re-run with --install`);
-    }
-  }
-
-  return result;
-}