@theyahia/megaplan-mcp 3.0.0 → 4.0.0

package/dist/http.js

@@ -0,0 +1,152 @@
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import { randomUUID } from "node:crypto";
+import { TOOL_COUNT, PROMPT_COUNT } from "./meta.js";
+/** Close a transport without caring about the result (sync throw or async rejection). */
+function closeQuietly(transport) {
+    void Promise.resolve()
+        .then(() => transport.close())
+        .catch(() => {
+        /* ignore */
+    });
+}
+export async function startHttpServer(createMcpServer, port) {
+    const host = process.env.HOST ?? "127.0.0.1";
+    // Fail closed: this server proxies live Megaplan credentials, so refuse to
+    // start --http without an auth token rather than expose tools unauthenticated.
+    const httpToken = process.env.MCP_HTTP_TOKEN;
+    if (!httpToken) {
+        throw new Error("MCP_HTTP_TOKEN must be set for --http mode (refusing to expose Megaplan tools without authentication).");
+    }
+    const allowedHosts = (process.env.MCP_HTTP_ALLOWED_HOSTS ?? `127.0.0.1:${port},localhost:${port}`)
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const maxSessions = Number(process.env.MCP_HTTP_MAX_SESSIONS ?? 100);
+    const idleMs = Number(process.env.MCP_HTTP_SESSION_TTL_MS ?? 30 * 60 * 1000);
+    const app = express();
+    app.use(express.json({ limit: process.env.MCP_HTTP_BODY_LIMIT ?? "1mb" }));
+    // Bearer auth in front of every /mcp route.
+    app.use("/mcp", (req, res, next) => {
+        if (req.headers.authorization !== `Bearer ${httpToken}`) {
+            res.status(401).json({ error: "unauthorized" });
+            return;
+        }
+        next();
+    });
+    const transports = new Map();
+    // Evict idle/abandoned sessions so the map (and its live transports) can't grow without bound.
+    const sweep = setInterval(() => {
+        const now = Date.now();
+        for (const [id, session] of transports) {
+            if (now - session.lastSeen > idleMs) {
+                closeQuietly(session.transport);
+                transports.delete(id);
+            }
+        }
+    }, 60_000);
+    sweep.unref?.();
+    app.post("/mcp", async (req, res) => {
+        try {
+            const sessionId = req.headers["mcp-session-id"];
+            if (sessionId && transports.has(sessionId)) {
+                const session = transports.get(sessionId);
+                session.lastSeen = Date.now();
+                await session.transport.handleRequest(req, res, req.body);
+                return;
+            }
+            if (transports.size >= maxSessions) {
+                res.status(503).json({ error: "too many sessions" });
+                return;
+            }
+            const newSessionId = randomUUID();
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => newSessionId,
+                enableDnsRebindingProtection: true,
+                allowedHosts,
+                allowedOrigins: [],
+            });
+            transport.onclose = () => transports.delete(newSessionId);
+            // A fresh McpServer per session (an McpServer is 1:1 with a transport).
+            await createMcpServer().connect(transport);
+            transports.set(newSessionId, { transport, lastSeen: Date.now() });
+            try {
+                await transport.handleRequest(req, res, req.body);
+            }
+            catch (error) {
+                // Roll back the session we just created if the first request failed.
+                transports.delete(newSessionId);
+                closeQuietly(transport);
+                throw error;
+            }
+        }
+        catch (error) {
+            console.error("[megaplan-mcp] POST /mcp error:", error);
+            if (!res.headersSent)
+                res.status(500).json({ error: "internal error" });
+        }
+    });
+    app.get("/mcp", async (req, res) => {
+        try {
+            const sessionId = req.headers["mcp-session-id"];
+            if (!sessionId || !transports.has(sessionId)) {
+                res.status(400).json({ error: "No valid session. POST /mcp first." });
+                return;
+            }
+            const session = transports.get(sessionId);
+            session.lastSeen = Date.now();
+            await session.transport.handleRequest(req, res);
+        }
+        catch (error) {
+            console.error("[megaplan-mcp] GET /mcp error:", error);
+            if (!res.headersSent)
+                res.status(500).json({ error: "internal error" });
+        }
+    });
+    app.delete("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        const session = sessionId ? transports.get(sessionId) : undefined;
+        if (!session) {
+            res.status(200).end();
+            return;
+        }
+        try {
+            await session.transport.handleRequest(req, res);
+        }
+        catch (error) {
+            console.error("[megaplan-mcp] DELETE /mcp error:", error);
+            if (!res.headersSent)
+                res.status(500).json({ error: "internal error" });
+        }
+        finally {
+            // Always tear down the session, even if handleRequest threw.
+            closeQuietly(session.transport);
+            transports.delete(sessionId);
+        }
+    });
+    app.get("/health", (_req, res) => {
+        res.json({ status: "ok", tools: TOOL_COUNT, prompts: PROMPT_COUNT, sessions: transports.size });
+    });
+    // Body-parser / payload-size error handler (must be last, 4-arg signature).
+    app.use((err, _req, res, next) => {
+        if (!err) {
+            next();
+            return;
+        }
+        const tooLarge = err.type === "entity.too.large";
+        console.error("[megaplan-mcp] request error:", err);
+        if (!res.headersSent)
+            res.status(tooLarge ? 413 : 400).json({ error: "bad request" });
+    });
+    return new Promise((resolve) => {
+        const httpServer = app.listen(port, host, () => {
+            const bound = httpServer.address();
+            const shownPort = typeof bound === "object" && bound ? bound.port : port;
+            console.error(`[megaplan-mcp] HTTP server on http://${host}:${shownPort}/mcp (Streamable HTTP, auth required)`);
+            console.error(`[megaplan-mcp] Health: http://${host}:${shownPort}/health`);
+            resolve(httpServer);
+        });
+        httpServer.on("close", () => clearInterval(sweep));
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -1,14 +1,3 @@
 #!/usr/bin/env node
-/**
- * @theyahia/megaplan-mcp — MCP server for Megaplan project management
- *
- * 8 tools + 2 MCP prompts for tasks, deals, projects, employees, comments.
- *
- * Auth: Bearer token (MEGAPLAN_TOKEN) OR Password grant (MEGAPLAN_LOGIN + MEGAPLAN_PASSWORD).
- *
- * Transports:
- *   - stdio (default) — for Claude Desktop / Cursor / Windsurf
- *   - Streamable HTTP — --http flag or HTTP_PORT env (port 3000 default)
- */
-export {};
-//# sourceMappingURL=index.d.ts.map
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/index.js

@@ -1,26 +1,100 @@
 #!/usr/bin/env node
-/**
- * @theyahia/megaplan-mcp — MCP server for Megaplan project management
- *
- * 8 tools + 2 MCP prompts for tasks, deals, projects, employees, comments.
- *
- * Auth: Bearer token (MEGAPLAN_TOKEN) OR Password grant (MEGAPLAN_LOGIN + MEGAPLAN_PASSWORD).
- *
- * Transports:
- *   - stdio (default) — for Claude Desktop / Cursor / Windsurf
- *   - Streamable HTTP — --http flag or HTTP_PORT env (port 3000 default)
- */
-import { runServer } from "@theyahia/mcp-core";
-import { createServer, TOOL_COUNT, logger } from "./server.js";
-runServer(createServer, {
-    name: "megaplan-mcp",
-    version: "2.0.0",
-    toolCount: TOOL_COUNT,
-    logger,
-}).catch((error) => {
-    logger.error("Fatal error", {
-        error: error instanceof Error ? error.message : String(error),
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { fileURLToPath } from "node:url";
+import { realpathSync } from "node:fs";
+import { TOOL_COUNT, PROMPT_COUNT } from "./meta.js";
+import { getTasksSchema, handleGetTasks, getTaskSchema, handleGetTask, createTaskSchema, handleCreateTask, updateTaskSchema, handleUpdateTask, } from "./tools/tasks.js";
+import { getDealsSchema, handleGetDeals, getDealSchema, handleGetDeal, createDealSchema, handleCreateDeal, updateDealSchema, handleUpdateDeal, } from "./tools/deals.js";
+import { getProjectsSchema, handleGetProjects, getProjectSchema, handleGetProject } from "./tools/projects.js";
+import { getEmployeesSchema, handleGetEmployees } from "./tools/employees.js";
+import { getCommentsSchema, handleGetComments, createCommentSchema, handleCreateComment } from "./tools/comments.js";
+import { getDealProgramsSchema, handleGetDealPrograms, getDealProgramSchema, handleGetDealProgram, } from "./tools/programs.js";
+import { listClientsSchema, handleListClients, getClientSchema, handleGetClient, } from "./tools/contractors.js";
+import { getCurrentUserSchema, handleGetCurrentUser } from "./tools/me.js";
+import { MY_TASKS_TODAY, CREATE_DEAL_WIZARD } from "./prompts.js";
+/** Wrap a tool handler so thrown errors become a clean isError result, not a transport error. */
+function wrapTool(handler) {
+    return async (params) => {
+        try {
+            return { content: [{ type: "text", text: await handler(params) }] };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error("[megaplan-mcp] tool error:", error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    };
+}
+export function createServer() {
+    const server = new McpServer({
+        name: "megaplan-mcp",
+        version: "4.0.0",
     });
-    process.exit(1);
-});
+    // ── Tasks ──
+    server.tool("get_tasks", "List tasks from Megaplan, filtered by status code(s), responsible user, and free-text search.", getTasksSchema.shape, wrapTool(handleGetTasks));
+    server.tool("get_task", "Get a single Megaplan task by ID with full details.", getTaskSchema.shape, wrapTool(handleGetTask));
+    server.tool("create_task", "Create a task in Megaplan with name, description, responsible user, and deadline.", createTaskSchema.shape, wrapTool(handleCreateTask));
+    server.tool("update_task", "Update an existing Megaplan task (name, description, responsible, deadline, status).", updateTaskSchema.shape, wrapTool(handleUpdateTask));
+    // ── Deals ──
+    server.tool("get_deals", "List deals from Megaplan, filtered by status code(s), responsible user, and free-text search.", getDealsSchema.shape, wrapTool(handleGetDeals));
+    server.tool("get_deal", "Get a single Megaplan deal by ID with full details.", getDealSchema.shape, wrapTool(handleGetDeal));
+    server.tool("create_deal", "Create a deal in Megaplan. Requires a program (pipeline) ID — discover it via get_deal_programs.", createDealSchema.shape, wrapTool(handleCreateDeal));
+    server.tool("update_deal", "Update an existing Megaplan deal (name, responsible, amount, description, status).", updateDealSchema.shape, wrapTool(handleUpdateDeal));
+    // ── Projects ──
+    server.tool("get_projects", "List projects from Megaplan, filtered by status code(s) and free-text search.", getProjectsSchema.shape, wrapTool(handleGetProjects));
+    server.tool("get_project", "Get a single Megaplan project by ID with full details.", getProjectSchema.shape, wrapTool(handleGetProject));
+    // ── Employees ──
+    server.tool("get_employees", "List employees from Megaplan with free-text search and department filter.", getEmployeesSchema.shape, wrapTool(handleGetEmployees));
+    // ── Deal programs (pipelines) ──
+    server.tool("get_deal_programs", "List deal programs (pipelines). Use this to find the program_id required by create_deal.", getDealProgramsSchema.shape, wrapTool(handleGetDealPrograms));
+    server.tool("get_deal_program", "Get a single deal program (pipeline) by ID.", getDealProgramSchema.shape, wrapTool(handleGetDealProgram));
+    // ── Clients (CRM contractors) ──
+    server.tool("list_clients", "List clients (CRM contractors): people (human) or organizations (company).", listClientsSchema.shape, wrapTool(handleListClients));
+    server.tool("get_client", "Get a single client (contractor) by type and ID.", getClientSchema.shape, wrapTool(handleGetClient));
+    // ── Current user ──
+    server.tool("get_current_user", "Get the authenticated user's employee record (experimental). Use it to scope 'my tasks'.", getCurrentUserSchema.shape, wrapTool(handleGetCurrentUser));
+    // ── Comments ──
+    server.tool("get_comments", "List comments for a task, deal, or project in Megaplan.", getCommentsSchema.shape, wrapTool(handleGetComments));
+    server.tool("create_comment", "Add a comment to a task, deal, or project in Megaplan.", createCommentSchema.shape, wrapTool(handleCreateComment));
+    // ── Skills (prompts) ──
+    const registerPrompt = (p) => server.prompt(p.name, p.description, {}, async () => ({
+        messages: [{ role: "user", content: { type: "text", text: p.text } }],
+    }));
+    registerPrompt(MY_TASKS_TODAY);
+    registerPrompt(CREATE_DEAL_WIZARD);
+    return server;
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes("--http")) {
+        const { startHttpServer } = await import("./http.js");
+        const port = parseInt(process.env.PORT ?? "3000", 10);
+        await startHttpServer(createServer, port);
+    }
+    else {
+        const server = createServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error(`[megaplan-mcp] Server started via stdio. ${TOOL_COUNT} tools, ${PROMPT_COUNT} skills available.`);
+    }
+}
+/** True when this file is being executed directly (not imported, e.g. by tests). */
+function isEntrypoint() {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntrypoint()) {
+    main().catch((error) => {
+        console.error("[megaplan-mcp] Error:", error);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE/D,SAAS,CAAC,YAAY,EAAE;IACtB,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,UAAU;IACrB,MAAM;CACP,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACjB,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE;QAC1B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAC9D,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/meta.d.ts

@@ -0,0 +1,2 @@
+export declare const TOOL_COUNT = 18;
+export declare const PROMPT_COUNT = 2;

package/dist/meta.js

@@ -0,0 +1,5 @@
+// Surface counts, shared by the stdio startup log and the HTTP /health endpoint.
+// Keep in sync with the tool/prompt registrations in src/index.ts.
+export const TOOL_COUNT = 18;
+export const PROMPT_COUNT = 2;
+//# sourceMappingURL=meta.js.map

package/dist/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,mEAAmE;AACnE,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,7 @@
+export interface PromptDef {
+    name: string;
+    description: string;
+    text: string;
+}
+export declare const MY_TASKS_TODAY: PromptDef;
+export declare const CREATE_DEAL_WIZARD: PromptDef;

package/dist/prompts.js

@@ -0,0 +1,22 @@
+// Prompt ("skill") definitions, kept separate so their contract (which tools
+// and filters they steer the model toward) can be unit-tested.
+export const MY_TASKS_TODAY = {
+    name: "my-tasks-today",
+    description: "Мои задачи на сегодня — your tasks due today or overdue",
+    text: "Сначала вызови get_current_user, чтобы узнать мой employee id. Если он недоступен " +
+        "(experimental endpoint вернул ошибку) — попроси меня указать мой employee id (его можно " +
+        "найти через get_employees). Затем вызови get_tasks с filter_responsible_id=<мой id> и " +
+        "подходящим filter_status, чтобы получить именно МОИ активные задачи. Покажи список с " +
+        "дедлайнами, отсортируй по срочности, просроченные пометь. Формат: компактная таблица с " +
+        "колонками Задача, Дедлайн, Статус, Приоритет.",
+};
+export const CREATE_DEAL_WIZARD = {
+    name: "create-deal-wizard",
+    description: "Создай сделку — guided deal creation wizard",
+    text: "Помоги создать новую сделку в Мегаплане. Сначала вызови get_deal_programs и покажи мне " +
+        "список доступных программ (pipelines) с их id, чтобы я выбрал нужную. Затем спроси: " +
+        "1) Название сделки, 2) Ответственный (опционально — найди через get_employees), 3) Сумма и " +
+        "валюта (опционально), 4) Контакт/клиент и его тип human/company (опционально — найди через " +
+        "list_clients), 5) Описание (опционально). После сбора данных вызови create_deal.",
+};
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+DAA+D;AAQ/D,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,yDAAyD;IACtE,IAAI,EACF,oFAAoF;QACpF,0FAA0F;QAC1F,wFAAwF;QACxF,uFAAuF;QACvF,yFAAyF;QACzF,+CAA+C;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,6CAA6C;IAC1D,IAAI,EACF,yFAAyF;QACzF,sFAAsF;QACtF,6FAA6F;QAC7F,6FAA6F;QAC7F,kFAAkF;CACrF,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export declare const idSchema: z.ZodString;
+export interface RefSpec {
+    /** Entity field to filter on, e.g. "responsible" or "department". */
+    field: string;
+    /** Referenced entity contentType, e.g. "Employee" or "Department". */
+    contentType: string;
+    id: string;
+}
+export interface ListQueryOpts {
+    /** Entity contentType base, used for the filter type and the cursor, e.g. "Task". */
+    entity: string;
+    limit: number;
+    /** Cursor: id of the last item from the previous page. */
+    pageAfter?: string;
+    /** Status enum code(s), e.g. ["filter_any"]. Account-specific. */
+    status?: string | string[];
+    /** Reference filters (responsible, department, ...). */
+    refs?: RefSpec[];
+    /** Free-text search. */
+    search?: string;
+    /** Override for the filter contentType (defaults to `${entity}Filter`). */
+    filterContentType?: string;
+}
+type Json = Record<string, unknown>;
+/** Build the v3 list-query object (limit + filter + cursor). */
+export declare function buildListQuery(opts: ListQueryOpts): Json;
+/** v3 date+time value object (deadlines etc. are entity objects, not bare strings). */
+export declare function toDateTime(iso: string): Json;
+/** v3 Money value object (money fields are complex objects, not bare numbers). */
+export declare function toMoney(value: number, currency?: string): Json;
+export {};

package/dist/query.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+// A Megaplan entity id. Constrained so a value interpolated into a request URL
+// path (e.g. /task/{id}, /{type}/{subject_id}/comments) can't smuggle in path
+// traversal — the callers here are LLM agents, so ids are an untrusted boundary.
+export const idSchema = z
+    .string()
+    .regex(/^[A-Za-z0-9_-]+$/, "Invalid Megaplan id (letters, digits, _ or - only)");
+/** Build the v3 list-query object (limit + filter + cursor). */
+export function buildListQuery(opts) {
+    const query = { limit: opts.limit };
+    const terms = [];
+    const status = opts.status == null ? [] : Array.isArray(opts.status) ? opts.status : [opts.status];
+    if (status.length > 0) {
+        terms.push({
+            contentType: "FilterTermEnum",
+            field: "status",
+            comparison: "equals",
+            value: status,
+        });
+    }
+    for (const ref of opts.refs ?? []) {
+        if (!ref.id)
+            continue;
+        terms.push({
+            contentType: "FilterTermRef",
+            field: ref.field,
+            comparison: "equals",
+            value: [{ id: ref.id, contentType: ref.contentType }],
+        });
+    }
+    if (terms.length > 0) {
+        query.filter = {
+            // TODO(live-verify): per-entity filter contentType (e.g. Deal may be
+            // "TradeFilter" rather than "DealFilter") — confirm against the account RAML.
+            contentType: opts.filterContentType ?? `${opts.entity}Filter`,
+            id: null,
+            config: {
+                contentType: "FilterConfig",
+                termGroup: { contentType: "FilterTermGroup", join: "and", terms },
+            },
+        };
+    }
+    // TODO(live-verify): free-text search param name (q vs search vs a string
+    // filter term). `q` is the documented-likely candidate.
+    if (opts.search)
+        query.q = opts.search;
+    if (opts.pageAfter) {
+        query.pageAfter = { contentType: opts.entity, id: opts.pageAfter };
+    }
+    return query;
+}
+/** v3 date+time value object (deadlines etc. are entity objects, not bare strings). */
+export function toDateTime(iso) {
+    return { contentType: "DateTime", value: iso };
+}
+/** v3 Money value object (money fields are complex objects, not bare numbers). */
+export function toMoney(value, currency = "RUB") {
+    // TODO(live-verify): the API may also require `valueInMain`.
+    return { contentType: "Money", value, currency };
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,8EAA8E;AAC9E,iFAAiF;AACjF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,KAAK,CAAC,kBAAkB,EAAE,oDAAoD,CAAC,CAAC;AAqCnF,gEAAgE;AAChE,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,MAAM,KAAK,GAAS,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAE1C,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,MAAM,GACV,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC;YACT,WAAW,EAAE,gBAAgB;YAC7B,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,QAAQ;YACpB,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,SAAS;QACtB,KAAK,CAAC,IAAI,CAAC;YACT,WAAW,EAAE,eAAe;YAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,UAAU,EAAE,QAAQ;YACpB,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,MAAM,GAAG;YACb,qEAAqE;YACrE,8EAA8E;YAC9E,WAAW,EAAE,IAAI,CAAC,iBAAiB,IAAI,GAAG,IAAI,CAAC,MAAM,QAAQ;YAC7D,EAAE,EAAE,IAAI;YACR,MAAM,EAAE;gBACN,WAAW,EAAE,cAAc;gBAC3B,SAAS,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;aAClE;SACF,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,wDAAwD;IACxD,IAAI,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IAEvC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,KAAK,CAAC,SAAS,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACjD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,QAAQ,GAAG,KAAK;IACrD,6DAA6D;IAC7D,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACnD,CAAC"}

package/dist/tools/comments.d.ts

@@ -3,31 +3,33 @@ export declare const getCommentsSchema: z.ZodObject<{
     subject_type: z.ZodEnum<["task", "deal", "project"]>;
     subject_id: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
-    offset: z.ZodDefault<z.ZodNumber>;
+    page_after: z.ZodOptional<z.ZodString>;
+    raw: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     limit: number;
-    offset: number;
     subject_type: "task" | "deal" | "project";
     subject_id: string;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
 }, {
     subject_type: "task" | "deal" | "project";
     subject_id: string;
     limit?: number | undefined;
-    offset?: number | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
 }>;
 export declare function handleGetComments(params: z.infer<typeof getCommentsSchema>): Promise<string>;
 export declare const createCommentSchema: z.ZodObject<{
     subject_type: z.ZodEnum<["task", "deal", "project"]>;
     subject_id: z.ZodString;
-    text: z.ZodString;
+    content: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    content: string;
     subject_type: "task" | "deal" | "project";
     subject_id: string;
-    text: string;
 }, {
+    content: string;
     subject_type: "task" | "deal" | "project";
     subject_id: string;
-    text: string;
 }>;
 export declare function handleCreateComment(params: z.infer<typeof createCommentSchema>): Promise<string>;
-//# sourceMappingURL=comments.d.ts.map

package/dist/tools/comments.js

@@ -1,34 +1,31 @@
 import { z } from "zod";
 import { megaplanGet, megaplanPost } from "../client.js";
+import { idSchema } from "../query.js";
+import { formatList, formatEntity, formatComment } from "../format.js";
 export const getCommentsSchema = z.object({
     subject_type: z.enum(["task", "deal", "project"]).describe("Entity type to get comments for"),
-    subject_id: z.string().describe("Entity ID to get comments for"),
-    limit: z.number().int().min(1).max(100).default(25).describe("Results per page"),
-    offset: z.number().int().default(0).describe("Offset for pagination"),
+    subject_id: idSchema.describe("Entity ID to get comments for"),
+    limit: z.number().int().min(1).max(100).default(25).describe("Results per page (max 100)"),
+    page_after: z.string().optional().describe("Cursor: id of the last comment from the previous page"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
 });
 export async function handleGetComments(params) {
-    const query = {
-        limit: String(params.limit),
-        offset: String(params.offset),
-    };
-    const result = await megaplanGet(`/${params.subject_type}/${params.subject_id}/comment`, query);
-    return JSON.stringify(result, null, 2);
+    const query = { limit: params.limit };
+    if (params.page_after)
+        query.pageAfter = { contentType: "Comment", id: params.page_after };
+    // v3 comments live at the PLURAL sub-resource /{entity}/{id}/comments.
+    const result = await megaplanGet(`/${params.subject_type}/${params.subject_id}/comments`, query);
+    return formatList(result, formatComment, params.raw);
 }
 export const createCommentSchema = z.object({
     subject_type: z.enum(["task", "deal", "project"]).describe("Entity type to comment on"),
-    subject_id: z.string().describe("Entity ID to comment on"),
-    text: z.string().describe("Comment text (supports HTML)"),
+    subject_id: idSchema.describe("Entity ID to comment on"),
+    content: z.string().describe("Comment text"),
 });
 export async function handleCreateComment(params) {
-    const body = {
-        contentType: "Comment",
-        text: params.text,
-        subject: {
-            id: params.subject_id,
-            contentType: params.subject_type.charAt(0).toUpperCase() + params.subject_type.slice(1),
-        },
-    };
-    const result = await megaplanPost(`/${params.subject_type}/${params.subject_id}/comment`, body);
-    return JSON.stringify(result, null, 2);
+    // The subject is encoded in the URL path; the body only needs contentType + content.
+    const body = { contentType: "Comment", content: params.content };
+    const result = await megaplanPost(`/${params.subject_type}/${params.subject_id}/comments`, body);
+    return formatEntity(result, formatComment);
 }
 //# sourceMappingURL=comments.js.map

package/dist/tools/comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC7F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAChE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAChF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAyC;IAC/E,MAAM,KAAK,GAA2B;QACpC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;KAC9B,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,UAAU,EAAE,KAAK,CAAC,CAAC;IAChG,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACvF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA2C;IACnF,MAAM,IAAI,GAAG;QACX,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE;YACP,EAAE,EAAE,MAAM,CAAC,UAAU;YACrB,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;SACxF;KACF,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,UAAU,EAAE,IAAI,CAAC,CAAC;IAChG,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC7F,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC9D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC1F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACnG,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAyC;IAC/E,MAAM,KAAK,GAA4B,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/D,IAAI,MAAM,CAAC,UAAU;QAAE,KAAK,CAAC,SAAS,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAC3F,uEAAuE;IACvE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,WAAW,EAAE,KAAK,CAAC,CAAC;IACjG,OAAO,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACvF,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA2C;IACnF,qFAAqF;IACrF,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,WAAW,EAAE,IAAI,CAAC,CAAC;IACjG,OAAO,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC"}

package/dist/tools/contractors.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export declare const listClientsSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<["human", "company"]>>;
+    search: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    page_after: z.ZodOptional<z.ZodString>;
+    raw: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    type: "human" | "company";
+    search?: string | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
+}, {
+    limit?: number | undefined;
+    type?: "human" | "company" | undefined;
+    search?: string | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
+}>;
+export declare function handleListClients(params: z.infer<typeof listClientsSchema>): Promise<string>;
+export declare const getClientSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<["human", "company"]>>;
+    id: z.ZodString;
+    raw: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: "human" | "company";
+    raw?: boolean | undefined;
+}, {
+    id: string;
+    type?: "human" | "company" | undefined;
+    raw?: boolean | undefined;
+}>;
+export declare function handleGetClient(params: z.infer<typeof getClientSchema>): Promise<string>;