@bluefly/openstandardagents 0.4.8 → 0.5.0

package/examples/agent-mesh/DISCOVERY.md

@@ -115,7 +115,7 @@ const discovery = new DiscoveryService(registry);
 
 // Define your agent
 const myAgent: AgentCard = {
-  uri: 'agent://team/creative-agent-naming',
+  uri: 'uadp://team/creative-agent-naming',
   name: 'My Agent',
   version: '1.0.0',
   ossaVersion: '0.4.1',
@@ -172,16 +172,16 @@ const graph = new AgentGraphBuilder()
     {
       id: 'security',
       name: 'Security Team',
-      leader: 'agent://security/leader',
-      members: ['agent://security/scanner'],
-      specialists: ['agent://security/secrets-detector'],
+      leader: 'uadp://security/leader',
+      members: ['uadp://security/scanner'],
+      specialists: ['uadp://security/secrets-detector'],
       capabilities: ['vulnerability-scanning', 'secret-detection'],
     },
   ])
   .withRelationships([
     {
-      from: 'agent://security/leader',
-      to: 'agent://security/scanner',
+      from: 'uadp://security/leader',
+      to: 'uadp://security/scanner',
       type: 'leader',
       weight: 1.0,
       bidirectional: false,
@@ -192,8 +192,8 @@ const graph = new AgentGraphBuilder()
 
 // Record communication
 graph.recordCommunication({
-  from: 'agent://security/scanner',
-  to: 'agent://compliance/auditor',
+  from: 'uadp://security/scanner',
+  to: 'uadp://compliance/auditor',
   channel: 'security.vulnerabilities',
   frequency: 5.2,
   latencyMs: 45,
@@ -206,8 +206,8 @@ const topAgents = graph.getTopAgents(5);
 
 // Find path
 const path = graph.findPath(
-  'agent://security/scanner',
-  'agent://compliance/auditor'
+  'uadp://security/scanner',
+  'uadp://compliance/auditor'
 );
 ```
 
@@ -231,7 +231,7 @@ const router = new AdvancedAgentRouter({
 const agent = await router.routeByCapability('data-processing', {
   preferredRegion: 'us-east-1',
   maxLatencyMs: 100,
-  excludeAgents: ['agent://workers/worker-1'],
+  excludeAgents: ['uadp://workers/worker-1'],
 });
 
 // Route to multiple agents
@@ -266,7 +266,7 @@ Uses DNS SRV and TXT records for discovery.
 **DNS Structure:**
 ```
 _agents._tcp.agents.internal           SRV    0 0 8080 agent1.agents.internal
-agent1.agents.internal                 TXT    {"uri":"agent://team/agent1","capabilities":["scan"]}
+agent1.agents.internal                 TXT    {"uri":"uadp://team/agent1","capabilities":["scan"]}
 
 _vulnerability-scanning._tcp.agents.internal  SRV    0 0 8080 scanner.agents.internal
 ```
@@ -317,7 +317,7 @@ await consul.unregister(myAgent.uri);
   "Name": "security-scanner",
   "Tags": ["ossa-agent", "vulnerability-scanning"],
   "Meta": {
-    "uri": "agent://security/scanner",
+    "uri": "uadp://security/scanner",
     "version": "1.0.0",
     "ossaVersion": "0.4.1",
     "capabilities": "vulnerability-scanning,secret-detection"
@@ -362,7 +362,7 @@ metadata:
     app.kubernetes.io/component: ossa-agent
     app.kubernetes.io/version: "1.0.0"
   annotations:
-    ossa.io/agent-uri: "agent://security/scanner"
+    ossa.io/agent-uri: "uadp://security/scanner"
     ossa.io/version: "0.4.1"
     ossa.io/capabilities: "vulnerability-scanning,secret-detection"
 spec:
@@ -506,8 +506,8 @@ states.forEach((state, uri) => {
 
 ```typescript
 graph.addRelationship({
-  from: 'agent://security/leader',
-  to: 'agent://security/scanner',
+  from: 'uadp://security/leader',
+  to: 'uadp://security/scanner',
   type: 'leader',
   weight: 1.0,
   bidirectional: false,
@@ -519,7 +519,7 @@ graph.addRelationship({
 
 // Get related agents
 const workers = graph.findRelatedAgents(
-  'agent://security/leader',
+  'uadp://security/leader',
   'leader'
 );
 ```
@@ -530,8 +530,8 @@ Track message frequency, latency, and errors between agents.
 
 ```typescript
 graph.recordCommunication({
-  from: 'agent://security/scanner',
-  to: 'agent://compliance/auditor',
+  from: 'uadp://security/scanner',
+  to: 'uadp://compliance/auditor',
   channel: 'security.vulnerabilities',
   frequency: 5.2,  // messages per minute
   latencyMs: 45,
@@ -540,8 +540,8 @@ graph.recordCommunication({
 
 // Get statistics
 const stats = graph.getCommunicationStats(
-  'agent://security/scanner',
-  'agent://compliance/auditor'
+  'uadp://security/scanner',
+  'uadp://compliance/auditor'
 );
 
 console.log(`Total messages: ${stats.totalMessages}`);
@@ -640,7 +640,7 @@ process.on('SIGTERM', async () => {
 
 ```typescript
 // Check if agent is registered
-const agent = await discovery.discoverByUri('agent://team/creative-agent-naming');
+const agent = await discovery.discoverByUri('uadp://team/creative-agent-naming');
 if (!agent) {
   console.log('Agent not registered');
 }
@@ -657,9 +657,9 @@ const healthyAgents = await discovery.findHealthyAgents();
 
 ```typescript
 const states = router.getCircuitBreakerStates();
-if (states.get('agent://team/agent') === 'open') {
+if (states.get('uadp://team/agent') === 'open') {
   // Reset manually if issue resolved
-  router.resetCircuitBreaker('agent://team/agent');
+  router.resetCircuitBreaker('uadp://team/agent');
 }
 ```
 
@@ -667,7 +667,7 @@ if (states.get('agent://team/agent') === 'open') {
 
 ```typescript
 // Check communication patterns
-const stats = graph.getCommunicationStats('agent://source', 'agent://target');
+const stats = graph.getCommunicationStats('uadp://source', 'uadp://target');
 console.log(`Avg latency: ${stats.avgLatency}ms`);
 
 // Route to nearest agent

package/examples/agent-mesh/README.ts

@@ -39,7 +39,7 @@
  *
  * // 2. Define your agent
  * const agent = {
- *   uri: 'agent://team/my-agent',
+ *   uri: 'uadp://team/my-agent',
  *   name: 'My Agent',
  *   version: '1.0.0',
  *   ossaVersion: '0.3.0',
@@ -136,7 +136,7 @@
  * ```typescript
  * // Requester
  * const response = await client.request(
- *   'agent://team/analyzer',
+ *   'uadp://team/analyzer',
  *   { action: 'analyze', data: 'sample' },
  *   { timeoutMs: 30000 }
  * );
@@ -168,7 +168,7 @@
  *
  * ```typescript
  * // Send message directly to specific agent
- * await client.send('agent://team/specific-agent', {
+ * await client.send('uadp://team/specific-agent', {
  *   message: 'Hello!',
  * });
  * ```
@@ -183,11 +183,11 @@
  * const router = new DefaultMessageRouter();
  *
  * router.addRule({
- *   source: 'agent://security/scanner',
+ *   source: 'uadp://security/scanner',
  *   channel: 'security.vulnerabilities',
  *   targets: [
- *     'agent://compliance/auditor',
- *     'agent://monitoring/alerter',
+ *     'uadp://compliance/auditor',
+ *     'uadp://monitoring/alerter',
  *   ],
  *   filter: {
  *     fields: { severity: ['critical', 'high'] }

package/examples/agent-mesh/basic-usage.ts

@@ -25,7 +25,7 @@ async function examplePubSub() {
 
   // Define security scanner agent
   const securityAgent: AgentCard = {
-    uri: 'agent://security/scanner',
+    uri: 'uadp://security/scanner',
     name: 'Security Scanner',
     version: '1.0.0',
     ossaVersion: '0.3.0',
@@ -43,7 +43,7 @@ async function examplePubSub() {
 
   // Define monitoring agent
   const monitoringAgent: AgentCard = {
-    uri: 'agent://observability/monitor',
+    uri: 'uadp://observability/monitor',
     name: 'Monitoring Agent',
     version: '1.0.0',
     ossaVersion: '0.3.0',
@@ -120,7 +120,7 @@ async function exampleRequestResponse() {
 
   // Define code analyzer agent
   const analyzerAgent: AgentCard = {
-    uri: 'agent://code/analyzer',
+    uri: 'uadp://code/analyzer',
     name: 'Code Analyzer',
     version: '1.0.0',
     ossaVersion: '0.3.0',
@@ -138,7 +138,7 @@ async function exampleRequestResponse() {
 
   // Define orchestrator agent
   const orchestratorAgent: AgentCard = {
-    uri: 'agent://orchestrator/main',
+    uri: 'uadp://orchestrator/main',
     name: 'Orchestrator',
     version: '1.0.0',
     ossaVersion: '0.3.0',
@@ -205,7 +205,7 @@ async function exampleRequestResponse() {
   // Invoke command from orchestrator
   console.log('📞 Orchestrator invoking code analysis...\n');
   const result = await orchestratorClient.invokeCommand(
-    'agent://code/analyzer',
+    'uadp://code/analyzer',
     'analyze_code',
     {
       repository: 'https://github.com/org/repo',
@@ -234,7 +234,7 @@ async function exampleWorkflow() {
 
   // Define agents
   const validatorAgent: AgentCard = {
-    uri: 'agent://validation/config',
+    uri: 'uadp://validation/config',
     name: 'Config Validator',
     version: '1.0.0',
     ossaVersion: '0.3.0',
@@ -246,7 +246,7 @@ async function exampleWorkflow() {
   };
 
   const deployerAgent: AgentCard = {
-    uri: 'agent://deployment/deployer',
+    uri: 'uadp://deployment/deployer',
     name: 'Deployer',
     version: '1.0.0',
     ossaVersion: '0.3.0',
@@ -258,7 +258,7 @@ async function exampleWorkflow() {
   };
 
   const monitorAgent: AgentCard = {
-    uri: 'agent://observability/monitor',
+    uri: 'uadp://observability/monitor',
     name: 'Monitor',
     version: '1.0.0',
     ossaVersion: '0.3.0',
@@ -344,7 +344,7 @@ async function exampleBroadcast() {
 
   // Define orchestrator
   const orchestrator: AgentCard = {
-    uri: 'agent://orchestrator/main',
+    uri: 'uadp://orchestrator/main',
     name: 'Orchestrator',
     version: '1.0.0',
     ossaVersion: '0.3.0',
@@ -357,7 +357,7 @@ async function exampleBroadcast() {
 
   // Define workers
   const worker1: AgentCard = {
-    uri: 'agent://workers/worker-1',
+    uri: 'uadp://workers/worker-1',
     name: 'Worker 1',
     version: '1.0.0',
     ossaVersion: '0.3.0',
@@ -369,7 +369,7 @@ async function exampleBroadcast() {
   };
 
   const worker2: AgentCard = {
-    uri: 'agent://workers/worker-2',
+    uri: 'uadp://workers/worker-2',
     name: 'Worker 2',
     version: '1.0.0',
     ossaVersion: '0.3.0',

package/examples/agent-mesh/discovery-system.ts

@@ -53,7 +53,7 @@ async function exampleMultiProviderDiscovery() {
     // Register some test agents in memory
     const testAgents: AgentCard[] = [
       {
-        uri: 'agent://security/scanner-1',
+        uri: 'uadp://security/scanner-1',
         name: 'Security Scanner 1',
         version: '1.0.0',
         ossaVersion: '0.4.1',
@@ -66,7 +66,7 @@ async function exampleMultiProviderDiscovery() {
         metadata: { region: 'us-east-1', team: 'security' },
       },
       {
-        uri: 'agent://security/scanner-2',
+        uri: 'uadp://security/scanner-2',
         name: 'Security Scanner 2',
         version: '1.0.0',
         ossaVersion: '0.4.1',
@@ -79,7 +79,7 @@ async function exampleMultiProviderDiscovery() {
         metadata: { region: 'us-west-2', team: 'security' },
       },
       {
-        uri: 'agent://compliance/auditor',
+        uri: 'uadp://compliance/auditor',
         name: 'Compliance Auditor',
         version: '1.0.0',
         ossaVersion: '0.4.1',
@@ -127,7 +127,7 @@ async function exampleAgentGraph() {
   const agents: AgentCard[] = [
     // Security Team
     {
-      uri: 'agent://security/leader',
+      uri: 'uadp://security/leader',
       name: 'Security Team Leader',
       version: '1.0.0',
       ossaVersion: '0.4.1',
@@ -140,7 +140,7 @@ async function exampleAgentGraph() {
       metadata: { team: 'security', role: 'leader' },
     },
     {
-      uri: 'agent://security/scanner',
+      uri: 'uadp://security/scanner',
       name: 'Security Scanner',
       version: '1.0.0',
       ossaVersion: '0.4.1',
@@ -153,7 +153,7 @@ async function exampleAgentGraph() {
       metadata: { team: 'security', role: 'worker' },
     },
     {
-      uri: 'agent://security/secrets-detector',
+      uri: 'uadp://security/secrets-detector',
       name: 'Secrets Detector',
       version: '1.0.0',
       ossaVersion: '0.4.1',
@@ -167,7 +167,7 @@ async function exampleAgentGraph() {
     },
     // Compliance Team
     {
-      uri: 'agent://compliance/auditor',
+      uri: 'uadp://compliance/auditor',
       name: 'Compliance Auditor',
       version: '1.0.0',
       ossaVersion: '0.4.1',
@@ -188,38 +188,38 @@ async function exampleAgentGraph() {
       {
         id: 'security',
         name: 'Security Team',
-        leader: 'agent://security/leader',
-        members: ['agent://security/scanner'],
-        specialists: ['agent://security/secrets-detector'],
+        leader: 'uadp://security/leader',
+        members: ['uadp://security/scanner'],
+        specialists: ['uadp://security/secrets-detector'],
         capabilities: ['vulnerability-scanning', 'secret-detection', 'security-management'],
       },
       {
         id: 'compliance',
         name: 'Compliance Team',
         leader: undefined,
-        members: ['agent://compliance/auditor'],
+        members: ['uadp://compliance/auditor'],
         specialists: [],
         capabilities: ['policy-enforcement', 'audit-logging'],
       },
     ])
     .withRelationships([
       {
-        from: 'agent://security/leader',
-        to: 'agent://security/scanner',
+        from: 'uadp://security/leader',
+        to: 'uadp://security/scanner',
         type: 'leader',
         weight: 1.0,
         bidirectional: false,
       },
       {
-        from: 'agent://security/leader',
-        to: 'agent://security/secrets-detector',
+        from: 'uadp://security/leader',
+        to: 'uadp://security/secrets-detector',
         type: 'leader',
         weight: 1.0,
         bidirectional: false,
       },
       {
-        from: 'agent://security/scanner',
-        to: 'agent://compliance/auditor',
+        from: 'uadp://security/scanner',
+        to: 'uadp://compliance/auditor',
         type: 'dependency',
         weight: 0.8,
         bidirectional: false,
@@ -231,8 +231,8 @@ async function exampleAgentGraph() {
   // Record some communication patterns
   console.log('📊 Recording communication patterns...');
   graph.recordCommunication({
-    from: 'agent://security/scanner',
-    to: 'agent://compliance/auditor',
+    from: 'uadp://security/scanner',
+    to: 'uadp://compliance/auditor',
     channel: 'security.vulnerabilities',
     frequency: 5.2,
     latencyMs: 45,
@@ -240,8 +240,8 @@ async function exampleAgentGraph() {
   });
 
   graph.recordCommunication({
-    from: 'agent://security/leader',
-    to: 'agent://security/scanner',
+    from: 'uadp://security/leader',
+    to: 'uadp://security/scanner',
     channel: 'security.tasks',
     frequency: 10.5,
     latencyMs: 20,
@@ -274,7 +274,7 @@ async function exampleAgentGraph() {
 
   // Find path between agents
   console.log('\n🔗 Finding path from scanner to auditor...');
-  const path = graph.findPath('agent://security/scanner', 'agent://compliance/auditor');
+  const path = graph.findPath('uadp://security/scanner', 'uadp://compliance/auditor');
   if (path) {
     console.log(`  Path: ${path.join(' → ')}`);
   }
@@ -301,7 +301,7 @@ async function exampleAdvancedRouting() {
   // Register multiple agents with same capability
   const agents: AgentCard[] = [
     {
-      uri: 'agent://workers/worker-1',
+      uri: 'uadp://workers/worker-1',
       name: 'Worker 1',
       version: '1.0.0',
       ossaVersion: '0.4.1',
@@ -314,7 +314,7 @@ async function exampleAdvancedRouting() {
       metadata: { region: 'us-east-1' },
     },
     {
-      uri: 'agent://workers/worker-2',
+      uri: 'uadp://workers/worker-2',
       name: 'Worker 2',
       version: '1.0.0',
       ossaVersion: '0.4.1',
@@ -327,7 +327,7 @@ async function exampleAdvancedRouting() {
       metadata: { region: 'us-west-2' },
     },
     {
-      uri: 'agent://workers/worker-3',
+      uri: 'uadp://workers/worker-3',
       name: 'Worker 3',
       version: '1.0.0',
       ossaVersion: '0.4.1',
@@ -389,8 +389,8 @@ async function exampleAdvancedRouting() {
   });
 
   // Simulate some failures for worker-2 to lower its weight
-  weightedRouter.recordResult('agent://workers/worker-2', false);
-  weightedRouter.recordResult('agent://workers/worker-2', false, 200);
+  weightedRouter.recordResult('uadp://workers/worker-2', false);
+  weightedRouter.recordResult('uadp://workers/worker-2', false, 200);
 
   for (let i = 0; i < 5; i++) {
     const agent = await weightedRouter.routeByCapability('data-processing');
@@ -430,7 +430,7 @@ async function exampleCircuitBreaker() {
 
   // Register agents
   const healthyAgent: AgentCard = {
-    uri: 'agent://stable/worker',
+    uri: 'uadp://stable/worker',
     name: 'Stable Worker',
     version: '1.0.0',
     ossaVersion: '0.4.1',
@@ -443,7 +443,7 @@ async function exampleCircuitBreaker() {
   };
 
   const flakyAgent: AgentCard = {
-    uri: 'agent://flaky/worker',
+    uri: 'uadp://flaky/worker',
     name: 'Flaky Worker',
     version: '1.0.0',
     ossaVersion: '0.4.1',
@@ -468,7 +468,7 @@ async function exampleCircuitBreaker() {
   // Simulate failures
   for (let i = 0; i < 6; i++) {
     const agent = await router.routeByCapability('task-execution');
-    if (agent?.uri === 'agent://flaky/worker') {
+    if (agent?.uri === 'uadp://flaky/worker') {
       console.log(`  Request ${i + 1} → ${agent.name} (FAILED)`);
       router.recordResult(agent.uri, false);
     } else if (agent) {
@@ -514,7 +514,7 @@ async function exampleCompleteSystem() {
   // Register agents
   const agents: AgentCard[] = [
     {
-      uri: 'agent://platform/orchestrator',
+      uri: 'uadp://platform/orchestrator',
       name: 'Platform Orchestrator',
       version: '1.0.0',
       ossaVersion: '0.4.1',
@@ -526,7 +526,7 @@ async function exampleCompleteSystem() {
       status: 'healthy',
     },
     {
-      uri: 'agent://platform/analyzer',
+      uri: 'uadp://platform/analyzer',
       name: 'Code Analyzer',
       version: '1.0.0',
       ossaVersion: '0.4.1',
@@ -548,15 +548,15 @@ async function exampleCompleteSystem() {
   graph.defineTeam({
     id: 'platform',
     name: 'Platform Team',
-    leader: 'agent://platform/orchestrator',
-    members: ['agent://platform/analyzer'],
+    leader: 'uadp://platform/orchestrator',
+    members: ['uadp://platform/analyzer'],
     specialists: [],
     capabilities: ['workflow-orchestration', 'code-analysis'],
   });
 
   graph.addRelationship({
-    from: 'agent://platform/orchestrator',
-    to: 'agent://platform/analyzer',
+    from: 'uadp://platform/orchestrator',
+    to: 'uadp://platform/analyzer',
     type: 'leader',
     weight: 1.0,
     bidirectional: false,
@@ -619,7 +619,7 @@ async function exampleCompleteSystem() {
 
       // Record in graph
       graph.recordCommunication({
-        from: 'agent://platform/orchestrator',
+        from: 'uadp://platform/orchestrator',
         to: analyzer.uri,
         channel: 'code-analysis',
         frequency: 1,

package/examples/agents/01-customer-support-bot/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: customer-support-bot
@@ -26,19 +26,16 @@ spec:
     - Clear and concise explanations
     - Proactive in offering solutions
     - Transparent about limitations
-
   llm:
     provider: openai
     model: gpt-4o
     temperature: 0.7
     maxTokens: 1500
-
   capabilities:
     - search_documentation
     - create_ticket
     - send_email
     - conversation_memory
-
   tools:
     - type: function
       name: search_docs
@@ -55,7 +52,6 @@ spec:
             default: 5
         required:
           - query
-
     - type: function
       name: create_ticket
       description: Create a support ticket for issues requiring human attention
@@ -70,7 +66,11 @@ spec:
             description: Detailed description of the issue
           priority:
             type: string
-            enum: [low, medium, high, urgent]
+            enum:
+              - low
+              - medium
+              - high
+              - urgent
             description: Priority level of the ticket
           category:
             type: string
@@ -79,7 +79,6 @@ spec:
           - title
           - description
           - priority
-
     - type: function
       name: send_email
       description: Send follow-up email to customer
@@ -98,12 +97,14 @@ spec:
           template:
             type: string
             description: Email template to use
-            enum: [follow_up, resolution, escalation]
+            enum:
+              - follow_up
+              - resolution
+              - escalation
         required:
           - to
           - subject
           - body
-
   autonomy:
     level: supervised
     approval_required: false
@@ -112,7 +113,6 @@ spec:
         action: notify_human
       - condition: ticket_count > 3
         action: escalate
-
   memory:
     enabled: true
     type: conversation_buffer
@@ -121,7 +121,6 @@ spec:
       enabled: true
       backend: redis
       ttl: 86400
-
   safety:
     input_filters:
       - type: pii_detection
@@ -132,8 +131,9 @@ spec:
       - type: hallucination_check
         threshold: 0.8
       - type: tone_analysis
-        required_sentiment: [positive, neutral]
-
+        required_sentiment:
+          - positive
+          - neutral
   observability:
     logging:
       level: info
@@ -150,23 +150,16 @@ spec:
     tracing:
       enabled: true
       provider: opentelemetry
-
 extensions:
   langchain:
-    agent_type: react
-    memory_type: conversation_buffer
-    chain_type: conversation
-    tools_mapping:
-      - ossa_capability: search_documentation
-        langchain_tool: search_docs
-        tool_class: CustomSearchTool
-      - ossa_capability: create_ticket
-        langchain_tool: create_ticket
-        tool_class: TicketingTool
-      - ossa_capability: send_email
-        langchain_tool: send_email
-        tool_class: EmailTool
-    export_config:
-      format: python
-      include_dependencies: true
-      output_file: customer_support_agent.py
+    enabled: true
+    chain_type: agent
+    memory:
+      type: buffer
+    tools:
+      - name: search_docs
+        description: Search the knowledge base for relevant documentation
+      - name: create_ticket
+        description: Create a support ticket for issues requiring human attention
+      - name: send_email
+        description: Send follow-up email to customer