@superblocksteam/mcp-server 2.0.0-SNAPSHOT.06fa243c132fe1fb

package/dist/tools/get-application-structure.js

@@ -0,0 +1,98 @@
+import fs from "fs-extra";
+import { ExportViewMode } from "@superblocksteam/shared";
+import { buildDirectoryTreeSummary } from "../application/directory-tree.js";
+import { materializeApplication } from "../application/materialize-application.js";
+import { applicationModeLabel, applicationModeNote, summarizeMultiPageApplicationStructure, } from "../application/summary.js";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { getApplicationStructureInputSchema, resolveAppTarget, } from "../target/resolve-app-target.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+const DEFAULT_DIRECTORY_TREE_ENTRY_LIMIT = 200;
+export const getApplicationStructure = {
+    name: "get_application_structure",
+    title: "Get Application Structure",
+    description: "Fetch a Superblocks application structure summary. For Clark AI Apps this returns a bounded checkout tree and temp path. Provide either app_url or application_id plus base_url.",
+    inputSchema: schemas.getApplicationStructureToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(getApplicationStructureInputSchema, args);
+        const target = resolveAppTarget(input);
+        const auth = await resolveAuthForOrigin(target.baseUrl);
+        const sdk = createSdk(auth.token, target.baseUrl);
+        const application = await sdk.fetchApplicationWithComponents({
+            applicationId: target.applicationId,
+            branch: target.branch,
+            viewMode: ExportViewMode.EXPORT_LIVE,
+        });
+        if (!application) {
+            throw new Error(`Application ${target.applicationId} was not found.`);
+        }
+        if (application.type === "multi-page") {
+            const mode = "1.0";
+            return {
+                ...summarizeMultiPageApplicationStructure(application),
+                application_mode_label: applicationModeLabel(mode),
+                application_mode_note: applicationModeNote(mode),
+                application_id: target.applicationId,
+                auth_source: auth.source,
+                base_url: target.baseUrl,
+                branch: target.branch,
+                environment: target.environment,
+                resolved_from: target.resolvedFrom,
+            };
+        }
+        const materialized = await materializeApplication({
+            sdk,
+            application,
+            branch: target.branch,
+        });
+        const cleanupRootPath = materialized.isTemporary
+            ? materialized.temporaryRootPath
+            : undefined;
+        if (materialized.isTemporary && !cleanupRootPath) {
+            throw new Error(`Expected temporaryRootPath for temporary checkout: ${materialized.checkoutPath}`);
+        }
+        try {
+            const directoryTree = await buildDirectoryTreeSummary(materialized.checkoutPath, {
+                exclude: new Set([".superblocks"]),
+                maxEntries: input.max_entries ?? DEFAULT_DIRECTORY_TREE_ENTRY_LIMIT,
+            });
+            const mode = "2.0";
+            return {
+                application_id: target.applicationId,
+                application_mode: mode,
+                application_mode_label: applicationModeLabel(mode),
+                application_mode_note: applicationModeNote(mode),
+                auth_source: auth.source,
+                base_url: target.baseUrl,
+                branch: target.branch,
+                checkout_is_temporary: materialized.isTemporary,
+                checkout_path: materialized.isTemporary
+                    ? null
+                    : materialized.checkoutPath,
+                directory_tree: directoryTree.entries,
+                environment: target.environment,
+                resolved_from: target.resolvedFrom,
+                tree_truncated: directoryTree.truncated,
+            };
+        }
+        finally {
+            if (cleanupRootPath) {
+                try {
+                    await fs.remove(cleanupRootPath);
+                }
+                catch {
+                    // Best-effort cleanup; do not mask primary result or error.
+                }
+            }
+        }
+    },
+};
+//# sourceMappingURL=get-application-structure.js.map

package/dist/tools/get-application-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-application-structure.js","sourceRoot":"","sources":["../../src/tools/get-application-structure.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-application-summary.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const getApplicationSummary: ToolDefinition;
+//# sourceMappingURL=get-application-summary.d.ts.map

package/dist/tools/get-application-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-application-summary.d.ts","sourceRoot":"","sources":["../../src/tools/get-application-summary.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,eAAO,MAAM,qBAAqB,EAAE,cAwCnC,CAAC"}

package/dist/tools/get-application-summary.js

@@ -0,0 +1,46 @@
+import { ExportViewMode } from "@superblocksteam/shared";
+import { applicationModeLabel, applicationModeNote, summarizeApplication, } from "../application/summary.js";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { appTargetInputSchema, resolveAppTarget, } from "../target/resolve-app-target.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+export const getApplicationSummary = {
+    name: "get_application_summary",
+    title: "Get Application Summary",
+    description: "Fetch a Superblocks application summary, including the owning organization ID, app mode, deployed commit ID when available, and resolved environment. Provide either app_url or application_id plus base_url.",
+    inputSchema: schemas.appTargetToolInputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(appTargetInputSchema, args);
+        const target = resolveAppTarget(input);
+        const auth = await resolveAuthForOrigin(target.baseUrl);
+        const sdk = createSdk(auth.token, target.baseUrl);
+        const application = await sdk.fetchApplication({
+            applicationId: target.applicationId,
+            branch: target.branch,
+            viewMode: ExportViewMode.EXPORT_LIVE,
+        });
+        if (!application) {
+            throw new Error(`Application ${target.applicationId} was not found.`);
+        }
+        const summary = summarizeApplication(application);
+        return {
+            ...summary,
+            application_mode_label: applicationModeLabel(summary.application_mode),
+            application_mode_note: applicationModeNote(summary.application_mode),
+            auth_source: auth.source,
+            base_url: target.baseUrl,
+            branch: target.branch,
+            environment: target.environment,
+            resolved_from: target.resolvedFrom,
+        };
+    },
+};
+//# sourceMappingURL=get-application-summary.js.map

package/dist/tools/get-application-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-application-summary.js","sourceRoot":"","sources":["../../src/tools/get-application-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,IAAI,EAAE,yBAAyB;IAC/B,KAAK,EAAE,yBAAyB;IAChC,WAAW,EACT,+MAA+M;IACjN,WAAW,EAAE,OAAO,CAAC,wBAAwB;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD,QAAQ,EAAE,UAAU;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,cAAc,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC;YAC7C,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,cAAc,CAAC,WAAW;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,CAAC,aAAa,iBAAiB,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAClD,OAAO;YACL,GAAG,OAAO;YACV,sBAAsB,EAAE,oBAAoB,CAAC,OAAO,CAAC,gBAAgB,CAAC;YACtE,qBAAqB,EAAE,mBAAmB,CAAC,OAAO,CAAC,gBAAgB,CAAC;YACpE,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,QAAQ,EAAE,MAAM,CAAC,OAAO;YACxB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,MAAM,CAAC,YAAY;SACnC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/get-audit-events.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const getAuditEvents: ToolDefinition;
+//# sourceMappingURL=get-audit-events.d.ts.map

package/dist/tools/get-audit-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-audit-events.d.ts","sourceRoot":"","sources":["../../src/tools/get-audit-events.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,eAAO,MAAM,cAAc,EAAE,cAkD5B,CAAC"}

package/dist/tools/get-audit-events.js

@@ -0,0 +1,55 @@
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { getAuditEventsInputSchema, resolveBaseUrlTarget, } from "../target/resolve-base-url-target.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+export const getAuditEvents = {
+    name: "get_audit_events",
+    title: "Get Audit Events",
+    description: "Fetch v2 audit events (OCSF) for the current organization in a time range, with cursor pagination and OCSF filters. Use list_audit_event_types to discover all available class_uid, resource_type, and operation values for filtering.\n\n" +
+        "IMPORTANT — API execution double-counting: API execution events (class_uid=6003) are logged as start/completion pairs. " +
+        "Each execution produces two events with the same timestamp: a start event (status_id=99, no duration) and a completion event " +
+        "(status_id=1 for success or status_id=2 for failure, includes duration in ms). " +
+        "To count unique executions, filter to status_id != 99 (i.e. exclude IN_PROGRESS) or divide the raw class_uid=6003 count by 2.",
+    inputSchema: schemas.getAuditEventsToolInputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(getAuditEventsInputSchema, args);
+        const target = resolveBaseUrlTarget(input);
+        const auth = await resolveAuthForOrigin(target.baseUrl);
+        const sdk = createSdk(auth.token, target.baseUrl);
+        const response = await sdk.fetchAuditEvents({
+            activityId: input.activity_id,
+            applicationId: input.application_id,
+            timeStart: input.time_start,
+            timeEnd: input.time_end,
+            classUid: input.class_uid,
+            status: input.status,
+            severity: input.severity,
+            actor: input.actor,
+            resourceType: input.resource_type,
+            resourceId: input.resource_id,
+            search: input.search,
+            cursor: input.cursor,
+            limit: input.limit,
+        });
+        if (!Array.isArray(response?.events)) {
+            throw new Error("Invalid audit events response from SDK");
+        }
+        return {
+            events: response.events,
+            next_cursor: response.next_cursor,
+            auth_source: auth.source,
+            base_url: target.baseUrl,
+            environment: target.environment,
+            total_count: response.events.length,
+        };
+    },
+};
+//# sourceMappingURL=get-audit-events.js.map

package/dist/tools/get-audit-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-audit-events.js","sourceRoot":"","sources":["../../src/tools/get-audit-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,kBAAkB;IACzB,WAAW,EACT,4OAA4O;QAC5O,yHAAyH;QACzH,+HAA+H;QAC/H,iFAAiF;QACjF,+HAA+H;IACjI,WAAW,EAAE,OAAO,CAAC,6BAA6B;IAClD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD,QAAQ,EAAE,UAAU;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,cAAc,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC;YAC1C,UAAU,EAAE,KAAK,CAAC,WAAW;YAC7B,aAAa,EAAE,KAAK,CAAC,cAAc;YACnC,SAAS,EAAE,KAAK,CAAC,UAAU;YAC3B,OAAO,EAAE,KAAK,CAAC,QAAQ;YACvB,QAAQ,EAAE,KAAK,CAAC,SAAS;YACzB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,KAAK,CAAC,aAAa;YACjC,UAAU,EAAE,KAAK,CAAC,WAAW;YAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,QAAQ,EAAE,MAAM,CAAC,OAAO;YACxB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM;SACpC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/get-auth-status.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const getAuthStatus: ToolDefinition;
+//# sourceMappingURL=get-auth-status.d.ts.map

package/dist/tools/get-auth-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-auth-status.d.ts","sourceRoot":"","sources":["../../src/tools/get-auth-status.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,eAAO,MAAM,aAAa,EAAE,cA8B3B,CAAC"}

package/dist/tools/get-auth-status.js

@@ -0,0 +1,34 @@
+import { getAuthSetupHint, getAuthStatusForOrigin, } from "../auth/resolve-auth.js";
+import { authStatusInputSchema, resolveOriginTarget, } from "../target/resolve-app-target.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+export const getAuthStatus = {
+    name: "get_auth_status",
+    title: "Get Auth Status",
+    description: "Check whether the current user is authenticated for a Superblocks environment derived from either an app_url or a base_url.",
+    inputSchema: schemas.authStatusToolInputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(authStatusInputSchema, args);
+        const target = resolveOriginTarget(input);
+        const authStatus = await getAuthStatusForOrigin(target.baseUrl);
+        return {
+            authenticated: authStatus.authenticated,
+            auth_source: authStatus.source,
+            base_url: target.baseUrl,
+            environment: target.environment,
+            resolved_from: target.resolvedFrom,
+            setup_hint: authStatus.authenticated
+                ? undefined
+                : getAuthSetupHint(target.baseUrl),
+            updated_at: authStatus.updatedAt,
+        };
+    },
+};
+//# sourceMappingURL=get-auth-status.js.map

package/dist/tools/get-auth-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-auth-status.js","sourceRoot":"","sources":["../../src/tools/get-auth-status.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,6HAA6H;IAC/H,WAAW,EAAE,OAAO,CAAC,yBAAyB;IAC9C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACrB;IACD,QAAQ,EAAE,UAAU;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,cAAc,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEhE,OAAO;YACL,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,WAAW,EAAE,UAAU,CAAC,MAAM;YAC9B,QAAQ,EAAE,MAAM,CAAC,OAAO;YACxB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,MAAM,CAAC,YAAY;YAClC,UAAU,EAAE,UAAU,CAAC,aAAa;gBAClC,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC;YACpC,UAAU,EAAE,UAAU,CAAC,SAAS;SACjC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/get-billing-plan-summary.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const getBillingPlanSummary: ToolDefinition;
+//# sourceMappingURL=get-billing-plan-summary.d.ts.map

package/dist/tools/get-billing-plan-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-billing-plan-summary.d.ts","sourceRoot":"","sources":["../../src/tools/get-billing-plan-summary.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,eAAO,MAAM,qBAAqB,EAAE,cA4BnC,CAAC"}

package/dist/tools/get-billing-plan-summary.js

@@ -0,0 +1,32 @@
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { billingBaseUrlInputSchema, resolveBaseUrlTarget, } from "../target/resolve-base-url-target.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+export const getBillingPlanSummary = {
+    name: "get_billing_plan_summary",
+    title: "Get Billing Plan Summary",
+    description: "Get the current billing plan summary including credit allocation, usage, billing cycle dates, and deployed application counts. Requires billing:manage permission.",
+    inputSchema: schemas.getBillingPlanSummaryToolInputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(billingBaseUrlInputSchema, args);
+        const target = resolveBaseUrlTarget(input);
+        const auth = await resolveAuthForOrigin(target.baseUrl);
+        const sdk = createSdk(auth.token, target.baseUrl);
+        const summary = await sdk.fetchBillingPlanSummary();
+        return {
+            auth_source: auth.source,
+            base_url: target.baseUrl,
+            environment: target.environment,
+            plan: summary,
+        };
+    },
+};
+//# sourceMappingURL=get-billing-plan-summary.js.map

package/dist/tools/get-billing-plan-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-billing-plan-summary.js","sourceRoot":"","sources":["../../src/tools/get-billing-plan-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,IAAI,EAAE,0BAA0B;IAChC,KAAK,EAAE,0BAA0B;IACjC,WAAW,EACT,oKAAoK;IACtK,WAAW,EAAE,OAAO,CAAC,oCAAoC;IACzD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD,QAAQ,EAAE,UAAU;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,cAAc,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAElD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,uBAAuB,EAAE,CAAC;QAEpD,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,QAAQ,EAAE,MAAM,CAAC,OAAO;YACxB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/get-billing-usage-daily.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const getBillingUsageDaily: ToolDefinition;
+//# sourceMappingURL=get-billing-usage-daily.d.ts.map

package/dist/tools/get-billing-usage-daily.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-billing-usage-daily.d.ts","sourceRoot":"","sources":["../../src/tools/get-billing-usage-daily.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,eAAO,MAAM,oBAAoB,EAAE,cAqClC,CAAC"}

package/dist/tools/get-billing-usage-daily.js

@@ -0,0 +1,37 @@
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { billingDateRangeInputSchema, resolveBaseUrlTarget, } from "../target/resolve-base-url-target.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+export const getBillingUsageDaily = {
+    name: "get_billing_usage_daily",
+    title: "Get Billing Usage (Daily)",
+    description: "Get daily AI credit usage for a date range. Returns one row per day with the total credits consumed. Requires billing:manage permission.",
+    inputSchema: schemas.getBillingUsageDailyToolInputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(billingDateRangeInputSchema, args);
+        const target = resolveBaseUrlTarget(input);
+        const auth = await resolveAuthForOrigin(target.baseUrl);
+        const sdk = createSdk(auth.token, target.baseUrl);
+        const rows = await sdk.fetchBillingUsageDaily(input.start_date, input.end_date);
+        const totalCredits = rows.reduce((sum, r) => sum + r.creditsUsed, 0);
+        return {
+            auth_source: auth.source,
+            base_url: target.baseUrl,
+            daily_usage: rows,
+            end_date: input.end_date,
+            environment: target.environment,
+            start_date: input.start_date,
+            total_credits: totalCredits,
+            total_days: rows.length,
+        };
+    },
+};
+//# sourceMappingURL=get-billing-usage-daily.js.map

package/dist/tools/get-billing-usage-daily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-billing-usage-daily.js","sourceRoot":"","sources":["../../src/tools/get-billing-usage-daily.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,IAAI,EAAE,yBAAyB;IAC/B,KAAK,EAAE,2BAA2B;IAClC,WAAW,EACT,0IAA0I;IAC5I,WAAW,EAAE,OAAO,CAAC,mCAAmC;IACxD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD,QAAQ,EAAE,UAAU;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,cAAc,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAElD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,sBAAsB,CAC3C,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,QAAQ,CACf,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAErE,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,QAAQ,EAAE,MAAM,CAAC,OAAO;YACxB,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,aAAa,EAAE,YAAY;YAC3B,UAAU,EAAE,IAAI,CAAC,MAAM;SACxB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/get-billing-usage-records.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const getBillingUsageRecords: ToolDefinition;
+//# sourceMappingURL=get-billing-usage-records.d.ts.map

package/dist/tools/get-billing-usage-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-billing-usage-records.d.ts","sourceRoot":"","sources":["../../src/tools/get-billing-usage-records.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAiMpD,eAAO,MAAM,sBAAsB,EAAE,cAiIpC,CAAC"}

package/dist/tools/get-billing-usage-records.js

@@ -0,0 +1,246 @@
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { billingUsageRecordsInputSchema, resolveBaseUrlTarget, } from "../target/resolve-base-url-target.js";
+import { applyPagination } from "./pagination.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+const NO_CHECKPOINT_LABEL = "No checkpoint";
+function buildCheckpointRollup(rows) {
+    const byCheckpoint = new Map();
+    let noCheckpoint = null;
+    for (const row of rows) {
+        // Treat a null, undefined, or empty checkpointId as "no checkpoint" so a
+        // malformed/empty id never becomes a phantom checkpoint entry. All credit
+        // sums are `?? 0`-guarded: the wire shape is a hand-maintained mirror with
+        // no runtime validation, and an absent numeric field must degrade a row to
+        // a 0 contribution, never NaN (NaN serializes to null and would silently
+        // corrupt the whole response's total).
+        if (!row.checkpointId) {
+            if (noCheckpoint === null) {
+                noCheckpoint = {
+                    application_id: row.applicationId,
+                    application_name: row.applicationName,
+                    checkpoint_id: null,
+                    checkpoint_label: NO_CHECKPOINT_LABEL,
+                    credits_used: 0,
+                    last_activity_date: row.date,
+                    on_demand_credits_used: 0,
+                    unbilled_credits_used: 0,
+                };
+            }
+            else if (noCheckpoint.application_id !== row.applicationId) {
+                // The bucket folds rows from more than one application (or a row with
+                // no application at all), so it is not attributable to a single app.
+                // Under an application_id filter every folded row shares one app, so
+                // this branch never fires and the bucket keeps that app's id/name.
+                noCheckpoint.application_id = null;
+                noCheckpoint.application_name = null;
+            }
+            noCheckpoint.credits_used += row.creditsUsed ?? 0;
+            noCheckpoint.on_demand_credits_used += row.onDemandCreditsUsed ?? 0;
+            noCheckpoint.unbilled_credits_used += row.unbilledCreditsUsed ?? 0;
+            if (row.date > noCheckpoint.last_activity_date) {
+                noCheckpoint.last_activity_date = row.date;
+            }
+            continue;
+        }
+        const existing = byCheckpoint.get(row.checkpointId) ?? {
+            application_id: row.applicationId,
+            application_name: row.applicationName,
+            checkpoint_id: row.checkpointId,
+            checkpoint_label: row.checkpointLabel,
+            credits_used: 0,
+            last_activity_date: row.date,
+            on_demand_credits_used: 0,
+            unbilled_credits_used: 0,
+        };
+        existing.credits_used += row.creditsUsed ?? 0;
+        existing.on_demand_credits_used += row.onDemandCreditsUsed ?? 0;
+        existing.unbilled_credits_used += row.unbilledCreditsUsed ?? 0;
+        existing.checkpoint_label ??= row.checkpointLabel;
+        existing.application_id ??= row.applicationId;
+        existing.application_name ??= row.applicationName;
+        if (row.date > existing.last_activity_date) {
+            existing.last_activity_date = row.date;
+        }
+        byCheckpoint.set(row.checkpointId, existing);
+    }
+    const checkpoints = [...byCheckpoint.values()].sort((a, b) => b.credits_used - a.credits_used ||
+        b.last_activity_date.localeCompare(a.last_activity_date) ||
+        (a.checkpoint_id ?? "").localeCompare(b.checkpoint_id ?? ""));
+    if (noCheckpoint) {
+        // The "No checkpoint" bucket is always last, regardless of its credit total, so real checkpoints stay top-ranked.
+        checkpoints.push(noCheckpoint);
+    }
+    return checkpoints;
+}
+function matchesAppFilters(row, input) {
+    if (input.application_id && row.applicationId !== input.application_id) {
+        return false;
+    }
+    if (input.usage_type && row.usageType !== input.usage_type) {
+        return false;
+    }
+    return true;
+}
+function summarizePagination(paged) {
+    return {
+        has_more: paged.has_more,
+        limit: paged.limit,
+        next_offset: paged.next_offset,
+        offset: paged.offset,
+        returned_count: paged.returned_count,
+        total_count: paged.total_count,
+    };
+}
+function buildApplicationAggregates({ applicationUsageRows, dollarLedgerRows, }) {
+    const byApplication = new Map();
+    if (dollarLedgerRows.length > 0) {
+        for (const row of dollarLedgerRows) {
+            if (!row.applicationId) {
+                continue;
+            }
+            const existing = byApplication.get(row.applicationId) ?? {
+                amount_cents: 0,
+                application_id: row.applicationId,
+                application_name: row.applicationName,
+                credits: null,
+            };
+            existing.amount_cents = (existing.amount_cents ?? 0) + row.amountCents;
+            existing.application_name ??= row.applicationName;
+            byApplication.set(row.applicationId, existing);
+        }
+        return [...byApplication.values()].sort((a, b) => (b.amount_cents ?? 0) - (a.amount_cents ?? 0) ||
+            (a.application_name ?? "").localeCompare(b.application_name ?? "") ||
+            a.application_id.localeCompare(b.application_id));
+    }
+    for (const row of applicationUsageRows) {
+        if (!row.applicationId) {
+            continue;
+        }
+        const existing = byApplication.get(row.applicationId) ?? {
+            amount_cents: null,
+            application_id: row.applicationId,
+            application_name: row.applicationName,
+            credits: 0,
+        };
+        existing.credits = (existing.credits ?? 0) + (row.creditsUsed ?? 0);
+        byApplication.set(row.applicationId, existing);
+    }
+    return [...byApplication.values()].sort((a, b) => (b.credits ?? 0) - (a.credits ?? 0) ||
+        (a.application_name ?? "").localeCompare(b.application_name ?? "") ||
+        a.application_id.localeCompare(b.application_id));
+}
+export const getBillingUsageRecords = {
+    name: "get_billing_usage_records",
+    title: "Get Billing Usage Records",
+    description: "Get AI credit billing usage for a date range, rolled up per checkpoint (an accepted AI change). Each entry has checkpoint_id, checkpoint_label (the checkpoint's commit message; null when the commit had no message), application, credits_used, and overage splits. Usage not attributable to any checkpoint (history from before checkpoint tracking shipped, never-accepted prompts, and agent or utility usage) is aggregated into a single trailing entry with checkpoint_id null — expected, not missing data; older date ranges fall mostly in that bucket. Because that entry sorts last, it may sit past the requested page; no_checkpoint_credits always reports its credit total for the whole filtered range, so compare it against total_credits before summarizing a partial page. checkpoint_data_available is false when the server predates checkpoint rollups (no_checkpoint_credits is then null — unknowable, not zero). App filters (application_id, usage_type) scope every surface, including checkpoints. Pagination (limit/offset) applies only to the checkpoints list; by_application, dollar_ledger_records, and top_users are always full summaries. by_application credits are an independent server-side per-application total and are not expected to equal the sum of that application's checkpoints. Requires billing:manage permission.",
+    inputSchema: schemas.getBillingUsageRecordsToolInputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(billingUsageRecordsInputSchema, args);
+        const target = resolveBaseUrlTarget(input);
+        const auth = await resolveAuthForOrigin(target.baseUrl);
+        const sdk = createSdk(auth.token, target.baseUrl);
+        const response = await sdk.fetchBillingUsageRecordsResponse(input.start_date, input.end_date);
+        const hasAppScopedFilter = Boolean(input.application_id || input.usage_type);
+        const dollarLedgerRows = (response.dollarLedgerRows ?? []).filter((row) => matchesAppFilters(row, input));
+        const applicationUsageRows = (response.applicationUsageRows ?? []).filter((row) => matchesAppFilters(row, input));
+        const byApplication = buildApplicationAggregates({
+            applicationUsageRows,
+            dollarLedgerRows,
+        });
+        // Two separate questions. `hasUsageGroupRows` — did the server send the
+        // rollup collection? — drives which source computes the totals, so they
+        // always reconcile with `checkpoints`. `checkpoint_data_available` — does
+        // the server actually map usage to checkpoints? — is the presence of the
+        // checkpointId FIELD on the rows, not merely of the array: a pre-checkpoint
+        // server (the state between #20020 and #20888 landing) returns
+        // usageGroupRows with no checkpointId, and must report false so a consumer
+        // can tell "no rollup capability" from "rollup present, nothing mapped yet".
+        const usageGroupRows = response.usageGroupRows;
+        const hasUsageGroupRows = Array.isArray(usageGroupRows);
+        const checkpointDataAvailable = Array.isArray(usageGroupRows) &&
+            (usageGroupRows.length === 0 ||
+                usageGroupRows.some((row) => "checkpointId" in row));
+        const filteredGroupRows = (usageGroupRows ?? []).filter((row) => {
+            if (input.application_id && row.applicationId !== input.application_id) {
+                return false;
+            }
+            // Checkpoint rollups are AI-credit usage; any other usage type excludes them.
+            if (input.usage_type && input.usage_type !== "ai_credits") {
+                return false;
+            }
+            return true;
+        });
+        const allCheckpoints = buildCheckpointRollup(filteredGroupRows);
+        // The trailing bucket sorts last, so pagination can leave it off the page
+        // while total_credits still includes it. This scalar keeps the unattributed
+        // total visible to consumers that never page. null = pre-rollup server,
+        // where attributability is unknowable (distinct from a known 0).
+        const noCheckpointCredits = hasUsageGroupRows
+            ? (allCheckpoints.find((c) => c.checkpoint_id === null)?.credits_used ??
+                0)
+            : null;
+        const legacyRows = hasAppScopedFilter ? [] : response.rows;
+        // Every legacy path gets the same `?? 0` guard as the usageGroupRows path:
+        // these are hand-maintained wire mirrors with no runtime validation, and
+        // one absent creditsUsed must degrade that row to 0, never NaN-poison the
+        // total (NaN serializes to null and silently corrupts the response).
+        const totalCredits = hasUsageGroupRows
+            ? filteredGroupRows.reduce((sum, r) => sum + (r.creditsUsed ?? 0), 0)
+            : hasAppScopedFilter
+                ? // Sum real per-app credits from applicationUsageRows: by_application's
+                    // `credits` is null in dollar-ledger mode, which would zero the total.
+                    applicationUsageRows.reduce((sum, r) => sum + (r.creditsUsed ?? 0), 0)
+                : legacyRows.reduce((sum, r) => sum + (r.creditsUsed ?? 0), 0);
+        const byUser = new Map();
+        const userRows = hasUsageGroupRows ? filteredGroupRows : legacyRows;
+        for (const r of userRows) {
+            if (!r.email) {
+                continue;
+            }
+            byUser.set(r.email, (byUser.get(r.email) ?? 0) + (r.creditsUsed ?? 0));
+        }
+        const topUsers = [...byUser.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([email, credits]) => ({ email, credits }));
+        // `checkpoints` is the primary list and the only paginated collection; the
+        // pagination fields always describe it. `by_application`, `top_users`, and
+        // `dollar_ledger_records` are full app-scoped summaries, never paginated.
+        const checkpointPagination = applyPagination(allCheckpoints, {
+            limit: input.limit,
+            offset: input.offset,
+        });
+        const checkpoints = checkpointPagination.page;
+        const pageInfo = summarizePagination(checkpointPagination);
+        return {
+            auth_source: auth.source,
+            base_url: target.baseUrl,
+            by_application: byApplication,
+            checkpoint_data_available: checkpointDataAvailable,
+            checkpoints,
+            dollar_ledger_records: dollarLedgerRows,
+            end_date: input.end_date,
+            environment: target.environment,
+            has_more: pageInfo.has_more,
+            limit: pageInfo.limit,
+            next_offset: pageInfo.next_offset,
+            no_checkpoint_credits: noCheckpointCredits,
+            offset: pageInfo.offset,
+            returned_count: pageInfo.returned_count,
+            start_date: input.start_date,
+            top_users: topUsers,
+            total_count: pageInfo.total_count,
+            total_credits: totalCredits,
+        };
+    },
+};
+//# sourceMappingURL=get-billing-usage-records.js.map