@pennant/mcp 1.0.0

package/dist/sdk-guide.js

@@ -0,0 +1,259 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+const SDKS = ["react", "vue", "js", "node", "python", "go", "rust"];
+const MANIFESTS = [
+    "package.json",
+    "pyproject.toml",
+    "requirements.txt",
+    "go.mod",
+    "Cargo.toml",
+];
+const SERVER_FRAMEWORKS = ["express", "fastify", "koa", "hono", "@nestjs/core", "@hapi/hapi"];
+/** Picks SDKs from manifest file contents, keyed by file name. */
+function detectStack(files) {
+    const found = [];
+    const pkgText = files.get("package.json");
+    if (pkgText) {
+        let deps = {};
+        try {
+            const pkg = JSON.parse(pkgText);
+            deps = { ...pkg.devDependencies, ...pkg.dependencies };
+        }
+        catch {
+            deps = {};
+        }
+        const has = (name) => name in deps;
+        const framework = has("next") ? "next" : has("nuxt") ? "nuxt" : has("vite") ? "vite" : undefined;
+        if (has("react"))
+            found.push({ sdk: "react", reason: "package.json depends on react.", framework });
+        else if (has("vue"))
+            found.push({ sdk: "vue", reason: "package.json depends on vue.", framework });
+        const server = SERVER_FRAMEWORKS.find(has);
+        if (server)
+            found.push({ sdk: "node", reason: `package.json depends on ${server}.` });
+        if (!has("react") && !has("vue") && !server) {
+            found.push(framework === "vite"
+                ? { sdk: "js", reason: "A Vite app without React or Vue.", framework }
+                : { sdk: "node", reason: "A JavaScript project without a browser framework." });
+        }
+    }
+    if (files.has("pyproject.toml") || files.has("requirements.txt")) {
+        found.push({
+            sdk: "python",
+            reason: files.has("pyproject.toml") ? "Found pyproject.toml." : "Found requirements.txt.",
+        });
+    }
+    if (files.has("go.mod"))
+        found.push({ sdk: "go", reason: "Found go.mod." });
+    if (files.has("Cargo.toml"))
+        found.push({ sdk: "rust", reason: "Found Cargo.toml." });
+    return found;
+}
+/** Reads the manifest files in one directory. Missing files are skipped. */
+async function readManifests(dir) {
+    const files = new Map();
+    await Promise.all(MANIFESTS.map(async (name) => {
+        try {
+            files.set(name, await readFile(path.join(dir, name), "utf8"));
+        }
+        catch {
+            /* not present */
+        }
+    }));
+    return files;
+}
+function browserKeyVar(framework) {
+    if (framework === "next")
+        return "NEXT_PUBLIC_PENNANT_CLIENT_KEY";
+    if (framework === "nuxt")
+        return "NUXT_PUBLIC_PENNANT_CLIENT_KEY";
+    return "VITE_PENNANT_CLIENT_KEY";
+}
+function browserEnvRead(framework, name) {
+    return framework === "next" || framework === "nuxt"
+        ? `process.env.${name}`
+        : `import.meta.env.${name}`;
+}
+/** Install line, environment variables, and a first flag check for one SDK. */
+function setupGuide(sdk, options) {
+    const flag = options.flagKey ?? "new-checkout";
+    const keyNote = "Copy the client key from the project's Configure page. It can only read flag results, but keep it in configuration, not source.";
+    const offNote = `Write the code so ${flag} being off is the safe path. Unknown flags read as off.`;
+    switch (sdk) {
+        case "react": {
+            const keyVar = browserKeyVar(options.framework);
+            return {
+                sdk,
+                install: "npm install @pennant/react",
+                env: { [keyVar]: "<project client key>" },
+                code: `import { PennantProvider, useFlag } from "@pennant/react"
+
+export function Root({ user, children }) {
+  return (
+    <PennantProvider
+      apiUrl="${options.apiUrl}"
+      clientKey={${browserEnvRead(options.framework, keyVar)}}
+      environment="production"
+      context={{ userId: user.id }}
+    >
+      {children}
+    </PennantProvider>
+  )
+}
+
+function Checkout() {
+  const enabled = useFlag("${flag}")
+  return enabled ? <NewCheckout /> : <ClassicCheckout />
+}`,
+                notes: [
+                    keyNote,
+                    offNote,
+                    "The provider refreshes every 15 seconds by default. Set pollIntervalMs to change it.",
+                    ...(options.framework === "next"
+                        ? ['In the Next.js App Router, render PennantProvider from a "use client" component.']
+                        : []),
+                ],
+            };
+        }
+        case "vue": {
+            const keyVar = browserKeyVar(options.framework);
+            return {
+                sdk,
+                install: "npm install @pennant/vue",
+                env: { [keyVar]: "<project client key>" },
+                code: `<script setup>
+import { Flag, PennantProvider } from "@pennant/vue"
+const clientKey = ${browserEnvRead(options.framework, keyVar)}
+</script>
+
+<template>
+  <PennantProvider
+    api-url="${options.apiUrl}"
+    :client-key="clientKey"
+    environment="production"
+    :context="{ userId: user.id }"
+  >
+    <Flag name="${flag}">
+      <NewCheckout />
+    </Flag>
+  </PennantProvider>
+</template>`,
+                notes: [
+                    keyNote,
+                    offNote,
+                    "useFlag and useVariant work in any component under PennantProvider.",
+                ],
+            };
+        }
+        case "js":
+            return {
+                sdk,
+                install: "npm install @pennant/js",
+                env: { VITE_PENNANT_CLIENT_KEY: "<project client key>" },
+                code: `import { createPennantClient } from "@pennant/js"
+
+const pennant = createPennantClient({
+  apiUrl: "${options.apiUrl}",
+  clientKey: import.meta.env.VITE_PENNANT_CLIENT_KEY,
+  environment: "production",
+  context: { userId: currentUser.id },
+})
+
+await pennant.evaluate()
+if (pennant.isEnabled("${flag}")) {
+  showNewCheckout()
+}`,
+                notes: [keyNote, offNote, "Call evaluate again after sign-in or when the context changes."],
+            };
+        case "node":
+            return {
+                sdk,
+                install: "npm install @pennant/node",
+                env: { PENNANT_API_URL: options.apiUrl, PENNANT_CLIENT_KEY: "<project client key>" },
+                code: `import { createPennantClient } from "@pennant/node"
+
+const pennant = createPennantClient({
+  apiUrl: process.env.PENNANT_API_URL,
+  clientKey: process.env.PENNANT_CLIENT_KEY,
+  environment: "production",
+})
+
+// Evaluate per request with that request's user.
+const flags = await pennant.evaluate({ userId: req.user.id, remoteAddress: req.ip })
+if (flags["${flag}"]?.enabled) {
+  return newCheckout(req, res)
+}`,
+                notes: [
+                    keyNote,
+                    offNote,
+                    "Server SDKs evaluate when called, so pass the current user's context each time.",
+                ],
+            };
+        case "python":
+            return {
+                sdk,
+                install: 'pip install "pennant-sdk @ git+https://github.com/flypennant/pennant-sdks.git@python/v1.1.0#subdirectory=python"',
+                env: { PENNANT_API_URL: options.apiUrl, PENNANT_CLIENT_KEY: "<project client key>" },
+                code: `import os
+from pennant import PennantClient
+
+pennant = PennantClient(
+    api_url=os.environ["PENNANT_API_URL"],
+    client_key=os.environ["PENNANT_CLIENT_KEY"],
+    environment="production",
+)
+
+flags = pennant.evaluate({"userId": user.id})
+if flags.get("${flag}", {}).get("enabled"):
+    return new_checkout(request)`,
+                notes: [keyNote, offNote, "The package is pennant-sdk; the import name is pennant."],
+            };
+        case "go":
+            return {
+                sdk,
+                install: "go get github.com/flypennant/pennant-sdks/go@latest",
+                env: { PENNANT_API_URL: options.apiUrl, PENNANT_CLIENT_KEY: "<project client key>" },
+                code: `import pennant "github.com/flypennant/pennant-sdks/go"
+
+client := pennant.NewClient(pennant.ClientOptions{
+	APIURL:      os.Getenv("PENNANT_API_URL"),
+	ClientKey:   os.Getenv("PENNANT_CLIENT_KEY"),
+	Environment: "production",
+})
+
+flags, err := client.Evaluate(&pennant.EvaluationContext{UserID: user.ID})
+if err == nil && pennant.IsEnabledIn(flags, "${flag}") {
+	return newCheckout(w, r)
+}`,
+                notes: [
+                    keyNote,
+                    offNote,
+                    "Treat an evaluate error as off, so an outage falls back to the current behaviour.",
+                ],
+            };
+        case "rust":
+            return {
+                sdk,
+                install: "cargo add pennant-sdk --rename pennant --git https://github.com/flypennant/pennant-sdks --tag rust/v1.1.0",
+                env: { PENNANT_API_URL: options.apiUrl, PENNANT_CLIENT_KEY: "<project client key>" },
+                code: `use pennant::{is_enabled, Client, ClientOptions, EvaluationContext};
+
+let mut client = Client::new(ClientOptions {
+    api_url: std::env::var("PENNANT_API_URL")?,
+    client_key: std::env::var("PENNANT_CLIENT_KEY")?,
+    environment: "production".into(),
+    project: None,
+    context: EvaluationContext::default(),
+});
+
+let context = EvaluationContext { user_id: Some(user.id.clone()), ..EvaluationContext::default() };
+let flags = client.evaluate(Some(&context))?;
+if is_enabled(&flags, "${flag}") {
+    return new_checkout(req);
+}`,
+                notes: [keyNote, offNote, "The crate is pennant-sdk; the library name is pennant."],
+            };
+    }
+}
+export { MANIFESTS, SDKS, detectStack, readManifests, setupGuide };
+//# sourceMappingURL=sdk-guide.js.map

package/dist/sdk-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-guide.js","sourceRoot":"","sources":["../src/sdk-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAU,CAAA;AAc5E,MAAM,SAAS,GAAG;IAChB,cAAc;IACd,gBAAgB;IAChB,kBAAkB;IAClB,QAAQ;IACR,YAAY;CACJ,CAAA;AAEV,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,CAAC,CAAA;AAE7F,kEAAkE;AAClE,SAAS,WAAW,CAAC,KAA0B;IAC7C,MAAM,KAAK,GAAgB,EAAE,CAAA;IAE7B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IACzC,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,IAAI,GAA2B,EAAE,CAAA;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAG7B,CAAA;YACD,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,CAAA;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,EAAE,CAAA;QACX,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI,CAAA;QAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;QAChG,IAAI,GAAG,CAAC,OAAO,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,gCAAgC,EAAE,SAAS,EAAE,CAAC,CAAA;aAC9E,IAAI,GAAG,CAAC,KAAK,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,EAAE,SAAS,EAAE,CAAC,CAAA;QAC/E,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC1C,IAAI,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,2BAA2B,MAAM,GAAG,EAAE,CAAC,CAAA;QACrF,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CACR,SAAS,KAAK,MAAM;gBAClB,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,kCAAkC,EAAE,SAAS,EAAE;gBACtE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,mDAAmD,EAAE,CACjF,CAAA;QACH,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,EAAE,QAAQ;YACb,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,yBAAyB;SAC1F,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;IAC3E,IAAI,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAA;IACrF,OAAO,KAAK,CAAA;AACd,CAAC;AAED,4EAA4E;AAC5E,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,MAAM,OAAO,CAAC,GAAG,CACf,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC,CAAC,CACH,CAAA;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,aAAa,CAAC,SAAkC;IACvD,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,gCAAgC,CAAA;IACjE,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,gCAAgC,CAAA;IACjE,OAAO,yBAAyB,CAAA;AAClC,CAAC;AAED,SAAS,cAAc,CAAC,SAAiC,EAAE,IAAY;IACrE,OAAO,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,MAAM;QACjD,CAAC,CAAC,eAAe,IAAI,EAAE;QACvB,CAAC,CAAC,mBAAmB,IAAI,EAAE,CAAA;AAC/B,CAAC;AAED,+EAA+E;AAC/E,SAAS,UAAU,CACjB,GAAU,EACV,OAAiF;IAEjF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAA;IAC9C,MAAM,OAAO,GACX,iIAAiI,CAAA;IACnI,MAAM,OAAO,GAAG,qBAAqB,IAAI,yDAAyD,CAAA;IAElG,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;YAC/C,OAAO;gBACL,GAAG;gBACH,OAAO,EAAE,4BAA4B;gBACrC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,EAAE;gBACzC,IAAI,EAAE;;;;;gBAKE,OAAO,CAAC,MAAM;mBACX,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;;;;;;;;;;6BAU/B,IAAI;;EAE/B;gBACM,KAAK,EAAE;oBACL,OAAO;oBACP,OAAO;oBACP,sFAAsF;oBACtF,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,MAAM;wBAC9B,CAAC,CAAC,CAAC,kFAAkF,CAAC;wBACtF,CAAC,CAAC,EAAE,CAAC;iBACR;aACF,CAAA;QACH,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;YAC/C,OAAO;gBACL,GAAG;gBACH,OAAO,EAAE,0BAA0B;gBACnC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,EAAE;gBACzC,IAAI,EAAE;;oBAEM,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;;;;;eAK9C,OAAO,CAAC,MAAM;;;;;kBAKX,IAAI;;;;YAIV;gBACJ,KAAK,EAAE;oBACL,OAAO;oBACP,OAAO;oBACP,qEAAqE;iBACtE;aACF,CAAA;QACH,CAAC;QACD,KAAK,IAAI;YACP,OAAO;gBACL,GAAG;gBACH,OAAO,EAAE,yBAAyB;gBAClC,GAAG,EAAE,EAAE,uBAAuB,EAAE,sBAAsB,EAAE;gBACxD,IAAI,EAAE;;;aAGD,OAAO,CAAC,MAAM;;;;;;;yBAOF,IAAI;;EAE3B;gBACM,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,gEAAgE,CAAC;aAC5F,CAAA;QACH,KAAK,MAAM;YACT,OAAO;gBACL,GAAG;gBACH,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,sBAAsB,EAAE;gBACpF,IAAI,EAAE;;;;;;;;;;aAUD,IAAI;;EAEf;gBACM,KAAK,EAAE;oBACL,OAAO;oBACP,OAAO;oBACP,iFAAiF;iBAClF;aACF,CAAA;QACH,KAAK,QAAQ;YACX,OAAO;gBACL,GAAG;gBACH,OAAO,EACL,kHAAkH;gBACpH,GAAG,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,sBAAsB,EAAE;gBACpF,IAAI,EAAE;;;;;;;;;;gBAUE,IAAI;iCACa;gBACzB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,yDAAyD,CAAC;aACrF,CAAA;QACH,KAAK,IAAI;YACP,OAAO;gBACL,GAAG;gBACH,OAAO,EAAE,qDAAqD;gBAC9D,GAAG,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,sBAAsB,EAAE;gBACpF,IAAI,EAAE;;;;;;;;;+CASiC,IAAI;;EAEjD;gBACM,KAAK,EAAE;oBACL,OAAO;oBACP,OAAO;oBACP,mFAAmF;iBACpF;aACF,CAAA;QACH,KAAK,MAAM;YACT,OAAO;gBACL,GAAG;gBACH,OAAO,EACL,2GAA2G;gBAC7G,GAAG,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,sBAAsB,EAAE;gBACpF,IAAI,EAAE;;;;;;;;;;;;yBAYW,IAAI;;EAE3B;gBACM,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,wDAAwD,CAAC;aACpF,CAAA;IACL,CAAC;AACH,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,CAAA"}

package/dist/tools.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpConfig } from "./config.ts";
+import { type ConsoleClient } from "./console-client.ts";
+declare function registerTools(server: McpServer, client: ConsoleClient, config: McpConfig): void;
+export { registerTools };

package/dist/tools.js

@@ -0,0 +1,306 @@
+import path from "node:path";
+import { z } from "zod";
+import { ConsoleError } from "./console-client.js";
+import { describeStrategy, explainFlag } from "./explain.js";
+import { SDKS, detectStack, readManifests, setupGuide } from "./sdk-guide.js";
+import { FLAG_TYPES } from "./types.js";
+const projectArg = z
+    .string()
+    .optional()
+    .describe("Project id. Defaults to PENNANT_PROJECT or 'default'.");
+const strategySchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("everyone") }),
+    z.object({ type: z.literal("gradual"), percentage: z.number().int().min(0).max(100) }),
+    z.object({ type: z.literal("allowlist"), userIds: z.array(z.string()) }),
+    z.object({ type: z.literal("remoteAddress"), addresses: z.array(z.string()) }),
+    z.object({ type: z.literal("hostname"), hostnames: z.array(z.string()) }),
+]);
+const constraintSchema = z.object({
+    contextName: z.string().describe("Context field, such as userId or a custom property like plan."),
+    operator: z.enum(["IN", "NOT_IN"]),
+    values: z.array(z.string()),
+});
+const contextSchema = z
+    .object({
+    userId: z.string().optional(),
+    sessionId: z.string().optional(),
+    remoteAddress: z.string().optional(),
+    hostname: z.string().optional(),
+    properties: z.record(z.string(), z.string()).optional(),
+})
+    .describe("Who the flag is evaluated for.");
+function ok(text) {
+    return { content: [{ type: "text", text }] };
+}
+function json(value) {
+    return ok(JSON.stringify(value, null, 2));
+}
+/** Turns console errors into tool errors the assistant can read and act on. */
+async function guarded(run) {
+    try {
+        return await run();
+    }
+    catch (error) {
+        const message = error instanceof ConsoleError
+            ? `Pennant returned ${error.status}: ${error.message}`
+            : error instanceof Error
+                ? error.message
+                : "Unexpected error.";
+        return { content: [{ type: "text", text: message }], isError: true };
+    }
+}
+function flagSummary(flag) {
+    return {
+        key: flag.key,
+        name: flag.name,
+        type: flag.type,
+        archived: flag.archived,
+        parentKey: flag.parentKey ?? null,
+        tags: flag.tags,
+        environments: Object.fromEntries(Object.entries(flag.environments).map(([env, config]) => [
+            env,
+            `${config.enabled ? "on" : "off"}, ${describeStrategy(config.strategy)}`,
+        ])),
+    };
+}
+function registerTools(server, client, config) {
+    const project = (value) => value ?? config.project;
+    /* ---------- read ---------- */
+    server.registerTool("list_projects", {
+        title: "List projects",
+        description: "List the Pennant projects the signed-in user can open.",
+        annotations: { readOnlyHint: true },
+    }, () => guarded(async () => json(await client.listProjects())));
+    server.registerTool("list_environments", {
+        title: "List environments",
+        description: "List a project's environments, such as development and production.",
+        inputSchema: { project: projectArg },
+        annotations: { readOnlyHint: true },
+    }, (args) => guarded(async () => json(await client.listEnvironments(project(args.project)))));
+    server.registerTool("list_flags", {
+        title: "List flags",
+        description: "List flags in a project with their type, tags, parent, and on/off state per environment.",
+        inputSchema: {
+            project: projectArg,
+            includeArchived: z.boolean().optional(),
+            tag: z.string().optional().describe("Only flags with this tag."),
+        },
+        annotations: { readOnlyHint: true },
+    }, (args) => guarded(async () => {
+        const flags = await client.listFlags(project(args.project), args.includeArchived ?? false);
+        const filtered = args.tag ? flags.filter((flag) => flag.tags.includes(args.tag)) : flags;
+        return json(filtered.map(flagSummary));
+    }));
+    server.registerTool("get_flag", {
+        title: "Get flag",
+        description: "Get a flag's full configuration: strategy, constraints, segments, and variants per environment.",
+        inputSchema: { key: z.string(), project: projectArg },
+        annotations: { readOnlyHint: true },
+    }, (args) => guarded(async () => json(await client.getFlag(project(args.project), args.key))));
+    server.registerTool("list_segments", {
+        title: "List segments",
+        description: "List a project's saved audiences and their constraints.",
+        inputSchema: { project: projectArg },
+        annotations: { readOnlyHint: true },
+    }, (args) => guarded(async () => json(await client.listSegments(project(args.project)))));
+    /* ---------- explain ---------- */
+    server.registerTool("explain_flag", {
+        title: "Explain a flag result",
+        description: "Explain why a flag is on or off for a given user in an environment. Walks the same rules the server checks: archive, environment switch, constraints, segments, parent flag, then strategy.",
+        inputSchema: {
+            key: z.string(),
+            environment: z.string(),
+            context: contextSchema,
+            project: projectArg,
+        },
+        annotations: { readOnlyHint: true },
+    }, (args) => guarded(async () => {
+        const id = project(args.project);
+        const [flags, segments, live] = await Promise.all([
+            client.listFlags(id, true),
+            client.listSegments(id),
+            client.evaluate(args.environment, args.context, id),
+        ]);
+        const flag = flags.find((item) => item.key === args.key);
+        if (!flag)
+            return {
+                content: [{ type: "text", text: `No flag ${args.key} in project ${id}.` }],
+                isError: true,
+            };
+        const explanation = explainFlag(flag, args.environment, args.context, {
+            flags: new Map(flags.map((item) => [item.key, item])),
+            segments: new Map(segments.map((item) => [item.id, item])),
+            live: live ?? undefined,
+        });
+        const verdict = explanation.enabled === null
+            ? "Depends on the rollout"
+            : explanation.enabled
+                ? "On"
+                : "Off";
+        const source = live
+            ? "Confirmed against the live evaluate API."
+            : "Worked out from the flag configuration.";
+        return ok([
+            `${verdict}: ${explanation.reason}`,
+            "",
+            ...explanation.steps.map((step, i) => `${i + 1}. ${step}`),
+            "",
+            source,
+        ].join("\n"));
+    }));
+    /* ---------- sdk ---------- */
+    server.registerTool("detect_stack", {
+        title: "Detect the codebase's stack",
+        description: "Read the manifest files (package.json, pyproject.toml, go.mod, Cargo.toml) in a directory and say which Pennant SDK fits.",
+        inputSchema: {
+            path: z
+                .string()
+                .optional()
+                .describe("Directory to inspect. Defaults to the current directory."),
+        },
+        annotations: { readOnlyHint: true },
+    }, (args) => guarded(async () => {
+        const dir = path.resolve(args.path ?? process.cwd());
+        const detections = detectStack(await readManifests(dir));
+        if (detections.length === 0) {
+            return ok(`No package.json, pyproject.toml, requirements.txt, go.mod, or Cargo.toml in ${dir}. Run sdk_setup with the SDK you want.`);
+        }
+        return json({
+            directory: dir,
+            matches: detections,
+            next: "Call sdk_setup with the sdk (and framework) for install steps and code.",
+        });
+    }));
+    server.registerTool("sdk_setup", {
+        title: "SDK setup steps",
+        description: "Install command, environment variables, and a first flag check for one Pennant SDK, pointed at this Pennant console.",
+        inputSchema: {
+            sdk: z.enum(SDKS),
+            framework: z.enum(["next", "vite", "nuxt"]).optional(),
+            flagKey: z
+                .string()
+                .optional()
+                .describe("Flag to use in the example. Defaults to new-checkout."),
+        },
+        annotations: { readOnlyHint: true },
+    }, (args) => guarded(async () => {
+        const guide = setupGuide(args.sdk, {
+            apiUrl: config.url,
+            flagKey: args.flagKey,
+            framework: args.framework,
+        });
+        const env = Object.entries(guide.env).map(([name, value]) => `${name}=${value}`);
+        return ok([
+            `Install:\n${guide.install}`,
+            `Environment:\n${env.join("\n")}`,
+            `Code:\n${guide.code}`,
+            `Notes:\n${guide.notes.map((note) => `- ${note}`).join("\n")}`,
+        ].join("\n\n"));
+    }));
+    if (config.readOnly)
+        return;
+    /* ---------- write ---------- */
+    server.registerTool("create_flag", {
+        title: "Create flag",
+        description: "Create a flag. It starts switched off in every environment.",
+        inputSchema: {
+            key: z.string().describe("Lowercase key used in code, such as new-checkout."),
+            name: z.string(),
+            description: z.string().optional(),
+            type: z.enum(FLAG_TYPES).optional(),
+            strategy: strategySchema.optional().describe("Starting strategy for every environment."),
+            project: projectArg,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false },
+    }, (args) => guarded(async () => {
+        const { project: id, ...input } = args;
+        const flag = await client.createFlag(project(id), input);
+        return ok(`Created ${flag.key}. It is off everywhere until you switch it on.\n\n${JSON.stringify(flagSummary(flag), null, 2)}`);
+    }));
+    server.registerTool("set_flag_enabled", {
+        title: "Switch a flag on or off",
+        description: "Switch a flag on or off in one environment. If the project requires approval for production, this opens a change request instead of applying the change.",
+        inputSchema: {
+            key: z.string(),
+            environment: z.string(),
+            enabled: z.boolean(),
+            project: projectArg,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
+    }, (args) => guarded(async () => {
+        const result = await client.setEnabled(project(args.project), args.key, args.environment, args.enabled);
+        if (result.mode === "change-request") {
+            return ok(`Production changes need approval in this project, so a change request was opened (${result.changeRequest.id}). An admin must approve it in the console.`);
+        }
+        return ok(`${args.key} is now ${args.enabled ? "on" : "off"} in ${args.environment}.`);
+    }));
+    server.registerTool("update_targeting", {
+        title: "Update targeting",
+        description: "Change who gets a flag in one environment: strategy, constraints, variants, or segments. Production changes become a change request when the project requires approval.",
+        inputSchema: {
+            key: z.string(),
+            environment: z.string(),
+            strategy: strategySchema.optional(),
+            constraints: z.array(constraintSchema).optional(),
+            variants: z
+                .array(z.object({ name: z.string(), weight: z.number().int().min(0) }))
+                .optional(),
+            segmentIds: z.array(z.string()).optional(),
+            project: projectArg,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    }, (args) => guarded(async () => {
+        const id = project(args.project);
+        const change = {};
+        if (args.strategy)
+            change.strategy = args.strategy;
+        if (args.constraints)
+            change.constraints = args.constraints;
+        if (args.variants)
+            change.variants = args.variants;
+        if (args.segmentIds)
+            change.segmentIds = args.segmentIds;
+        if (Object.keys(change).length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Pass at least one of strategy, constraints, variants, or segmentIds.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (args.environment === "production" && (await client.approvalRequired(id))) {
+            const current = (await client.getFlag(id, args.key)).environments.production;
+            if (!current)
+                return {
+                    content: [{ type: "text", text: `${args.key} has no production settings.` }],
+                    isError: true,
+                };
+            const { changeRequest } = await client.proposeProductionChange(id, args.key, {
+                ...current,
+                ...change,
+            });
+            return ok(`Production changes need approval in this project, so a change request was opened (${changeRequest.id}). An admin must approve it in the console.`);
+        }
+        const flag = await client.updateFlag(id, args.key, {
+            environments: { [args.environment]: change },
+        });
+        const config = flag.environments[args.environment];
+        return ok(`Updated ${args.key} in ${args.environment}: ${config ? describeStrategy(config.strategy) : "saved"}.`);
+    }));
+    server.registerTool("archive_flag", {
+        title: "Archive or restore a flag",
+        description: "Archive a flag so it stops being sent to apps, or restore it. Archived flags can always be restored.",
+        inputSchema: { key: z.string(), archived: z.boolean().default(true), project: projectArg },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
+    }, (args) => guarded(async () => {
+        await client.updateFlag(project(args.project), args.key, { archived: args.archived });
+        return ok(args.archived
+            ? `Archived ${args.key}. Apps no longer receive it.`
+            : `Restored ${args.key}.`);
+    }));
+}
+export { registerTools };
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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