pmwiki-mcp 1.0.0

package/README.md

@@ -0,0 +1,153 @@
+# PmWiki MCP Server
+
+A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that enables AI agents like Claude to interact with a PmWiki instance.
+
+## Features
+
+- **wiki_find_pages** - Search for pages by name or content
+- **wiki_read_page** - Read page content (raw, markdown, or HTML)
+- **wiki_create_page** - Create new wiki pages
+- **wiki_edit_page** - Edit existing wiki pages
+- **wiki_list_pages** - List pages in a group
+
+## Installation
+
+### Using npx (recommended)
+
+No installation needed - just configure Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "pmwiki": {
+      "command": "npx",
+      "args": ["-y", "pmwiki-mcp"],
+      "env": {
+        "PMWIKI_URL": "https://your-wiki-url.com",
+        "PMWIKI_MCP_KEY": "your-mcp-key-here"
+      }
+    }
+  }
+}
+```
+
+### Global installation
+
+```bash
+npm install -g pmwiki-mcp
+```
+
+## Configuration
+
+The server requires two environment variables:
+
+| Variable | Description |
+|----------|-------------|
+| `PMWIKI_URL` | Base URL of your wiki (e.g., `https://wiki.example.com`) |
+| `PMWIKI_MCP_KEY` | MCP authentication key (generated via `?action=mcpkeygen`) |
+
+## Server Setup
+
+Your PmWiki installation needs the MCP cookbook (`cookbook/mcp.php`) which provides the API endpoints:
+
+1. Copy `cookbook/mcp.php` to your wiki's cookbook directory
+2. Add to `local/config.php`:
+   ```php
+   include_once("$FarmD/cookbook/mcp.php");
+   ```
+3. Generate an MCP key by visiting `?action=mcpkeygen` while logged in as admin
+4. Save the key securely - it provides full read/write access to all pages
+
+## Tools
+
+### wiki_find_pages
+
+Search for wiki pages by name or content.
+
+**Parameters:**
+- `query` (required) - Search query
+- `group` (optional) - Limit search to a specific group
+- `nameOnly` (optional) - Only search page names, not content
+- `limit` (optional) - Maximum results (default: 50)
+
+**Example:**
+```
+Search for pages about "authentication"
+```
+
+### wiki_read_page
+
+Read a wiki page's content.
+
+**Parameters:**
+- `pagename` (required) - Page name (e.g., "Main.HomePage" or "Main/HomePage")
+- `format` (optional) - Output format: `raw`, `markdown`, or `html` (default: raw)
+
+**Example:**
+```
+Read the page Main/AdminPage in markdown format
+```
+
+### wiki_create_page
+
+Create a new wiki page.
+
+**Parameters:**
+- `pagename` (required) - Page name
+- `content` (required) - Page content in PmWiki markup
+- `summary` (optional) - Edit summary
+
+**Example:**
+```
+Create page Main.NewPage with content "!! Welcome\n\nThis is a new page."
+```
+
+### wiki_edit_page
+
+Edit an existing wiki page.
+
+**Parameters:**
+- `pagename` (required) - Page name
+- `content` (required) - New page content
+- `summary` (optional) - Edit summary
+
+### wiki_list_pages
+
+List wiki pages in a group.
+
+**Parameters:**
+- `group` (optional) - Group name (lists all if omitted)
+- `limit` (optional) - Maximum pages (default: 100)
+
+**Example:**
+```
+List all pages in the Main group
+```
+
+## Security
+
+- The MCP key provides full access to all wiki pages - protect it like a password
+- All requests are logged to `wiki.d/.mcplog`
+- Rate limiting prevents abuse (60 requests per minute per IP)
+- HTTPS is strongly recommended for production use
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/milee98/pmwiki.git
+cd pmwiki/pmwiki-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+PMWIKI_URL=https://wiki.example.com PMWIKI_MCP_KEY=xxx npm start
+```
+
+## License
+
+MIT

package/dist/api/wikiClient.d.ts

@@ -0,0 +1,73 @@
+/**
+ * HTTP client for PmWiki MCP API
+ */
+import { Config } from '../config.js';
+export interface WikiPage {
+    pagename: string;
+    title: string;
+    text: string;
+    format: string;
+    time?: number;
+    author?: string;
+    group: string;
+    name: string;
+}
+export interface PageListItem {
+    pagename: string;
+    group: string;
+    name: string;
+    title: string;
+    time?: number;
+    author?: string;
+}
+export interface SearchResult {
+    pagename: string;
+    group: string;
+    name: string;
+    title: string;
+    time?: number;
+    matchType: 'name' | 'content' | 'both';
+    snippet?: string;
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    error?: string;
+    [key: string]: unknown;
+}
+export declare class WikiClient {
+    private baseUrl;
+    private mcpKey;
+    constructor(config: Config);
+    private request;
+    /**
+     * Read a wiki page
+     */
+    readPage(pagename: string, format?: 'raw' | 'markdown' | 'html'): Promise<WikiPage>;
+    /**
+     * List pages in a group
+     */
+    listPages(group?: string, limit?: number): Promise<PageListItem[]>;
+    /**
+     * Search for pages
+     */
+    searchPages(query: string, options?: {
+        group?: string;
+        nameOnly?: boolean;
+        limit?: number;
+    }): Promise<SearchResult[]>;
+    /**
+     * Create a new page
+     */
+    createPage(pagename: string, content: string, summary?: string): Promise<{
+        pagename: string;
+        action: string;
+    }>;
+    /**
+     * Edit an existing page
+     */
+    editPage(pagename: string, content: string, summary?: string): Promise<{
+        pagename: string;
+        action: string;
+    }>;
+}
+//# sourceMappingURL=wikiClient.d.ts.map

package/dist/api/wikiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikiClient.d.ts","sourceRoot":"","sources":["../../src/api/wikiClient.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;YAKZ,OAAO;IA2CrB;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,KAAK,GAAG,UAAU,GAAG,MAAc,GAC1C,OAAO,CAAC,QAAQ,CAAC;IAiBpB;;OAEG;IACG,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAWxE;;OAEG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GACL,OAAO,CAAC,YAAY,EAAE,CAAC;IAY1B;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBhD;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAgBjD"}

package/dist/api/wikiClient.js

@@ -0,0 +1,120 @@
+/**
+ * HTTP client for PmWiki MCP API
+ */
+export class WikiClient {
+    baseUrl;
+    mcpKey;
+    constructor(config) {
+        this.baseUrl = config.wikiUrl;
+        this.mcpKey = config.mcpKey;
+    }
+    async request(action, params = {}, method = 'GET', body) {
+        const url = new URL(this.baseUrl);
+        url.searchParams.set('action', action);
+        url.searchParams.set('mcpkey', this.mcpKey);
+        for (const [key, value] of Object.entries(params)) {
+            url.searchParams.set(key, value);
+        }
+        const options = {
+            method,
+            headers: {
+                Accept: 'application/json',
+            },
+        };
+        if (method === 'POST' && body) {
+            options.headers = {
+                ...options.headers,
+                'Content-Type': 'application/x-www-form-urlencoded',
+            };
+            const formData = new URLSearchParams();
+            for (const [key, value] of Object.entries(body)) {
+                formData.set(key, value);
+            }
+            options.body = formData.toString();
+        }
+        const response = await fetch(url.toString(), options);
+        const data = (await response.json());
+        if (!response.ok || data.error) {
+            throw new Error(data.error || `HTTP ${response.status}`);
+        }
+        return data;
+    }
+    /**
+     * Read a wiki page
+     */
+    async readPage(pagename, format = 'raw') {
+        const response = await this.request('mcpread', { page: pagename, format });
+        return {
+            pagename: response.pagename,
+            title: response.title,
+            text: response.text,
+            format: response.format,
+            time: response.time,
+            author: response.author,
+            group: response.group,
+            name: response.name,
+        };
+    }
+    /**
+     * List pages in a group
+     */
+    async listPages(group, limit) {
+        const params = {};
+        if (group)
+            params.group = group;
+        if (limit)
+            params.limit = String(limit);
+        const response = await this.request('mcplist', params);
+        return response.pages;
+    }
+    /**
+     * Search for pages
+     */
+    async searchPages(query, options = {}) {
+        const params = { q: query };
+        if (options.group)
+            params.group = options.group;
+        if (options.nameOnly)
+            params.nameonly = '1';
+        if (options.limit)
+            params.limit = String(options.limit);
+        const response = await this.request('mcpsearch', params);
+        return response.results;
+    }
+    /**
+     * Create a new page
+     */
+    async createPage(pagename, content, summary) {
+        const body = {
+            page: pagename,
+            content,
+        };
+        if (summary)
+            body.summary = summary;
+        const response = await this.request('mcpwrite', {}, 'POST', body);
+        if (response.action !== 'created') {
+            throw new Error(`Page already exists: ${pagename}`);
+        }
+        return {
+            pagename: response.pagename,
+            action: response.action,
+        };
+    }
+    /**
+     * Edit an existing page
+     */
+    async editPage(pagename, content, summary) {
+        const body = {
+            page: pagename,
+            content,
+        };
+        if (summary)
+            body.summary = summary;
+        const response = await this.request('mcpwrite', {}, 'POST', body);
+        return {
+            pagename: response.pagename,
+            action: response.action,
+        };
+    }
+}
+//# sourceMappingURL=wikiClient.js.map

package/dist/api/wikiClient.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Configuration for PmWiki MCP server
+ *
+ * Environment variables:
+ *   PMWIKI_URL     - Base URL of the wiki (e.g., https://wiki.mjlee.xyz)
+ *   PMWIKI_MCP_KEY - MCP authentication key
+ */
+export interface Config {
+    wikiUrl: string;
+    mcpKey: string;
+}
+export declare function getConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,SAAS,IAAI,MAAM,CAmBlC"}

package/dist/config.js

@@ -0,0 +1,24 @@
+/**
+ * Configuration for PmWiki MCP server
+ *
+ * Environment variables:
+ *   PMWIKI_URL     - Base URL of the wiki (e.g., https://wiki.mjlee.xyz)
+ *   PMWIKI_MCP_KEY - MCP authentication key
+ */
+export function getConfig() {
+    const wikiUrl = process.env.PMWIKI_URL;
+    const mcpKey = process.env.PMWIKI_MCP_KEY;
+    if (!wikiUrl) {
+        throw new Error('PMWIKI_URL environment variable is required');
+    }
+    if (!mcpKey) {
+        throw new Error('PMWIKI_MCP_KEY environment variable is required');
+    }
+    // Normalize URL (remove trailing slash)
+    const normalizedUrl = wikiUrl.replace(/\/+$/, '');
+    return {
+        wikiUrl: normalizedUrl,
+        mcpKey,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,wCAAwC;IACxC,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAElD,OAAO;QACL,OAAO,EAAE,aAAa;QACtB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * PmWiki MCP Server
+ *
+ * Provides Model Context Protocol tools for interacting with a PmWiki instance.
+ *
+ * Environment variables:
+ *   PMWIKI_URL     - Base URL of the wiki (e.g., https://wiki.mjlee.xyz)
+ *   PMWIKI_MCP_KEY - MCP authentication key
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/index.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/**
+ * PmWiki MCP Server
+ *
+ * Provides Model Context Protocol tools for interacting with a PmWiki instance.
+ *
+ * Environment variables:
+ *   PMWIKI_URL     - Base URL of the wiki (e.g., https://wiki.mjlee.xyz)
+ *   PMWIKI_MCP_KEY - MCP authentication key
+ */
+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 { getConfig } from './config.js';
+import { WikiClient } from './api/wikiClient.js';
+import { findPages, findPagesTool } from './tools/findPages.js';
+import { readPage, readPageTool } from './tools/readPage.js';
+import { createPage, createPageTool } from './tools/createPage.js';
+import { editPage, editPageTool } from './tools/editPage.js';
+import { listPages, listPagesTool } from './tools/listPages.js';
+const config = getConfig();
+const client = new WikiClient(config);
+const server = new Server({
+    name: 'pmwiki-mcp',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            findPagesTool,
+            readPageTool,
+            createPageTool,
+            editPageTool,
+            listPagesTool,
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case 'wiki_find_pages':
+                result = await findPages(client, args);
+                break;
+            case 'wiki_read_page':
+                result = await readPage(client, args);
+                break;
+            case 'wiki_create_page':
+                result = await createPage(client, args);
+                break;
+            case 'wiki_edit_page':
+                result = await editPage(client, args);
+                break;
+            case 'wiki_list_pages':
+                result = await listPages(client, args);
+                break;
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: message }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('PmWiki MCP server started');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/createPage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * wiki_create_page tool - Create a new wiki page
+ */
+import { z } from 'zod';
+import { WikiClient } from '../api/wikiClient.js';
+export declare const createPageSchema: z.ZodObject<{
+    pagename: z.ZodString;
+    content: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    pagename: string;
+    summary?: string | undefined;
+}, {
+    content: string;
+    pagename: string;
+    summary?: string | undefined;
+}>;
+export type CreatePageInput = z.infer<typeof createPageSchema>;
+export interface CreatePageResult {
+    pagename: string;
+    action: string;
+    message: string;
+}
+export declare function createPage(client: WikiClient, input: CreatePageInput): Promise<CreatePageResult>;
+export declare const createPageTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            pagename: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            summary: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=createPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createPage.d.ts","sourceRoot":"","sources":["../../src/tools/createPage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAM3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAa3B;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAsB1B,CAAC"}

package/dist/tools/createPage.js

@@ -0,0 +1,44 @@
+/**
+ * wiki_create_page tool - Create a new wiki page
+ */
+import { z } from 'zod';
+export const createPageSchema = z.object({
+    pagename: z
+        .string()
+        .describe('Page name in Group.Name or Group/Name format'),
+    content: z.string().describe('Page content in PmWiki markup format'),
+    summary: z.string().optional().describe('Edit summary describing the change'),
+});
+export async function createPage(client, input) {
+    // Normalize pagename (convert / to .)
+    const pagename = input.pagename.replace('/', '.');
+    const result = await client.createPage(pagename, input.content, input.summary);
+    return {
+        pagename: result.pagename,
+        action: result.action,
+        message: `Page ${result.pagename} created successfully`,
+    };
+}
+export const createPageTool = {
+    name: 'wiki_create_page',
+    description: 'Create a new wiki page. Fails if the page already exists (use wiki_edit_page to update existing pages).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            pagename: {
+                type: 'string',
+                description: 'Page name in Group.Name or Group/Name format',
+            },
+            content: {
+                type: 'string',
+                description: 'Page content in PmWiki markup format',
+            },
+            summary: {
+                type: 'string',
+                description: 'Edit summary describing the change (optional)',
+            },
+        },
+        required: ['pagename', 'content'],
+    },
+};
+//# sourceMappingURL=createPage.js.map

package/dist/tools/createPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPage.js","sourceRoot":"","sources":["../../src/tools/createPage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAC9E,CAAC,CAAC;AAUH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAkB,EAClB,KAAsB;IAEtB,sCAAsC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CACpC,QAAQ,EACR,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,OAAO,CACd,CAAC;IACF,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,QAAQ,MAAM,CAAC,QAAQ,uBAAuB;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,yGAAyG;IAC3G,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;KAClC;CACF,CAAC"}

package/dist/tools/editPage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * wiki_edit_page tool - Edit an existing wiki page
+ */
+import { z } from 'zod';
+import { WikiClient } from '../api/wikiClient.js';
+export declare const editPageSchema: z.ZodObject<{
+    pagename: z.ZodString;
+    content: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    pagename: string;
+    summary?: string | undefined;
+}, {
+    content: string;
+    pagename: string;
+    summary?: string | undefined;
+}>;
+export type EditPageInput = z.infer<typeof editPageSchema>;
+export interface EditPageResult {
+    pagename: string;
+    action: string;
+    message: string;
+}
+export declare function editPage(client: WikiClient, input: EditPageInput): Promise<EditPageResult>;
+export declare const editPageTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            pagename: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            summary: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=editPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editPage.d.ts","sourceRoot":"","sources":["../../src/tools/editPage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;;;EAMzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,CAAC,CASzB;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;CAsBxB,CAAC"}

package/dist/tools/editPage.js

@@ -0,0 +1,44 @@
+/**
+ * wiki_edit_page tool - Edit an existing wiki page
+ */
+import { z } from 'zod';
+export const editPageSchema = z.object({
+    pagename: z
+        .string()
+        .describe('Page name in Group.Name or Group/Name format'),
+    content: z.string().describe('New page content in PmWiki markup format'),
+    summary: z.string().optional().describe('Edit summary describing the change'),
+});
+export async function editPage(client, input) {
+    // Normalize pagename (convert / to .)
+    const pagename = input.pagename.replace('/', '.');
+    const result = await client.editPage(pagename, input.content, input.summary);
+    return {
+        pagename: result.pagename,
+        action: result.action,
+        message: `Page ${result.pagename} ${result.action} successfully`,
+    };
+}
+export const editPageTool = {
+    name: 'wiki_edit_page',
+    description: 'Edit an existing wiki page. Replaces the entire page content. If the page does not exist, it will be created.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            pagename: {
+                type: 'string',
+                description: 'Page name in Group.Name or Group/Name format',
+            },
+            content: {
+                type: 'string',
+                description: 'New page content in PmWiki markup format',
+            },
+            summary: {
+                type: 'string',
+                description: 'Edit summary describing the change (optional)',
+            },
+        },
+        required: ['pagename', 'content'],
+    },
+};
+//# sourceMappingURL=editPage.js.map

package/dist/tools/editPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editPage.js","sourceRoot":"","sources":["../../src/tools/editPage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACxE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAC9E,CAAC,CAAC;AAUH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAkB,EAClB,KAAoB;IAEpB,sCAAsC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7E,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,QAAQ,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,eAAe;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,+GAA+G;IACjH,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;KAClC;CACF,CAAC"}

package/dist/tools/findPages.d.ts

@@ -0,0 +1,50 @@
+/**
+ * wiki_find_pages tool - Search for pages by name or content
+ */
+import { z } from 'zod';
+import { WikiClient, SearchResult } from '../api/wikiClient.js';
+export declare const findPagesSchema: z.ZodObject<{
+    query: z.ZodString;
+    group: z.ZodOptional<z.ZodString>;
+    nameOnly: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    group?: string | undefined;
+    limit?: number | undefined;
+    nameOnly?: boolean | undefined;
+}, {
+    query: string;
+    group?: string | undefined;
+    limit?: number | undefined;
+    nameOnly?: boolean | undefined;
+}>;
+export type FindPagesInput = z.infer<typeof findPagesSchema>;
+export declare function findPages(client: WikiClient, input: FindPagesInput): Promise<SearchResult[]>;
+export declare const findPagesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            group: {
+                type: string;
+                description: string;
+            };
+            nameOnly: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=findPages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findPages.d.ts","sourceRoot":"","sources":["../../src/tools/findPages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEhE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAW1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,wBAAsB,SAAS,CAC7B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAMzB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;CA0BzB,CAAC"}

package/dist/tools/findPages.js

@@ -0,0 +1,50 @@
+/**
+ * wiki_find_pages tool - Search for pages by name or content
+ */
+import { z } from 'zod';
+export const findPagesSchema = z.object({
+    query: z.string().describe('Search query to find pages'),
+    group: z.string().optional().describe('Limit search to a specific group'),
+    nameOnly: z
+        .boolean()
+        .optional()
+        .describe('If true, only search page names, not content'),
+    limit: z
+        .number()
+        .optional()
+        .describe('Maximum number of results to return (default: 50)'),
+});
+export async function findPages(client, input) {
+    return client.searchPages(input.query, {
+        group: input.group,
+        nameOnly: input.nameOnly,
+        limit: input.limit,
+    });
+}
+export const findPagesTool = {
+    name: 'wiki_find_pages',
+    description: 'Search for wiki pages by name or content. Returns matching pages with snippets showing where the query was found.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search query to find pages',
+            },
+            group: {
+                type: 'string',
+                description: 'Limit search to a specific group (optional)',
+            },
+            nameOnly: {
+                type: 'boolean',
+                description: 'If true, only search page names, not content (optional)',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 50)',
+            },
+        },
+        required: ['query'],
+    },
+};
+//# sourceMappingURL=findPages.js.map

package/dist/tools/findPages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findPages.js","sourceRoot":"","sources":["../../src/tools/findPages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACzE,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;CACjE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAkB,EAClB,KAAqB;IAErB,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE;QACrC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,mHAAmH;IACrH,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,yDAAyD;aACvE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC"}

package/dist/tools/listPages.d.ts

@@ -0,0 +1,36 @@
+/**
+ * wiki_list_pages tool - List pages in a group
+ */
+import { z } from 'zod';
+import { WikiClient, PageListItem } from '../api/wikiClient.js';
+export declare const listPagesSchema: z.ZodObject<{
+    group: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    group?: string | undefined;
+    limit?: number | undefined;
+}, {
+    group?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type ListPagesInput = z.infer<typeof listPagesSchema>;
+export declare function listPages(client: WikiClient, input: ListPagesInput): Promise<PageListItem[]>;
+export declare const listPagesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            group: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+//# sourceMappingURL=listPages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listPages.d.ts","sourceRoot":"","sources":["../../src/tools/listPages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEhE,eAAO,MAAM,eAAe;;;;;;;;;EAM1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,wBAAsB,SAAS,CAC7B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAEzB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAkBzB,CAAC"}

package/dist/tools/listPages.js

@@ -0,0 +1,33 @@
+/**
+ * wiki_list_pages tool - List pages in a group
+ */
+import { z } from 'zod';
+export const listPagesSchema = z.object({
+    group: z.string().optional().describe('Group to list pages from'),
+    limit: z
+        .number()
+        .optional()
+        .describe('Maximum number of pages to return (default: 100)'),
+});
+export async function listPages(client, input) {
+    return client.listPages(input.group, input.limit);
+}
+export const listPagesTool = {
+    name: 'wiki_list_pages',
+    description: 'List wiki pages, optionally filtered by group. Returns page names, titles, and metadata sorted by most recently modified.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            group: {
+                type: 'string',
+                description: 'Group to list pages from (optional, lists all if omitted)',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of pages to return (default: 100)',
+            },
+        },
+        required: [],
+    },
+};
+//# sourceMappingURL=listPages.js.map

package/dist/tools/listPages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listPages.js","sourceRoot":"","sources":["../../src/tools/listPages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACjE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAkB,EAClB,KAAqB;IAErB,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,2HAA2H;IAC7H,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACF,CAAC"}

package/dist/tools/readPage.d.ts

@@ -0,0 +1,37 @@
+/**
+ * wiki_read_page tool - Read a wiki page's content
+ */
+import { z } from 'zod';
+import { WikiClient, WikiPage } from '../api/wikiClient.js';
+export declare const readPageSchema: z.ZodObject<{
+    pagename: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<["raw", "markdown", "html"]>>;
+}, "strip", z.ZodTypeAny, {
+    pagename: string;
+    format?: "raw" | "markdown" | "html" | undefined;
+}, {
+    pagename: string;
+    format?: "raw" | "markdown" | "html" | undefined;
+}>;
+export type ReadPageInput = z.infer<typeof readPageSchema>;
+export declare function readPage(client: WikiClient, input: ReadPageInput): Promise<WikiPage>;
+export declare const readPageTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            pagename: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=readPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readPage.d.ts","sourceRoot":"","sources":["../../src/tools/readPage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;;;;;;EAQzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,QAAQ,CAAC,CAInB;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;CAoBxB,CAAC"}

package/dist/tools/readPage.js

@@ -0,0 +1,38 @@
+/**
+ * wiki_read_page tool - Read a wiki page's content
+ */
+import { z } from 'zod';
+export const readPageSchema = z.object({
+    pagename: z
+        .string()
+        .describe('Page name in Group.Name or Group/Name format'),
+    format: z
+        .enum(['raw', 'markdown', 'html'])
+        .optional()
+        .describe('Output format: raw (PmWiki markup), markdown, or html'),
+});
+export async function readPage(client, input) {
+    // Normalize pagename (convert / to .)
+    const pagename = input.pagename.replace('/', '.');
+    return client.readPage(pagename, input.format || 'raw');
+}
+export const readPageTool = {
+    name: 'wiki_read_page',
+    description: "Read a wiki page's content. Returns the page text along with metadata like title, author, and last modified time.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            pagename: {
+                type: 'string',
+                description: 'Page name in Group.Name or Group/Name format',
+            },
+            format: {
+                type: 'string',
+                enum: ['raw', 'markdown', 'html'],
+                description: 'Output format: raw (PmWiki markup), markdown, or html (default: raw)',
+            },
+        },
+        required: ['pagename'],
+    },
+};
+//# sourceMappingURL=readPage.js.map

package/dist/tools/readPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readPage.js","sourceRoot":"","sources":["../../src/tools/readPage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;SACjC,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;CACrE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAkB,EAClB,KAAoB;IAEpB,sCAAsC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,mHAAmH;IACrH,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC;gBACjC,WAAW,EACT,sEAAsE;aACzE;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;CACF,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "pmwiki-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for PmWiki - enables AI agents to read, create, and edit wiki pages",
+  "main": "dist/index.js",
+  "bin": {
+    "pmwiki-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "pmwiki",
+    "wiki",
+    "claude",
+    "ai",
+    "model-context-protocol"
+  ],
+  "author": "Mike Lee",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/milee98/pmwiki"
+  }
+}