@octopusdeploy/mcp-server 1.0.1 → 2.1.0

package/dist/tools/findCertificates.js

@@ -0,0 +1,98 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { READ_ONLY_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { mapCertificateResource } from "../types/certificateTypes.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES } from "../helpers/errorHandling.js";
+export function registerFindCertificatesTool(server) {
+    server.registerTool("find_certificates", {
+        title: "Find certificates in an Octopus Deploy space",
+        description: `Find certificates in a space - can retrieve a single certificate by ID or list all certificates
+
+This unified tool can either:
+- Get detailed information about a specific certificate when certificateId is provided
+- List all certificates in a space when certificateId is omitted
+
+You can optionally filter by various parameters like name, archived status, tenant, etc. when listing.`,
+        inputSchema: {
+            spaceName: z.string(),
+            certificateId: z.string().optional().describe("The ID of a specific certificate to retrieve. If omitted, lists all certificates."),
+            skip: z.number().optional().describe("Number of certificates to skip for pagination (only used when listing)"),
+            take: z.number().optional().describe("Number of certificates to take for pagination (only used when listing)"),
+            search: z.string().optional().describe("Search term to filter certificates (only used when listing)"),
+            archived: z.boolean().optional().describe("Filter by archived status (only used when listing)"),
+            tenant: z.string().optional().describe("Filter by tenant (only used when listing)"),
+            firstResult: z.number().optional().describe("Index of first result to return (only used when listing)"),
+            orderBy: z.string().optional().describe("Field to order results by (only used when listing)"),
+            ids: z.array(z.string()).optional().describe("Filter by specific certificate IDs (only used when listing)"),
+            partialName: z.string().optional().describe("Filter by partial name match (only used when listing)"),
+        },
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
+    }, async ({ spaceName, certificateId, skip, take, search, archived, tenant, firstResult, orderBy, ids, partialName, }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const spaceId = await resolveSpaceId(client, spaceName);
+        // If certificateId is provided, get a single certificate
+        if (certificateId) {
+            validateEntityId(certificateId, 'certificate', ENTITY_PREFIXES.certificate);
+            try {
+                const response = await client.get("~/api/{spaceId}/certificates/{id}", {
+                    spaceId,
+                    id: certificateId,
+                });
+                const certificate = mapCertificateResource(response);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(certificate),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                handleOctopusApiError(error, {
+                    entityType: 'certificate',
+                    entityId: certificateId,
+                    spaceName
+                });
+            }
+        }
+        // Otherwise, list all certificates
+        const response = await client.get("~/api/{spaceId}/certificates{?skip,take,search,archived,tenant,firstResult,orderBy,ids,partialName}", {
+            spaceId,
+            skip,
+            take,
+            search,
+            archived,
+            tenant,
+            firstResult,
+            orderBy,
+            ids,
+            partialName,
+        });
+        const certificates = response.Items.map((cert) => mapCertificateResource(cert));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        totalResults: response.TotalResults,
+                        itemsPerPage: response.ItemsPerPage,
+                        numberOfPages: response.NumberOfPages,
+                        lastPageNumber: response.LastPageNumber,
+                        items: certificates,
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "find_certificates",
+    config: { toolset: "certificates", readOnly: true },
+    registerFn: registerFindCertificatesTool,
+});
+//# sourceMappingURL=findCertificates.js.map

package/dist/tools/findCertificates.js.map

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

package/dist/tools/findDeploymentTargets.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerFindDeploymentTargetsTool(server: McpServer): void;
+//# sourceMappingURL=findDeploymentTargets.d.ts.map

package/dist/tools/findDeploymentTargets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findDeploymentTargets.d.ts","sourceRoot":"","sources":["../../src/tools/findDeploymentTargets.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS,QAqLlE"}

package/dist/tools/findDeploymentTargets.js

@@ -0,0 +1,161 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { READ_ONLY_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import {} from "../types/deploymentTargetTypes.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES } from "../helpers/errorHandling.js";
+export function registerFindDeploymentTargetsTool(server) {
+    server.registerTool("find_deployment_targets", {
+        title: "Find deployment targets in an Octopus Deploy space",
+        description: `Find deployment targets (machines) in a space - can retrieve a single target by ID or list all targets
+
+This unified tool can either:
+- Get detailed information about a specific deployment target when targetId is provided
+- List all deployment targets in a space when targetId is omitted
+
+You can optionally filter by various parameters like name, roles, health status, etc. when listing.`,
+        inputSchema: {
+            spaceName: z.string(),
+            targetId: z.string().optional().describe("The ID of a specific deployment target to retrieve. If omitted, lists all deployment targets."),
+            skip: z.number().optional().describe("Number of targets to skip for pagination (only used when listing)"),
+            take: z.number().optional().describe("Number of targets to take for pagination (only used when listing)"),
+            name: z.string().optional().describe("Filter by exact name (only used when listing)"),
+            ids: z.array(z.string()).optional().describe("Filter by specific target IDs (only used when listing)"),
+            partialName: z.string().optional().describe("Filter by partial name match (only used when listing)"),
+            roles: z.array(z.string()).optional().describe("A list of roles / target tags to filter by (only used when listing)"),
+            isDisabled: z.boolean().optional().describe("Filter by disabled status (only used when listing)"),
+            healthStatuses: z.array(z.string()).optional().describe("Possible values: Healthy, Unhealthy, Unavailable, Unknown, HasWarnings (only used when listing)"),
+            commStyles: z.array(z.string()).optional().describe("Filter by communication styles (only used when listing)"),
+            tenantIds: z.array(z.string()).optional().describe("Filter by tenant IDs (only used when listing)"),
+            tenantTags: z.array(z.string()).optional().describe("Filter by tenant tags (only used when listing)"),
+            environmentIds: z.array(z.string()).optional().describe("Filter by environment IDs (only used when listing)"),
+            thumbprint: z.string().optional().describe("Filter by thumbprint (only used when listing)"),
+            deploymentId: z.string().optional().describe("Filter by deployment ID (only used when listing)"),
+            shellNames: z.array(z.string()).optional().describe("Filter by shell names (only used when listing)"),
+            deploymentTargetTypes: z.array(z.string()).optional().describe("Filter by deployment target types (only used when listing)"),
+        },
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
+    }, async ({ spaceName, targetId, skip, take, name, ids, partialName, roles, isDisabled, healthStatuses, commStyles, tenantIds, tenantTags, environmentIds, thumbprint, deploymentId, shellNames, deploymentTargetTypes, }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const spaceId = await resolveSpaceId(client, spaceName);
+        // If targetId is provided, get a single deployment target
+        if (targetId) {
+            validateEntityId(targetId, 'machine', ENTITY_PREFIXES.machine);
+            try {
+                const target = await client.get("~/api/{spaceId}/machines/{id}", {
+                    spaceId,
+                    id: targetId,
+                });
+                const deploymentTarget = {
+                    spaceId: target.SpaceId,
+                    id: target.Id,
+                    name: target.Name,
+                    slug: target.Slug,
+                    isDisabled: target.IsDisabled,
+                    healthStatus: target.HealthStatus,
+                    statusSummary: target.StatusSummary,
+                    environmentIds: target.EnvironmentIds,
+                    roles: target.Roles,
+                    tenantedDeploymentParticipation: target.TenantedDeploymentParticipation,
+                    tenantIds: target.TenantIds,
+                    tenantTags: target.TenantTags,
+                    endpoint: {
+                        id: target.Endpoint.Id,
+                        communicationStyle: target.Endpoint.CommunicationStyle,
+                        uri: target.Endpoint.Uri,
+                        fingerprint: target.Endpoint.Fingerprint,
+                        proxyId: target.Endpoint.ProxyId,
+                        tentacleVersionDetails: target.Endpoint.TentacleVersionDetails,
+                    },
+                    shellName: target.ShellName,
+                    machinePolicyId: target.MachinePolicyId,
+                    hasLatestCalamari: target.HasLatestCalamari,
+                    isInProcess: target.IsInProcess,
+                    links: target.Links,
+                };
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(deploymentTarget),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                handleOctopusApiError(error, {
+                    entityType: 'deployment target',
+                    entityId: targetId,
+                    spaceName,
+                    helpText: "Use find_deployment_targets without targetId to find valid target IDs."
+                });
+            }
+        }
+        // Otherwise, list all deployment targets
+        const response = await client.get("~/api/{spaceId}/machines{?skip,take,name,ids,partialName,roles,isDisabled,healthStatuses,commStyles,tenantIds,tenantTags,environmentIds,thumbprint,deploymentId,shellNames,deploymentTargetTypes}", {
+            spaceId,
+            skip,
+            take,
+            name,
+            ids,
+            partialName,
+            roles,
+            isDisabled,
+            healthStatuses,
+            commStyles,
+            tenantIds,
+            tenantTags,
+            environmentIds,
+            thumbprint,
+            deploymentId,
+            shellNames,
+            deploymentTargetTypes,
+        });
+        const deploymentTargets = response.Items.map((target) => ({
+            spaceId: target.SpaceId,
+            id: target.Id,
+            name: target.Name,
+            slug: target.Slug,
+            isDisabled: target.IsDisabled,
+            healthStatus: target.HealthStatus,
+            statusSummary: target.StatusSummary,
+            environmentIds: target.EnvironmentIds,
+            roles: target.Roles,
+            tenantedDeploymentParticipation: target.TenantedDeploymentParticipation,
+            tenantIds: target.TenantIds,
+            tenantTags: target.TenantTags,
+            endpoint: {
+                communicationStyle: target.Endpoint.CommunicationStyle,
+                uri: target.Endpoint.Uri,
+                fingerprint: target.Endpoint.Fingerprint,
+            },
+            shellName: target.ShellName,
+            machinePolicyId: target.MachinePolicyId,
+            hasLatestCalamari: target.HasLatestCalamari,
+            isInProcess: target.IsInProcess,
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        totalResults: response.TotalResults,
+                        itemsPerPage: response.ItemsPerPage,
+                        numberOfPages: response.NumberOfPages,
+                        lastPageNumber: response.LastPageNumber,
+                        items: deploymentTargets,
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "find_deployment_targets",
+    config: { toolset: "machines", readOnly: true },
+    registerFn: registerFindDeploymentTargetsTool,
+});
+//# sourceMappingURL=findDeploymentTargets.js.map

package/dist/tools/findDeploymentTargets.js.map

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

package/dist/tools/findFeatureToggles.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare const findFeatureTogglesSchema: z.ZodObject<{
+    spaceName: z.ZodString;
+    projectId: z.ZodString;
+    partialName: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    environmentIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    skip: z.ZodOptional<z.ZodNumber>;
+    take: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    spaceName: string;
+    projectId: string;
+    partialName?: string | undefined;
+    skip?: number | undefined;
+    take?: number | undefined;
+    tags?: string[] | undefined;
+    environmentIds?: string[] | undefined;
+}, {
+    spaceName: string;
+    projectId: string;
+    partialName?: string | undefined;
+    skip?: number | undefined;
+    take?: number | undefined;
+    tags?: string[] | undefined;
+    environmentIds?: string[] | undefined;
+}>;
+export type FindFeatureTogglesParams = z.infer<typeof findFeatureTogglesSchema>;
+export declare function findFeatureTogglesHandler(params: FindFeatureTogglesParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function registerFindFeatureTogglesTool(server: McpServer): void;
+export {};
+//# sourceMappingURL=findFeatureToggles.d.ts.map

package/dist/tools/findFeatureToggles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findFeatureToggles.d.ts","sourceRoot":"","sources":["../../src/tools/findFeatureToggles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8CzE,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;EAoC5B,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,wBAAwB;;;;;GA2DjC;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,QAiB/D"}

package/dist/tools/findFeatureToggles.js

@@ -0,0 +1,139 @@
+import { Client, resolveSpaceId, } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { READ_ONLY_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { handleOctopusApiError, isErrorWithMessage, } from "../helpers/errorHandling.js";
+import {} from "../types/featureToggleTypes.js";
+/**
+ * Slim per-environment shape returned alongside each toggle. Includes just
+ * enough state to answer "where is X turned on, and at what rollout?" without
+ * dereferencing the full toggle body. Tenant lists, segments, and minimum
+ * versions stay in the resource.
+ */
+function environmentSummary(env) {
+    return {
+        deploymentEnvironmentId: env.DeploymentEnvironmentId,
+        isEnabled: env.IsEnabled,
+        rolloutPercentage: env.RolloutPercentage,
+        clientRolloutPercentage: env.ClientRolloutPercentage,
+    };
+}
+function toggleSummary(toggle, spaceName) {
+    const encodedSpace = encodeURIComponent(spaceName);
+    const encodedProjectId = encodeURIComponent(toggle.ProjectId);
+    const encodedSlug = encodeURIComponent(toggle.Slug);
+    return {
+        id: toggle.Id,
+        slug: toggle.Slug,
+        name: toggle.Name,
+        projectId: toggle.ProjectId,
+        defaultIsEnabled: toggle.DefaultIsEnabled,
+        rolloutGroupId: toggle.RolloutGroupId ?? null,
+        tags: toggle.Tags ?? [],
+        environmentSummaries: (toggle.Environments ?? []).map(environmentSummary),
+        resourceUri: `octopus://spaces/${encodedSpace}/projects/${encodedProjectId}/featuretoggles/${encodedSlug}`,
+    };
+}
+const findFeatureTogglesSchema = z.object({
+    spaceName: z.string().describe("Space name."),
+    projectId: z
+        .string()
+        .describe("Project ID (e.g. Projects-123). Feature toggles are scoped per project."),
+    partialName: z
+        .string()
+        .optional()
+        .describe("Case-insensitive substring match on the toggle name."),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe('Filter by canonical tag names (e.g. "release-rings/beta"). Repeats: a toggle matches if it has any of these tags.'),
+    environmentIds: z
+        .array(z.string())
+        .optional()
+        .describe("Filter by environment IDs (e.g. Environments-7). A toggle matches if it has configuration for any of these environments."),
+    skip: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe("Pagination offset (≥ 0)."),
+    take: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("Pagination page size (1–100, server-side cap)."),
+});
+export async function findFeatureTogglesHandler(params) {
+    const { spaceName, projectId, partialName, tags, environmentIds, skip, take } = params;
+    const client = await Client.create(getClientConfigurationFromEnvironment());
+    let spaceId;
+    try {
+        spaceId = await resolveSpaceId(client, spaceName);
+    }
+    catch (error) {
+        handleOctopusApiError(error, { spaceName });
+    }
+    try {
+        const response = await client.get("~/api/{spaceId}/projects/{projectId}/featuretoggles{?Skip,Take,PartialName,Tags,Environments}", {
+            spaceId,
+            projectId,
+            Skip: skip,
+            Take: take,
+            PartialName: partialName,
+            Tags: tags,
+            Environments: environmentIds,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        totalResults: response.TotalResults,
+                        itemsPerPage: response.ItemsPerPage,
+                        numberOfPages: response.NumberOfPages,
+                        lastPageNumber: response.LastPageNumber,
+                        items: (response.Items ?? []).map((toggle) => toggleSummary(toggle, spaceName)),
+                    }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        // 404 at this layer is ambiguous: either feature toggles are disabled on
+        // the instance (per the API contract — every route returns 404 when the
+        // capability is off), or the projectId is wrong. The space itself was
+        // already resolved successfully above. Surface the disabled-capability
+        // hint rather than the generic "Space not found" message.
+        if (isErrorWithMessage(error, "not found") || isErrorWithMessage(error, "404")) {
+            throw new Error(`Feature toggles endpoint returned 404 for project '${projectId}' in space '${spaceName}'. ` +
+                "Either the customer feature toggles capability is disabled on this Octopus instance, or the projectId is incorrect. " +
+                "Use list_projects to verify the project ID.");
+        }
+        handleOctopusApiError(error, { spaceName });
+    }
+}
+export function registerFindFeatureTogglesTool(server) {
+    server.registerTool("find_feature_toggles", {
+        title: "Find feature toggles",
+        description: `List customer feature toggles in an Octopus Deploy project.
+
+Each summary includes per-environment state (isEnabled, rolloutPercentage, clientRolloutPercentage) so "where is X turned on" is answerable from the list response. Heavy fields (description, tenant lists, segments, minimum versions) live in the resource body.
+
+Dereference the returned resourceUri (octopus://spaces/{spaceName}/projects/{projectId}/featuretoggles/{slug}) for the full toggle body.
+
+Use update_feature_toggle to flip an environment on/off or change rollout percentages on an existing toggle. This MCP server does not expose toggle creation, deletion, renaming, or rollout-group management — direct customers to the Octopus UI for those.`,
+        inputSchema: findFeatureTogglesSchema.shape,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
+    }, findFeatureTogglesHandler);
+}
+registerToolDefinition({
+    toolName: "find_feature_toggles",
+    config: { toolset: "featureToggles", readOnly: true },
+    registerFn: registerFindFeatureTogglesTool,
+    minimumOctopusVersion: "2026.1.10655",
+});
+//# sourceMappingURL=findFeatureToggles.js.map

package/dist/tools/findFeatureToggles.js.map

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

package/dist/tools/findInterruptions.d.ts

@@ -0,0 +1,79 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+interface InterruptionFormElement {
+    Name: string;
+    Control?: {
+        Type?: string;
+    } | null;
+    IsValueRequired?: boolean;
+}
+interface InterruptionResource {
+    Id: string;
+    Title: string;
+    Type?: string;
+    Created: string;
+    IsPending: boolean;
+    Form?: {
+        Values?: Record<string, unknown> | null;
+        Elements?: InterruptionFormElement[] | null;
+    } | null;
+    RelatedDocumentIds?: string[];
+    ResponsibleTeamIds?: string[];
+    ResponsibleUserId?: string;
+    CanTakeResponsibility: boolean;
+    HasResponsibility: boolean;
+    IsLinkedToOtherInterruption?: boolean;
+    TaskId: string;
+    CorrelationId?: string;
+    SpaceId: string;
+}
+export declare function interruptionSummary(interruption: InterruptionResource, spaceName: string, instanceURL: string): {
+    id: string;
+    title: string;
+    type: string | undefined;
+    taskId: string;
+    correlationId: string | undefined;
+    isPending: boolean;
+    isLinkedToOtherInterruption: boolean | undefined;
+    created: string;
+    relatedDocumentIds: string[];
+    responsible: {
+        teamIds: string[];
+        userId: string | undefined;
+        canTakeResponsibility: boolean;
+        hasResponsibility: boolean;
+    };
+    formElementNames: string[];
+    resourceUri: string;
+    taskResourceUri: string;
+    publicUrl: string;
+    publicUrlInstruction: string;
+};
+export interface FindInterruptionsParams {
+    spaceName: string;
+    interruptionId?: string;
+    pendingOnly?: boolean;
+    assignedToMe?: boolean;
+    regarding?: string;
+    skip?: number;
+    take?: number;
+}
+export declare function findInterruptionsHandler(params: FindInterruptionsParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+/**
+ * Page through the unfiltered /interruptions result set, collecting items
+ * the authenticated user can act on. Octopus has no responsibleUserId query
+ * parameter, so post-filtering is the only correctness-preserving option.
+ *
+ * Safety cap: ASSIGNED_SCAN_MAX records inspected. Almost always hit only
+ * with pendingOnly: false on busy spaces with deep history; the assigned
+ * set under pendingOnly: true is virtually always small.
+ */
+export declare const ASSIGNED_SCAN_PAGE_SIZE = 100;
+export declare const ASSIGNED_SCAN_MAX = 500;
+export declare function registerFindInterruptionsTool(server: McpServer): void;
+export {};
+//# sourceMappingURL=findInterruptions.d.ts.map

package/dist/tools/findInterruptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findInterruptions.d.ts","sourceRoot":"","sources":["../../src/tools/findInterruptions.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACxC,QAAQ,CAAC,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAAC;KAC7C,GAAG,IAAI,CAAC;IACT,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,oBAAoB,EAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;EAkCpB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA4DD,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,uBAAuB;;;;;GA6I7E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AA2DrC,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,QAyB9D"}