@bluefly/openstandardagents 0.3.2 → 0.3.5

package/spec/v0.3/flow-kind.schema.json

@@ -0,0 +1,244 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.3.5/flow-kind.json",
+  "title": "OSSA v0.3.5 Flow Kind Specification",
+  "description": "Flow-based orchestration for multi-agent workflows",
+  "type": "object",
+  "definitions": {
+    "FlowState": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$"
+        },
+        "description": {
+          "type": "string"
+        },
+        "entry_action": {
+          "type": "string",
+          "description": "Action to execute on state entry"
+        },
+        "exit_action": {
+          "type": "string",
+          "description": "Action to execute on state exit"
+        }
+      }
+    },
+    "FlowTransition": {
+      "type": "object",
+      "required": ["from", "to", "trigger"],
+      "properties": {
+        "from": {
+          "type": "string",
+          "description": "Source state name"
+        },
+        "to": {
+          "type": "string",
+          "description": "Target state name"
+        },
+        "trigger": {
+          "type": "object",
+          "required": ["type"],
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": ["webhook", "agent_signal", "timer", "condition"]
+            },
+            "event": {
+              "type": "string",
+              "description": "Event name (for webhook/agent_signal)"
+            },
+            "agent": {
+              "type": "string",
+              "description": "Agent ID (for agent_signal)"
+            },
+            "signal": {
+              "type": "string",
+              "enum": ["continue", "complete", "blocked", "escalate", "checkpoint"]
+            },
+            "interval": {
+              "type": "string",
+              "description": "Timer interval (for timer type)"
+            },
+            "condition_expression": {
+              "type": "string",
+              "description": "Condition expression (for condition type)"
+            }
+          }
+        },
+        "condition": {
+          "type": "string",
+          "description": "Optional condition expression"
+        }
+      }
+    },
+    "FlowEvent": {
+      "type": "object",
+      "required": ["name", "type"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["webhook", "agent_signal", "timer", "custom"]
+        },
+        "source": {
+          "type": "string",
+          "description": "Event source (e.g., gitlab, @mr-reviewer)"
+        },
+        "handler": {
+          "type": "string",
+          "description": "Handler service (e.g., agent-mesh)"
+        },
+        "schema": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Event payload schema"
+        }
+      }
+    },
+    "FlowNode": {
+      "type": "object",
+      "required": ["id", "type"],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["webhook", "agent", "task", "condition", "aggregator"]
+        },
+        "agent_id": {
+          "type": "string",
+          "description": "Agent ID (for agent type)"
+        },
+        "task_id": {
+          "type": "string",
+          "description": "Task ID (for task type)"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "FlowEdge": {
+      "type": "object",
+      "required": ["from", "to"],
+      "properties": {
+        "from": {
+          "type": "string",
+          "description": "Source node ID"
+        },
+        "to": {
+          "type": "string",
+          "description": "Target node ID"
+        },
+        "condition": {
+          "type": "string",
+          "description": "Edge condition expression"
+        },
+        "weight": {
+          "type": "integer",
+          "description": "Edge weight for routing"
+        }
+      }
+    },
+    "FlowAdaptor": {
+      "type": "object",
+      "properties": {
+        "langgraph": {
+          "type": "object",
+          "properties": {
+            "export": {
+              "type": "boolean"
+            },
+            "state_schema": {
+              "type": "object",
+              "additionalProperties": true
+            }
+          }
+        },
+        "temporal": {
+          "type": "object",
+          "properties": {
+            "export": {
+              "type": "boolean"
+            },
+            "workflow_id": {
+              "type": "string"
+            }
+          }
+        },
+        "n8n": {
+          "type": "object",
+          "properties": {
+            "export": {
+              "type": "boolean"
+            },
+            "format": {
+              "type": "string",
+              "enum": ["json", "yaml"]
+            }
+          }
+        }
+      }
+    },
+    "FlowSpec": {
+      "type": "object",
+      "required": ["flow_schema", "transitions"],
+      "properties": {
+        "flow_schema": {
+          "type": "object",
+          "required": ["initial_state", "states"],
+          "properties": {
+            "initial_state": {
+              "type": "string"
+            },
+            "states": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/FlowState"
+              }
+            }
+          }
+        },
+        "transitions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/FlowTransition"
+          }
+        },
+        "flow_events": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/FlowEvent"
+          }
+        },
+        "nodes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/FlowNode"
+          }
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/FlowEdge"
+          }
+        },
+        "adaptors": {
+          "$ref": "#/definitions/FlowAdaptor"
+        }
+      }
+    }
+  },
+  "properties": {
+    "spec": {
+      "$ref": "#/definitions/FlowSpec"
+    }
+  }
+}

package/spec/v0.3/infrastructure-substrate.schema.json

@@ -0,0 +1,190 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.3.5/infrastructure-substrate.json",
+  "title": "OSSA v0.3.5 Infrastructure Substrate Schema",
+  "description": "Infrastructure as agent-addressable resources",
+  "type": "object",
+  "definitions": {
+    "InfrastructureSubstrate": {
+      "type": "object",
+      "required": ["type", "hostname"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["synology_nas", "vast_ai", "cloudflare_workers", "kubernetes", "docker", "local"],
+          "examples": ["synology_nas", "vast_ai"]
+        },
+        "hostname": {
+          "type": "string",
+          "format": "hostname",
+          "examples": ["blueflynas.tailcf98b3.ts.net", "vastai-gpu.tailcf98b3.ts.net"]
+        },
+        "ip": {
+          "type": "string",
+          "format": "ipv4"
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "examples": [["store_artifact", "retrieve_artifact", "manage_checkpoints", "vector_search", "llm_inference"]]
+        },
+        "services": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name", "type", "port"],
+            "properties": {
+              "name": {
+                "type": "string",
+                "examples": ["MinIO", "PostgreSQL", "Qdrant", "Redis", "Ollama"]
+              },
+              "type": {
+                "type": "string",
+                "enum": ["s3_compatible", "database", "vector_db", "cache", "llm", "api"]
+              },
+              "port": {
+                "type": "integer"
+              },
+              "endpoint": {
+                "type": "string",
+                "format": "uri"
+              },
+              "health_check": {
+                "type": "string",
+                "format": "uri"
+              }
+            }
+          }
+        },
+        "resources": {
+          "type": "object",
+          "properties": {
+            "storage": {
+              "type": "object",
+              "properties": {
+                "total_gb": {
+                  "type": "integer"
+                },
+                "available_gb": {
+                  "type": "integer"
+                }
+              }
+            },
+            "memory": {
+              "type": "object",
+              "properties": {
+                "total_gb": {
+                  "type": "integer"
+                },
+                "available_gb": {
+                  "type": "integer"
+                }
+              }
+            },
+            "cpu": {
+              "type": "object",
+              "properties": {
+                "cores": {
+                  "type": "integer"
+                },
+                "utilization_percent": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                }
+              }
+            },
+            "gpu": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "examples": ["RTX 4090", "A100", "H100"]
+                },
+                "count": {
+                  "type": "integer"
+                },
+                "memory_gb": {
+                  "type": "integer"
+                }
+              }
+            }
+          }
+        },
+        "lifecycle": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": ["always_on", "on_demand", "scheduled"],
+              "default": "always_on"
+            },
+            "auto_scale": {
+              "type": "boolean",
+              "default": false
+            },
+            "scale_policy": {
+              "type": "object",
+              "properties": {
+                "min_instances": {
+                  "type": "integer"
+                },
+                "max_instances": {
+                  "type": "integer"
+                },
+                "target_utilization": {
+                  "type": "number"
+                }
+              }
+            },
+            "cost_cap": {
+              "type": "object",
+              "properties": {
+                "monthly_usd": {
+                  "type": "number"
+                },
+                "alert_threshold": {
+                  "type": "number",
+                  "default": 0.8
+                }
+              }
+            }
+          }
+        },
+        "access": {
+          "type": "object",
+          "properties": {
+            "tier": {
+              "type": "string",
+              "enum": ["tier_1_read", "tier_2_write_limited", "tier_3_write_elevated", "tier_4_policy"]
+            },
+            "agents_allowed": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^@[a-z0-9]([-a-z0-9]*[a-z0-9])?$"
+              }
+            },
+            "networks": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "examples": [["tailscale", "cloudflare"]]
+            }
+          }
+        }
+      }
+    }
+  },
+  "properties": {
+    "infrastructure": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/InfrastructureSubstrate"
+      }
+    }
+  }
+}

package/spec/v0.3/mixture-of-experts.schema.json

@@ -0,0 +1,159 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.3.5/mixture-of-experts.json",
+  "title": "OSSA v0.3.5 Mixture of Experts (MoE) Extension",
+  "description": "Agent-controlled expert model selection for intelligent routing",
+  "type": "object",
+  "definitions": {
+    "ExpertModel": {
+      "type": "object",
+      "required": ["id", "model"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$",
+          "description": "Unique expert identifier",
+          "examples": ["reasoning-expert", "code-expert", "speed-expert"]
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable expert name"
+        },
+        "model": {
+          "type": "object",
+          "required": ["provider", "model"],
+          "properties": {
+            "provider": {
+              "type": "string",
+              "enum": ["anthropic", "openai", "google", "aws", "azure", "local"],
+              "examples": ["anthropic", "openai"]
+            },
+            "model": {
+              "type": "string",
+              "examples": ["claude-opus-4-5-20251101", "gpt-4-turbo", "gemini-2.0-flash"]
+            },
+            "api_key_env": {
+              "type": "string",
+              "description": "Environment variable for API key"
+            }
+          }
+        },
+        "specializations": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Expert specialization areas",
+          "examples": [["complex_reasoning", "planning"], ["code_generation", "code_review"]]
+        },
+        "cost_tier": {
+          "type": "string",
+          "enum": ["economy", "standard", "premium"],
+          "description": "Cost tier classification"
+        },
+        "capabilities": {
+          "type": "object",
+          "properties": {
+            "extended_thinking": {
+              "type": "boolean",
+              "description": "Supports extended thinking/reasoning"
+            },
+            "max_tokens": {
+              "type": "integer",
+              "description": "Maximum context window"
+            },
+            "reasoning_depth": {
+              "type": "string",
+              "enum": ["fast", "balanced", "deep"],
+              "description": "Reasoning depth capability"
+            },
+            "multimodal": {
+              "type": "boolean",
+              "description": "Supports multimodal inputs"
+            },
+            "streaming": {
+              "type": "boolean",
+              "description": "Supports streaming responses"
+            }
+          }
+        },
+        "availability": {
+          "type": "object",
+          "properties": {
+            "regions": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "examples": [["us-east-1", "eu-west-1"]]
+            },
+            "fallback": {
+              "type": "string",
+              "description": "Fallback expert ID if unavailable"
+            },
+            "sla": {
+              "type": "object",
+              "properties": {
+                "uptime": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                },
+                "latency_p95_ms": {
+                  "type": "integer"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "ExpertSelectionStrategy": {
+      "type": "string",
+      "enum": ["agent_controlled", "cost_optimized", "capability_match", "hybrid"],
+      "default": "agent_controlled",
+      "description": "How experts are selected"
+    },
+    "MoEExtension": {
+      "type": "object",
+      "properties": {
+        "registry": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ExpertModel"
+          },
+          "description": "Available expert models"
+        },
+        "selection_strategy": {
+          "$ref": "#/definitions/ExpertSelectionStrategy"
+        },
+        "tools": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "enum": ["list_experts", "invoke_expert", "get_expert_history"]
+              },
+              "description": {
+                "type": "string"
+              },
+              "parameters": {
+                "type": "object",
+                "additionalProperties": true
+              }
+            },
+            "required": ["name", "description"]
+          }
+        }
+      },
+      "required": ["registry", "selection_strategy"]
+    }
+  },
+  "properties": {
+    "experts": {
+      "$ref": "#/definitions/MoEExtension"
+    }
+  }
+}