@objectstack/spec 2.0.2 → 2.0.4

package/json-schema/ai/PluginScaffoldingTemplate.json

@@ -1,7 +1,126 @@
 {
-  "$ref": "#/definitions/PluginScaffoldingTemplate",
-  "definitions": {
-    "PluginScaffoldingTemplate": {}
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "pluginType": {
+      "type": "string"
+    },
+    "structure": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "file",
+              "directory"
+            ]
+          },
+          "path": {
+            "type": "string"
+          },
+          "template": {
+            "description": "Template content with variables",
+            "type": "string"
+          },
+          "optional": {
+            "default": false,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "type",
+          "path",
+          "optional"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "variables": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "string",
+              "number",
+              "boolean",
+              "array",
+              "object"
+            ]
+          },
+          "required": {
+            "default": true,
+            "type": "boolean"
+          },
+          "default": {},
+          "validation": {
+            "description": "Validation regex or rule",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "description",
+          "type",
+          "required"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "scripts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "command": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "optional": {
+            "default": false,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "name",
+          "command",
+          "optional"
+        ],
+        "additionalProperties": false
+      }
+    }
   },
-  "$schema": "http://json-schema.org/draft-07/schema#"
+  "required": [
+    "id",
+    "name",
+    "description",
+    "pluginType",
+    "structure",
+    "variables"
+  ],
+  "additionalProperties": false
 }

package/json-schema/ai/PostProcessingAction.json

@@ -1,7 +1,39 @@
 {
-  "$ref": "#/definitions/PostProcessingAction",
-  "definitions": {
-    "PostProcessingAction": {}
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {},
+      "description": "Action-specific configuration"
+    },
+    "condition": {
+      "description": "Execute only if condition is TRUE",
+      "type": "string"
+    }
   },
-  "$schema": "http://json-schema.org/draft-07/schema#"
+  "required": [
+    "type",
+    "name",
+    "config"
+  ],
+  "additionalProperties": false
 }

package/json-schema/ai/PredictionRequest.json

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

package/json-schema/ai/PredictionResult.json

@@ -1,7 +1,119 @@
 {
-  "$ref": "#/definitions/PredictionResult",
-  "definitions": {
-    "PredictionResult": {}
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "modelName": {
+      "type": "string"
+    },
+    "modelVersion": {
+      "type": "string"
+    },
+    "recordId": {
+      "type": "string"
+    },
+    "prediction": {
+      "description": "The predicted value"
+    },
+    "confidence": {
+      "description": "Confidence score (0-1)",
+      "type": "number"
+    },
+    "probabilities": {
+      "description": "Class probabilities (for classification)",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "number"
+      }
+    },
+    "explanation": {
+      "type": "object",
+      "properties": {
+        "topFeatures": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "feature": {
+                "type": "string"
+              },
+              "importance": {
+                "type": "number"
+              },
+              "value": {}
+            },
+            "required": [
+              "feature",
+              "importance",
+              "value"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "reasoning": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "tokens": {
+      "description": "Token usage for this prediction (if AI-powered)",
+      "type": "object",
+      "properties": {
+        "prompt": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Input tokens"
+        },
+        "completion": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Output tokens"
+        },
+        "total": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Total tokens"
+        }
+      },
+      "required": [
+        "prompt",
+        "completion",
+        "total"
+      ],
+      "additionalProperties": false
+    },
+    "cost": {
+      "description": "Cost for this prediction in USD",
+      "type": "number",
+      "minimum": 0
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "executionTime": {
+          "description": "Execution time in milliseconds",
+          "type": "number"
+        },
+        "timestamp": {
+          "description": "ISO timestamp",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+        }
+      },
+      "additionalProperties": false
+    }
   },
-  "$schema": "http://json-schema.org/draft-07/schema#"
+  "required": [
+    "modelName",
+    "modelVersion",
+    "prediction"
+  ],
+  "additionalProperties": false
 }