@omnicoreos/planka-mcp 0.2.0 → 0.3.0

package/dist/operations/members.js.map

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

package/dist/operations/projects.d.ts

@@ -17,8 +17,24 @@ export declare function getProjects(): Promise<{
     projects: Project[];
     boards: Board[];
 }>;
+/**
+ * Trims what Planka answered down to what this server is allowed to show.
+ *
+ * Filtering here (and not only at call time) is the point: an agent that
+ * cannot SEE the other boards never tries to touch them, and the error paths
+ * that list "known boards" stop leaking names from projects out of scope.
+ */
+export declare function applyAllowlists(projects: Project[], boards: Board[]): {
+    projects: Project[];
+    boards: Board[];
+};
 /**
  * Get the full structure: projects -> boards -> lists.
+ *
+ * `GET /api/projects` already carries every visible board, so with
+ * `withLists: false` the whole structure is ONE request. With lists (the
+ * default, kept so existing callers keep their column IDs) it costs one board
+ * read per board — the N+1 that `planka_board_summary` avoids.
  */
 export declare function getStructure(input?: GetStructureInput): Promise<ProjectStructure[]>;
 //# sourceMappingURL=projects.d.ts.map

package/dist/operations/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/operations/projects.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG/E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,IAAI,EAAE,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAC3C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB,CAAC,CAWD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,GAAE,iBAAsB,GAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkD7B"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/operations/projects.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG/E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,IAAI,EAAE,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAC3C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB,CAAC,CAQD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,KAAK,EAAE,GACd;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,CAoB1C;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,KAAK,GAAE,iBAAsB,GAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA2E7B"}

package/dist/operations/projects.js

@@ -2,7 +2,8 @@
  * Project operations for PLANKA API.
  */
 import { plankaClient } from "../client.js";
-import { parseInput } from "../errors.js";
+import { parseInput, PlankaError } from "../errors.js";
+import { assertProjectAllowed, getPolicy, isBoardAllowed, isProjectAllowed, } from "../config/policy.js";
 import { ProjectsResponse, ProjectsIncludedSchema } from "../schemas/responses.js";
 import { GetStructureSchema } from "../schemas/requests.js";
 import { z } from "zod";
@@ -13,26 +14,70 @@ export async function getProjects() {
     const response = await plankaClient.get("/api/projects");
     const parsed = ProjectsResponse.parse(response);
     const included = ProjectsIncludedSchema.parse(response.included || {});
-    return {
-        projects: parsed.items,
-        boards: included.boards || [],
-    };
+    return applyAllowlists(parsed.items, included.boards || []);
+}
+/**
+ * Trims what Planka answered down to what this server is allowed to show.
+ *
+ * Filtering here (and not only at call time) is the point: an agent that
+ * cannot SEE the other boards never tries to touch them, and the error paths
+ * that list "known boards" stop leaking names from projects out of scope.
+ */
+export function applyAllowlists(projects, boards) {
+    const policy = getPolicy();
+    if (policy.allowedProjectIds === null && policy.allowedBoardIds === null) {
+        return { projects, boards };
+    }
+    let visibleProjects = projects.filter((p) => isProjectAllowed(p.id, policy));
+    const projectIds = new Set(visibleProjects.map((p) => p.id));
+    const visibleBoards = boards.filter((b) => projectIds.has(b.projectId) && isBoardAllowed(b.id, policy));
+    // With a board allowlist, a project with no allowed board is noise.
+    if (policy.allowedBoardIds !== null) {
+        const withBoards = new Set(visibleBoards.map((b) => b.projectId));
+        visibleProjects = visibleProjects.filter((p) => withBoards.has(p.id));
+    }
+    return { projects: visibleProjects, boards: visibleBoards };
 }
 /**
  * Get the full structure: projects -> boards -> lists.
+ *
+ * `GET /api/projects` already carries every visible board, so with
+ * `withLists: false` the whole structure is ONE request. With lists (the
+ * default, kept so existing callers keep their column IDs) it costs one board
+ * read per board — the N+1 that `planka_board_summary` avoids.
  */
 export async function getStructure(input = {}) {
-    const { projectId } = parseInput(GetStructureSchema, input);
+    const { projectId, withLists } = parseInput(GetStructureSchema, input);
+    // Outside the allowlist: say so instead of answering an empty structure.
+    if (projectId)
+        assertProjectAllowed(projectId);
     const { projects, boards } = await getProjects();
     // Filter to specific project if requested
-    const targetProjects = projectId
-        ? projects.filter((p) => p.id === projectId)
-        : projects;
+    let targetProjects = projects;
+    if (projectId) {
+        targetProjects = projects.filter((p) => p.id === projectId);
+        if (targetProjects.length === 0) {
+            const known = projects
+                .map((p) => `  - ${p.id} — "${p.name}"`)
+                .join("\n");
+            throw new PlankaError(`No project with id ${projectId} is visible to this account. ` +
+                (projects.length
+                    ? `Visible projects:\n${known}`
+                    : "No projects are visible at all — check the credentials and the board memberships of the Planka user."), "NOT_FOUND", 404);
+        }
+    }
     const structures = [];
     for (const project of targetProjects) {
         const projectBoards = boards.filter((b) => b.projectId === project.id);
         const boardsWithLists = [];
         for (const board of projectBoards) {
+            // Planka has no per-board list endpoint: the columns only come inside a
+            // full board read (every card, every attachment). One per board — so it
+            // only happens when the caller asked for the lists.
+            if (!withLists) {
+                boardsWithLists.push({ board, lists: [] });
+                continue;
+            }
             // Get board details to get lists
             const boardResponse = await plankaClient.get(`/api/boards/${board.id}`);
             const included = boardResponse.included;

package/dist/operations/projects.js.map

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

package/dist/operations/tasks.d.ts

@@ -22,7 +22,7 @@ export declare function updateTask(input: UpdateTaskParamsInput): Promise<Task>;
 /**
  * Delete a task.
  */
-export declare function deleteTask(input: TaskIdInput): Promise<void>;
+export declare function deleteTask(input: TaskIdInput): Promise<Task | null>;
 /**
  * Delete a task-list and all its tasks.
  */

package/dist/operations/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/operations/tasks.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAEL,qBAAqB,EAGrB,mBAAmB,EAEnB,eAAe,EAEf,WAAW,EAEX,eAAe,EAEf,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAqChC;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAanB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CA0B/E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/operations/tasks.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAEL,qBAAqB,EAGrB,mBAAmB,EAEnB,eAAe,EAEf,WAAW,EAEX,eAAe,EAEf,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAqChC;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAanB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CA0B/E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAKzE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E"}

package/dist/operations/tasks.js

@@ -9,7 +9,7 @@ import { plankaClient } from "../client.js";
 import { parseInput } from "../errors.js";
 import { BatchCreateTasksSchema, CreateTaskListSchema, CreateTaskSchema, TaskIdSchema, TaskListIdSchema, UpdateTaskParamsSchema, } from "../schemas/requests.js";
 import { TaskResponse, TaskListResponse } from "../schemas/responses.js";
-import { getCard } from "./cards.js";
+import { getCardLight } from "./cards.js";
 const DEFAULT_TASK_LIST_NAME = "Tasks";
 /**
  * Get or create a default task-list for a card.
@@ -18,7 +18,7 @@ const DEFAULT_TASK_LIST_NAME = "Tasks";
 async function getOrCreateDefaultTaskList(input) {
     const { cardId } = input;
     // Fetch card to see existing task-lists
-    const cardDetails = await getCard({ cardId });
+    const cardDetails = await getCardLight({ cardId });
     // Check if there's an existing task-list
     if (cardDetails.taskLists && cardDetails.taskLists.length > 0) {
         // Return the first task-list (sorted by position)
@@ -99,7 +99,9 @@ export async function updateTask(input) {
  */
 export async function deleteTask(input) {
     const { taskId } = parseInput(TaskIdSchema, input);
-    await plankaClient.delete(`/api/tasks/${taskId}`);
+    const body = await plankaClient.delete(`/api/tasks/${taskId}`);
+    const parsed = TaskResponse.safeParse(body);
+    return parsed.success ? parsed.data.item : null;
 }
 /**
  * Delete a task-list and all its tasks.

package/dist/operations/tasks.js.map

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

package/dist/operations/users.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Who exists in this Planka, and who this server is logged in as.
+ *
+ * `GET /api/users` is admin-or-projectOwner only (`policies.js`): an agent
+ * running as the recommended `boardUser` gets 403 and would be left unable to
+ * assign anybody. So every read here has a board-scoped fallback — the board
+ * show carries `included.users` and `included.boardMemberships` for exactly
+ * the people who can be assigned on that board, which is the useful set anyway.
+ *
+ * The fallback is never silent: the result says `source: "board"` so a caller
+ * knows it is looking at the board's members, not the instance's roster.
+ */
+import { z } from "zod";
+declare const UserRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isDeactivated: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isDeactivated: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isDeactivated: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type UserRow = z.infer<typeof UserRowSchema>;
+declare const BoardMembershipSchema: z.ZodObject<{
+    id: z.ZodString;
+    boardId: z.ZodString;
+    userId: z.ZodString;
+    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    canComment: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    boardId: z.ZodString;
+    userId: z.ZodString;
+    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    canComment: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    boardId: z.ZodString;
+    userId: z.ZodString;
+    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    canComment: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type BoardMembership = z.infer<typeof BoardMembershipSchema>;
+/** One user, reduced to what an assignment decision needs. */
+export interface UserDigest {
+    id: string;
+    name: string;
+    username?: string;
+    role?: string;
+    /** Only in the board-scoped view: "editor" | "viewer". */
+    boardRole?: string;
+    canComment?: boolean;
+    /** Only with detail: "full" — an address is PII, not a routing key. */
+    email?: string;
+    isDeactivated?: boolean;
+}
+export interface ListUsersResult {
+    /** "instance" = GET /api/users · "board" = the board's own members. */
+    source: "instance" | "board";
+    boardId?: string;
+    users: UserDigest[];
+    /** Set when the instance roster was refused and the board answered instead. */
+    fellBackBecause?: string;
+}
+/**
+ * Everyone this server can see, instance-wide when allowed and board-scoped
+ * otherwise.
+ */
+export declare function listUsers(input?: {
+    boardId?: string;
+    detail?: "digest" | "full";
+}): Promise<ListUsersResult>;
+/** The board's own members, with their board role. */
+export declare function listBoardUsers(input: {
+    boardId?: string;
+    detail?: "digest" | "full";
+}): Promise<ListUsersResult>;
+/** The account this server authenticates as. */
+export declare function getCurrentUser(): Promise<UserRow>;
+/**
+ * The Planka version.
+ *
+ * `/api/bootstrap` is the ONLY endpoint that carries it in 2.x — `/api/config`
+ * returns SMTP settings and nothing else, and `/swagger.json` is not served.
+ */
+export declare function getPlankaVersion(): Promise<string | null>;
+/**
+ * This user's membership on one board, read from `/api/projects` (3 kB) rather
+ * than from the board show (~900 kB): both carry `boardMemberships`.
+ */
+export declare function getBoardMembership(input: {
+    boardId: string;
+    userId: string;
+}): Promise<BoardMembership | null>;
+/**
+ * Resolves names or usernames to user ids.
+ *
+ * Case-insensitive, exact match on `username` first and then on `name`. An
+ * ambiguous name is NOT guessed: assigning the wrong person is worse than
+ * failing, so it comes back in `failed`.
+ */
+export declare function resolveUserNames(names: string[], users: UserDigest[]): {
+    ids: string[];
+    failed: Array<{
+        userName: string;
+        reason: string;
+    }>;
+};
+export {};
+//# sourceMappingURL=users.d.ts.map

package/dist/operations/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/operations/users.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;gCASH,CAAC;AACjB,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAKpD,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;gCAQX,CAAC;AACjB,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAyBpE,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA0BD;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,KAAK,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;CAAO,GAC3D,OAAO,CAAC,eAAe,CAAC,CAqB1B;AAED,sDAAsD;AACtD,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,eAAe,CAAC,CAiB3B;AAED,gDAAgD;AAChD,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG/D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAQlC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,UAAU,EAAE,GAClB;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAqCxE"}

package/dist/operations/users.js

@@ -0,0 +1,180 @@
+/**
+ * Who exists in this Planka, and who this server is logged in as.
+ *
+ * `GET /api/users` is admin-or-projectOwner only (`policies.js`): an agent
+ * running as the recommended `boardUser` gets 403 and would be left unable to
+ * assign anybody. So every read here has a board-scoped fallback — the board
+ * show carries `included.users` and `included.boardMemberships` for exactly
+ * the people who can be assigned on that board, which is the useful set anyway.
+ *
+ * The fallback is never silent: the result says `source: "board"` so a caller
+ * knows it is looking at the board's members, not the instance's roster.
+ */
+import { z } from "zod";
+import { plankaClient } from "../client.js";
+import { PlankaError } from "../errors.js";
+import { withBoardId } from "./board-id.js";
+const UserRowSchema = z
+    .object({
+    id: z.string(),
+    name: z.string().nullable().optional(),
+    username: z.string().nullable().optional(),
+    email: z.string().nullable().optional(),
+    role: z.string().nullable().optional(),
+    isDeactivated: z.boolean().nullable().optional(),
+})
+    .passthrough();
+const UsersResponse = z.object({ items: z.array(UserRowSchema) });
+const UserResponse = z.object({ item: UserRowSchema });
+const BoardMembershipSchema = z
+    .object({
+    id: z.string(),
+    boardId: z.string(),
+    userId: z.string(),
+    role: z.string().nullable().optional(),
+    canComment: z.boolean().nullable().optional(),
+})
+    .passthrough();
+const BoardUsersResponse = z.object({
+    included: z
+        .object({
+        users: z.array(UserRowSchema).optional(),
+        boardMemberships: z.array(BoardMembershipSchema).optional(),
+    })
+        .passthrough()
+        .optional(),
+});
+const ProjectsMembershipsResponse = z.object({
+    included: z
+        .object({
+        boardMemberships: z.array(BoardMembershipSchema).optional(),
+    })
+        .passthrough()
+        .optional(),
+});
+const BootstrapResponse = z.object({
+    item: z.object({ version: z.string().optional() }).passthrough(),
+});
+function digestUser(user, membership, full) {
+    return {
+        id: user.id,
+        name: user.name ?? user.username ?? user.id,
+        ...(user.username ? { username: user.username } : {}),
+        ...(user.role ? { role: user.role } : {}),
+        ...(membership?.role ? { boardRole: membership.role } : {}),
+        ...(membership && membership.canComment !== null && membership.canComment !== undefined
+            ? { canComment: membership.canComment }
+            : {}),
+        ...(full && user.email ? { email: user.email } : {}),
+        ...(user.isDeactivated ? { isDeactivated: true } : {}),
+    };
+}
+/** True for the 403 Planka answers a `boardUser` asking for the roster. */
+function isForbidden(error) {
+    return error instanceof PlankaError && (error.status === 403 || error.status === 401);
+}
+/**
+ * Everyone this server can see, instance-wide when allowed and board-scoped
+ * otherwise.
+ */
+export async function listUsers(input = {}) {
+    const full = input.detail === "full";
+    try {
+        const response = await plankaClient.get("/api/users");
+        const parsed = UsersResponse.parse(response);
+        return {
+            source: "instance",
+            users: parsed.items.map((user) => digestUser(user, undefined, full)),
+        };
+    }
+    catch (error) {
+        if (!isForbidden(error))
+            throw error;
+        const board = await listBoardUsers({ boardId: input.boardId, detail: input.detail });
+        return {
+            ...board,
+            fellBackBecause: "GET /api/users is admin-only and this account is not an admin; " +
+                "these are the members of the board instead.",
+        };
+    }
+}
+/** The board's own members, with their board role. */
+export async function listBoardUsers(input) {
+    const full = input.detail === "full";
+    return withBoardId(input.boardId, async (boardId) => {
+        const response = await plankaClient.get(`/api/boards/${boardId}`);
+        const parsed = BoardUsersResponse.parse(response);
+        const memberships = parsed.included?.boardMemberships ?? [];
+        const byUser = new Map(memberships.map((m) => [m.userId, m]));
+        return {
+            source: "board",
+            boardId,
+            users: (parsed.included?.users ?? []).map((user) => digestUser(user, byUser.get(user.id), full)),
+        };
+    });
+}
+/** The account this server authenticates as. */
+export async function getCurrentUser() {
+    const response = await plankaClient.get("/api/users/me");
+    return UserResponse.parse(response).item;
+}
+/**
+ * The Planka version.
+ *
+ * `/api/bootstrap` is the ONLY endpoint that carries it in 2.x — `/api/config`
+ * returns SMTP settings and nothing else, and `/swagger.json` is not served.
+ */
+export async function getPlankaVersion() {
+    const response = await plankaClient.get("/api/bootstrap");
+    return BootstrapResponse.parse(response).item.version ?? null;
+}
+/**
+ * This user's membership on one board, read from `/api/projects` (3 kB) rather
+ * than from the board show (~900 kB): both carry `boardMemberships`.
+ */
+export async function getBoardMembership(input) {
+    const response = await plankaClient.get("/api/projects");
+    const parsed = ProjectsMembershipsResponse.parse(response);
+    return ((parsed.included?.boardMemberships ?? []).find((m) => m.boardId === input.boardId && m.userId === input.userId) ?? null);
+}
+/**
+ * Resolves names or usernames to user ids.
+ *
+ * Case-insensitive, exact match on `username` first and then on `name`. An
+ * ambiguous name is NOT guessed: assigning the wrong person is worse than
+ * failing, so it comes back in `failed`.
+ */
+export function resolveUserNames(names, users) {
+    const ids = [];
+    const failed = [];
+    for (const raw of names) {
+        const wanted = raw.trim().toLowerCase();
+        if (!wanted) {
+            failed.push({ userName: raw, reason: "empty name" });
+            continue;
+        }
+        const byUsername = users.filter((u) => u.username?.toLowerCase() === wanted);
+        const matches = byUsername.length > 0
+            ? byUsername
+            : users.filter((u) => u.name.toLowerCase() === wanted);
+        if (matches.length === 0) {
+            failed.push({
+                userName: raw,
+                reason: `no user named "${raw}" — call planka_list_users for the real names`,
+            });
+            continue;
+        }
+        if (matches.length > 1) {
+            failed.push({
+                userName: raw,
+                reason: `"${raw}" matches ${matches.length} users (${matches
+                    .map((u) => u.id)
+                    .join(", ")}); pass the userId`,
+            });
+            continue;
+        }
+        ids.push(matches[0].id);
+    }
+    return { ids, failed };
+}
+//# sourceMappingURL=users.js.map

package/dist/operations/users.js.map

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

package/dist/operations/verify.d.ts

@@ -0,0 +1,84 @@
+export interface VerifiedWriteResult<T, A> {
+    /** Whatever the write returned (usually Planka's `item`). */
+    result: T;
+    /** True only when the re-read confirmed the change. */
+    verified: boolean;
+    /** The re-read state, when the re-read succeeded. */
+    after?: A;
+    /** Set when the re-read itself blew up — the write may or may not have landed. */
+    verificationError?: string;
+}
+/**
+ * Run a write, re-read the entity, and report whether the change is really there.
+ *
+ * `landed` gets the re-read state and the write's own result; it answers the
+ * only question that matters: is what we asked for true now?
+ */
+export declare function verifiedWrite<T, A>(opts: {
+    write: () => Promise<T>;
+    reread: (written: T) => Promise<A>;
+    landed: (after: A, written: T) => boolean;
+}): Promise<VerifiedWriteResult<T, A>>;
+export interface VerifiedDeleteResult<T> {
+    /** The DELETE response body (Planka 2.x returns the deleted item). */
+    result: T;
+    /** True only when a re-read confirmed the entity is gone. */
+    verified: boolean;
+    /** Set when the confirmation could not be made at all. */
+    verificationError?: string;
+    /** Set when confirmation was structurally impossible (missing parent id). */
+    verificationUnavailable?: string;
+}
+/**
+ * Run a delete and confirm the entity is really gone.
+ *
+ * `confirmGone` returns true (gone), false (still there) or null (could not
+ * check — e.g. the parent id needed for the re-read is unknown).
+ */
+export declare function verifiedDelete<T>(opts: {
+    del: () => Promise<T>;
+    confirmGone: (deleted: T) => Promise<boolean | null>;
+    /** Message used when confirmGone answers null. */
+    unknownReason?: string;
+}): Promise<VerifiedDeleteResult<T>>;
+/**
+ * Confirmation helper for entities that have their own GET: a 404 on re-read
+ * is the proof of deletion. Any other failure propagates.
+ */
+export declare function goneOn404(reread: () => Promise<unknown>): Promise<boolean>;
+/**
+ * Standard tool payload for a write.
+ *
+ * `success` mirrors `verified` and nothing else. "I could not check" is not a
+ * success: a payload that says `success: true` next to `verified: false` and
+ * "delete not confirmed" is read by the model as done, and the model moves on.
+ *
+ * - verified            → success, no isError
+ * - unavailable         → success:false, verified:false, isError, and a
+ *                         `verificationUnavailable` that names the parameter
+ *                         which would have made the check possible
+ * - anything else       → isError, because the write cannot be claimed
+ */
+export declare function writeResult(payload: Record<string, unknown>, v: {
+    verified: boolean;
+    verificationError?: string;
+    verificationUnavailable?: string;
+}): {
+    isError?: true | undefined;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * The "nothing to do" guard shared by the update tools: a PATCH with only an
+ * id is a no-op that Planka happily answers 200 to.
+ */
+export declare function nothingToDo(fields: string, extra?: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+//# sourceMappingURL=verify.d.ts.map

package/dist/operations/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/operations/verify.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,CAAC;IACvC,6DAA6D;IAC7D,MAAM,EAAE,CAAC,CAAC;IACV,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE;IAC9C,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC;CAC3C,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAerC;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,sEAAsE;IACtE,MAAM,EAAE,CAAC,CAAC;IACV,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACrD,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAwBnC;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAQhF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,CAAC,EAAE;IACD,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;;;;;;EAgBF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;;;;;;EAUzD"}