@x12i/memorix-service 3.9.2 → 3.11.0

package/dist/openapi/openapi.json

@@ -2417,7 +2417,8 @@
                       "ingress": {
                         "type": "string",
                         "enum": ["push", "import", "sync", "derive", "migrate", "manual", "replicate"]
-                      }
+                      },
+                      "sources": { "$ref": "#/components/schemas/DatasourceSourcesDeclaration" }
                     }
                   }
                 }
@@ -2830,7 +2831,8 @@
                       "ingress": {
                         "type": "string",
                         "enum": ["push", "import", "sync", "derive", "migrate", "manual", "replicate"]
-                      }
+                      },
+                      "sources": { "$ref": "#/components/schemas/DatasourceSourcesDeclaration" }
                     },
                     "additionalProperties": true
                   },
@@ -13935,228 +13937,821 @@
           }
         }
       }
-    }
-  },
-  "components": {
-    "parameters": {
-      "XMemorixOrgId": {
-        "name": "x-memorix-org-id",
-        "in": "header",
-        "required": true,
-        "schema": {
-          "type": "string",
-          "minLength": 1
-        },
-        "description": "Organization / data-universe id"
-      },
-      "XMemorixAgentIds": {
-        "name": "x-memorix-agent-ids",
-        "in": "header",
-        "required": true,
-        "schema": {
-          "type": "string",
-          "minLength": 1
-        },
-        "description": "Comma-separated agentIds for effective metadata",
-        "example": "ops,fieldstone"
-      },
-      "XMemorixCaller": {
-        "name": "x-memorix-caller",
-        "in": "header",
-        "required": true,
-        "schema": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 128,
-          "pattern": "^[a-zA-Z0-9@][a-zA-Z0-9._@/-]*$"
-        },
-        "description": "MX-CALLER-01: calling application id (e.g. synapix-lander, map-store, memorix-studio, @x12i/memorix-client)",
-        "example": "memorix-studio"
-      }
     },
-    "schemas": {
-      "MemorixScope": {
-        "type": "object",
-        "required": [
-          "orgId",
-          "agentIds"
+    "/api/analytics/counters": {
+      "get": {
+        "operationId": "analyticsCountersList",
+        "summary": "List registered counters (pack analytics[], API registrations, built-ins)",
+        "tags": [
+          "Analytics"
         ],
-        "additionalProperties": false,
-        "properties": {
-          "orgId": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Data universe / org isolation key"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
           },
-          "agentIds": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            },
-            "minItems": 1,
-            "uniqueItems": true,
-            "description": "Effective metadata agent chain (canonicalized/sorted)"
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
           }
-        },
-        "example": {
-          "orgId": "acme",
-          "agentIds": [
-            "opx",
-            "fieldstone"
-          ]
-        }
-      },
-      "ConnectorCatalogEntry": {
-        "type": "object",
-        "required": [
-          "id",
-          "version",
-          "protocol",
-          "enabled",
-          "framework",
-          "displayName",
-          "capabilities",
-          "isSource",
-          "isTarget",
-          "origin"
         ],
-        "properties": {
-          "id": {
-            "type": "string",
-            "description": "Connector package id (connectorRef)"
-          },
-          "version": {
-            "type": "string"
-          },
-          "protocol": {
-            "type": "string",
-            "example": "memorix-connector/1"
-          },
-          "enabled": {
-            "type": "boolean"
-          },
-          "framework": {
-            "type": "boolean"
-          },
-          "displayName": {
-            "type": "string"
-          },
-          "capabilities": {
-            "type": "object",
-            "additionalProperties": true
-          },
-          "connectorRole": {
-            "type": "string",
-            "enum": [
-              "source",
-              "target",
-              "both"
-            ],
-            "nullable": true,
-            "description": "Authoritative direction when set (prefer over id suffix)."
-          },
-          "isSource": {
-            "type": "boolean"
-          },
-          "isTarget": {
-            "type": "boolean"
-          },
-          "origin": {
-            "type": "string",
-            "enum": [
-              "registry",
-              "builtin",
-              "generic-connectors"
-            ]
-          },
-          "hostBaseUrl": {
-            "type": "string",
-            "description": "MGC host base when origin is generic-connectors"
-          },
-          "remoteHosting": {
-            "type": "boolean"
-          },
-          "unavailableReason": {
-            "type": "string",
-            "description": "Set when the row is listed but not usable (e.g. host URL unset for stubs)"
-          },
-          "definitionHash": {
-            "type": "string",
-            "description": "Pinned hash from host catalog when available"
-          },
-          "description": {
-            "type": "string"
-          },
-          "purpose": {
-            "type": "string"
-          },
-          "classification": {
-            "type": "string",
-            "description": "Domain classification from pack catalog (e.g. cybersecurity)"
-          },
-          "tags": {
-            "type": "array",
-            "items": {
-              "type": "string"
+        "responses": {
+          "200": {
+            "description": "Counters for the organization",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "items"
+                  ],
+                  "properties": {
+                    "items": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/AnalyticsCounter"
+                      }
+                    }
+                  }
+                }
+              }
             }
           },
-          "usageModel": {
-            "type": "string",
-            "enum": [
-              "stream",
-              "service"
-            ],
-            "description": "stream = continuous sync; service = on-demand enrichment. Protocol role remains source|target only."
+          "503": {
+            "description": "Analytics counters unavailable (no Mongo, or MEMORIX_ANALYTICS=0)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
           }
         }
       },
-      "MemorixIdentifier": {
-        "type": "object",
-        "required": [
-          "kind",
-          "value"
+      "post": {
+        "operationId": "analyticsCountersRegister",
+        "summary": "Register a counter; results are read from its target record with GET /api/data/content",
+        "tags": [
+          "Analytics"
         ],
-        "properties": {
-          "kind": {
-            "type": "string"
-          },
-          "value": {
-            "type": "string"
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
           },
-          "issuer": {
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
           },
-          "normalizedValue": {
-            "type": "string"
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
           }
-        }
-      },
-      "MemorixRecordV2": {
-        "type": "object",
-        "required": [
-          "format",
-          "recordId",
-          "revision",
-          "objectType",
-          "contentType",
-          "dataCategory",
-          "concept",
-          "data",
-          "_system"
         ],
-        "properties": {
-          "format": {
-            "type": "string",
-            "enum": [
-              "memorix-record/2"
-            ]
-          },
-          "recordId": {
-            "type": "string"
-          },
-          "revision": {
-            "type": "integer",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "definition"
+                ],
+                "properties": {
+                  "definition": {
+                    "type": "object",
+                    "additionalProperties": true,
+                    "description": "An analytics definition (same shape as a pack analytics[] item). A measure, group, or split may name abstractType, or objectType plus contentType and a stored property path."
+                  },
+                  "replace": {
+                    "type": "boolean",
+                    "description": "Rebuild when a counter with this id exists with a different definition"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Accepted; the counter backfills once, then stays current from writes",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "status",
+                    "counter"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    },
+                    "counter": {
+                      "$ref": "#/components/schemas/AnalyticsCounter"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Definition invalid (error.details.issues)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Id taken by a pack or built-in counter, definition differs without replace, or target already used",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Analytics counters unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/analytics/counters/validate": {
+      "post": {
+        "operationId": "analyticsCountersValidate",
+        "summary": "Validate a counter definition without registering it",
+        "tags": [
+          "Analytics"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "definition": {
+                    "type": "object",
+                    "additionalProperties": true
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Validation result",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "ok",
+                    "issues"
+                  ],
+                  "properties": {
+                    "ok": {
+                      "type": "boolean"
+                    },
+                    "issues": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Analytics counters unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/analytics/counters/{id}": {
+      "get": {
+        "operationId": "analyticsCounterGet",
+        "summary": "Counter status, backfill progress, target address and lastMaterializedAt",
+        "tags": [
+          "Analytics"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Counter",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AnalyticsCounter"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Counter not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Analytics counters unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "analyticsCounterDelete",
+        "summary": "Unregister an API-registered counter (pack counters are removed from the pack)",
+        "tags": [
+          "Analytics"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Removed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "removed": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Counter not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Pack or built-in counter",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Analytics counters unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/analytics/counters/{id}/rebuild": {
+      "post": {
+        "operationId": "analyticsCounterRebuild",
+        "summary": "Drop the counter's cells and ledger, then backfill again",
+        "tags": [
+          "Analytics"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted; the counter backfills once, then stays current from writes",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "status",
+                    "counter"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    },
+                    "counter": {
+                      "$ref": "#/components/schemas/AnalyticsCounter"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Counter not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Analytics counters unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/analytics/source-census": {
+      "get": {
+        "operationId": "analyticsSourceCensus",
+        "summary": "Current records by data source (built-in @datasources counter)",
+        "tags": [
+          "Analytics"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Census",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "ok",
+                    "censusId",
+                    "timestamp",
+                    "status",
+                    "subjects",
+                    "heads"
+                  ],
+                  "properties": {
+                    "ok": {
+                      "type": "boolean"
+                    },
+                    "censusId": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "timestamp": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "live",
+                        "backfilling",
+                        "error",
+                        "disabled"
+                      ]
+                    },
+                    "subjects": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "system",
+                          "name",
+                          "total",
+                          "kinds"
+                        ],
+                        "properties": {
+                          "system": {
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "total": {
+                            "type": "integer"
+                          },
+                          "kinds": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "required": [
+                                "kind",
+                                "label",
+                                "count"
+                              ],
+                              "properties": {
+                                "kind": {
+                                  "type": "string"
+                                },
+                                "label": {
+                                  "type": "string"
+                                },
+                                "count": {
+                                  "type": "integer"
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "heads": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "system",
+                          "name",
+                          "total",
+                          "kinds"
+                        ],
+                        "properties": {
+                          "system": {
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "total": {
+                            "type": "integer"
+                          },
+                          "kinds": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "required": [
+                                "kind",
+                                "label",
+                                "count"
+                              ],
+                              "properties": {
+                                "kind": {
+                                  "type": "string"
+                                },
+                                "label": {
+                                  "type": "string"
+                                },
+                                "count": {
+                                  "type": "integer"
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "parameters": {
+      "XMemorixOrgId": {
+        "name": "x-memorix-org-id",
+        "in": "header",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": "Organization / data-universe id"
+      },
+      "XMemorixAgentIds": {
+        "name": "x-memorix-agent-ids",
+        "in": "header",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": "Comma-separated agentIds for effective metadata",
+        "example": "ops,fieldstone"
+      },
+      "XMemorixCaller": {
+        "name": "x-memorix-caller",
+        "in": "header",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[a-zA-Z0-9@][a-zA-Z0-9._@/-]*$"
+        },
+        "description": "MX-CALLER-01: calling application id (e.g. synapix-lander, map-store, memorix-studio, @x12i/memorix-client)",
+        "example": "memorix-studio"
+      }
+    },
+    "schemas": {
+      "MemorixScope": {
+        "type": "object",
+        "required": [
+          "orgId",
+          "agentIds"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "orgId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Data universe / org isolation key"
+          },
+          "agentIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 1,
+            "uniqueItems": true,
+            "description": "Effective metadata agent chain (canonicalized/sorted)"
+          }
+        },
+        "example": {
+          "orgId": "acme",
+          "agentIds": [
+            "opx",
+            "fieldstone"
+          ]
+        }
+      },
+      "ConnectorCatalogEntry": {
+        "type": "object",
+        "required": [
+          "id",
+          "version",
+          "protocol",
+          "enabled",
+          "framework",
+          "displayName",
+          "capabilities",
+          "isSource",
+          "isTarget",
+          "origin"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Connector package id (connectorRef)"
+          },
+          "version": {
+            "type": "string"
+          },
+          "protocol": {
+            "type": "string",
+            "example": "memorix-connector/1"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "framework": {
+            "type": "boolean"
+          },
+          "displayName": {
+            "type": "string"
+          },
+          "capabilities": {
+            "type": "object",
+            "additionalProperties": true
+          },
+          "connectorRole": {
+            "type": "string",
+            "enum": [
+              "source",
+              "target",
+              "both"
+            ],
+            "nullable": true,
+            "description": "Authoritative direction when set (prefer over id suffix)."
+          },
+          "isSource": {
+            "type": "boolean"
+          },
+          "isTarget": {
+            "type": "boolean"
+          },
+          "origin": {
+            "type": "string",
+            "enum": [
+              "registry",
+              "builtin",
+              "generic-connectors"
+            ]
+          },
+          "hostBaseUrl": {
+            "type": "string",
+            "description": "MGC host base when origin is generic-connectors"
+          },
+          "remoteHosting": {
+            "type": "boolean"
+          },
+          "unavailableReason": {
+            "type": "string",
+            "description": "Set when the row is listed but not usable (e.g. host URL unset for stubs)"
+          },
+          "definitionHash": {
+            "type": "string",
+            "description": "Pinned hash from host catalog when available"
+          },
+          "description": {
+            "type": "string"
+          },
+          "purpose": {
+            "type": "string"
+          },
+          "classification": {
+            "type": "string",
+            "description": "Domain classification from pack catalog (e.g. cybersecurity)"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "usageModel": {
+            "type": "string",
+            "enum": [
+              "stream",
+              "service"
+            ],
+            "description": "stream = continuous sync; service = on-demand enrichment. Protocol role remains source|target only."
+          }
+        }
+      },
+      "MemorixIdentifier": {
+        "type": "object",
+        "required": [
+          "kind",
+          "value"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          },
+          "issuer": {
+            "type": "string"
+          },
+          "normalizedValue": {
+            "type": "string"
+          }
+        }
+      },
+      "MemorixRecordV2": {
+        "type": "object",
+        "required": [
+          "format",
+          "recordId",
+          "revision",
+          "objectType",
+          "contentType",
+          "dataCategory",
+          "concept",
+          "data",
+          "_system"
+        ],
+        "properties": {
+          "format": {
+            "type": "string",
+            "enum": [
+              "memorix-record/2"
+            ]
+          },
+          "recordId": {
+            "type": "string"
+          },
+          "revision": {
+            "type": "integer",
             "minimum": 1
           },
           "objectType": {
@@ -14319,7 +14914,29 @@
           "origin": { "type": "string" },
           "channel": { "type": "string" },
           "originRecordId": { "type": "string" },
-          "originAt": { "type": "string", "format": "date-time" }
+          "originAt": { "type": "string", "format": "date-time" },
+          "sources": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["system", "name"],
+              "properties": { "system": { "type": "string" }, "name": { "type": "string" } }
+            }
+          }
+        }
+      },
+      "DatasourceSourcesDeclaration": {
+        "description": "Connector the record came from; the census and @datasource groups file it under sources[0]. Replaces stored sources; null or [] clears them; omit to keep them.",
+        "type": "array",
+        "nullable": true,
+        "maxItems": 8,
+        "items": {
+          "type": "object",
+          "required": ["system", "name"],
+          "properties": {
+            "system": { "type": "string", "pattern": "^[a-zA-Z0-9@][a-zA-Z0-9._@/-]*$", "maxLength": 128 },
+            "name": { "type": "string", "minLength": 1, "maxLength": 128 }
+          }
         }
       },
       "PublicationMember": {
@@ -16256,6 +16873,134 @@
             }
           }
         }
+      },
+      "AnalyticsCounter": {
+        "type": "object",
+        "required": [
+          "id",
+          "origin",
+          "status",
+          "generation",
+          "target",
+          "backfill"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "origin": {
+            "type": "string",
+            "enum": [
+              "pack",
+              "api",
+              "builtin"
+            ]
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "backfilling",
+              "live",
+              "error"
+            ]
+          },
+          "generation": {
+            "type": "integer"
+          },
+          "hash": {
+            "type": "string"
+          },
+          "agentIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "target": {
+            "type": [
+              "object",
+              "null"
+            ],
+            "properties": {
+              "objectType": {
+                "type": "string"
+              },
+              "contentType": {
+                "type": "string"
+              },
+              "recordId": {
+                "type": "string"
+              }
+            }
+          },
+          "history": {
+            "type": [
+              "object",
+              "null"
+            ],
+            "additionalProperties": true
+          },
+          "backfill": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "cursor": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "done": {
+                  "type": "boolean"
+                },
+                "seen": {
+                  "type": "integer"
+                }
+              }
+            }
+          },
+          "registeredAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "registeredBy": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "updatedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "liveAt": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "date-time"
+          },
+          "lastMaterializedAt": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "date-time"
+          },
+          "error": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
       }
     }
   }