@bluefly/openstandardagents 0.4.8 → 0.4.9

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/openapi/agent-communication.yaml

@@ -65,8 +65,8 @@ paths:
               taskAssignment:
                 summary: Assign task to worker
                 value:
-                  to: agent://worker-001
-                  from: agent://orchestrator-main
+                  to: uadp://worker-001
+                  from: uadp://orchestrator-main
                   type: TaskAssigned
                   payload:
                     taskId: task-123
@@ -78,8 +78,8 @@ paths:
               queryRequest:
                 summary: Query another agent
                 value:
-                  to: agent://specialist-nlp
-                  from: agent://worker-002
+                  to: uadp://specialist-nlp
+                  from: uadp://worker-002
                   type: QueryRequest
                   payload:
                     query: "Extract entities from text"
@@ -299,7 +299,7 @@ paths:
               webhookSubscription:
                 summary: Webhook-based subscription
                 value:
-                  agentId: agent://worker-003
+                  agentId: uadp://worker-003
                   deliveryMode: push
                   webhookUrl: https://worker-003.example.com/channels/task-updates
                   filter:
@@ -307,7 +307,7 @@ paths:
               pollingSubscription:
                 summary: Polling-based subscription
                 value:
-                  agentId: agent://monitor-001
+                  agentId: uadp://monitor-001
                   deliveryMode: pull
                   filter:
                     messageTypes: [TaskCompleted]
@@ -386,7 +386,7 @@ paths:
                 value:
                   type: AgentStarted
                   payload:
-                    agentId: agent://worker-005
+                    agentId: uadp://worker-005
                     version: 1.2.0
                     capabilities: [text_analysis, entity_extraction]
                     startedAt: "2025-12-18T14:25:00Z"
@@ -627,13 +627,13 @@ components:
         to:
           type: string
           format: uri
-          description: Target agent URI (e.g., agent://worker-001)
-          pattern: '^agent://[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
+          description: Target agent URI (e.g., uadp://worker-001)
+          pattern: '^uadp://[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
         from:
           type: string
           format: uri
           description: Source agent URI
-          pattern: '^agent://[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
+          pattern: '^uadp://[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
         type:
           $ref: '#/components/schemas/MessageType'
         payload:
@@ -865,7 +865,7 @@ components:
         agentId:
           type: string
           format: uri
-          pattern: '^agent://[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
+          pattern: '^uadp://[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
           description: Subscribing agent URI
         deliveryMode:
           type: string
@@ -970,7 +970,7 @@ components:
         agentId:
           type: string
           format: uri
-          pattern: '^agent://[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
+          pattern: '^uadp://[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
         description:
           type: string
         events:

package/openapi/marketplace-plugin.openapi.yaml

@@ -2093,7 +2093,7 @@ components:
       properties:
         uri:
           type: string
-          pattern: '^agent://'
+          pattern: '^uadp://'
         name:
           type: string
         version:

package/openapi/protocols/sse-streams.yaml

@@ -80,14 +80,14 @@ paths:
                   value: |
                     event: message
                     id: msg-123e4567-e89b-12d3-a456-426614174000
-                    data: {"type":"message","timestamp":"2025-12-18T14:00:00Z","payload":{"channel":"content.published","data":{"contentId":"node-123"}},"metadata":{"agentId":"agent://example.com/publisher"}}
+                    data: {"type":"message","timestamp":"2025-12-18T14:00:00Z","payload":{"channel":"content.published","data":{"contentId":"node-123"}},"metadata":{"agentId":"uadp://example.com/publisher"}}
 
                 status_event:
                   summary: Status update event
                   value: |
                     event: status
                     id: status-456e7890-a12b-34c5-d678-901234567890
-                    data: {"type":"status","timestamp":"2025-12-18T14:00:00Z","payload":{"status":"healthy","load":0.45},"metadata":{"agentId":"agent://example.com/agent"}}
+                    data: {"type":"status","timestamp":"2025-12-18T14:00:00Z","payload":{"status":"healthy","load":0.45},"metadata":{"agentId":"uadp://example.com/agent"}}
 
         '401':
           description: Unauthorized - Invalid authentication
@@ -401,7 +401,7 @@ components:
           type: string
           format: uri
           description: Agent URI of sender
-          example: agent://example.com/supercali-fragilisticagent
+          example: uadp://example.com/supercali-fragilisticagent
         streamId:
           type: string
           format: uuid

package/openapi/protocols/websocket-events.yaml

@@ -111,8 +111,8 @@ components:
             agentId:
               type: string
               format: uri
-              description: Agent URI (agent://domain/agent-id)
-              example: agent://example.com/supercali-fragilisticagent
+              description: Agent URI (uadp://domain/agent-id)
+              example: uadp://example.com/supercali-fragilisticagent
             capabilities:
               type: array
               items:
@@ -353,7 +353,7 @@ components:
           type: string
           format: uri
           description: Agent URI of sender
-          example: agent://example.com/supercali-fragilisticagent
+          example: uadp://example.com/supercali-fragilisticagent
         correlationId:
           type: string
           format: uuid

package/openapi/uadp-asyncapi.yaml

@@ -1,6 +1,6 @@
 asyncapi: 3.0.0
 info:
-  title: Universal Agent Discovery Protocol (UADP) — Event Streams
+  title: Universal AI Discovery Protocol (UADP) — Event Streams
   version: 0.4.0
   description: |
     ## UADP AsyncAPI Specification v0.4

package/openapi/uadp-openapi.yaml

@@ -1,10 +1,10 @@
 openapi: 3.1.0
 info:
-  title: Universal Agent Discovery Protocol (UADP) — REST API
+  title: Universal AI Discovery Protocol (UADP) — REST API
   version: 0.4.0
   description: |
-    ## Universal Agent Discovery Protocol (UADP) v0.4
-    
+    ## Universal AI Discovery Protocol (UADP) v0.4
+
     UADP is the decentralized discovery and registry standard that is the "missing contract"
     for software agents — part of the Open Standard for Software Agents (OSSA) specification.
 
@@ -52,6 +52,8 @@ tags:
     description: Agent registration and lifecycle management
   - name: discovery
     description: Agent discovery, search, and filtering
+  - name: federation
+    description: Peer-to-peer gossip and node federation (v0.6.0)
   - name: trust
     description: Signature verification and trust badge resolution
   - name: health
@@ -61,6 +63,43 @@ tags:
 
 paths:
   # ─────────────────────────────────────────────
+  # WEBFINGER (Decentralized Discovery)
+  # ─────────────────────────────────────────────
+  /.well-known/webfinger:
+    get:
+      summary: RFC 7033 WebFinger Discovery
+      description: |
+        Given a resource URI (like `uadp://skills.sh/code-review` or `acct:alice@example.com`),
+        this endpoint returns JRD (JSON Resource Descriptor) format links pointing to
+        the agent's OSSA manifest, UADP status, or PGP keys.
+        This prevents UADP from requiring a centralized registry.
+      operationId: uadp_webfinger
+      tags: [discovery]
+      parameters:
+        - name: resource
+          in: query
+          required: true
+          schema:
+            type: string
+          description: "URI to look up (e.g., uadp://skills.sh/tools/linter)"
+          example: "uadp://skills.sh/tools/linter"
+        - name: rel
+          in: query
+          schema:
+            type: string
+          description: "Optional link relation to filter by (e.g., https://openstandardagents.org/rel/manifest)"
+      responses:
+        '200':
+          description: JRD Resource Descriptor
+          content:
+            application/jrd+json:
+              schema:
+                $ref: '#/components/schemas/WebFingerJRD'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '404':
+          $ref: '#/components/responses/NotFound'
+  # ─────────────────────────────────────────────
   # REGISTRY
   # ─────────────────────────────────────────────
   /registry/register:
@@ -80,6 +119,15 @@ paths:
           application/json:
             schema:
               $ref: '#/components/schemas/RegistrationRequest'
+      parameters:
+        - name: gossip
+          in: query
+          description: |
+            If true, the registering node/agent wishes to participate in P2P gossip.
+            The response will include a `peers` array of known active UADP nodes.
+          schema:
+            type: boolean
+            default: false
             examples:
               signedAgent:
                 summary: Agent with Ed25519 x-signature
@@ -196,7 +244,7 @@ paths:
         - **capabilities** (capability matching — all must match)
         - **trust** (`verified-signature`, `signed`, `community`, `official`, `experimental`)
         - **status** (active, deprecated, revoked)
-        
+
         pagination via `limit` + `cursor` for large registries.
       operationId: uadp_discoverAgents
       tags: [discovery]
@@ -293,7 +341,7 @@ paths:
       description: |
         Accepts an agent manifest (or just the `metadata.x-signature` block) and performs
         cryptographic verification of the signature against the embedded public key.
-        
+
         Returns a `TrustVerificationResult` indicating whether the signature is valid,
         what tier it earns, and why.
       operationId: uadp_verifySignature
@@ -416,6 +464,46 @@ components:
       description: Unique agent identifier (DNS-1123 subdomain format)
 
   schemas:
+    # ── WEBFINGER JRD ──────────────────────────
+    WebFingerJRD:
+      type: object
+      required: [subject, links]
+      properties:
+        subject:
+          type: string
+          description: The URI of the requested resource
+        aliases:
+          type: array
+          items:
+            type: string
+            format: uri
+        properties:
+          type: object
+          additionalProperties:
+            type: string
+        links:
+          type: array
+          items:
+            type: object
+            required: [rel, href]
+            properties:
+              rel:
+                type: string
+                description: Link relation type
+              type:
+                type: string
+                description: Media type
+              href:
+                type: string
+                format: uri
+              titles:
+                type: object
+                additionalProperties:
+                  type: string
+              properties:
+                type: object
+                additionalProperties:
+                  type: string
     # ── SIGNATURE ──────────────────────────────
     XSignature:
       type: object
@@ -540,6 +628,12 @@ components:
           format: date-time
         tier:
           $ref: '#/components/schemas/TrustTier'
+        peers:
+          type: array
+          description: "List of known UADP node URIs for P2P gossip (present if `gossip=true` was sent)"
+          items:
+            type: string
+            format: uri
 
     # ── AGENT RECORD ───────────────────────────
     AgentRecord: