@objectstack/spec 0.2.0 → 0.3.1

package/json-schema/ai/ModelRegistry.json

@@ -0,0 +1,427 @@
+{
+  "$ref": "#/definitions/ModelRegistry",
+  "definitions": {
+    "ModelRegistry": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Registry name"
+        },
+        "models": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "model": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "Unique model identifier"
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "Model display name"
+                  },
+                  "version": {
+                    "type": "string",
+                    "description": "Model version (e.g., \"gpt-4-turbo-2024-04-09\")"
+                  },
+                  "provider": {
+                    "type": "string",
+                    "enum": [
+                      "openai",
+                      "azure_openai",
+                      "anthropic",
+                      "google",
+                      "cohere",
+                      "huggingface",
+                      "local",
+                      "custom"
+                    ]
+                  },
+                  "capabilities": {
+                    "type": "object",
+                    "properties": {
+                      "textGeneration": {
+                        "type": "boolean",
+                        "default": true,
+                        "description": "Supports text generation"
+                      },
+                      "textEmbedding": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "Supports text embedding"
+                      },
+                      "imageGeneration": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "Supports image generation"
+                      },
+                      "imageUnderstanding": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "Supports image understanding"
+                      },
+                      "functionCalling": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "Supports function calling"
+                      },
+                      "codeGeneration": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "Supports code generation"
+                      },
+                      "reasoning": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "Supports advanced reasoning"
+                      }
+                    },
+                    "additionalProperties": false
+                  },
+                  "limits": {
+                    "type": "object",
+                    "properties": {
+                      "maxTokens": {
+                        "type": "integer",
+                        "exclusiveMinimum": 0,
+                        "description": "Maximum tokens per request"
+                      },
+                      "contextWindow": {
+                        "type": "integer",
+                        "exclusiveMinimum": 0,
+                        "description": "Context window size"
+                      },
+                      "maxOutputTokens": {
+                        "type": "integer",
+                        "exclusiveMinimum": 0,
+                        "description": "Maximum output tokens"
+                      },
+                      "rateLimit": {
+                        "type": "object",
+                        "properties": {
+                          "requestsPerMinute": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0
+                          },
+                          "tokensPerMinute": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0
+                          }
+                        },
+                        "additionalProperties": false
+                      }
+                    },
+                    "required": [
+                      "maxTokens",
+                      "contextWindow"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "pricing": {
+                    "type": "object",
+                    "properties": {
+                      "currency": {
+                        "type": "string",
+                        "default": "USD"
+                      },
+                      "inputCostPer1kTokens": {
+                        "type": "number",
+                        "description": "Cost per 1K input tokens"
+                      },
+                      "outputCostPer1kTokens": {
+                        "type": "number",
+                        "description": "Cost per 1K output tokens"
+                      },
+                      "embeddingCostPer1kTokens": {
+                        "type": "number",
+                        "description": "Cost per 1K embedding tokens"
+                      }
+                    },
+                    "additionalProperties": false
+                  },
+                  "endpoint": {
+                    "type": "string",
+                    "format": "uri",
+                    "description": "Custom API endpoint"
+                  },
+                  "apiKey": {
+                    "type": "string",
+                    "description": "API key or reference to secret"
+                  },
+                  "region": {
+                    "type": "string",
+                    "description": "Deployment region (e.g., \"us-east-1\")"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "tags": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Tags for categorization"
+                  },
+                  "deprecated": {
+                    "type": "boolean",
+                    "default": false
+                  },
+                  "recommendedFor": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Use case recommendations"
+                  }
+                },
+                "required": [
+                  "id",
+                  "name",
+                  "version",
+                  "provider",
+                  "capabilities",
+                  "limits"
+                ],
+                "additionalProperties": false
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "active",
+                  "deprecated",
+                  "experimental",
+                  "disabled"
+                ],
+                "default": "active"
+              },
+              "priority": {
+                "type": "integer",
+                "default": 0,
+                "description": "Priority for model selection"
+              },
+              "fallbackModels": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Fallback model IDs"
+              },
+              "healthCheck": {
+                "type": "object",
+                "properties": {
+                  "enabled": {
+                    "type": "boolean",
+                    "default": true
+                  },
+                  "intervalSeconds": {
+                    "type": "integer",
+                    "default": 300
+                  },
+                  "lastChecked": {
+                    "type": "string",
+                    "description": "ISO timestamp"
+                  },
+                  "status": {
+                    "type": "string",
+                    "enum": [
+                      "healthy",
+                      "unhealthy",
+                      "unknown"
+                    ],
+                    "default": "unknown"
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "model"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Model entries by ID"
+        },
+        "promptTemplates": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Unique template identifier"
+              },
+              "name": {
+                "type": "string",
+                "pattern": "^[a-z_][a-z0-9_]*$",
+                "description": "Template name (snake_case)"
+              },
+              "label": {
+                "type": "string",
+                "description": "Display name"
+              },
+              "system": {
+                "type": "string",
+                "description": "System prompt"
+              },
+              "user": {
+                "type": "string",
+                "description": "User prompt template with variables"
+              },
+              "assistant": {
+                "type": "string",
+                "description": "Assistant message prefix"
+              },
+              "variables": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "type": "string",
+                      "description": "Variable name (e.g., \"user_name\", \"context\")"
+                    },
+                    "type": {
+                      "type": "string",
+                      "enum": [
+                        "string",
+                        "number",
+                        "boolean",
+                        "object",
+                        "array"
+                      ],
+                      "default": "string"
+                    },
+                    "required": {
+                      "type": "boolean",
+                      "default": false
+                    },
+                    "defaultValue": {},
+                    "description": {
+                      "type": "string"
+                    },
+                    "validation": {
+                      "type": "object",
+                      "properties": {
+                        "minLength": {
+                          "type": "number"
+                        },
+                        "maxLength": {
+                          "type": "number"
+                        },
+                        "pattern": {
+                          "type": "string"
+                        },
+                        "enum": {
+                          "type": "array"
+                        }
+                      },
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "name"
+                  ],
+                  "additionalProperties": false
+                },
+                "description": "Template variables"
+              },
+              "modelId": {
+                "type": "string",
+                "description": "Recommended model ID"
+              },
+              "temperature": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 2
+              },
+              "maxTokens": {
+                "type": "number"
+              },
+              "topP": {
+                "type": "number"
+              },
+              "frequencyPenalty": {
+                "type": "number"
+              },
+              "presencePenalty": {
+                "type": "number"
+              },
+              "stopSequences": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "version": {
+                "type": "string",
+                "default": "1.0.0"
+              },
+              "description": {
+                "type": "string"
+              },
+              "category": {
+                "type": "string",
+                "description": "Template category (e.g., \"code_generation\", \"support\")"
+              },
+              "tags": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "examples": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "input": {
+                      "type": "object",
+                      "additionalProperties": {},
+                      "description": "Example variable values"
+                    },
+                    "output": {
+                      "type": "string",
+                      "description": "Expected output"
+                    }
+                  },
+                  "required": [
+                    "input",
+                    "output"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "label",
+              "user"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Prompt templates by name"
+        },
+        "defaultModel": {
+          "type": "string",
+          "description": "Default model ID"
+        },
+        "enableAutoFallback": {
+          "type": "boolean",
+          "default": true,
+          "description": "Auto-fallback on errors"
+        }
+      },
+      "required": [
+        "name",
+        "models"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/ModelRegistryEntry.json

@@ -0,0 +1,239 @@
+{
+  "$ref": "#/definitions/ModelRegistryEntry",
+  "definitions": {
+    "ModelRegistryEntry": {
+      "type": "object",
+      "properties": {
+        "model": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "description": "Unique model identifier"
+            },
+            "name": {
+              "type": "string",
+              "description": "Model display name"
+            },
+            "version": {
+              "type": "string",
+              "description": "Model version (e.g., \"gpt-4-turbo-2024-04-09\")"
+            },
+            "provider": {
+              "type": "string",
+              "enum": [
+                "openai",
+                "azure_openai",
+                "anthropic",
+                "google",
+                "cohere",
+                "huggingface",
+                "local",
+                "custom"
+              ]
+            },
+            "capabilities": {
+              "type": "object",
+              "properties": {
+                "textGeneration": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Supports text generation"
+                },
+                "textEmbedding": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Supports text embedding"
+                },
+                "imageGeneration": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Supports image generation"
+                },
+                "imageUnderstanding": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Supports image understanding"
+                },
+                "functionCalling": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Supports function calling"
+                },
+                "codeGeneration": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Supports code generation"
+                },
+                "reasoning": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Supports advanced reasoning"
+                }
+              },
+              "additionalProperties": false
+            },
+            "limits": {
+              "type": "object",
+              "properties": {
+                "maxTokens": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Maximum tokens per request"
+                },
+                "contextWindow": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Context window size"
+                },
+                "maxOutputTokens": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Maximum output tokens"
+                },
+                "rateLimit": {
+                  "type": "object",
+                  "properties": {
+                    "requestsPerMinute": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0
+                    },
+                    "tokensPerMinute": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "maxTokens",
+                "contextWindow"
+              ],
+              "additionalProperties": false
+            },
+            "pricing": {
+              "type": "object",
+              "properties": {
+                "currency": {
+                  "type": "string",
+                  "default": "USD"
+                },
+                "inputCostPer1kTokens": {
+                  "type": "number",
+                  "description": "Cost per 1K input tokens"
+                },
+                "outputCostPer1kTokens": {
+                  "type": "number",
+                  "description": "Cost per 1K output tokens"
+                },
+                "embeddingCostPer1kTokens": {
+                  "type": "number",
+                  "description": "Cost per 1K embedding tokens"
+                }
+              },
+              "additionalProperties": false
+            },
+            "endpoint": {
+              "type": "string",
+              "format": "uri",
+              "description": "Custom API endpoint"
+            },
+            "apiKey": {
+              "type": "string",
+              "description": "API key or reference to secret"
+            },
+            "region": {
+              "type": "string",
+              "description": "Deployment region (e.g., \"us-east-1\")"
+            },
+            "description": {
+              "type": "string"
+            },
+            "tags": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Tags for categorization"
+            },
+            "deprecated": {
+              "type": "boolean",
+              "default": false
+            },
+            "recommendedFor": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Use case recommendations"
+            }
+          },
+          "required": [
+            "id",
+            "name",
+            "version",
+            "provider",
+            "capabilities",
+            "limits"
+          ],
+          "additionalProperties": false
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "active",
+            "deprecated",
+            "experimental",
+            "disabled"
+          ],
+          "default": "active"
+        },
+        "priority": {
+          "type": "integer",
+          "default": 0,
+          "description": "Priority for model selection"
+        },
+        "fallbackModels": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Fallback model IDs"
+        },
+        "healthCheck": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            },
+            "intervalSeconds": {
+              "type": "integer",
+              "default": 300
+            },
+            "lastChecked": {
+              "type": "string",
+              "description": "ISO timestamp"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "healthy",
+                "unhealthy",
+                "unknown"
+              ],
+              "default": "unknown"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "model"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}