@bluefly/openstandardagents 0.3.2 → 0.3.3

package/spec/v0.2.2/ossa-0.2.2.schema.json

@@ -1,906 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openstandardagents.org/schemas/v0.2.2/agent.json",
-  "title": "OSSA v0.2.2 Agent Manifest Schema",
-  "description": "Open Standard for Scalable AI Agents (OSSA) - The OpenAPI for AI Agents. Specification for declarative agent definition with framework-agnostic portability.",
-  "type": "object",
-  "required": [
-    "apiVersion",
-    "kind",
-    "metadata",
-    "spec"
-  ],
-  "properties": {
-    "apiVersion": {
-      "type": "string",
-      "pattern": "^ossa/v(0\\.2\\.2|1)(\\.[0-9]+)?(-[a-zA-Z0-9]+)?$",
-      "description": "OSSA API version (supports ossa/v0.2.2 or ossa/v1 for compatibility)",
-      "examples": [
-        "ossa/v1",
-        "ossa/v0.2.2",
-        "ossa/v1.0"
-      ]
-    },
-    "kind": {
-      "type": "string",
-      "enum": [
-        "Agent"
-      ],
-      "description": "Resource type - currently only 'Agent' is supported"
-    },
-    "metadata": {
-      "$ref": "#/definitions/Metadata"
-    },
-    "spec": {
-      "$ref": "#/definitions/AgentSpec"
-    },
-    "extensions": {
-      "type": "object",
-      "description": "Framework-specific extensions for integration with kagent, buildkit, drupal, librechat, mcp, and other frameworks",
-      "properties": {
-        "kagent": {
-          "$ref": "#/definitions/KAgentExtension"
-        },
-        "buildkit": {
-          "$ref": "#/definitions/BuildKitExtension"
-        },
-        "drupal": {
-          "$ref": "#/definitions/DrupalExtension"
-        },
-        "librechat": {
-          "$ref": "#/definitions/LibreChatExtension"
-        },
-        "mcp": {
-          "$ref": "#/definitions/MCPExtension"
-        },
-        "langchain": {
-          "$ref": "#/definitions/LangChainExtension"
-        },
-        "crewai": {
-          "$ref": "#/definitions/CrewAIExtension"
-        },
-        "openai_agents": {
-          "$ref": "#/definitions/OpenAIAgentsExtension"
-        }
-      },
-      "additionalProperties": true
-    }
-  },
-  "additionalProperties": false,
-  "definitions": {
-    "Metadata": {
-      "type": "object",
-      "required": [
-        "name"
-      ],
-      "properties": {
-        "name": {
-          "type": "string",
-          "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$",
-          "maxLength": 253,
-          "description": "Agent identifier (DNS-1123 subdomain format for Kubernetes compatibility)"
-        },
-        "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)"
-        },
-        "description": {
-          "type": "string",
-          "maxLength": 2000,
-          "description": "Human-readable description of agent purpose and capabilities"
-        },
-        "labels": {
-          "type": "object",
-          "additionalProperties": {
-            "type": "string",
-            "maxLength": 63
-          },
-          "description": "Key-value labels for organization and filtering"
-        },
-        "annotations": {
-          "type": "object",
-          "additionalProperties": {
-            "type": "string"
-          },
-          "description": "Arbitrary metadata for tooling (not used for filtering)"
-        }
-      },
-      "additionalProperties": false
-    },
-    "AgentSpec": {
-      "type": "object",
-      "required": [
-        "role"
-      ],
-      "properties": {
-        "taxonomy": {
-          "$ref": "#/definitions/Taxonomy"
-        },
-        "role": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Agent role/system prompt describing behavior and capabilities"
-        },
-        "llm": {
-          "$ref": "#/definitions/LLMConfig"
-        },
-        "tools": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/Tool"
-          },
-          "description": "Available tools/capabilities for the agent"
-        },
-        "autonomy": {
-          "$ref": "#/definitions/Autonomy"
-        },
-        "constraints": {
-          "$ref": "#/definitions/Constraints"
-        },
-        "observability": {
-          "$ref": "#/definitions/Observability"
-        }
-      },
-      "additionalProperties": true
-    },
-    "Taxonomy": {
-      "type": "object",
-      "required": [
-        "domain"
-      ],
-      "properties": {
-        "domain": {
-          "type": "string",
-          "description": "Primary domain classification",
-          "examples": [
-            "infrastructure",
-            "security",
-            "compliance",
-            "documentation"
-          ]
-        },
-        "subdomain": {
-          "type": "string",
-          "description": "Secondary classification within domain",
-          "examples": [
-            "kubernetes",
-            "vulnerability",
-            "generation"
-          ]
-        },
-        "capability": {
-          "type": "string",
-          "description": "Specific capability or function",
-          "examples": [
-            "troubleshooting",
-            "scanning",
-            "optimization"
-          ]
-        }
-      },
-      "additionalProperties": false
-    },
-    "LLMConfig": {
-      "type": "object",
-      "required": [
-        "provider",
-        "model"
-      ],
-      "properties": {
-        "provider": {
-          "type": "string",
-          "enum": [
-            "openai",
-            "anthropic",
-            "google",
-            "azure",
-            "ollama",
-            "custom"
-          ],
-          "description": "LLM provider"
-        },
-        "model": {
-          "type": "string",
-          "description": "Model identifier",
-          "examples": [
-            "gpt-4",
-            "claude-3-sonnet-20240229",
-            "gemini-pro"
-          ]
-        },
-        "temperature": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 2,
-          "description": "Sampling temperature for response generation"
-        },
-        "maxTokens": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "Maximum tokens per request"
-        },
-        "topP": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Nucleus sampling parameter"
-        },
-        "frequencyPenalty": {
-          "type": "number",
-          "minimum": -2,
-          "maximum": 2,
-          "description": "Frequency penalty for token generation"
-        },
-        "presencePenalty": {
-          "type": "number",
-          "minimum": -2,
-          "maximum": 2,
-          "description": "Presence penalty for token generation"
-        }
-      },
-      "additionalProperties": false
-    },
-    "Tool": {
-      "type": "object",
-      "required": [
-        "type"
-      ],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": [
-            "mcp",
-            "kubernetes",
-            "http",
-            "grpc",
-            "function",
-            "custom"
-          ],
-          "description": "Tool integration type"
-        },
-        "name": {
-          "type": "string",
-          "description": "Tool name/identifier"
-        },
-        "server": {
-          "type": "string",
-          "description": "MCP server name (for type=mcp)"
-        },
-        "namespace": {
-          "type": "string",
-          "description": "Kubernetes namespace (for type=kubernetes or mcp)"
-        },
-        "endpoint": {
-          "type": "string",
-          "format": "uri",
-          "description": "HTTP/gRPC endpoint (for type=http/grpc)"
-        },
-        "capabilities": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Specific capabilities/operations from this tool"
-        },
-        "config": {
-          "type": "object",
-          "description": "Tool-specific configuration",
-          "additionalProperties": true
-        },
-        "auth": {
-          "type": "object",
-          "properties": {
-            "type": {
-              "type": "string",
-              "enum": [
-                "bearer",
-                "oauth2",
-                "mtls",
-                "apikey",
-                "none"
-              ]
-            },
-            "credentials": {
-              "type": "string",
-              "description": "Reference to secret/credential (not the actual secret)"
-            }
-          }
-        }
-      },
-      "additionalProperties": false
-    },
-    "Autonomy": {
-      "type": "object",
-      "properties": {
-        "level": {
-          "type": "string",
-          "enum": [
-            "supervised",
-            "autonomous",
-            "fully_autonomous"
-          ],
-          "description": "Level of autonomy for agent decision-making"
-        },
-        "approval_required": {
-          "type": "boolean",
-          "description": "Whether human approval is required for actions"
-        },
-        "allowed_actions": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Whitelist of permitted actions"
-        },
-        "blocked_actions": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Blacklist of forbidden actions"
-        },
-        "escalation_policy": {
-          "type": "object",
-          "description": "Rules for escalating to human oversight"
-        }
-      },
-      "additionalProperties": false
-    },
-    "Constraints": {
-      "type": "object",
-      "properties": {
-        "cost": {
-          "type": "object",
-          "properties": {
-            "maxTokensPerDay": {
-              "type": "integer",
-              "minimum": 0
-            },
-            "maxTokensPerRequest": {
-              "type": "integer",
-              "minimum": 0
-            },
-            "maxCostPerDay": {
-              "type": "number",
-              "minimum": 0
-            },
-            "currency": {
-              "type": "string",
-              "pattern": "^[A-Z]{3}$",
-              "default": "USD"
-            }
-          }
-        },
-        "performance": {
-          "type": "object",
-          "properties": {
-            "maxLatencySeconds": {
-              "type": "number",
-              "minimum": 0
-            },
-            "maxConcurrentRequests": {
-              "type": "integer",
-              "minimum": 1
-            },
-            "timeoutSeconds": {
-              "type": "number",
-              "minimum": 0
-            }
-          }
-        },
-        "resources": {
-          "type": "object",
-          "properties": {
-            "cpu": {
-              "type": "string",
-              "description": "CPU limit (Kubernetes format: 100m, 1, 2.5)"
-            },
-            "memory": {
-              "type": "string",
-              "description": "Memory limit (Kubernetes format: 128Mi, 1Gi)"
-            },
-            "gpu": {
-              "type": "string",
-              "description": "GPU requirement"
-            }
-          }
-        }
-      },
-      "additionalProperties": false
-    },
-    "Observability": {
-      "type": "object",
-      "properties": {
-        "tracing": {
-          "type": "object",
-          "properties": {
-            "enabled": {
-              "type": "boolean",
-              "default": true
-            },
-            "exporter": {
-              "type": "string",
-              "enum": [
-                "otlp",
-                "jaeger",
-                "zipkin",
-                "custom"
-              ]
-            },
-            "endpoint": {
-              "type": "string",
-              "format": "uri"
-            }
-          }
-        },
-        "metrics": {
-          "type": "object",
-          "properties": {
-            "enabled": {
-              "type": "boolean",
-              "default": true
-            },
-            "exporter": {
-              "type": "string",
-              "enum": [
-                "prometheus",
-                "otlp",
-                "custom"
-              ]
-            },
-            "endpoint": {
-              "type": "string",
-              "format": "uri"
-            }
-          }
-        },
-        "logging": {
-          "type": "object",
-          "properties": {
-            "level": {
-              "type": "string",
-              "enum": [
-                "debug",
-                "info",
-                "warn",
-                "error"
-              ],
-              "default": "info"
-            },
-            "format": {
-              "type": "string",
-              "enum": [
-                "json",
-                "text"
-              ],
-              "default": "json"
-            }
-          }
-        }
-      },
-      "additionalProperties": false
-    },
-    "KAgentExtension": {
-      "type": "object",
-      "description": "kagent.dev Kubernetes-native agent deployment extension",
-      "properties": {
-        "kubernetes": {
-          "type": "object",
-          "properties": {
-            "namespace": {
-              "type": "string",
-              "default": "default",
-              "description": "Target Kubernetes namespace"
-            },
-            "labels": {
-              "type": "object",
-              "additionalProperties": {
-                "type": "string"
-              },
-              "description": "Kubernetes labels for agent CRD"
-            },
-            "annotations": {
-              "type": "object",
-              "additionalProperties": {
-                "type": "string"
-              },
-              "description": "Kubernetes annotations"
-            }
-          }
-        },
-        "deployment": {
-          "type": "object",
-          "properties": {
-            "replicas": {
-              "type": "integer",
-              "minimum": 1,
-              "default": 1
-            },
-            "strategy": {
-              "type": "string",
-              "enum": ["rolling-update", "recreate"],
-              "default": "rolling-update"
-            }
-          }
-        },
-        "api_version": {
-          "type": "string",
-          "description": "kagent.dev API version (e.g., kagent.dev/v1alpha2)",
-          "default": "kagent.dev/v1alpha2"
-        }
-      },
-      "additionalProperties": true
-    },
-    "BuildKitExtension": {
-      "type": "object",
-      "description": "Agent BuildKit deployment and orchestration extension",
-      "properties": {
-        "deployment": {
-          "type": "object",
-          "properties": {
-            "replicas": {
-              "type": "object",
-              "properties": {
-                "min": {
-                  "type": "integer",
-                  "default": 1
-                },
-                "max": {
-                  "type": "integer",
-                  "default": 4
-                }
-              }
-            }
-          }
-        },
-        "container": {
-          "type": "object",
-          "properties": {
-            "image": {
-              "type": "string",
-              "description": "Container image"
-            },
-            "runtime": {
-              "type": "string",
-              "enum": ["docker", "podman", "containerd"],
-              "default": "docker"
-            },
-            "resources": {
-              "type": "object",
-              "description": "Container resource limits"
-            }
-          }
-        }
-      },
-      "additionalProperties": true
-    },
-    "DrupalExtension": {
-      "type": "object",
-      "description": "Drupal LLM Platform integration extension",
-      "properties": {
-        "module": {
-          "type": "string",
-          "pattern": "^[a-z][a-z0-9_]*$",
-          "description": "Drupal module that owns this agent"
-        },
-        "service": {
-          "type": "string",
-          "pattern": "^[a-z][a-z0-9_]*\\.[a-z][a-z0-9_]*$",
-          "description": "Drupal service ID (module.service format)"
-        },
-        "dependencies": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[a-z][a-z0-9_]*$"
-          },
-          "description": "Required Drupal modules"
-        },
-        "database": {
-          "type": "object",
-          "properties": {
-            "tables": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            },
-            "migrations": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            }
-          }
-        }
-      },
-      "additionalProperties": true
-    },
-    "LibreChatExtension": {
-      "type": "object",
-      "description": "LibreChat integration extension",
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": true
-        },
-        "agent_id": {
-          "type": "string",
-          "description": "LibreChat agent identifier"
-        },
-        "endpoint": {
-          "type": "string",
-          "format": "uri",
-          "description": "LibreChat API endpoint"
-        },
-        "authentication": {
-          "type": "object",
-          "description": "LibreChat authentication configuration"
-        }
-      },
-      "additionalProperties": true
-    },
-    "MCPExtension": {
-      "type": "object",
-      "description": "Model Context Protocol (MCP) extension",
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": true
-        },
-        "server_type": {
-          "type": "string",
-          "enum": ["stdio", "sse", "websocket"],
-          "default": "stdio"
-        },
-        "server_name": {
-          "type": "string",
-          "description": "MCP server name"
-        },
-        "config": {
-          "type": "object",
-          "description": "MCP server configuration"
-        }
-      },
-      "additionalProperties": true
-    },
-    "LangChainExtension": {
-      "type": "object",
-      "description": "LangChain framework integration extension",
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        },
-        "tool_class": {
-          "type": "string",
-          "description": "LangChain tool class name"
-        },
-        "chain_type": {
-          "type": "string",
-          "enum": ["llm", "retrieval", "agent", "sequential", "custom"]
-        },
-        "memory": {
-          "type": "object",
-          "properties": {
-            "type": {
-              "type": "string",
-              "enum": ["buffer", "summary", "conversation", "vector"]
-            },
-            "max_tokens": {
-              "type": "integer"
-            }
-          }
-        }
-      },
-      "additionalProperties": true
-    },
-    "CrewAIExtension": {
-      "type": "object",
-      "description": "CrewAI framework integration extension",
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        },
-        "agent_type": {
-          "type": "string",
-          "enum": ["worker", "manager", "researcher", "analyst", "custom"]
-        },
-        "role": {
-          "type": "string",
-          "description": "CrewAI agent role"
-        },
-        "goal": {
-          "type": "string",
-          "description": "CrewAI agent goal"
-        },
-        "backstory": {
-          "type": "string",
-          "description": "CrewAI agent backstory"
-        },
-        "tools": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "CrewAI tool names"
-        }
-      },
-      "additionalProperties": true
-    },
-    "OpenAIAgentsExtension": {
-      "type": "object",
-      "description": "OpenAI Agents SDK integration extension",
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false,
-          "description": "Enable OpenAI Agents SDK bridge"
-        },
-        "agent_id": {
-          "type": "string",
-          "description": "OpenAI agent ID (optional, auto-generated if not provided)"
-        },
-        "instructions": {
-          "type": "string",
-          "description": "Agent instructions/prompt (overrides spec.role if provided)"
-        },
-        "model": {
-          "type": "string",
-          "enum": [
-            "gpt-4o",
-            "gpt-4o-mini",
-            "gpt-4-turbo",
-            "gpt-3.5-turbo"
-          ],
-          "default": "gpt-4o-mini",
-          "description": "OpenAI model to use for the agent"
-        },
-        "tools_mapping": {
-          "type": "array",
-          "description": "Map OSSA capabilities to OpenAI tools",
-          "items": {
-            "type": "object",
-            "required": [
-              "ossa_capability"
-            ],
-            "properties": {
-              "ossa_capability": {
-                "type": "string",
-                "description": "OSSA capability name to map"
-              },
-              "openai_tool_name": {
-                "type": "string",
-                "description": "OpenAI tool name (defaults to ossa_capability if not provided)"
-              },
-              "description": {
-                "type": "string",
-                "description": "Tool description (defaults to OSSA capability description)"
-              },
-              "parameters": {
-                "type": "object",
-                "description": "OpenAI tool parameter schema (auto-generated from OSSA input_schema if not provided)"
-              }
-            },
-            "additionalProperties": false
-          }
-        },
-        "sub_agents": {
-          "type": "array",
-          "description": "Sub-agent handoffs configuration",
-          "items": {
-            "type": "object",
-            "required": [
-              "agent_id",
-              "ossa_agent_ref"
-            ],
-            "properties": {
-              "agent_id": {
-                "type": "string",
-                "description": "OpenAI sub-agent identifier"
-              },
-              "ossa_agent_ref": {
-                "type": "string",
-                "description": "Reference to OSSA agent (metadata.name or agent ID)"
-              },
-              "handoff_conditions": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "Conditions that trigger handoff to this sub-agent"
-              },
-              "instructions": {
-                "type": "string",
-                "description": "Sub-agent specific instructions"
-              }
-            },
-            "additionalProperties": false
-          }
-        },
-        "guardrails": {
-          "type": "object",
-          "description": "Safety guardrails configuration",
-          "properties": {
-            "enabled": {
-              "type": "boolean",
-              "default": true
-            },
-            "policies": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "Guardrail policy names (maps to OSSA compliance frameworks)"
-            },
-            "max_tool_calls": {
-              "type": "integer",
-              "minimum": 1,
-              "description": "Maximum tool calls per agent execution"
-            },
-            "timeout_seconds": {
-              "type": "integer",
-              "minimum": 1,
-              "description": "Maximum execution time in seconds"
-            }
-          },
-          "additionalProperties": false
-        },
-        "memory": {
-          "type": "object",
-          "description": "Session memory configuration",
-          "properties": {
-            "enabled": {
-              "type": "boolean",
-              "default": false
-            },
-            "type": {
-              "type": "string",
-              "enum": [
-                "session",
-                "persistent"
-              ],
-              "default": "session",
-              "description": "Memory storage type"
-            },
-            "max_messages": {
-              "type": "integer",
-              "minimum": 1,
-              "description": "Maximum messages to retain in memory"
-            }
-          },
-          "additionalProperties": false
-        },
-        "tracing": {
-          "type": "object",
-          "description": "Observability and tracing configuration",
-          "properties": {
-            "enabled": {
-              "type": "boolean",
-              "default": true
-            },
-            "provider": {
-              "type": "string",
-              "enum": [
-                "langfuse",
-                "langsmith",
-                "custom"
-              ],
-              "default": "langfuse",
-              "description": "Tracing provider"
-            },
-            "endpoint": {
-              "type": "string",
-              "format": "uri",
-              "description": "Custom tracing endpoint (for provider=custom)"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": true
-    }
-  }
-}