@octopusdeploy/mcp-server 1.1.0 → 2.1.1

package/dist/tools/listSpaces.js

@@ -3,16 +3,19 @@ import { z } from "zod";
 import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
 import {} from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerToolDefinition } from "../types/toolConfig.js";
+import { READ_ONLY_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
 import { spacesDescription } from "../types/spaceTypes.js";
 import { handleOctopusApiError } from "../helpers/errorHandling.js";
 export function registerListSpacesTool(server) {
-    server.tool("list_spaces", `List all spaces in the Octopus Deploy instance. ${spacesDescription} Always use this tool first to check that the requested space exists.`, {
-        partialName: z.string().optional(),
-        skip: z.number().optional(),
-        take: z.number().optional(),
-    }, {
+    server.registerTool("list_spaces", {
         title: "List all spaces in an Octopus Deploy instance",
-        readOnlyHint: true,
+        description: `List all spaces in the Octopus Deploy instance. ${spacesDescription} Always use this tool first to check that the requested space exists.`,
+        inputSchema: {
+            partialName: z.string().optional(),
+            skip: z.number().optional(),
+            take: z.number().optional(),
+        },
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ partialName, skip, take }) => {
         try {
             const configuration = getClientConfigurationFromEnvironment();

package/dist/tools/listSpaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"listSpaces.js","sourceRoot":"","sources":["../../src/tools/listSpaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,aAAa,EACb,mDAAmD,iBAAiB,uEAAuE,EAC3I;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,EACD;QACE,KAAK,EAAE,+CAA+C;QACtD,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACpC,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YAClD,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;YAEpD,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC;gBAChD,WAAW;gBACX,IAAI;gBACJ,IAAI;aACL,CAAC,CAAC;YAEH,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtC,MAAM,OAAO,GAAG,WAAW;oBACzB,CAAC,CAAC,6BAA6B,WAAW,oCAAoC;oBAC9E,CAAC,CAAC,yEAAyE,CAAC;gBAE9E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,OAAO;yBACd;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,YAAY,EAAE,cAAc,CAAC,YAAY;4BACzC,YAAY,EAAE,cAAc,CAAC,YAAY;4BACzC,aAAa,EAAE,cAAc,CAAC,aAAa;4BAC3C,cAAc,EAAE,cAAc,CAAC,cAAc;4BAC7C,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gCAC1C,EAAE,EAAE,KAAK,CAAC,EAAE;gCACZ,IAAI,EAAE,KAAK,CAAC,IAAI;gCAChB,WAAW,EAAE,KAAK,CAAC,WAAW;gCAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;gCAC1B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;6BACzC,CAAC,CAAC;yBACJ,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,aAAa;IACvB,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC3C,UAAU,EAAE,sBAAsB;CACnC,CAAC,CAAC"}
+{"version":3,"file":"listSpaces.js","sourceRoot":"","sources":["../../src/tools/listSpaces.ts"],"names":[],"mappings":"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"}

package/dist/tools/readResource.d.ts

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

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

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

package/dist/tools/readResource.js

@@ -0,0 +1,50 @@
+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 { dispatchOctopusUri } from "../resources/dispatch.js";
+export function registerReadResourceTool(server) {
+    server.registerTool("read_resource", {
+        title: "Read an Octopus resource by URI",
+        description: `Universal fetch for any 'octopus://' URI returned by any other tool. Use this whenever you see fields like 'resourceUri' or 'taskResourceUri' in a response and need the full body.
+
+How to use:
+- Pass the URI string verbatim. Examples: 'octopus://spaces/Default/releases/Releases-42', 'octopus://spaces/Default/tasks/ServerTasks-7', 'octopus://spaces/Default/tasks/ServerTasks-7/details'.
+- The response 'mimeType' tells you how to interpret 'text': 'application/json' → parse as JSON.
+
+This tool is the backstop for clients that do not natively implement the MCP 'resources/read' primitive. Clients that DO support resources/read (Claude Code, MCP Inspector) can call it directly and skip this tool. Either path returns byte-identical bodies.
+
+Tools that return resource URIs include: find_releases, get_deployment_from_url, get_task_from_url, and others. When in doubt, call read_resource on any 'octopus://' string you encounter.
+
+Note: there is intentionally no octopus://...tasks/{id}/log resource. Call the grep_task_log tool to search task logs without inhaling the full body.`,
+        inputSchema: {
+            uri: z
+                .string()
+                .describe("Any 'octopus://...' URI returned by another tool (e.g. in the resourceUri or taskResourceUri field)."),
+        },
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
+    }, async ({ uri }) => {
+        const payload = await dispatchOctopusUri(uri);
+        if (payload === null) {
+            throw new Error(`Unrecognised resource URI '${uri}'.`);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        uri,
+                        mimeType: payload.mimeType,
+                        text: payload.text,
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "read_resource",
+    config: { toolset: "core", readOnly: true },
+    registerFn: registerReadResourceTool,
+});
+//# sourceMappingURL=readResource.js.map

package/dist/tools/readResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readResource.js","sourceRoot":"","sources":["../../src/tools/readResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EAAE;;;;;;;;;;sJAUmI;QAChJ,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,CACP,sGAAsG,CACvG;SACJ;QACD,WAAW,EAAE,0BAA0B;KACxC,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAE9C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,GAAG;wBACH,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;qBACnB,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC3C,UAAU,EAAE,wBAAwB;CACrC,CAAC,CAAC"}

package/dist/tools/runRunbook.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"runRunbook.d.ts","sourceRoot":"","sources":["../../src/tools/runRunbook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA+MvD"}

package/dist/tools/runRunbook.js

@@ -0,0 +1,174 @@
+import { Client, RunbookRunRepository } 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 { DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { handleOctopusApiError } from "../helpers/errorHandling.js";
+import { requireConfirmation, unconfirmedResponse, } from "../helpers/requireConfirmation.js";
+export function registerRunRunbookTool(server) {
+    server.registerTool("run_runbook", {
+        title: "Run a runbook in Octopus Deploy",
+        description: `Run a runbook against one or more environments in Octopus Deploy
+
+Runbooks execute operational processes (DB backups, smoke tests, environment refresh, etc.) against the specified environments. By default the published snapshot is used; pass runbookSnapshotId to run a specific snapshot. For tenanted runs, supply tenants and/or tenantTags.`,
+        inputSchema: {
+            spaceName: z.string().describe("The space name"),
+            projectName: z.string().describe("The project name"),
+            runbookName: z
+                .string()
+                .describe("The runbook name (within the project)"),
+            environmentNames: z
+                .array(z.string())
+                .min(1)
+                .describe("Array of environment names. At least one environment must be provided."),
+            tenants: z
+                .array(z.string())
+                .optional()
+                .describe("Array of tenant names for tenanted runs (optional)"),
+            tenantTags: z
+                .array(z.string())
+                .optional()
+                .describe("Array of tenant tags for tenanted runs (e.g., ['Region/US-West', 'Tier/Production'])"),
+            runbookSnapshotId: z
+                .string()
+                .optional()
+                .describe("Specific snapshot ID. Defaults to the runbook's published snapshot if omitted."),
+            promptedVariableValues: z
+                .record(z.string())
+                .optional()
+                .describe("Prompted variable values as key-value pairs"),
+            useGuidedFailure: z
+                .boolean()
+                .optional()
+                .describe("Use guided failure mode"),
+            forcePackageDownload: z
+                .boolean()
+                .optional()
+                .describe("Force package download"),
+            specificMachineNames: z
+                .array(z.string())
+                .optional()
+                .describe("Run on specific machines only"),
+            excludedMachineNames: z
+                .array(z.string())
+                .optional()
+                .describe("Exclude specific machines from the run"),
+            skipStepNames: z
+                .array(z.string())
+                .optional()
+                .describe("Skip specific runbook steps"),
+            runAt: z
+                .string()
+                .optional()
+                .describe("Schedule run for later (ISO 8601 date string)"),
+            noRunAfter: z
+                .string()
+                .optional()
+                .describe("Don't run after this time (ISO 8601 date string)"),
+            confirm: z
+                .boolean()
+                .optional()
+                .describe("Required only when the MCP client does not support elicitation. Set to true to confirm the run; otherwise the tool aborts."),
+        },
+        annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
+    }, async ({ spaceName, projectName, runbookName, environmentNames, tenants, tenantTags, runbookSnapshotId, promptedVariableValues, useGuidedFailure, forcePackageDownload, specificMachineNames, excludedMachineNames, skipStepNames, runAt, noRunAfter, confirm, }) => {
+        try {
+            const isTenanted = (tenants && tenants.length > 0) ||
+                (tenantTags && tenantTags.length > 0);
+            const tenantSummary = isTenanted
+                ? ` for tenants [${(tenants ?? []).join(", ")}${tenantTags?.length ? `; tags: ${tenantTags.join(", ")}` : ""}]`
+                : "";
+            const confirmMessage = `Run runbook ${runbookName} of ${projectName} in ` +
+                `[${environmentNames.join(", ")}]${tenantSummary} in space ${spaceName}?`;
+            const command = {
+                spaceName: spaceName,
+                ProjectName: projectName,
+                RunbookName: runbookName,
+                EnvironmentNames: environmentNames,
+                ...(tenants && { Tenants: tenants }),
+                ...(tenantTags && { TenantTags: tenantTags }),
+                ...(runbookSnapshotId && { Snapshot: runbookSnapshotId }),
+                ...(promptedVariableValues && { Variables: promptedVariableValues }),
+                ...(useGuidedFailure !== undefined && {
+                    UseGuidedFailure: useGuidedFailure,
+                }),
+                ...(forcePackageDownload !== undefined && {
+                    ForcePackageDownload: forcePackageDownload,
+                }),
+                ...(specificMachineNames && {
+                    SpecificMachineNames: specificMachineNames,
+                }),
+                ...(excludedMachineNames && {
+                    ExcludedMachineNames: excludedMachineNames,
+                }),
+                ...(skipStepNames && { SkipStepNames: skipStepNames }),
+                ...(runAt && { RunAt: new Date(runAt) }),
+                ...(noRunAfter && { NoRunAfter: new Date(noRunAfter) }),
+            };
+            const confirmation = await requireConfirmation(server, {
+                message: confirmMessage,
+                fallbackConfirm: confirm,
+                change: { source: {}, target: command },
+            });
+            if (!confirmation.confirmed) {
+                return unconfirmedResponse(confirmation, { action: "runbook run" });
+            }
+            const configuration = getClientConfigurationFromEnvironment();
+            const client = await Client.create(configuration);
+            const runbookRunRepository = new RunbookRunRepository(client, spaceName);
+            const response = await runbookRunRepository.create(command);
+            const tasks = response.RunbookRunServerTasks || [];
+            const encodedSpace = encodeURIComponent(spaceName);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            runsCreated: tasks.length,
+                            runbookRunTasks: tasks.map((task) => ({
+                                taskId: task.ServerTaskId,
+                                runbookRunId: task.RunbookRunId,
+                                resourceUri: `octopus://spaces/${encodedSpace}/tasks/${encodeURIComponent(task.ServerTaskId)}`,
+                            })),
+                            message: `Successfully started ${tasks.length} runbook run(s) for ${runbookName}`,
+                            helpText: `Fetch octopus://spaces/{spaceName}/tasks/{taskId} (or /details for the structured activity tree) via resources/read or read_resource to monitor run progress. To search the raw log for a specific error or step, call grep_task_log with the taskId.`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && !error.message.includes("octopus")) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: error.message,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            handleOctopusApiError(error, {
+                entityType: "runbook run",
+                spaceName,
+                helpText: "Use list_projects to find valid project names, list_environments for environment names, find_tenants for tenant information. Ensure the runbook has a published snapshot (or pass an explicit runbookSnapshotId) and you have permissions to run it.",
+            });
+        }
+    });
+}
+registerToolDefinition({
+    toolName: "run_runbook",
+    config: { toolset: "runbooks", readOnly: false },
+    registerFn: registerRunRunbookTool,
+    // The api-client's RunbookRunRepository.create throws at runtime if the
+    // server is older than 2022.3.5512 (the Executions API minimum). Surface
+    // that here so --list-tools-by-version reports it accurately.
+    minimumOctopusVersion: "2022.3.5512",
+});
+//# sourceMappingURL=runRunbook.js.map

package/dist/tools/runRunbook.js.map

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

package/dist/tools/updateFeatureToggle.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const updateFeatureToggleSchema: z.ZodEffects<z.ZodObject<{
+    spaceName: z.ZodString;
+    projectId: z.ZodString;
+    slug: z.ZodString;
+    defaultIsEnabled: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    environments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        deploymentEnvironmentId: z.ZodString;
+        isEnabled: z.ZodOptional<z.ZodBoolean>;
+        rolloutPercentage: z.ZodOptional<z.ZodNumber>;
+        clientRolloutPercentage: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }, {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }>, "many">>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    spaceName: string;
+    projectId: string;
+    slug: string;
+    description?: string | undefined;
+    environments?: {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }[] | undefined;
+    defaultIsEnabled?: boolean | undefined;
+    confirm?: boolean | undefined;
+}, {
+    spaceName: string;
+    projectId: string;
+    slug: string;
+    description?: string | undefined;
+    environments?: {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }[] | undefined;
+    defaultIsEnabled?: boolean | undefined;
+    confirm?: boolean | undefined;
+}>, {
+    spaceName: string;
+    projectId: string;
+    slug: string;
+    description?: string | undefined;
+    environments?: {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }[] | undefined;
+    defaultIsEnabled?: boolean | undefined;
+    confirm?: boolean | undefined;
+}, {
+    spaceName: string;
+    projectId: string;
+    slug: string;
+    description?: string | undefined;
+    environments?: {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }[] | undefined;
+    defaultIsEnabled?: boolean | undefined;
+    confirm?: boolean | undefined;
+}>;
+export type UpdateFeatureToggleParams = z.infer<typeof updateFeatureToggleSchema>;
+export declare function updateFeatureToggleHandler(server: McpServer, params: UpdateFeatureToggleParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare function registerUpdateFeatureToggleTool(server: McpServer): void;
+//# sourceMappingURL=updateFeatureToggle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateFeatureToggle.d.ts","sourceRoot":"","sources":["../../src/tools/updateFeatureToggle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwCzE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsDlC,CAAC;AAEL,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAoFlF,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,yBAAyB;;;;;;;;;;;;GAkMlC;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,QAiBhE"}