@burdenoff/mcp-libs 2026.1014.4 → 2026.1026.1

package/dist/modules/semanticfed/index.d.ts

@@ -1,8 +1,3 @@
-import { c as McpModule } from '../../module-VpgjAf8m.js';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-import '../../context-DGO4h-Pd.js';
-import 'graphql-request';
-
+import type { McpModule } from '../../core/index.js';
 declare const semanticfedModule: McpModule;
-
-export { semanticfedModule as default };
+export default semanticfedModule;

package/dist/modules/semanticfed/index.js

@@ -1,4 +1,4 @@
-import { mcpToolName, errorResult, jsonResult, mcpResourceUri, mcpPromptName } from '../../chunk-G76DKEPI.js';
+import { mcpToolName, errorResult, jsonResult, mcpResourceUri, mcpPromptName } from '../../chunk-FHXCNP2U.js';
 import { z } from 'zod';
 
 // src/modules/semanticfed/operations.ts
@@ -309,6 +309,23 @@ var LIST_QUERY_RUNS = `
     }
   }
 `;
+var GET_QUERY_RUN = `
+  query SemQueryRun($id: ID!) {
+    semQueryRun(id: $id) {
+      ${QUERY_RUN_FIELDS}
+    }
+  }
+`;
+var GET_QUERY_RUN_RESULT = `
+  query SemQueryRunResult($runId: ID!, $pagination: PaginationInput) {
+    semQueryRunResult(runId: $runId, pagination: $pagination) {
+      runId queryId
+      columns { name entity field aggregation masked mask }
+      rows rowCount totalRowCount truncated expiresAt offset limit nextOffset
+      ${PAGE_INFO}
+    }
+  }
+`;
 var LIST_ACCESS_POLICIES = `
   query SemListAccessPolicies($modelId: ID, $entityId: ID) {
     semListAccessPolicies(modelId: $modelId, entityId: $entityId) {
@@ -1378,6 +1395,52 @@ function registerRunTools(server, ctx, track) {
       }
     }
   );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "query_runs_get")),
+    {
+      title: "Get Query Run",
+      description: "Fetch one query run by ID: status (QUEUED -> PLANNING -> RUNNING -> SUCCEEDED / FAILED), rowCount, plan summary with the access-policy decisions, and the error message of a failed run. Poll this after queries_run.",
+      inputSchema: { id: z.string().describe("Query run ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_QUERY_RUN, { id });
+        if (!data.semQueryRun) return errorResult(`Query run ${id} not found`);
+        return jsonResult(data.semQueryRun);
+      } catch (error) {
+        ctx.logger.error("semanticfed query_runs_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get query run: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "query_runs_result")),
+    {
+      title: "Get Query Run Result",
+      description: "Read the result rows of a SUCCEEDED query run you started: column metadata plus a page of row objects, exactly as the engine produced them under your access policies (filtered rows are absent, masked columns come back masked as NULL / [REDACTED] / hmac:...). Page with limit (default 100, max 500) and offset (nextOffset of the previous page). Results are capped (see truncated / totalRowCount) and expire (expiresAt); run the query again after that.",
+      inputSchema: {
+        runId: z.string().describe("Query run ID (must be SUCCEEDED)"),
+        limit: z.number().int().optional().describe("Rows per page (default 100, max 500)"),
+        offset: z.number().int().min(0).optional().describe("nextOffset from the previous page; omit for the first page")
+      }
+    },
+    async ({ runId, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_QUERY_RUN_RESULT, {
+          runId,
+          pagination: { limit: limit ?? 100, offset: offset ?? 0 }
+        });
+        return jsonResult(data.semQueryRunResult);
+      } catch (error) {
+        ctx.logger.error("semanticfed query_runs_result failed", { error: String(error) });
+        return errorResult(
+          `Failed to read query run result: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
 }
 function registerPolicyTools(server, ctx, track) {
   server.registerTool(
@@ -1727,7 +1790,8 @@ Show results at each step and confirm before publishing.`
 2. **Govern**: Use ${p}_access_policies_create to add a row/column access policy (principal, effect, scope) and ${p}_access_policies_set_active to enable it.
 3. **Publish**: Use ${p}_queries_publish to move the query to PUBLISHED.
 4. **Execute**: Use ${p}_queries_run to enqueue a federated execution; it returns a run record.
-5. **Inspect**: Poll ${p}_query_runs_list (filter by status) to watch QUEUED \u2192 PLANNING \u2192 RUNNING \u2192 SUCCEEDED and read rowCount / sourcesTouched / planSummary.
+5. **Inspect**: Poll ${p}_query_runs_get (or ${p}_query_runs_list filtered by status) to watch QUEUED \u2192 PLANNING \u2192 RUNNING \u2192 SUCCEEDED and read rowCount / sourcesTouched / planSummary.
+6. **Read results**: Call ${p}_query_runs_result with the run id to page through the governed rows (masked columns stay masked; filtered rows are absent).
 
 Summarize what needs attention after each step.`
             }