@octopusdeploy/mcp-server 1.1.0 → 2.1.0

package/dist/resources/catalog/capabilities.js

@@ -0,0 +1,90 @@
+import { Client } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../../helpers/getClientConfigurationFromEnvironment.js";
+import { TOOL_REGISTRY, DEFAULT_TOOLSETS, } from "../../types/toolConfig.js";
+import { getActiveToolsetConfig } from "../../helpers/activeToolsetConfig.js";
+import {} from "../../helpers/methodTier.js";
+function resolveEnabledToolsets() {
+    const config = getActiveToolsetConfig();
+    if (config.enabledToolsets === "all" || config.enabledToolsets == null) {
+        return DEFAULT_TOOLSETS;
+    }
+    return config.enabledToolsets;
+}
+export async function buildCapabilities() {
+    const client = await Client.create(getClientConfigurationFromEnvironment());
+    const serverInfo = await client.getServerInformation();
+    const activeConfig = getActiveToolsetConfig();
+    const enabledToolsets = resolveEnabledToolsets();
+    const readOnlyMode = activeConfig.readOnlyMode ?? false;
+    const allowDeletes = activeConfig.allowDeletes ?? false;
+    const enabledSet = new Set(enabledToolsets);
+    enabledSet.add("core");
+    const tools = [];
+    for (const [name, registration] of TOOL_REGISTRY) {
+        if (!enabledSet.has(registration.config.toolset))
+            continue;
+        if (readOnlyMode && !registration.config.readOnly)
+            continue;
+        const entry = {
+            name,
+            toolset: registration.config.toolset,
+            readOnly: registration.config.readOnly,
+            minimumOctopusVersion: registration.minimumOctopusVersion,
+        };
+        // The execute tool registers as readOnly:true (so it survives the
+        // registration filter in read-only mode for its GET branch) but its
+        // actual behaviour is method-gated. Surface that explicitly so callers
+        // don't conclude execute is fully read-only.
+        if (name === "execute") {
+            entry.methodGated = true;
+            const tiers = ["read"];
+            if (!readOnlyMode)
+                tiers.push("write");
+            if (!readOnlyMode && allowDeletes)
+                tiers.push("delete");
+            entry.tiersAvailable = tiers;
+        }
+        tools.push(entry);
+    }
+    tools.sort((a, b) => a.name.localeCompare(b.name));
+    let featureFlags;
+    try {
+        featureFlags = await client.get("~/api/serverstatus/extensions");
+    }
+    catch {
+        // The serverstatus/extensions endpoint isn't universally available across
+        // older Octopus versions. Omit feature flags rather than failing the whole
+        // capabilities read — server version is the high-value field.
+        featureFlags = undefined;
+    }
+    const capabilities = {
+        server: {
+            version: serverInfo.version,
+            installationId: serverInfo.installationId,
+        },
+        session: {
+            enabledToolsets: Array.from(enabledSet).sort(),
+            readOnlyMode,
+            allowDeletes,
+        },
+        tools,
+    };
+    if (featureFlags !== undefined) {
+        capabilities.featureFlags = featureFlags;
+    }
+    return capabilities;
+}
+registerResourceDescriptor({
+    name: "catalog-capabilities",
+    uriTemplate: "octopus://api/capabilities",
+    toolset: "core",
+    title: "Octopus MCP capabilities",
+    description: "Server version, enabled toolsets, available tools, and Octopus feature flags for this MCP session. Use this to discover what's reachable before calling other tools.",
+    mimeType: "application/json",
+    read: async () => ({
+        mimeType: "application/json",
+        text: JSON.stringify(await buildCapabilities()),
+    }),
+});
+//# sourceMappingURL=capabilities.js.map

package/dist/resources/catalog/capabilities.js.map

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

package/dist/resources/catalog/llmsTxt.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Fetch llms.txt for the configured Octopus server, with a 5-minute TTL cache.
+ * Exposed so grep_llms_txt can share the same cache.
+ */
+export declare function fetchLlmsTxt(): Promise<string>;
+/** Test seam: clear the cache between tests. */
+export declare function clearLlmsTxtCache(): void;
+//# sourceMappingURL=llmsTxt.d.ts.map

package/dist/resources/catalog/llmsTxt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmsTxt.d.ts","sourceRoot":"","sources":["../../../src/resources/catalog/llmsTxt.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAcpD;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/resources/catalog/llmsTxt.js

@@ -0,0 +1,44 @@
+import { Client } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../../helpers/getClientConfigurationFromEnvironment.js";
+const LLMS_TXT_PATH = "~/api/experimental/llms.txt";
+const CACHE_TTL_MS = 5 * 60 * 1000;
+// Module-scoped cache keyed on the configured Octopus server URL. llms.txt
+// only changes when Octopus itself ships a new version; refetching on every
+// resource read or every grep call would burn ~360 KB of bandwidth and add
+// latency to every catalog query.
+const cache = new Map();
+/**
+ * Fetch llms.txt for the configured Octopus server, with a 5-minute TTL cache.
+ * Exposed so grep_llms_txt can share the same cache.
+ */
+export async function fetchLlmsTxt() {
+    const configuration = getClientConfigurationFromEnvironment();
+    const cacheKey = configuration.instanceURL ?? "(unknown)";
+    const now = Date.now();
+    const hit = cache.get(cacheKey);
+    if (hit && now - hit.fetchedAt < CACHE_TTL_MS) {
+        return hit.body;
+    }
+    const client = await Client.create(configuration);
+    const body = await client.getRaw(LLMS_TXT_PATH);
+    cache.set(cacheKey, { body, fetchedAt: now });
+    return body;
+}
+/** Test seam: clear the cache between tests. */
+export function clearLlmsTxtCache() {
+    cache.clear();
+}
+registerResourceDescriptor({
+    name: "catalog-llms-txt",
+    uriTemplate: "octopus://api/llms.txt",
+    toolset: "core",
+    title: "Octopus API catalog (llms.txt)",
+    description: "Markdown catalog of every Octopus REST endpoint, including HTTP method, path, query params, and request/response types. Large (~300+ KB) — prefer the grep_llms_txt tool to search it instead of reading the whole body. Requires Octopus Server 2026.2.3916 or later (the /api/experimental/llms.txt endpoint shipped in that release).",
+    mimeType: "text/markdown",
+    read: async () => ({
+        mimeType: "text/markdown",
+        text: await fetchLlmsTxt(),
+    }),
+});
+//# sourceMappingURL=llmsTxt.js.map

package/dist/resources/catalog/llmsTxt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmsTxt.js","sourceRoot":"","sources":["../../../src/resources/catalog/llmsTxt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,qCAAqC,EAAE,MAAM,wDAAwD,CAAC;AAE/G,MAAM,aAAa,GAAG,6BAA6B,CAAC;AACpD,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAOnC,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,kCAAkC;AAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;IAC9D,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,IAAI,WAAW,CAAC;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QAC9C,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAChD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,iBAAiB;IAC/B,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,0BAA0B,CAAC;IACzB,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,wBAAwB;IACrC,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,gCAAgC;IACvC,WAAW,EACT,0UAA0U;IAC5U,QAAQ,EAAE,eAAe;IACzB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,QAAQ,EAAE,eAAe;QACzB,IAAI,EAAE,MAAM,YAAY,EAAE;KAC3B,CAAC;CACH,CAAC,CAAC"}

package/dist/resources/dispatch.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Registry-driven dispatch for octopus:// resource URIs.
+ *
+ * Both the Resource Template registrations (src/resources/index.ts) and the
+ * `read_resource` Tool backstop (src/tools/readResource.ts) flow through the
+ * same descriptor registry, so resource-aware clients (which call resources/read)
+ * and resource-less clients (which call the Tool wrapper) hit identical logic.
+ *
+ * Toolset filtering is enforced at dispatch time. Native MCP clients only
+ * see resources whose toolset is enabled because registerResources skips
+ * disabled descriptors at registration. The `read_resource` backstop, by
+ * contrast, is registered under `core` and is always available — so without
+ * filtering here a caller could guess a URI for a descriptor whose toolset
+ * is disabled and still fetch the body. The filter below closes that gap.
+ */
+import { type ResourcePayload } from "../types/resourceConfig.js";
+/**
+ * Pick the first value for each variable and URL-decode it.
+ *
+ * The SDK's UriTemplate.match captures regex groups as raw strings (no decoding),
+ * so an input URI like `octopus://spaces/AI%20Foundations/releases/Releases-1`
+ * yields `spaceName = "AI%20Foundations"` here. Decoding makes the variables
+ * usable directly against the Octopus API, which expects the literal `AI Foundations`.
+ *
+ * Falls back to the raw value if a string contains an invalid percent-escape so
+ * a malformed input surfaces as a clearer downstream error rather than a URIError.
+ */
+export declare function flatten(variables: Record<string, string | string[]>): Record<string, string>;
+export declare function dispatchOctopusUri(uri: string): Promise<ResourcePayload | null>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/resources/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/resources/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAmBpC;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAmBD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAejC"}

package/dist/resources/dispatch.js

@@ -0,0 +1,81 @@
+/**
+ * Registry-driven dispatch for octopus:// resource URIs.
+ *
+ * Both the Resource Template registrations (src/resources/index.ts) and the
+ * `read_resource` Tool backstop (src/tools/readResource.ts) flow through the
+ * same descriptor registry, so resource-aware clients (which call resources/read)
+ * and resource-less clients (which call the Tool wrapper) hit identical logic.
+ *
+ * Toolset filtering is enforced at dispatch time. Native MCP clients only
+ * see resources whose toolset is enabled because registerResources skips
+ * disabled descriptors at registration. The `read_resource` backstop, by
+ * contrast, is registered under `core` and is always available — so without
+ * filtering here a caller could guess a URI for a descriptor whose toolset
+ * is disabled and still fetch the body. The filter below closes that gap.
+ */
+import { UriTemplate } from "@modelcontextprotocol/sdk/shared/uriTemplate.js";
+import { RESOURCE_REGISTRY, } from "../types/resourceConfig.js";
+import { DEFAULT_TOOLSETS, } from "../types/toolConfig.js";
+import { getActiveToolsetConfig } from "../helpers/activeToolsetConfig.js";
+const COMPILED = new WeakMap();
+function compiled(descriptor) {
+    let template = COMPILED.get(descriptor);
+    if (!template) {
+        template = new UriTemplate(descriptor.uriTemplate);
+        COMPILED.set(descriptor, template);
+    }
+    return template;
+}
+/**
+ * Pick the first value for each variable and URL-decode it.
+ *
+ * The SDK's UriTemplate.match captures regex groups as raw strings (no decoding),
+ * so an input URI like `octopus://spaces/AI%20Foundations/releases/Releases-1`
+ * yields `spaceName = "AI%20Foundations"` here. Decoding makes the variables
+ * usable directly against the Octopus API, which expects the literal `AI Foundations`.
+ *
+ * Falls back to the raw value if a string contains an invalid percent-escape so
+ * a malformed input surfaces as a clearer downstream error rather than a URIError.
+ */
+export function flatten(variables) {
+    const out = {};
+    for (const [key, value] of Object.entries(variables)) {
+        const first = Array.isArray(value) ? (value[0] ?? "") : value;
+        out[key] = safeDecode(first);
+    }
+    return out;
+}
+function safeDecode(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+function isToolsetEnabled(toolset, config) {
+    if (toolset === "core")
+        return true;
+    const enabled = config.enabledToolsets === "all"
+        ? DEFAULT_TOOLSETS
+        : config.enabledToolsets || DEFAULT_TOOLSETS;
+    return enabled.includes(toolset);
+}
+export async function dispatchOctopusUri(uri) {
+    if (!uri.startsWith("octopus://"))
+        return null;
+    const config = getActiveToolsetConfig();
+    for (const descriptor of RESOURCE_REGISTRY) {
+        const variables = compiled(descriptor).match(uri);
+        if (!variables)
+            continue;
+        // Even though the URI matches, the descriptor's toolset may be disabled
+        // for this session. Skip and keep looking — but no other descriptor
+        // should claim the same template, so this effectively returns null.
+        if (!isToolsetEnabled(descriptor.toolset, config))
+            continue;
+        return descriptor.read(flatten(variables));
+    }
+    return null;
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/resources/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/resources/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAC9E,OAAO,EACL,iBAAiB,GAGlB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,GAGjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAmC,CAAC;AAEhE,SAAS,QAAQ,CAAC,UAA8B;IAC9C,IAAI,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACnD,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CACrB,SAA4C;IAE5C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9D,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB,EAAE,MAAqB;IAC/D,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,OAAO,GACX,MAAM,CAAC,eAAe,KAAK,KAAK;QAC9B,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,MAAM,CAAC,eAAe,IAAI,gBAAgB,CAAC;IACjD,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW;IAEX,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,wEAAwE;QACxE,oEAAoE;QACpE,oEAAoE;QACpE,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;YAAE,SAAS;QAC5D,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/resources/featureToggle.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=featureToggle.d.ts.map

package/dist/resources/featureToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureToggle.d.ts","sourceRoot":"","sources":["../../src/resources/featureToggle.ts"],"names":[],"mappings":""}

package/dist/resources/featureToggle.js

@@ -0,0 +1,34 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { handleOctopusApiError } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+import {} from "../types/featureToggleTypes.js";
+registerResourceDescriptor({
+    name: "featureToggle",
+    uriTemplate: "octopus://spaces/{spaceName}/projects/{projectId}/featuretoggles/{slug}",
+    toolset: "featureToggles",
+    title: "Octopus feature toggle",
+    description: "Full customer feature toggle body for a given slug in a project. Includes per-environment configuration (tenants, segments, minimum versions) that the find_feature_toggles slim summary omits.",
+    mimeType: "application/json",
+    read: async ({ spaceName, projectId, slug }) => {
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const spaceId = await resolveSpaceId(client, spaceName);
+            const toggle = await client.get("~/api/{spaceId}/projects/{projectId}/featuretoggles/{slug}", { spaceId, projectId, slug });
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(toggle)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "feature toggle",
+                entityId: slug,
+                spaceName,
+                helpText: "Use find_feature_toggles to list valid slugs. If 404 persists across all toggles, the customer feature toggles capability may be disabled on the Octopus instance.",
+            });
+        }
+    },
+});
+//# sourceMappingURL=featureToggle.js.map

package/dist/resources/featureToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureToggle.js","sourceRoot":"","sources":["../../src/resources/featureToggle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAA8B,MAAM,gCAAgC,CAAC;AAE5E,0BAA0B,CAAC;IACzB,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,yEAAyE;IAC3E,OAAO,EAAE,gBAAgB;IACzB,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EACT,iMAAiM;IACnM,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAC7B,4DAA4D,EAC5D,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAC7B,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;aACzC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,gBAAgB;gBAC5B,QAAQ,EAAE,IAAI;gBACd,SAAS;gBACT,QAAQ,EACN,oKAAoK;aACvK,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,12 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolsetConfig } from "../types/toolConfig.js";
+import "./release.js";
+import "./runbook.js";
+import "./task.js";
+import "./interruption.js";
+import "./featureToggle.js";
+import "./rolloutGroup.js";
+import "./catalog/llmsTxt.js";
+import "./catalog/capabilities.js";
+export declare function registerResources(server: McpServer, config?: ToolsetConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAC3F,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,cAAc,CAAC;AACtB,OAAO,cAAc,CAAC;AACtB,OAAO,WAAW,CAAC;AACnB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,2BAA2B,CAAC;AAWnC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,GAAE,aAAkB,GAAG,IAAI,CA2BrF"}

package/dist/resources/index.js

@@ -0,0 +1,44 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { DEFAULT_TOOLSETS, } from "../types/toolConfig.js";
+import { RESOURCE_REGISTRY } from "../types/resourceConfig.js";
+import { flatten } from "./dispatch.js";
+import { setActiveToolsetConfig } from "../helpers/activeToolsetConfig.js";
+// Side-effect imports populate RESOURCE_REGISTRY.
+import "./release.js";
+import "./runbook.js";
+import "./task.js";
+import "./interruption.js";
+import "./featureToggle.js";
+import "./rolloutGroup.js";
+import "./catalog/llmsTxt.js";
+import "./catalog/capabilities.js";
+function isToolsetEnabled(toolset, config) {
+    const enabled = config.enabledToolsets === "all"
+        ? DEFAULT_TOOLSETS
+        : config.enabledToolsets || DEFAULT_TOOLSETS;
+    return toolset === "core" || enabled.includes(toolset);
+}
+export function registerResources(server, config = {}) {
+    setActiveToolsetConfig(config);
+    for (const descriptor of RESOURCE_REGISTRY) {
+        if (!isToolsetEnabled(descriptor.toolset, config))
+            continue;
+        server.registerResource(descriptor.name, new ResourceTemplate(descriptor.uriTemplate, { list: undefined }), {
+            title: descriptor.title,
+            description: descriptor.description,
+            mimeType: descriptor.mimeType,
+        }, async (uri, variables) => {
+            const payload = await descriptor.read(flatten(variables));
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: payload.mimeType,
+                        text: payload.text,
+                    },
+                ],
+            };
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3F,OAAO,EAGL,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,kDAAkD;AAClD,OAAO,cAAc,CAAC;AACtB,OAAO,cAAc,CAAC;AACtB,OAAO,WAAW,CAAC;AACnB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,2BAA2B,CAAC;AAEnC,SAAS,gBAAgB,CAAC,OAAgB,EAAE,MAAqB;IAC/D,MAAM,OAAO,GACX,MAAM,CAAC,eAAe,KAAK,KAAK;QAC9B,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,MAAM,CAAC,eAAe,IAAI,gBAAgB,CAAC;IAEjD,OAAO,OAAO,KAAK,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,SAAwB,EAAE;IAC7E,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;QAC3C,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;YAAE,SAAS;QAE5D,MAAM,CAAC,gBAAgB,CACrB,UAAU,CAAC,IAAI,EACf,IAAI,gBAAgB,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACjE;YACE,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;YACvB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;YAC1D,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;qBACnB;iBACF;aACF,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/resources/interruption.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interruption.d.ts.map

package/dist/resources/interruption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interruption.d.ts","sourceRoot":"","sources":["../../src/resources/interruption.ts"],"names":[],"mappings":""}

package/dist/resources/interruption.js

@@ -0,0 +1,34 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+registerResourceDescriptor({
+    name: "interruption",
+    uriTemplate: "octopus://spaces/{spaceName}/interruptions/{interruptionId}",
+    toolset: "interruptions",
+    title: "Octopus interruption",
+    description: "Full interruption body for a given interruption ID in a space. Includes Form.Elements (the form definition with control types, labels, button options, and Paragraph instructions in Markdown) and Form.Values (any already-submitted values), plus RelatedDocumentIds, ResponsibleTeamIds, ResponsibleUserId, and the responsibility flags. Use this when the find_interruptions slim summary is not enough — for example, when the user wants to see the intervention's instructions or the set of choices on the SubmitButtonGroup.",
+    mimeType: "application/json",
+    read: async ({ spaceName, interruptionId }) => {
+        validateEntityId(interruptionId, "interruption", ENTITY_PREFIXES.interruption);
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const spaceId = await resolveSpaceId(client, spaceName);
+            const interruption = await client.get("~/api/{spaceId}/interruptions/{interruptionId}", { spaceId, interruptionId });
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(interruption)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "interruption",
+                entityId: interruptionId,
+                spaceName,
+                helpText: "Use find_interruptions to find valid interruption IDs.",
+            });
+        }
+    },
+});
+//# sourceMappingURL=interruption.js.map

package/dist/resources/interruption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interruption.js","sourceRoot":"","sources":["../../src/resources/interruption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,0BAA0B,CAAC;IACzB,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,6DAA6D;IAC1E,OAAO,EAAE,eAAe;IACxB,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,wgBAAwgB;IAC1gB,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE;QAC5C,gBAAgB,CAAC,cAAc,EAAE,cAAc,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,GAAG,CACnC,gDAAgD,EAChD,EAAE,OAAO,EAAE,cAAc,EAAE,CAC5B,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;aAC/C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,cAAc;gBAC1B,QAAQ,EAAE,cAAc;gBACxB,SAAS;gBACT,QAAQ,EAAE,wDAAwD;aACnE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/resources/release.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=release.d.ts.map

package/dist/resources/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/resources/release.ts"],"names":[],"mappings":""}

package/dist/resources/release.js

@@ -0,0 +1,33 @@
+import { Client, ReleaseRepository } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+registerResourceDescriptor({
+    name: "release",
+    uriTemplate: "octopus://spaces/{spaceName}/releases/{releaseId}",
+    toolset: "releases",
+    title: "Octopus release",
+    description: "Full release object for a given release ID in a space. Body shape mirrors the find_releases tool output for a single release.",
+    mimeType: "application/json",
+    read: async ({ spaceName, releaseId }) => {
+        validateEntityId(releaseId, "release", ENTITY_PREFIXES.release);
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const release = await new ReleaseRepository(client, spaceName).get(releaseId);
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(release)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "release",
+                entityId: releaseId,
+                spaceName,
+                helpText: "Use find_releases to find valid release IDs.",
+            });
+        }
+    },
+});
+//# sourceMappingURL=release.js.map

package/dist/resources/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../src/resources/release.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,0BAA0B,CAAC;IACzB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,mDAAmD;IAChE,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,+HAA+H;IACjI,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;QACvC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QAEhE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,IAAI,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAAG,CAChE,SAAS,CACV,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;aAC1C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,SAAS;gBACnB,SAAS;gBACT,QAAQ,EACN,8CAA8C;aACjD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/resources/rolloutGroup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rolloutGroup.d.ts.map

package/dist/resources/rolloutGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolloutGroup.d.ts","sourceRoot":"","sources":["../../src/resources/rolloutGroup.ts"],"names":[],"mappings":""}

package/dist/resources/rolloutGroup.js

@@ -0,0 +1,35 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+import {} from "../types/featureToggleTypes.js";
+registerResourceDescriptor({
+    name: "rolloutGroup",
+    uriTemplate: "octopus://spaces/{spaceName}/projects/{projectId}/rolloutgroups/{rolloutGroupId}",
+    toolset: "featureToggles",
+    title: "Octopus feature toggle rollout group",
+    description: "Full rollout group body for a given rollout group ID in a project. Lists the feature toggles bound to the group via FeatureToggleUsages. Read-only — this MCP server does not expose rollout group create/modify/delete; use the Octopus UI for those.",
+    mimeType: "application/json",
+    read: async ({ spaceName, projectId, rolloutGroupId }) => {
+        validateEntityId(rolloutGroupId, "rollout group", "RolloutGroups-");
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const spaceId = await resolveSpaceId(client, spaceName);
+            const group = await client.get("~/api/{spaceId}/projects/{projectId}/featuretoggles/rollout-groups/{rolloutGroupId}", { spaceId, projectId, rolloutGroupId });
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(group)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "rollout group",
+                entityId: rolloutGroupId,
+                spaceName,
+                helpText: "Rollout group IDs surface as RolloutGroupId on toggles returned from find_feature_toggles. They are unique per project.",
+            });
+        }
+    },
+});
+//# sourceMappingURL=rolloutGroup.js.map

package/dist/resources/rolloutGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolloutGroup.js","sourceRoot":"","sources":["../../src/resources/rolloutGroup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAA6B,MAAM,gCAAgC,CAAC;AAE3E,0BAA0B,CAAC;IACzB,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,kFAAkF;IACpF,OAAO,EAAE,gBAAgB;IACzB,KAAK,EAAE,sCAAsC;IAC7C,WAAW,EACT,wPAAwP;IAC1P,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE;QACvD,gBAAgB,CAAC,cAAc,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;QAEpE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,CAC5B,qFAAqF,EACrF,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CACvC,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;aACxC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,eAAe;gBAC3B,QAAQ,EAAE,cAAc;gBACxB,SAAS;gBACT,QAAQ,EACN,yHAAyH;aAC5H,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/resources/runbook.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runbook.d.ts.map

package/dist/resources/runbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runbook.d.ts","sourceRoot":"","sources":["../../src/resources/runbook.ts"],"names":[],"mappings":""}

package/dist/resources/runbook.js

@@ -0,0 +1,34 @@
+import { Client, resolveSpaceId, } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+registerResourceDescriptor({
+    name: "runbook",
+    uriTemplate: "octopus://spaces/{spaceName}/runbooks/{runbookId}",
+    toolset: "runbooks",
+    title: "Octopus runbook",
+    description: "Full runbook object for a given runbook ID in a space. Body shape mirrors the find_runbooks tool output for a single runbook, plus runtime policy fields (ConnectivityPolicy, DefaultGuidedFailureMode, RunRetentionPolicy) that the slim summary omits.",
+    mimeType: "application/json",
+    read: async ({ spaceName, runbookId }) => {
+        validateEntityId(runbookId, "runbook", ENTITY_PREFIXES.runbook);
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const spaceId = await resolveSpaceId(client, spaceName);
+            const runbook = await client.get("~/api/{spaceId}/runbooks/{id}", { spaceId, id: runbookId });
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(runbook)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "runbook",
+                entityId: runbookId,
+                spaceName,
+                helpText: "Use find_runbooks to find valid runbook IDs.",
+            });
+        }
+    },
+});
+//# sourceMappingURL=runbook.js.map

package/dist/resources/runbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runbook.js","sourceRoot":"","sources":["../../src/resources/runbook.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,cAAc,GAEf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,0BAA0B,CAAC;IACzB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,mDAAmD;IAChE,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,0PAA0P;IAC5P,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;QACvC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QAEhE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAC9B,+BAA+B,EAC/B,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAC3B,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;aAC1C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,SAAS;gBACnB,SAAS;gBACT,QAAQ,EAAE,8CAA8C;aACzD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/resources/task.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task.d.ts.map

package/dist/resources/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/resources/task.ts"],"names":[],"mappings":""}