@theyahia/megaplan-mcp 3.0.0 → 4.0.0

package/dist/tools/contractors.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { megaplanGet } from "../client.js";
+import { buildListQuery, idSchema } from "../query.js";
+import { formatList, formatEntity, formatClient } from "../format.js";
+// In v3 contractors are split into two entities: people (contractorHuman) and
+// organizations (contractorCompany). The `type` param selects which.
+function pathFor(type) {
+    return type === "company" ? "contractorCompany" : "contractorHuman";
+}
+function entityFor(type) {
+    return type === "company" ? "ContractorCompany" : "ContractorHuman";
+}
+export const listClientsSchema = z.object({
+    type: z.enum(["human", "company"]).default("human").describe("Person (human) or organization (company)"),
+    search: z.string().optional().describe("Free-text search by name"),
+    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 client from the previous page"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
+});
+export async function handleListClients(params) {
+    const query = buildListQuery({
+        entity: entityFor(params.type),
+        limit: params.limit,
+        pageAfter: params.page_after,
+        search: params.search,
+    });
+    const result = await megaplanGet(`/${pathFor(params.type)}`, query);
+    return formatList(result, formatClient, params.raw);
+}
+export const getClientSchema = z.object({
+    type: z.enum(["human", "company"]).default("human").describe("Person (human) or organization (company)"),
+    id: idSchema.describe("Client ID"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
+});
+export async function handleGetClient(params) {
+    const result = await megaplanGet(`/${pathFor(params.type)}/${params.id}`);
+    return formatEntity(result, formatClient, params.raw);
+}
+//# sourceMappingURL=contractors.js.map

package/dist/tools/contractors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractors.js","sourceRoot":"","sources":["../../src/tools/contractors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtE,8EAA8E;AAC9E,qEAAqE;AAErE,SAAS,OAAO,CAAC,IAAyB;IACxC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACtE,CAAC;AACD,SAAS,SAAS,CAAC,IAAyB;IAC1C,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACxG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAClE,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,sDAAsD,CAAC;IAClG,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,GAAG,cAAc,CAAC;QAC3B,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,UAAU;QAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACpE,OAAO,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACxG,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;IAClC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAuC;IAC3E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC"}

package/dist/tools/deals.d.ts

@@ -1,34 +1,52 @@
 import { z } from "zod";
 export declare const getDealsSchema: z.ZodObject<{
-    filter_status: z.ZodOptional<z.ZodString>;
+    filter_status: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
     filter_responsible_id: z.ZodOptional<z.ZodString>;
     search: z.ZodOptional<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;
-    filter_status?: string | undefined;
+    filter_status?: string | string[] | undefined;
     filter_responsible_id?: string | undefined;
     search?: string | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
 }, {
-    filter_status?: string | undefined;
+    limit?: number | undefined;
+    filter_status?: string | string[] | undefined;
     filter_responsible_id?: string | undefined;
     search?: string | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
 }>;
 export declare function handleGetDeals(params: z.infer<typeof getDealsSchema>): Promise<string>;
+export declare const getDealSchema: z.ZodObject<{
+    id: z.ZodString;
+    raw: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    raw?: boolean | undefined;
+}, {
+    id: string;
+    raw?: boolean | undefined;
+}>;
+export declare function handleGetDeal(params: z.infer<typeof getDealSchema>): Promise<string>;
 export declare const createDealSchema: z.ZodObject<{
     name: z.ZodString;
     program_id: z.ZodString;
     responsible_id: z.ZodOptional<z.ZodString>;
     contact_id: z.ZodOptional<z.ZodString>;
+    contact_type: z.ZodDefault<z.ZodEnum<["human", "company"]>>;
     amount: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodDefault<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
+    currency: string;
     program_id: string;
+    contact_type: "human" | "company";
     description?: string | undefined;
     responsible_id?: string | undefined;
     contact_id?: string | undefined;
@@ -36,10 +54,37 @@ export declare const createDealSchema: z.ZodObject<{
 }, {
     name: string;
     program_id: string;
+    currency?: string | undefined;
     description?: string | undefined;
     responsible_id?: string | undefined;
     contact_id?: string | undefined;
+    contact_type?: "human" | "company" | undefined;
     amount?: number | undefined;
 }>;
 export declare function handleCreateDeal(params: z.infer<typeof createDealSchema>): Promise<string>;
-//# sourceMappingURL=deals.d.ts.map
+export declare const updateDealSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    responsible_id: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    currency: string;
+    name?: string | undefined;
+    status?: string | undefined;
+    description?: string | undefined;
+    responsible_id?: string | undefined;
+    amount?: number | undefined;
+}, {
+    id: string;
+    name?: string | undefined;
+    currency?: string | undefined;
+    status?: string | undefined;
+    description?: string | undefined;
+    responsible_id?: string | undefined;
+    amount?: number | undefined;
+}>;
+export declare function handleUpdateDeal(params: z.infer<typeof updateDealSchema>): Promise<string>;

package/dist/tools/deals.js

@@ -1,49 +1,97 @@
 import { z } from "zod";
 import { megaplanGet, megaplanPost } from "../client.js";
+import { buildListQuery, toMoney, idSchema } from "../query.js";
+import { formatList, formatEntity, formatDeal } from "../format.js";
+const statusFilter = z
+    .union([z.string(), z.array(z.string())])
+    .optional()
+    .describe('Filter by status code(s). Codes are account-specific.');
 export const getDealsSchema = z.object({
-    filter_status: z.string().optional().describe("Filter by deal status"),
+    filter_status: statusFilter,
     filter_responsible_id: z.string().optional().describe("Filter by responsible employee ID"),
-    search: z.string().optional().describe("Search by deal name"),
-    limit: z.number().int().min(1).max(100).default(25).describe("Results per page"),
-    offset: z.number().int().default(0).describe("Offset for pagination"),
+    search: z.string().optional().describe("Free-text search by deal name"),
+    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 deal from the previous page"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
 });
 export async function handleGetDeals(params) {
-    const query = {
-        limit: String(params.limit),
-        offset: String(params.offset),
-    };
-    if (params.filter_status)
-        query["filter[status]"] = params.filter_status;
-    if (params.filter_responsible_id)
-        query["filter[responsible]"] = params.filter_responsible_id;
-    if (params.search)
-        query["search"] = params.search;
+    const query = buildListQuery({
+        entity: "Deal",
+        limit: params.limit,
+        pageAfter: params.page_after,
+        status: params.filter_status,
+        refs: params.filter_responsible_id
+            ? [{ field: "responsible", contentType: "Employee", id: params.filter_responsible_id }]
+            : [],
+        search: params.search,
+    });
     const result = await megaplanGet("/deal", query);
-    return JSON.stringify(result, null, 2);
+    return formatList(result, formatDeal, params.raw);
+}
+export const getDealSchema = z.object({
+    id: idSchema.describe("Deal ID"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
+});
+export async function handleGetDeal(params) {
+    const result = await megaplanGet(`/deal/${params.id}`);
+    return formatEntity(result, formatDeal, params.raw);
 }
 export const createDealSchema = z.object({
     name: z.string().describe("Deal name/title"),
-    program_id: z.string().describe("Deal program (pipeline) ID"),
+    program_id: z.string().describe("Deal program (pipeline) ID — discover via get_deal_programs"),
     responsible_id: z.string().optional().describe("Responsible employee ID"),
     contact_id: z.string().optional().describe("Contact/client ID"),
-    amount: z.number().optional().describe("Deal amount"),
+    contact_type: z
+        .enum(["human", "company"])
+        .default("human")
+        .describe("Whether contact_id is a person (human) or an organization (company)"),
+    amount: z.number().optional().describe("Deal amount (maps to the 'price' / final-sum field)"),
+    currency: z.string().default("RUB").describe("ISO currency code for amount"),
     description: z.string().optional().describe("Deal description"),
 });
 export async function handleCreateDeal(params) {
     const body = {
         contentType: "Deal",
         name: params.name,
-        program: { id: params.program_id, contentType: "DealProgram" },
+        program: { id: params.program_id, contentType: "Program" },
     };
-    if (params.responsible_id)
+    if (params.responsible_id) {
         body.responsible = { id: params.responsible_id, contentType: "Employee" };
-    if (params.contact_id)
-        body.contact = { id: params.contact_id, contentType: "Contractor" };
+    }
+    if (params.contact_id) {
+        const contentType = params.contact_type === "company" ? "ContractorCompany" : "ContractorHuman";
+        body.contact = { id: params.contact_id, contentType };
+    }
     if (params.amount != null)
-        body.cost = params.amount;
+        body.price = toMoney(params.amount, params.currency);
     if (params.description)
         body.description = params.description;
     const result = await megaplanPost("/deal", body);
-    return JSON.stringify(result, null, 2);
+    return formatEntity(result, formatDeal);
+}
+export const updateDealSchema = z.object({
+    id: idSchema.describe("Deal ID to update"),
+    name: z.string().optional().describe("New name/title"),
+    responsible_id: z.string().optional().describe("New responsible employee ID"),
+    amount: z.number().optional().describe("New deal amount (maps to 'price')"),
+    currency: z.string().default("RUB").describe("ISO currency code for amount"),
+    description: z.string().optional().describe("New description"),
+    status: z.string().optional().describe("New status code (experimental — field shape unverified)"),
+});
+export async function handleUpdateDeal(params) {
+    const body = { contentType: "Deal" };
+    if (params.name !== undefined)
+        body.name = params.name;
+    if (params.responsible_id)
+        body.responsible = { id: params.responsible_id, contentType: "Employee" };
+    if (params.amount != null)
+        body.price = toMoney(params.amount, params.currency);
+    if (params.description !== undefined)
+        body.description = params.description;
+    // TODO(live-verify): status may need a link-entity rather than a bare code.
+    if (params.status !== undefined)
+        body.status = params.status;
+    const result = await megaplanPost(`/deal/${params.id}`, body);
+    return formatEntity(result, formatDeal);
 }
 //# sourceMappingURL=deals.js.map

package/dist/tools/deals.js.map

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

package/dist/tools/employees.d.ts

@@ -3,17 +3,19 @@ export declare const getEmployeesSchema: z.ZodObject<{
     search: z.ZodOptional<z.ZodString>;
     filter_department_id: z.ZodOptional<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;
     search?: string | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
     filter_department_id?: string | undefined;
 }, {
-    search?: string | undefined;
     limit?: number | undefined;
-    offset?: number | undefined;
+    search?: string | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
     filter_department_id?: string | undefined;
 }>;
 export declare function handleGetEmployees(params: z.infer<typeof getEmployeesSchema>): Promise<string>;
-//# sourceMappingURL=employees.d.ts.map

package/dist/tools/employees.js

@@ -1,21 +1,25 @@
 import { z } from "zod";
 import { megaplanGet } from "../client.js";
+import { buildListQuery } from "../query.js";
+import { formatList, formatEmployee } from "../format.js";
 export const getEmployeesSchema = z.object({
-    search: z.string().optional().describe("Search by employee name or email"),
+    search: z.string().optional().describe("Free-text search by employee name or email"),
     filter_department_id: z.string().optional().describe("Filter by department ID"),
-    limit: z.number().int().min(1).max(100).default(25).describe("Results per page"),
-    offset: z.number().int().default(0).describe("Offset for pagination"),
+    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 employee from the previous page"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
 });
 export async function handleGetEmployees(params) {
-    const query = {
-        limit: String(params.limit),
-        offset: String(params.offset),
-    };
-    if (params.search)
-        query["search"] = params.search;
-    if (params.filter_department_id)
-        query["filter[department]"] = params.filter_department_id;
+    const query = buildListQuery({
+        entity: "Employee",
+        limit: params.limit,
+        pageAfter: params.page_after,
+        refs: params.filter_department_id
+            ? [{ field: "department", contentType: "Department", id: params.filter_department_id }]
+            : [],
+        search: params.search,
+    });
     const result = await megaplanGet("/employee", query);
-    return JSON.stringify(result, null, 2);
+    return formatList(result, formatEmployee, params.raw);
 }
 //# sourceMappingURL=employees.js.map

package/dist/tools/employees.js.map

@@ -1 +1 @@
-{"version":3,"file":"employees.js","sourceRoot":"","sources":["../../src/tools/employees.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC1E,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC/E,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,kBAAkB,CAAC,MAA0C;IACjF,MAAM,KAAK,GAA2B;QACpC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;KAC9B,CAAC;IACF,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,IAAI,MAAM,CAAC,oBAAoB;QAAE,KAAK,CAAC,oBAAoB,CAAC,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAE3F,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"employees.js","sourceRoot":"","sources":["../../src/tools/employees.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACpF,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC/E,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,wDAAwD,CAAC;IACpG,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAA0C;IACjF,MAAM,KAAK,GAAG,cAAc,CAAC;QAC3B,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,UAAU;QAC5B,IAAI,EAAE,MAAM,CAAC,oBAAoB;YAC/B,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,oBAAoB,EAAE,CAAC;YACvF,CAAC,CAAC,EAAE;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC"}

package/dist/tools/me.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export declare const getCurrentUserSchema: z.ZodObject<{
+    raw: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    raw?: boolean | undefined;
+}, {
+    raw?: boolean | undefined;
+}>;
+export declare function handleGetCurrentUser(params: z.infer<typeof getCurrentUserSchema>): Promise<string>;

package/dist/tools/me.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { megaplanGet } from "../client.js";
+import { formatEntity, formatEmployee } from "../format.js";
+// EXPERIMENTAL: the current-user endpoint is not documented for v3.
+// GET /api/v3/employee/current is the most likely path; if the account returns
+// 404 we surface a helpful message instead of failing opaquely.
+export const getCurrentUserSchema = z.object({
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
+});
+export async function handleGetCurrentUser(params) {
+    try {
+        const result = await megaplanGet("/employee/current");
+        return formatEntity(result, formatEmployee, params.raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        // TODO(live-verify): confirm the current-user path on a real account.
+        if (/\b40[34]\b/.test(message)) {
+            return JSON.stringify({
+                error: "Current-user endpoint not available on this account. Find your employee id via get_employees and pass it explicitly (e.g. to get_tasks filter_responsible_id).",
+            }, null, 2);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=me.js.map

package/dist/tools/me.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"me.js","sourceRoot":"","sources":["../../src/tools/me.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D,oEAAoE;AACpE,+EAA+E;AAC/E,gEAAgE;AAEhE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA4C;IAE5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,mBAAmB,CAAC,CAAC;QACtD,OAAO,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,sEAAsE;QACtE,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,SAAS,CACnB;gBACE,KAAK,EACH,gKAAgK;aACnK,EACD,IAAI,EACJ,CAAC,CACF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/programs.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const getDealProgramsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    page_after: z.ZodOptional<z.ZodString>;
+    raw: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
+}, {
+    limit?: number | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
+}>;
+export declare function handleGetDealPrograms(params: z.infer<typeof getDealProgramsSchema>): Promise<string>;
+export declare const getDealProgramSchema: z.ZodObject<{
+    id: z.ZodString;
+    raw: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    raw?: boolean | undefined;
+}, {
+    id: string;
+    raw?: boolean | undefined;
+}>;
+export declare function handleGetDealProgram(params: z.infer<typeof getDealProgramSchema>): Promise<string>;

package/dist/tools/programs.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { megaplanGet } from "../client.js";
+import { buildListQuery, idSchema } from "../query.js";
+import { formatList, formatEntity, formatProgram } from "../format.js";
+// Deal programs (a.k.a. pipelines). create_deal requires a program_id, and this
+// is the only way to discover it.
+export const getDealProgramsSchema = z.object({
+    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 program from the previous page"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
+});
+export async function handleGetDealPrograms(params) {
+    const query = buildListQuery({ entity: "Program", limit: params.limit, pageAfter: params.page_after });
+    const result = await megaplanGet("/program", query);
+    return formatList(result, formatProgram, params.raw);
+}
+export const getDealProgramSchema = z.object({
+    id: idSchema.describe("Deal program (pipeline) ID"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
+});
+export async function handleGetDealProgram(params) {
+    const result = await megaplanGet(`/program/${params.id}`);
+    return formatEntity(result, formatProgram, params.raw);
+}
+//# sourceMappingURL=programs.js.map

package/dist/tools/programs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../src/tools/programs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvE,gFAAgF;AAChF,kCAAkC;AAElC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,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,qBAAqB,CACzC,MAA6C;IAE7C,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACvG,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACnD,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA4C;IAE5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC"}

package/dist/tools/projects.d.ts

@@ -1,19 +1,32 @@
 import { z } from "zod";
 export declare const getProjectsSchema: z.ZodObject<{
-    filter_status: z.ZodOptional<z.ZodString>;
+    filter_status: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
     search: z.ZodOptional<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;
-    filter_status?: string | undefined;
+    filter_status?: string | string[] | undefined;
     search?: string | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
 }, {
-    filter_status?: string | undefined;
-    search?: string | undefined;
     limit?: number | undefined;
-    offset?: number | undefined;
+    filter_status?: string | string[] | undefined;
+    search?: string | undefined;
+    page_after?: string | undefined;
+    raw?: boolean | undefined;
 }>;
 export declare function handleGetProjects(params: z.infer<typeof getProjectsSchema>): Promise<string>;
-//# sourceMappingURL=projects.d.ts.map
+export declare const getProjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    raw: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    raw?: boolean | undefined;
+}, {
+    id: string;
+    raw?: boolean | undefined;
+}>;
+export declare function handleGetProject(params: z.infer<typeof getProjectSchema>): Promise<string>;

package/dist/tools/projects.js

@@ -1,21 +1,34 @@
 import { z } from "zod";
 import { megaplanGet } from "../client.js";
+import { buildListQuery, idSchema } from "../query.js";
+import { formatList, formatEntity, formatProject } from "../format.js";
 export const getProjectsSchema = z.object({
-    filter_status: z.string().optional().describe("Filter by status (active, completed, etc.)"),
-    search: z.string().optional().describe("Search by project name"),
-    limit: z.number().int().min(1).max(100).default(25).describe("Results per page"),
-    offset: z.number().int().default(0).describe("Offset for pagination"),
+    filter_status: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe("Filter by status code(s). Codes are account-specific."),
+    search: z.string().optional().describe("Free-text search by project name"),
+    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 project from the previous page"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
 });
 export async function handleGetProjects(params) {
-    const query = {
-        limit: String(params.limit),
-        offset: String(params.offset),
-    };
-    if (params.filter_status)
-        query["filter[status]"] = params.filter_status;
-    if (params.search)
-        query["search"] = params.search;
+    const query = buildListQuery({
+        entity: "Project",
+        limit: params.limit,
+        pageAfter: params.page_after,
+        status: params.filter_status,
+        search: params.search,
+    });
     const result = await megaplanGet("/project", query);
-    return JSON.stringify(result, null, 2);
+    return formatList(result, formatProject, params.raw);
+}
+export const getProjectSchema = z.object({
+    id: idSchema.describe("Project ID"),
+    raw: z.boolean().optional().describe("Return raw API JSON instead of a compact summary"),
+});
+export async function handleGetProject(params) {
+    const result = await megaplanGet(`/project/${params.id}`);
+    return formatEntity(result, formatProject, params.raw);
 }
 //# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

@@ -1 +1 @@
-{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC3F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,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,IAAI,MAAM,CAAC,aAAa;QAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;IACzE,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IAEnD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC1E,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,GAAG,cAAc,CAAC;QAC3B,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,UAAU;QAC5B,MAAM,EAAE,MAAM,CAAC,aAAa;QAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAwC;IAC7E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC"}