@omnicoreos/planka-mcp 0.2.0 → 0.3.0

package/dist/client.js

@@ -5,10 +5,15 @@ import { PlankaAuthError, PlankaConfigError, PlankaNetworkError, createPlankaErr
 import { AuthResponse } from "./schemas/responses.js";
 export function createRequestInit(method, options = {}) {
     const headers = {};
-    if (options.token)
+    if (options.apiKey) {
+        // Never together with Authorization: Planka would ignore the key.
+        headers["X-Api-Key"] = options.apiKey;
+    }
+    else if (options.token) {
         headers.Authorization = `Bearer ${options.token}`;
-    if (options.token && options.cookieToken) {
-        headers.Cookie = `accessToken=${options.token}`;
+        if (options.cookieToken) {
+            headers.Cookie = `accessToken=${options.token}`;
+        }
     }
     if (options.form === undefined && options.body !== undefined) {
         headers["Content-Type"] = "application/json";
@@ -26,17 +31,30 @@ export function createRequestInit(method, options = {}) {
  */
 export function getConfig(env = process.env) {
     const baseUrl = env.PLANKA_BASE_URL;
-    const email = env.PLANKA_AGENT_EMAIL;
+    const apiKey = env.PLANKA_API_KEY?.trim() || undefined;
+    const email = env.PLANKA_AGENT_EMAIL?.trim() || undefined;
     const password = env.PLANKA_AGENT_PASSWORD;
-    const missing = [];
-    if (!baseUrl)
-        missing.push("PLANKA_BASE_URL");
-    if (!email)
-        missing.push("PLANKA_AGENT_EMAIL");
-    if (!password)
-        missing.push("PLANKA_AGENT_PASSWORD");
-    if (missing.length > 0) {
-        throw new PlankaConfigError(`Missing required environment variables: ${missing.join(", ")}`);
+    if (!baseUrl) {
+        throw new PlankaConfigError("Missing required environment variables: PLANKA_BASE_URL");
+    }
+    // API key XOR password login. Sending both is a configuration mistake worth
+    // naming: Planka would silently use only one of them.
+    if (apiKey && (email || password)) {
+        throw new PlankaConfigError("Conflicting Planka credentials: PLANKA_API_KEY is set together with " +
+            "PLANKA_AGENT_EMAIL, PLANKA_AGENT_PASSWORD. Choose one: keep PLANKA_API_KEY " +
+            "(recommended) and unset the email/password pair, or unset PLANKA_API_KEY.");
+    }
+    if (!apiKey) {
+        const missing = [];
+        if (!email)
+            missing.push("PLANKA_AGENT_EMAIL");
+        if (!password)
+            missing.push("PLANKA_AGENT_PASSWORD");
+        if (missing.length > 0) {
+            throw new PlankaConfigError(`Missing Planka credentials (${missing.join(", ")}). Authenticate with EITHER ` +
+                "PLANKA_API_KEY (recommended: no login, no token refresh, no sign-in rate limit) " +
+                "OR the pair PLANKA_AGENT_EMAIL, PLANKA_AGENT_PASSWORD.");
+        }
     }
     // Validate URL format
     try {
@@ -45,11 +63,9 @@ export function getConfig(env = process.env) {
     catch {
         throw new PlankaConfigError(`Invalid PLANKA_BASE_URL: ${baseUrl}`);
     }
-    // TypeScript narrowing: after the check above, these are guaranteed to be defined
     return {
         baseUrl: baseUrl.replace(/\/+$/, ""), // Remove trailing slashes
-        email: email,
-        password: password,
+        ...(apiKey ? { apiKey } : { email: email, password: password }),
     };
 }
 /**
@@ -111,9 +127,11 @@ export class PlankaClient {
         }
         const data = await this.safeParseJson(response);
         if (data === null) {
-            const redirectHint = config.baseUrl.startsWith("http://") || response.redirected
-                ? " Your HTTP URL probably redirects to HTTPS; a 301/302 can drop the POST body. Configure the final https:// URL directly."
-                : " Check that PLANKA_BASE_URL points to the Planka API origin, not a proxy error page.";
+            const redirectHint = response.redirected
+                ? " The request was redirected: a 301/302 can drop the POST body. Configure the final URL directly."
+                : config.baseUrl.startsWith("http://")
+                    ? " PLANKA_BASE_URL is http://: if the server redirects to HTTPS the POST body is dropped. Configure the final https:// URL directly."
+                    : " Check that PLANKA_BASE_URL points to the Planka API origin, not a proxy error page.";
             throw new PlankaAuthError(`Authentication returned HTML or another non-JSON response.${redirectHint}`);
         }
         const parsed = AuthResponse.safeParse(data);
@@ -136,6 +154,46 @@ export class PlankaClient {
         }
         return this.token;
     }
+    /**
+     * The auth material for one request: an API key when configured (no login,
+     * no refresh), a bearer token otherwise. Never both — Planka ignores
+     * `x-api-key` whenever `Authorization` is present.
+     */
+    async authOptions() {
+        const config = this.getConfig();
+        if (config.apiKey)
+            return { apiKey: config.apiKey };
+        return { token: await this.getToken() };
+    }
+    /**
+     * A 200 carrying the SPA's HTML instead of JSON — Planka answers every
+     * unknown GET that way, and an http:// base URL redirected to https:// ends
+     * up here too. Indistinguishable from success if only the status is read.
+     */
+    assertNotHtml(response, data, what, method) {
+        if (data !== null)
+            return;
+        const contentType = response.headers.get("content-type") ?? "";
+        if (!contentType.includes("text/html"))
+            return;
+        const config = this.getConfig();
+        // The HTTP→HTTPS redirect is the most common cause, not the only one: an
+        // https:// base URL that was never redirected cannot be it, and neither can
+        // a plain http:// origin that answered directly.
+        const redirectHint = response.redirected
+            ? " The request was redirected: configure the final URL directly, a 301/302 can drop the body."
+            : config.baseUrl.startsWith("http://")
+                ? " PLANKA_BASE_URL is http://: if the server redirects to HTTPS, configure the final https:// URL directly. Otherwise check that it points at the Planka API origin, not a proxy error page."
+                : " Check that PLANKA_BASE_URL points to the Planka API origin, not a proxy error page.";
+        // A non-GET reaching here went somewhere: the SPA catch-all is GET-only, so
+        // HTML on a write means a redirect or a proxy, and the write may have run.
+        const writeHint = method === "GET"
+            ? ""
+            : " This was a WRITE: it MAY have landed even though the answer is unusable — re-read the entity before retrying.";
+        throw new PlankaNetworkError(`${what} returned HTML instead of JSON: this route does not exist in Planka 2.x — ` +
+            "every unknown GET under /api falls through to the single-page app, which answers 200 with HTML." +
+            `${redirectHint}${writeHint}`);
+    }
     /**
      * Safely parses JSON from a response, returning null on failure.
      */
@@ -153,21 +211,22 @@ export class PlankaClient {
      */
     async request(method, path, body, isRetry = false) {
         const config = this.getConfig();
-        const token = await this.getToken();
+        const auth = await this.authOptions();
         const url = `${config.baseUrl}${path}`;
         let response;
         try {
             response = await this.fetchImpl(url, createRequestInit(method, {
-                token,
+                ...auth,
                 body,
                 signal: this.createTimeoutSignal(),
             }));
         }
         catch (error) {
             if (error instanceof Error && error.name === "AbortError") {
-                throw new PlankaNetworkError(`Request timeout: ${method} ${path}`, error);
+                throw new PlankaNetworkError(`Request timeout: ${method} ${path} (Planka at ${config.baseUrl})`, error);
             }
-            throw new PlankaNetworkError(`Network error: ${method} ${path}`, error);
+            throw new PlankaNetworkError(`Network error: ${method} ${path} — could not reach Planka at ${config.baseUrl}. ` +
+                "Check PLANKA_BASE_URL, DNS and that the instance is up.", error);
         }
         // Handle 204 No Content
         if (response.status === 204) {
@@ -183,6 +242,7 @@ export class PlankaClient {
             }
             throw createPlankaError(response.status, data, `${method} ${path}`);
         }
+        this.assertNotHtml(response, data, `${method} ${path}`, method);
         return data;
     }
     /**
@@ -191,21 +251,22 @@ export class PlankaClient {
      */
     async postMultipart(path, form, isRetry = false) {
         const config = this.getConfig();
-        const token = await this.getToken();
+        const auth = await this.authOptions();
         const url = `${config.baseUrl}${path}`;
         let response;
         try {
             response = await this.fetchImpl(url, createRequestInit("POST", {
-                token,
+                ...auth,
                 form,
                 signal: this.createTimeoutSignal(),
             }));
         }
         catch (error) {
             if (error instanceof Error && error.name === "AbortError") {
-                throw new PlankaNetworkError(`Request timeout: POST ${path}`, error);
+                throw new PlankaNetworkError(`Request timeout: POST ${path} (Planka at ${config.baseUrl})`, error);
             }
-            throw new PlankaNetworkError(`Network error: POST ${path}`, error);
+            throw new PlankaNetworkError(`Network error: POST ${path} — could not reach Planka at ${config.baseUrl}. ` +
+                "The upload MAY have started; re-read the card's attachments before retrying.", error);
         }
         const data = await this.safeParseJson(response);
         if (!response.ok) {
@@ -222,27 +283,35 @@ export class PlankaClient {
      * Authenticated binary download (attachment contents).
      * Accepts an absolute URL on the same host, or a relative path.
      */
-    async getBinary(urlOrPath) {
+    async getBinary(urlOrPath, isRetry = false) {
         const config = this.getConfig();
-        const token = await this.getToken();
+        const auth = await this.authOptions();
         const url = urlOrPath.startsWith("http")
             ? urlOrPath
             : `${config.baseUrl}${urlOrPath}`;
         let response;
         try {
             response = await this.fetchImpl(url, createRequestInit("GET", {
-                token,
+                ...auth,
+                // Planka serves downloads with the cookie or the API key, and some
+                // deployments disagree on which one they honour.
                 cookieToken: true,
                 signal: this.createTimeoutSignal(),
             }));
         }
         catch (error) {
             if (error instanceof Error && error.name === "AbortError") {
-                throw new PlankaNetworkError(`Request timeout: GET ${url}`, error);
+                throw new PlankaNetworkError(`Request timeout: GET ${url} (Planka at ${config.baseUrl})`, error);
             }
-            throw new PlankaNetworkError(`Network error: GET ${url}`, error);
+            throw new PlankaNetworkError(`Network error: GET ${url} — could not reach Planka at ${config.baseUrl}.`, error);
         }
         if (!response.ok) {
+            // Same expired-token retry the JSON path has always had.
+            if (response.status === 401 && this.token && !isRetry) {
+                this.token = null;
+                this.tokenExpiresAt = 0;
+                return this.getBinary(urlOrPath, true);
+            }
             throw createPlankaError(response.status, null, `GET ${url}`);
         }
         const buffer = await response.arrayBuffer();
@@ -271,6 +340,11 @@ export class PlankaClient {
     }
     /**
      * DELETE request.
+     *
+     * Returns the response body: Planka 2.x answers a delete with `{item}` of
+     * what it removed, and that item carries the parent id (cardId, boardId…)
+     * the caller needs to re-read the parent and prove the delete landed.
+     * Discarding it made every delete a blind `success: true`.
      */
     async delete(path) {
         return this.request("DELETE", path);

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAoCtD,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,UAA0B,EAAE;IAE5B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,kEAAkE;QAClE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACxC,CAAC;SAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,aAAa,GAAG,UAAU,OAAO,CAAC,KAAK,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,GAAG,eAAe,OAAO,CAAC,KAAK,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO;QACP,IAAI,EACF,OAAO,CAAC,IAAI;YACZ,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACvD,MAAM,KAAK,GAAG,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IAC1D,MAAM,QAAQ,GAAG,GAAG,CAAC,qBAAqB,CAAC;IAE3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,iBAAiB,CACzB,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,sDAAsD;IACtD,IAAI,MAAM,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,iBAAiB,CACzB,sEAAsE;YACpE,6EAA6E;YAC7E,2EAA2E,CAC9E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,iBAAiB,CACzB,+BAA+B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,8BAA8B;gBAC7E,kFAAkF;gBAClF,wDAAwD,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,iBAAiB,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,0BAA0B;QAChE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAM,EAAE,QAAQ,EAAE,QAAS,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAMJ;IACA;IANX,MAAM,GAAwB,IAAI,CAAC;IACnC,KAAK,GAAkB,IAAI,CAAC;IAC5B,cAAc,GAAW,CAAC,CAAC;IAEnC,YACmB,MAAyB,OAAO,CAAC,GAAG,EACpC,YAA0B,KAAK;QAD/B,QAAG,GAAH,GAAG,CAAiC;QACpC,cAAS,GAAT,SAAS,CAAsB;IAC/C,CAAC;IAEJ;;OAEG;IACK,SAAS;QACf,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,sCAAsC;IAC9B,MAAM,CAAU,kBAAkB,GAAG,KAAK,CAAC;IAEnD;;;OAGG;IACK,mBAAmB;QACzB,OAAO,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,oBAAoB,CAAC;QAElD,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAC7B,GAAG,EACH,iBAAiB,CAAC,MAAM,EAAE;gBACxB,IAAI,EAAE;oBACJ,eAAe,EAAE,MAAM,CAAC,KAAM;oBAC9B,QAAQ,EAAE,MAAM,CAAC,QAAS;iBAC3B;gBACD,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE;aACnC,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,kBAAkB,CAC1B,2CAA2C,MAAM,CAAC,OAAO,EAAE,EAC3D,KAAK,CACN,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,kCAAkC,MAAM,CAAC,OAAO,EAAE,EAClD,KAAK,CACN,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,IAAI,eAAe,CACvB,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACnE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU;gBACtC,CAAC,CAAC,kGAAkG;gBACpG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;oBACpC,CAAC,CAAC,oIAAoI;oBACtI,CAAC,CAAC,sFAAsF,CAAC;YAC7F,MAAM,IAAI,eAAe,CACvB,6DAA6D,YAAY,EAAE,CAC5E,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CACvB,uEAAuE,CACxE,CAAC;QACJ,CAAC;QAED,qDAAqD;QACrD,mDAAmD;QACnD,yDAAyD;QACzD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAE9B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,QAAQ;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,WAAW;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACpD,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACK,aAAa,CACnB,QAAkB,EAClB,IAAa,EACb,IAAY,EACZ,MAAc;QAEd,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO;QAC1B,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/D,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,yEAAyE;QACzE,4EAA4E;QAC5E,iDAAiD;QACjD,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU;YACtC,CAAC,CAAC,6FAA6F;YAC/F,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;gBACpC,CAAC,CAAC,4LAA4L;gBAC9L,CAAC,CAAC,sFAAsF,CAAC;QAC7F,4EAA4E;QAC5E,2EAA2E;QAC3E,MAAM,SAAS,GACb,MAAM,KAAK,KAAK;YACd,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,gHAAgH,CAAC;QACvH,MAAM,IAAI,kBAAkB,CAC1B,GAAG,IAAI,4EAA4E;YACjF,iGAAiG;YACjG,GAAG,YAAY,GAAG,SAAS,EAAE,CAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,QAAkB;QAC5C,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,IAAc,EACd,OAAO,GAAG,KAAK;QAEf,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QAEvC,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAC7B,GAAG,EACH,iBAAiB,CAAC,MAAM,EAAE;gBACxB,GAAG,IAAI;gBACP,IAAI;gBACJ,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE;aACnC,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,kBAAkB,CAC1B,oBAAoB,MAAM,IAAI,IAAI,eAAe,MAAM,CAAC,OAAO,GAAG,EAClE,KAAK,CACN,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,MAAM,IAAI,IAAI,gCAAgC,MAAM,CAAC,OAAO,IAAI;gBAChF,yDAAyD,EAC3D,KAAK,CACN,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,SAAc,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,mFAAmF;YACnF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;gBAClB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC;YACD,MAAM,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAEhE,OAAO,IAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CACjB,IAAY,EACZ,IAAc,EACd,OAAO,GAAG,KAAK;QAEf,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QAEvC,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAC7B,GAAG,EACH,iBAAiB,CAAC,MAAM,EAAE;gBACxB,GAAG,IAAI;gBACP,IAAI;gBACJ,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE;aACnC,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,kBAAkB,CAC1B,yBAAyB,IAAI,eAAe,MAAM,CAAC,OAAO,GAAG,EAC7D,KAAK,CACN,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,uBAAuB,IAAI,gCAAgC,MAAM,CAAC,OAAO,IAAI;gBAC3E,8EAA8E,EAChF,KAAK,CACN,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;gBAClB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CACb,SAAiB,EACjB,OAAO,GAAG,KAAK;QAEf,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,GAAG,SAAS,EAAE,CAAC;QAEpC,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAC7B,GAAG,EACH,iBAAiB,CAAC,KAAK,EAAE;gBACvB,GAAG,IAAI;gBACP,mEAAmE;gBACnE,iDAAiD;gBACjD,WAAW,EAAE,IAAI;gBACjB,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE;aACnC,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,kBAAkB,CAC1B,wBAAwB,GAAG,eAAe,MAAM,CAAC,OAAO,GAAG,EAC3D,KAAK,CACN,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,GAAG,gCAAgC,MAAM,CAAC,OAAO,GAAG,EAC1E,KAAK,CACN,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,yDAAyD;YACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;gBAClB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO;YACL,KAAK,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC;YAC7B,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;SAC/C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAI,IAAY;QACvB,OAAO,IAAI,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAa;QACvC,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAI,IAAY,EAAE,IAAa;QACxC,OAAO,IAAI,CAAC,OAAO,CAAI,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAc,IAAY;QACpC,OAAO,IAAI,CAAC,OAAO,CAAI,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;;AAGH,4BAA4B;AAC5B,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/config/policy.d.ts

@@ -0,0 +1,82 @@
+export interface AccessPolicy {
+    /** Board used when a tool call omits `boardId`. `null` = no default. */
+    defaultBoardId: string | null;
+    /** Allowlist of board ids. `null` = no allowlist (everything visible). */
+    allowedBoardIds: string[] | null;
+    /** Allowlist of project ids. `null` = no allowlist. */
+    allowedProjectIds: string[] | null;
+    /** Hide (and refuse) every write tool. */
+    readOnly: boolean;
+    /** Tool names switched off by configuration. */
+    disabledTools: string[];
+    /** Drop deprecated tools (old names kept as aliases) from `tools/list`. */
+    hideDeprecated: boolean;
+    /**
+     * Lists that must not receive cards, be edited or deleted — and whose cards
+     * may not be moved, archived or deleted out of them either.
+     */
+    protectedListIds: string[];
+    /**
+     * Label that `planka_board_summary` flags as "unblocked". `null` = none: the
+     * server ships no board-specific vocabulary of its own.
+     */
+    summaryHighlightLabel: string | null;
+    /**
+     * Columns `planka_board_summary` returns cards from when the call does not
+     * say. `null` = none: the summary answers columns and labels only.
+     */
+    summaryDecisionLists: string[] | null;
+}
+/**
+ * The tools that write to Planka, by name and on purpose.
+ *
+ * A heuristic over the name ("does it start with get_?") would silently
+ * misclassify the next tool someone adds. This set is the contract:
+ * `tests/unit/policy.test.ts` asserts, tool by tool, that membership here
+ * matches the `readOnlyHint` each tool advertises in `toolPresentation` — so a
+ * write tool that nobody listed here fails the suite instead of staying
+ * visible under `PLANKA_READ_ONLY=true`.
+ */
+export declare const WRITE_TOOL_NAMES: ReadonlySet<string>;
+/** Tool names are always prefixed; accept the bare name as a convenience. */
+export declare function normalizeToolName(name: string): string;
+/**
+ * Builds the policy from an environment. Pure: no caching, no process.env.
+ */
+export declare function parsePolicy(env: NodeJS.ProcessEnv): AccessPolicy;
+/**
+ * The active policy. Memoized per environment object so a tool call does not
+ * re-parse on every request, and so tests can hand in their own env.
+ */
+export declare function getPolicy(env?: NodeJS.ProcessEnv): AccessPolicy;
+/** Drops the memoized policy. For tests, and for anything that mutates env. */
+export declare function resetPolicyCache(): void;
+/**
+ * Rejects a board that is outside the allowlist, before any request goes out.
+ */
+export declare function assertBoardAllowed(boardId: string, policy?: AccessPolicy): string;
+/** Same check for projects. */
+export declare function assertProjectAllowed(projectId: string, policy?: AccessPolicy): string;
+/** True when the id survives the board allowlist. */
+export declare function isBoardAllowed(boardId: string, policy?: AccessPolicy): boolean;
+/** True when the id survives the project allowlist. */
+export declare function isProjectAllowed(projectId: string, policy?: AccessPolicy): boolean;
+/**
+ * Fills in `PLANKA_DEFAULT_BOARD_ID` for a missing `boardId` and checks the
+ * result against the allowlist. Throws when there is neither an argument nor
+ * a default.
+ */
+export declare function resolveBoardId(boardId: string | undefined | null, policy?: AccessPolicy): string;
+/** Whether a tool is exposed at all under the current policy. */
+export declare function isToolVisible(name: string, policy?: AccessPolicy): boolean;
+/**
+ * Why a tool is not available — the text the model gets back when it calls one
+ * anyway. Returns null when the tool is available.
+ */
+export declare function toolBlockedReason(name: string, policy?: AccessPolicy): string | null;
+/**
+ * Guard-rail (not security — Planka has no per-list permissions) that keeps
+ * cards out of protected columns and protected columns intact.
+ */
+export declare function assertListWritable(listId: string | undefined | null, policy?: AccessPolicy, action?: string): void;
+//# sourceMappingURL=policy.d.ts.map

package/dist/config/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/config/policy.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0EAA0E;IAC1E,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B;;;OAGG;IACH,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,oBAAoB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CA4B/C,CAAC;AAEH,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AA8CD;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,YAAY,CAyDhE;AAKD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAM5E;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,YAA0B,GACjC,MAAM,CAQR;AAED,+BAA+B;AAC/B,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,YAA0B,GACjC,MAAM,CAQR;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,YAA0B,GACjC,OAAO,CAET;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,YAA0B,GACjC,OAAO,CAKT;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAClC,MAAM,GAAE,YAA0B,GACjC,MAAM,CAcR;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,YAA0B,GACjC,OAAO,CAIT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,YAA0B,GACjC,MAAM,GAAG,IAAI,CAcf;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACjC,MAAM,GAAE,YAA0B,EAClC,MAAM,SAAa,GAClB,IAAI,CASN"}

package/dist/config/policy.js

@@ -0,0 +1,226 @@
+/**
+ * Access policy: what this MCP server is allowed to see and touch.
+ *
+ * Layer 2 of the three-layer defence documented in the README. Layer 1 is
+ * Planka itself (a `boardUser` with board memberships — the only layer an
+ * agent cannot talk its way around); layer 3 is the client's own allow/deny
+ * list. This module is the middle one: it travels with the package, so it
+ * reaches every runtime (Claude Code, Codex, Cursor…) with the same rules.
+ *
+ * Everything here is driven by environment variables and every helper is
+ * pure, so the whole surface is testable without a Planka.
+ */
+import { PlankaConfigError, PlankaError } from "../errors.js";
+/**
+ * The tools that write to Planka, by name and on purpose.
+ *
+ * A heuristic over the name ("does it start with get_?") would silently
+ * misclassify the next tool someone adds. This set is the contract:
+ * `tests/unit/policy.test.ts` asserts, tool by tool, that membership here
+ * matches the `readOnlyHint` each tool advertises in `toolPresentation` — so a
+ * write tool that nobody listed here fails the suite instead of staying
+ * visible under `PLANKA_READ_ONLY=true`.
+ */
+export const WRITE_TOOL_NAMES = new Set([
+    "planka_create_card",
+    "planka_update_card",
+    "planka_move_card",
+    "planka_delete_card",
+    "planka_create_tasks",
+    "planka_update_task",
+    "planka_delete_task",
+    "planka_create_label",
+    "planka_update_label",
+    "planka_delete_label",
+    "planka_manage_labels",
+    "planka_set_card_labels",
+    "planka_create_comment",
+    "planka_update_comment",
+    "planka_delete_comment",
+    "planka_add_comment",
+    "planka_manage_comment",
+    "planka_create_list",
+    "planka_update_list",
+    "planka_delete_list",
+    "planka_manage_lists",
+    "planka_add_attachment",
+    "planka_delete_attachment",
+    "planka_set_card_members",
+    "planka_duplicate_card",
+    "planka_archive_card",
+    "planka_move_list_cards",
+]);
+/** Tool names are always prefixed; accept the bare name as a convenience. */
+export function normalizeToolName(name) {
+    const trimmed = name.trim();
+    return trimmed.startsWith("planka_") ? trimmed : `planka_${trimmed}`;
+}
+/** Splits a CSV env var into trimmed, non-empty entries. */
+function parseCsv(raw) {
+    if (raw === undefined)
+        return null;
+    const entries = raw
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+    return entries;
+}
+/** A trimmed string env var, or null when unset/blank. */
+function parseOptionalString(raw) {
+    const value = raw?.trim();
+    return value ? value : null;
+}
+/** A CSV env var that, when present, must list at least one entry. */
+function parseNonEmptyCsv(name, raw) {
+    const entries = parseCsv(raw);
+    if (entries === null)
+        return null;
+    if (entries.length === 0) {
+        throw new PlankaConfigError(`${name} is set but lists no value. Remove it, or list the entries (comma-separated).`);
+    }
+    return entries;
+}
+const TRUTHY = new Set(["true", "1"]);
+const FALSY = new Set(["false", "0", ""]);
+function parseBoolean(name, raw) {
+    if (raw === undefined)
+        return false;
+    const value = raw.trim().toLowerCase();
+    if (TRUTHY.has(value))
+        return true;
+    if (FALSY.has(value))
+        return false;
+    throw new PlankaConfigError(`Invalid ${name}: "${raw}". Use "true" or "1" to enable it, "false" or "0" to disable it.`);
+}
+/**
+ * Builds the policy from an environment. Pure: no caching, no process.env.
+ */
+export function parsePolicy(env) {
+    const defaultBoardIdRaw = env.PLANKA_DEFAULT_BOARD_ID?.trim();
+    if (defaultBoardIdRaw !== undefined && defaultBoardIdRaw.length === 0) {
+        throw new PlankaConfigError("PLANKA_DEFAULT_BOARD_ID is set but empty. Remove it, or give it a board id.");
+    }
+    const allowedBoardIds = parseCsv(env.PLANKA_ALLOWED_BOARD_IDS);
+    const allowedProjectIds = parseCsv(env.PLANKA_ALLOWED_PROJECT_IDS);
+    if (allowedBoardIds !== null && allowedBoardIds.length === 0) {
+        throw new PlankaConfigError("PLANKA_ALLOWED_BOARD_IDS is set but lists no id. That would hide every board. " +
+            "Remove the variable, or list the board ids (comma-separated).");
+    }
+    if (allowedProjectIds !== null && allowedProjectIds.length === 0) {
+        throw new PlankaConfigError("PLANKA_ALLOWED_PROJECT_IDS is set but lists no id. That would hide every project. " +
+            "Remove the variable, or list the project ids (comma-separated).");
+    }
+    const defaultBoardId = defaultBoardIdRaw ?? null;
+    if (defaultBoardId !== null &&
+        allowedBoardIds !== null &&
+        !allowedBoardIds.includes(defaultBoardId)) {
+        throw new PlankaConfigError(`PLANKA_DEFAULT_BOARD_ID (${defaultBoardId}) is not listed in PLANKA_ALLOWED_BOARD_IDS ` +
+            `(${allowedBoardIds.join(", ")}). Add it to the allowlist, or point the default at an allowed board.`);
+    }
+    return {
+        defaultBoardId,
+        allowedBoardIds,
+        allowedProjectIds,
+        readOnly: parseBoolean("PLANKA_READ_ONLY", env.PLANKA_READ_ONLY),
+        disabledTools: (parseCsv(env.PLANKA_DISABLED_TOOLS) ?? []).map(normalizeToolName),
+        hideDeprecated: parseBoolean("PLANKA_HIDE_DEPRECATED", env.PLANKA_HIDE_DEPRECATED),
+        protectedListIds: parseCsv(env.PLANKA_PROTECTED_LIST_IDS) ?? [],
+        summaryHighlightLabel: parseOptionalString(env.PLANKA_SUMMARY_HIGHLIGHT_LABEL),
+        summaryDecisionLists: parseNonEmptyCsv("PLANKA_SUMMARY_DECISION_LISTS", env.PLANKA_SUMMARY_DECISION_LISTS),
+    };
+}
+let cachedPolicy = null;
+let cachedEnv = null;
+/**
+ * The active policy. Memoized per environment object so a tool call does not
+ * re-parse on every request, and so tests can hand in their own env.
+ */
+export function getPolicy(env = process.env) {
+    if (cachedPolicy && cachedEnv === env)
+        return cachedPolicy;
+    const policy = parsePolicy(env);
+    cachedPolicy = policy;
+    cachedEnv = env;
+    return policy;
+}
+/** Drops the memoized policy. For tests, and for anything that mutates env. */
+export function resetPolicyCache() {
+    cachedPolicy = null;
+    cachedEnv = null;
+}
+/**
+ * Rejects a board that is outside the allowlist, before any request goes out.
+ */
+export function assertBoardAllowed(boardId, policy = getPolicy()) {
+    const allowed = policy.allowedBoardIds;
+    if (allowed === null || allowed.includes(boardId))
+        return boardId;
+    throw new PlankaError(`boardId ${boardId} is not in PLANKA_ALLOWED_BOARD_IDS (allowed: ${allowed.join(", ")})`, "BOARD_NOT_ALLOWED", 403);
+}
+/** Same check for projects. */
+export function assertProjectAllowed(projectId, policy = getPolicy()) {
+    const allowed = policy.allowedProjectIds;
+    if (allowed === null || allowed.includes(projectId))
+        return projectId;
+    throw new PlankaError(`projectId ${projectId} is not in PLANKA_ALLOWED_PROJECT_IDS (allowed: ${allowed.join(", ")})`, "PROJECT_NOT_ALLOWED", 403);
+}
+/** True when the id survives the board allowlist. */
+export function isBoardAllowed(boardId, policy = getPolicy()) {
+    return policy.allowedBoardIds === null || policy.allowedBoardIds.includes(boardId);
+}
+/** True when the id survives the project allowlist. */
+export function isProjectAllowed(projectId, policy = getPolicy()) {
+    return (policy.allowedProjectIds === null ||
+        policy.allowedProjectIds.includes(projectId));
+}
+/**
+ * Fills in `PLANKA_DEFAULT_BOARD_ID` for a missing `boardId` and checks the
+ * result against the allowlist. Throws when there is neither an argument nor
+ * a default.
+ */
+export function resolveBoardId(boardId, policy = getPolicy()) {
+    const explicit = typeof boardId === "string" ? boardId.trim() : "";
+    if (explicit.length > 0)
+        return assertBoardAllowed(explicit, policy);
+    if (policy.defaultBoardId) {
+        return assertBoardAllowed(policy.defaultBoardId, policy);
+    }
+    throw new PlankaError("boardId is required: no boardId was given and PLANKA_DEFAULT_BOARD_ID is not set. " +
+        "Pass boardId explicitly, or call planka_get_structure to find one.", "MISSING_BOARD_ID", 400);
+}
+/** Whether a tool is exposed at all under the current policy. */
+export function isToolVisible(name, policy = getPolicy()) {
+    if (policy.disabledTools.includes(name))
+        return false;
+    if (policy.readOnly && WRITE_TOOL_NAMES.has(name))
+        return false;
+    return true;
+}
+/**
+ * Why a tool is not available — the text the model gets back when it calls one
+ * anyway. Returns null when the tool is available.
+ */
+export function toolBlockedReason(name, policy = getPolicy()) {
+    if (policy.disabledTools.includes(name)) {
+        return (`Tool ${name} is disabled by this server's configuration (PLANKA_DISABLED_TOOLS). ` +
+            `Do not retry it; use another tool or ask the operator to re-enable it.`);
+    }
+    if (policy.readOnly && WRITE_TOOL_NAMES.has(name)) {
+        return (`Tool ${name} writes to Planka and this server runs in read-only mode (PLANKA_READ_ONLY=true). ` +
+            `Do not retry it; report the change you wanted to make instead of attempting it.`);
+    }
+    return null;
+}
+/**
+ * Guard-rail (not security — Planka has no per-list permissions) that keeps
+ * cards out of protected columns and protected columns intact.
+ */
+export function assertListWritable(listId, policy = getPolicy(), action = "write to") {
+    if (!listId)
+        return;
+    if (!policy.protectedListIds.includes(listId))
+        return;
+    throw new PlankaError(`list ${listId} is protected by PLANKA_PROTECTED_LIST_IDS: this server may not ${action} it ` +
+        `(protected: ${policy.protectedListIds.join(", ")}). Ask a human to do it.`, "LIST_PROTECTED", 403);
+}
+//# sourceMappingURL=policy.js.map

package/dist/config/policy.js.map

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

package/dist/errors.d.ts

@@ -12,7 +12,7 @@ export declare class PlankaAuthError extends PlankaError {
     constructor(message?: string);
 }
 export declare class PlankaNotFoundError extends PlankaError {
-    constructor(resource: string, id: string);
+    constructor(resource: string, id: string, hint?: string);
 }
 export declare class PlankaValidationError extends PlankaError {
     constructor(message: string, details?: unknown);
@@ -26,8 +26,12 @@ export declare class PlankaConfigError extends PlankaError {
 export declare class PlankaNetworkError extends PlankaError {
     constructor(message: string, details?: unknown);
 }
+/** The ID kind a context like "PATCH /api/labels/123" was addressing. */
+export declare function idKindFromContext(context?: string): string | undefined;
 /**
  * Factory function to create typed errors from API responses.
+ *
+ * Every branch answers "what should the agent do now?", not just "what broke".
  * @param status HTTP status code
  * @param body Response body (parsed JSON or null)
  * @param context Optional context (e.g., "GET /api/cards/123")

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qBAAa,WAAY,SAAQ,KAAK;aAGlB,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;aACd,OAAO,CAAC,EAAE,OAAO;gBAHjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,SAA0B;CAI9C;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAIzC;AAED,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,OAAO,SAA6B;CAIjD;AAED,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAoBb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAMD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;aACpB,QAAQ,EAAE,OAAO;gBADjB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EACpB,QAAQ,EAAE,OAAO;CASpC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC/C,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAMb;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,QAAQ,CAE9D;AAwDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,EACvB,MAAM,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE,MAAM,CAuBR;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE,MAAM,CAaR;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,CAAC,QAAQ,GAChB,MAAM,CAYR"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qBAAa,WAAY,SAAQ,KAAK;aAGlB,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;aACd,OAAO,CAAC,EAAE,OAAO;gBAHjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,SAA0B;CAI9C;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAIxD;AAED,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,OAAO,SAA6B;CAIjD;AAED,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AA2BD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUtE;AAcD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAmCb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAMD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;aACpB,QAAQ,EAAE,OAAO;gBADjB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EACpB,QAAQ,EAAE,OAAO;CASpC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC/C,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAMb;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,QAAQ,CAE9D;AAwDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,EACvB,MAAM,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE,MAAM,CAuBR;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE,MAAM,CAaR;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,CAAC,QAAQ,GAChB,MAAM,CAYR"}