opf-br-mcp 0.7.0 → 0.9.3

package/README.md

@@ -21,6 +21,10 @@ acesso token-eficiente às regras do Open Finance Brasil.
 | `payments-common-rules` | Confluence público OFB (Serviços - SV) | Conteúdo comum aos produtos de Iniciação de Pagamentos (atores, Idempotência, Como Assinar o Payload, Convenções de data/fuso, Polling) — item por seção |
 | `payments-implementation-guides` | Confluence público OFB (Serviços - SV) | Guias de Implementação (Pix Automático, Agendamento Recorrente, Transferências Inteligentes, Liquidação de QR Codes) — item por seção |
 | `consents-v3-openapi` | GitHub Pages openbanking-brasil.github.io | Spec OpenAPI 3.3.1 da API de Consentimentos (Dados Cadastrais e Transacionais) |
+| `resources-v3-openapi` | GitHub Pages openbanking-brasil.github.io | Spec OpenAPI 3.1.0 da API de Recursos (`GET /resources`: status dos recursos compartilhados) |
+| `resources-v3-business-rules` | Confluence público OFB (Dados - DC) | Regras de negócio da API de Recursos 3.1.0 (Informações Gerais, Orientações) — item por seção |
+| `accounts-v2-openapi` | GitHub Pages openbanking-brasil.github.io | Spec OpenAPI 2.4.2 da API de Contas (listagem, saldos, transações, limites de cheque especial) |
+| `accounts-v2-business-rules` | Confluence público OFB (Dados - DC) | Regras de negócio da API de Contas 2.4.2 (Informações Gerais, Orientações — contraparte/IN BCB nº 371) — item por seção |
 | `pcm-openapi` | GitHub OpenBanking-Brasil/pcm-specs | Spec OpenAPI da PCM (reportes, hybrid-flow, opendata, consents/stock, credit-portabilities, payments/status) |
 | `pcm-business-rules` | Confluence público OFB | Regras de negócio da PCM (Reporte, Processamento, Divergências, Especificação Técnica, Manual de Integração) — item por seção |
 | `jornada-otimizada` | Confluence público OFB | Regras da Jornada Otimizada (Orientações Gerais, Transferências Inteligentes, Jornada sem Redirecionamento) — item por seção |
@@ -32,13 +36,27 @@ acesso token-eficiente às regras do Open Finance Brasil.
 
 ## Tools
 
-- `list_domains()` — descoberta: domínios, filtros e estado do cache
+- `list_domains()` — descoberta: domínios, filtros, versão da spec de origem e estado do cache
 - `search(domain, query?, filters?, limit?, offset?)` — busca filtrada, retorno compacto
 - `get_item(domain, id)` — registro completo
-- `refresh(domain?)` — força re-extração das fontes
+- `refresh(domain?)` — força re-extração das fontes. Prefira passar `domain`:
+  sem ele o server atualiza o que couber em 45s (o timeout padrão do cliente MCP
+  é 60s) e devolve o restante em `pendentes`, para o agente retomar um a um
 
 Fluxo recomendado para o agente: `list_domains` → `search` → `get_item`.
 
+### Qual versão estou usando?
+
+`list_domains` devolve `server: { name, version }` junto do catálogo, então o
+agente descobre a versão do server na mesma chamada com que descobre os domínios.
+Cada domínio que embrulha uma spec traz também o seu `specVersion`.
+
+Pela linha de comando:
+
+```bash
+npx opf-br-mcp --version
+```
+
 Domínios marcados como `live` (ex.: `portal`) consultam a fonte a cada chamada:
 não têm cache nem `refresh`, e `search` exige `query`. Quando um `search` em
 domínio comum retorna 0 resultados, a resposta inclui um `hint` sugerindo o
@@ -51,7 +69,12 @@ bem na janela de contexto de um agente, e despejá-la desperdiça tokens. A solu
 é **revelação progressiva** — o agente nunca recebe a spec completa de uma vez,
 apenas o mínimo necessário em cada etapa do funil:
 
-1. **`list_domains`** — catálogo barato: quais domínios e filtros existem.
+1. **`list_domains`** — catálogo barato: quais domínios e filtros existem. Os
+   filtros idênticos a uma família inteira de domínios (os 8 `*-openapi`, os 11
+   de seções do Confluence) saem uma única vez em `filterSets`; cada domínio
+   traz `filterSet` e só lista inline o que é próprio dele (em `*-openapi`,
+   apenas `path`, cujo exemplo varia por API). Os filtros aceitos por um domínio
+   são a união dos dois.
 2. **`search`** — índice **pesquisável e resumido**. Cada resultado traz só os
    campos leves (`id`, `type`, `path`, `method`, `summary`/`name`, `required`,
    `in`); o nó pesado da spec (`detail`) e a lista `refs` são removidos do

package/dist/index.js

@@ -18,14 +18,24 @@ function cacheDir() {
 function cachePath(domainId) {
   return join(cacheDir(), `${domainId}.json`);
 }
+function isCacheEntry(value) {
+  const entry = value;
+  return typeof entry === "object" && entry !== null && typeof entry.extractedAt === "string" && typeof entry.packageVersion === "string" && typeof entry.data === "object" && entry.data !== null && Array.isArray(entry.data.items);
+}
 function readCache(domainId) {
   const path = cachePath(domainId);
   if (!existsSync(path)) return null;
+  let parsed;
   try {
-    return JSON.parse(readFileSync(path, "utf8"));
+    parsed = JSON.parse(readFileSync(path, "utf8"));
   } catch {
     return null;
   }
+  if (!isCacheEntry(parsed)) {
+    console.error(`[opf-br-mcp] cache de ${domainId} tem forma inesperada; ignorando (${path})`);
+    return null;
+  }
+  return parsed;
 }
 function writeCache(domainId, data, packageVersion) {
   const entry = {
@@ -46,7 +56,7 @@ function isFresh(entry, ttlHours, now = /* @__PURE__ */ new Date()) {
 }
 
 // src/core/version.ts
-var PACKAGE_VERSION = "0.7.0";
+var PACKAGE_VERSION = "0.9.3";
 
 // src/core/data.ts
 async function getDomainData(domain, force = false, ctx) {
@@ -66,15 +76,52 @@ async function getDomainData(domain, force = false, ctx) {
   }
 }
 
+// src/core/filter-sets.ts
+var FILTER_SETS = {
+  openapi: [
+    { name: "method", description: "Verbo HTTP exato (ex.: POST)" },
+    { name: "schema", description: "Substring no nome do schema (case-insensitive)" },
+    {
+      name: "response",
+      description: "Substring no nome do components.responses, a chave usada no $ref (ex.: 202Webhook)"
+    },
+    {
+      name: "parameter",
+      description: "Substring no nome do components.parameters, a chave usada no $ref (ex.: xFapiInteractionId)"
+    },
+    {
+      name: "header",
+      description: "Substring no nome do components.headers, a chave usada no $ref (ex.: X-V)"
+    }
+  ],
+  sections: [
+    { name: "page", description: "Substring no t\xEDtulo da p\xE1gina Confluence" },
+    { name: "heading", description: "Substring no t\xEDtulo da se\xE7\xE3o (heading)" },
+    { name: "contains", description: "Substring no conte\xFAdo da se\xE7\xE3o" }
+  ]
+};
+
 // src/core/http.ts
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+function sleep(ms, signal) {
+  if (signal?.aborted) return Promise.resolve();
+  return new Promise((resolve) => {
+    const done = () => {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", done);
+      resolve();
+    };
+    const timer = setTimeout(done, ms);
+    signal?.addEventListener("abort", done, { once: true });
+  });
 }
 async function fetchWithRetry(url, opts) {
   let lastError;
   for (let attempt = 0; attempt <= opts.retryDelaysMs.length; attempt++) {
     if (opts.signal?.aborted) break;
-    if (attempt > 0) await sleep(opts.retryDelaysMs[attempt - 1]);
+    if (attempt > 0) {
+      await sleep(opts.retryDelaysMs[attempt - 1], opts.signal);
+      if (opts.signal?.aborted) break;
+    }
     const timeout = AbortSignal.timeout(3e4);
     const signal = opts.signal ? AbortSignal.any([opts.signal, timeout]) : timeout;
     let response;
@@ -134,8 +181,14 @@ async function fetchConfluencePage(baseUrl, pageId, retryDelaysMs, signal) {
   const apiUrl = `${baseUrl}/wiki/rest/api/content/${pageId}?expand=body.view`;
   const response = await fetchWithRetry(apiUrl, { retryDelaysMs, headers: HEADERS, signal });
   const json = await response.json();
+  const html = json?.body?.view?.value;
+  if (typeof html !== "string") {
+    throw new Error(
+      `resposta da p\xE1gina ${pageId} n\xE3o traz body.view.value; n\xE3o \xE9 conte\xFAdo Confluence expandido`
+    );
+  }
   return {
-    html: json.body?.view?.value ?? "",
+    html,
     title: json.title,
     url: `${baseUrl}/wiki${json._links?.webui ?? ""}`
   };
@@ -310,8 +363,8 @@ var pcmDomain = {
     const total = pcmConfig.pages.length;
     const pages = [];
     for (const [i, page] of pcmConfig.pages.entries()) {
+      if (i > 0) await sleep(pcmConfig.interRequestDelayMs, ctx?.signal);
       if (ctx?.signal?.aborted) throw new Error("Extra\xE7\xE3o cancelada pelo cliente");
-      if (i > 0) await sleep(pcmConfig.interRequestDelayMs);
       ctx?.onProgress?.(i, total, `Extraindo "${page.title}"`);
       const { html, url } = await fetchConfluencePage(
         pcmConfig.confluenceBaseUrl,
@@ -380,7 +433,13 @@ function refsOf(node, specName) {
   return [...out];
 }
 function parseOpenApiSpec(yamlText, specName) {
-  const spec = parse(yamlText);
+  const parsed = parse(yamlText);
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed) || !("paths" in parsed) && !("components" in parsed)) {
+    throw new Error(
+      `resposta de ${specName} n\xE3o \xE9 uma spec OpenAPI (sem "paths" nem "components"); in\xEDcio do conte\xFAdo: ${JSON.stringify(yamlText.slice(0, 80))}`
+    );
+  }
+  const spec = parsed;
   const items = [];
   for (const [path, pathItem] of Object.entries(spec.paths ?? {})) {
     for (const method of HTTP_METHODS) {
@@ -433,23 +492,12 @@ function createOpenApiDomain(config) {
     id: config.id,
     title: config.title,
     description: config.description,
+    specVersion: config.specVersion,
     ttlHours: 72,
+    filterSet: "openapi",
     filters: [
       { name: "path", description: `Substring no path do endpoint (ex.: ${config.pathExample})` },
-      { name: "method", description: "Verbo HTTP exato (ex.: POST)" },
-      { name: "schema", description: "Substring no nome do schema (case-insensitive)" },
-      {
-        name: "response",
-        description: "Substring no nome do components.responses, a chave usada no $ref (ex.: 202Webhook)"
-      },
-      {
-        name: "parameter",
-        description: "Substring no nome do components.parameters, a chave usada no $ref (ex.: xFapiInteractionId)"
-      },
-      {
-        name: "header",
-        description: "Substring no nome do components.headers, a chave usada no $ref (ex.: X-V)"
-      }
+      ...FILTER_SETS.openapi
     ],
     async extract(ctx) {
       if (ctx?.signal?.aborted) throw new Error("Extra\xE7\xE3o cancelada pelo cliente");
@@ -589,18 +637,16 @@ function createConfluenceSectionsDomain(config) {
     id: config.id,
     title: config.title,
     description: config.description,
+    specVersion: config.specVersion,
     ttlHours: 72,
-    filters: [
-      { name: "page", description: "Substring no t\xEDtulo da p\xE1gina Confluence" },
-      { name: "heading", description: "Substring no t\xEDtulo da se\xE7\xE3o (heading)" },
-      { name: "contains", description: "Substring no conte\xFAdo da se\xE7\xE3o" }
-    ],
+    filterSet: "sections",
+    filters: [...FILTER_SETS.sections],
     async extract(ctx) {
       const total = config.pages.length;
       const pages = [];
       for (const [i, page] of config.pages.entries()) {
+        if (i > 0) await sleep(config.interRequestDelayMs, ctx?.signal);
         if (ctx?.signal?.aborted) throw new Error("Extra\xE7\xE3o cancelada pelo cliente");
-        if (i > 0) await sleep(config.interRequestDelayMs);
         ctx?.onProgress?.(i, total, `Extraindo "${page.title}"`);
         const { html, url } = await fetchConfluencePage(
           config.confluenceBaseUrl,
@@ -637,6 +683,7 @@ function createConfluenceSectionsDomain(config) {
 var paymentsV5BusinessRulesConfig = {
   id: "payments-v5-business-rules",
   title: "API de Pagamentos v5 \u2014 Regras de neg\xF3cio (SV)",
+  specVersion: "5.0.0",
   description: "Regras de neg\xF3cio da API de Inicia\xE7\xE3o de Pagamentos (Pix) vers\xE3o 5.0.0 do Open Finance Brasil, extra\xEDdas das p\xE1ginas Confluence de Servi\xE7os (SV): Informa\xE7\xF5es Gerais (vis\xE3o geral dos endpoints e dicion\xE1rio de dados), Escopo da API (formas de inicia\xE7\xE3o suportadas: Pix imediato, agendado, agendado recorrente, QR Code est\xE1tico/din\xE2mico, Pix Saque, Pix Troco, Pix Composto), M\xE1quina de Estados (status do consentimento e do pagamento), Diagrama de Sequ\xEAncia, Valida\xE7\xE3o de informa\xE7\xF5es no DICT e Adapta\xE7\xF5es para consultas de recursos entre 4.0.1 e 5.0.0. Complementa payments-v5-openapi, que traz a spec (endpoints e schemas) da mesma vers\xE3o. Conte\xFAdo que vale para todos os produtos de inicia\xE7\xE3o (idempot\xEAncia, assinatura de payload, polling, formatos de data) est\xE1 em payments-common-rules. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
   confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
   interRequestDelayMs: 2e3,
@@ -673,6 +720,7 @@ var enrollmentsV2Domain = createOpenApiDomain(enrollmentsV2Config);
 var enrollmentsV2BusinessRulesConfig = {
   id: "enrollments-v2-business-rules",
   title: "API de V\xEDnculo de Dispositivo v2 \u2014 Regras de neg\xF3cio (SV)",
+  specVersion: "2.2.0",
   description: "Regras de neg\xF3cio da API de V\xEDnculo de Dispositivo (Enrollments / Jornada Sem Redirecionamento) vers\xE3o 2.2.0 do Open Finance Brasil, extra\xEDdas das p\xE1ginas Confluence de Servi\xE7os (SV): Informa\xE7\xF5es Gerais, M\xE1quina de estados (vincula\xE7\xE3o de conta, autoriza\xE7\xE3o de consentimento e do consentimento recorrente), Edi\xE7\xE3o do v\xEDnculo de dispositivo (campos edit\xE1veis e condi\xE7\xF5es) e FAQ - JSR (perguntas e respostas por categoria). Complementa enrollments-v2-openapi, que traz a spec (endpoints e schemas) do mesmo major \u2014 hoje na 2.3.0, enquanto estas p\xE1ginas do Confluence ainda s\xE3o as da 2.2.0. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
   confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
   interRequestDelayMs: 2e3,
@@ -709,6 +757,7 @@ var automaticPaymentsV2Domain = createOpenApiDomain(automaticPaymentsV2Config);
 var automaticPaymentsV2BusinessRulesConfig = {
   id: "automatic-payments-v2-business-rules",
   title: "API de Pagamentos Autom\xE1ticos v2 \u2014 Regras de neg\xF3cio (SV)",
+  specVersion: "2.2.0",
   description: "Regras de neg\xF3cio da API de Pagamentos Autom\xE1ticos (Pix Autom\xE1tico e Transfer\xEAncias Inteligentes) vers\xE3o 2.2.0 do Open Finance Brasil, extra\xEDdas das p\xE1ginas Confluence de Servi\xE7os (SV): Informa\xE7\xF5es Gerais (vis\xE3o geral dos endpoints e dicion\xE1rio de dados), M\xE1quina de Estados (status do consentimento recorrente e do pagamento), Edi\xE7\xE3o do consentimento (campos edit\xE1veis e condi\xE7\xF5es), Tentativas Intradia e Extradia para Pix Autom\xE1tico (janelas de liquida\xE7\xE3o, retentativas, e2eID) e Adapta\xE7\xF5es para consultas de recursos entre 1.0.0 e 2.2.0. Complementa automatic-payments-v2-openapi, que traz a spec (endpoints e schemas) da mesma vers\xE3o. O guia de implementa\xE7\xE3o passo a passo do Pix Autom\xE1tico est\xE1 em payments-implementation-guides. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
   confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
   interRequestDelayMs: 2e3,
@@ -784,18 +833,91 @@ var consentsV3Config = {
 // src/domains/consents-v3-openapi/index.ts
 var consentsV3Domain = createOpenApiDomain(consentsV3Config);
 
+// src/domains/resources-v3-openapi/config.ts
+var resourcesV3Config = {
+  id: "resources-v3-openapi",
+  title: "API de Recursos \u2014 spec OpenAPI 3.1.0",
+  description: "Spec OpenAPI oficial da API de Recursos (Resources) do Open Finance Brasil, vers\xE3o 3.1.0. Endpoint \xFAnico (GET /resources) que lista os recursos compartilhados pelo cliente e o status de cada um, considerando a disponibilidade do recurso e o status do consentimento relacionado \u2014 \xE9 o ponto de partida de qualquer jornada de Dados Cadastrais e Transacionais, pois diz o que a receptora pode de fato consultar. O consentimento que a habilita fica em consents-v3-openapi; as contas em si, em accounts-v2-openapi. Itens type=operation, type=schema (ex.: ResponseResourceList, ResourceData com enum de status) e os components alvos dos $ref: type=response e type=parameter. Regras de neg\xF3cio da mesma API em resources-v3-business-rules. search devolve resumos; use get_item para o n\xF3 completo da spec \u2014 nas opera\xE7\xF5es o campo `refs` traz os ids dos components referenciados, prontos para get_item.",
+  pathExample: "/resources",
+  specName: "resources",
+  specVersion: "3.1.0",
+  url: "https://openbanking-brasil.github.io/openapi/swagger-apis/resources/3.1.0.yml",
+  retryDelaysMs: [2e3, 4e3, 8e3, 16e3]
+};
+
+// src/domains/resources-v3-openapi/index.ts
+var resourcesV3Domain = createOpenApiDomain(resourcesV3Config);
+
+// src/domains/resources-v3-business-rules/config.ts
+var resourcesV3BusinessRulesConfig = {
+  id: "resources-v3-business-rules",
+  title: "API de Recursos v3 \u2014 Regras de neg\xF3cio (DC)",
+  specVersion: "3.1.0",
+  description: "Regras de neg\xF3cio da API de Recursos (Resources) vers\xE3o 3.1.0 do Open Finance Brasil, extra\xEDdas das p\xE1ginas Confluence de Dados Cadastrais e Transacionais (DC): Informa\xE7\xF5es Gerais (vis\xE3o geral do GET /resources/v3/resources, status do recurso versus status do consentimento) e Orienta\xE7\xF5es - [DC] Recursos (quando um recurso volta a ficar dispon\xEDvel, uso do status code de erro apropriado quando a transmissora n\xE3o retorna as informa\xE7\xF5es) \u2014 esta \xFAltima n\xE3o \xE9 versionada e vale para todo o major v3. Complementa resources-v3-openapi, que traz a spec (endpoints e schemas) do mesmo major. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
+  confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
+  interRequestDelayMs: 2e3,
+  retryDelaysMs: [2e3, 4e3, 8e3, 16e3],
+  pages: [
+    { pageId: "1267990545", title: "Informa\xE7\xF5es Gerais - [DC] Recursos - v3.1.0" },
+    { pageId: "219512943", title: "Orienta\xE7\xF5es - [DC] Recursos" }
+  ]
+};
+
+// src/domains/resources-v3-business-rules/index.ts
+var resourcesV3BusinessRulesDomain = createConfluenceSectionsDomain(
+  resourcesV3BusinessRulesConfig
+);
+
+// src/domains/accounts-v2-openapi/config.ts
+var accountsV2Config = {
+  id: "accounts-v2-openapi",
+  title: "API de Contas \u2014 spec OpenAPI 2.4.2",
+  description: "Spec OpenAPI oficial da API de Contas (Accounts) do Open Finance Brasil, vers\xE3o 2.4.2 \u2014 compartilhamento de contas de dep\xF3sito \xE0 vista, poupan\xE7a e pagamento pr\xE9-paga. Cobre listagem (GET /accounts), identifica\xE7\xE3o (GET /accounts/{accountId}), saldos (GET /accounts/{accountId}/balances), transa\xE7\xF5es (GET /accounts/{accountId}/transactions e /transactions-current) e limites de cheque especial (GET /accounts/{accountId}/overdraft-limits). \xC9 API de Dados Cadastrais e Transacionais: o consentimento que a habilita fica em consents-v3-openapi, e a listagem de recursos compartilhados em resources-v3-openapi. Itens type=operation (um por m\xE9todo+path), type=schema (payloads, ex.: AccountData, AccountBalancesData, AccountTransactionsData) e os components alvos dos $ref: type=response e type=parameter. Regras de neg\xF3cio da mesma API em accounts-v2-business-rules. search devolve resumos; use get_item para o n\xF3 completo da spec \u2014 nas opera\xE7\xF5es o campo `refs` traz os ids dos components referenciados, prontos para get_item.",
+  pathExample: "/accounts/{accountId}/transactions",
+  specName: "accounts",
+  specVersion: "2.4.2",
+  url: "https://openbanking-brasil.github.io/openapi/swagger-apis/accounts/2.4.2.yml",
+  retryDelaysMs: [2e3, 4e3, 8e3, 16e3]
+};
+
+// src/domains/accounts-v2-openapi/index.ts
+var accountsV2Domain = createOpenApiDomain(accountsV2Config);
+
+// src/domains/accounts-v2-business-rules/config.ts
+var accountsV2BusinessRulesConfig = {
+  id: "accounts-v2-business-rules",
+  title: "API de Contas v2 \u2014 Regras de neg\xF3cio (DC)",
+  specVersion: "2.4.2",
+  description: "Regras de neg\xF3cio da API de Contas (Accounts) vers\xE3o 2.4.2 do Open Finance Brasil, extra\xEDdas das p\xE1ginas Confluence de Dados Cadastrais e Transacionais (DC): Informa\xE7\xF5es Gerais (vis\xE3o geral dos endpoints, contas de dep\xF3sito \xE0 vista/poupan\xE7a/pagamento pr\xE9-paga, saldos, transa\xE7\xF5es e limites) e Orienta\xE7\xF5es - [DC] Contas (obrigatoriedade de informa\xE7\xF5es de contraparte pela IN BCB n\xBA 371, tratamento de transa\xE7\xF5es e casos de borda) \u2014 esta \xFAltima n\xE3o \xE9 versionada e vale para todo o major v2. Complementa accounts-v2-openapi, que traz a spec (endpoints e schemas) do mesmo major. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
+  confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
+  interRequestDelayMs: 2e3,
+  retryDelaysMs: [2e3, 4e3, 8e3, 16e3],
+  pages: [
+    { pageId: "979566625", title: "Informa\xE7\xF5es Gerais - [DC] Contas - v2.4.2" },
+    { pageId: "1739096252", title: "Orienta\xE7\xF5es - [DC] Contas" }
+  ]
+};
+
+// src/domains/accounts-v2-business-rules/index.ts
+var accountsV2BusinessRulesDomain = createConfluenceSectionsDomain(
+  accountsV2BusinessRulesConfig
+);
+
 // src/domains/pcm-openapi/config.ts
 var pcmOpenapiConfig = {
   specName: "pcm",
-  specVersion: "1.0.0",
-  url: "https://raw.githubusercontent.com/OpenBanking-Brasil/pcm-specs/refs/heads/feature/correct-paths/PCM-current.openapi.yaml",
+  // A spec da PCM não declara `info.version` (o campo `openapi:` traz um valor
+  // fora do padrão). Identificar pelo commit é o único rótulo verificável — e
+  // deixa explícito, em list_domains, que este domínio está congelado no SHA.
+  specVersion: "commit 8a7f7b0",
+  url: "https://raw.githubusercontent.com/OpenBanking-Brasil/pcm-specs/8a7f7b03ddfab7eaf97bcfe68e67fac22a5eeb68/PCM-current.openapi.yaml",
   retryDelaysMs: [2e3, 4e3, 8e3, 16e3]
 };
 
 // src/domains/pcm-openapi/index.ts
 var pcmOpenapiDomain = createOpenApiDomain({
   id: "pcm-openapi",
-  title: `PCM \u2014 spec OpenAPI ${pcmOpenapiConfig.specVersion}`,
+  title: `PCM \u2014 spec OpenAPI (${pcmOpenapiConfig.specVersion})`,
   description: "Spec OpenAPI oficial da PCM (Plataforma de Coleta de M\xE9tricas) do Open Finance Brasil \u2014 a faceta swagger. Cobre os endpoints de reporte (report-api v1/v2), hybrid-flow, opendata, consents/stock, credit-portabilities, payments/status e token. Itens type=operation (um por m\xE9todo+path), type=schema (payloads) e type=response (components reutiliz\xE1veis, alvos dos $ref). Outras facetas da PCM: tabelas de obrigatoriedade do campo additionalInfo em pcm-additional-info; regras de neg\xF3cio (reporte, processamento, diverg\xEAncias) em pcm-business-rules. search devolve resumos; use get_item para o n\xF3 completo da spec (opera\xE7\xF5es trazem `refs` com os ids dos components que referenciam).",
   pathExample: "/report-api/v1/private/report",
   ...pcmOpenapiConfig
@@ -922,6 +1044,11 @@ var participantesConfig = {
 // src/domains/participantes/parser.ts
 function parseParticipants(jsonText) {
   const orgs = JSON.parse(jsonText);
+  if (!Array.isArray(orgs) || orgs.length === 0) {
+    throw new Error(
+      `resposta do diret\xF3rio n\xE3o \xE9 uma lista de organiza\xE7\xF5es n\xE3o-vazia; in\xEDcio do conte\xFAdo: ${JSON.stringify(jsonText.slice(0, 80))}`
+    );
+  }
   return orgs.map((org) => {
     const servers = org.AuthorisationServers ?? [];
     const families = /* @__PURE__ */ new Set();
@@ -1069,6 +1196,10 @@ var domains = [
   paymentsCommonRulesDomain,
   paymentsImplementationGuidesDomain,
   consentsV3Domain,
+  resourcesV3Domain,
+  resourcesV3BusinessRulesDomain,
+  accountsV2Domain,
+  accountsV2BusinessRulesDomain,
   pcmOpenapiDomain,
   pcmBusinessRulesDomain,
   jornadaOtimizadaDomain,
@@ -1099,6 +1230,7 @@ function findDomain(id) {
   return domains.find((d) => d.id === id);
 }
 var validIds = () => domains.map((d) => d.id).join(", ");
+var REFRESH_BUDGET_MS = 45e3;
 var domainIdSchema = z.enum(domains.map((d) => d.id)).describe("Id do dom\xEDnio (ver list_domains)");
 function extractContext(extra) {
   const progressToken = extra._meta?.progressToken;
@@ -1113,7 +1245,7 @@ function extractContext(extra) {
     }
   };
 }
-function createServer() {
+function createServer(refreshBudgetMs = REFRESH_BUDGET_MS) {
   const server2 = new McpServer(
     { name: "opf-br-mcp", version: PACKAGE_VERSION },
     {
@@ -1124,7 +1256,7 @@ function createServer() {
     "list_domains",
     {
       title: "Listar dom\xEDnios",
-      description: "Lista os dom\xEDnios de conhecimento do Open Finance Brasil dispon\xEDveis neste server, com os filtros aceitos por cada um e o estado do cache local. Comece por aqui; depois use search(domain, ...) e get_item(domain, id).",
+      description: "Lista os dom\xEDnios de conhecimento do Open Finance Brasil dispon\xEDveis neste server, com os filtros aceitos por cada um, a vers\xE3o da spec de origem e o estado do cache local. Devolve tamb\xE9m a vers\xE3o deste server em `server.version`. Os filtros aceitos por um dom\xEDnio s\xE3o a uni\xE3o de `filters` (os pr\xF3prios dele, pode vir ausente) com `filterSets[<filterSet>]` (o conjunto comum \xE0 fam\xEDlia, listado uma vez no topo). Comece por aqui; depois use search(domain, ...) e get_item(domain, id).",
       annotations: {
         readOnlyHint: true,
         destructiveHint: false,
@@ -1134,20 +1266,34 @@ function createServer() {
     },
     async () => {
       const out = domains.map((d) => {
+        const shared = d.filterSet ? FILTER_SETS[d.filterSet] : void 0;
+        const own = shared ? d.filters.filter((f) => !shared.some((s) => s.name === f.name && s.description === f.description)) : d.filters;
+        const base = {
+          id: d.id,
+          title: d.title,
+          description: d.description,
+          ...d.filterSet ? { filterSet: d.filterSet } : {},
+          ...own.length > 0 ? { filters: own } : {},
+          ...d.specVersion ? { specVersion: d.specVersion } : {}
+        };
         if (d.live) {
-          return { id: d.id, title: d.title, description: d.description, filters: d.filters, live: true };
+          return { ...base, live: true };
         }
         const cached = readCache(d.id);
         return {
-          id: d.id,
-          title: d.title,
-          description: d.description,
-          filters: d.filters,
+          ...base,
           cachedItems: cached?.data.items.length ?? 0,
           extractedAt: cached?.extractedAt ?? null
         };
       });
-      return text(out);
+      const usedSets = Object.fromEntries(
+        Object.entries(FILTER_SETS).filter(([name]) => domains.some((d) => d.filterSet === name))
+      );
+      return text({
+        server: { name: "opf-br-mcp", version: PACKAGE_VERSION },
+        filterSets: usedSets,
+        domains: out
+      });
     }
   );
   server2.registerTool(
@@ -1263,7 +1409,7 @@ function createServer() {
     "refresh",
     {
       title: "Re-extrair fontes",
-      description: "For\xE7a re-extra\xE7\xE3o das fontes p\xFAblicas (ignora o TTL de 72h do cache). Sem `domain`, atualiza todos. Use quando suspeitar de dados desatualizados.",
+      description: "For\xE7a re-extra\xE7\xE3o das fontes p\xFAblicas (ignora o TTL de 72h do cache). Use quando suspeitar de dados desatualizados. Prefira passar `domain`: sem ele o server atualiza o que couber em 45s e devolve o restante em `pendentes`, que voc\xEA deve refazer chamando refresh(domain) para cada id.",
       inputSchema: {
         domain: domainIdSchema.optional().describe("Id do dom\xEDnio; omita para todos")
       },
@@ -1279,7 +1425,13 @@ function createServer() {
         (d) => !d.live && (!domain || d.id === domain)
       );
       const report = {};
+      const pendentes = [];
+      const inicio = Date.now();
       for (const d of targets) {
+        if (!domain && Date.now() - inicio > refreshBudgetMs) {
+          pendentes.push(d.id);
+          continue;
+        }
         try {
           const { data } = await getDomainData(d, true, extractContext(extra));
           report[d.id] = `ok: ${data.items.length} itens`;
@@ -1287,13 +1439,23 @@ function createServer() {
           report[d.id] = `erro: ${err.message}`;
         }
       }
-      return text(report);
+      return text({
+        atualizados: report,
+        ...pendentes.length > 0 ? {
+          pendentes,
+          nota: `Parei em ${refreshBudgetMs / 1e3}s para n\xE3o estourar o timeout do cliente. Chame refresh(domain) para cada id em pendentes.`
+        } : {}
+      });
     }
   );
   return server2;
 }
 
 // src/index.ts
+if (process.argv.includes("--version") || process.argv.includes("-v")) {
+  console.log(PACKAGE_VERSION);
+  process.exit(0);
+}
 var server = createServer();
 await server.connect(new StdioServerTransport());
-console.error("[opf-br-mcp] server pronto (stdio)");
+console.error(`[opf-br-mcp] server pronto (stdio) \u2014 v${PACKAGE_VERSION}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opf-br-mcp",
-  "version": "0.7.0",
+  "version": "0.9.3",
   "description": "MCP server local com as regras do Open Finance Brasil (PCM additionalInfo, specs OpenAPI de Pagamentos)",
   "type": "module",
   "license": "MIT",