Skip to content

armgit / ODS

Public Imported from GitHub
0

ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.

4.2 KB
Raw Blame
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://osmantic.dev/schemas/ods.model-state.v1.json",
  "title": "ODS Model Switchboard state record (v1)",
  "type": "object",
  "required": ["schema", "seq", "routeSeq", "desired", "active", "history", "availability"],
  "additionalProperties": false,
  "properties": {
    "schema": { "const": "ods.model-state.v1" },
    "seq": { "type": "integer", "minimum": 0 },
    "routeSeq": { "type": "integer", "minimum": 0 },
    "operation": {
      "oneOf": [
        { "type": "null" },
        {
          "type": "object",
          "required": ["id", "phase", "requestedModelId", "startedAt"],
          "additionalProperties": false,
          "properties": {
            "id": { "type": "string", "minLength": 1 },
            "phase": {
              "enum": ["requested", "staging", "verifying", "publishing", "flipping", "serving", "failed", "rolling_back"]
            },
            "requestedModelId": { "type": "string" },
            "startedAt": { "type": "string" },
            "error": { "type": ["string", "null"] }
          }
        }
      ]
    },
    "desired": {
      "oneOf": [
        { "type": "null" },
        {
          "type": "object",
          "required": ["catalogId"],
          "additionalProperties": false,
          "properties": { "catalogId": { "type": "string", "minLength": 1 } }
        }
      ]
    },
    "active": {
      "oneOf": [
        { "type": "null" },
        {
          "type": "object",
          "required": ["routeSeq", "catalogId", "runtimeModelId", "publicModel", "backend", "contextLength", "capabilities", "verifiedAt", "proof"],
          "additionalProperties": false,
          "properties": {
            "routeSeq": { "type": "integer", "minimum": 0 },
            "catalogId": { "type": "string", "minLength": 1 },
            "runtimeModelId": { "type": "string", "minLength": 1 },
            "publicModel": { "type": "string", "minLength": 1 },
            "backend": {
              "type": "object",
              "required": ["kind", "endpointId"],
              "additionalProperties": false,
              "properties": {
                "kind": {
                  "enum": ["llama-server", "vllm", "lemonade", "hipfire", "unknown"],
                  "description": "lemonade names a pre-round-F route: readable for one release so the host agent can replace it, never written"
                },
                "endpointId": { "type": "string", "minLength": 1 },
                "nativeRoute": { "type": ["string", "null"] }
              }
            },
            "contextLength": { "type": "integer", "minimum": 0 },
            "capabilities": {
              "type": "object",
              "required": ["chat", "tools", "vision", "agentViable"],
              "additionalProperties": false,
              "properties": {
                "chat": { "type": "boolean" },
                "tools": { "type": "boolean" },
                "vision": { "type": "boolean" },
                "agentViable": { "type": "boolean" }
              }
            },
            "verifiedAt": { "type": ["string", "null"] },
            "reconstructed": { "type": "boolean" },
            "proof": {
              "type": "object",
              "required": ["identity", "completion"],
              "additionalProperties": false,
              "properties": {
                "identity": { "type": ["string", "null"] },
                "completion": { "type": "boolean" }
              }
            }
          }
        }
      ]
    },
    "history": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "object",
        "required": ["routeSeq", "catalogId", "runtimeModelId", "verifiedAt"],
        "additionalProperties": true,
        "properties": {
          "routeSeq": { "type": "integer", "minimum": 0 },
          "catalogId": { "type": "string" },
          "runtimeModelId": { "type": "string" },
          "verifiedAt": { "type": ["string", "null"] }
        }
      }
    },
    "availability": {
      "type": "object",
      "required": ["mode", "queueDeadline"],
      "additionalProperties": false,
      "properties": {
        "mode": { "enum": ["serve_active", "queue"] },
        "queueDeadline": { "type": ["string", "null"] }
      }
    }
  }
}