@objectstack/spec 0.2.0 → 0.3.1

package/json-schema/ai/MessagePruningEvent.json

@@ -0,0 +1,92 @@
+{
+  "$ref": "#/definitions/MessagePruningEvent",
+  "definitions": {
+    "MessagePruningEvent": {
+      "type": "object",
+      "properties": {
+        "timestamp": {
+          "type": "string",
+          "description": "ISO 8601 timestamp"
+        },
+        "strategy": {
+          "type": "string",
+          "enum": [
+            "fifo",
+            "importance",
+            "semantic",
+            "sliding_window",
+            "summary"
+          ]
+        },
+        "reason": {
+          "type": "string",
+          "description": "Reason for pruning"
+        },
+        "prunedMessages": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "messageId": {
+                "type": "string"
+              },
+              "role": {
+                "type": "string",
+                "enum": [
+                  "system",
+                  "user",
+                  "assistant",
+                  "function",
+                  "tool"
+                ]
+              },
+              "tokens": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "importance": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1
+              }
+            },
+            "required": [
+              "messageId",
+              "role",
+              "tokens"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "tokensFreed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "messagesRemoved": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "remainingTokens": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "remainingMessages": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "timestamp",
+        "strategy",
+        "reason",
+        "prunedMessages",
+        "tokensFreed",
+        "messagesRemoved",
+        "remainingTokens",
+        "remainingMessages"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/MessageRole.json

@@ -0,0 +1,16 @@
+{
+  "$ref": "#/definitions/MessageRole",
+  "definitions": {
+    "MessageRole": {
+      "type": "string",
+      "enum": [
+        "system",
+        "user",
+        "assistant",
+        "function",
+        "tool"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/ModelCapability.json

@@ -0,0 +1,47 @@
+{
+  "$ref": "#/definitions/ModelCapability",
+  "definitions": {
+    "ModelCapability": {
+      "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
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/ModelConfig.json

@@ -0,0 +1,181 @@
+{
+  "$ref": "#/definitions/ModelConfig",
+  "definitions": {
+    "ModelConfig": {
+      "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
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/ModelDrift.json

@@ -0,0 +1,73 @@
+{
+  "$ref": "#/definitions/ModelDrift",
+  "definitions": {
+    "ModelDrift": {
+      "type": "object",
+      "properties": {
+        "modelName": {
+          "type": "string"
+        },
+        "driftType": {
+          "type": "string",
+          "enum": [
+            "feature_drift",
+            "prediction_drift",
+            "performance_drift"
+          ]
+        },
+        "severity": {
+          "type": "string",
+          "enum": [
+            "low",
+            "medium",
+            "high",
+            "critical"
+          ]
+        },
+        "detectedAt": {
+          "type": "string",
+          "description": "ISO timestamp"
+        },
+        "metrics": {
+          "type": "object",
+          "properties": {
+            "driftScore": {
+              "type": "number",
+              "description": "Drift magnitude (0-1)"
+            },
+            "affectedFeatures": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "performanceChange": {
+              "type": "number",
+              "description": "Change in performance metric"
+            }
+          },
+          "required": [
+            "driftScore"
+          ],
+          "additionalProperties": false
+        },
+        "recommendation": {
+          "type": "string"
+        },
+        "autoRetrainTriggered": {
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "modelName",
+        "driftType",
+        "severity",
+        "detectedAt",
+        "metrics"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/ModelFeature.json

@@ -0,0 +1,71 @@
+{
+  "$ref": "#/definitions/ModelFeature",
+  "definitions": {
+    "ModelFeature": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z_][a-z0-9_]*$",
+          "description": "Feature name (snake_case)"
+        },
+        "label": {
+          "type": "string",
+          "description": "Human-readable label"
+        },
+        "field": {
+          "type": "string",
+          "description": "Source field name"
+        },
+        "object": {
+          "type": "string",
+          "description": "Source object (if different from target)"
+        },
+        "dataType": {
+          "type": "string",
+          "enum": [
+            "numeric",
+            "categorical",
+            "text",
+            "datetime",
+            "boolean"
+          ],
+          "description": "Feature data type"
+        },
+        "transformation": {
+          "type": "string",
+          "enum": [
+            "none",
+            "normalize",
+            "standardize",
+            "one_hot_encode",
+            "label_encode",
+            "log_transform",
+            "binning",
+            "embedding"
+          ],
+          "default": "none"
+        },
+        "required": {
+          "type": "boolean",
+          "default": true
+        },
+        "defaultValue": {},
+        "description": {
+          "type": "string"
+        },
+        "importance": {
+          "type": "number",
+          "description": "Feature importance score (0-1)"
+        }
+      },
+      "required": [
+        "name",
+        "field",
+        "dataType"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/ModelLimits.json

@@ -0,0 +1,45 @@
+{
+  "$ref": "#/definitions/ModelLimits",
+  "definitions": {
+    "ModelLimits": {
+      "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
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/ModelPricing.json

@@ -0,0 +1,28 @@
+{
+  "$ref": "#/definitions/ModelPricing",
+  "definitions": {
+    "ModelPricing": {
+      "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
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/ModelProvider.json

@@ -0,0 +1,19 @@
+{
+  "$ref": "#/definitions/ModelProvider",
+  "definitions": {
+    "ModelProvider": {
+      "type": "string",
+      "enum": [
+        "openai",
+        "azure_openai",
+        "anthropic",
+        "google",
+        "cohere",
+        "huggingface",
+        "local",
+        "custom"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}