fix(powerbi): generate docs entirely from source

Author: Bill Leoutsakos

apps/docs/content/docs/integrations/powerbi.mdx

@@ -10,24 +10,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
   color="#FFFFFF"
 />
 
-{/* MANUAL-CONTENT-START:intro */}
-[Power BI](https://www.microsoft.com/en-us/power-platform/products/power-bi) is Microsoft's analytics platform. Use this block to list named workspaces, inspect reports and semantic models, run one DAX query, request a standard semantic-model refresh, and read refresh history.
-
-Connect a home-tenant organizational account through the **Power BI** Microsoft connection. Existing Microsoft Graph connections cannot substitute for it. Self-hosted installations use the existing Microsoft client environment variables and register `/api/auth/oauth2/callback/microsoft-powerbi` as a Web redirect URI. This version supports delegated OAuth only, without Credential Groups or service principals.
-
-**Execute DAX Query** requires the tenant's **Dataset Execute Queries REST API** setting, workspace access, and Read and Build permissions on the semantic model. Submit one DAX query that returns one table. The API limits each query to 100,000 rows or 1,000,000 values, 15 MB of returned data, and 120 query requests per minute per user. Dynamic column names are preserved. An HTTP 200 response can contain an error with partial rows; any reported query error fails the action. Connect the block's error port to handle its standard `error` output. Failed workflow outputs omit query fields, including partial rows, `errors`, and `incomplete`; successful queries expose the declared outputs. Direct tool responses retain available partial rows and typed errors, but those fields are unavailable to downstream workflow blocks after failure. See Microsoft's [Execute Queries documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/execute-queries-in-group).
-
-**Refresh Semantic Model** requests a standard refresh and returns acceptance immediately. Acceptance does not mean the refresh completed. Use **Get Refresh History** separately to inspect status; it requires write permission on the model. `Unknown` can mean a refresh is in progress or its completion state is unknown. Standard refresh is subject to capacity limits, including eight refresh requests per day on shared capacity. See Microsoft's [refresh documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/refresh-dataset-in-group) and [refresh history documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/get-refresh-history-in-group).
-
-Read-only semantic models may return only their ID and name, and paginated reports may have no semantic-model ID. Missing optional fields are represented as `null`, so their absence does not imply a permission or feature capability.
-
-Workspace listing supports a result limit, offset, and OData filter. Reports and semantic models return the provider's flat list; Sim does not invent pagination for them. Provider JSON readers are bounded to 20 MiB; workflow actions also use Sim's stricter 10 MiB inline tool-response budget. Keep DAX results small with summaries or `TOPN`. My Workspace, cross-tenant guest configuration, impersonation, enhanced refresh, report exports, dashboards, and triggers are outside this version.
-{/* MANUAL-CONTENT-END */}
-
-
 ## Usage Instructions
 
-Connect Power BI to your workflows with a delegated organizational Microsoft account. List accessible workspaces, reports, and semantic models; retrieve report and model details; execute one DAX query; request a standard semantic model refresh; and inspect refresh history. DAX queries require Read and Build permissions and the tenant Execute Queries setting. Refresh history requires model Write permission. Refresh requests return acceptance immediately; use a separate history operation to check their status.
+Connect a home-tenant organizational account through the Power BI Microsoft connection to list named workspaces, inspect reports and semantic models, execute DAX queries, request standard refreshes, and read refresh history. Microsoft Graph connections cannot substitute for this delegated OAuth connection. See the [self-hosted OAuth setup](/platform/self-hosting/integrations-oauth#microsoft) for app registration and the Power BI callback URI. Workspace listing supports a result limit, offset, and OData filter; reports and semantic models return flat lists. Read-only models may contain only their ID and name, and paginated reports may omit their semantic-model ID. Missing optional fields are null and do not establish permission or feature availability. Keep results small with summaries or TOPN: provider JSON reads are limited to 20 MiB, and workflow tool responses have a stricter 10 MiB inline budget. My Workspace, cross-tenant guest configuration, Credential Groups, service principals, impersonation, enhanced refresh, report exports, dashboards, and triggers are outside this version.
 
 
 
@@ -132,7 +117,7 @@ Get semantic model metadata from a Power BI workspace.
 
 ### Power BI Execute DAX Query
 
-Execute one DAX query against a semantic model and detect reported query errors.
+Execute one DAX query returning one table from a semantic model. Requires workspace access, Read and Build permissions, and the tenant Dataset Execute Queries REST API setting. Power BI limits each query to 100,000 rows or 1,000,000 values, 15 MB of data, and 120 requests per minute per user. Dynamic column names are preserved. Any reported query error fails the action, including errors returned with HTTP 200. Connect the block's error port to handle its standard error output. Failed workflow outputs omit query fields, including partial rows, errors, and incomplete; successful queries expose the declared outputs. Direct tool responses retain available partial rows and typed errors, but downstream workflow blocks cannot access them after failure. See the [Execute Queries documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/execute-queries-in-group).
 
 #### Input
 
@@ -157,7 +142,7 @@ Execute one DAX query against a semantic model and detect reported query errors.
 
 ### Power BI Refresh Semantic Model
 
-Request a standard asynchronous semantic model refresh; acceptance does not mean completion.
+Request a standard asynchronous semantic model refresh and return acceptance immediately. Acceptance does not mean completion; use Get Refresh History separately to inspect status. Shared capacity allows eight refresh requests per day, including scheduled refreshes. See the [refresh documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/refresh-dataset-in-group).
 
 #### Input
 
@@ -177,7 +162,7 @@ Request a standard asynchronous semantic model refresh; acceptance does not mean
 
 ### Power BI Get Refresh History
 
-Get recent semantic model refresh history; requires Write permission on the model.
+Get recent semantic model refresh history; requires Write permission on the model. Unknown can mean a refresh is in progress or its completion state is unknown. See the [refresh history documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/get-refresh-history-in-group).
 
 #### Input
 

apps/sim/blocks/blocks/powerbi.ts

@@ -25,8 +25,7 @@ export const PowerBIBlock: BlockConfig = {
   type: 'powerbi',
   name: 'Power BI',
   description: 'Query semantic models and manage reports and refreshes',
-  longDescription:
-    'Connect Power BI to your workflows with a delegated organizational Microsoft account. List accessible workspaces, reports, and semantic models; retrieve report and model details; execute one DAX query; request a standard semantic model refresh; and inspect refresh history. DAX queries require Read and Build permissions and the tenant Execute Queries setting. Refresh history requires model Write permission. Refresh requests return acceptance immediately; use a separate history operation to check their status.',
+  longDescription: `Connect a home-tenant organizational account through the Power BI Microsoft connection to list named workspaces, inspect reports and semantic models, execute DAX queries, request standard refreshes, and read refresh history. Microsoft Graph connections cannot substitute for this delegated OAuth connection. See the [self-hosted OAuth setup](/platform/self-hosting/integrations-oauth#microsoft) for app registration and the Power BI callback URI. Workspace listing supports a result limit, offset, and OData filter; reports and semantic models return flat lists. Read-only models may contain only their ID and name, and paginated reports may omit their semantic-model ID. Missing optional fields are null and do not establish permission or feature availability. Keep results small with summaries or TOPN: provider JSON reads are limited to 20 MiB, and workflow tool responses have a stricter 10 MiB inline budget. My Workspace, cross-tenant guest configuration, Credential Groups, service principals, impersonation, enhanced refresh, report exports, dashboards, and triggers are outside this version.`,
   docsLink: 'https://docs.sim.ai/integrations/powerbi',
   category: 'tools',
   integrationType: IntegrationType.Analytics,

apps/sim/tools/generated/tool-metadata.ts

@@ -25,7 +25,7 @@ export const powerbiExecuteQueryTool: ToolConfig<
 > = {
   id: 'powerbi_execute_query',
   name: 'Power BI Execute DAX Query',
-  description: 'Execute one DAX query against a semantic model and detect reported query errors.',
+  description: `Execute one DAX query returning one table from a semantic model. Requires workspace access, Read and Build permissions, and the tenant Dataset Execute Queries REST API setting. Power BI limits each query to 100,000 rows or 1,000,000 values, 15 MB of data, and 120 requests per minute per user. Dynamic column names are preserved. Any reported query error fails the action, including errors returned with HTTP 200. Connect the block's error port to handle its standard error output. Failed workflow outputs omit query fields, including partial rows, errors, and incomplete; successful queries expose the declared outputs. Direct tool responses retain available partial rows and typed errors, but downstream workflow blocks cannot access them after failure. See the [Execute Queries documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/execute-queries-in-group).`,
   version: '1.0.0',
   errorExtractor: 'nested-error-object',
   oauth: { required: true, provider: 'microsoft-powerbi' },

apps/sim/tools/powerbi/execute-query.ts

@@ -22,7 +22,7 @@ export const powerbiGetRefreshHistoryTool: ToolConfig<
 > = {
   id: 'powerbi_get_refresh_history',
   name: 'Power BI Get Refresh History',
-  description: 'Get recent semantic model refresh history; requires Write permission on the model.',
+  description: `Get recent semantic model refresh history; requires Write permission on the model. Unknown can mean a refresh is in progress or its completion state is unknown. See the [refresh history documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/get-refresh-history-in-group).`,
   version: '1.0.0',
   errorExtractor: 'nested-error-object',
   oauth: { required: true, provider: 'microsoft-powerbi' },

apps/sim/tools/powerbi/get-refresh-history.ts

@@ -17,8 +17,7 @@ export const powerbiRefreshDatasetTool: ToolConfig<
 > = {
   id: 'powerbi_refresh_dataset',
   name: 'Power BI Refresh Semantic Model',
-  description:
-    'Request a standard asynchronous semantic model refresh; acceptance does not mean completion.',
+  description: `Request a standard asynchronous semantic model refresh and return acceptance immediately. Acceptance does not mean completion; use Get Refresh History separately to inspect status. Shared capacity allows eight refresh requests per day, including scheduled refreshes. See the [refresh documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/refresh-dataset-in-group).`,
   version: '1.0.0',
   errorExtractor: 'nested-error-object',
   oauth: { required: true, provider: 'microsoft-powerbi' },

apps/sim/tools/powerbi/refresh-dataset.ts

@@ -18462,7 +18462,7 @@
       "slug": "power-bi",
       "name": "Power BI",
       "description": "Query semantic models and manage reports and refreshes",
-      "longDescription": "Connect Power BI to your workflows with a delegated organizational Microsoft account. List accessible workspaces, reports, and semantic models; retrieve report and model details; execute one DAX query; request a standard semantic model refresh; and inspect refresh history. DAX queries require Read and Build permissions and the tenant Execute Queries setting. Refresh history requires model Write permission. Refresh requests return acceptance immediately; use a separate history operation to check their status.",
+      "longDescription": "Connect a home-tenant organizational account through the Power BI Microsoft connection to list named workspaces, inspect reports and semantic models, execute DAX queries, request standard refreshes, and read refresh history. Microsoft Graph connections cannot substitute for this delegated OAuth connection. See the [self-hosted OAuth setup](/platform/self-hosting/integrations-oauth#microsoft) for app registration and the Power BI callback URI. Workspace listing supports a result limit, offset, and OData filter; reports and semantic models return flat lists. Read-only models may contain only their ID and name, and paginated reports may omit their semantic-model ID. Missing optional fields are null and do not establish permission or feature availability. Keep results small with summaries or TOPN: provider JSON reads are limited to 20 MiB, and workflow tool responses have a stricter 10 MiB inline budget. My Workspace, cross-tenant guest configuration, Credential Groups, service principals, impersonation, enhanced refresh, report exports, dashboards, and triggers are outside this version.",
       "bgColor": "#FFFFFF",
       "iconName": "PowerBIIcon",
       "docsUrl": "https://docs.sim.ai/integrations/powerbi",
@@ -18489,15 +18489,15 @@
         },
         {
           "name": "Execute DAX Query",
-          "description": "Execute one DAX query against a semantic model and detect reported query errors."
+          "description": ""
         },
         {
           "name": "Refresh Semantic Model",
-          "description": "Request a standard asynchronous semantic model refresh; acceptance does not mean completion."
+          "description": "Request a standard asynchronous semantic model refresh and return acceptance immediately. Acceptance does not mean completion; use Get Refresh History separately to inspect status. Shared capacity allows eight refresh requests per day, including scheduled refreshes. See the [refresh documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/refresh-dataset-in-group)."
         },
         {
           "name": "Get Refresh History",
-          "description": "Get recent semantic model refresh history; requires Write permission on the model."
+          "description": "Get recent semantic model refresh history; requires Write permission on the model. Unknown can mean a refresh is in progress or its completion state is unknown. See the [refresh history documentation](https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/get-refresh-history-in-group)."
         }
       ],
       "operationCount": 8,