@featureflip/mcp 0.1.10 → 0.1.11

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as e, c as t, o as n, r, s as i, t as a } from "./org-C5dAa5In.js";
+import { a as e, c as t, o as n, r, s as i, t as a } from "./org-c4iWMSzU.js";
 export { n as ApiError, i as FeatureflipApi, t as PKG_VERSION, e as createServer, r as loadConfig, a as resolveOrg };

package/dist/{org-C5dAa5In.js → org-c4iWMSzU.js}

@@ -4,7 +4,7 @@ import * as t from "zod/v4";
 //#region src/version.ts
 var n = {
 	name: "@featureflip/mcp",
-	version: "0.1.10",
+	version: "0.1.11",
 	mcpName: "io.github.canopy-labs/featureflip",
 	description: "MCP server for managing Featureflip feature flags from AI agents and editors",
 	keywords: [
@@ -43,17 +43,17 @@ var n = {
 		"smoke:docker": "node scripts/docker-smoke.mjs"
 	},
 	dependencies: {
-		"@modelcontextprotocol/server": "2.1.0",
+		"@modelcontextprotocol/server": "2.3.1",
 		zod: "^4.6.5"
 	},
 	devDependencies: {
-		"@modelcontextprotocol/client": "2.1.0",
+		"@modelcontextprotocol/client": "2.3.1",
 		"@typescript/typescript6": "^6.0.2",
-		"@types/node": "^26.6.2",
+		"@types/node": "^26.6.4",
 		typescript: "^7.0.2",
-		vite: "^8.3.1",
-		"vite-plugin-dts": "^5.1.1",
-		vitest: "^5.0.1"
+		vite: "^8.3.3",
+		"vite-plugin-dts": "^5.1.2",
+		vitest: "^5.0.3"
 	},
 	engines: { node: ">=20.19.0" }
 }.version, r = class extends Error {
@@ -282,6 +282,7 @@ function y(e, n) {
 			})).optional(),
 			expiresAtUtc: t.string().optional().describe("Optional date (YYYY-MM-DD, end of that UTC day) or ISO-8601 timestamp the flag is expected to be removed by (see set_flag_expiry)"),
 			ownerEmail: t.string().optional().describe("Optional owner: the email of an active member (Pro plan and above, see set_flag_owner). Omitted, a personal access token makes its own user the owner and a service token leaves the flag unowned"),
+			isPermanent: t.boolean().optional().describe("Mark the flag permanent: a kill switch, ops toggle or entitlement gate that is meant to stay. Permanent flags are never listed as removal candidates or by find_stale_flags. Cannot be combined with expiresAtUtc"),
 			idempotency_key: t.string().optional().describe("Idempotency-Key header for safe retries")
 		}),
 		annotations: { destructiveHint: !1 }
@@ -314,7 +315,7 @@ function y(e, n) {
 		});
 	})), e.registerTool("set_flag_expiry", {
 		title: "Set or clear flag expiry",
-		description: "Set the date a flag is expected to be removed by, or pass expiresAtUtc: null to clear it. Expiry is advisory: evaluation never changes. Once the date passes, find_stale_flags reports the flag as expired. expiresAtUtc takes a date (2026-12-31), which means the end of that day in UTC, the same as picking it in the dashboard, or a full ISO-8601 timestamp, which is stored exactly. Refused with EXPIRY_IN_PAST for a time that has already passed (today's date is allowed), and with FEATURE_NOT_ENABLED while flag expiration is not enabled for the organization. Clearing is always allowed.",
+		description: "Set the date a flag is expected to be removed by, or pass expiresAtUtc: null to clear it. Expiry is advisory: evaluation never changes. Once the date passes, find_stale_flags reports the flag as expired. expiresAtUtc takes a date (2026-12-31), which means the end of that day in UTC, the same as picking it in the dashboard, or a full ISO-8601 timestamp, which is stored exactly. Refused with EXPIRY_IN_PAST for a time that has already passed (today's date is allowed), with FEATURE_NOT_ENABLED while flag expiration is not enabled for the organization, and with PERMANENT_FLAG_HAS_EXPIRY on a permanent flag (make it temporary first with set_flag_permanent). Clearing is always allowed.",
 		inputSchema: t.object({
 			project: t.string(),
 			flag: t.string().describe("Flag key or id"),
@@ -331,6 +332,25 @@ function y(e, n) {
 			flag: t,
 			expiresAtUtc: a
 		});
+	})), e.registerTool("set_flag_permanent", {
+		title: "Mark a flag permanent or temporary",
+		description: "Mark a flag permanent (a kill switch, ops toggle or entitlement gate that is meant to stay), or pass permanent: false to make it temporary again. Permanent flags are never listed as removal candidates or by find_stale_flags; evaluation never changes. Marking is refused with PERMANENT_FLAG_HAS_EXPIRY while the flag has an expiry date (clear it first with set_flag_expiry and expiresAtUtc: null), with FEATURE_NOT_ENABLED while permanent flags are not enabled for the organization, and on an archived flag. Making a flag temporary is always allowed.",
+		inputSchema: t.object({
+			project: t.string(),
+			flag: t.string().describe("Flag key or id"),
+			permanent: t.boolean().describe("true to mark the flag permanent, false to make it temporary")
+		}),
+		annotations: {
+			destructiveHint: !1,
+			idempotentHint: !0
+		}
+	}, async ({ project: e, flag: t, permanent: a }) => d(async () => {
+		let o = `${r(e)}/${i(t)}/permanent`;
+		return await n.api.request(a ? "PUT" : "DELETE", o), l({
+			project: e,
+			flag: t,
+			permanent: a
+		});
 	})), e.registerTool("set_flag_owner", {
 		title: "Set or clear flag owner",
 		description: "Name the person responsible for a flag, or pass owner: null to leave it unowned. owner is the email of an active member of the organization, or \"me\" for the token's own user (needs a personal access token). The owner gets the flag's cleanup notices; evaluation never changes. Refused with OWNER_NOT_MEMBER for an email that is not an active member, and with PLAN_FEATURE_UNAVAILABLE below the Pro plan. Clearing is always allowed.",
@@ -681,7 +701,7 @@ var A = t.enum(["dead", "stale"]), j = 50;
 function M(e, n) {
 	e.registerTool("find_stale_flags", {
 		title: "Find stale flags",
-		description: `Find flags that look ready for code cleanup: not updated in N days AND either enabled in every environment (verify rollout is complete before removing — per-rule percentage ramps are not inspected) or disabled in every environment (dead — remove flag and code path). A flag whose expiry date (set_flag_expiry) has passed is always a candidate, however recently it was edited; if it is on in some environments and off in others its reason is past-expiry, meaning the owner has to decide which way to fold it. Every result carries expiresAtUtc, expired and owner (null when unowned). Pass owner to see one person's stale flags ("me" for your own) or "none" for the unowned ones. Every result also carries blockedBy: the live flags that still list it as a prerequisite, which have to be removed and archived before it ([] when none). blockedBy is null when the server did not classify the flag as a removal candidate, which means unknown, not unblocked. A flag that other live flags list as a prerequisite has to be removed LAST, dependents first: archiving it while a dependent still names it makes that dependent fail its prerequisite check and serve its off variation, so archive_flag refuses it with FLAG_HAS_DEPENDENTS. Checks at most ${j} candidates per call, expired flags first.`,
+		description: `Find flags that look ready for code cleanup: not updated in N days AND either enabled in every environment (verify rollout is complete before removing — per-rule percentage ramps are not inspected) or disabled in every environment (dead — remove flag and code path). A flag whose expiry date (set_flag_expiry) has passed is always a candidate, however recently it was edited; if it is on in some environments and off in others its reason is past-expiry, meaning the owner has to decide which way to fold it. Every result carries expiresAtUtc, expired and owner (null when unowned). Flags marked permanent (kill switches, ops toggles) are never listed. Pass owner to see one person's stale flags ("me" for your own) or "none" for the unowned ones. Every result also carries blockedBy: the live flags that still list it as a prerequisite, which have to be removed and archived before it ([] when none). blockedBy is null when the server did not classify the flag as a removal candidate, which means unknown, not unblocked. A flag that other live flags list as a prerequisite has to be removed LAST, dependents first: archiving it while a dependent still names it makes that dependent fail its prerequisite check and serve its off variation, so archive_flag refuses it with FLAG_HAS_DEPENDENTS. Checks at most ${j} candidates per call, expired flags first.`,
 		inputSchema: t.object({
 			project: t.string(),
 			days: t.number().int().min(1).optional().default(30).describe("Minimum age in days since last update"),
@@ -695,7 +715,8 @@ function M(e, n) {
 				archived: !1,
 				limit: 100,
 				cursor: p,
-				owner: o
+				owner: o,
+				permanent: !1
 			} });
 			f.push(...(e.items ?? []).filter((e) => !!e.key && !!e.name && !!e.updatedAt && (new Date(e.updatedAt).getTime() < u || d(e)))), p = e.next_cursor ?? void 0;
 		} while (p);

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

@@ -1 +1 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/tools/flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAI9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAkQ3E"}
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/tools/flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAI9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAqS3E"}

package/dist/tools/workflows/stale-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stale-flags.d.ts","sourceRoot":"","sources":["../../../src/tools/workflows/stale-flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAI9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAsBjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAmKhF"}
+{"version":3,"file":"stale-flags.d.ts","sourceRoot":"","sources":["../../../src/tools/workflows/stale-flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAI9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAsBjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAsKhF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featureflip/mcp",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "mcpName": "io.github.canopy-labs/featureflip",
   "description": "MCP server for managing Featureflip feature flags from AI agents and editors",
   "keywords": [
@@ -48,17 +48,17 @@
     "smoke:docker": "node scripts/docker-smoke.mjs"
   },
   "dependencies": {
-    "@modelcontextprotocol/server": "2.1.0",
+    "@modelcontextprotocol/server": "2.3.1",
     "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@modelcontextprotocol/client": "2.1.0",
+    "@modelcontextprotocol/client": "2.3.1",
     "@typescript/typescript6": "^6.0.2",
-    "@types/node": "^26.6.2",
+    "@types/node": "^26.6.4",
     "typescript": "^7.0.2",
-    "vite": "^8.3.1",
-    "vite-plugin-dts": "^5.1.1",
-    "vitest": "^5.0.1"
+    "vite": "^8.3.3",
+    "vite-plugin-dts": "^5.1.2",
+    "vitest": "^5.0.3"
   },
   "engines": {
     "node": ">=20.19.0"