@launchdarkly/mcp-server 0.4.0 → 0.4.1

package/src/funcs/environmentsListByProject.ts

@@ -0,0 +1,229 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { LaunchDarklyCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { LaunchDarklyError } from "../models/errors/launchdarklyerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * List environments
+ *
+ * @remarks
+ * Return a list of environments for the specified project.
+ *
+ * By default, this returns the first 20 environments. Page through this list with the `limit` parameter and by following the `first`, `prev`, `next`, and `last` links in the `_links` field that returns. If those links do not appear, the pages they refer to don't exist. For example, the `first` and `prev` links will be missing from the response on the first page, because there is no previous page and you cannot return to the first page when you are already on the first page.
+ *
+ * ### Filtering environments
+ *
+ * LaunchDarkly supports two fields for filters:
+ * - `query` is a string that matches against the environments' names and keys. It is not case sensitive.
+ * - `tags` is a `+`-separated list of environment tags. It filters the list of environments that have all of the tags in the list.
+ *
+ * For example, the filter `filter=query:abc,tags:tag-1+tag-2` matches environments with the string `abc` in their name or key and also are tagged with `tag-1` and `tag-2`. The filter is not case-sensitive.
+ *
+ * The documented values for `filter` query parameters are prior to URL encoding. For example, the `+` in `filter=tags:tag-1+tag-2` must be encoded to `%2B`.
+ *
+ * ### Sorting environments
+ *
+ * LaunchDarkly supports the following fields for sorting:
+ *
+ * - `createdOn` sorts by the creation date of the environment.
+ * - `critical` sorts by whether the environments are marked as critical.
+ * - `name` sorts by environment name.
+ *
+ * For example, `sort=name` sorts the response by environment name in ascending order.
+ */
+export function environmentsListByProject(
+  client: LaunchDarklyCore,
+  request: operations.GetEnvironmentsByProjectRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.Environments,
+    | errors.InvalidRequestErrorRep
+    | errors.UnauthorizedErrorRep
+    | errors.ForbiddenErrorRep
+    | errors.NotFoundErrorRep
+    | errors.MethodNotAllowedErrorRep
+    | errors.RateLimitedErrorRep
+    | LaunchDarklyError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: LaunchDarklyCore,
+  request: operations.GetEnvironmentsByProjectRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.Environments,
+      | errors.InvalidRequestErrorRep
+      | errors.UnauthorizedErrorRep
+      | errors.ForbiddenErrorRep
+      | errors.NotFoundErrorRep
+      | errors.MethodNotAllowedErrorRep
+      | errors.RateLimitedErrorRep
+      | LaunchDarklyError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.GetEnvironmentsByProjectRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    projectKey: encodeSimple("projectKey", payload.projectKey, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/api/v2/projects/{projectKey}/environments")(
+    pathParams,
+  );
+
+  const query = encodeFormQuery({
+    "filter": payload.filter,
+    "limit": payload.limit,
+    "offset": payload.offset,
+    "sort": payload.sort,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "getEnvironmentsByProject",
+    oAuth2Scopes: [],
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["400", "401", "403", "404", "405", "429", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.Environments,
+    | errors.InvalidRequestErrorRep
+    | errors.UnauthorizedErrorRep
+    | errors.ForbiddenErrorRep
+    | errors.NotFoundErrorRep
+    | errors.MethodNotAllowedErrorRep
+    | errors.RateLimitedErrorRep
+    | LaunchDarklyError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.Environments$inboundSchema),
+    M.jsonErr(400, errors.InvalidRequestErrorRep$inboundSchema),
+    M.jsonErr(401, errors.UnauthorizedErrorRep$inboundSchema),
+    M.jsonErr(403, errors.ForbiddenErrorRep$inboundSchema),
+    M.jsonErr(404, errors.NotFoundErrorRep$inboundSchema),
+    M.jsonErr(405, errors.MethodNotAllowedErrorRep$inboundSchema),
+    M.jsonErr(429, errors.RateLimitedErrorRep$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/featureFlagsGetStatus.ts

@@ -0,0 +1,201 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { LaunchDarklyCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { LaunchDarklyError } from "../models/errors/launchdarklyerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get flag status across environments
+ *
+ * @remarks
+ * Get the status for a particular feature flag across environments.
+ */
+export function featureFlagsGetStatus(
+  client: LaunchDarklyCore,
+  request: operations.GetFeatureFlagStatusAcrossEnvironmentsRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.FeatureFlagStatusAcrossEnvironments,
+    | errors.UnauthorizedErrorRep
+    | errors.ForbiddenErrorRep
+    | errors.NotFoundErrorRep
+    | errors.RateLimitedErrorRep
+    | LaunchDarklyError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: LaunchDarklyCore,
+  request: operations.GetFeatureFlagStatusAcrossEnvironmentsRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.FeatureFlagStatusAcrossEnvironments,
+      | errors.UnauthorizedErrorRep
+      | errors.ForbiddenErrorRep
+      | errors.NotFoundErrorRep
+      | errors.RateLimitedErrorRep
+      | LaunchDarklyError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.GetFeatureFlagStatusAcrossEnvironmentsRequest$outboundSchema
+        .parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    featureFlagKey: encodeSimple("featureFlagKey", payload.featureFlagKey, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    projectKey: encodeSimple("projectKey", payload.projectKey, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/api/v2/flag-status/{projectKey}/{featureFlagKey}")(
+    pathParams,
+  );
+
+  const query = encodeFormQuery({
+    "env": payload.env,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "getFeatureFlagStatusAcrossEnvironments",
+    oAuth2Scopes: [],
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["401", "403", "404", "429", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.FeatureFlagStatusAcrossEnvironments,
+    | errors.UnauthorizedErrorRep
+    | errors.ForbiddenErrorRep
+    | errors.NotFoundErrorRep
+    | errors.RateLimitedErrorRep
+    | LaunchDarklyError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.FeatureFlagStatusAcrossEnvironments$inboundSchema),
+    M.jsonErr(401, errors.UnauthorizedErrorRep$inboundSchema),
+    M.jsonErr(403, errors.ForbiddenErrorRep$inboundSchema),
+    M.jsonErr(404, errors.NotFoundErrorRep$inboundSchema),
+    M.jsonErr(429, errors.RateLimitedErrorRep$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -69,8 +69,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2.0",
-  sdkVersion: "0.4.0",
+  sdkVersion: "0.4.1",
   genVersion: "2.654.2",
   userAgent:
-    "speakeasy-sdk/typescript 0.4.0 2.654.2 2.0 @launchdarkly/mcp-server",
+    "speakeasy-sdk/typescript 0.4.1 2.654.2 2.0 @launchdarkly/mcp-server",
 } as const;

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.4.0",
+    currentVersion: "0.4.1",
   },
 });
 

package/src/mcp-server/server.ts

@@ -24,9 +24,12 @@ import { tool$aiConfigsList } from "./tools/aiConfigsList.js";
 import { tool$aiConfigsUpdate } from "./tools/aiConfigsUpdate.js";
 import { tool$aiConfigsUpdateTargeting } from "./tools/aiConfigsUpdateTargeting.js";
 import { tool$aiConfigsUpdateVariation } from "./tools/aiConfigsUpdateVariation.js";
+import { tool$codeReferencesListRepositories } from "./tools/codeReferencesListRepositories.js";
+import { tool$environmentsListByProject } from "./tools/environmentsListByProject.js";
 import { tool$featureFlagsCreate } from "./tools/featureFlagsCreate.js";
 import { tool$featureFlagsDelete } from "./tools/featureFlagsDelete.js";
 import { tool$featureFlagsGet } from "./tools/featureFlagsGet.js";
+import { tool$featureFlagsGetStatus } from "./tools/featureFlagsGetStatus.js";
 import { tool$featureFlagsList } from "./tools/featureFlagsList.js";
 import { tool$featureFlagsPatch } from "./tools/featureFlagsPatch.js";
 
@@ -40,7 +43,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "LaunchDarkly",
-    version: "0.4.0",
+    version: "0.4.1",
   });
 
   const client = new LaunchDarklyCore({
@@ -70,11 +73,14 @@ export function createMCPServer(deps: {
   const register = { tool, resource, resourceTemplate, prompt };
   void register; // suppress unused warnings
 
+  tool(tool$codeReferencesListRepositories);
+  tool(tool$featureFlagsGetStatus);
   tool(tool$featureFlagsList);
   tool(tool$featureFlagsCreate);
   tool(tool$featureFlagsGet);
   tool(tool$featureFlagsPatch);
   tool(tool$featureFlagsDelete);
+  tool(tool$environmentsListByProject);
   tool(tool$aiConfigsGetTargeting);
   tool(tool$aiConfigsUpdateTargeting);
   tool(tool$aiConfigsList);

package/src/mcp-server/tools/codeReferencesListRepositories.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { codeReferencesListRepositories } from "../../funcs/codeReferencesListRepositories.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetRepositoriesRequest$inboundSchema,
+};
+
+export const tool$codeReferencesListRepositories: ToolDefinition<typeof args> =
+  {
+    name: "get-code-references",
+    description:
+      `Identifies which repositories have code references to a given flag, helping agents determine if they're operating on the correct repository and understand the scope of cleanup (single vs multi-repo).
+`,
+    scopes: ["read"],
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await codeReferencesListRepositories(
+        client,
+        args.request,
+        { fetchOptions: { signal: ctx.signal } },
+      ).$inspect();
+
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true,
+        };
+      }
+
+      const value = result.value;
+
+      return formatResult(value, apiCall);
+    },
+  };

package/src/mcp-server/tools/environmentsListByProject.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { environmentsListByProject } from "../../funcs/environmentsListByProject.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetEnvironmentsByProjectRequest$inboundSchema,
+};
+
+export const tool$environmentsListByProject: ToolDefinition<typeof args> = {
+  name: "get-environments",
+  description:
+    `Identifies which environments exist in a project and determines which are marked as "critical" (production, staging, etc.). Allows agents to programmatically identify critical environments instead of hardcoding assumptions.
+`,
+  scopes: ["read"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await environmentsListByProject(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/featureFlagsGetStatus.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { featureFlagsGetStatus } from "../../funcs/featureFlagsGetStatus.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request:
+    operations.GetFeatureFlagStatusAcrossEnvironmentsRequest$inboundSchema,
+};
+
+export const tool$featureFlagsGetStatus: ToolDefinition<typeof args> = {
+  name: "get-flag-status-across-environments",
+  description:
+    `Returns lifecycle status (new, active, inactive, launched) based on actual usage patterns, evaluation counts, and configuration stability. This is the key intelligence for removal readiness assessment.
+`,
+  scopes: ["read"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await featureFlagsGetStatus(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};