@nonz250/notepm-mcp-server 0.3.0 → 0.5.0

package/README.md

@@ -20,7 +20,7 @@
 
 An unofficial [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [NotePM](https://notepm.jp/) - a knowledge management and documentation platform.
 
-This server enables AI assistants like Claude to search, read, create, update, and delete pages in your NotePM workspace.
+This server enables AI assistants like Claude to search, read, create, and update pages in your NotePM workspace.
 
 ## Requirements
 
@@ -115,21 +115,14 @@ If you installed globally, replace `npx` with the direct command:
 
 | Tool | Description |
 |------|-------------|
+| `list_folders` | List folders in a note with hierarchy |
 | `list_notes` | List all notes in your workspace |
-| `get_note` | Get a note's details including name, description, and scope |
-| `create_note` | Create a new note with name, description, and access settings |
-| `update_note` | Update an existing note's name, description, or access settings |
-| `delete_note` | Delete a note and all its pages (irreversible) |
-| `archive_note` | Archive a note (hidden from default list but can be restored) |
-| `unarchive_note` | Restore an archived note back to the active list |
 | `search_pages` | Search pages by keyword, note, or tag |
 | `get_page` | Get a page's full content including title, body, and tags |
 | `create_page` | Create a new page in a specified note |
 | `update_page` | Update an existing page's content |
-| `delete_page` | Delete a page (irreversible) |
 | `list_tags` | List all tags in your workspace |
 | `create_tag` | Create a new tag |
-| `delete_tag` | Delete a tag (irreversible) |
 
 ## Environment Variables
 

package/dist/folders/__tests__/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/folders/__tests__/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../../src/folders/__tests__/client.test.ts"],"names":[],"mappings":""}

package/dist/folders/__tests__/client.test.js

@@ -0,0 +1,30 @@
+/**
+ * FolderClient Tests
+ */
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { FolderClient } from "../client.js";
+describe("FolderClient", () => {
+    let client;
+    let mockHttp;
+    beforeEach(() => {
+        mockHttp = { request: vi.fn() };
+        client = new FolderClient(mockHttp);
+    });
+    describe("list", () => {
+        it("should call GET /notes/:note_code/folders", async () => {
+            mockHttp.request.mockResolvedValue({ folders: [] });
+            await client.list({ note_code: "abc123" });
+            expect(mockHttp.request).toHaveBeenCalledWith("GET", "/notes/abc123/folders");
+        });
+        it("should return folders response", async () => {
+            const mockFolders = [
+                { folder_id: 1, name: "Folder 1", parent_folder_id: null },
+                { folder_id: 2, name: "Folder 2", parent_folder_id: 1 },
+            ];
+            mockHttp.request.mockResolvedValue({ folders: mockFolders });
+            const result = await client.list({ note_code: "abc123" });
+            expect(result.folders).toEqual(mockFolders);
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/folders/__tests__/client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.js","sourceRoot":"","sources":["../../../src/folders/__tests__/client.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,MAAoB,CAAC;IACzB,IAAI,QAA+C,CAAC;IAEpD,UAAU,CAAC,GAAG,EAAE;QACd,QAAQ,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QAChC,MAAM,GAAG,IAAI,YAAY,CAAC,QAAiC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAEpD,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YAE3C,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,WAAW,GAAG;gBAClB,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE;gBAC1D,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,EAAE;aACxD,CAAC;YACF,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAE7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YAE1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/folders/__tests__/schemas.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schemas.test.d.ts.map

package/dist/folders/__tests__/schemas.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.test.d.ts","sourceRoot":"","sources":["../../../src/folders/__tests__/schemas.test.ts"],"names":[],"mappings":""}

package/dist/folders/__tests__/schemas.test.js

@@ -0,0 +1,27 @@
+/**
+ * Folder Schema Validation Tests
+ */
+import { describe, expect, it } from "vitest";
+import { ListFoldersInputSchema } from "../schemas.js";
+describe("ListFoldersInputSchema", () => {
+    it("should require note_code", () => {
+        const result = ListFoldersInputSchema.safeParse({});
+        expect(result.success).toBe(false);
+    });
+    it("should accept valid note_code", () => {
+        const result = ListFoldersInputSchema.safeParse({ note_code: "abc123" });
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.note_code).toBe("abc123");
+        }
+    });
+    it("should reject empty note_code", () => {
+        const result = ListFoldersInputSchema.safeParse({ note_code: "" });
+        expect(result.success).toBe(false);
+    });
+    it("should reject non-string note_code", () => {
+        const result = ListFoldersInputSchema.safeParse({ note_code: 123 });
+        expect(result.success).toBe(false);
+    });
+});
+//# sourceMappingURL=schemas.test.js.map

package/dist/folders/__tests__/schemas.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.test.js","sourceRoot":"","sources":["../../../src/folders/__tests__/schemas.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QACpE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/folders/client.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Folder domain API client
+ */
+import { HttpClient } from "../shared/http-client.js";
+import type { FoldersResponse, ListFoldersParams } from "./types.js";
+export declare class FolderClient {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List folders in a note
+     * GET /api/v1/notes/:note_code/folders
+     */
+    list(params: ListFoldersParams): Promise<FoldersResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/folders/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/folders/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE,qBAAa,YAAY;IACX,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;CAGhE"}

package/dist/folders/client.js

@@ -0,0 +1,14 @@
+export class FolderClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List folders in a note
+     * GET /api/v1/notes/:note_code/folders
+     */
+    async list(params) {
+        return this.http.request("GET", `/notes/${params.note_code}/folders`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/folders/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/folders/client.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,MAAyB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB,KAAK,EAAE,UAAU,MAAM,CAAC,SAAS,UAAU,CAAC,CAAC;IACzF,CAAC;CACF"}

package/dist/folders/handlers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Folder domain handlers
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { FolderClient } from "./client.js";
+import type { FolderToolName } from "./types.js";
+/**
+ * Check if the tool name is a folder tool
+ */
+export declare function isFolderToolName(name: string): name is FolderToolName;
+/**
+ * Handle folder tool calls
+ */
+export declare function handleFolderToolCall(client: FolderClient, _name: FolderToolName, args: unknown): Promise<CallToolResult>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/folders/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/folders/handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAU,cAAc,EAAE,MAAM,YAAY,CAAC;AAiCzD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,cAAc,CAErE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,cAAc,CAAC,CAWzB"}

package/dist/folders/handlers.js

@@ -0,0 +1,47 @@
+import { parseInput, success } from "../shared/result.js";
+import { ListFoldersInputSchema } from "./schemas.js";
+import { FOLDER_TOOL_NAMES } from "./types.js";
+/**
+ * Build folder tree structure for display
+ */
+function buildFolderTree(folders) {
+    // Get root folders (no parent)
+    const rootFolders = folders.filter((f) => f.parent_folder_id === null);
+    // Get child folders for a given parent
+    const getChildren = (parentId) => folders.filter((f) => f.parent_folder_id === parentId);
+    // Recursively format folder with children
+    const formatWithChildren = (folder, indent) => {
+        const prefix = "  ".repeat(indent);
+        const lines = [`${prefix}- **${folder.name}** (id: ${String(folder.folder_id)})`];
+        const children = getChildren(folder.folder_id);
+        for (const child of children) {
+            lines.push(...formatWithChildren(child, indent + 1));
+        }
+        return lines;
+    };
+    const lines = [];
+    for (const root of rootFolders) {
+        lines.push(...formatWithChildren(root, 0));
+    }
+    return lines.join("\n");
+}
+/**
+ * Check if the tool name is a folder tool
+ */
+export function isFolderToolName(name) {
+    return Object.values(FOLDER_TOOL_NAMES).includes(name);
+}
+/**
+ * Handle folder tool calls
+ */
+export async function handleFolderToolCall(client, _name, args) {
+    // Currently only list_folders is supported
+    const { note_code } = parseInput(ListFoldersInputSchema, args);
+    const result = await client.list({ note_code });
+    if (result.folders.length === 0) {
+        return success("No folders found in this note.");
+    }
+    const folderTree = buildFolderTree(result.folders);
+    return success(`Folders in note "${note_code}":\n\n${folderTree}`);
+}
+//# sourceMappingURL=handlers.js.map

package/dist/folders/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/folders/handlers.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,SAAS,eAAe,CAAC,OAAiB;IACxC,+BAA+B;IAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC;IAEvE,uCAAuC;IACvC,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAY,EAAE,CACjD,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC;IAEzD,0CAA0C;IAC1C,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAE,MAAc,EAAY,EAAE;QACtE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,OAAO,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,IAAsB,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAoB,EACpB,KAAqB,EACrB,IAAa;IAEb,2CAA2C;IAC3C,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAEhD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,gCAAgC,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,OAAO,CAAC,oBAAoB,SAAS,SAAS,UAAU,EAAE,CAAC,CAAC;AACrE,CAAC"}

package/dist/folders/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Folders domain exports
+ */
+export * from "./types.js";
+export * from "./schemas.js";
+export * from "./client.js";
+export * from "./handlers.js";
+export * from "./tools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/folders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/folders/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/folders/index.js

@@ -0,0 +1,9 @@
+/**
+ * Folders domain exports
+ */
+export * from "./types.js";
+export * from "./schemas.js";
+export * from "./client.js";
+export * from "./handlers.js";
+export * from "./tools.js";
+//# sourceMappingURL=index.js.map

package/dist/folders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/folders/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/folders/schemas.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Folder domain schemas (Zod)
+ */
+import { z } from "zod";
+export declare const ListFoldersInputSchema: z.ZodObject<{
+    note_code: z.ZodString;
+}, z.core.$strip>;
+/** Inferred type for list folders input */
+export type ListFoldersInput = z.infer<typeof ListFoldersInputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/folders/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/folders/schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAMH,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/folders/schemas.js

@@ -0,0 +1,11 @@
+/**
+ * Folder domain schemas (Zod)
+ */
+import { z } from "zod";
+// ============================================================
+// Zod Schemas
+// ============================================================
+export const ListFoldersInputSchema = z.object({
+    note_code: z.string().min(1).describe("Note code to list folders from"),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/folders/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/folders/schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACxE,CAAC,CAAC"}

package/dist/folders/tools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Folder domain tool definitions
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const FOLDER_TOOLS: Tool[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/folders/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAM/D,eAAO,MAAM,YAAY,EAAE,IAAI,EAM9B,CAAC"}

package/dist/folders/tools.js

@@ -0,0 +1,11 @@
+import { toInputSchema } from "../shared/index.js";
+import { ListFoldersInputSchema } from "./schemas.js";
+import { FOLDER_TOOL_NAMES } from "./types.js";
+export const FOLDER_TOOLS = [
+    {
+        name: FOLDER_TOOL_NAMES.LIST_FOLDERS,
+        description: "List folders in a NotePM note. Returns folder hierarchy with IDs and names.",
+        inputSchema: toInputSchema(ListFoldersInputSchema),
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/folders/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/folders/tools.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC;QACE,IAAI,EAAE,iBAAiB,CAAC,YAAY;QACpC,WAAW,EAAE,6EAA6E;QAC1F,WAAW,EAAE,aAAa,CAAC,sBAAsB,CAAC;KACnD;CACF,CAAC"}

package/dist/folders/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Folder domain types
+ */
+/** Folder information */
+export interface Folder {
+    folder_id: number;
+    name: string;
+    parent_folder_id: number | null;
+}
+/** Folders list response */
+export interface FoldersResponse {
+    folders: Folder[];
+}
+/** List folders parameters */
+export interface ListFoldersParams {
+    note_code: string;
+}
+/** Tool name constants for folders */
+export declare const FOLDER_TOOL_NAMES: {
+    readonly LIST_FOLDERS: "list_folders";
+};
+/** Type representing valid folder tool names */
+export type FolderToolName = (typeof FOLDER_TOOL_NAMES)[keyof typeof FOLDER_TOOL_NAMES];
+//# sourceMappingURL=types.d.ts.map

package/dist/folders/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/folders/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yBAAyB;AACzB,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,4BAA4B;AAC5B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sCAAsC;AACtC,eAAO,MAAM,iBAAiB;;CAEpB,CAAC;AAEX,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/folders/types.js

@@ -0,0 +1,8 @@
+/**
+ * Folder domain types
+ */
+/** Tool name constants for folders */
+export const FOLDER_TOOL_NAMES = {
+    LIST_FOLDERS: "list_folders",
+};
+//# sourceMappingURL=types.js.map

package/dist/folders/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/folders/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,sCAAsC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,YAAY,EAAE,cAAc;CACpB,CAAC"}

package/dist/index.js

@@ -13,7 +13,8 @@ import { createRequire } from "node:module";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-import { handleToolCall, TOOLS } from "./mcp/index.js";
+import { FolderClient } from "./folders/index.js";
+import { TOOLS, handleToolCall } from "./mcp/index.js";
 import { NoteClient } from "./notes/index.js";
 import { PageClient } from "./pages/index.js";
 import { HttpClient, loadConfig } from "./shared/index.js";
@@ -29,6 +30,7 @@ const packageJson = require("../package.json");
 const config = loadConfig();
 const httpClient = new HttpClient(config);
 const clients = {
+    folders: new FolderClient(httpClient),
     notes: new NoteClient(httpClient),
     pages: new PageClient(httpClient),
     tags: new TagClient(httpClient),

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAsC,CAAC;AAEpF,+DAA+D;AAC/D,4CAA4C;AAC5C,+DAA+D;AAE/D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAC5B,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,OAAO,GAAG;IACd,KAAK,EAAE,IAAI,UAAU,CAAC,UAAU,CAAC;IACjC,KAAK,EAAE,IAAI,UAAU,CAAC,UAAU,CAAC;IACjC,IAAI,EAAE,IAAI,SAAS,CAAC,UAAU,CAAC;CAChC,CAAC;AAEF,+DAA+D;AAC/D,yBAAyB;AACzB,+DAA+D;AAE/D,uDAAuD;AACvD,4EAA4E;AAC5E,4DAA4D;AAC5D,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,OAAO,EAAE,WAAW,CAAC,OAAO;CAC7B,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,+DAA+D;AAC/D,0BAA0B;AAC1B,+DAA+D;AAE/D;;GAEG;AACH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,OAAO,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,+DAA+D;AAC/D,eAAe;AACf,+DAA+D;AAE/D,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,8BAA8B,MAAM,CAAC,UAAU,aAAa,CAAC,CAAC;AAC9E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAsC,CAAC;AAEpF,+DAA+D;AAC/D,4CAA4C;AAC5C,+DAA+D;AAE/D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAC5B,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,OAAO,GAAG;IACd,OAAO,EAAE,IAAI,YAAY,CAAC,UAAU,CAAC;IACrC,KAAK,EAAE,IAAI,UAAU,CAAC,UAAU,CAAC;IACjC,KAAK,EAAE,IAAI,UAAU,CAAC,UAAU,CAAC;IACjC,IAAI,EAAE,IAAI,SAAS,CAAC,UAAU,CAAC;CAChC,CAAC;AAEF,+DAA+D;AAC/D,yBAAyB;AACzB,+DAA+D;AAE/D,uDAAuD;AACvD,4EAA4E;AAC5E,4DAA4D;AAC5D,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,OAAO,EAAE,WAAW,CAAC,OAAO;CAC7B,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,+DAA+D;AAC/D,0BAA0B;AAC1B,+DAA+D;AAE/D;;GAEG;AACH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,OAAO,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,+DAA+D;AAC/D,eAAe;AACf,+DAA+D;AAE/D,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,8BAA8B,MAAM,CAAC,UAAU,aAAa,CAAC,CAAC;AAC9E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/__tests__/handler.test.js

@@ -1,6 +1,6 @@
 import { beforeEach, describe, expect, it, vi } from "vitest";
+import { createMockFolder, createMockFoldersResponse, createMockNote, createMockNotesResponse, createMockPage, createMockPagesResponse, createMockTag, createMockTagsResponse, } from "../../shared/__tests__/fixtures.js";
 import { NotePMAPIError } from "../../shared/errors.js";
-import { createMockNote, createMockNotesResponse, createMockPage, createMockPagesResponse, createMockTag, createMockTagsResponse, } from "../../shared/__tests__/fixtures.js";
 import { handleToolCall } from "../index.js";
 // ============================================================
 // Helper Functions
@@ -18,37 +18,35 @@ function getTextContent(result) {
 // ============================================================
 // Mock Setup
 // ============================================================
+const createMockFolderClient = () => ({
+    list: vi.fn(),
+});
 const createMockNoteClient = () => ({
     list: vi.fn(),
-    get: vi.fn(),
-    create: vi.fn(),
-    update: vi.fn(),
-    delete: vi.fn(),
-    archive: vi.fn(),
-    unarchive: vi.fn(),
 });
 const createMockPageClient = () => ({
     search: vi.fn(),
     get: vi.fn(),
     create: vi.fn(),
     update: vi.fn(),
-    delete: vi.fn(),
 });
 const createMockTagClient = () => ({
     list: vi.fn(),
     create: vi.fn(),
-    delete: vi.fn(),
 });
 describe("handleToolCall", () => {
+    let mockFolderClient;
     let mockNoteClient;
     let mockPageClient;
     let mockTagClient;
     let clients;
     beforeEach(() => {
+        mockFolderClient = createMockFolderClient();
         mockNoteClient = createMockNoteClient();
         mockPageClient = createMockPageClient();
         mockTagClient = createMockTagClient();
         clients = {
+            folders: mockFolderClient,
             notes: mockNoteClient,
             pages: mockPageClient,
             tags: mockTagClient,
@@ -157,14 +155,6 @@ describe("handleToolCall", () => {
             expect(getTextContent(result)).toContain("## Updated Page");
         });
     });
-    describe("delete_page", () => {
-        it("should return success message", async () => {
-            mockPageClient.delete.mockResolvedValue(undefined);
-            const result = await handleToolCall(clients, "delete_page", { page_code: "page123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toBe("Page deleted: page123");
-        });
-    });
     // ============================================================
     // Note Tools Tests
     // ============================================================
@@ -208,104 +198,6 @@ describe("handleToolCall", () => {
             expect(getTextContent(result)).toContain("(No description)");
         });
     });
-    describe("get_note", () => {
-        it("should format note with all fields", async () => {
-            const note = createMockNote();
-            mockNoteClient.get.mockResolvedValue(note);
-            const result = await handleToolCall(clients, "get_note", { note_code: "note123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toContain("## Test Note");
-            expect(getTextContent(result)).toContain("Note code: note123");
-            expect(getTextContent(result)).toContain("Scope: All members");
-            expect(getTextContent(result)).toContain("Archived: No");
-        });
-        it("should handle scope as number 0 (open)", async () => {
-            const note = createMockNote({ scope: 0 });
-            mockNoteClient.get.mockResolvedValue(note);
-            const result = await handleToolCall(clients, "get_note", { note_code: "note123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toContain("Scope: All members");
-        });
-        it("should handle private scope", async () => {
-            const note = createMockNote({ scope: "private" });
-            mockNoteClient.get.mockResolvedValue(note);
-            const result = await handleToolCall(clients, "get_note", { note_code: "note123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toContain("Scope: Participating members only");
-        });
-        it("should handle archived note", async () => {
-            const note = createMockNote({ archived: true });
-            mockNoteClient.get.mockResolvedValue(note);
-            const result = await handleToolCall(clients, "get_note", { note_code: "note123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toContain("Archived: Yes");
-        });
-        it("should handle note with no description", async () => {
-            const note = createMockNote({ description: "" });
-            mockNoteClient.get.mockResolvedValue(note);
-            const result = await handleToolCall(clients, "get_note", { note_code: "note123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toContain("(No description)");
-        });
-        it("should handle note with missing dates", async () => {
-            const note = createMockNote({ created_at: undefined, updated_at: undefined });
-            mockNoteClient.get.mockResolvedValue(note);
-            const result = await handleToolCall(clients, "get_note", { note_code: "note123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toContain("Created at: N/A");
-            expect(getTextContent(result)).toContain("Updated at: N/A");
-        });
-    });
-    describe("create_note", () => {
-        it("should return success message with note details", async () => {
-            const note = createMockNote({ note_code: "new123", name: "New Note" });
-            mockNoteClient.create.mockResolvedValue(note);
-            const result = await handleToolCall(clients, "create_note", {
-                name: "New Note",
-                scope: "open",
-            });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toContain("Note created.");
-            expect(getTextContent(result)).toContain("## New Note");
-        });
-    });
-    describe("update_note", () => {
-        it("should return success message with updated note details", async () => {
-            const note = createMockNote({ note_code: "note123", name: "Updated Note" });
-            mockNoteClient.update.mockResolvedValue(note);
-            const result = await handleToolCall(clients, "update_note", {
-                note_code: "note123",
-                name: "Updated Note",
-            });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toContain("Note updated.");
-            expect(getTextContent(result)).toContain("## Updated Note");
-        });
-    });
-    describe("delete_note", () => {
-        it("should return success message", async () => {
-            mockNoteClient.delete.mockResolvedValue(undefined);
-            const result = await handleToolCall(clients, "delete_note", { note_code: "note123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toBe("Note deleted: note123");
-        });
-    });
-    describe("archive_note", () => {
-        it("should return success message", async () => {
-            mockNoteClient.archive.mockResolvedValue(undefined);
-            const result = await handleToolCall(clients, "archive_note", { note_code: "note123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toBe("Note archived: note123");
-        });
-    });
-    describe("unarchive_note", () => {
-        it("should return success message", async () => {
-            mockNoteClient.unarchive.mockResolvedValue(undefined);
-            const result = await handleToolCall(clients, "unarchive_note", { note_code: "note123" });
-            expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toBe("Note unarchived: note123");
-        });
-    });
     // ============================================================
     // Tag Tools Tests
     // ============================================================
@@ -333,12 +225,32 @@ describe("handleToolCall", () => {
             expect(getTextContent(result)).toBe("Tag created: new-tag");
         });
     });
-    describe("delete_tag", () => {
-        it("should return success message", async () => {
-            mockTagClient.delete.mockResolvedValue(undefined);
-            const result = await handleToolCall(clients, "delete_tag", { name: "tag-to-delete" });
+    // ============================================================
+    // Folder Tools Tests
+    // ============================================================
+    describe("list_folders", () => {
+        it("should return 'No folders found.' for empty results", async () => {
+            mockFolderClient.list.mockResolvedValue(createMockFoldersResponse([]));
+            const result = await handleToolCall(clients, "list_folders", { note_code: "note123" });
             expect(result.isError).toBeUndefined();
-            expect(getTextContent(result)).toBe("Tag deleted: tag-to-delete");
+            expect(getTextContent(result)).toBe("No folders found in this note.");
+        });
+        it("should format folder list with hierarchy", async () => {
+            const folders = [
+                createMockFolder({ folder_id: 1, name: "Parent Folder", parent_folder_id: null }),
+                createMockFolder({ folder_id: 2, name: "Child Folder", parent_folder_id: 1 }),
+            ];
+            mockFolderClient.list.mockResolvedValue(createMockFoldersResponse(folders));
+            const result = await handleToolCall(clients, "list_folders", { note_code: "note123" });
+            expect(result.isError).toBeUndefined();
+            expect(getTextContent(result)).toContain('Folders in note "note123"');
+            expect(getTextContent(result)).toContain("**Parent Folder**");
+            expect(getTextContent(result)).toContain("**Child Folder**");
+        });
+        it("should require note_code parameter", async () => {
+            const result = await handleToolCall(clients, "list_folders", {});
+            expect(result.isError).toBe(true);
+            expect(getTextContent(result)).toContain("Input error:");
         });
     });
 });