opc-agent 1.4.0 → 1.4.1

package/src/deploy/openclaw.ts

@@ -1,190 +1,200 @@
-/**
- * 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;
-}
+/**
+ * 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`;
+
+  // DTV
+  if (dtv) {
+    md += `## Trust & Value\n\n`;
+    md += `- Trust Level: ${dtv.trust?.level ?? 'sandbox'}\n`;
+    if (dtv.value?.metrics?.length) {
+      md += `- Metrics: ${dtv.value.metrics.join(', ')}\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;
+}

package/src/dtv/data.ts

@@ -0,0 +1,29 @@
+export interface DataSource {
+  readonly name: string;
+  readonly type: string;
+  read(key: string): Promise<unknown>;
+}
+
+/**
+ * MRGConfig reader — read-only data layer for agents.
+ * Agents can read business data but cannot modify source systems.
+ */
+export class MRGConfigReader implements DataSource {
+  readonly name = 'mrg-config';
+  readonly type = 'config';
+  private data: Map<string, unknown>;
+
+  constructor(initial?: Record<string, unknown>) {
+    this.data = new Map(Object.entries(initial ?? {}));
+  }
+
+  async read(key: string): Promise<unknown> {
+    return this.data.get(key);
+  }
+
+  load(data: Record<string, unknown>): void {
+    for (const [k, v] of Object.entries(data)) {
+      this.data.set(k, v);
+    }
+  }
+}

package/src/dtv/trust.ts

@@ -0,0 +1,43 @@
+import type { TrustLevelType } from '../schema/oad';
+
+/**
+ * Trust levels: sandbox → verified → certified → listed
+ *
+ * - sandbox:   No network, no file system, limited capabilities
+ * - verified:  Identity verified, basic capabilities
+ * - certified: Passed security audit, full capabilities
+ * - listed:    Published in OPC marketplace
+ */
+export class TrustManager {
+  private level: TrustLevelType;
+
+  constructor(level: TrustLevelType = 'sandbox') {
+    this.level = level;
+  }
+
+  getLevel(): TrustLevelType {
+    return this.level;
+  }
+
+  canAccessNetwork(): boolean {
+    return this.level !== 'sandbox';
+  }
+
+  canAccessFileSystem(): boolean {
+    return this.level === 'certified' || this.level === 'listed';
+  }
+
+  canPublish(): boolean {
+    return this.level === 'listed';
+  }
+
+  upgrade(to: TrustLevelType): void {
+    const order: TrustLevelType[] = ['sandbox', 'verified', 'certified', 'listed'];
+    const currentIdx = order.indexOf(this.level);
+    const targetIdx = order.indexOf(to);
+    if (targetIdx <= currentIdx) {
+      throw new Error(`Cannot downgrade trust from ${this.level} to ${to}`);
+    }
+    this.level = to;
+  }
+}

package/src/dtv/value.ts

@@ -0,0 +1,47 @@
+/**
+ * Value tracking — metrics and ROI for agent operations.
+ */
+export interface ValueMetric {
+  name: string;
+  value: number;
+  unit: string;
+  timestamp: number;
+}
+
+export class ValueTracker {
+  private metrics: Map<string, ValueMetric[]> = new Map();
+  private trackedNames: Set<string>;
+
+  constructor(metricNames: string[] = []) {
+    this.trackedNames = new Set(metricNames);
+  }
+
+  record(name: string, value: number, unit: string = ''): void {
+    if (!this.metrics.has(name)) {
+      this.metrics.set(name, []);
+    }
+    this.metrics.get(name)!.push({ name, value, unit, timestamp: Date.now() });
+  }
+
+  getMetrics(name: string): ValueMetric[] {
+    return this.metrics.get(name) ?? [];
+  }
+
+  getAverage(name: string): number {
+    const m = this.getMetrics(name);
+    if (m.length === 0) return 0;
+    return m.reduce((sum, v) => sum + v.value, 0) / m.length;
+  }
+
+  getSummary(): Record<string, { count: number; average: number; last: number }> {
+    const result: Record<string, { count: number; average: number; last: number }> = {};
+    for (const [name, values] of this.metrics) {
+      result[name] = {
+        count: values.length,
+        average: this.getAverage(name),
+        last: values[values.length - 1]?.value ?? 0,
+      };
+    }
+    return result;
+  }
+}