@bluefly/openstandardagents 0.2.4 → 0.2.7

package/spec/v0.2.1/ossa-0.2.1.schema.json

@@ -0,0 +1,555 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://ossa.io/schemas/0.2.1/agent.json",
+  "title": "OSSA 0.2.1 Agent Schema",
+  "description": "Formal JSON Schema for OSSA (Open Standard for Smart & Scalable Agents) version 1.0. The OpenAPI for AI Agents.",
+  "type": "object",
+  "required": ["ossaVersion", "agent"],
+  "properties": {
+    "ossaVersion": {
+      "type": "string",
+      "enum": ["0.2.1"],
+      "description": "OSSA specification version"
+    },
+    "agent": {
+      "type": "object",
+      "required": ["id", "name", "version", "role", "runtime", "capabilities"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$",
+          "maxLength": 63,
+          "description": "Unique agent identifier (DNS-1123 subdomain format)",
+          "examples": ["compliance-scanner", "chat-bot-v1", "workflow-orchestrator"]
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200,
+          "description": "Human-readable agent name",
+          "examples": ["Compliance Scanner", "Customer Support Chat Bot"]
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
+          "description": "Semantic version (semver 2.0.0)",
+          "examples": ["1.0.0", "2.1.3-beta.1"]
+        },
+        "description": {
+          "type": "string",
+          "description": "Agent purpose and capabilities description"
+        },
+        "role": {
+          "type": "string",
+          "enum": [
+            "compliance",
+            "chat",
+            "orchestration",
+            "audit",
+            "workflow",
+            "monitoring",
+            "data_processing",
+            "integration",
+            "development",
+            "custom"
+          ],
+          "description": "Primary agent role/purpose"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Searchable tags for discovery",
+          "examples": [["security", "fedramp", "compliance"]]
+        },
+        "runtime": {
+          "type": "object",
+          "required": ["type"],
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": ["docker", "k8s", "local", "serverless", "edge"],
+              "description": "Runtime environment type"
+            },
+            "image": {
+              "type": "string",
+              "description": "Container image (for docker/k8s)",
+              "examples": ["ossa/compliance-scanner:1.0.0"]
+            },
+            "command": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Entrypoint command (for local)"
+            },
+            "requirements": {
+              "type": "object",
+              "properties": {
+                "python": {
+                  "type": "string",
+                  "description": "Python version requirement"
+                },
+                "node": {
+                  "type": "string",
+                  "description": "Node.js version requirement"
+                },
+                "packages": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Required packages"
+                }
+              },
+              "additionalProperties": true
+            },
+            "resources": {
+              "type": "object",
+              "properties": {
+                "cpu": {
+                  "type": "string",
+                  "description": "CPU request (Kubernetes format)",
+                  "examples": ["500m", "1000m", "2"]
+                },
+                "memory": {
+                  "type": "string",
+                  "description": "Memory request (Kubernetes format)",
+                  "examples": ["256Mi", "512Mi", "1Gi"]
+                },
+                "gpu": {
+                  "type": "boolean",
+                  "description": "GPU required"
+                }
+              }
+            },
+            "health_check": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "enum": ["http", "tcp", "exec"],
+                  "description": "Health check type"
+                },
+                "endpoint": {
+                  "type": "string",
+                  "description": "HTTP endpoint for health check",
+                  "examples": ["/health", "/api/v1/health"]
+                },
+                "port": {
+                  "type": "integer",
+                  "description": "TCP port for health check"
+                },
+                "command": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Command to execute for health check"
+                },
+                "initial_delay_seconds": {
+                  "type": "integer",
+                  "default": 30
+                },
+                "period_seconds": {
+                  "type": "integer",
+                  "default": 10
+                },
+                "timeout_seconds": {
+                  "type": "integer",
+                  "default": 5
+                },
+                "failure_threshold": {
+                  "type": "integer",
+                  "default": 3
+                }
+              }
+            }
+          }
+        },
+        "capabilities": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["name", "description", "input_schema", "output_schema"],
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Capability name (like OpenAPI operationId)"
+              },
+              "description": {
+                "type": "string",
+                "description": "What this capability does"
+              },
+              "input_schema": {
+                "oneOf": [
+                  {
+                    "type": "object",
+                    "description": "JSON Schema for input"
+                  },
+                  {
+                    "type": "string",
+                    "format": "uri",
+                    "description": "Reference to external schema (OpenAPI path)"
+                  }
+                ]
+              },
+              "output_schema": {
+                "oneOf": [
+                  {
+                    "type": "object",
+                    "description": "JSON Schema for output"
+                  },
+                  {
+                    "type": "string",
+                    "format": "uri",
+                    "description": "Reference to external schema"
+                  }
+                ]
+              },
+              "examples": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "type": "string"
+                    },
+                    "input": {
+                      "type": "object"
+                    },
+                    "output": {
+                      "type": "object"
+                    }
+                  }
+                }
+              },
+              "timeout_seconds": {
+                "type": "integer",
+                "default": 300,
+                "description": "Maximum execution time"
+              },
+              "retry_policy": {
+                "type": "object",
+                "properties": {
+                  "max_attempts": {
+                    "type": "integer",
+                    "default": 3
+                  },
+                  "backoff": {
+                    "type": "string",
+                    "enum": ["linear", "exponential"],
+                    "default": "exponential"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "policies": {
+          "type": "object",
+          "description": "Compliance and policy configuration",
+          "properties": {
+            "compliance": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "fedramp-low",
+                  "fedramp-moderate",
+                  "fedramp-high",
+                  "iso27001",
+                  "soc2-type1",
+                  "soc2-type2",
+                  "hipaa",
+                  "gdpr",
+                  "pci-dss",
+                  "nist-800-53",
+                  "iso42001",
+                  "eu-ai-act"
+                ]
+              },
+              "description": "Compliance frameworks this agent adheres to"
+            },
+            "data_residency": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Geographic restrictions (ISO 3166-1 alpha-2 codes)",
+              "examples": [["US", "CA"], ["EU"], ["US-GOV"]]
+            },
+            "encryption": {
+              "type": "boolean",
+              "default": true,
+              "description": "Require encryption in transit and at rest"
+            },
+            "audit": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable comprehensive audit logging"
+            },
+            "pii_handling": {
+              "type": "string",
+              "enum": ["none", "anonymize", "encrypt", "prohibit"],
+              "default": "none",
+              "description": "How to handle PII data"
+            }
+          }
+        },
+        "integration": {
+          "type": "object",
+          "description": "Integration and communication configuration",
+          "properties": {
+            "protocol": {
+              "type": "string",
+              "enum": ["http", "grpc", "mcp", "websocket"],
+              "default": "http",
+              "description": "Primary communication protocol"
+            },
+            "endpoints": {
+              "type": "object",
+              "properties": {
+                "base_url": {
+                  "type": "string",
+                  "format": "uri"
+                },
+                "health": {
+                  "type": "string",
+                  "default": "/health"
+                },
+                "metrics": {
+                  "type": "string",
+                  "default": "/metrics"
+                },
+                "openapi": {
+                  "type": "string",
+                  "description": "Path to OpenAPI specification"
+                }
+              }
+            },
+            "auth": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "enum": ["none", "api_key", "jwt", "oauth2", "mtls"],
+                  "default": "jwt"
+                },
+                "config": {
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              }
+            },
+            "rate_limits": {
+              "type": "object",
+              "properties": {
+                "requests_per_second": {
+                  "type": "integer"
+                },
+                "requests_per_minute": {
+                  "type": "integer"
+                },
+                "burst": {
+                  "type": "integer"
+                }
+              }
+            }
+          }
+        },
+        "monitoring": {
+          "type": "object",
+          "description": "Observability configuration",
+          "properties": {
+            "traces": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable OpenTelemetry tracing"
+            },
+            "metrics": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable Prometheus metrics"
+            },
+            "logs": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable structured logging"
+            },
+            "health_check": {
+              "type": "string",
+              "format": "uri",
+              "description": "Health check endpoint URL",
+              "examples": ["http://localhost:3100/health"]
+            },
+            "phoenix_arise": {
+              "type": "object",
+              "description": "Phoenix Arise integration",
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "export_interval_seconds": {
+                  "type": "integer",
+                  "default": 60
+                }
+              }
+            }
+          }
+        },
+        "dependencies": {
+          "type": "object",
+          "description": "Dependencies on other OSSA agents",
+          "properties": {
+            "required": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["agent_id", "min_version"],
+                "properties": {
+                  "agent_id": {
+                    "type": "string"
+                  },
+                  "min_version": {
+                    "type": "string"
+                  },
+                  "max_version": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            "optional": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "agent_id": {
+                    "type": "string"
+                  },
+                  "fallback": {
+                    "type": "string",
+                    "description": "Fallback behavior if not available"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Additional metadata for discovery and management",
+          "properties": {
+            "author": {
+              "type": "string"
+            },
+            "maintainer": {
+              "type": "string"
+            },
+            "homepage": {
+              "type": "string",
+              "format": "uri"
+            },
+            "repository": {
+              "type": "string",
+              "format": "uri"
+            },
+            "documentation": {
+              "type": "string",
+              "format": "uri"
+            },
+            "license": {
+              "type": "string",
+              "examples": ["MIT", "Apache-2.0", "GPL-3.0"]
+            },
+            "keywords": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": true
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "ossaVersion": "0.2.1",
+      "agent": {
+        "id": "compliance-scanner-v1",
+        "name": "FedRAMP Compliance Scanner",
+        "version": "1.0.0",
+        "description": "Automated compliance scanning for FedRAMP environments",
+        "role": "compliance",
+        "tags": ["security", "fedramp", "compliance"],
+        "runtime": {
+          "type": "k8s",
+          "image": "ossa/compliance-scanner:1.0.0",
+          "resources": {
+            "cpu": "500m",
+            "memory": "512Mi"
+          },
+          "health_check": {
+            "type": "http",
+            "endpoint": "/health",
+            "port": 3000
+          }
+        },
+        "capabilities": [
+          {
+            "name": "scan_security_vulnerabilities",
+            "description": "Scan codebase for security vulnerabilities",
+            "input_schema": {
+              "type": "object",
+              "properties": {
+                "repository": {"type": "string"},
+                "branch": {"type": "string", "default": "main"}
+              }
+            },
+            "output_schema": {
+              "type": "object",
+              "properties": {
+                "vulnerabilities": {
+                  "type": "array",
+                  "items": {"type": "object"}
+                },
+                "severity_counts": {"type": "object"}
+              }
+            }
+          }
+        ],
+        "policies": {
+          "compliance": ["fedramp-moderate", "soc2-type2"],
+          "data_residency": ["US"],
+          "encryption": true,
+          "audit": true
+        },
+        "integration": {
+          "protocol": "http",
+          "endpoints": {
+            "base_url": "http://compliance-scanner:3000",
+            "health": "/health",
+            "metrics": "/metrics"
+          },
+          "auth": {
+            "type": "jwt"
+          }
+        },
+        "monitoring": {
+          "traces": true,
+          "metrics": true,
+          "logs": true,
+          "health_check": "http://localhost:3000/health"
+        }
+      }
+    }
+  ]
+}

package/spec/v0.2.3/CHANGELOG.md

@@ -93,7 +93,7 @@ All kagent examples updated with:
 ```yaml
 # Both versions work identically
 apiVersion: ossa/v0.2.2  # Still valid
-apiVersion: ossa/v0.2.3  # Recommended
+apiVersion: ossa/v0.2.4  # Recommended
 ```
 
 ### Recommended Changes
@@ -107,12 +107,12 @@ See [migrations/v0.2.2-to-v0.2.3.md](migrations/v0.2.2-to-v0.2.3.md) for detaile
 
 ### npm (Recommended)
 ```bash
-npm install -g @bluefly/open-standards-scalable-agents@0.2.3
+npm install -g @bluefly/openstandardagents@0.2.3
 ```
 
 ### GitLab Package Registry
 ```bash
-npm install --registry=https://gitlab.bluefly.io/api/v4/projects/PROJECT_ID/packages/npm/ @bluefly/open-standards-scalable-agents@0.2.3
+npm install @bluefly/openstandardagents@0.2.3
 ```
 
 ### Verify Installation
@@ -163,9 +163,9 @@ ossa --version
 
 ## Support
 
-- **Documentation**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/wikis/home
-- **Issues**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/issues
-- **Examples**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/tree/main/examples
+- **Documentation**: https://github.com/blueflyio/openstandardagents
+- **Issues**: https://github.com/blueflyio/openstandardagents/issues
+- **Examples**: https://github.com/blueflyio/openstandardagents/tree/main/examples
 
 ## Acknowledgments
 
@@ -173,4 +173,4 @@ Special thanks to the OSSA community for feedback and contributions!
 
 ---
 
-**Full Changelog**: [v0.2.2...v0.2.3](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/compare/v0.2.2...v0.2.3)
+**Full Changelog**: [v0.2.2...v0.2.3](https://github.com/blueflyio/openstandardagents/compare/v0.2.2...v0.2.3)

package/spec/v0.2.3/README.md

@@ -20,11 +20,11 @@ OSSA is to AI agents what OpenAPI is to REST APIs:
 ## API Version
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.4
 ```
 
 The schema accepts:
-- `ossa/v0.2.3` (recommended)
+- `ossa/v0.2.4` (recommended)
 - `ossa/v0.2.2` (backward compatible)
 - `ossa/v1` (forward compatible)
 
@@ -33,7 +33,7 @@ The schema accepts:
 ### Kubernetes-Style Manifest
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.4
 kind: Agent
 metadata:
   name: my-agent
@@ -86,7 +86,7 @@ Simply update your `apiVersion` field:
 apiVersion: ossa/v0.2.2
 
 # After (v0.2.3)
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.4
 ```
 
 Both versions are accepted by the same schema. See [migrations/v0.2.2-to-v0.2.3.md](migrations/v0.2.2-to-v0.2.3.md) for details.
@@ -121,7 +121,7 @@ Validate your manifests using the OSSA CLI:
 
 ```bash
 # Install
-npm install -g @bluefly/open-standards-scalable-agents
+npm install -g @bluefly/openstandardagents
 
 # Validate
 ossa validate my-agent.ossa.yaml
@@ -132,10 +132,10 @@ ossa generate my-new-agent --type worker
 
 ## Resources
 
-- **Main Docs**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/wikis/home
-- **Examples**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/tree/main/examples
-- **Migration Guides**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/wikis/Migration-Guides
-- **OpenAPI Extensions**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/wikis/OpenAPI-Extensions
+- **Main Docs**: https://github.com/blueflyio/openstandardagents
+- **Examples**: https://github.com/blueflyio/openstandardagents/tree/main/examples
+- **Migration Guides**: https://github.com/blueflyio/openstandardagents/tree/main/spec
+- **OpenAPI Extensions**: https://github.com/blueflyio/openstandardagents/tree/main/docs
 
 ## Compatibility Matrix