[admin] merge to live

fabric/item/dataAgent/definition/topicsManifest/1.0.0/schema.json

@@ -0,0 +1,43 @@
+{
+  "$id": "https://developer.microsoft.com/json-schemas/fabric/item/dataAgent/definition/topicsManifest/1.0.0/schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Data Agent Topics Manifest",
+  "description": "The manifest of topics associated with a data source. Maps each topic's stable id to its human-readable markdown file name. The topic bodies live in sibling .md files referenced by fileName.",
+  "properties": {
+    "$schema": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "The schema version of the topics manifest file (e.g., \"1.0.0\")."
+    },
+    "topics": {
+      "type": [
+        "array",
+        "null"
+      ],
+      "description": "The list of topics for this data source, sorted by id for deterministic export.",
+      "items": {
+        "type": "object",
+        "title": "Data Agent Topic",
+        "description": "Represents a single topic and the markdown file that holds its body. The topic's display name and description live in the markdown YAML frontmatter of the body file, not in this manifest.",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "The stable, rename-safe identifier of the topic (a GUID).",
+            "format": "uuid"
+          },
+          "fileName": {
+            "type": "string",
+            "description": "The file name of the topic body in OneLake (e.g., \"company-policies.md\"). Must end with \".md\", contain only alphanumeric characters, hyphens, and underscores, and be unique within the data source. Maximum length is 256 characters.",
+            "pattern": "^[A-Za-z0-9_-]+\\.md$",
+            "maxLength": 256
+          }
+        },
+        "required": [ "id", "fileName" ]
+      }
+    }
+  },
+  "required": [ "$schema" ]
+}

fabric/item/operationsAgents/definition/1.0.0/schema.json

@@ -8,7 +8,7 @@
     "configuration": {
       "type": "object",
       "title": "Operations Agent Configuration",
-      "description": "User specified configuration containing instructions, data sources, actions, message destination, and identity of the agent.",
+      "description": "User specified configuration containing instructions, data sources, actions, message destination, and user-provided identity fields of the agent.",
       "properties": {
         "instructions": {
           "type": "string",
@@ -237,24 +237,11 @@
     },
     "agentIdentity": {
       "type": "object",
-      "description": "Identity information for the agent, used for agent OBO / app-only scenarios on ALM import/export.",
+      "description": "User-provided identity settings for definition payloads. Server-generated identity fields are read-only and excluded.",
       "properties": {
-        "principalId": {
-          "type": "string",
-          "description": "The principal ID for the agent identity."
-        },
-        "blueprintId": {
-          "type": "string",
-          "description": "The agent identity blueprint ID."
-        },
-        "mode": {
-          "type": "string",
-          "enum": ["Delegated"],
-          "description": "Execution mode."
-        },
         "sponsor": {
           "type": "string",
-          "description": "The UPN of the sponsor user. Required when messageDestination is a non-Recipient kind."
+          "description": "Sponsor alias provided by the user."
         }
       },
       "additionalProperties": false

fabric/item/plan/definition/Definition/1.0.0/schema.json

@@ -5,6 +5,7 @@
   "type": "object",
   "required": [
     "$schema",
+    "workloadItemName",
     "semanticModelReference",
     "sheets"
   ],
@@ -14,6 +15,10 @@
       "format": "uri",
       "const": "https://developer.microsoft.com/json-schemas/fabric/item/plan/definition/definition/1.0.0/schema.json"
     },
+    "workloadItemName": {
+      "type": "string",
+      "description": "User-facing name of the workload item."
+    },
     "semanticModelReference": {
       "$ref": "#/definitions/SemanticModelReference"
     },
@@ -30,16 +35,60 @@
     "SemanticModelReference": {
       "type": "object",
       "description": "Reference to the semantic model backing this plan.",
-      "required": [
-        "connection",
-        "semanticModel"
+      "anyOf": [
+        {
+          "required": [
+            "connection",
+            "semanticModel"
+          ]
+        },
+        {
+          "required": [
+            "connectionId",
+            "semanticModelId",
+            "semanticModelName",
+            "semanticModelWorkspaceId",
+            "semanticModelWorkspaceName",
+            "directLakeMode",
+            "directQueryMode",
+            "sourceType"
+          ]
+        }
       ],
       "properties": {
         "connection": {
           "$ref": "https://developer.microsoft.com/json-schemas/fabric/common/connectionReference/1.0.0/schema.json#/definitions/ConnectionReferenceOrVar"
         },
         "semanticModel": {
           "$ref": "https://developer.microsoft.com/json-schemas/fabric/common/itemReference/1.0.0/schema.json#/definitions/ItemReferenceOrVar"
+        },
+        "connectionId": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "semanticModelId": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "semanticModelName": {
+          "type": "string"
+        },
+        "semanticModelWorkspaceId": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "semanticModelWorkspaceName": {
+          "type": "string"
+        },
+        "directLakeMode": {
+          "type": "boolean"
+        },
+        "directQueryMode": {
+          "type": "boolean"
+        },
+        "sourceType": {
+          "type": "string",
+          "enum": ["POWERTABLE", "INFOBRIDGE", "WORKLOAD"]
         }
       },
       "additionalProperties": false
@@ -48,15 +97,15 @@
       "type": "object",
       "description": "A sheet declaration within the plan.",
       "required": [
-        "id",
         "displayName",
-        "sheetType"
+        "sheetType",
+        "recordGuid"
       ],
       "properties": {
-        "id": {
+         "recordGuid": {
           "type": "string",
           "format": "uuid",
-          "description": "Unique identifier for the sheet."
+          "description": "Unique identifier for the sheet record."
         },
         "displayName": {
           "type": "string",
@@ -66,10 +115,43 @@
           "type": "string",
           "description": "The type of sheet.",
           "enum": [
-            "Planning",
-            "PowerTable",
-            "Intelligence"
+            "PLANNING",
+            "REPORTING",
+            "POWERTABLE",
+            "INFOBRIDGE",
+            "SUPER_FILTER",
+            "BI_REPORTING",
+            "BI_ADHOC_ANALYSIS",
+            "BI_DASHBOARD"
           ]
+        },
+        "isHidden": {
+          "type": "boolean",
+          "description": "Indicates if the sheet is hidden."
+        },
+        "order": {
+          "type": "number",
+          "description": "Order of the sheet within the report."
+        },
+        "workloadItemEntityVisuals": {
+          "type": "array",
+          "description": "List of visuals associated with the sheet.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "visualType": {
+                "type": "string",
+                "description": "Type of the visual.",
+                "enum": ["POWERTABLE", "PLANNING", "INFO_BRIDGE"]
+              },
+              "visualId": {
+                "type": "string",
+                "format": "uuid",
+                "description": "Unique identifier for the visual."
+              }
+            },
+            "additionalProperties": false
+          }
         }
       },
       "additionalProperties": false