@zuwiki/mcp 0.1.0

package/dist/cli.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import { startStdio } from "./transports/stdio.js";
+import { startHttp } from "./transports/http.js";
+const DEFAULT_BASE_URL = "https://zuwiki.com";
+function parseArgs(argv) {
+    const opts = {
+        http: false,
+        host: process.env.ZUWIKI_HTTP_HOST ?? "127.0.0.1",
+        port: parseIntEnv(process.env.ZUWIKI_HTTP_PORT, 3333),
+        baseUrl: process.env.ZUWIKI_BASE_URL ?? DEFAULT_BASE_URL,
+        organizationId: process.env.ZUWIKI_ORGANIZATION_ID ?? null,
+        credentialsPath: process.env.ZUWIKI_CREDENTIALS_PATH,
+        organizationsPath: process.env.ZUWIKI_ORGANIZATIONS_PATH,
+        path: process.env.ZUWIKI_HTTP_PATH ?? "/mcp",
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+        else if (arg === "--http") {
+            opts.http = true;
+        }
+        else if (arg === "--stdio") {
+            opts.http = false;
+        }
+        else if (arg === "--host") {
+            opts.host = requireValue(argv, ++i, arg);
+        }
+        else if (arg === "--port") {
+            opts.port = parseRequiredInt(requireValue(argv, ++i, arg), arg);
+        }
+        else if (arg === "--base-url") {
+            opts.baseUrl = requireValue(argv, ++i, arg);
+        }
+        else if (arg === "--organization" || arg === "--org") {
+            opts.organizationId = requireValue(argv, ++i, arg);
+        }
+        else if (arg === "--credentials") {
+            opts.credentialsPath = requireValue(argv, ++i, arg);
+        }
+        else if (arg === "--organizations-path") {
+            opts.organizationsPath = requireValue(argv, ++i, arg);
+        }
+        else if (arg === "--path") {
+            opts.path = requireValue(argv, ++i, arg);
+        }
+        else {
+            process.stderr.write(`Unknown argument: ${arg}\n`);
+            printHelp();
+            process.exit(2);
+        }
+    }
+    return opts;
+}
+function requireValue(argv, index, flag) {
+    const value = argv[index];
+    if (typeof value !== "string") {
+        process.stderr.write(`Missing value for ${flag}.\n`);
+        process.exit(2);
+    }
+    return value;
+}
+function parseIntEnv(value, fallback) {
+    if (!value)
+        return fallback;
+    const n = Number(value);
+    if (!Number.isFinite(n) || !Number.isInteger(n))
+        return fallback;
+    return n;
+}
+function parseRequiredInt(value, flag) {
+    const n = Number(value);
+    if (!Number.isFinite(n) || !Number.isInteger(n)) {
+        process.stderr.write(`Value for ${flag} must be an integer.\n`);
+        process.exit(2);
+    }
+    return n;
+}
+function printHelp() {
+    process.stderr.write([
+        "Zuwiki MCP Server",
+        "",
+        "Usage:",
+        "  zuwiki-mcp [options]",
+        "",
+        "Options:",
+        "  --http                   Use streamable HTTP transport instead of stdio",
+        "  --host <host>            HTTP host (default: 127.0.0.1)",
+        "  --port <port>            HTTP port (default: 3333)",
+        "  --path <path>            HTTP path (default: /mcp)",
+        "  --base-url <url>         Zuwiki base URL (default: https://zuwiki.com)",
+        "  --organization <id>      Active organization id",
+        "  --credentials <path>     Path to the credentials file",
+        "  --organizations-path <p> Override the API path for the organizations list",
+        "  --help                   Show this help",
+        "",
+        "In stdio mode the OAuth browser flow runs on the first start.",
+        "In HTTP mode the MCP client must send a bearer token on every request via the Authorization header.",
+        "",
+    ].join("\n"));
+}
+async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    if (opts.http) {
+        await startHttp({
+            baseUrl: opts.baseUrl,
+            host: opts.host,
+            port: opts.port,
+            organizationId: opts.organizationId,
+            organizationsPath: opts.organizationsPath,
+            path: opts.path,
+        });
+        return;
+    }
+    await startStdio({
+        baseUrl: opts.baseUrl,
+        organizationId: opts.organizationId,
+        credentialsPath: opts.credentialsPath,
+        organizationsPath: opts.organizationsPath,
+    });
+}
+main().catch((err) => {
+    process.stderr.write(`Startup error: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,15 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AuthManager, OrganizationState } from "./auth/client.js";
+export interface BuildServerOptions {
+    baseUrl: string;
+    authManager?: AuthManager;
+    organizationId?: string | null;
+    organizationsPath?: string;
+    /** If set, the token is read from this callback on every request instead of from the AuthManager. */
+    perRequestToken?: () => string | null;
+}
+export interface BuiltServer {
+    server: McpServer;
+    organizationState: OrganizationState;
+}
+export declare function buildServer(opts: BuildServerOptions): BuiltServer;

package/dist/server.js

@@ -0,0 +1,53 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { OrganizationState } from "./auth/client.js";
+import { registerTools } from "./tools/register.js";
+export function buildServer(opts) {
+    const server = new McpServer({
+        name: "zuwiki-mcp",
+        version: "0.1.0",
+    }, {
+        capabilities: {
+            tools: { listChanged: false },
+        },
+        instructions: "Zuwiki MCP Server. Use the zuwiki_ tools to read and edit wikis, categories and pages. First pick an organization to work in via zuwiki_list_organizations and zuwiki_set_active_organization, then explore the existing structure with zuwiki_list_wikis and zuwiki_get_wiki_editor.",
+    });
+    const organizationState = new OrganizationState(opts.organizationId ?? null);
+    const contextFactory = (extra) => {
+        const apiContext = {
+            baseUrl: opts.baseUrl,
+            organizationId: organizationState.get(),
+            async getAccessToken() {
+                if (opts.perRequestToken) {
+                    const token = opts.perRequestToken();
+                    if (!token) {
+                        throw new Error("No bearer token on the current request. Send an Authorization header.");
+                    }
+                    return token;
+                }
+                const fromExtra = extra.authInfo?.token;
+                if (fromExtra)
+                    return fromExtra;
+                if (opts.authManager)
+                    return opts.authManager.ensureAccessToken();
+                throw new Error("No token source configured.");
+            },
+            async invalidateAndRefreshToken() {
+                if (opts.perRequestToken) {
+                    throw new Error("Cannot refresh: the bearer token is supplied per request by the HTTP client. The client must send a new token.");
+                }
+                if (opts.authManager)
+                    return opts.authManager.invalidateAndRefresh();
+                throw new Error("No token source configured.");
+            },
+        };
+        return apiContext;
+    };
+    registerTools({
+        server,
+        contextFactory,
+        organizationState,
+        organizationsPath: opts.organizationsPath,
+    });
+    return { server, organizationState };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAe,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAiB5E,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;SAC9B;QACD,YAAY,EACV,uRAAuR;KAC1R,CACF,CAAC;IAEF,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC;IAE7E,MAAM,cAAc,GAAsB,CAAC,KAAK,EAAE,EAAE;QAClD,MAAM,UAAU,GAAe;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,cAAc,EAAE,iBAAiB,CAAC,GAAG,EAAE;YACvC,KAAK,CAAC,cAAc;gBAClB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;oBACzB,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;oBACrC,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;oBACJ,CAAC;oBACD,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;gBACxC,IAAI,SAAS;oBAAE,OAAO,SAAS,CAAC;gBAChC,IAAI,IAAI,CAAC,WAAW;oBAAE,OAAO,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;gBAClE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjD,CAAC;YACD,KAAK,CAAC,yBAAyB;gBAC7B,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;oBACzB,MAAM,IAAI,KAAK,CACb,gHAAgH,CACjH,CAAC;gBACJ,CAAC;gBACD,IAAI,IAAI,CAAC,WAAW;oBAAE,OAAO,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE,CAAC;gBACrE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjD,CAAC;SACF,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;IAEF,aAAa,CAAC;QACZ,MAAM;QACN,cAAc;QACd,iBAAiB;QACjB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;KAC1C,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;AACvC,CAAC"}

package/dist/tools/register.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import type { ApiContext } from "../api/types.js";
+import { OrganizationState } from "../auth/client.js";
+export type ApiContextFactory = (extra: RequestHandlerExtra<any, any>) => ApiContext;
+export interface RegisterToolsOptions {
+    server: McpServer;
+    contextFactory: ApiContextFactory;
+    organizationState: OrganizationState;
+    organizationsPath?: string;
+}
+export declare function registerTools(opts: RegisterToolsOptions): void;

package/dist/tools/register.js

@@ -0,0 +1,244 @@
+import { z } from "zod";
+import { createWiki, deleteWiki, getWiki, getWikiEditor, listWikis, updateWiki, } from "../api/wikis.js";
+import { createCategory, deleteCategory, renameCategory, } from "../api/categories.js";
+import { createPage, deletePage, getPageContent, getPageHistory, getPageSettings, renamePage, restorePageHistory, setPageStatus, updatePageContent, updatePageSettings, } from "../api/pages.js";
+import { listOrganizations } from "../api/organizations.js";
+import { runTool } from "./shared.js";
+const visibilityEnum = z.enum([
+    "PUBLIC",
+    "PRIVATE_ACCOUNT",
+    "PRIVATE_PASSWORD",
+    "PRIVATE_EMAIL_DOMAIN",
+]);
+const statusEnum = z.enum(["DRAFT", "PUBLISHED"]);
+export function registerTools(opts) {
+    const { server, contextFactory, organizationState } = opts;
+    // Organization Tools
+    server.registerTool("zuwiki_list_organizations", {
+        title: "List organizations",
+        description: "Lists every organization the currently signed in Zuwiki user is a member of. Use this when no active organization is set yet or when you want to switch. Returns the id and name of each organization.",
+        inputSchema: {},
+    }, async (_args, extra) => {
+        return runTool(async () => {
+            const ctx = contextFactory(extra);
+            return listOrganizations(ctx, opts.organizationsPath);
+        });
+    });
+    server.registerTool("zuwiki_set_active_organization", {
+        title: "Set active organization",
+        description: "Sets the organization whose wikis will be operated on. All subsequent tool calls use this id as the x-organization-id header. The value persists for the lifetime of this server instance only.",
+        inputSchema: {
+            organizationId: z
+                .string()
+                .min(1)
+                .describe("ID of the organization whose wikis should be operated on."),
+        },
+    }, async ({ organizationId }) => {
+        organizationState.set(organizationId);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Active organization is now ${organizationId}.`,
+                },
+            ],
+        };
+    });
+    server.registerTool("zuwiki_get_active_organization", {
+        title: "Get active organization",
+        description: "Returns the organization id currently used for wiki operations. Returns null if none has been set yet.",
+        inputSchema: {},
+    }, async () => ({
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ organizationId: organizationState.get() }, null, 2),
+            },
+        ],
+    }));
+    // Wiki Read Tools
+    server.registerTool("zuwiki_list_wikis", {
+        title: "List wikis",
+        description: "Lists all wikis in the active organization. Use this tool to find the wikiId for further calls.",
+        inputSchema: {},
+    }, async (_args, extra) => runTool(async () => listWikis(contextFactory(extra))));
+    server.registerTool("zuwiki_get_wiki", {
+        title: "Get wiki details",
+        description: "Returns metadata of a wiki such as title and slug. For the full structure including categories and pages use zuwiki_get_wiki_editor instead.",
+        inputSchema: {
+            wikiId: z.string().min(1).describe("ID of the wiki"),
+        },
+    }, async ({ wikiId }, extra) => runTool(async () => getWiki(contextFactory(extra), wikiId)));
+    server.registerTool("zuwiki_get_wiki_editor", {
+        title: "Get wiki structure tree",
+        description: "Returns a snapshot of the entire wiki structure: all categories, root pages, nested pages and root links. This is the fastest way to get an overview of how a wiki is organized before editing individual pages.",
+        inputSchema: {
+            wikiId: z.string().min(1).describe("ID of the wiki"),
+        },
+    }, async ({ wikiId }, extra) => runTool(async () => getWikiEditor(contextFactory(extra), wikiId)));
+    // Wiki Write Tools
+    server.registerTool("zuwiki_create_wiki", {
+        title: "Create wiki",
+        description: "Creates a new wiki in the active organization. The slug is derived from the title by the server.",
+        inputSchema: {
+            title: z.string().min(1).describe("Display name of the new wiki"),
+        },
+    }, async ({ title }, extra) => runTool(async () => createWiki(contextFactory(extra), title)));
+    server.registerTool("zuwiki_update_wiki", {
+        title: "Update wiki",
+        description: "Updates the title and/or slug of a wiki. At least one of the fields must be provided.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            title: z.string().min(1).optional(),
+            slug: z.string().min(1).optional(),
+        },
+    }, async ({ wikiId, title, slug }, extra) => runTool(async () => {
+        if (title === undefined && slug === undefined) {
+            throw new Error("At least one of title or slug must be provided.");
+        }
+        return updateWiki(contextFactory(extra), wikiId, { title, slug });
+    }));
+    server.registerTool("zuwiki_delete_wiki", {
+        title: "Delete wiki",
+        description: "Deletes an entire wiki including all categories, pages and history entries. This operation cannot be undone.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+        },
+    }, async ({ wikiId }, extra) => runTool(async () => deleteWiki(contextFactory(extra), wikiId)));
+    // Category Write Tools
+    server.registerTool("zuwiki_create_category", {
+        title: "Create category",
+        description: "Creates a new category inside a wiki. Categories group pages and appear as containers in the sidebar.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            name: z.string().min(1).describe("Display name of the category"),
+        },
+    }, async ({ wikiId, name }, extra) => runTool(async () => createCategory(contextFactory(extra), wikiId, name)));
+    server.registerTool("zuwiki_rename_category", {
+        title: "Rename category",
+        description: "Renames an existing category.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            categoryId: z.string().min(1),
+            name: z.string().min(1),
+        },
+    }, async ({ wikiId, categoryId, name }, extra) => runTool(async () => renameCategory(contextFactory(extra), wikiId, categoryId, name)));
+    server.registerTool("zuwiki_delete_category", {
+        title: "Delete category",
+        description: "Deletes a category. Pages inside the category lose their category assignment and become root pages.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            categoryId: z.string().min(1),
+        },
+    }, async ({ wikiId, categoryId }, extra) => runTool(async () => deleteCategory(contextFactory(extra), wikiId, categoryId)));
+    // Page Metadata Tools
+    server.registerTool("zuwiki_create_page", {
+        title: "Create page",
+        description: "Creates a new page inside a wiki. If categoryId is provided, the page is placed inside that category. If null or omitted, the page is created as a root page.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            title: z.string().min(1),
+            categoryId: z.string().nullable().optional(),
+        },
+    }, async ({ wikiId, title, categoryId }, extra) => runTool(async () => createPage(contextFactory(extra), wikiId, {
+        title,
+        categoryId: categoryId ?? null,
+    })));
+    server.registerTool("zuwiki_rename_page", {
+        title: "Rename page",
+        description: "Changes the title of a page. Content and history are preserved.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            pageId: z.string().min(1),
+            title: z.string().min(1),
+        },
+    }, async ({ wikiId, pageId, title }, extra) => runTool(async () => renamePage(contextFactory(extra), wikiId, pageId, title)));
+    server.registerTool("zuwiki_delete_page", {
+        title: "Delete page",
+        description: "Deletes a page including its history. This operation cannot be undone.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            pageId: z.string().min(1),
+        },
+    }, async ({ wikiId, pageId }, extra) => runTool(async () => deletePage(contextFactory(extra), wikiId, pageId)));
+    // Page Content Tools
+    server.registerTool("zuwiki_get_page_content", {
+        title: "Read page content",
+        description: "Reads the current Markdown content of a page. The response contains a content field with the raw Markdown.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            pageId: z.string().min(1),
+        },
+    }, async ({ wikiId, pageId }, extra) => runTool(async () => getPageContent(contextFactory(extra), wikiId, pageId)));
+    server.registerTool("zuwiki_update_page_content", {
+        title: "Save page content",
+        description: "Overwrites the Markdown content of a page. The server automatically creates a history entry on every save, so older revisions can be restored later via zuwiki_get_page_history and zuwiki_restore_page_history.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            pageId: z.string().min(1),
+            content: z.string().describe("Complete new Markdown content of the page"),
+        },
+    }, async ({ wikiId, pageId, content }, extra) => runTool(async () => updatePageContent(contextFactory(extra), wikiId, pageId, content)));
+    // Page Settings Tools
+    server.registerTool("zuwiki_get_page_settings", {
+        title: "Read page settings",
+        description: "Reads the settings of a page such as slug, visibility, SEO fields and icon.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            pageId: z.string().min(1),
+        },
+    }, async ({ wikiId, pageId }, extra) => runTool(async () => getPageSettings(contextFactory(extra), wikiId, pageId)));
+    server.registerTool("zuwiki_update_page_settings", {
+        title: "Update page settings",
+        description: "Updates arbitrary settings of a page. All fields are optional, only provided values are changed. pageVisibility controls the access level.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            pageId: z.string().min(1),
+            title: z.string().min(1).optional(),
+            slug: z.string().min(1).optional(),
+            hidden: z.boolean().optional(),
+            pageVisibility: visibilityEnum.optional(),
+            seoTitle: z.string().optional(),
+            seoDescription: z.string().optional(),
+            seoKeywords: z.string().optional(),
+            icon: z.string().optional(),
+        },
+    }, async (args, extra) => {
+        return runTool(async () => {
+            const { wikiId, pageId, ...patch } = args;
+            const clean = Object.fromEntries(Object.entries(patch).filter(([, v]) => v !== undefined));
+            if (Object.keys(clean).length === 0) {
+                throw new Error("At least one settings field must be provided.");
+            }
+            return updatePageSettings(contextFactory(extra), wikiId, pageId, clean);
+        });
+    });
+    server.registerTool("zuwiki_set_page_status", {
+        title: "Set page status",
+        description: "Sets the publication status of a page. DRAFT means the page is only visible to editors, PUBLISHED makes it available according to its pageVisibility.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            pageId: z.string().min(1),
+            status: statusEnum,
+        },
+    }, async ({ wikiId, pageId, status }, extra) => runTool(async () => setPageStatus(contextFactory(extra), wikiId, pageId, status)));
+    // Page History Tools
+    server.registerTool("zuwiki_get_page_history", {
+        title: "Read page history",
+        description: "Returns every history entry of a page including timestamp and author. Use the historyId of an entry together with zuwiki_restore_page_history to restore that revision.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            pageId: z.string().min(1),
+        },
+    }, async ({ wikiId, pageId }, extra) => runTool(async () => getPageHistory(contextFactory(extra), wikiId, pageId)));
+    server.registerTool("zuwiki_restore_page_history", {
+        title: "Restore historical revision",
+        description: "Restores a previous content version of a page. The current content is saved as a new history entry first.",
+        inputSchema: {
+            wikiId: z.string().min(1),
+            pageId: z.string().min(1),
+            historyId: z.string().min(1),
+        },
+    }, async ({ wikiId, pageId, historyId }, extra) => runTool(async () => restorePageHistory(contextFactory(extra), wikiId, pageId, historyId)));
+}
+//# sourceMappingURL=register.js.map

package/dist/tools/register.js.map

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

package/dist/tools/shared.d.ts

@@ -0,0 +1,5 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare function jsonResult(value: unknown): CallToolResult;
+export declare function errorResult(message: string): CallToolResult;
+export declare function formatApiError(err: unknown): string;
+export declare function runTool<T>(fn: () => Promise<T>): Promise<CallToolResult>;

package/dist/tools/shared.js

@@ -0,0 +1,38 @@
+import { ApiError } from "../api/types.js";
+export function jsonResult(value) {
+    const text = typeof value === "string" ? value : JSON.stringify(value, null, 2);
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+export function errorResult(message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+    };
+}
+export function formatApiError(err) {
+    if (err instanceof ApiError) {
+        if (err.code === "insufficient_scope") {
+            return `Request rejected because of insufficient scope. The current token does not carry the required permission. ${err.message}`;
+        }
+        if (err.code === "forbidden_or_not_member") {
+            return `403 received. Either the user is not a member of the active organization or the action is not allowed. ${err.message}`;
+        }
+        if (err.code === "no_active_organization") {
+            return err.message;
+        }
+        return err.message;
+    }
+    return err.message ?? String(err);
+}
+export async function runTool(fn) {
+    try {
+        const value = await fn();
+        return jsonResult(value ?? { ok: true });
+    }
+    catch (err) {
+        return errorResult(formatApiError(err));
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;YACtC,OAAO,6GAA6G,GAAG,CAAC,OAAO,EAAE,CAAC;QACpI,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;YAC3C,OAAO,0GAA0G,GAAG,CAAC,OAAO,EAAE,CAAC;QACjI,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;YAC1C,OAAO,GAAG,CAAC,OAAO,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,OAAQ,GAAa,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,EAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/transports/http.d.ts

@@ -0,0 +1,9 @@
+export interface HttpTransportOptions {
+    baseUrl: string;
+    host: string;
+    port: number;
+    organizationId: string | null;
+    organizationsPath?: string;
+    path?: string;
+}
+export declare function startHttp(opts: HttpTransportOptions): Promise<void>;