zerosync-mcp 0.1.0

package/README.md

@@ -0,0 +1,116 @@
+# zerosync-mcp
+
+Servidor [MCP](https://modelcontextprotocol.io) (stdio) que expõe as ações do **ZeroSync** como ferramentas para assistentes de IA (Claude Desktop, n8n, código próprio, etc.).
+
+Ele é um wrapper fino sobre a **API REST pública v1** do ZeroSync (`https://app.zerosync.com.br/api/v1`), autenticado por um **Personal Access Token (PAT)**. O servidor não acessa o banco diretamente — todo o isolamento por usuário é garantido pela própria API.
+
+## Ferramentas disponíveis
+
+| Tool | O que faz | Endpoint v1 |
+| --- | --- | --- |
+| `criar_tarefa` | Cria tarefa/compromisso na agenda | `POST /tasks` |
+| `listar_agenda` | Lista tarefas de um dia | `GET /tasks` |
+| `lancar_despesa` | Lança uma despesa | `POST /transactions` (type=expense) |
+| `lancar_receita` | Lança uma receita | `POST /transactions` (type=income) |
+| `resumo_financeiro` | Resumo do mês (entradas/saídas/saldo) | `GET /finance/summary` |
+| `marcar_habito` | Marca um hábito como feito | `POST /habits/log` |
+| `listar_habitos` | Lista hábitos e status do dia | `GET /habits` |
+| `add_compra` | Adiciona item à lista de compras | `POST /shopping` |
+| `criar_objetivo` | Cria um objetivo/meta | `POST /goals` |
+| `add_nota` | Adiciona nota de diário | `POST /notes` |
+
+Cada ferramenta retorna o texto de resumo (`summary`) devolvido pela API.
+
+## Pré-requisitos
+
+- Node.js 18+ (testado em 20/22/24; usa o `fetch` global).
+- Um **Personal Access Token** do ZeroSync. Gere em `https://app.zerosync.com.br` (seção de API/tokens).
+
+## Variáveis de ambiente
+
+| Variável | Obrigatória | Default | Descrição |
+| --- | --- | --- | --- |
+| `ZEROSYNC_API_KEY` | **Sim** | — | Seu Personal Access Token (PAT). |
+| `ZEROSYNC_API_URL` | Não | `https://app.zerosync.com.br/api/v1` | Base da API v1 (útil para apontar para um ambiente local/staging). |
+
+Se `ZEROSYNC_API_KEY` não estiver definida, o servidor encerra com uma mensagem clara.
+
+## Instalação e build
+
+```bash
+cd packages/zerosync-mcp
+npm install
+npm run build   # compila TypeScript para dist/
+```
+
+Para desenvolvimento sem build, use `npm run dev` (executa via `tsx`).
+
+## Conectar no Claude Desktop
+
+Edite o arquivo de configuração do Claude Desktop:
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Adicione o servidor em `mcpServers`. A forma recomendada é via `npx` (quando o pacote estiver publicado no npm):
+
+```json
+{
+  "mcpServers": {
+    "zerosync": {
+      "command": "npx",
+      "args": ["-y", "zerosync-mcp"],
+      "env": {
+        "ZEROSYNC_API_KEY": "seu_personal_access_token_aqui"
+      }
+    }
+  }
+}
+```
+
+### Rodando a partir do código local (sem publicar no npm)
+
+Aponte diretamente para o `dist/index.js` gerado pelo build:
+
+```json
+{
+  "mcpServers": {
+    "zerosync": {
+      "command": "node",
+      "args": ["C:\\Users\\voce\\Apps\\ZeroSync\\packages\\zerosync-mcp\\dist\\index.js"],
+      "env": {
+        "ZEROSYNC_API_KEY": "seu_personal_access_token_aqui"
+      }
+    }
+  }
+}
+```
+
+Para apontar para um ambiente local da API, adicione `"ZEROSYNC_API_URL": "http://localhost:3000/api/v1"` ao bloco `env`.
+
+Depois de salvar, reinicie o Claude Desktop. As ferramentas `criar_tarefa`, `lancar_despesa`, etc. ficarão disponíveis.
+
+## Usar com n8n / código próprio
+
+Qualquer cliente MCP que fale stdio funciona. Inicie o processo com a env definida:
+
+```bash
+ZEROSYNC_API_KEY=seu_token npx -y zerosync-mcp
+# ou, a partir do build local:
+ZEROSYNC_API_KEY=seu_token node dist/index.js
+```
+
+No Windows (PowerShell):
+
+```powershell
+$env:ZEROSYNC_API_KEY = "seu_token"; node dist/index.js
+```
+
+## Erros comuns
+
+| Mensagem | Causa | Solução |
+| --- | --- | --- |
+| `ZEROSYNC_API_KEY não definida` | Env ausente | Defina a variável com seu PAT. |
+| `Token inválido ou revogado` | Token errado/revogado | Gere um novo PAT no ZeroSync. |
+| `Seu token não tem permissão (escopo)` | PAT sem o escopo necessário (read/write) | Gere um token com o escopo adequado. |
+| `Não consegui falar com o ZeroSync` | Rede/URL incorreta | Verifique conexão e `ZEROSYNC_API_URL`. |

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/** Erro HTTP da API v1, carregando status + corpo já parseado quando possível. */
+export declare class ApiError extends Error {
+    status: number;
+    code: string;
+    body?: unknown | undefined;
+    constructor(status: number, code: string, message: string, body?: unknown | undefined);
+}
+export type HttpMethod = "GET" | "POST" | "PATCH" | "DELETE";
+/**
+ * Faz uma chamada autenticada à API v1.
+ *
+ * - `path` é relativo à base (ex: "/tasks", "/finance/summary?month=2026-06").
+ * - Em sucesso, retorna o corpo JSON já parseado (ou `{}` se vazio).
+ * - Em erro HTTP, lança `ApiError` com a mensagem do campo `error` da API
+ *   (helper `apiError` do backend devolve `{ error: "<code>", ... }`).
+ */
+export declare function call<T = unknown>(config: {
+    apiKey: string;
+    apiUrl: string;
+}, method: HttpMethod, path: string, body?: unknown): Promise<T>;

package/dist/index.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+/**
+ * zerosync-mcp — servidor MCP (stdio) que expõe as ações do ZeroSync.
+ *
+ * Cada tool é um wrapper fino sobre a API REST pública v1 do ZeroSync
+ * (`https://app.zerosync.com.br/api/v1`), autenticada por um Personal Access
+ * Token (PAT) do usuário. O servidor NÃO fala com o banco direto: ele só faz
+ * HTTP, então o isolamento por usuário continua garantido pela própria API.
+ *
+ * Variáveis de ambiente:
+ *   - ZEROSYNC_API_KEY  (obrigatória) — o PAT do usuário (`Bearer <token>`).
+ *   - ZEROSYNC_API_URL  (opcional)    — base da API. Default:
+ *                                        https://app.zerosync.com.br/api/v1
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { tools } from "./tools.js";
+const DEFAULT_API_URL = "https://app.zerosync.com.br/api/v1";
+/** Configuração lida do ambiente. Falha cedo e com mensagem clara. */
+function loadConfig() {
+    const apiKey = process.env.ZEROSYNC_API_KEY?.trim();
+    if (!apiKey) {
+        console.error("[zerosync-mcp] ERRO: variável de ambiente ZEROSYNC_API_KEY não definida.\n" +
+            "Gere um Personal Access Token em https://app.zerosync.com.br e exponha-o como ZEROSYNC_API_KEY.");
+        process.exit(1);
+    }
+    const apiUrl = (process.env.ZEROSYNC_API_URL?.trim() || DEFAULT_API_URL).replace(/\/+$/, "");
+    return { apiKey, apiUrl };
+}
+/** Erro HTTP da API v1, carregando status + corpo já parseado quando possível. */
+export class ApiError extends Error {
+    status;
+    code;
+    body;
+    constructor(status, code, message, body) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.body = body;
+        this.name = "ApiError";
+    }
+}
+/**
+ * Faz uma chamada autenticada à API v1.
+ *
+ * - `path` é relativo à base (ex: "/tasks", "/finance/summary?month=2026-06").
+ * - Em sucesso, retorna o corpo JSON já parseado (ou `{}` se vazio).
+ * - Em erro HTTP, lança `ApiError` com a mensagem do campo `error` da API
+ *   (helper `apiError` do backend devolve `{ error: "<code>", ... }`).
+ */
+export async function call(config, method, path, body) {
+    const url = `${config.apiUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    let res;
+    try {
+        res = await fetch(url, {
+            method,
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                Accept: "application/json",
+                ...(body !== undefined ? { "Content-Type": "application/json" } : {}),
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+    }
+    catch (err) {
+        // Falha de rede / DNS / conexão recusada.
+        throw new ApiError(0, "network_error", `Não consegui falar com o ZeroSync (${url}): ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const text = await res.text();
+    let parsed = undefined;
+    if (text.length > 0) {
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            parsed = text; // resposta não-JSON (ex: HTML de erro 5xx atrás de proxy)
+        }
+    }
+    if (!res.ok) {
+        const code = extractErrorCode(parsed) ?? `http_${res.status}`;
+        throw new ApiError(res.status, code, humanizeError(res.status, code), parsed);
+    }
+    return (parsed ?? {});
+}
+/** Extrai o campo `error` (string) do corpo de erro padrão da API v1. */
+function extractErrorCode(parsed) {
+    if (parsed && typeof parsed === "object" && "error" in parsed) {
+        const err = parsed.error;
+        if (typeof err === "string" && err.length > 0)
+            return err;
+    }
+    return null;
+}
+/** Mensagens amigáveis em PT-BR para os erros padrão da API v1. */
+function humanizeError(status, code) {
+    switch (code) {
+        case "missing_token":
+            return "Token ausente. Configure ZEROSYNC_API_KEY com seu PAT do ZeroSync.";
+        case "invalid_token":
+            return "Token inválido ou revogado. Gere um novo PAT no ZeroSync.";
+        case "insufficient_scope":
+            return "Seu token não tem permissão (escopo) para esta operação.";
+        default:
+            if (status === 404)
+                return "Recurso não encontrado.";
+            if (status === 400)
+                return `Requisição inválida (${code}).`;
+            if (status >= 500)
+                return `Erro interno do ZeroSync (${code}).`;
+            return `Erro ${status}: ${code}`;
+    }
+}
+async function main() {
+    const config = loadConfig();
+    const server = new Server({ name: "zerosync-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+    const byName = new Map(tools.map((t) => [t.name, t]));
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const tool = byName.get(req.params.name);
+        if (!tool) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Tool desconhecida: ${req.params.name}` }],
+            };
+        }
+        try {
+            const args = (req.params.arguments ?? {});
+            const text = await tool.run((method, path, b) => call(config, method, path, b), args);
+            return { content: [{ type: "text", text }] };
+        }
+        catch (err) {
+            const message = err instanceof ApiError
+                ? err.message
+                : err instanceof Error
+                    ? err.message
+                    : String(err);
+            return { isError: true, content: [{ type: "text", text: message }] };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // stderr não polui o protocolo (stdout é reservado pro JSON-RPC do MCP).
+    console.error("[zerosync-mcp] conectado via stdio. API base:", config.apiUrl);
+}
+main().catch((err) => {
+    console.error("[zerosync-mcp] falha fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,17 @@
+import type { HttpMethod } from "./index.js";
+/** Assinatura do helper de chamada HTTP injetado pelo servidor. */
+export type Caller = <T = unknown>(method: HttpMethod, path: string, body?: unknown) => Promise<T>;
+export interface ToolDef {
+    name: string;
+    description: string;
+    /** JSON Schema (draft-07-ish) exposto no list_tools do MCP. */
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+    /** Valida + executa. Recebe o caller e os args crus do cliente. */
+    run: (call: Caller, args: Record<string, unknown>) => Promise<string>;
+}
+export declare const tools: ToolDef[];

package/dist/tools.js

@@ -0,0 +1,409 @@
+/**
+ * Declaração das MCP tools do ZeroSync.
+ *
+ * Cada tool espelha um endpoint da API v1. O fluxo é sempre:
+ *   1. valida os argumentos com Zod (mensagens em PT-BR),
+ *   2. chama a API via o helper `call` injetado,
+ *   3. extrai e retorna um texto legível (o `summary`/resultado da API).
+ *
+ * `inputSchema` é JSON Schema (o que o protocolo MCP exige no list_tools).
+ * Mantemos JSON Schema + Zod lado a lado: o JSON Schema é o contrato exposto
+ * ao cliente MCP; o Zod garante a validação em runtime antes do fetch.
+ */
+import { z } from "zod";
+// ----------------------------------------------------------------- helpers
+const YMD = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/, "Data esperada no formato AAAA-MM-DD.");
+const HHMM = z
+    .string()
+    .regex(/^\d{2}:\d{2}$/, "Hora esperada no formato HH:MM.");
+const YM = z
+    .string()
+    .regex(/^\d{4}-\d{2}$/, "Mês esperado no formato AAAA-MM.");
+/** Constrói um ToolDef validando os args com um schema Zod antes de rodar. */
+function defineTool(opts) {
+    return {
+        name: opts.name,
+        description: opts.description,
+        inputSchema: opts.inputSchema,
+        run: async (call, raw) => {
+            const parsed = opts.schema.safeParse(raw);
+            if (!parsed.success) {
+                const msg = parsed.error.issues
+                    .map((i) => `${i.path.join(".") || "(raiz)"}: ${i.message}`)
+                    .join("; ");
+                throw new Error(`Argumentos inválidos — ${msg}`);
+            }
+            return opts.handler(call, parsed.data);
+        },
+    };
+}
+/** Remove chaves undefined pra não enviar lixo no corpo JSON. */
+function clean(obj) {
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+/** Monta uma querystring a partir de pares definidos. */
+function qs(params) {
+    const sp = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "")
+            sp.set(k, v);
+    }
+    const s = sp.toString();
+    return s ? `?${s}` : "";
+}
+/**
+ * Extrai um texto legível de uma resposta da API.
+ *
+ * A v1 padroniza ações de domínio como `{ summary, entityType?, entityId? }`
+ * (ActionResult). Alguns endpoints de leitura devolvem outros formatos
+ * (`{ result }`, `{ message }`, listas), então tentamos os campos comuns e
+ * caímos pro JSON cru como último recurso.
+ */
+function textFrom(res, fallback = "Operação concluída.") {
+    if (res == null)
+        return fallback;
+    if (typeof res === "string")
+        return res;
+    if (typeof res === "object") {
+        const o = res;
+        for (const key of ["summary", "result", "message", "text"]) {
+            const v = o[key];
+            if (typeof v === "string" && v.trim())
+                return v;
+        }
+    }
+    try {
+        return JSON.stringify(res, null, 2);
+    }
+    catch {
+        return fallback;
+    }
+}
+// ----------------------------------------------------------------- schemas
+const criarTarefaSchema = z.object({
+    title: z.string().min(1, "Título obrigatório."),
+    date: YMD.optional(),
+    start_time: HHMM.optional(),
+    duration_minutes: z.number().int().positive().optional(),
+    description: z.string().optional(),
+    category: z.string().optional(),
+});
+const listarAgendaSchema = z.object({
+    date: YMD.optional(),
+});
+const transacaoSchema = z.object({
+    amount: z.number().positive("O valor deve ser maior que zero."),
+    description: z.string().min(1, "Descrição obrigatória."),
+    category: z.string().optional(),
+    account: z.string().optional(),
+    date: YMD.optional(),
+});
+const resumoFinanceiroSchema = z.object({
+    month: YM.optional(),
+});
+const marcarHabitoSchema = z.object({
+    habit_name: z.string().min(1, "Nome do hábito obrigatório."),
+    quantity: z.number().positive().optional(),
+    date: YMD.optional(),
+});
+const listarHabitosSchema = z.object({
+    date: YMD.optional(),
+});
+const addCompraSchema = z.object({
+    title: z.string().min(1, "Título obrigatório."),
+    horizon: z.enum(["short", "medium", "long"]).optional(),
+    quantity: z.number().int().positive().optional(),
+    estimated_price: z.number().nonnegative().optional(),
+    category: z.string().optional(),
+    notes: z.string().optional(),
+});
+const criarObjetivoSchema = z.object({
+    title: z.string().min(1, "Título obrigatório."),
+    description: z.string().optional(),
+    horizon: z.enum(["short", "medium", "long"]).optional(),
+    target_date: YMD.optional(),
+});
+const addNotaSchema = z.object({
+    content: z.string().min(1, "Conteúdo obrigatório."),
+    title: z.string().optional(),
+    date: YMD.optional(),
+    type: z.enum(["journal", "gratidao", "reflexao"]).optional(),
+    mood: z.number().int().min(1).max(5).optional(),
+    tags: z.array(z.string()).optional(),
+});
+// ----------------------------------------------------------------- tools
+export const tools = [
+    defineTool({
+        name: "criar_tarefa",
+        description: "Cria uma tarefa/compromisso na agenda do ZeroSync. Use para agendar algo num dia e horário.",
+        schema: criarTarefaSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: { type: "string", description: "Título da tarefa." },
+                date: {
+                    type: "string",
+                    description: "Data no formato AAAA-MM-DD. Default: hoje.",
+                },
+                start_time: {
+                    type: "string",
+                    description: "Hora de início HH:MM. Default: 09:00.",
+                },
+                duration_minutes: {
+                    type: "integer",
+                    description: "Duração em minutos. Default: 30.",
+                },
+                description: { type: "string", description: "Detalhes da tarefa." },
+                category: {
+                    type: "string",
+                    description: "Nome da categoria (aproximado; será resolvido).",
+                },
+            },
+            required: ["title"],
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("POST", "/tasks", clean(args));
+            return textFrom(res, `Tarefa "${args.title}" criada.`);
+        },
+    }),
+    defineTool({
+        name: "listar_agenda",
+        description: "Consulta a agenda do ZeroSync para um dia (lista as tarefas e horários).",
+        schema: listarAgendaSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                date: {
+                    type: "string",
+                    description: "Data AAAA-MM-DD. Default: hoje.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("GET", `/tasks${qs({ date: args.date })}`);
+            return textFrom(res, "Nenhuma tarefa encontrada.");
+        },
+    }),
+    defineTool({
+        name: "lancar_despesa",
+        description: "Lança uma despesa (saída de dinheiro) nas finanças do ZeroSync.",
+        schema: transacaoSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                amount: { type: "number", description: "Valor da despesa (positivo)." },
+                description: { type: "string", description: "Descrição da despesa." },
+                category: {
+                    type: "string",
+                    description: "Categoria (aproximada; será resolvida).",
+                },
+                account: {
+                    type: "string",
+                    description: "Conta de origem (aproximada; será resolvida).",
+                },
+                date: { type: "string", description: "Data AAAA-MM-DD. Default: hoje." },
+            },
+            required: ["amount", "description"],
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("POST", "/transactions", {
+                type: "expense",
+                ...clean(args),
+            });
+            return textFrom(res, "Despesa lançada.");
+        },
+    }),
+    defineTool({
+        name: "lancar_receita",
+        description: "Lança uma receita (entrada de dinheiro) nas finanças do ZeroSync.",
+        schema: transacaoSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                amount: { type: "number", description: "Valor da receita (positivo)." },
+                description: { type: "string", description: "Descrição da receita." },
+                category: {
+                    type: "string",
+                    description: "Categoria (aproximada; será resolvida).",
+                },
+                account: {
+                    type: "string",
+                    description: "Conta de destino (aproximada; será resolvida).",
+                },
+                date: { type: "string", description: "Data AAAA-MM-DD. Default: hoje." },
+            },
+            required: ["amount", "description"],
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("POST", "/transactions", {
+                type: "income",
+                ...clean(args),
+            });
+            return textFrom(res, "Receita lançada.");
+        },
+    }),
+    defineTool({
+        name: "resumo_financeiro",
+        description: "Resumo financeiro do mês: entradas, saídas, líquido e saldo das contas.",
+        schema: resumoFinanceiroSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                month: {
+                    type: "string",
+                    description: "Mês AAAA-MM. Default: mês atual.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("GET", `/finance/summary${qs({ month: args.month })}`);
+            return textFrom(res, "Sem dados financeiros para o período.");
+        },
+    }),
+    defineTool({
+        name: "marcar_habito",
+        description: "Marca um hábito como feito no ZeroSync (registra o cumprimento do dia).",
+        schema: marcarHabitoSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                habit_name: {
+                    type: "string",
+                    description: "Nome do hábito (aproximado; será resolvido).",
+                },
+                quantity: {
+                    type: "number",
+                    description: "Quantidade registrada (ex: 8 copos). Opcional.",
+                },
+                date: { type: "string", description: "Data AAAA-MM-DD. Default: hoje." },
+            },
+            required: ["habit_name"],
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("POST", "/habits/log", clean(args));
+            return textFrom(res, `Hábito "${args.habit_name}" marcado.`);
+        },
+    }),
+    defineTool({
+        name: "listar_habitos",
+        description: "Lista os hábitos do ZeroSync e quais já foram cumpridos no dia.",
+        schema: listarHabitosSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                date: {
+                    type: "string",
+                    description: "Data AAAA-MM-DD para o status do dia. Default: hoje.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("GET", `/habits${qs({ date: args.date })}`);
+            return textFrom(res, "Nenhum hábito cadastrado.");
+        },
+    }),
+    defineTool({
+        name: "add_compra",
+        description: "Adiciona um item à lista de compras/desejos do ZeroSync (com horizonte de prazo).",
+        schema: addCompraSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: { type: "string", description: "O que comprar." },
+                horizon: {
+                    type: "string",
+                    enum: ["short", "medium", "long"],
+                    description: "Horizonte: short (curto), medium, long. Default: short.",
+                },
+                quantity: { type: "integer", description: "Quantidade. Opcional." },
+                estimated_price: {
+                    type: "number",
+                    description: "Preço estimado. Opcional.",
+                },
+                category: { type: "string", description: "Categoria. Opcional." },
+                notes: { type: "string", description: "Observações. Opcional." },
+            },
+            required: ["title"],
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("POST", "/shopping", clean(args));
+            return textFrom(res, `Compra "${args.title}" adicionada à lista.`);
+        },
+    }),
+    defineTool({
+        name: "criar_objetivo",
+        description: "Cria um objetivo/meta no ZeroSync (com horizonte e data alvo opcional).",
+        schema: criarObjetivoSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: { type: "string", description: "Título do objetivo." },
+                description: { type: "string", description: "Descrição. Opcional." },
+                horizon: {
+                    type: "string",
+                    enum: ["short", "medium", "long"],
+                    description: "Horizonte. Default: medium.",
+                },
+                target_date: {
+                    type: "string",
+                    description: "Data alvo AAAA-MM-DD. Opcional.",
+                },
+            },
+            required: ["title"],
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("POST", "/goals", clean(args));
+            return textFrom(res, `Objetivo "${args.title}" criado.`);
+        },
+    }),
+    defineTool({
+        name: "add_nota",
+        description: "Adiciona uma nota/registro de diário (journal, gratidão ou reflexão) no ZeroSync.",
+        schema: addNotaSchema,
+        inputSchema: {
+            type: "object",
+            properties: {
+                content: { type: "string", description: "Conteúdo da nota." },
+                title: { type: "string", description: "Título. Opcional." },
+                date: { type: "string", description: "Data AAAA-MM-DD. Default: hoje." },
+                type: {
+                    type: "string",
+                    enum: ["journal", "gratidao", "reflexao"],
+                    description: "Tipo da nota. Default: journal.",
+                },
+                mood: {
+                    type: "integer",
+                    description: "Humor de 1 a 5. Opcional.",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Tags. Opcional.",
+                },
+            },
+            required: ["content"],
+            additionalProperties: false,
+        },
+        handler: async (call, args) => {
+            const res = await call("POST", "/notes", clean(args));
+            return textFrom(res, "Nota adicionada.");
+        },
+    }),
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB,4EAA4E;AAC5E,MAAM,GAAG,GAAG,CAAC;KACV,MAAM,EAAE;KACR,KAAK,CAAC,qBAAqB,EAAE,sCAAsC,CAAC,CAAC;AACxE,MAAM,IAAI,GAAG,CAAC;KACX,MAAM,EAAE;KACR,KAAK,CAAC,eAAe,EAAE,iCAAiC,CAAC,CAAC;AAC7D,MAAM,EAAE,GAAG,CAAC;KACT,MAAM,EAAE;KACR,KAAK,CAAC,eAAe,EAAE,kCAAkC,CAAC,CAAC;AAE9D,8EAA8E;AAC9E,SAAS,UAAU,CAAsB,IAMxC;IACC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;qBAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;qBAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,SAAS,KAAK,CAAoC,GAAM;IACtD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,GAAiB,CAAC;AAC3B,CAAC;AAED,yDAAyD;AACzD,SAAS,EAAE,CAAC,MAA0C;IACpD,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;YAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACxB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAC,GAAY,EAAE,QAAQ,GAAG,qBAAqB;IAC9D,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,GAA8B,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE;gBAAE,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IAC/C,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE;IACpB,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE;IAC3B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACxD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,EAAE,CAAC,QAAQ,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6BAA6B,CAAC;IAC5D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IAC/C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvD,WAAW,EAAE,GAAG,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,KAAK,GAAc;IAC9B,UAAU,CAAC;QACT,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,6FAA6F;QAC/F,MAAM,EAAE,iBAAiB;QACzB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;gBAC3D,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uCAAuC;iBACrD;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,kCAAkC;iBAChD;gBACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;gBACnE,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iDAAiD;iBAC/D;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,OAAO,QAAQ,CAAC,GAAG,EAAE,WAAW,IAAI,CAAC,KAAK,WAAW,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0EAA0E;QAC5E,MAAM,EAAE,kBAAkB;QAC1B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAClE,OAAO,QAAQ,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,iEAAiE;QACnE,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;gBACvE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBACrE,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;gBACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;aACzE;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;YACnC,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE;gBAC9C,IAAI,EAAE,SAAS;gBACf,GAAG,KAAK,CAAC,IAAI,CAAC;aACf,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,mEAAmE;QACrE,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;gBACvE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBACrE,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gDAAgD;iBAC9D;gBACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;aACzE;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;YACnC,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE;gBAC9C,IAAI,EAAE,QAAQ;gBACd,GAAG,KAAK,CAAC,IAAI,CAAC;aACf,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,yEAAyE;QAC3E,MAAM,EAAE,sBAAsB;QAC9B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kCAAkC;iBAChD;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9E,OAAO,QAAQ,CAAC,GAAG,EAAE,uCAAuC,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,yEAAyE;QAC3E,MAAM,EAAE,kBAAkB;QAC1B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gDAAgD;iBAC9D;gBACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;aACzE;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;YACxB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3D,OAAO,QAAQ,CAAC,GAAG,EAAE,WAAW,IAAI,CAAC,UAAU,YAAY,CAAC,CAAC;QAC/D,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,iEAAiE;QACnE,MAAM,EAAE,mBAAmB;QAC3B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACnE,OAAO,QAAQ,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,mFAAmF;QACrF,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;gBACxD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;oBACjC,WAAW,EAAE,yDAAyD;iBACvE;gBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBACnE,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;iBACzC;gBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;gBACjE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;aACjE;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACzD,OAAO,QAAQ,CAAC,GAAG,EAAE,WAAW,IAAI,CAAC,KAAK,uBAAuB,CAAC,CAAC;QACrE,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,yEAAyE;QAC3E,MAAM,EAAE,mBAAmB;QAC3B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;gBAC7D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;gBACpE,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;oBACjC,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,OAAO,QAAQ,CAAC,GAAG,EAAE,aAAa,IAAI,CAAC,KAAK,WAAW,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,mFAAmF;QACrF,MAAM,EAAE,aAAa;QACrB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;gBAC7D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;gBAC3D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;gBACxE,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC;oBACzC,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,2BAA2B;iBACzC;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,iBAAiB;iBAC/B;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,OAAO,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;CACH,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "zerosync-mcp",
+  "version": "0.1.0",
+  "description": "MCP server (stdio) que expõe as ações do ZeroSync via API REST v1. Autentica com um Personal Access Token (PAT).",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "zerosync",
+    "agenda",
+    "finance",
+    "habits",
+    "assistant"
+  ],
+  "homepage": "https://app.zerosync.com.br/docs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pablosantosia/ZeroSync.git",
+    "directory": "packages/zerosync-mcp"
+  },
+  "bin": {
+    "zerosync-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.3"
+  }
+}