opc-agent 1.3.0 → 1.3.2

package/examples/customer-service-demo/oad.yaml

@@ -1,107 +1,107 @@
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: ShopBot
-  version: "1.0.0"
-  description: "E-commerce customer service agent for TechStyle — handles product FAQs, order tracking, returns, and complaint escalation"
-  author: "TechStyle Inc."
-  license: Apache-2.0
-  marketplace:
-    category: customer-service
-    pricing: free
-    tags: [ecommerce, support, faq, orders]
-
-spec:
-  provider:
-    default: deepseek
-    allowed: [openai, deepseek, qwen]
-  model: deepseek-chat
-
-  systemPrompt: |
-    You are ShopBot, the friendly and professional customer service agent for TechStyle, 
-    an online electronics and lifestyle store.
-
-    ## Personality
-    - Warm, helpful, and patient
-    - Professional but not robotic — use a conversational tone
-    - Proactive: anticipate follow-up questions
-    - Empathetic: acknowledge customer frustration before solving problems
-
-    ## Core Capabilities
-    1. **Product FAQ**: Answer questions about products, specs, pricing, availability
-    2. **Order Tracking**: Look up order status by order ID (format: TS-XXXXXX)
-    3. **Returns & Refunds**: Guide customers through return process (30-day policy)
-    4. **Complaint Handling**: De-escalate issues, offer solutions, escalate when needed
-
-    ## Escalation Rules
-    - Escalate to human agent if:
-      - Customer asks 3+ times about the same unresolved issue
-      - Customer explicitly requests a human
-      - Issue involves billing disputes over $100
-      - Customer uses abusive language (remain calm, offer to transfer)
-    - Say: "Let me connect you with a specialist who can help further."
-
-    ## Response Guidelines
-    - Keep responses under 200 words unless detailed explanation is needed
-    - Always confirm understanding: "Just to make sure I understand..."
-    - End with a follow-up: "Is there anything else I can help with?"
-    - For order lookups, ask for order ID if not provided
-    - Never make up order status — if you can't find it, say so
-
-    ## Product Catalog (Quick Reference)
-    - TechStyle Pro Headphones — $149, wireless, ANC, 30hr battery
-    - TechStyle Slim Laptop Stand — $59, aluminum, adjustable
-    - TechStyle Power Bank 20K — $39, 20000mAh, USB-C PD
-    - TechStyle Smart Watch S3 — $199, health tracking, 5-day battery
-    - TechStyle Webcam 4K — $89, autofocus, built-in mic
-
-    ## Return Policy
-    - 30-day return window from delivery date
-    - Item must be in original packaging
-    - Free return shipping for defective items
-    - Refund processed within 5-7 business days
-    - Gift cards and sale items are final sale
-
-  skills:
-    - name: product-faq
-      description: "Answer product questions from the catalog knowledge base"
-      config:
-        source: catalog
-        fallback: "I don't have that info right now. Let me check with the team."
-
-    - name: order-lookup
-      description: "Look up order status by order ID"
-      config:
-        idPattern: "TS-\\d{6}"
-        notFoundMessage: "I couldn't find that order. Double-check the ID (format: TS-XXXXXX)."
-
-    - name: complaint-handler
-      description: "Handle complaints with empathy and escalation logic"
-      config:
-        maxAttempts: 3
-        escalationMessage: "Let me connect you with a specialist who can help further."
-
-  channels:
-    - type: telegram
-      config:
-        welcomeMessage: "Hi! 👋 I'm ShopBot from TechStyle. How can I help you today?"
-    - type: web
-      port: 3000
-
-  memory:
-    shortTerm: true
-    longTerm: false
-
-  dtv:
-    trust:
-      level: verified
-    value:
-      metrics:
-        - response_time
-        - resolution_rate
-        - customer_satisfaction
-
-  streaming:
-    enabled: true
-
-  locale: en
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: ShopBot
+  version: "1.0.0"
+  description: "E-commerce customer service agent for TechStyle — handles product FAQs, order tracking, returns, and complaint escalation"
+  author: "TechStyle Inc."
+  license: Apache-2.0
+  marketplace:
+    category: customer-service
+    pricing: free
+    tags: [ecommerce, support, faq, orders]
+
+spec:
+  provider:
+    default: deepseek
+    allowed: [openai, deepseek, qwen]
+  model: deepseek-chat
+
+  systemPrompt: |
+    You are ShopBot, the friendly and professional customer service agent for TechStyle, 
+    an online electronics and lifestyle store.
+
+    ## Personality
+    - Warm, helpful, and patient
+    - Professional but not robotic — use a conversational tone
+    - Proactive: anticipate follow-up questions
+    - Empathetic: acknowledge customer frustration before solving problems
+
+    ## Core Capabilities
+    1. **Product FAQ**: Answer questions about products, specs, pricing, availability
+    2. **Order Tracking**: Look up order status by order ID (format: TS-XXXXXX)
+    3. **Returns & Refunds**: Guide customers through return process (30-day policy)
+    4. **Complaint Handling**: De-escalate issues, offer solutions, escalate when needed
+
+    ## Escalation Rules
+    - Escalate to human agent if:
+      - Customer asks 3+ times about the same unresolved issue
+      - Customer explicitly requests a human
+      - Issue involves billing disputes over $100
+      - Customer uses abusive language (remain calm, offer to transfer)
+    - Say: "Let me connect you with a specialist who can help further."
+
+    ## Response Guidelines
+    - Keep responses under 200 words unless detailed explanation is needed
+    - Always confirm understanding: "Just to make sure I understand..."
+    - End with a follow-up: "Is there anything else I can help with?"
+    - For order lookups, ask for order ID if not provided
+    - Never make up order status — if you can't find it, say so
+
+    ## Product Catalog (Quick Reference)
+    - TechStyle Pro Headphones — $149, wireless, ANC, 30hr battery
+    - TechStyle Slim Laptop Stand — $59, aluminum, adjustable
+    - TechStyle Power Bank 20K — $39, 20000mAh, USB-C PD
+    - TechStyle Smart Watch S3 — $199, health tracking, 5-day battery
+    - TechStyle Webcam 4K — $89, autofocus, built-in mic
+
+    ## Return Policy
+    - 30-day return window from delivery date
+    - Item must be in original packaging
+    - Free return shipping for defective items
+    - Refund processed within 5-7 business days
+    - Gift cards and sale items are final sale
+
+  skills:
+    - name: product-faq
+      description: "Answer product questions from the catalog knowledge base"
+      config:
+        source: catalog
+        fallback: "I don't have that info right now. Let me check with the team."
+
+    - name: order-lookup
+      description: "Look up order status by order ID"
+      config:
+        idPattern: "TS-\\d{6}"
+        notFoundMessage: "I couldn't find that order. Double-check the ID (format: TS-XXXXXX)."
+
+    - name: complaint-handler
+      description: "Handle complaints with empathy and escalation logic"
+      config:
+        maxAttempts: 3
+        escalationMessage: "Let me connect you with a specialist who can help further."
+
+  channels:
+    - type: telegram
+      config:
+        welcomeMessage: "Hi! 👋 I'm ShopBot from TechStyle. How can I help you today?"
+    - type: web
+      port: 3000
+
+  memory:
+    shortTerm: true
+    longTerm: false
+
+  dtv:
+    trust:
+      level: verified
+    value:
+      metrics:
+        - response_time
+        - resolution_rate
+        - customer_satisfaction
+
+  streaming:
+    enabled: true
+
+  locale: en

package/package.json

@@ -1,50 +1,50 @@
-{
-  "name": "opc-agent",
-  "version": "1.3.0",
-  "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "opc": "dist/cli.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "dev": "tsc --watch",
-    "lint": "tsc --noEmit",
-    "docs:dev": "vitepress dev docs",
-    "docs:build": "vitepress build docs",
-    "docs:preview": "vitepress preview docs"
-  },
-  "keywords": [
-    "agent",
-    "ai",
-    "llm",
-    "framework",
-    "typescript",
-    "agent-framework"
-  ],
-  "author": "Deepleaper",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Deepleaper/opc-agent.git"
-  },
-  "dependencies": {
-    "agentkits": "^0.1.0",
-    "commander": "^12.0.0",
-    "express": "^4.21.0",
-    "js-yaml": "^4.1.0",
-    "ws": "^8.20.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.21",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.11.0",
-    "@types/ws": "^8.18.1",
-    "typescript": "^5.5.0",
-    "vitest": "^2.0.0",
-    "vitepress": "^1.5.0"
-  }
-}
+{
+  "name": "opc-agent",
+  "version": "1.3.2",
+  "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "opc": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "keywords": [
+    "agent",
+    "ai",
+    "llm",
+    "framework",
+    "typescript",
+    "agent-framework"
+  ],
+  "author": "Deepleaper",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Deepleaper/opc-agent.git"
+  },
+  "dependencies": {
+    "agentkits": "^0.1.0",
+    "commander": "^12.0.0",
+    "express": "^4.21.0",
+    "js-yaml": "^4.1.0",
+    "ws": "^8.20.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "vitepress": "^1.5.0"
+  }
+}

package/src/analytics/index.ts

@@ -1,66 +1,66 @@
-/**
- * Agent Analytics — track messages, response times, skill usage, errors, tokens.
- */
-export interface AnalyticsSnapshot {
-  messagesProcessed: number;
-  avgResponseTimeMs: number;
-  skillUsage: Record<string, number>;
-  errorCount: number;
-  tokenUsage: { input: number; output: number; total: number };
-  uptime: number;
-  startedAt: number;
-}
-
-export class Analytics {
-  private messagesProcessed = 0;
-  private totalResponseTimeMs = 0;
-  private skillUsage: Record<string, number> = {};
-  private errorCount = 0;
-  private tokenUsage = { input: 0, output: 0 };
-  private startedAt = Date.now();
-
-  recordMessage(responseTimeMs: number): void {
-    this.messagesProcessed++;
-    this.totalResponseTimeMs += responseTimeMs;
-  }
-
-  recordSkillUsage(skillName: string): void {
-    this.skillUsage[skillName] = (this.skillUsage[skillName] ?? 0) + 1;
-  }
-
-  recordError(): void {
-    this.errorCount++;
-  }
-
-  recordTokens(input: number, output: number): void {
-    this.tokenUsage.input += input;
-    this.tokenUsage.output += output;
-  }
-
-  getSnapshot(): AnalyticsSnapshot {
-    return {
-      messagesProcessed: this.messagesProcessed,
-      avgResponseTimeMs: this.messagesProcessed > 0
-        ? Math.round(this.totalResponseTimeMs / this.messagesProcessed)
-        : 0,
-      skillUsage: { ...this.skillUsage },
-      errorCount: this.errorCount,
-      tokenUsage: {
-        input: this.tokenUsage.input,
-        output: this.tokenUsage.output,
-        total: this.tokenUsage.input + this.tokenUsage.output,
-      },
-      uptime: Date.now() - this.startedAt,
-      startedAt: this.startedAt,
-    };
-  }
-
-  reset(): void {
-    this.messagesProcessed = 0;
-    this.totalResponseTimeMs = 0;
-    this.skillUsage = {};
-    this.errorCount = 0;
-    this.tokenUsage = { input: 0, output: 0 };
-    this.startedAt = Date.now();
-  }
-}
+/**
+ * Agent Analytics — track messages, response times, skill usage, errors, tokens.
+ */
+export interface AnalyticsSnapshot {
+  messagesProcessed: number;
+  avgResponseTimeMs: number;
+  skillUsage: Record<string, number>;
+  errorCount: number;
+  tokenUsage: { input: number; output: number; total: number };
+  uptime: number;
+  startedAt: number;
+}
+
+export class Analytics {
+  private messagesProcessed = 0;
+  private totalResponseTimeMs = 0;
+  private skillUsage: Record<string, number> = {};
+  private errorCount = 0;
+  private tokenUsage = { input: 0, output: 0 };
+  private startedAt = Date.now();
+
+  recordMessage(responseTimeMs: number): void {
+    this.messagesProcessed++;
+    this.totalResponseTimeMs += responseTimeMs;
+  }
+
+  recordSkillUsage(skillName: string): void {
+    this.skillUsage[skillName] = (this.skillUsage[skillName] ?? 0) + 1;
+  }
+
+  recordError(): void {
+    this.errorCount++;
+  }
+
+  recordTokens(input: number, output: number): void {
+    this.tokenUsage.input += input;
+    this.tokenUsage.output += output;
+  }
+
+  getSnapshot(): AnalyticsSnapshot {
+    return {
+      messagesProcessed: this.messagesProcessed,
+      avgResponseTimeMs: this.messagesProcessed > 0
+        ? Math.round(this.totalResponseTimeMs / this.messagesProcessed)
+        : 0,
+      skillUsage: { ...this.skillUsage },
+      errorCount: this.errorCount,
+      tokenUsage: {
+        input: this.tokenUsage.input,
+        output: this.tokenUsage.output,
+        total: this.tokenUsage.input + this.tokenUsage.output,
+      },
+      uptime: Date.now() - this.startedAt,
+      startedAt: this.startedAt,
+    };
+  }
+
+  reset(): void {
+    this.messagesProcessed = 0;
+    this.totalResponseTimeMs = 0;
+    this.skillUsage = {};
+    this.errorCount = 0;
+    this.tokenUsage = { input: 0, output: 0 };
+    this.startedAt = Date.now();
+  }
+}