@bluefly/openstandardagents 0.2.9 → 0.3.0

package/dist/spec/schema/agent-test.schema.json

@@ -0,0 +1,117 @@
+{
+  "$id": "https://ossa.dev/schema/agent-test.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSSA AgentTest Resource",
+  "description": "Test definition for OSSA agents",
+  "type": "object",
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "const": "ossa/v0.3.0"
+    },
+    "kind": {
+      "type": "string",
+      "const": "AgentTest"
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string" },
+        "version": { "type": "string" },
+        "description": { "type": "string" }
+      },
+      "required": ["name"]
+    },
+    "spec": {
+      "type": "object",
+      "properties": {
+        "target": {
+          "type": "object",
+          "description": "Target agent to test",
+          "properties": {
+            "agent": { "type": "string", "description": "Agent name or path" },
+            "version": { "type": "string", "description": "Agent version to test" }
+          },
+          "required": ["agent"]
+        },
+        "scenarios": {
+          "type": "array",
+          "description": "Test scenarios",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "description": { "type": "string" },
+              "input": {
+                "type": "object",
+                "description": "Input to provide to the agent"
+              },
+              "expected": {
+                "type": "object",
+                "properties": {
+                  "output": { "type": "object" },
+                  "tools_called": {
+                    "type": "array",
+                    "items": { "type": "string" }
+                  },
+                  "max_latency_ms": { "type": "integer" },
+                  "max_tokens": { "type": "integer" },
+                  "max_turns": { "type": "integer" }
+                }
+              },
+              "assertions": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": ["contains", "equals", "matches", "tool_called", "not_contains", "json_path"]
+                    },
+                    "path": { "type": "string" },
+                    "value": {},
+                    "message": { "type": "string" }
+                  },
+                  "required": ["type"]
+                }
+              },
+              "mocks": {
+                "type": "object",
+                "description": "Mock tool responses",
+                "additionalProperties": true
+              }
+            },
+            "required": ["name", "input"]
+          }
+        },
+        "config": {
+          "type": "object",
+          "properties": {
+            "timeout_seconds": { "type": "integer", "default": 60 },
+            "retries": { "type": "integer", "default": 0 },
+            "parallel": { "type": "boolean", "default": false },
+            "fail_fast": { "type": "boolean", "default": true },
+            "record": { "type": "boolean", "default": false, "description": "Record interactions for replay" }
+          }
+        },
+        "setup": {
+          "type": "object",
+          "description": "Test setup configuration",
+          "properties": {
+            "env": { "type": "object", "additionalProperties": { "type": "string" } },
+            "fixtures": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "teardown": {
+          "type": "object",
+          "description": "Test teardown configuration",
+          "properties": {
+            "cleanup": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      },
+      "required": ["target", "scenarios"]
+    }
+  },
+  "required": ["apiVersion", "kind", "metadata", "spec"]
+}

package/dist/spec/schema/components/activity-stream.schema.json

@@ -0,0 +1,94 @@
+{
+  "$id": "https://ossa.dev/schema/components/activity-stream.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSSA Activity Stream Configuration",
+  "description": "Activity stream settings for agent observability",
+  "type": "object",
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "description": "Enable activity stream publishing"
+    },
+    "format": {
+      "type": "string",
+      "enum": ["activity-streams-2.0", "json", "cloudevents"],
+      "default": "activity-streams-2.0",
+      "description": "Activity stream format"
+    },
+    "sink": {
+      "type": "object",
+      "description": "Event sink configuration",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["webhook", "kafka", "pubsub", "redis", "stdout"],
+          "description": "Sink type"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Webhook URL or connection string"
+        },
+        "topic": {
+          "type": "string",
+          "description": "Topic or channel name"
+        },
+        "batch_size": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 100,
+          "description": "Batch size for event delivery"
+        },
+        "flush_interval_ms": {
+          "type": "integer",
+          "minimum": 100,
+          "default": 5000,
+          "description": "Flush interval in milliseconds"
+        }
+      },
+      "required": ["type"]
+    },
+    "events": {
+      "type": "object",
+      "description": "Event filtering",
+      "properties": {
+        "include": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Event types to include"
+        },
+        "exclude": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Event types to exclude"
+        }
+      }
+    },
+    "enrichment": {
+      "type": "object",
+      "description": "Event enrichment settings",
+      "properties": {
+        "add_trace_context": {
+          "type": "boolean",
+          "default": true,
+          "description": "Include W3C trace context"
+        },
+        "add_agent_metadata": {
+          "type": "boolean",
+          "default": true,
+          "description": "Include agent metadata"
+        },
+        "add_timestamp": {
+          "type": "boolean",
+          "default": true
+        },
+        "custom_attributes": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/spec/schema/components/constraints.schema.json

@@ -0,0 +1,84 @@
+{
+  "$id": "https://ossa.dev/schema/components/constraints.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSSA Constraints Component",
+  "description": "Reusable constraints block for OSSA resources",
+  "type": "object",
+  "properties": {
+    "performance": {
+      "type": "object",
+      "properties": {
+        "maxLatencySeconds": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Maximum acceptable latency in seconds"
+        },
+        "timeoutSeconds": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Request timeout in seconds"
+        },
+        "maxConcurrency": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum concurrent executions"
+        }
+      }
+    },
+    "cost": {
+      "type": "object",
+      "properties": {
+        "maxTokensPerRequest": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum tokens per request"
+        },
+        "maxTokensPerDay": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Daily token budget"
+        },
+        "maxCostPerRequest": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Maximum cost per request in USD"
+        }
+      }
+    },
+    "safety": {
+      "type": "object",
+      "properties": {
+        "maxTurns": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum conversation turns"
+        },
+        "maxToolCalls": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Maximum tool calls per turn"
+        },
+        "requireHumanApproval": {
+          "type": "boolean",
+          "description": "Require human approval for actions"
+        }
+      }
+    },
+    "resources": {
+      "type": "object",
+      "properties": {
+        "maxMemoryMB": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum memory in megabytes"
+        },
+        "maxCpuCores": {
+          "type": "number",
+          "minimum": 0.1,
+          "description": "Maximum CPU cores"
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/spec/schema/components/dependencies.schema.json

@@ -0,0 +1,147 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.3.0/components/dependencies.json",
+  "title": "Agent Dependencies Schema",
+  "description": "Declares dependencies on other agents, services, and MCP servers for multi-agent orchestration",
+  "type": "object",
+  "properties": {
+    "agents": {
+      "type": "array",
+      "description": "Dependencies on other OSSA agents",
+      "items": {
+        "$ref": "#/definitions/AgentDependency"
+      }
+    },
+    "services": {
+      "type": "array",
+      "description": "Dependencies on external services (APIs, databases, etc.)",
+      "items": {
+        "$ref": "#/definitions/ServiceDependency"
+      }
+    },
+    "mcp": {
+      "type": "array",
+      "description": "Dependencies on Model Context Protocol servers",
+      "items": {
+        "$ref": "#/definitions/MCPDependency"
+      }
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "AgentDependency": {
+      "type": "object",
+      "required": ["name", "version", "required"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$",
+          "maxLength": 253,
+          "description": "Agent name (must match metadata.name in target agent manifest)"
+        },
+        "version": {
+          "type": "string",
+          "description": "Semantic version constraint (npm semver format: ^1.2.0, >=1.0.0 <2.0.0, *)",
+          "examples": ["^1.2.0", ">=2.0.0 <3.0.0", "*", "~1.5.0"]
+        },
+        "required": {
+          "type": "boolean",
+          "description": "Whether this dependency is required (true) or optional (false)"
+        },
+        "reason": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "Human-readable explanation of why this dependency exists"
+        },
+        "contract": {
+          "type": "object",
+          "description": "Expected contract (events, commands) from the dependency",
+          "properties": {
+            "publishes": {
+              "type": "array",
+              "description": "Events this agent expects the dependency to publish",
+              "items": {
+                "type": "string",
+                "description": "Channel name (e.g., security.vulnerability.detected)"
+              }
+            },
+            "commands": {
+              "type": "array",
+              "description": "Commands this agent expects the dependency to expose",
+              "items": {
+                "type": "string",
+                "description": "Command name (e.g., fix_vulnerability)"
+              }
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "ServiceDependency": {
+      "type": "object",
+      "required": ["name", "required"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Service name (e.g., gitlab-api, prometheus, postgresql)"
+        },
+        "version": {
+          "type": "string",
+          "description": "Service version or API version (e.g., v4, >=2.0)"
+        },
+        "endpoint": {
+          "type": "string",
+          "description": "Service endpoint URL (can use environment variable substitution: ${GITLAB_API_URL})"
+        },
+        "required": {
+          "type": "boolean",
+          "description": "Whether this service dependency is required"
+        },
+        "reason": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "Human-readable explanation of why this service is needed"
+        }
+      },
+      "additionalProperties": false
+    },
+    "MCPDependency": {
+      "type": "object",
+      "required": ["name", "required"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "MCP server name (e.g., jira-mcp, slack-mcp)"
+        },
+        "version": {
+          "type": "string",
+          "description": "MCP server version constraint (semver format)"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "MCP server URL (can use environment variable substitution)"
+        },
+        "required": {
+          "type": "boolean",
+          "description": "Whether this MCP server is required"
+        },
+        "tools": {
+          "type": "array",
+          "description": "List of MCP tools this agent uses from this server",
+          "items": {
+            "type": "string",
+            "description": "Tool name (e.g., getJiraIssue, createSlackMessage)"
+          }
+        },
+        "reason": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "Human-readable explanation of why this MCP server is needed"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/dist/spec/schema/components/encryption.schema.json

@@ -0,0 +1,115 @@
+{
+  "$id": "https://ossa.dev/schema/components/encryption.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSSA Encryption Configuration",
+  "description": "Encryption settings for agent state storage",
+  "type": "object",
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "default": false,
+      "description": "Enable encryption for state storage"
+    },
+    "algorithm": {
+      "type": "string",
+      "enum": ["AES-256-GCM", "AES-256-CBC", "ChaCha20-Poly1305"],
+      "default": "AES-256-GCM",
+      "description": "Encryption algorithm"
+    },
+    "key_management": {
+      "type": "object",
+      "description": "Key management configuration",
+      "properties": {
+        "provider": {
+          "type": "string",
+          "enum": ["vault", "aws-kms", "gcp-kms", "azure-keyvault", "local"],
+          "description": "Key management provider"
+        },
+        "key_id": {
+          "type": "string",
+          "description": "Key identifier in the provider"
+        },
+        "key_version": {
+          "type": "string",
+          "description": "Specific key version to use"
+        },
+        "rotation_days": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 90,
+          "description": "Key rotation interval in days"
+        },
+        "auto_rotate": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable automatic key rotation"
+        }
+      },
+      "required": ["provider"]
+    },
+    "at_rest": {
+      "type": "object",
+      "description": "Encryption at rest settings",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable encryption at rest"
+        },
+        "scope": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["state", "logs", "artifacts", "all"]
+          },
+          "default": ["state"],
+          "description": "What data to encrypt at rest"
+        }
+      }
+    },
+    "in_transit": {
+      "type": "object",
+      "description": "Encryption in transit settings",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable encryption in transit"
+        },
+        "tls_version": {
+          "type": "string",
+          "enum": ["1.2", "1.3"],
+          "default": "1.3",
+          "description": "Minimum TLS version"
+        },
+        "verify_certificates": {
+          "type": "boolean",
+          "default": true,
+          "description": "Verify TLS certificates"
+        },
+        "client_cert_required": {
+          "type": "boolean",
+          "default": false,
+          "description": "Require client certificates (mTLS)"
+        }
+      }
+    },
+    "compliance": {
+      "type": "object",
+      "description": "Compliance-related encryption settings",
+      "properties": {
+        "fips_mode": {
+          "type": "boolean",
+          "default": false,
+          "description": "Use FIPS 140-2 compliant algorithms"
+        },
+        "audit_logging": {
+          "type": "boolean",
+          "default": true,
+          "description": "Log encryption operations"
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/spec/schema/components/identity.schema.json

@@ -0,0 +1,48 @@
+{
+  "$id": "https://ossa.dev/schema/components/identity.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSSA Identity Component",
+  "description": "Reusable identity block for OSSA agent instances",
+  "type": "object",
+  "properties": {
+    "instance_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Unique identifier for this agent instance"
+    },
+    "interaction_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Unique identifier for this interaction/session"
+    },
+    "parent_instance_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Parent agent instance ID for multi-agent scenarios"
+    },
+    "workflow_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Workflow execution ID"
+    },
+    "trace_id": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{32}$",
+      "description": "W3C Trace ID for distributed tracing"
+    },
+    "span_id": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{16}$",
+      "description": "W3C Span ID for distributed tracing"
+    },
+    "tenant_id": {
+      "type": "string",
+      "description": "Multi-tenant environment identifier"
+    },
+    "user_id": {
+      "type": "string",
+      "description": "Initiating user identifier"
+    }
+  },
+  "additionalProperties": false
+}

package/dist/spec/schema/components/index.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSSA Schema Components Index",
+  "description": "Index of reusable OSSA schema components",
+  "components": [
+    {
+      "name": "metadata",
+      "schema": "https://ossa.dev/schema/components/metadata.schema.json",
+      "file": "metadata.schema.json",
+      "description": "Reusable metadata block for OSSA resources"
+    },
+    {
+      "name": "tool",
+      "schema": "https://ossa.dev/schema/components/tool.schema.json",
+      "file": "tool.schema.json",
+      "description": "Reusable tool definition for OSSA agents"
+    },
+    {
+      "name": "llm-config",
+      "schema": "https://ossa.dev/schema/components/llm-config.schema.json",
+      "file": "llm-config.schema.json",
+      "description": "Reusable LLM configuration for OSSA agents"
+    },
+    {
+      "name": "constraints",
+      "schema": "https://ossa.dev/schema/components/constraints.schema.json",
+      "file": "constraints.schema.json",
+      "description": "Reusable constraints block for OSSA resources"
+    },
+    {
+      "name": "identity",
+      "schema": "https://ossa.dev/schema/components/identity.schema.json",
+      "file": "identity.schema.json",
+      "description": "Reusable identity block for OSSA agent instances"
+    }
+  ]
+}