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

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

@@ -0,0 +1,60 @@
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { aggregateAuditEventsInputSchema, resolveBaseUrlTarget, } from "../target/resolve-base-url-target.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+export const aggregateAuditEvents = {
+    name: "aggregate_audit_events",
+    title: "Aggregate Audit Events",
+    description: "Compute aggregated metrics over v2 audit events (OCSF) for the current organization. " +
+        "Returns a single numeric value and optional grouped breakdown.\n\n" +
+        "Metrics: 'count' (total events), 'unique_actors' (distinct users), 'unique_resources' (distinct resources).\n" +
+        "Group by: 'activity_id', 'actor_user_uid', 'application_id', 'class_uid', 'day', 'hour', 'resource_type'.\n\n" +
+        "All the same OCSF filters from get_audit_events are available (class_uid, status, severity, actor, etc.).\n\n" +
+        "Example use cases:\n" +
+        "- Active end-users in a time range: metric=unique_actors\n" +
+        "- Active builders: metric=unique_actors, class_uid=6002 (APPLICATION_LIFECYCLE)\n" +
+        "- API executions by day: metric=count, class_uid=6003, status!=99, group_by=day\n\n" +
+        "IMPORTANT — API execution double-counting: API execution events (class_uid=6003) are logged as start/completion pairs. " +
+        "To count unique executions, filter to status != 99 (exclude IN_PROGRESS).\n\n" +
+        "Time range is capped at 366 days.",
+    inputSchema: schemas.aggregateAuditEventsToolInputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(aggregateAuditEventsInputSchema, args);
+        const target = resolveBaseUrlTarget(input);
+        const auth = await resolveAuthForOrigin(target.baseUrl);
+        const sdk = createSdk(auth.token, target.baseUrl);
+        const response = await sdk.fetchAuditEventsAggregate({
+            metric: input.metric,
+            groupBy: input.group_by,
+            timeStart: input.time_start,
+            timeEnd: input.time_end,
+            activityId: input.activity_id,
+            applicationId: input.application_id,
+            classUid: input.class_uid,
+            status: input.status,
+            severity: input.severity,
+            actor: input.actor,
+            resourceType: input.resource_type,
+            resourceId: input.resource_id,
+            search: input.search,
+        });
+        return {
+            metric: input.metric,
+            group_by: input.group_by ?? null,
+            value: response.value,
+            groups: response.groups,
+            auth_source: auth.source,
+            base_url: target.baseUrl,
+            environment: target.environment,
+        };
+    },
+};
+//# sourceMappingURL=aggregate-audit-events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-audit-events.js","sourceRoot":"","sources":["../../src/tools/aggregate-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,+BAA+B,EAC/B,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,wBAAwB;IAC9B,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EACT,uFAAuF;QACvF,oEAAoE;QACpE,+GAA+G;QAC/G,+GAA+G;QAC/G,+GAA+G;QAC/G,sBAAsB;QACtB,4DAA4D;QAC5D,mFAAmF;QACnF,qFAAqF;QACrF,yHAAyH;QACzH,+EAA+E;QAC/E,mCAAmC;IACrC,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,+BAA+B,EAAE,IAAI,CAAC,CAAC;QACpE,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,yBAAyB,CAAC;YACnD,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,QAAQ;YACvB,SAAS,EAAE,KAAK,CAAC,UAAU;YAC3B,OAAO,EAAE,KAAK,CAAC,QAAQ;YACvB,UAAU,EAAE,KAAK,CAAC,WAAW;YAC7B,aAAa,EAAE,KAAK,CAAC,cAAc;YACnC,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;SACrB,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,QAAQ,EAAE,MAAM,CAAC,OAAO;YACxB,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/assign-builder-seat.d.ts

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

package/dist/tools/assign-builder-seat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assign-builder-seat.d.ts","sourceRoot":"","sources":["../../src/tools/assign-builder-seat.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAYpD,eAAO,MAAM,iBAAiB,EAAE,cAgC/B,CAAC"}

package/dist/tools/assign-builder-seat.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.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 assignBuilderSeatInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    user_id: z.string().uuid(),
+})
+    .strict();
+export const assignBuilderSeat = {
+    name: "assign_builder_seat",
+    title: "Assign Builder Seat",
+    description: "Assign a builder seat to a user by user_id.",
+    inputSchema: schemas.assignBuilderSeatToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(assignBuilderSeatInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const assignment = await callServerApi({
+            baseUrl,
+            token: auth.token,
+            method: "POST",
+            path: "/api/v1/billing/builder-seats",
+            body: { userId: input.user_id },
+        });
+        return {
+            assignment,
+            user_id: input.user_id,
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+        };
+    },
+};
+//# sourceMappingURL=assign-builder-seat.js.map

package/dist/tools/assign-builder-seat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assign-builder-seat.js","sourceRoot":"","sources":["../../src/tools/assign-builder-seat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,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,4BAA4B,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC3B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,6CAA6C;IAC1D,WAAW,EAAE,OAAO,CAAC,gCAAgC;IACrD,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,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,UAAU,GAAG,MAAM,aAAa,CAAC;YACrC,OAAO;YACP,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,+BAA+B;YACrC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE;SAChC,CAAC,CAAC;QAEH,OAAO;YACL,UAAU;YACV,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,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/billing-usage-limits.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDefinition } from "./registry.js";
+export declare const listBillingUsageLimits: ToolDefinition;
+export declare const updateUserBillingUsageLimit: ToolDefinition;
+export declare const updateOrgBillingUsageLimit: ToolDefinition;
+//# sourceMappingURL=billing-usage-limits.d.ts.map

package/dist/tools/billing-usage-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-usage-limits.d.ts","sourceRoot":"","sources":["../../src/tools/billing-usage-limits.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA2HpD,eAAO,MAAM,sBAAsB,EAAE,cA0CpC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,cAmCzC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,cA8BxC,CAAC"}

package/dist/tools/billing-usage-limits.js

@@ -0,0 +1,191 @@
+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 { applyPagination } from "./pagination.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+const limitInputFields = {
+    amount_limit_cents: z.number().int().nonnegative().optional(),
+    credit_limit: z.number().nonnegative().optional(),
+};
+function exactlyOneLimitValue(value, ctx) {
+    const valuesProvided = [
+        value.amount_limit_cents !== undefined,
+        value.credit_limit !== undefined,
+    ].filter(Boolean).length;
+    if (valuesProvided !== 1) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Provide exactly one of credit_limit or amount_limit_cents",
+        });
+    }
+}
+const listBillingUsageLimitsInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    limit: z.number().int().positive().max(200).optional(),
+    offset: z.number().int().nonnegative().optional(),
+})
+    .strict();
+const updateUserBillingUsageLimitInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    user_id: z.string().uuid().optional(),
+    ...limitInputFields,
+})
+    .strict()
+    .superRefine(exactlyOneLimitValue);
+const updateOrgBillingUsageLimitInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    ...limitInputFields,
+})
+    .strict()
+    .superRefine(exactlyOneLimitValue);
+function buildLimitBody(input) {
+    if (input.amount_limit_cents !== undefined) {
+        return { amountLimitCents: input.amount_limit_cents };
+    }
+    return { creditLimit: input.credit_limit };
+}
+function validateLimitMatchesPlan(input, plan) {
+    const contractType = plan && typeof plan === "object"
+        ? plan.contractType
+        : undefined;
+    const isDollarCommit = contractType === "dollar_commit";
+    if (isDollarCommit && input.credit_limit !== undefined) {
+        throw new Error("Dollar commit plans require amount_limit_cents, not credit_limit");
+    }
+    if (!isDollarCommit && input.amount_limit_cents !== undefined) {
+        throw new Error("Credit-based plans require credit_limit, not amount_limit_cents");
+    }
+}
+function omitInactiveLimitField(row) {
+    if (!row || typeof row !== "object")
+        return row;
+    const normalized = { ...row };
+    if (normalized.amountLimitCents == null) {
+        delete normalized.amountLimitCents;
+    }
+    if (normalized.creditLimit == null) {
+        delete normalized.creditLimit;
+    }
+    return normalized;
+}
+function validateUsageLimitsResponse(data) {
+    if (!data || typeof data !== "object") {
+        throw new Error(`Unexpected response from billing usage limits API: expected object, got ${typeof data}`);
+    }
+    const response = data;
+    if (!Array.isArray(response.limits)) {
+        throw new Error(`Unexpected response from billing usage limits API: expected limits array, got ${typeof response.limits}`);
+    }
+    if (!("orgLimit" in response)) {
+        throw new Error("Unexpected response from billing usage limits API: missing orgLimit");
+    }
+    if (response.orgLimit !== null && typeof response.orgLimit !== "object") {
+        throw new Error(`Unexpected response from billing usage limits API: expected orgLimit object or null, got ${typeof response.orgLimit}`);
+    }
+    return { limits: response.limits, orgLimit: response.orgLimit };
+}
+export const listBillingUsageLimits = {
+    name: "list_billing_usage_limits",
+    title: "List Billing Usage Limits",
+    description: "List configured AI usage limits for the current organization, including per-user/default user limits and the enterprise org-wide overage limit when available. Requires billing:manage permission.",
+    inputSchema: schemas.listBillingUsageLimitsToolInputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(listBillingUsageLimitsInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const sdk = createSdk(auth.token, baseUrl);
+        const data = validateUsageLimitsResponse(await sdk.fetchBillingUsageLimits());
+        const limits = data.limits.map(omitInactiveLimitField);
+        const paged = applyPagination(limits, {
+            limit: input.limit,
+            offset: input.offset,
+        });
+        return {
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+            has_more: paged.has_more,
+            limit: paged.limit,
+            limits: paged.page,
+            next_offset: paged.next_offset,
+            org_limit: data.orgLimit ? omitInactiveLimitField(data.orgLimit) : null,
+            offset: paged.offset,
+            returned_count: paged.returned_count,
+            total_count: paged.total_count,
+        };
+    },
+};
+export const updateUserBillingUsageLimit = {
+    name: "update_user_billing_usage_limit",
+    title: "Update User Billing Usage Limit",
+    description: "Set a per-user AI usage limit override, or omit user_id to set the default per-user usage limit for the organization. Provide either credit_limit or amount_limit_cents. Requires billing:manage permission.",
+    inputSchema: schemas.updateUserBillingUsageLimitToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(updateUserBillingUsageLimitInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const userId = input.user_id ?? null;
+        const sdk = createSdk(auth.token, baseUrl);
+        const plan = await sdk.fetchBillingPlanSummary();
+        validateLimitMatchesPlan(input, plan);
+        const result = await sdk.updateUserBillingUsageLimit({
+            userId,
+            ...buildLimitBody(input),
+        });
+        return {
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+            result,
+            user_id: userId,
+        };
+    },
+};
+export const updateOrgBillingUsageLimit = {
+    name: "update_org_billing_usage_limit",
+    title: "Update Organization Billing Usage Limit",
+    description: "Set the enterprise org-wide overage AI usage limit. Provide either credit_limit or amount_limit_cents. Requires billing:manage permission and an enterprise plan.",
+    inputSchema: schemas.updateOrgBillingUsageLimitToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(updateOrgBillingUsageLimitInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const sdk = createSdk(auth.token, baseUrl);
+        const plan = await sdk.fetchBillingPlanSummary();
+        validateLimitMatchesPlan(input, plan);
+        const result = await sdk.updateOrgBillingUsageLimit(buildLimitBody(input));
+        return {
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+            result,
+        };
+    },
+};
+//# sourceMappingURL=billing-usage-limits.js.map

package/dist/tools/billing-usage-limits.js.map

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

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

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

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

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

package/dist/tools/checkout-application.js

@@ -0,0 +1,65 @@
+import { ExportViewMode } from "@superblocksteam/shared";
+import { materializeApplication } from "../application/materialize-application.js";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { checkoutInputSchema, resolveAppTarget, } from "../target/resolve-app-target.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+export const checkoutApplication = {
+    name: "checkout_application",
+    title: "Checkout Application",
+    description: "Check out a Superblocks application to a caller-provided directory or a temporary directory and return the checkout path. You can optionally provide commit_id to materialize a historical snapshot. Provide either app_url or application_id plus base_url.",
+    inputSchema: schemas.checkoutToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(checkoutInputSchema, args);
+        const target = resolveAppTarget(input);
+        const auth = await resolveAuthForOrigin(target.baseUrl);
+        const sdk = createSdk(auth.token, target.baseUrl);
+        const commitId = "commit_id" in input ? input.commit_id : undefined;
+        const application = await sdk.fetchApplicationWithComponents({
+            applicationId: target.applicationId,
+            branch: target.branch,
+            viewMode: commitId
+                ? ExportViewMode.EXPORT_COMMIT
+                : ExportViewMode.EXPORT_LIVE,
+            commitId,
+        });
+        if (!application) {
+            throw new Error(`Application ${target.applicationId} was not found.`);
+        }
+        const directoryContentsHash = commitId && application.type === "code-mode"
+            ? await sdk.dbfsGetApplicationDirectoryHash({
+                applicationId: target.applicationId,
+                branch: target.branch,
+                commitId,
+            })
+            : undefined;
+        const materialized = await materializeApplication({
+            sdk,
+            application,
+            branch: target.branch,
+            directoryContentsHash,
+            destinationPath: input.destination_path,
+        });
+        return {
+            application_id: target.applicationId,
+            application_mode: application.type === "code-mode" ? "2.0" : "1.0",
+            auth_source: auth.source,
+            base_url: target.baseUrl,
+            branch: target.branch,
+            checkout_is_temporary: materialized.isTemporary,
+            checkout_path: materialized.checkoutPath,
+            commit_id: commitId ?? null,
+            environment: target.environment,
+            resolved_from: target.resolvedFrom,
+        };
+    },
+};
+//# sourceMappingURL=checkout-application.js.map

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

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

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

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

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

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

package/dist/tools/create-folder.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 createFolderInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    name: z.string().trim().min(1),
+})
+    .strict();
+export const createFolder = {
+    name: "create_folder",
+    title: "Create Folder",
+    description: "Create a folder in the current organization.",
+    inputSchema: schemas.createFolderToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(createFolderInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const sdk = createSdk(auth.token, baseUrl);
+        const folder = await sdk.createFolder({ name: input.name });
+        return {
+            folder,
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+        };
+    },
+};
+//# sourceMappingURL=create-folder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-folder.js","sourceRoot":"","sources":["../../src/tools/create-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,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE,8CAA8C;IAC3D,WAAW,EAAE,OAAO,CAAC,2BAA2B;IAChD,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,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,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAE5D,OAAO;YACL,MAAM;YACN,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/create-integration.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDefinition } from "./registry.js";
+export declare function buildCreateIntegrationPayload(input: {
+    configuration: Record<string, unknown>;
+    kind?: "PLUGIN" | "SECRET";
+    name: string;
+    plugin_id: string;
+    slug?: string;
+}): Record<string, unknown>;
+export declare const createIntegration: ToolDefinition;
+//# sourceMappingURL=create-integration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-integration.d.ts","sourceRoot":"","sources":["../../src/tools/create-integration.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAepD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmB1B;AAsBD,eAAO,MAAM,iBAAiB,EAAE,cA0C/B,CAAC"}

package/dist/tools/create-integration.js

@@ -0,0 +1,93 @@
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { IntegrationKind } from "@superblocksteam/shared";
+import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
+import { createSdk } from "../sdk/create-sdk.js";
+import { detectEnvironment, normalizeBaseUrl } from "../urls.js";
+import { integrationMention } from "./integration-mention.js";
+import * as schemas from "./schemas.js";
+import { parseToolInput } from "./validation.js";
+const createIntegrationInputSchema = z
+    .object({
+    base_url: z.string().url(),
+    configuration: z.record(z.string(), z.unknown()),
+    kind: z.enum(["PLUGIN", "SECRET"]).optional(),
+    name: z.string().trim().min(1),
+    plugin_id: z.string().trim().min(1),
+    slug: z.string().trim().min(1).optional(),
+})
+    .strict();
+export function buildCreateIntegrationPayload(input) {
+    const id = randomUUID();
+    const configurationId = randomUUID();
+    return {
+        configurations: [
+            {
+                configuration: input.configuration,
+                created: new Date().toISOString(),
+                id: configurationId,
+                integrationId: id,
+                isDefault: true,
+            },
+        ],
+        id,
+        kind: input.kind ?? IntegrationKind.PLUGIN,
+        name: input.name,
+        pluginId: input.plugin_id,
+        ...(input.slug ? { slug: input.slug } : {}),
+    };
+}
+// Hosted deployments serve the dashboard from the same origin as the API, so
+// base_url is a usable link. Local dev splits them across ports, and we have no
+// way to learn the UI port here, so we link nothing rather than link wrong.
+function integrationPageUrl(baseUrl, integration) {
+    if (detectEnvironment(baseUrl) === "local") {
+        return undefined;
+    }
+    if (typeof integration !== "object" || integration === null) {
+        return undefined;
+    }
+    const { id, pluginId } = integration;
+    if (typeof id !== "string" || typeof pluginId !== "string") {
+        return undefined;
+    }
+    return `${baseUrl}/integrations/${pluginId}/${id}`;
+}
+export const createIntegration = {
+    name: "create_integration",
+    title: "Create Integration",
+    description: "Create a new integration. Call get_integration_config_schema first unless the missing-integration decision already includes configurationSchema. Pass name, plugin_id, and configuration. For credentialed integrations, include known non-secret fields and omit passwords, API tokens, and other secrets so the user can enter them in Superblocks. Do not send the integrations API envelope (id, created, configurations wrapper). When the result carries integration_url, show it so the user can open the prefilled integration. An integration whose secrets you left blank cannot run a query yet, so during an import wait for the user to confirm they saved the credentials before calling edit_app with integration_id: Superblocks tests the APIs it wires, and every one of those tests fails on a blank secret. To reference the integration, include the returned mention unchanged in the next edit_app prompt.",
+    inputSchema: schemas.createIntegrationToolInputSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    audience: "customer",
+    async handler(args) {
+        const input = parseToolInput(createIntegrationInputSchema, args);
+        const baseUrl = normalizeBaseUrl(input.base_url);
+        const auth = await resolveAuthForOrigin(baseUrl);
+        const sdk = createSdk(auth.token, baseUrl);
+        const integration = await sdk.createIntegration(buildCreateIntegrationPayload(input));
+        const integrationUrl = integrationPageUrl(baseUrl, integration);
+        const integrationId = typeof integration === "object" &&
+            integration !== null &&
+            typeof integration.id === "string"
+            ? integration.id
+            : undefined;
+        return {
+            integration,
+            ...(integrationId ? { integration_id: integrationId } : {}),
+            ...(integrationId
+                ? { mention: integrationMention(input.name, integrationId) }
+                : {}),
+            ...(integrationUrl ? { integration_url: integrationUrl } : {}),
+            auth_source: auth.source,
+            base_url: baseUrl,
+            environment: detectEnvironment(baseUrl),
+        };
+    },
+};
+//# sourceMappingURL=create-integration.js.map

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

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