mcp-agendor 1.0.1

package/.env.example

@@ -0,0 +1,9 @@
+# Agendor API (required)
+AGENDOR_TOKEN=your_agendor_token_here
+AGENDOR_BASE_URL=https://api.agendor.com.br/v3
+
+# Optional: Postgres for event store (Fase 2)
+# DATABASE_URL=postgresql://user:pass@localhost:5432/agendor_mcp
+
+# Optional: HTTP server port (default: stdio only)
+# PORT=3000

package/README.md

@@ -0,0 +1,3 @@
+# MCP Agendor
+
+MCP server for Agendor CRM. Set AGENDOR_TOKEN in .env. Run: npm run build && node dist/index.js.

package/dist/agendor/client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Agendor API V3 client: auth (Token header), pagination, retry (429/5xx), throttle.
+ * Normaliza respostas da API (camelCase) para snake_case usado pelas tools.
+ */
+import type { AgendorDeal, AgendorFunnel, AgendorTask, AgendorUser } from "./types.js";
+export declare class AgendorClient {
+    private token;
+    private baseUrl;
+    constructor();
+    getFunnels(): Promise<AgendorFunnel[]>;
+    getUsers(): Promise<AgendorUser[]>;
+    getDeals(params?: {
+        dealStage?: number;
+        dealStatus?: string;
+        userOwner?: number;
+        organization?: number;
+        withCustomFields?: boolean;
+        page?: number;
+        per_page?: number;
+        created_after?: string;
+        updated_after?: string;
+    }): Promise<AgendorDeal[]>;
+    getAllDeals(params?: Omit<Parameters<AgendorClient["getDeals"]>[0], "page" | "per_page">): Promise<AgendorDeal[]>;
+    getDeal(id: number, withCustomFields?: boolean): Promise<AgendorDeal | null>;
+    getDealsStream(since: string): Promise<AgendorDeal[]>;
+    getDealsMovementsHistory(params?: {
+        deal_id?: number;
+        since?: string;
+    }): Promise<unknown[]>;
+    getTasks(params?: {
+        deal_id?: number;
+        since?: string;
+    }): Promise<AgendorTask[]>;
+    getDealTasks(dealId: number): Promise<AgendorTask[]>;
+    createDealTask(dealId: number, body: {
+        title: string;
+        due_date?: string;
+    }): Promise<AgendorTask>;
+}
+export declare function getAgendorClient(): AgendorClient;

package/dist/agendor/client.js

@@ -0,0 +1,215 @@
+/**
+ * Agendor API V3 client: auth (Token header), pagination, retry (429/5xx), throttle.
+ * Normaliza respostas da API (camelCase) para snake_case usado pelas tools.
+ */
+import Bottleneck from "bottleneck";
+import pRetry from "p-retry";
+import { fetch as undiciFetch } from "undici";
+const DEFAULT_BASE = "https://api.agendor.com.br/v3";
+const PER_PAGE = 50;
+const RATE_LIMIT_MIN_TIME = 1100; // ~1 req/s to avoid 429
+function getConfig() {
+    const token = process.env.AGENDOR_TOKEN;
+    const baseUrl = process.env.AGENDOR_BASE_URL ?? DEFAULT_BASE;
+    if (!token) {
+        throw new Error("AGENDOR_TOKEN is required");
+    }
+    return { token, baseUrl: baseUrl.replace(/\/$/, "") };
+}
+function authHeaders(token) {
+    return {
+        Authorization: `Token ${token}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+    };
+}
+// Throttle all requests per process
+const limiter = new Bottleneck({ minTime: RATE_LIMIT_MIN_TIME });
+async function request(url, token, options = {}) {
+    const run = () => limiter.schedule(async () => {
+        const res = await undiciFetch(url, {
+            method: options.method ?? "GET",
+            headers: authHeaders(token),
+            body: options.body,
+        });
+        if (res.status === 429 || (res.status >= 500 && res.status < 600)) {
+            throw new Error(`HTTP ${res.status}`);
+        }
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Agendor API ${res.status}: ${text.slice(0, 200)}`);
+        }
+        return res.json();
+    });
+    return pRetry(run, {
+        retries: 3,
+        onFailedAttempt: (e) => {
+            if (e.retriesLeft > 0) {
+                console.error(`[agendor] Retry after ${e.message}`);
+            }
+        },
+    });
+}
+/** API retorna dealStages (camelCase); tools usam stages */
+function normalizeFunnel(f) {
+    if (!f)
+        return;
+    const stages = (f.dealStages ?? f.stageList ?? f.stages);
+    if (Array.isArray(stages) && stages.length > 0)
+        f.stages = stages;
+}
+/** API retorna createdAt, dealStage, dealStatus (objeto); preenche snake_case no mesmo objeto */
+function normalizeDeal(d) {
+    if (!d)
+        return;
+    const ds = d.dealStage;
+    if (ds != null && typeof ds.id === "number") {
+        d.deal_stage_id = ds.id;
+        d.deal_stage = d.deal_stage ?? { id: ds.id, name: ds.name ?? "" };
+    }
+    if (d.createdAt != null)
+        d.created_at = d.createdAt;
+    if (d.updatedAt != null)
+        d.updated_at = d.updatedAt;
+    const status = d.dealStatus;
+    if (status !== undefined && status !== null) {
+        const raw = typeof status === "string" ? status : status?.name ?? "";
+        const lower = String(raw).toLowerCase();
+        if (lower === "ganho")
+            d.deal_status = "won";
+        else if (lower === "perdido")
+            d.deal_status = "lost";
+        else
+            d.deal_status = raw;
+    }
+    if (d.wonAt != null && d.deal_status !== "won")
+        d.deal_status = "won";
+    if (d.lostAt != null && d.deal_status !== "lost")
+        d.deal_status = "lost";
+    const owner = d.owner;
+    if (owner != null && typeof owner.id === "number")
+        d.user_owner_id = owner.id;
+}
+export class AgendorClient {
+    token;
+    baseUrl;
+    constructor() {
+        const { token, baseUrl } = getConfig();
+        this.token = token;
+        this.baseUrl = baseUrl;
+    }
+    async getFunnels() {
+        const data = await request(`${this.baseUrl}/funnels`, this.token);
+        const list = Array.isArray(data) ? data : (data.data ?? []);
+        list.forEach((f) => normalizeFunnel(f));
+        return list;
+    }
+    async getUsers() {
+        const all = [];
+        let page = 1;
+        for (;;) {
+            const data = await request(`${this.baseUrl}/users?page=${page}&per_page=${PER_PAGE}`, this.token);
+            const list = data.data ?? [];
+            all.push(...list);
+            if (list.length < PER_PAGE)
+                break;
+            page += 1;
+        }
+        return all;
+    }
+    async getDeals(params = {}) {
+        const q = new URLSearchParams();
+        if (params.dealStage != null)
+            q.set("deal_stage_id", String(params.dealStage));
+        if (params.dealStatus)
+            q.set("deal_status", params.dealStatus);
+        if (params.userOwner != null)
+            q.set("user_owner_id", String(params.userOwner));
+        if (params.organization != null)
+            q.set("organization_id", String(params.organization));
+        if (params.withCustomFields !== false)
+            q.set("withCustomFields", "true");
+        q.set("page", String(params.page ?? 1));
+        q.set("per_page", String(params.per_page ?? PER_PAGE));
+        if (params.created_after)
+            q.set("created_after", params.created_after);
+        if (params.updated_after)
+            q.set("updated_after", params.updated_after);
+        const data = await request(`${this.baseUrl}/deals?${q.toString()}`, this.token);
+        const list = data.data ?? [];
+        list.forEach((d) => normalizeDeal(d));
+        return list;
+    }
+    async getAllDeals(params = {}) {
+        const all = [];
+        let page = 1;
+        for (;;) {
+            const list = await this.getDeals({ ...params, page, per_page: PER_PAGE });
+            all.push(...list);
+            if (list.length < PER_PAGE)
+                break;
+            page += 1;
+        }
+        return all;
+    }
+    async getDeal(id, withCustomFields = true) {
+        try {
+            const q = withCustomFields ? "?withCustomFields=true" : "";
+            const d = await request(`${this.baseUrl}/deals/${id}${q}`, this.token);
+            normalizeDeal(d);
+            return d;
+        }
+        catch (e) {
+            if (e instanceof Error && e.message.includes("404"))
+                return null;
+            throw e;
+        }
+    }
+    async getDealsStream(since) {
+        const data = await request(`${this.baseUrl}/deals/stream?since=${encodeURIComponent(since)}`, this.token);
+        const list = Array.isArray(data) ? data : (data.data ?? []);
+        list.forEach((d) => normalizeDeal(d));
+        return list;
+    }
+    async getDealsMovementsHistory(params = {}) {
+        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()}` : ""}`;
+        try {
+            const data = await request(url, this.token);
+            return Array.isArray(data) ? data : (data.data ?? []);
+        }
+        catch {
+            return [];
+        }
+    }
+    async getTasks(params = {}) {
+        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}/tasks${q.toString() ? `?${q.toString()}` : ""}`;
+        const data = await request(url, this.token);
+        return Array.isArray(data) ? data : (data.data ?? []);
+    }
+    async getDealTasks(dealId) {
+        const data = await request(`${this.baseUrl}/deals/${dealId}/tasks`, this.token);
+        return Array.isArray(data) ? data : (data.data ?? []);
+    }
+    async createDealTask(dealId, body) {
+        return request(`${this.baseUrl}/deals/${dealId}/tasks`, this.token, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
+}
+let defaultClient = null;
+export function getAgendorClient() {
+    if (!defaultClient)
+        defaultClient = new AgendorClient();
+    return defaultClient;
+}

package/dist/agendor/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Minimal types for Agendor API V3 responses (funnels, deals, users, tasks).
+ * Extend as needed when API docs are available.
+ */
+export interface AgendorFunnelStage {
+    id: number;
+    name: string;
+    order?: number;
+    [key: string]: unknown;
+}
+export interface AgendorFunnel {
+    id: number;
+    name: string;
+    stages?: AgendorFunnelStage[];
+    [key: string]: unknown;
+}
+export interface AgendorUser {
+    id: number;
+    name: string;
+    email?: string;
+    [key: string]: unknown;
+}
+export interface AgendorDeal {
+    id: number;
+    name?: string;
+    value?: number;
+    deal_stage_id?: number;
+    deal_stage?: {
+        id: number;
+        name: string;
+    };
+    deal_status?: string;
+    user_owner_id?: number;
+    user_owner?: AgendorUser;
+    organization_id?: number;
+    created_at?: string;
+    updated_at?: string;
+    customFields?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface AgendorTask {
+    id: number;
+    deal_id?: number;
+    title?: string;
+    due_date?: string;
+    completed_at?: string;
+    created_at?: string;
+    [key: string]: unknown;
+}
+export interface AgendorDealMovement {
+    deal_id: number;
+    from_stage_id?: number;
+    to_stage_id?: number;
+    created_at?: string;
+    [key: string]: unknown;
+}
+export interface AgendorPagedResponse<T> {
+    data?: T[];
+    total?: number;
+    page?: number;
+    per_page?: number;
+    [key: string]: unknown;
+}

package/dist/agendor/types.js

@@ -0,0 +1,5 @@
+/**
+ * Minimal types for Agendor API V3 responses (funnels, deals, users, tasks).
+ * Extend as needed when API docs are available.
+ */
+export {};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { funnelsList } from "./tools/funnels.js";
+import { usersList } from "./tools/users.js";
+import { dealsList, dealsGet, dealsTimeline } from "./tools/deals.js";
+import { pipelineOverview } from "./tools/pipeline-overview.js";
+import { pipelineStageMetrics } from "./tools/pipeline-stage-metrics.js";
+import { pipelineTrends } from "./tools/pipeline-trends.js";
+import { pipelineAging } from "./tools/pipeline-aging.js";
+import { pipelineRepPerformance } from "./tools/pipeline-rep-performance.js";
+import { pipelineReport } from "./tools/pipeline-report.js";
+import * as schemas from "./schemas/inputs.js";
+const server = new McpServer({ name: "mcp-agendor", version: "1.0.0" });
+server.registerTool("funnels_list", { title: "List funnels", description: "Lista funis e etapas", inputSchema: z.object({}) }, () => funnelsList());
+server.registerTool("users_list", { title: "List users", description: "Lista usuarios", inputSchema: z.object({}) }, () => usersList());
+server.registerTool("deals_list", { title: "List deals", description: "Lista negocios", inputSchema: schemas.dealsListSchema }, (a) => dealsList(a));
+server.registerTool("deals_get", { title: "Get deal", description: "Negocio por ID", inputSchema: schemas.dealsGetSchema }, (a) => dealsGet(a));
+server.registerTool("deals_timeline", { title: "Deal timeline", description: "Movimentacoes e tarefas", inputSchema: schemas.dealsTimelineSchema }, (a) => dealsTimeline(a));
+server.registerTool("pipeline_overview", { title: "Pipeline overview", description: "Snapshot e distribuicao", inputSchema: schemas.pipelineOverviewSchema }, (a) => pipelineOverview(a));
+server.registerTool("pipeline_stage_metrics", { title: "Stage metrics", description: "Metricas por coluna", inputSchema: schemas.pipelineStageMetricsSchema }, (a) => pipelineStageMetrics(a));
+server.registerTool("pipeline_trends", { title: "Pipeline trends", description: "Novos ganhos perdidos por periodo", inputSchema: schemas.pipelineTrendsSchema }, (a) => pipelineTrends(a));
+server.registerTool("pipeline_aging", { title: "Pipeline aging", description: "Parados e ranking risco", inputSchema: schemas.pipelineAgingSchema }, (a) => pipelineAging(a));
+server.registerTool("pipeline_rep_performance", { title: "Rep performance", description: "Por responsavel", inputSchema: schemas.pipelineRepPerformanceSchema }, (a) => pipelineRepPerformance(a));
+server.registerTool("pipeline_report", { title: "Pipeline full report", description: "Relatório completo: leads por status, valor em análise (forecast), valores ganhos/perdidos, tempo médio por coluna", inputSchema: schemas.pipelineReportSchema }, (a) => pipelineReport(a));
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/schemas/inputs.d.ts

@@ -0,0 +1,232 @@
+import { z } from "zod";
+export declare const pipelineIdSchema: z.ZodOptional<z.ZodNumber>;
+export declare const rangeSchema: z.ZodOptional<z.ZodObject<{
+    start: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    end: z.ZodUnion<[z.ZodString, z.ZodString]>;
+}, "strip", z.ZodTypeAny, {
+    start: string;
+    end: string;
+}, {
+    start: string;
+    end: string;
+}>>;
+export declare const timezoneSchema: z.ZodDefault<z.ZodString>;
+export declare const groupBySchema: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter"]>>;
+export declare const ownerIdSchema: z.ZodOptional<z.ZodNumber>;
+export declare const includeValueSchema: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+export declare const pipelineOverviewSchema: z.ZodObject<{
+    pipeline_id: z.ZodOptional<z.ZodNumber>;
+    range: z.ZodOptional<z.ZodObject<{
+        start: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        end: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        start: string;
+        end: string;
+    }, {
+        start: string;
+        end: string;
+    }>>;
+    timezone: z.ZodDefault<z.ZodString>;
+    group_by: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter"]>>;
+    owner_id: z.ZodOptional<z.ZodNumber>;
+    include_value: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    timezone: string;
+    include_value: boolean;
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    group_by?: "day" | "week" | "month" | "quarter" | undefined;
+    owner_id?: number | undefined;
+}, {
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    timezone?: string | undefined;
+    group_by?: "day" | "week" | "month" | "quarter" | undefined;
+    owner_id?: number | undefined;
+    include_value?: boolean | undefined;
+}>;
+export declare const pipelineStageMetricsSchema: z.ZodObject<{
+    pipeline_id: z.ZodOptional<z.ZodNumber>;
+    range: z.ZodOptional<z.ZodObject<{
+        start: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        end: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        start: string;
+        end: string;
+    }, {
+        start: string;
+        end: string;
+    }>>;
+    owner_id: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    owner_id?: number | undefined;
+}, {
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    owner_id?: number | undefined;
+}>;
+export declare const pipelineTrendsSchema: z.ZodObject<{
+    pipeline_id: z.ZodOptional<z.ZodNumber>;
+    range: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        start: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        end: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        start: string;
+        end: string;
+    }, {
+        start: string;
+        end: string;
+    }>>>;
+    group_by: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter"]>>;
+    owner_id: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    group_by?: "day" | "week" | "month" | "quarter" | undefined;
+    owner_id?: number | undefined;
+}, {
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    group_by?: "day" | "week" | "month" | "quarter" | undefined;
+    owner_id?: number | undefined;
+}>;
+export declare const pipelineAgingSchema: z.ZodObject<{
+    pipeline_id: z.ZodOptional<z.ZodNumber>;
+    days_without_activity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    days_without_activity: number;
+    limit: number;
+    pipeline_id?: number | undefined;
+}, {
+    pipeline_id?: number | undefined;
+    days_without_activity?: number | undefined;
+    limit?: number | undefined;
+}>;
+export declare const pipelineRepPerformanceSchema: z.ZodObject<{
+    pipeline_id: z.ZodOptional<z.ZodNumber>;
+    range: z.ZodOptional<z.ZodObject<{
+        start: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        end: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        start: string;
+        end: string;
+    }, {
+        start: string;
+        end: string;
+    }>>;
+    owner_id: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    owner_id?: number | undefined;
+}, {
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    owner_id?: number | undefined;
+}>;
+export declare const pipelineReportSchema: z.ZodObject<{
+    pipeline_id: z.ZodOptional<z.ZodNumber>;
+    todos_os_funis: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    range: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        start: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        end: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        start: string;
+        end: string;
+    }, {
+        start: string;
+        end: string;
+    }>>>;
+    owner_id: z.ZodOptional<z.ZodNumber>;
+    include_tempo_medio: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    todos_os_funis: boolean;
+    include_tempo_medio: boolean;
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    owner_id?: number | undefined;
+}, {
+    pipeline_id?: number | undefined;
+    range?: {
+        start: string;
+        end: string;
+    } | undefined;
+    owner_id?: number | undefined;
+    todos_os_funis?: boolean | undefined;
+    include_tempo_medio?: boolean | undefined;
+}>;
+export declare const dealsListSchema: z.ZodObject<{
+    pipeline_id: z.ZodOptional<z.ZodNumber>;
+    stage_id: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<["open", "won", "lost"]>>;
+    owner_id: z.ZodOptional<z.ZodNumber>;
+    organization_id: z.ZodOptional<z.ZodNumber>;
+    with_custom_fields: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    per_page: number;
+    with_custom_fields: boolean;
+    organization_id?: number | undefined;
+    status?: "won" | "lost" | "open" | undefined;
+    pipeline_id?: number | undefined;
+    owner_id?: number | undefined;
+    stage_id?: number | undefined;
+}, {
+    organization_id?: number | undefined;
+    page?: number | undefined;
+    per_page?: number | undefined;
+    status?: "won" | "lost" | "open" | undefined;
+    pipeline_id?: number | undefined;
+    owner_id?: number | undefined;
+    stage_id?: number | undefined;
+    with_custom_fields?: boolean | undefined;
+}>;
+export declare const dealsGetSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    with_custom_fields: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    with_custom_fields: boolean;
+}, {
+    id: number;
+    with_custom_fields?: boolean | undefined;
+}>;
+export declare const dealsTimelineSchema: z.ZodObject<{
+    id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+}, {
+    id: number;
+}>;

package/dist/schemas/inputs.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+export const pipelineIdSchema = z.number().int().positive().optional();
+export const rangeSchema = z
+    .object({
+    start: z.string().datetime().or(z.string().regex(/^\d{4}-\d{2}-\d{2}$/)),
+    end: z.string().datetime().or(z.string().regex(/^\d{4}-\d{2}-\d{2}$/)),
+})
+    .optional();
+export const timezoneSchema = z.string().default("America/Sao_Paulo");
+export const groupBySchema = z.enum(["day", "week", "month", "quarter"]).optional();
+export const ownerIdSchema = z.number().int().positive().optional();
+export const includeValueSchema = z.boolean().optional().default(true);
+export const pipelineOverviewSchema = z.object({
+    pipeline_id: pipelineIdSchema,
+    range: rangeSchema,
+    timezone: timezoneSchema,
+    group_by: groupBySchema,
+    owner_id: ownerIdSchema,
+    include_value: includeValueSchema,
+});
+export const pipelineStageMetricsSchema = z.object({
+    pipeline_id: pipelineIdSchema,
+    range: rangeSchema,
+    owner_id: ownerIdSchema,
+});
+export const pipelineTrendsSchema = z.object({
+    pipeline_id: pipelineIdSchema,
+    range: rangeSchema.optional(),
+    group_by: groupBySchema,
+    owner_id: ownerIdSchema,
+});
+export const pipelineAgingSchema = z.object({
+    pipeline_id: pipelineIdSchema,
+    days_without_activity: z.number().int().min(0).optional().default(7),
+    limit: z.number().int().min(1).max(100).optional().default(20),
+});
+export const pipelineRepPerformanceSchema = z.object({
+    pipeline_id: pipelineIdSchema,
+    range: rangeSchema,
+    owner_id: ownerIdSchema,
+});
+export const pipelineReportSchema = z.object({
+    pipeline_id: pipelineIdSchema,
+    todos_os_funis: z.boolean().optional().default(true),
+    range: rangeSchema.optional(),
+    owner_id: ownerIdSchema,
+    include_tempo_medio: z.boolean().optional().default(true),
+});
+export const dealsListSchema = z.object({
+    pipeline_id: pipelineIdSchema,
+    stage_id: z.number().int().positive().optional(),
+    status: z.enum(["open", "won", "lost"]).optional(),
+    owner_id: ownerIdSchema,
+    organization_id: z.number().int().positive().optional(),
+    with_custom_fields: z.boolean().optional().default(true),
+    page: z.number().int().min(1).optional().default(1),
+    per_page: z.number().int().min(1).max(100).optional().default(50),
+});
+export const dealsGetSchema = z.object({
+    id: z.number().int().positive(),
+    with_custom_fields: z.boolean().optional().default(true),
+});
+export const dealsTimelineSchema = z.object({
+    id: z.number().int().positive(),
+});