@objectstack/spec 0.3.0 → 0.3.2

package/json-schema/ai/EvaluationMetrics.json

@@ -0,0 +1,64 @@
+{
+  "$ref": "#/definitions/EvaluationMetrics",
+  "definitions": {
+    "EvaluationMetrics": {
+      "type": "object",
+      "properties": {
+        "accuracy": {
+          "type": "number"
+        },
+        "precision": {
+          "type": "number"
+        },
+        "recall": {
+          "type": "number"
+        },
+        "f1Score": {
+          "type": "number"
+        },
+        "auc": {
+          "type": "number",
+          "description": "Area Under ROC Curve"
+        },
+        "mse": {
+          "type": "number",
+          "description": "Mean Squared Error"
+        },
+        "rmse": {
+          "type": "number",
+          "description": "Root Mean Squared Error"
+        },
+        "mae": {
+          "type": "number",
+          "description": "Mean Absolute Error"
+        },
+        "r2Score": {
+          "type": "number",
+          "description": "R-squared score"
+        },
+        "silhouetteScore": {
+          "type": "number"
+        },
+        "daviesBouldinIndex": {
+          "type": "number"
+        },
+        "mape": {
+          "type": "number",
+          "description": "Mean Absolute Percentage Error"
+        },
+        "smape": {
+          "type": "number",
+          "description": "Symmetric MAPE"
+        },
+        "custom": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "number"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/FunctionCall.json

@@ -0,0 +1,28 @@
+{
+  "$ref": "#/definitions/FunctionCall",
+  "definitions": {
+    "FunctionCall": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Function name"
+        },
+        "arguments": {
+          "type": "string",
+          "description": "JSON string of function arguments"
+        },
+        "result": {
+          "type": "string",
+          "description": "Function execution result"
+        }
+      },
+      "required": [
+        "name",
+        "arguments"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/Hyperparameters.json

@@ -0,0 +1,80 @@
+{
+  "$ref": "#/definitions/Hyperparameters",
+  "definitions": {
+    "Hyperparameters": {
+      "type": "object",
+      "properties": {
+        "learningRate": {
+          "type": "number",
+          "description": "Learning rate for training"
+        },
+        "epochs": {
+          "type": "integer",
+          "description": "Number of training epochs"
+        },
+        "batchSize": {
+          "type": "integer",
+          "description": "Training batch size"
+        },
+        "maxDepth": {
+          "type": "integer",
+          "description": "Maximum tree depth"
+        },
+        "numTrees": {
+          "type": "integer",
+          "description": "Number of trees in ensemble"
+        },
+        "minSamplesSplit": {
+          "type": "integer",
+          "description": "Minimum samples to split node"
+        },
+        "minSamplesLeaf": {
+          "type": "integer",
+          "description": "Minimum samples in leaf node"
+        },
+        "hiddenLayers": {
+          "type": "array",
+          "items": {
+            "type": "integer"
+          },
+          "description": "Hidden layer sizes"
+        },
+        "activation": {
+          "type": "string",
+          "description": "Activation function"
+        },
+        "dropout": {
+          "type": "number",
+          "description": "Dropout rate"
+        },
+        "l1Regularization": {
+          "type": "number",
+          "description": "L1 regularization strength"
+        },
+        "l2Regularization": {
+          "type": "number",
+          "description": "L2 regularization strength"
+        },
+        "numClusters": {
+          "type": "integer",
+          "description": "Number of clusters (k-means, etc.)"
+        },
+        "seasonalPeriod": {
+          "type": "integer",
+          "description": "Seasonal period for time series"
+        },
+        "forecastHorizon": {
+          "type": "integer",
+          "description": "Number of periods to forecast"
+        },
+        "custom": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Algorithm-specific parameters"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/MessageContent.json

@@ -0,0 +1,46 @@
+{
+  "$ref": "#/definitions/MessageContent",
+  "definitions": {
+    "MessageContent": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "text",
+            "image",
+            "file",
+            "code",
+            "structured"
+          ],
+          "default": "text"
+        },
+        "text": {
+          "type": "string",
+          "description": "Text content"
+        },
+        "imageUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Image URL for vision models"
+        },
+        "fileUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "File attachment URL"
+        },
+        "mimeType": {
+          "type": "string",
+          "description": "MIME type for files"
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Additional metadata"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/MessageContentType.json

@@ -0,0 +1,16 @@
+{
+  "$ref": "#/definitions/MessageContentType",
+  "definitions": {
+    "MessageContentType": {
+      "type": "string",
+      "enum": [
+        "text",
+        "image",
+        "file",
+        "code",
+        "structured"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

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/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/PostProcessingAction.json

@@ -0,0 +1,41 @@
+{
+  "$ref": "#/definitions/PostProcessingAction",
+  "definitions": {
+    "PostProcessingAction": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "field_update",
+            "send_email",
+            "create_record",
+            "update_related",
+            "trigger_flow",
+            "webhook"
+          ]
+        },
+        "name": {
+          "type": "string",
+          "description": "Action name"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Action-specific configuration"
+        },
+        "condition": {
+          "type": "string",
+          "description": "Execute only if condition is TRUE"
+        }
+      },
+      "required": [
+        "type",
+        "name",
+        "config"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/PredictionRequest.json

@@ -0,0 +1,39 @@
+{
+  "$ref": "#/definitions/PredictionRequest",
+  "definitions": {
+    "PredictionRequest": {
+      "type": "object",
+      "properties": {
+        "modelName": {
+          "type": "string",
+          "description": "Model to use for prediction"
+        },
+        "recordIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Specific records to predict (if not provided, uses all)"
+        },
+        "inputData": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Direct input data (alternative to recordIds)"
+        },
+        "returnConfidence": {
+          "type": "boolean",
+          "default": true
+        },
+        "returnExplanation": {
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "modelName"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/PredictionResult.json

@@ -0,0 +1,82 @@
+{
+  "$ref": "#/definitions/PredictionResult",
+  "definitions": {
+    "PredictionResult": {
+      "type": "object",
+      "properties": {
+        "modelName": {
+          "type": "string"
+        },
+        "modelVersion": {
+          "type": "string"
+        },
+        "recordId": {
+          "type": "string"
+        },
+        "prediction": {
+          "description": "The predicted value"
+        },
+        "confidence": {
+          "type": "number",
+          "description": "Confidence score (0-1)"
+        },
+        "probabilities": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "number"
+          },
+          "description": "Class probabilities (for classification)"
+        },
+        "explanation": {
+          "type": "object",
+          "properties": {
+            "topFeatures": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "feature": {
+                    "type": "string"
+                  },
+                  "importance": {
+                    "type": "number"
+                  },
+                  "value": {}
+                },
+                "required": [
+                  "feature",
+                  "importance"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "reasoning": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "metadata": {
+          "type": "object",
+          "properties": {
+            "executionTime": {
+              "type": "number",
+              "description": "Execution time in milliseconds"
+            },
+            "timestamp": {
+              "type": "string",
+              "description": "ISO timestamp"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "modelName",
+        "modelVersion"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}