@octopusdeploy/mcp-server 1.0.1 → 2.1.0

package/dist/tools/findInterruptions.js

@@ -0,0 +1,273 @@
+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 { getPublicUrl } from "../helpers/getPublicUrl.js";
+import { getCurrentUserCached } from "../helpers/userCache.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+export function interruptionSummary(interruption, spaceName, instanceURL) {
+    const encodedSpace = encodeURIComponent(spaceName);
+    const encodedInterruptionId = encodeURIComponent(interruption.Id);
+    const encodedTaskId = encodeURIComponent(interruption.TaskId);
+    const elements = interruption.Form?.Elements ?? [];
+    return {
+        id: interruption.Id,
+        title: interruption.Title,
+        type: interruption.Type,
+        taskId: interruption.TaskId,
+        correlationId: interruption.CorrelationId,
+        isPending: interruption.IsPending,
+        isLinkedToOtherInterruption: interruption.IsLinkedToOtherInterruption,
+        created: interruption.Created,
+        relatedDocumentIds: interruption.RelatedDocumentIds ?? [],
+        responsible: {
+            teamIds: interruption.ResponsibleTeamIds ?? [],
+            userId: interruption.ResponsibleUserId,
+            canTakeResponsibility: interruption.CanTakeResponsibility,
+            hasResponsibility: interruption.HasResponsibility,
+        },
+        formElementNames: elements.map((element) => element.Name),
+        resourceUri: `octopus://spaces/${encodedSpace}/interruptions/${encodedInterruptionId}`,
+        taskResourceUri: `octopus://spaces/${encodedSpace}/tasks/${encodedTaskId}`,
+        publicUrl: getPublicUrl(`${instanceURL}/app#/{spaceId}/tasks/{taskId}`, {
+            spaceId: interruption.SpaceId,
+            taskId: interruption.TaskId,
+        }),
+        publicUrlInstruction: "View and respond to this interruption in the Octopus Deploy web portal at the provided publicUrl. " +
+            "For full form details (Markdown instructions, button options, control types) dereference the resourceUri.",
+    };
+}
+const findInterruptionsSchema = z
+    .object({
+    spaceName: z.string().describe("Space name."),
+    interruptionId: z
+        .string()
+        .optional()
+        .describe("Fetch the slim summary for a single interruption by ID (e.g. Interruptions-1). " +
+        "Mutually exclusive with regarding/assignedToMe/pendingOnly. " +
+        "For the full body (form definition, instructions, button options, submitted values) dereference the returned resourceUri."),
+    pendingOnly: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Return only unprocessed (pending) interruptions. Defaults to true. Ignored when interruptionId is set."),
+    assignedToMe: z
+        .boolean()
+        .optional()
+        .describe("Limit to interruptions the authenticated user can act on (CanTakeResponsibility or HasResponsibility, " +
+        "or where the user is the explicit ResponsibleUserId). When true, /users/me is resolved (cached per session). " +
+        "Octopus has no responsibleUserId query parameter, so the tool pages through the server result set and " +
+        "post-filters; pages are scanned up to a safety cap (filteredAs.scanComplete signals whether the entire " +
+        "result set was inspected). totalResults reflects the post-filter count; the unfiltered server total is " +
+        "exposed under filteredAs. Ignored when interruptionId is set."),
+    regarding: z
+        .string()
+        .optional()
+        .describe("Native server-side filter to interruptions related to a specific entity ID " +
+        "(e.g. ServerTasks-1234, Deployments-5678). Ignored when interruptionId is set."),
+    skip: z.number().optional().describe("Pagination offset. Ignored when interruptionId is set."),
+    take: z.number().optional().describe("Pagination page size. Ignored when interruptionId is set."),
+})
+    .superRefine((args, ctx) => {
+    if (!args.interruptionId)
+        return;
+    const conflicting = [
+        "regarding",
+        "assignedToMe",
+        "skip",
+        "take",
+    ];
+    for (const key of conflicting) {
+        if (args[key] !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "Provide either interruptionId (to fetch a single interruption) or list filters " +
+                    `(${conflicting.join(", ")}), not both.`,
+                path: [key],
+            });
+        }
+    }
+});
+export async function findInterruptionsHandler(params) {
+    const { spaceName, interruptionId, pendingOnly = true, assignedToMe, regarding, skip, take, } = params;
+    // Cheap pre-check: validate the ID format before any network round-trip,
+    // so callers get a clear error without paying for the space resolve first.
+    if (interruptionId) {
+        validateEntityId(interruptionId, "interruption", ENTITY_PREFIXES.interruption);
+    }
+    const configuration = getClientConfigurationFromEnvironment();
+    const client = await Client.create(configuration);
+    let spaceId;
+    try {
+        spaceId = await resolveSpaceId(client, spaceName);
+    }
+    catch (error) {
+        handleOctopusApiError(error, { spaceName });
+    }
+    // Single-id lookup mode.
+    if (interruptionId) {
+        try {
+            const interruption = await client.get("~/api/{spaceId}/interruptions/{interruptionId}", { spaceId, interruptionId });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(interruptionSummary(interruption, spaceName, configuration.instanceURL)),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "interruption",
+                entityId: interruptionId,
+                spaceName,
+                helpText: "Call find_interruptions without interruptionId to list valid IDs.",
+            });
+        }
+    }
+    // assignedToMe: scan multiple server pages and post-filter, since Octopus
+    // has no native "responsibleUserId" query param. Without paging, a first
+    // server page that contains zero matches would cause us to return an empty
+    // result and silently miss actionable interruptions on later pages.
+    if (assignedToMe) {
+        const user = await getCurrentUserCached(client);
+        const currentUserId = user.Id;
+        const scan = await scanAssignedInterruptions(client, spaceId, {
+            pendingOnly,
+            regarding,
+            currentUserId,
+        });
+        const start = skip ?? 0;
+        const end = take !== undefined
+            ? Math.min(start + take, scan.matched.length)
+            : scan.matched.length;
+        const sliced = scan.matched.slice(start, end);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        // Post-filter counts: the LLM's "totalResults" is the number of
+                        // interruptions actually assigned to the user, not the unfiltered
+                        // server total. The latter is surfaced under filteredAs for
+                        // transparency.
+                        totalResults: scan.matched.length,
+                        itemsPerPage: sliced.length,
+                        numberOfPages: 1,
+                        lastPageNumber: 0,
+                        filteredAs: {
+                            userId: currentUserId,
+                            serverTotalScanned: scan.serverScanned,
+                            serverTotalAvailable: scan.serverTotal,
+                            scanComplete: scan.scanComplete,
+                            ...(scan.scanComplete
+                                ? {}
+                                : {
+                                    scanIncompleteHint: "Hit the safety cap before exhausting the server result set. " +
+                                        "Narrow the query (e.g. set regarding to a specific task, or keep pendingOnly: true) " +
+                                        "to ensure complete results.",
+                                }),
+                        },
+                        items: sliced.map((interruption) => interruptionSummary(interruption, spaceName, configuration.instanceURL)),
+                    }),
+                },
+            ],
+        };
+    }
+    // List mode (no per-user filter): pass server pagination through directly.
+    const response = await client.get("~/api/{spaceId}/interruptions{?skip,take,pendingOnly,regarding}", {
+        spaceId,
+        skip,
+        take,
+        pendingOnly,
+        regarding,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    totalResults: response.TotalResults,
+                    itemsPerPage: response.ItemsPerPage,
+                    numberOfPages: response.NumberOfPages,
+                    lastPageNumber: response.LastPageNumber,
+                    items: (response.Items ?? []).map((interruption) => interruptionSummary(interruption, spaceName, configuration.instanceURL)),
+                }),
+            },
+        ],
+    };
+}
+/**
+ * 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 const ASSIGNED_SCAN_PAGE_SIZE = 100;
+export const ASSIGNED_SCAN_MAX = 500;
+async function scanAssignedInterruptions(client, spaceId, params) {
+    const matched = [];
+    let serverScanned = 0;
+    let serverTotal = 0;
+    let scanComplete = false;
+    while (serverScanned < ASSIGNED_SCAN_MAX) {
+        const remaining = ASSIGNED_SCAN_MAX - serverScanned;
+        const pageTake = Math.min(ASSIGNED_SCAN_PAGE_SIZE, remaining);
+        const page = await client.get("~/api/{spaceId}/interruptions{?skip,take,pendingOnly,regarding}", {
+            spaceId,
+            skip: serverScanned,
+            take: pageTake,
+            pendingOnly: params.pendingOnly,
+            regarding: params.regarding,
+        });
+        serverTotal = page.TotalResults;
+        const items = page.Items ?? [];
+        for (const interruption of items) {
+            if (interruption.CanTakeResponsibility ||
+                interruption.HasResponsibility ||
+                interruption.ResponsibleUserId === params.currentUserId) {
+                matched.push(interruption);
+            }
+        }
+        serverScanned += items.length;
+        // Empty page (or short page) means the server has no more.
+        if (items.length === 0 || items.length < pageTake || serverScanned >= serverTotal) {
+            scanComplete = true;
+            break;
+        }
+    }
+    return { matched, serverTotal, serverScanned, scanComplete };
+}
+export function registerFindInterruptionsTool(server) {
+    server.registerTool("find_interruptions", {
+        title: "Find interruptions",
+        description: `Find interruptions (manual interventions, guided failures, deployment approvals) in an Octopus Deploy space.
+
+Interruptions are the Octopus surface equivalent to pending approvals: a deployment or runbook run pauses and waits for a human to take action. Use this tool to enumerate them or to look up a single one.
+
+Modes (picked by which arguments you supply):
+- interruptionId  → fetch the slim summary for that interruption.
+- assignedToMe    → list interruptions the authenticated user can act on; resolves /users/me (cached per session).
+- regarding       → list interruptions related to a specific entity (ServerTasks-…, Deployments-…). Native server-side filter.
+- (none)          → list all interruptions, optionally filtered by pendingOnly (default: true) and skip/take.
+
+Each summary includes:
+- resourceUri      → octopus://spaces/{spaceName}/interruptions/{id} for the FULL body (form definition with Markdown instructions, button options, control types, and any already-submitted values). Dereference this when the user asks for details about a specific interruption.
+- taskResourceUri  → octopus://spaces/{spaceName}/tasks/{taskId} for the surrounding deployment/runbook task.
+- publicUrl        → Octopus portal deep link to take action.
+- formElementNames → just the field names (e.g. Instructions, Notes, Result). Field values are NOT in the slim summary; fetch resourceUri for those.`,
+        inputSchema: findInterruptionsSchema,
+        annotations: { readOnlyHint: true },
+    }, findInterruptionsHandler);
+}
+registerToolDefinition({
+    toolName: "find_interruptions",
+    config: { toolset: "interruptions", readOnly: true },
+    registerFn: registerFindInterruptionsTool,
+});
+//# sourceMappingURL=findInterruptions.js.map

package/dist/tools/findInterruptions.js.map

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

package/dist/tools/findReleases.d.ts

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

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

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

package/dist/tools/findReleases.js

@@ -0,0 +1,138 @@
+import { Client, ReleaseRepository } 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 { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+/**
+ * Slim release shape returned by find_releases.
+ *
+ * Heavy fields (releaseNotes, selectedPackages, selectedGitResources,
+ * buildInformation, customFields) are deliberately omitted. Callers fetch
+ * the `resourceUri` (octopus://spaces/{spaceName}/releases/{releaseId})
+ * Resource for the full body when needed.
+ */
+function releaseSummary(release, spaceName) {
+    const encodedSpace = encodeURIComponent(spaceName);
+    const encodedId = encodeURIComponent(release.Id);
+    return {
+        id: release.Id,
+        version: release.Version,
+        channelId: release.ChannelId,
+        projectId: release.ProjectId,
+        assembled: release.Assembled,
+        ignoreChannelRules: release.IgnoreChannelRules,
+        versionControlReference: release.VersionControlReference,
+        resourceUri: `octopus://spaces/${encodedSpace}/releases/${encodedId}`,
+    };
+}
+const findReleasesSchema = z
+    .object({
+    spaceName: z.string().describe("Space name."),
+    releaseId: z
+        .string()
+        .optional()
+        .describe("Fetch a single release by ID. Mutually exclusive with projectId and searchByVersion."),
+    projectId: z
+        .string()
+        .optional()
+        .describe("Restrict listing to a single project. Mutually exclusive with releaseId."),
+    searchByVersion: z
+        .string()
+        .optional()
+        .describe("Filter by version string. Requires projectId."),
+    skip: z.number().optional().describe("Pagination offset."),
+    take: z.number().optional().describe("Pagination page size."),
+})
+    .superRefine((args, ctx) => {
+    if (args.releaseId && args.projectId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Provide either releaseId or projectId, not both. Use releaseId to fetch a single release; use projectId to list releases for a project.",
+            path: ["projectId"],
+        });
+    }
+    if (args.searchByVersion && !args.projectId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "searchByVersion requires projectId.",
+            path: ["searchByVersion"],
+        });
+    }
+    if (args.releaseId && args.searchByVersion) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "searchByVersion is only valid when listing releases for a project; it cannot be combined with releaseId.",
+            path: ["searchByVersion"],
+        });
+    }
+});
+export function registerFindReleasesTool(server) {
+    server.registerTool("find_releases", {
+        title: "Find releases",
+        description: `Find releases in an Octopus Deploy space.
+
+  Three modes, picked by which arguments are supplied:
+  - releaseId  → fetch the summary for that release.
+  - projectId  → list releases for that project (optionally filtered by searchByVersion).
+  - neither    → list releases across the space.
+
+  Each summary includes a resourceUri for fetching the full release body
+  (release notes, packages, build information, custom fields).`,
+        inputSchema: findReleasesSchema,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
+    }, async ({ spaceName, releaseId, projectId, searchByVersion, skip, take }) => {
+        const client = await Client.create(getClientConfigurationFromEnvironment());
+        const releaseRepository = new ReleaseRepository(client, spaceName);
+        if (releaseId) {
+            validateEntityId(releaseId, "release", ENTITY_PREFIXES.release);
+            try {
+                const release = await releaseRepository.get(releaseId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(releaseSummary(release, spaceName)),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                handleOctopusApiError(error, {
+                    entityType: "release",
+                    entityId: releaseId,
+                    spaceName,
+                    helpText: "Call find_releases without releaseId to list valid IDs.",
+                });
+            }
+        }
+        const releasesResponse = projectId
+            ? await releaseRepository.listForProject(projectId, {
+                skip,
+                take,
+                searchByVersion,
+            })
+            : await releaseRepository.list({ skip, take });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        totalResults: releasesResponse.TotalResults,
+                        itemsPerPage: releasesResponse.ItemsPerPage,
+                        numberOfPages: releasesResponse.NumberOfPages,
+                        lastPageNumber: releasesResponse.LastPageNumber,
+                        items: releasesResponse.Items.map((release) => releaseSummary(release, spaceName)),
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "find_releases",
+    config: { toolset: "releases", readOnly: true },
+    registerFn: registerFindReleasesTool,
+});
+//# sourceMappingURL=findReleases.js.map

package/dist/tools/findReleases.js.map

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

package/dist/tools/findRunbooks.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"findRunbooks.d.ts","sourceRoot":"","sources":["../../src/tools/findRunbooks.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwDzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,QA2GzD"}

package/dist/tools/findRunbooks.js

@@ -0,0 +1,139 @@
+import { Client, ProjectRepository, RunbookRepository, } 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 } from "../helpers/errorHandling.js";
+function runbookSummary(runbook, spaceName) {
+    const encodedSpace = encodeURIComponent(spaceName);
+    const encodedId = encodeURIComponent(runbook.Id);
+    return {
+        id: runbook.Id,
+        name: runbook.Name,
+        description: runbook.Description,
+        projectId: runbook.ProjectId,
+        runbookProcessId: runbook.RunbookProcessId,
+        publishedRunbookSnapshotId: runbook.PublishedRunbookSnapshotId,
+        multiTenancyMode: runbook.MultiTenancyMode,
+        environmentScope: runbook.EnvironmentScope,
+        environments: runbook.Environments,
+        resourceUri: `octopus://spaces/${encodedSpace}/runbooks/${encodedId}`,
+    };
+}
+const findRunbooksSchema = z
+    .object({
+    spaceName: z.string().describe("Space name."),
+    projectName: z
+        .string()
+        .describe("Project name. Runbooks are scoped to a project, so this is required for both single fetch and listing."),
+    runbookId: z
+        .string()
+        .optional()
+        .describe("Fetch a single runbook by ID. Mutually exclusive with partialName/skip/take."),
+    partialName: z
+        .string()
+        .optional()
+        .describe("Filter listing by partial runbook name (case-insensitive)."),
+    skip: z.number().optional().describe("Pagination offset."),
+    take: z.number().optional().describe("Pagination page size."),
+})
+    .superRefine((args, ctx) => {
+    if (args.runbookId && args.partialName) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "partialName cannot be combined with runbookId. Use runbookId to fetch a single runbook; use partialName to filter the listing.",
+            path: ["partialName"],
+        });
+    }
+});
+export function registerFindRunbooksTool(server) {
+    server.registerTool("find_runbooks", {
+        title: "Find runbooks in a project",
+        description: `Find runbooks in an Octopus Deploy project.
+
+Two modes, picked by which arguments are supplied:
+- runbookId  → fetch the summary for that runbook.
+- neither    → list all runbooks in the project (optionally filtered by partialName).
+
+Each summary includes the publishedRunbookSnapshotId (which run_runbook uses by default), the multiTenancyMode, and the environmentScope so callers can determine which environments and tenants are valid targets before invoking run_runbook.`,
+        inputSchema: findRunbooksSchema,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
+    }, async ({ spaceName, projectName, runbookId, partialName, skip, take }) => {
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const projectRepository = new ProjectRepository(client, spaceName);
+            const projectMatches = await projectRepository.list({
+                partialName: projectName,
+                take: 100,
+            });
+            const project = projectMatches.Items.find((p) => p.Name === projectName);
+            if (!project) {
+                // Returned directly (not thrown) so the error surfaces to the LLM
+                // with a project-specific message. handleOctopusApiError below would
+                // otherwise rewrite a thrown "Project not found" into a misleading
+                // "Space not found" because it requires entityId for the entity
+                // branch and falls through to the space branch when entityId is
+                // undefined (we haven't reached the runbook lookup yet).
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: `Project '${projectName}' not found in space '${spaceName}'. ` +
+                                    `Use list_projects to find valid project names. Project names are case-sensitive.`,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const runbookRepository = new RunbookRepository(client, spaceName, project);
+            if (runbookId) {
+                const runbook = await runbookRepository.get(runbookId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(runbookSummary(runbook, spaceName)),
+                        },
+                    ],
+                };
+            }
+            const runbooksResponse = await runbookRepository.list({
+                partialName,
+                skip,
+                take,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            totalResults: runbooksResponse.TotalResults,
+                            itemsPerPage: runbooksResponse.ItemsPerPage,
+                            numberOfPages: runbooksResponse.NumberOfPages,
+                            lastPageNumber: runbooksResponse.LastPageNumber,
+                            items: runbooksResponse.Items.map((runbook) => runbookSummary(runbook, spaceName)),
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "runbook",
+                entityId: runbookId,
+                spaceName,
+                helpText: "Use list_projects to find valid project names. Call find_runbooks without runbookId to list all runbooks for a project.",
+            });
+        }
+    });
+}
+registerToolDefinition({
+    toolName: "find_runbooks",
+    config: { toolset: "runbooks", readOnly: true },
+    registerFn: registerFindRunbooksTool,
+});
+//# sourceMappingURL=findRunbooks.js.map

package/dist/tools/findRunbooks.js.map

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

package/dist/tools/findTenants.d.ts

@@ -0,0 +1,19 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface FindTenantsParams {
+    spaceName: string;
+    tenantId?: string;
+    skip?: number;
+    take?: number;
+    projectId?: string;
+    tags?: string;
+    ids?: string[];
+    partialName?: string;
+}
+export declare function findTenantsHandler(params: FindTenantsParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function registerFindTenantsTool(server: McpServer): void;
+//# sourceMappingURL=findTenants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findTenants.d.ts","sourceRoot":"","sources":["../../src/tools/findTenants.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB;;;;;GAgGjE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAwCxD"}