@bluefly/openstandardagents 0.4.4 → 0.4.5

package/dist/spec/v0.4/extensions/identity/identity.schema.json

@@ -0,0 +1,302 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.4/extensions/identity.json",
+  "title": "OSSA Identity Extension Schema (DID Document)",
+  "description": "Validates W3C DID Core-compliant identity documents for OSSA agents. Provides decentralized identity binding so agents can be cryptographically verified across platforms.",
+  "type": "object",
+  "required": ["@context", "id"],
+  "properties": {
+    "@context": {
+      "description": "JSON-LD context. Must include the W3C DID Core context.",
+      "oneOf": [
+        {
+          "type": "string",
+          "const": "https://www.w3.org/ns/did/v1"
+        },
+        {
+          "type": "array",
+          "items": { "type": "string" },
+          "contains": {
+            "const": "https://www.w3.org/ns/did/v1"
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "id": {
+      "type": "string",
+      "description": "DID identifier. Must use the did:web method for OSSA agents.",
+      "pattern": "^did:web:.+$",
+      "examples": [
+        "did:web:openstandardagents.org:agents:my-agent",
+        "did:web:example.com:agents:code-reviewer"
+      ]
+    },
+    "controller": {
+      "description": "DID(s) authorized to make changes to this DID document",
+      "oneOf": [
+        {
+          "type": "string",
+          "pattern": "^did:.+$"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^did:.+$"
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "alsoKnownAs": {
+      "type": "array",
+      "description": "Alternative identifiers for this agent (URIs)",
+      "items": {
+        "type": "string",
+        "format": "uri"
+      }
+    },
+    "verificationMethod": {
+      "type": "array",
+      "description": "Cryptographic verification methods (public keys) associated with this DID",
+      "items": {
+        "$ref": "#/definitions/VerificationMethod"
+      }
+    },
+    "authentication": {
+      "type": "array",
+      "description": "Verification methods used for authentication. References verificationMethod entries by id or embeds them inline.",
+      "items": {
+        "oneOf": [
+          {
+            "type": "string",
+            "description": "Reference to a verificationMethod id"
+          },
+          {
+            "$ref": "#/definitions/VerificationMethod"
+          }
+        ]
+      }
+    },
+    "assertionMethod": {
+      "type": "array",
+      "description": "Verification methods used for issuing verifiable credentials or assertions",
+      "items": {
+        "oneOf": [
+          {
+            "type": "string",
+            "description": "Reference to a verificationMethod id"
+          },
+          {
+            "$ref": "#/definitions/VerificationMethod"
+          }
+        ]
+      }
+    },
+    "keyAgreement": {
+      "type": "array",
+      "description": "Verification methods used for key agreement (e.g., establishing shared secrets)",
+      "items": {
+        "oneOf": [
+          {
+            "type": "string",
+            "description": "Reference to a verificationMethod id"
+          },
+          {
+            "$ref": "#/definitions/VerificationMethod"
+          }
+        ]
+      }
+    },
+    "capabilityInvocation": {
+      "type": "array",
+      "description": "Verification methods used to invoke cryptographic capabilities (e.g., authorization to update the DID document)",
+      "items": {
+        "oneOf": [
+          {
+            "type": "string",
+            "description": "Reference to a verificationMethod id"
+          },
+          {
+            "$ref": "#/definitions/VerificationMethod"
+          }
+        ]
+      }
+    },
+    "capabilityDelegation": {
+      "type": "array",
+      "description": "Verification methods used to delegate capabilities to other DIDs",
+      "items": {
+        "oneOf": [
+          {
+            "type": "string",
+            "description": "Reference to a verificationMethod id"
+          },
+          {
+            "$ref": "#/definitions/VerificationMethod"
+          }
+        ]
+      }
+    },
+    "service": {
+      "type": "array",
+      "description": "Service endpoints associated with this agent DID",
+      "items": {
+        "$ref": "#/definitions/ServiceEndpoint"
+      }
+    }
+  },
+  "additionalProperties": true,
+  "definitions": {
+    "VerificationMethod": {
+      "type": "object",
+      "description": "A cryptographic verification method (public key) per W3C DID Core",
+      "required": ["id", "type", "controller"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier for this verification method, typically DID + fragment",
+          "examples": ["did:web:openstandardagents.org:agents:my-agent#key-1"]
+        },
+        "type": {
+          "type": "string",
+          "description": "Cryptographic suite type",
+          "enum": [
+            "JsonWebKey2020",
+            "Ed25519VerificationKey2020",
+            "Ed25519VerificationKey2018",
+            "X25519KeyAgreementKey2020",
+            "X25519KeyAgreementKey2019",
+            "EcdsaSecp256k1VerificationKey2019",
+            "EcdsaSecp256r1VerificationKey2019",
+            "Multikey"
+          ]
+        },
+        "controller": {
+          "type": "string",
+          "description": "DID of the entity that controls this key",
+          "pattern": "^did:.+$"
+        },
+        "publicKeyJwk": {
+          "type": "object",
+          "description": "Public key in JWK format (RFC 7517)",
+          "properties": {
+            "kty": {
+              "type": "string",
+              "description": "Key type",
+              "enum": ["EC", "OKP", "RSA"]
+            },
+            "crv": {
+              "type": "string",
+              "description": "Curve name (for EC and OKP key types)",
+              "enum": ["Ed25519", "X25519", "P-256", "P-384", "P-521", "secp256k1"]
+            },
+            "x": {
+              "type": "string",
+              "description": "Public key x-coordinate (base64url-encoded)"
+            },
+            "y": {
+              "type": "string",
+              "description": "Public key y-coordinate (base64url-encoded, for EC keys)"
+            },
+            "kid": {
+              "type": "string",
+              "description": "Key identifier"
+            },
+            "use": {
+              "type": "string",
+              "description": "Intended use of the key",
+              "enum": ["sig", "enc"]
+            },
+            "alg": {
+              "type": "string",
+              "description": "Algorithm intended for use with this key"
+            }
+          },
+          "required": ["kty"],
+          "additionalProperties": true
+        },
+        "publicKeyMultibase": {
+          "type": "string",
+          "description": "Public key in multibase format (e.g., z-prefixed base58btc)",
+          "pattern": "^z[1-9A-HJ-NP-Za-km-z]+$"
+        },
+        "publicKeyBase58": {
+          "type": "string",
+          "description": "Public key in base58btc format (deprecated, use publicKeyMultibase)"
+        },
+        "blockchainAccountId": {
+          "type": "string",
+          "description": "CAIP-10 blockchain account identifier"
+        },
+        "revoked": {
+          "type": "boolean",
+          "description": "Whether this verification method has been revoked",
+          "default": false
+        }
+      },
+      "additionalProperties": true
+    },
+    "ServiceEndpoint": {
+      "type": "object",
+      "description": "A service endpoint associated with the agent DID",
+      "required": ["id", "type", "serviceEndpoint"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier for this service, typically DID + fragment",
+          "examples": ["did:web:openstandardagents.org:agents:my-agent#agent-endpoint"]
+        },
+        "type": {
+          "type": "string",
+          "description": "Service type identifier",
+          "examples": [
+            "OSSAAgentService",
+            "A2AService",
+            "MCPServerService",
+            "LinkedDomains",
+            "DIDCommMessaging",
+            "CredentialRegistry"
+          ]
+        },
+        "serviceEndpoint": {
+          "description": "The service endpoint URL(s)",
+          "oneOf": [
+            {
+              "type": "string",
+              "format": "uri"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "format": "uri"
+              }
+            },
+            {
+              "type": "object",
+              "description": "Structured endpoint with multiple properties",
+              "additionalProperties": true
+            }
+          ]
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of this service endpoint"
+        },
+        "routingKeys": {
+          "type": "array",
+          "description": "DIDComm routing keys for message encryption",
+          "items": { "type": "string" }
+        },
+        "accept": {
+          "type": "array",
+          "description": "Accepted media types or protocol versions",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/dist/spec/v0.4/extensions/kagent/README.md

@@ -30,7 +30,7 @@ extensions:
     kubernetes:
       namespace: production
       labels:
-        app: my-agent
+        app: creative-agent-naming
         team: platform
       resourceLimits:
         cpu: 1000m

package/dist/spec/v0.4/extensions/team/team.schema.json

@@ -0,0 +1,304 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.4/extensions/team.json",
+  "title": "OSSA Team Extension Schema",
+  "description": "Validates team/config.json generated by the TeamGeneratorService. Defines multi-agent team structure, coordination model, and deployment configuration for OSSA agent teams.",
+  "type": "object",
+  "required": ["name", "version", "pattern"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Team name, typically derived from the lead agent manifest metadata.name"
+    },
+    "version": {
+      "type": "string",
+      "description": "Team configuration version",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "examples": ["1.0.0"]
+    },
+    "pattern": {
+      "type": "string",
+      "description": "Multi-agent architecture pattern governing team coordination",
+      "enum": [
+        "single",
+        "swarm",
+        "pipeline",
+        "graph",
+        "hierarchical",
+        "reactive",
+        "cognitive",
+        "lead-teammate"
+      ]
+    },
+    "lead": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "null" }
+      ],
+      "description": "Name of the lead/orchestrator agent. Null when no explicit lead is designated."
+    },
+    "members": {
+      "type": "array",
+      "description": "Team member agent definitions",
+      "items": {
+        "$ref": "#/definitions/TeamMember"
+      }
+    },
+    "coordination": {
+      "$ref": "#/definitions/Coordination",
+      "description": "Task coordination and communication configuration"
+    },
+    "deployment": {
+      "$ref": "#/definitions/Deployment",
+      "description": "Deployment backend and scaling configuration"
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "TeamMember": {
+      "type": "object",
+      "description": "A single team member agent definition",
+      "required": ["name", "kind"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Unique agent name within the team"
+        },
+        "kind": {
+          "type": "string",
+          "description": "Agent kind/role classification within the team",
+          "examples": [
+            "team-lead",
+            "orchestrator",
+            "coordinator",
+            "teammate",
+            "worker",
+            "specialist",
+            "subagent",
+            "reviewer",
+            "planner",
+            "monitor",
+            "analyst"
+          ]
+        },
+        "role": {
+          "type": "string",
+          "description": "Human-readable role description or system prompt summary"
+        },
+        "contextIsolation": {
+          "type": "boolean",
+          "description": "Whether this agent operates with an independent context window (true) or shares context with lead (false)",
+          "default": true
+        },
+        "model": {
+          "type": "object",
+          "description": "LLM model configuration override for this member",
+          "properties": {
+            "provider": { "type": "string" },
+            "model": { "type": "string" },
+            "temperature": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 2
+            },
+            "maxTokens": {
+              "type": "integer",
+              "minimum": 1
+            }
+          },
+          "additionalProperties": true
+        },
+        "tools": {
+          "type": "array",
+          "description": "Tools available to this member",
+          "items": {
+            "oneOf": [
+              { "type": "string" },
+              {
+                "type": "object",
+                "properties": {
+                  "name": { "type": "string" },
+                  "description": { "type": "string" }
+                },
+                "required": ["name"]
+              }
+            ]
+          }
+        },
+        "handoffs": {
+          "type": "array",
+          "description": "Handoff targets for this member (swarm/graph patterns)",
+          "items": {
+            "type": "object",
+            "properties": {
+              "to": {
+                "type": "string",
+                "description": "Target agent name"
+              },
+              "condition": {
+                "type": "string",
+                "description": "Condition triggering the handoff",
+                "default": "any"
+              }
+            },
+            "required": ["to"],
+            "additionalProperties": true
+          }
+        },
+        "permissions": {
+          "type": "object",
+          "description": "Team-level permissions for this member",
+          "properties": {
+            "spawn": { "type": "boolean", "description": "Can spawn new agents" },
+            "shutdown": { "type": "boolean", "description": "Can shut down agents" },
+            "assignTasks": { "type": "boolean", "description": "Can assign tasks to others" },
+            "broadcast": { "type": "boolean", "description": "Can broadcast to all members" },
+            "modifyTeam": { "type": "boolean", "description": "Can modify team configuration" },
+            "approveWork": { "type": "boolean", "description": "Can approve completed work" },
+            "rejectWork": { "type": "boolean", "description": "Can reject completed work" },
+            "claimTasks": { "type": "boolean", "description": "Can self-claim tasks" },
+            "messagePeers": { "type": "boolean", "description": "Can message peer agents" },
+            "messageLeader": { "type": "boolean", "description": "Can message team lead" },
+            "reportToParent": { "type": "boolean", "description": "Can report to parent agent" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "Coordination": {
+      "type": "object",
+      "description": "Coordination model governing how team members interact and synchronize",
+      "properties": {
+        "taskModel": {
+          "type": "string",
+          "description": "Task coordination strategy",
+          "enum": [
+            "shared-list",
+            "self-claim",
+            "assigned",
+            "handoff",
+            "event-driven",
+            "pipeline"
+          ],
+          "default": "shared-list"
+        },
+        "communication": {
+          "type": "string",
+          "description": "Inter-agent communication pattern",
+          "enum": [
+            "mailbox",
+            "broadcast",
+            "direct",
+            "shared-file",
+            "report-to-parent",
+            "pub-sub",
+            "request-reply"
+          ],
+          "default": "mailbox"
+        },
+        "conflictResolution": {
+          "type": "string",
+          "description": "Strategy for resolving conflicts between agents",
+          "enum": [
+            "leader-decides",
+            "voting",
+            "priority-based",
+            "first-writer-wins",
+            "merge",
+            "escalate"
+          ],
+          "default": "leader-decides"
+        },
+        "taskPersistence": {
+          "type": "string",
+          "description": "How task state is persisted across agent restarts",
+          "enum": [
+            "in-memory",
+            "file-backed",
+            "database",
+            "distributed"
+          ],
+          "default": "file-backed"
+        },
+        "dependencyTracking": {
+          "type": "boolean",
+          "description": "Whether task dependencies (blocks/blockedBy) are tracked and enforced",
+          "default": true
+        },
+        "waveExecution": {
+          "type": "boolean",
+          "description": "Whether tasks are executed in dependency waves (all tasks in a wave start concurrently, next wave starts when current completes)",
+          "default": true
+        },
+        "lockingStrategy": {
+          "type": "string",
+          "description": "Concurrency control strategy for shared resources",
+          "enum": [
+            "none",
+            "file-lock",
+            "advisory-lock",
+            "optimistic",
+            "pessimistic",
+            "distributed-lock"
+          ],
+          "default": "file-lock"
+        }
+      },
+      "additionalProperties": false
+    },
+    "Deployment": {
+      "type": "object",
+      "description": "Deployment configuration for the agent team",
+      "properties": {
+        "backend": {
+          "type": "string",
+          "description": "Execution backend for agent processes",
+          "enum": [
+            "in-process",
+            "subprocess",
+            "docker",
+            "kubernetes",
+            "serverless",
+            "cloud-run",
+            "remote"
+          ],
+          "default": "in-process"
+        },
+        "scaling": {
+          "type": "string",
+          "description": "Scaling strategy for team members",
+          "enum": [
+            "fixed",
+            "auto",
+            "manual",
+            "event-driven",
+            "queue-based"
+          ],
+          "default": "fixed"
+        },
+        "minReplicas": {
+          "type": "integer",
+          "description": "Minimum number of agent replicas (for auto-scaling)",
+          "minimum": 0
+        },
+        "maxReplicas": {
+          "type": "integer",
+          "description": "Maximum number of agent replicas (for auto-scaling)",
+          "minimum": 1
+        },
+        "resources": {
+          "type": "object",
+          "description": "Resource constraints per agent process",
+          "properties": {
+            "cpu": { "type": "string", "description": "CPU limit (e.g., '500m', '2')" },
+            "memory": { "type": "string", "description": "Memory limit (e.g., '512Mi', '2Gi')" },
+            "gpu": { "type": "string", "description": "GPU requirement (e.g., 'nvidia-a100')" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}