@syntrologie/runtime-sdk 0.2.20 → 1.0.0-canary.1

package/schema/runtime-context.schema.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://syntropyforge.com/schemas/runtime-context.json",
+  "title": "Runtime Context",
+  "description": "The complete runtime context available to adaptives for decision-making",
+  "type": "object",
+  "required": ["page", "session", "viewport"],
+  "properties": {
+    "page": {
+      "type": "object",
+      "description": "Current page information",
+      "required": ["url"],
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "Current page URL"
+        },
+        "routeId": {
+          "type": "string",
+          "description": "Matched route pattern from RoutesConfig"
+        },
+        "title": {
+          "type": "string",
+          "description": "Document title"
+        },
+        "locale": {
+          "type": "string",
+          "description": "Page locale (e.g., 'en-US')"
+        }
+      },
+      "additionalProperties": false
+    },
+    "session": {
+      "type": "object",
+      "description": "Current session information",
+      "required": ["sessionId", "startTs"],
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "description": "Unique session ID (from PostHog)"
+        },
+        "startTs": {
+          "type": "number",
+          "description": "Session start timestamp (ms since epoch)"
+        },
+        "pageHistory": {
+          "type": "array",
+          "description": "Page history within this session",
+          "items": {
+            "type": "object",
+            "required": ["url", "ts"],
+            "properties": {
+              "url": {
+                "type": "string",
+                "description": "Page URL"
+              },
+              "ts": {
+                "type": "number",
+                "description": "Timestamp when page was visited"
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "viewport": {
+      "type": "object",
+      "description": "Current viewport size",
+      "required": ["width", "height"],
+      "properties": {
+        "width": {
+          "type": "number",
+          "description": "Viewport width in pixels"
+        },
+        "height": {
+          "type": "number",
+          "description": "Viewport height in pixels"
+        }
+      },
+      "additionalProperties": false
+    },
+    "anchors": {
+      "type": "array",
+      "description": "Tracked anchor element states",
+      "items": {
+        "type": "object",
+        "required": ["anchorId", "present"],
+        "properties": {
+          "anchorId": {
+            "type": "string",
+            "description": "Anchor element ID"
+          },
+          "present": {
+            "type": "boolean",
+            "description": "Whether the element is present in the DOM"
+          },
+          "visible": {
+            "type": "boolean",
+            "description": "Whether the element is visible in the viewport"
+          },
+          "boundingBox": {
+            "type": "object",
+            "description": "Element's bounding box",
+            "properties": {
+              "x": { "type": "number" },
+              "y": { "type": "number" },
+              "w": { "type": "number" },
+              "h": { "type": "number" }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "augmented": {
+      "type": "object",
+      "description": "ML-derived augmentation data (Phase 3)",
+      "additionalProperties": {
+        "oneOf": [{ "type": "number" }, { "type": "string" }, { "type": "boolean" }]
+      }
+    }
+  },
+  "additionalProperties": false
+}