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

package/dist/tools/deactivate-user.d.ts

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

package/dist/tools/deactivate-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deactivate-user.d.ts","sourceRoot":"","sources":["../../src/tools/deactivate-user.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAuBpD,eAAO,MAAM,cAAc,EAAE,cA0F5B,CAAC"}

package/dist/tools/deactivate-user.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { detectEnvironment, normalizeBaseUrl } from "../urls.js";
+import * as schemas from "./schemas.js";
+import { callServerApi } from "./server-api.js";
+import { parseToolInput } from "./validation.js";
+// Must match GroupType.ALL_USERS from @superblocksteam/shared
+const ALL_USERS_GROUP_TYPE = 0;
+const deactivateUserInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    user_id: z.string().uuid(),
+    reason: z
+        .string()
+        .trim()
+        .min(1)
+        .optional()
+        .describe("Echoed in the response for the caller's own logging; not persisted server-side."),
+})
+    .strict();
+export const deactivateUser = {
+    name: "deactivate_user",
+    title: "Deactivate User",
+    description: "Deactivate a user account by user_id for incident response. " +
+        "This removes the user from all groups, revokes their RBAC assignments, and prevents them from logging in. " +
+        "Requires org admin privileges. Optionally include a reason, which is echoed back in the response for the caller's own logging.",
+    inputSchema: schemas.deactivateUserToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    audience: "internal",
+    async handler(args) {
+        const input = parseToolInput(deactivateUserInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const sdk = createSdk(auth.token, baseUrl);
+        // Resolve the current user's organization ID.
+        const currentUser = await sdk.fetchCurrentUser();
+        const organizationId = currentUser.user.currentOrganizationId;
+        // Fetch the target user's details (we need their email for the group
+        // operations API that performs the actual deactivation).
+        const targetUser = (await callServerApi({
+            baseUrl,
+            token: auth.token,
+            method: "GET",
+            path: `/api/v1/organizations/${organizationId}/users/${input.user_id}`,
+        }));
+        if (!targetUser?.email) {
+            throw new Error(`Could not resolve email for user ${input.user_id}. The user may not exist in this organization.`);
+        }
+        // List organization groups and locate the "All Users" group.
+        const groupsResponse = (await callServerApi({
+            baseUrl,
+            token: auth.token,
+            method: "GET",
+            path: `/api/v1/organizations/${organizationId}/groups`,
+        }));
+        if (!Array.isArray(groupsResponse?.groups)) {
+            throw new Error("Unexpected response shape from groups endpoint.");
+        }
+        const allUsersGroup = groupsResponse.groups.find((g) => g.type === ALL_USERS_GROUP_TYPE);
+        if (!allUsersGroup) {
+            throw new Error("Could not find the All Users group in the organization.");
+        }
+        // Remove the user from the All Users group. On the server this triggers
+        // the full deactivation flow: sets the deactivated timestamp, deletes
+        // RBAC assignments, revokes pending invitations, and emits cloud events.
+        const result = (await callServerApi({
+            baseUrl,
+            token: auth.token,
+            method: "POST",
+            path: `/api/v1/organizations/${organizationId}/groups/${allUsersGroup.id}`,
+            body: {
+                operations: [{ email: targetUser.email, action: "REMOVE_MEMBER" }],
+            },
+        }));
+        if (result && typeof result === "object" && "errors" in result) {
+            throw new Error(`User deactivation may have failed. Server response: ${JSON.stringify(result)}`);
+        }
+        return {
+            result,
+            user_id: input.user_id,
+            user_email: targetUser.email,
+            reason: input.reason,
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+        };
+    },
+};
+//# sourceMappingURL=deactivate-user.js.map

package/dist/tools/deactivate-user.js.map

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

package/dist/tools/delete-folder.d.ts

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

package/dist/tools/delete-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-folder.d.ts","sourceRoot":"","sources":["../../src/tools/delete-folder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAWpD,eAAO,MAAM,YAAY,EAAE,cA6B1B,CAAC"}

package/dist/tools/delete-folder.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { detectEnvironment, normalizeBaseUrl } from "../urls.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+const deleteFolderInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    folder_id: z.string().uuid(),
+})
+    .strict();
+export const deleteFolder = {
+    name: "delete_folder",
+    title: "Delete Folder",
+    description: "Delete a folder by folder ID.",
+    inputSchema: schemas.deleteFolderToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(deleteFolderInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const sdk = createSdk(auth.token, baseUrl);
+        const folder = await sdk.deleteFolder(input.folder_id);
+        return {
+            // Some server responses may be 204/empty for deletes; return a stable confirmation shape.
+            deleted: true,
+            folder_id: input.folder_id,
+            ...(folder ? { folder } : {}),
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+        };
+    },
+};
+//# sourceMappingURL=delete-folder.js.map

package/dist/tools/delete-folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-folder.js","sourceRoot":"","sources":["../../src/tools/delete-folder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,uBAAuB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE,+BAA+B;IAC5C,WAAW,EAAE,OAAO,CAAC,2BAA2B;IAChD,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,IAAI;KACpB;IACD,QAAQ,EAAE,UAAU;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,cAAc,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEvD,OAAO;YACL,0FAA0F;YAC1F,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC;SACxC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/delete-group-org-role.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const deleteGroupOrgRole: ToolDefinition;
+//# sourceMappingURL=delete-group-org-role.d.ts.map

package/dist/tools/delete-group-org-role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-group-org-role.d.ts","sourceRoot":"","sources":["../../src/tools/delete-group-org-role.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAcpD,eAAO,MAAM,kBAAkB,EAAE,cAyChC,CAAC"}

package/dist/tools/delete-group-org-role.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { resolveCurrentOrganizationId } from "../auth/resolve-current-organization.js";
+import { detectEnvironment, normalizeBaseUrl } from "../urls.js";
+import * as schemas from "./schemas.js";
+import { callServerApi } from "./server-api.js";
+import { parseToolInput } from "./validation.js";
+const deleteGroupOrgRoleInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    group_id: z.string().uuid(),
+    assignment_record_id: z.string().uuid(),
+    organization_id: z.string().uuid().optional(),
+})
+    .strict();
+export const deleteGroupOrgRole = {
+    name: "delete_group_org_role",
+    title: "Delete Group Org Role",
+    description: "Remove a group's organization-level role assignment by assignment record ID. " +
+        "This uses the dedicated org group role endpoint, not the generic RBAC assignment API. " +
+        "Use list_rbac_assignments to find the assignment_record_id. " +
+        "Requires group management privileges.",
+    inputSchema: schemas.deleteGroupOrgRoleToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(deleteGroupOrgRoleInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const organizationId = input.organization_id ??
+            (await resolveCurrentOrganizationId(baseUrl, auth.token));
+        const result = await callServerApi({
+            baseUrl,
+            token: auth.token,
+            method: "DELETE",
+            path: `/api/v1/organizations/${organizationId}/groups/${input.group_id}/role/${input.assignment_record_id}`,
+        });
+        return {
+            result,
+            group_id: input.group_id,
+            assignment_record_id: input.assignment_record_id,
+            organization_id: organizationId,
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+        };
+    },
+};
+//# sourceMappingURL=delete-group-org-role.js.map

package/dist/tools/delete-group-org-role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-group-org-role.js","sourceRoot":"","sources":["../../src/tools/delete-group-org-role.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,6BAA6B,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,uBAAuB;IAC7B,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,+EAA+E;QAC/E,wFAAwF;QACxF,8DAA8D;QAC9D,uCAAuC;IACzC,WAAW,EAAE,OAAO,CAAC,iCAAiC;IACtD,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,IAAI;KACpB;IACD,QAAQ,EAAE,UAAU;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,cAAc,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,cAAc,GAClB,KAAK,CAAC,eAAe;YACrB,CAAC,MAAM,4BAA4B,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAE5D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;YACjC,OAAO;YACP,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,yBAAyB,cAAc,WAAW,KAAK,CAAC,QAAQ,SAAS,KAAK,CAAC,oBAAoB,EAAE;SAC5G,CAAC,CAAC;QAEH,OAAO;YACL,MAAM;YACN,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;YAChD,eAAe,EAAE,cAAc;YAC/B,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC;SACxC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/delete-integration.d.ts

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

package/dist/tools/delete-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-integration.d.ts","sourceRoot":"","sources":["../../src/tools/delete-integration.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAWpD,eAAO,MAAM,iBAAiB,EAAE,cA0B/B,CAAC"}

package/dist/tools/delete-integration.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { detectEnvironment, normalizeBaseUrl } from "../urls.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+const deleteIntegrationInputSchema = z
+    .object({
+    integration_id: z.string().uuid(),
+    base_url: z.string().url(),
+})
+    .strict();
+export const deleteIntegration = {
+    name: "delete_integration",
+    title: "Delete Integration",
+    description: "Delete an integration by ID.",
+    inputSchema: schemas.deleteIntegrationToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(deleteIntegrationInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const sdk = createSdk(auth.token, baseUrl);
+        const integration = await sdk.deleteIntegration(input.integration_id);
+        return {
+            integration,
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+        };
+    },
+};
+//# sourceMappingURL=delete-integration.js.map

package/dist/tools/delete-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-integration.js","sourceRoot":"","sources":["../../src/tools/delete-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,4BAA4B,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC3B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,8BAA8B;IAC3C,WAAW,EAAE,OAAO,CAAC,gCAAgC;IACrD,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,IAAI;KACpB;IACD,QAAQ,EAAE,UAAU;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,cAAc,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAEtE,OAAO;YACL,WAAW;YACX,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC;SACxC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/deploy-application.d.ts

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

package/dist/tools/deploy-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-application.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-application.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAwEpD,eAAO,MAAM,iBAAiB,EAAE,cAkG/B,CAAC"}

package/dist/tools/deploy-application.js

@@ -0,0 +1,142 @@
+import { z } from "zod";
+import { DEFAULT_BRANCH } from "@superblocksteam/sdk";
+import { CommitType } from "@superblocksteam/shared";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { resolveAppTarget, } from "../target/resolve-app-target.js";
+import * as schemas from "./schemas.js";
+import { callServerApi } from "./server-api.js";
+import { parseToolInput } from "./validation.js";
+const copiedCommitSchema = z.object({
+    commitId: z.string().min(1),
+});
+const applicationBranchesSchema = z.object({
+    branches: z.array(z.object({
+        isDefault: z.boolean(),
+        name: z.string(),
+    })),
+});
+const CHECKPOINT_AUTOSAVE_TYPE_PREFIX = "savepoint";
+const HISTORY_PAGE_SIZE = 50;
+function compareCommits(left, right) {
+    const dateDifference = right.commitDate - left.commitDate;
+    return dateDifference || right.commitId.localeCompare(left.commitId);
+}
+function isDeployableCommit(commit) {
+    // Keep this aligned with the UI's selectCheckpoints selector.
+    return (!commit.autosave ||
+        commit.autosaveType?.startsWith(CHECKPOINT_AUTOSAVE_TYPE_PREFIX));
+}
+/**
+ * A checkpoint exists only as an autosave, which the server refuses to deploy.
+ * Copying it produces an ordinary commit with the same contents, the same step
+ * the UI takes before publishing one.
+ */
+async function copyCheckpointToCommit(options) {
+    const copiedCommit = copiedCommitSchema.parse(await callServerApi({
+        baseUrl: options.baseUrl,
+        method: "POST",
+        path: `/api/v2/applications/${options.applicationId}/commit/${encodeURIComponent(options.commitId)}/copy`,
+        token: options.token,
+    }));
+    return copiedCommit.commitId;
+}
+const deployApplicationInputSchema = z.union([
+    z
+        .object({
+        app_url: z.string().url(),
+        commit_id: z.string().trim().min(1).optional(),
+    })
+        .strict(),
+    z
+        .object({
+        application_id: z.string().uuid(),
+        base_url: z.string().url(),
+        commit_id: z.string().trim().min(1).optional(),
+    })
+        .strict(),
+]);
+export const deployApplication = {
+    name: "deploy_application",
+    title: "Deploy Application",
+    description: "Deploy a Superblocks application from its default branch. Supports either app_url or application_id plus base_url. Optionally pass commit_id to deploy a specific commit.",
+    inputSchema: schemas.deployApplicationToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(deployApplicationInputSchema, args);
+        const targetInput = "app_url" in input
+            ? { app_url: input.app_url }
+            : {
+                application_id: input.application_id,
+                base_url: input.base_url,
+            };
+        const target = resolveAppTarget(targetInput);
+        const auth = await resolveAuthForOrigin(target.baseUrl);
+        const sdk = createSdk(auth.token, target.baseUrl);
+        const normalizedCommitId = input.commit_id?.toUpperCase() === "HEAD" ? "HEAD" : input.commit_id;
+        const shouldResolveHead = normalizedCommitId === undefined || normalizedCommitId === "HEAD";
+        const manualCommitsRemoved = (await sdk.getFeatureFlagsForCurrentUser()).removeManualCommitsEnabled();
+        let branchToDeploy = target.branch;
+        let commitIdToDeploy = normalizedCommitId;
+        if (manualCommitsRemoved) {
+            const { branches } = applicationBranchesSchema.parse(await callServerApi({
+                baseUrl: target.baseUrl,
+                method: "GET",
+                path: `/api/v2/applications/${target.applicationId}/branches`,
+                token: auth.token,
+            }));
+            branchToDeploy =
+                branches.find((branch) => branch.isDefault)?.name ?? DEFAULT_BRANCH;
+            const commitHistory = await sdk.fetchApplicationCommits({
+                applicationId: target.applicationId,
+                branch: branchToDeploy,
+                commitType: CommitType.ALL,
+                limit: HISTORY_PAGE_SIZE,
+                offset: 0,
+            });
+            const versions = [
+                ...commitHistory.autosaves,
+                ...commitHistory.commits,
+            ].sort(compareCommits);
+            // An explicit id that predates this window falls through untouched; the
+            // server validates it.
+            const versionToDeploy = shouldResolveHead
+                ? versions.find(isDeployableCommit)
+                : versions.find((version) => version.commitId === normalizedCommitId);
+            if (shouldResolveHead && !versionToDeploy) {
+                throw new Error(`No accepted checkpoint found in the last ${HISTORY_PAGE_SIZE} versions of application ${target.applicationId} on branch ${branchToDeploy}.`);
+            }
+            if (versionToDeploy && !isDeployableCommit(versionToDeploy)) {
+                throw new Error(`Version ${versionToDeploy.commitId} of application ${target.applicationId} is not an accepted checkpoint and cannot be published. Omit commit_id to publish the latest accepted checkpoint.`);
+            }
+            if (versionToDeploy) {
+                commitIdToDeploy = versionToDeploy.autosave
+                    ? await copyCheckpointToCommit({
+                        applicationId: target.applicationId,
+                        baseUrl: target.baseUrl,
+                        commitId: versionToDeploy.commitId,
+                        token: auth.token,
+                    })
+                    : versionToDeploy.commitId;
+            }
+        }
+        const deployment = await sdk.deployApplication(target.applicationId, commitIdToDeploy);
+        return {
+            deployment,
+            application_id: target.applicationId,
+            branch: branchToDeploy,
+            commit_id: commitIdToDeploy ?? "HEAD",
+            auth_source: auth.source,
+            base_url: target.baseUrl,
+            environment: target.environment,
+            resolved_from: target.resolvedFrom,
+        };
+    },
+};
+//# sourceMappingURL=deploy-application.js.map

package/dist/tools/deploy-application.js.map

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

package/dist/tools/find-apps-by-integration.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const findAppsByIntegration: ToolDefinition;
+//# sourceMappingURL=find-apps-by-integration.d.ts.map

package/dist/tools/find-apps-by-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-apps-by-integration.d.ts","sourceRoot":"","sources":["../../src/tools/find-apps-by-integration.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA0FpD,eAAO,MAAM,qBAAqB,EAAE,cA0EnC,CAAC"}

package/dist/tools/find-apps-by-integration.js

@@ -0,0 +1,135 @@
+import { z } from "zod";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { detectEnvironment, normalizeBaseUrl } from "../urls.js";
+import { applyPagination } from "./pagination.js";
+import * as schemas from "./schemas.js";
+import { callServerApi } from "./server-api.js";
+import { parseToolInput } from "./validation.js";
+const findAppsByIntegrationInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    integration_id: z.string().uuid(),
+    limit: z.number().int().positive().max(200).optional(),
+    offset: z.number().int().nonnegative().optional(),
+})
+    .strict();
+// Minimum fields we surface to MCP callers. The server returns a richer
+// shape (creator, folderId, entryPointCount, …) that we pass through
+// untouched via `.passthrough()` so callers keep working if the backend
+// adds more fields. Validating the core fields at item-level catches
+// field-rename regressions before they surface as silent `undefined`s in
+// tool output.
+const integrationUsageAppSchema = z
+    .object({
+    applicationId: z.string(),
+    applicationName: z.string(),
+    organizationId: z.string(),
+})
+    .passthrough();
+function parseApps(items) {
+    return items.map((item, index) => {
+        try {
+            return integrationUsageAppSchema.parse(item);
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            throw new Error(`Unexpected application shape at index ${index} from /api/v1/integrations/apps: ${detail}`);
+        }
+    });
+}
+function normalizeApplicationsResponse(response) {
+    if (Array.isArray(response)) {
+        return { kind: "legacy", items: parseApps(response) };
+    }
+    if (response && typeof response === "object") {
+        const obj = response;
+        if (Array.isArray(obj.items)) {
+            const items = parseApps(obj.items);
+            if (typeof obj.total === "number" &&
+                typeof obj.limit === "number" &&
+                typeof obj.offset === "number") {
+                return {
+                    kind: "paginated",
+                    items,
+                    total: obj.total,
+                    limit: obj.limit,
+                    offset: obj.offset,
+                };
+            }
+            // Envelope missing pagination metadata: treat as legacy so we fall
+            // back to client-side slicing rather than reporting a bogus total.
+            return { kind: "legacy", items };
+        }
+    }
+    throw new Error("Unexpected response shape from /api/v1/integrations/apps");
+}
+export const findAppsByIntegration = {
+    name: "find_apps_by_integration",
+    title: "Find Apps by Integration",
+    description: "Find applications using a specific integration ID by querying server-side integration usage metadata.",
+    inputSchema: schemas.findAppsByIntegrationToolInputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(findAppsByIntegrationInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const response = await callServerApi({
+            baseUrl,
+            token: auth.token,
+            method: "GET",
+            path: "/api/v1/integrations/apps",
+            query: {
+                integrationId: input.integration_id,
+                limit: input.limit,
+                offset: input.offset,
+            },
+        });
+        const normalized = normalizeApplicationsResponse(response);
+        // When the server paginates (new shape: { items, total, limit, offset })
+        // trust its totals and skip client-side slicing. When the server
+        // returns a bare array (legacy shape) fall back to client-side
+        // pagination so the tool keeps working against older deployments.
+        if (normalized.kind === "paginated") {
+            const hasMore = normalized.offset + normalized.items.length < normalized.total;
+            return {
+                integration_id: input.integration_id,
+                applications: normalized.items,
+                auth_source: auth.source,
+                base_url: baseUrl,
+                environment: detectEnvironment(baseUrl),
+                has_more: hasMore,
+                limit: normalized.limit,
+                next_offset: hasMore
+                    ? normalized.offset + normalized.items.length
+                    : null,
+                offset: normalized.offset,
+                returned_count: normalized.items.length,
+                total_count: normalized.total,
+            };
+        }
+        const paged = applyPagination(normalized.items, {
+            limit: input.limit,
+            offset: input.offset,
+        });
+        return {
+            integration_id: input.integration_id,
+            applications: paged.page,
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+            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,
+        };
+    },
+};
+//# sourceMappingURL=find-apps-by-integration.js.map

package/dist/tools/find-apps-by-integration.js.map

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

package/dist/tools/find-apps-by-package.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const findAppsByPackage: ToolDefinition;
+//# sourceMappingURL=find-apps-by-package.d.ts.map

package/dist/tools/find-apps-by-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-apps-by-package.d.ts","sourceRoot":"","sources":["../../src/tools/find-apps-by-package.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA6BpD,eAAO,MAAM,iBAAiB,EAAE,cAwF/B,CAAC"}