mcp-agendor 1.0.1 → 1.0.2

package/dist/agendor/client.d.ts

@@ -26,7 +26,12 @@ export declare class AgendorClient {
     getDealsMovementsHistory(params?: {
         deal_id?: number;
         since?: string;
+        days_interval?: number;
+        page?: number;
+        per_page?: number;
     }): Promise<unknown[]>;
+    /** Busca movimentações em janelas de 30 dias (limite da API) com paginação */
+    getAllDealsMovementsHistory(since: string, daysTotal?: number): Promise<unknown[]>;
     getTasks(params?: {
         deal_id?: number;
         since?: string;

package/dist/agendor/client.js

@@ -177,7 +177,11 @@ export class AgendorClient {
             q.set("deal_id", String(params.deal_id));
         if (params.since)
             q.set("since", params.since);
-        const url = `${this.baseUrl}/deals/movements_history${q.toString() ? `?${q.toString()}` : ""}`;
+        if (params.days_interval != null)
+            q.set("days_interval", String(Math.min(30, params.days_interval)));
+        q.set("page", String(params.page ?? 1));
+        q.set("per_page", String(params.per_page ?? PER_PAGE));
+        const url = `${this.baseUrl}/deals/movements_history?${q.toString()}`;
         try {
             const data = await request(url, this.token);
             return Array.isArray(data) ? data : (data.data ?? []);
@@ -186,6 +190,34 @@ export class AgendorClient {
             return [];
         }
     }
+    /** Busca movimentações em janelas de 30 dias (limite da API) com paginação */
+    async getAllDealsMovementsHistory(since, daysTotal = 180) {
+        const all = [];
+        const windowDays = 30;
+        let sinceDate = new Date(since);
+        const endDate = new Date(sinceDate);
+        endDate.setDate(endDate.getDate() + daysTotal);
+        while (sinceDate < endDate) {
+            const windowEnd = new Date(sinceDate);
+            windowEnd.setDate(windowEnd.getDate() + windowDays);
+            const sinceStr = sinceDate.toISOString().slice(0, 19) + "Z";
+            let page = 1;
+            for (;;) {
+                const list = await this.getDealsMovementsHistory({
+                    since: sinceStr,
+                    days_interval: windowDays,
+                    page,
+                    per_page: PER_PAGE,
+                });
+                all.push(...list);
+                if (list.length < PER_PAGE)
+                    break;
+                page += 1;
+            }
+            sinceDate = windowEnd;
+        }
+        return all;
+    }
     async getTasks(params = {}) {
         const q = new URLSearchParams();
         if (params.deal_id != null)

package/dist/tools/pipeline-report.js

@@ -123,17 +123,20 @@ async function buildFunnelReport(funnel, deals, args, client) {
         since.setDate(since.getDate() - 180);
         const sinceStr = since.toISOString().slice(0, 19) + "Z";
         try {
-            const raw = await client.getDealsMovementsHistory({ since: sinceStr });
+            const raw = await client.getAllDealsMovementsHistory(sinceStr, 180);
             const arr = Array.isArray(raw) ? raw : [];
             const stageDays = {};
             for (const s of stages)
                 stageDays[s.id] = [];
             const byDeal = {};
             for (const m of arr) {
-                const dealId = m.deal_id ?? m.dealId;
-                const toId = m.to_stage_id ?? m.toStageId;
-                const at = parseDate(m.created_at ?? m.createdAt ?? "").getTime();
-                if (dealId == null)
+                if ((m.event_type ?? "").toLowerCase() !== "stage_changed")
+                    continue;
+                const dealIdRaw = m.deal?.id ?? m.deal_id ?? m.dealId;
+                const dealId = typeof dealIdRaw === "string" ? parseInt(dealIdRaw, 10) : dealIdRaw;
+                const toId = m.deal_stage?.id ?? m.to_stage_id ?? m.toStageId;
+                const at = parseDate(m.updated_at ?? m.created_at ?? m.createdAt ?? "").getTime();
+                if (dealId == null || Number.isNaN(dealId))
                     continue;
                 if (!byDeal[dealId])
                     byDeal[dealId] = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-agendor",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP server for Agendor CRM - pipeline metrics and commercial management",
   "type": "module",
   "main": "dist/index.js",

package/src/agendor/client.ts

@@ -202,11 +202,20 @@ export class AgendorClient {
     return list as AgendorDeal[];
   }
 
-  async getDealsMovementsHistory(params: { deal_id?: number; since?: string } = {}): Promise<unknown[]> {
+  async getDealsMovementsHistory(params: {
+    deal_id?: number;
+    since?: string;
+    days_interval?: number;
+    page?: number;
+    per_page?: number;
+  } = {}): Promise<unknown[]> {
     const q = new URLSearchParams();
     if (params.deal_id != null) q.set("deal_id", String(params.deal_id));
     if (params.since) q.set("since", params.since);
-    const url = `${this.baseUrl}/deals/movements_history${q.toString() ? `?${q.toString()}` : ""}`;
+    if (params.days_interval != null) q.set("days_interval", String(Math.min(30, params.days_interval)));
+    q.set("page", String(params.page ?? 1));
+    q.set("per_page", String(params.per_page ?? PER_PAGE));
+    const url = `${this.baseUrl}/deals/movements_history?${q.toString()}`;
     try {
       const data = await request<unknown[] | { data?: unknown[] }>(url, this.token);
       return Array.isArray(data) ? data : (data.data ?? []);
@@ -215,6 +224,35 @@ export class AgendorClient {
     }
   }
 
+  /** Busca movimentações em janelas de 30 dias (limite da API) com paginação */
+  async getAllDealsMovementsHistory(since: string, daysTotal = 180): Promise<unknown[]> {
+    const all: unknown[] = [];
+    const windowDays = 30;
+    let sinceDate = new Date(since);
+    const endDate = new Date(sinceDate);
+    endDate.setDate(endDate.getDate() + daysTotal);
+
+    while (sinceDate < endDate) {
+      const windowEnd = new Date(sinceDate);
+      windowEnd.setDate(windowEnd.getDate() + windowDays);
+      const sinceStr = sinceDate.toISOString().slice(0, 19) + "Z";
+      let page = 1;
+      for (;;) {
+        const list = await this.getDealsMovementsHistory({
+          since: sinceStr,
+          days_interval: windowDays,
+          page,
+          per_page: PER_PAGE,
+        });
+        all.push(...list);
+        if (list.length < PER_PAGE) break;
+        page += 1;
+      }
+      sinceDate = windowEnd;
+    }
+    return all;
+  }
+
   async getTasks(params: { deal_id?: number; since?: string } = {}): Promise<AgendorTask[]> {
     const q = new URLSearchParams();
     if (params.deal_id != null) q.set("deal_id", String(params.deal_id));

package/src/tools/pipeline-report.ts

@@ -148,17 +148,30 @@ async function buildFunnelReport(
     since.setDate(since.getDate() - 180);
     const sinceStr = since.toISOString().slice(0, 19) + "Z";
     try {
-      const raw = await client.getDealsMovementsHistory({ since: sinceStr });
+      const raw = await client.getAllDealsMovementsHistory(sinceStr, 180);
       const arr = Array.isArray(raw) ? raw : [];
-      type Mov = { deal_id?: number; to_stage_id?: number; created_at?: string; toStageId?: number; createdAt?: string };
+      type Mov = {
+        deal?: { id?: number | string };
+        deal_id?: number;
+        dealId?: number;
+        deal_stage?: { id?: number };
+        to_stage_id?: number;
+        toStageId?: number;
+        updated_at?: string;
+        created_at?: string;
+        createdAt?: string;
+        event_type?: string;
+      };
       const stageDays: Record<number, number[]> = {};
       for (const s of stages) stageDays[s.id] = [];
       const byDeal: Record<number, Array<{ stageId: number; enteredAt: number }>> = {};
       for (const m of arr as Mov[]) {
-        const dealId = m.deal_id ?? (m as Record<string, unknown>).dealId as number | undefined;
-        const toId = m.to_stage_id ?? m.toStageId;
-        const at = parseDate(m.created_at ?? (m.createdAt as string) ?? "").getTime();
-        if (dealId == null) continue;
+        if ((m.event_type ?? "").toLowerCase() !== "stage_changed") continue;
+        const dealIdRaw = (m.deal as { id?: number | string } | undefined)?.id ?? m.deal_id ?? m.dealId;
+        const dealId = typeof dealIdRaw === "string" ? parseInt(dealIdRaw, 10) : dealIdRaw;
+        const toId = (m.deal_stage as { id?: number } | undefined)?.id ?? m.to_stage_id ?? m.toStageId;
+        const at = parseDate(m.updated_at ?? m.created_at ?? (m.createdAt as string) ?? "").getTime();
+        if (dealId == null || Number.isNaN(dealId)) continue;
         if (!byDeal[dealId]) byDeal[dealId] = [];
         if (toId != null && stageIds.has(toId as number)) byDeal[dealId].push({ stageId: toId as number, enteredAt: at });
       }