bcb-br-mcp 1.7.0 → 1.9.0

package/dist/provenance.d.ts

@@ -0,0 +1,291 @@
+/**
+ * Bloco de proveniência (contrato v1.0 do portfólio) — adaptador pt-BR sobre
+ * `@sbissoli/mcp-provenance`. O modelo canônico, as projeções
+ * `concise`/`detailed`, o determinismo da serialização, o fuso e o texto do
+ * rodapé moram no pacote; este módulo o amarra ao servidor do BCB:
+ *
+ *  - um `ProvenanceContext` para o servidor inteiro (namespace
+ *    `br.com.sidneybissoli.bcb`, pt-BR, horário de Brasília, modo `concise`);
+ *  - o registro `FONTES_BCB` — uma entrada por procedência, não por API;
+ *  - `provenienciaBcb(...)`, o construtor por chamada, que puxa o instante REAL
+ *    da extração do coletor aberto no `dispatchTool` (`shared.ts`).
+ *
+ * ## Por que o registro NÃO é "uma entrada por API"
+ *
+ * O plano da fase previa multi-fonte como ARRAY por API (receita medical). A
+ * medição de abertura do D4 (`bcb/docs/07`) desmentiu a premissa: **nenhuma tool
+ * mistura APIs** — cada uma fala com exatamente um host — e a **licença é a
+ * mesma nas três** (ODbL, reconferida em 13/08/2026), então segregar por API não
+ * segregaria licença nenhuma, que é o motivo de existir do array no contrato.
+ *
+ * O array continua necessário, por duas fronteiras de PROCEDÊNCIA que a mesma
+ * medição expôs:
+ *
+ *  1. **Servidor × BCB.** `bcb_series_populares` responde com ZERO requisição e
+ *     `bcb_buscar_serie` mistura o catálogo curado (nosso) com o índice do
+ *     portal. Anunciar as duas camadas como "extraído do BCB agora" repetiria,
+ *     na proveniência, o erro que a sessão 07 corrigiu no catálogo: dar a mesma
+ *     cara a coisas de procedência diferente.
+ *  2. **BCB × Refinitiv.** Nas paridades não-USD da PTAX o dado vem de agência
+ *     de informação e é redistribuído pelo BCB (`bcb/docs/01` §3).
+ *
+ * ## Canais de emissão
+ *
+ * `structuredContent.provenance` + `attribution` (legível pelo modelo) e espelho
+ * em `_meta` sob o namespace (fora de banda, zero tokens). **O rodapé de texto
+ * do contrato não se aplica aqui**, e isso é deliberado: no ibge e no medical o
+ * canal de texto é Markdown, e aqui ele é o próprio payload serializado em JSON
+ * (`structuredResult`) — anexar rodapé produziria um bloco de texto que não é
+ * JSON válido. O bloco já vai no texto, dentro do payload.
+ */
+import { type CanonicalProvenance } from "@sbissoli/mcp-provenance";
+import { type ToolResult } from "./shared.js";
+/** Contexto único do servidor: namespace de `_meta`, idioma, fuso e modo. */
+export declare const provenanceContext: import("@sbissoli/mcp-provenance").ProvenanceContext;
+/** Envelope canônico v1.0 (pós-validação). */
+export type Proveniencia = CanonicalProvenance;
+/** Chaves de `_meta` (estáveis — consumidores de auditoria leem por elas). */
+export declare const PROVENANCE_META_KEY: string;
+export declare const ATTRIBUTION_META_KEY: string;
+/**
+ * Licença das três APIs do BCB — **ODbL v1.0**, com share-alike e anti-DRM.
+ *
+ * Não é CC0, não é CC BY, não é domínio público: 4.259 dos 4.260 datasets do
+ * portal declaram `odc-odbl` (medido em 13/08/2026; em 10/08 eram 4.235 de
+ * 4.236 — o portal cresceu e a proporção se manteve).
+ *
+ * O `url` é o CANÔNICO em HTTPS. O que o CKAN declara é
+ * `http://www.opendefinition.org/licenses/odc-odbl`, que **resolve** (HTTP 200)
+ * mas só sem TLS — medido, e é a resposta à pendência P3 do decisor. Citar como
+ * link oficial um endereço sem TLS seria pior; o legado fica registrado no
+ * `terms_url` da própria fonte.
+ */
+export declare const LICENCA_ODBL: {
+    readonly id: "ODbL-1.0";
+    readonly name: "Open Data Commons Open Database License (ODbL) v1.0 — atribuição, share-alike e anti-DRM";
+    readonly url: "https://opendatacommons.org/licenses/odbl/1-0/";
+    readonly terms_url: "https://dadosabertos.bcb.gov.br/";
+    readonly verified_at: "2026-08-13";
+};
+/**
+ * Licença do que o SERVIDOR mantém (o catálogo curado). O código é MIT; os
+ * nomes transcritos do portal seguem sendo dados do BCB sob ODbL, e é por isso
+ * que a nota diz as duas coisas em vez de escolher uma.
+ */
+export declare const LICENCA_CATALOGO_CURADO: {
+    readonly id: null;
+    readonly name: string;
+    readonly url: "https://opendatacommons.org/licenses/odbl/1-0/";
+    readonly terms_url: "https://github.com/SidneyBissoli/bcb-br-mcp";
+    readonly verified_at: "2026-08-13";
+};
+/**
+ * Registro de fontes — uma entrada por PROCEDÊNCIA (ver o cabeçalho).
+ * A agência difere por API e foi lida do CKAN em 13/08/2026, não inferida.
+ */
+export declare const FONTES_BCB: {
+    SGS: {
+        name: string;
+        agency: string;
+        database: string;
+        endpoint: string;
+        license: {
+            readonly id: "ODbL-1.0";
+            readonly name: "Open Data Commons Open Database License (ODbL) v1.0 — atribuição, share-alike e anti-DRM";
+            readonly url: "https://opendatacommons.org/licenses/odbl/1-0/";
+            readonly terms_url: "https://dadosabertos.bcb.gov.br/";
+            readonly verified_at: "2026-08-13";
+        };
+        notices: never[];
+        citation: (data: string, detalhe: string | undefined) => string;
+        prefixoUrl: string;
+    };
+    FOCUS: {
+        name: string;
+        agency: string;
+        database: string;
+        endpoint: string;
+        license: {
+            readonly id: "ODbL-1.0";
+            readonly name: "Open Data Commons Open Database License (ODbL) v1.0 — atribuição, share-alike e anti-DRM";
+            readonly url: "https://opendatacommons.org/licenses/odbl/1-0/";
+            readonly terms_url: "https://dadosabertos.bcb.gov.br/";
+            readonly verified_at: "2026-08-13";
+        };
+        notices: never[];
+        citation: (data: string, detalhe: string | undefined) => string;
+        prefixoUrl: string;
+    };
+    PTAX: {
+        name: string;
+        agency: string;
+        database: string;
+        endpoint: string;
+        license: {
+            readonly id: "ODbL-1.0";
+            readonly name: "Open Data Commons Open Database License (ODbL) v1.0 — atribuição, share-alike e anti-DRM";
+            readonly url: "https://opendatacommons.org/licenses/odbl/1-0/";
+            readonly terms_url: "https://dadosabertos.bcb.gov.br/";
+            readonly verified_at: "2026-08-13";
+        };
+        notices: string[];
+        citation: (data: string, detalhe: string | undefined) => string;
+        prefixoUrl: string;
+    };
+    PARIDADE_REFINITIV: {
+        name: string;
+        agency: string;
+        database: string;
+        endpoint: string;
+        license: {
+            readonly id: "ODbL-1.0";
+            readonly name: "Open Data Commons Open Database License (ODbL) v1.0 — atribuição, share-alike e anti-DRM";
+            readonly url: "https://opendatacommons.org/licenses/odbl/1-0/";
+            readonly terms_url: "https://dadosabertos.bcb.gov.br/";
+            readonly verified_at: "2026-08-13";
+        };
+        notices: string[];
+        citation: (data: string) => string;
+        prefixoUrl: string;
+    };
+    PORTAL: {
+        name: string;
+        agency: string;
+        database: string;
+        endpoint: string;
+        license: {
+            readonly id: "ODbL-1.0";
+            readonly name: "Open Data Commons Open Database License (ODbL) v1.0 — atribuição, share-alike e anti-DRM";
+            readonly url: "https://opendatacommons.org/licenses/odbl/1-0/";
+            readonly terms_url: "https://dadosabertos.bcb.gov.br/";
+            readonly verified_at: "2026-08-13";
+        };
+        notices: never[];
+        citation: (data: string, detalhe: string | undefined) => string;
+        prefixoUrl: string;
+    };
+    CATALOGO_CURADO: {
+        name: string;
+        agency: null;
+        database: null;
+        endpoint: null;
+        license: {
+            readonly id: null;
+            readonly name: string;
+            readonly url: "https://opendatacommons.org/licenses/odbl/1-0/";
+            readonly terms_url: "https://github.com/SidneyBissoli/bcb-br-mcp";
+            readonly verified_at: "2026-08-13";
+        };
+        notices: string[];
+        citation: (data: string) => string;
+        prefixoUrl: null;
+    };
+};
+export type ChaveFonte = keyof typeof FONTES_BCB;
+export interface OpcoesProveniencia {
+    /** Qual procedência respondeu. */
+    fonte: ChaveFonte;
+    /** URL canônica que reproduz a consulta na fonte. */
+    url: string;
+    /** Conjunto dentro da fonte (código da série, recurso OData, moeda). */
+    dataset?: {
+        id?: string | null;
+        version?: string | null;
+        name?: string | null;
+    };
+    /** Competência do dado segundo a fonte; null quando a fonte não expõe. */
+    dataVintage?: string | null;
+    /** Detalhe interpolado na citação (ex.: "série 433 (IPCA)"). */
+    detalheCitacao?: string;
+    /** O servidor calculou além de filtrar/paginar/reserializar. */
+    derivado?: {
+        nota: string;
+    };
+    /** Avisos adicionais desta resposta, além dos fixos da fonte. */
+    avisosExtras?: string[];
+    /**
+     * Proveniência por campo — para as respostas que fundem vários recortes da
+     * MESMA fonte numa estrutura só (`bcb_comparar`, `bcb_correlacao`,
+     * `bcb_deflacionar`, `bcb_indicadores_atuais`, todas multi-série do SGS).
+     *
+     * Sem isto, o `source_url` teria de escolher uma série entre várias e mentir
+     * por omissão sobre as outras. A projeção `concise` não mostra este campo — é
+     * o piso legal —, mas ele vai no modelo canônico e no `detailed`.
+     */
+    fontesPorCampo?: Array<{
+        fields: string[];
+        source_url: string;
+        dataset_id?: string | null;
+        data_vintage?: string | null;
+    }>;
+}
+/**
+ * Monta o bloco canônico de UMA fonte de UMA resposta.
+ *
+ * `retrieved_at` e `served_from_cache` vêm do coletor aberto no `dispatchTool`,
+ * filtrados pelos acessos daquela fonte: o instante mais ANTIGO, e cache só se
+ * TUDO veio de cache (`bcb/docs/07`, S1 e S4). Sem coletor aberto — chamada
+ * direta em teste — degrada para o instante da chamada, nunca quebra.
+ */
+export declare function provenienciaBcb(opts: OpcoesProveniencia): Proveniencia;
+/** Nota fixa das tools que calculam (o motor mora no `@sbissoli/mcp-stats`). */
+export declare const NOTA_DERIVACAO_ESTATISTICA: string;
+/** Nota das tools que ACUMULAM uma série que já é variação (IPCA, IGP-M mensais). */
+export declare const NOTA_DERIVACAO_ENCADEAMENTO: string;
+/** Nota fixa da harmonização de frequência. */
+export declare const NOTA_DERIVACAO_HARMONIZACAO: string;
+/** Nota fixa da deflação (o SGS não publica número-índice — ver `bcb/docs/05`). */
+export declare const NOTA_DERIVACAO_DEFLACAO: string;
+/**
+ * Resultado de sucesso com os canais de proveniência.
+ *
+ * Aceita um bloco ou um ARRAY (multi-procedência). O formato do fio segue o
+ * formato da entrada — objeto vira objeto, array vira array —, casando com o
+ * `outputSchema` que a tool anuncia (`comProveniencia` × `comProvenienciaMulti`).
+ */
+export declare function resultadoComProveniencia(payload: Record<string, unknown>, proveniencia: Proveniencia | Proveniencia[]): ToolResult;
+/** Projeção `concise` de um bloco — a forma que vai em `structuredContent`/`_meta`. */
+export declare const PROVENANCE_BLOCK_SCHEMA: {
+    type: "object";
+    description: string;
+    properties: {
+        source: {
+            type: "string";
+            description: string;
+        };
+        source_url: {
+            type: "string";
+            description: string;
+        };
+        data_vintage: {
+            type: readonly ["string", "null"];
+            description: string;
+        };
+        retrieved_at: {
+            type: "string";
+            description: string;
+        };
+        citation: {
+            type: "string";
+            description: string;
+        };
+        license: {
+            type: readonly ["string", "null"];
+            description: string;
+        };
+    };
+    required: string[];
+};
+type SchemaObjeto = Record<string, unknown>;
+/**
+ * Acrescenta o canal de proveniência ao `outputSchema` de uma tool de fonte
+ * única. Os dois campos são OBRIGATÓRIOS: toda resposta de sucesso os carrega.
+ */
+export declare function comProveniencia(schema: SchemaObjeto): SchemaObjeto;
+/**
+ * Variante multi-procedência: um bloco por procedência que contribuiu com dado.
+ * As licenças nunca se fundem — é regra do contrato.
+ */
+export declare function comProvenienciaMulti(schema: SchemaObjeto): SchemaObjeto;
+export {};
+//# sourceMappingURL=provenance.d.ts.map

package/dist/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAIL,KAAK,mBAAmB,EAEzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,sDAK5B,CAAC;AAEH,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAE/C,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,QAAwC,CAAC;AACzE,eAAO,MAAM,oBAAoB,QAAyC,CAAC;AAK3E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;CAQ1B,CAAC;AAkBX;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Ea,CAAC;AAErC,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,UAAU,CAAC;AAYjD,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAChF,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CA2CtE;AAED,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,QAEgD,CAAC;AAExF,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,QAE+C,CAAC;AAExF,+CAA+C;AAC/C,eAAO,MAAM,2BAA2B,QAEhB,CAAC;AAEzB,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,QAG8B,CAAC;AAInE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,YAAY,EAAE,YAAY,GAAG,YAAY,EAAE,GAC1C,UAAU,CAgBZ;AAQD,uFAAuF;AACvF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBnC,CAAC;AAQF,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAY5C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAElE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAOvE"}

package/dist/provenance.js

@@ -0,0 +1,319 @@
+/**
+ * Bloco de proveniência (contrato v1.0 do portfólio) — adaptador pt-BR sobre
+ * `@sbissoli/mcp-provenance`. O modelo canônico, as projeções
+ * `concise`/`detailed`, o determinismo da serialização, o fuso e o texto do
+ * rodapé moram no pacote; este módulo o amarra ao servidor do BCB:
+ *
+ *  - um `ProvenanceContext` para o servidor inteiro (namespace
+ *    `br.com.sidneybissoli.bcb`, pt-BR, horário de Brasília, modo `concise`);
+ *  - o registro `FONTES_BCB` — uma entrada por procedência, não por API;
+ *  - `provenienciaBcb(...)`, o construtor por chamada, que puxa o instante REAL
+ *    da extração do coletor aberto no `dispatchTool` (`shared.ts`).
+ *
+ * ## Por que o registro NÃO é "uma entrada por API"
+ *
+ * O plano da fase previa multi-fonte como ARRAY por API (receita medical). A
+ * medição de abertura do D4 (`bcb/docs/07`) desmentiu a premissa: **nenhuma tool
+ * mistura APIs** — cada uma fala com exatamente um host — e a **licença é a
+ * mesma nas três** (ODbL, reconferida em 13/08/2026), então segregar por API não
+ * segregaria licença nenhuma, que é o motivo de existir do array no contrato.
+ *
+ * O array continua necessário, por duas fronteiras de PROCEDÊNCIA que a mesma
+ * medição expôs:
+ *
+ *  1. **Servidor × BCB.** `bcb_series_populares` responde com ZERO requisição e
+ *     `bcb_buscar_serie` mistura o catálogo curado (nosso) com o índice do
+ *     portal. Anunciar as duas camadas como "extraído do BCB agora" repetiria,
+ *     na proveniência, o erro que a sessão 07 corrigiu no catálogo: dar a mesma
+ *     cara a coisas de procedência diferente.
+ *  2. **BCB × Refinitiv.** Nas paridades não-USD da PTAX o dado vem de agência
+ *     de informação e é redistribuído pelo BCB (`bcb/docs/01` §3).
+ *
+ * ## Canais de emissão
+ *
+ * `structuredContent.provenance` + `attribution` (legível pelo modelo) e espelho
+ * em `_meta` sob o namespace (fora de banda, zero tokens). **O rodapé de texto
+ * do contrato não se aplica aqui**, e isso é deliberado: no ibge e no medical o
+ * canal de texto é Markdown, e aqui ele é o próprio payload serializado em JSON
+ * (`structuredResult`) — anexar rodapé produziria um bloco de texto que não é
+ * JSON válido. O bloco já vai no texto, dentro do payload.
+ */
+import { attributionList, createProvenanceContext, renderConcise } from "@sbissoli/mcp-provenance";
+import { DISCLAIMER_PTAX, QUALIFICACAO_PARIDADE, extracaoDaChamada, structuredResult } from "./shared.js";
+/** Contexto único do servidor: namespace de `_meta`, idioma, fuso e modo. */
+export const provenanceContext = createProvenanceContext({
+    metaNamespace: "br.com.sidneybissoli.bcb",
+    locale: "pt-BR",
+    timezone: { offset: "-03:00", label: "horário de Brasília" },
+    defaultMode: "concise"
+});
+/** Chaves de `_meta` (estáveis — consumidores de auditoria leem por elas). */
+export const PROVENANCE_META_KEY = provenanceContext.metaKeys.provenance;
+export const ATTRIBUTION_META_KEY = provenanceContext.metaKeys.attribution;
+/** Data da última verificação verbatim da licença (`bcb/docs/07`, reconferida). */
+const VERIFICADO_EM = "2026-08-13";
+/**
+ * Licença das três APIs do BCB — **ODbL v1.0**, com share-alike e anti-DRM.
+ *
+ * Não é CC0, não é CC BY, não é domínio público: 4.259 dos 4.260 datasets do
+ * portal declaram `odc-odbl` (medido em 13/08/2026; em 10/08 eram 4.235 de
+ * 4.236 — o portal cresceu e a proporção se manteve).
+ *
+ * O `url` é o CANÔNICO em HTTPS. O que o CKAN declara é
+ * `http://www.opendefinition.org/licenses/odc-odbl`, que **resolve** (HTTP 200)
+ * mas só sem TLS — medido, e é a resposta à pendência P3 do decisor. Citar como
+ * link oficial um endereço sem TLS seria pior; o legado fica registrado no
+ * `terms_url` da própria fonte.
+ */
+export const LICENCA_ODBL = {
+    id: "ODbL-1.0",
+    name: "Open Data Commons Open Database License (ODbL) v1.0 — atribuição, share-alike e anti-DRM",
+    url: "https://opendatacommons.org/licenses/odbl/1-0/",
+    terms_url: "https://dadosabertos.bcb.gov.br/",
+    verified_at: VERIFICADO_EM
+};
+/**
+ * Licença do que o SERVIDOR mantém (o catálogo curado). O código é MIT; os
+ * nomes transcritos do portal seguem sendo dados do BCB sob ODbL, e é por isso
+ * que a nota diz as duas coisas em vez de escolher uma.
+ */
+export const LICENCA_CATALOGO_CURADO = {
+    id: null,
+    name: "Catálogo curado mantido pelo servidor (código sob MIT); os nomes transcritos do " +
+        "Portal de Dados Abertos do BCB permanecem dados do BCB sob ODbL v1.0",
+    url: "https://opendatacommons.org/licenses/odbl/1-0/",
+    terms_url: "https://github.com/SidneyBissoli/bcb-br-mcp",
+    verified_at: VERIFICADO_EM
+};
+/**
+ * Registro de fontes — uma entrada por PROCEDÊNCIA (ver o cabeçalho).
+ * A agência difere por API e foi lida do CKAN em 13/08/2026, não inferida.
+ */
+export const FONTES_BCB = {
+    SGS: {
+        name: "Banco Central do Brasil — SGS (Sistema Gerenciador de Séries Temporais)",
+        agency: "Banco Central do Brasil / Departamento Econômico (Depec)",
+        database: "SGS",
+        endpoint: "https://api.bcb.gov.br/dados/serie",
+        license: LICENCA_ODBL,
+        notices: [],
+        citation: (data, detalhe) => `Fonte: Banco Central do Brasil — SGS${detalhe ? `, ${detalhe}` : ""}. ` +
+            `Dados sob ODbL v1.0. Extraído em ${data}.`,
+        prefixoUrl: "https://api.bcb.gov.br"
+    },
+    FOCUS: {
+        name: "Banco Central do Brasil — Expectativas de Mercado (Focus), via Olinda OData",
+        agency: "Banco Central do Brasil / Departamento de Estatísticas (Dstat)",
+        database: "Expectativas de Mercado",
+        endpoint: "https://olinda.bcb.gov.br/olinda/servico/Expectativas/versao/v1/odata",
+        license: LICENCA_ODBL,
+        notices: [],
+        citation: (data, detalhe) => `Fonte: Banco Central do Brasil — Expectativas de Mercado (Focus)${detalhe ? `, ${detalhe}` : ""}. ` +
+            `Dados sob ODbL v1.0. Extraído em ${data}.`,
+        prefixoUrl: "https://olinda.bcb.gov.br/olinda/servico/Expectativas"
+    },
+    PTAX: {
+        name: "Banco Central do Brasil — PTAX / Cotações e boletins de câmbio, via Olinda OData",
+        agency: "Banco Central do Brasil / Departamento das Reservas Internacionais (Depin)",
+        database: "PTAX",
+        endpoint: "https://olinda.bcb.gov.br/olinda/servico/PTAX/versao/v1/odata",
+        license: LICENCA_ODBL,
+        notices: [DISCLAIMER_PTAX],
+        citation: (data, detalhe) => `Fonte: Banco Central do Brasil — PTAX${detalhe ? `, ${detalhe}` : ""}. ` +
+            `Dados sob ODbL v1.0. Extraído em ${data}.`,
+        prefixoUrl: "https://olinda.bcb.gov.br/olinda/servico/PTAX"
+    },
+    PARIDADE_REFINITIV: {
+        name: "Paridades não-USD do boletim do BCB — apuradas por agência de informação (Refinitiv)",
+        agency: "Refinitiv (redistribuído pelo Banco Central do Brasil)",
+        database: "PTAX — paridades",
+        endpoint: "https://olinda.bcb.gov.br/olinda/servico/PTAX/versao/v1/odata",
+        license: LICENCA_ODBL,
+        notices: [QUALIFICACAO_PARIDADE, DISCLAIMER_PTAX],
+        citation: data => "Fonte: paridade obtida junto a agência de informação (Refinitiv) e redistribuída pelo " +
+            `Banco Central do Brasil no boletim de câmbio, sob ODbL v1.0. Extraído em ${data}.`,
+        prefixoUrl: "https://olinda.bcb.gov.br/olinda/servico/PTAX"
+    },
+    PORTAL: {
+        name: "Banco Central do Brasil — Portal de Dados Abertos (índice CKAN)",
+        agency: "Banco Central do Brasil",
+        database: "Portal de Dados Abertos",
+        endpoint: "https://dadosabertos.bcb.gov.br/api/3/action",
+        license: LICENCA_ODBL,
+        notices: [],
+        citation: (data, detalhe) => `Fonte: Banco Central do Brasil — Portal de Dados Abertos${detalhe ? `, ${detalhe}` : ""}. ` +
+            `Só metadados (código e nome), sob ODbL v1.0. Obtido em ${data}.`,
+        prefixoUrl: "https://dadosabertos.bcb.gov.br"
+    },
+    CATALOGO_CURADO: {
+        name: "bcb-br-mcp — catálogo curado do servidor (139 séries verificadas contra a origem)",
+        agency: null,
+        database: null,
+        // Sem extração upstream: é dado mantido no próprio servidor.
+        endpoint: null,
+        license: LICENCA_CATALOGO_CURADO,
+        notices: [
+            "Cada série do catálogo foi verificada contra a origem em 13/08/2026: 82 nomes são " +
+                "transcritos do dataset do BCB no Portal de Dados Abertos e 57 são herdados, com " +
+                "apenas periodicidade e magnitude medidas. O campo `fonteNome` diz qual é qual."
+        ],
+        citation: data => "Fonte: bcb-br-mcp — catálogo curado do servidor, verificado série a série contra a " +
+            `origem; nomes transcritos do Portal de Dados Abertos do BCB (ODbL v1.0). Consultado em ${data}.`,
+        prefixoUrl: null
+    }
+};
+/** "dd/mm/aaaa" de um instante em horário de Brasília, para o texto da citação. */
+function dataCitacao(instante) {
+    // Offset fixo -03:00: o Brasil não tem horário de verão desde 2019.
+    const [ano, mes, dia] = new Date(instante.getTime() - 3 * 60 * 60 * 1000)
+        .toISOString()
+        .slice(0, 10)
+        .split("-");
+    return `${dia}/${mes}/${ano}`;
+}
+/**
+ * Monta o bloco canônico de UMA fonte de UMA resposta.
+ *
+ * `retrieved_at` e `served_from_cache` vêm do coletor aberto no `dispatchTool`,
+ * filtrados pelos acessos daquela fonte: o instante mais ANTIGO, e cache só se
+ * TUDO veio de cache (`bcb/docs/07`, S1 e S4). Sem coletor aberto — chamada
+ * direta em teste — degrada para o instante da chamada, nunca quebra.
+ */
+export function provenienciaBcb(opts) {
+    const fonte = FONTES_BCB[opts.fonte];
+    const prefixo = fonte.prefixoUrl;
+    const extracao = extracaoDaChamada(prefixo ? url => url.startsWith(prefixo) : () => false);
+    const data = dataCitacao(extracao.retrievedAt);
+    return provenanceContext.build({
+        source: {
+            name: fonte.name,
+            agency: fonte.agency,
+            database: fonte.database,
+            endpoint: fonte.endpoint
+        },
+        source_url: opts.url,
+        ...(opts.dataset !== undefined
+            ? {
+                dataset: {
+                    id: opts.dataset.id ?? null,
+                    version: opts.dataset.version ?? null,
+                    name: opts.dataset.name ?? null
+                }
+            }
+            : {}),
+        data_vintage: opts.dataVintage ?? null,
+        retrieved_at: extracao.retrievedAt,
+        citation: fonte.citation(data, opts.detalheCitacao),
+        license: fonte.license,
+        notices: [...fonte.notices, ...(opts.avisosExtras ?? [])],
+        derived: opts.derivado !== undefined,
+        ...(opts.derivado !== undefined ? { derivation_note: opts.derivado.nota } : {}),
+        served_from_cache: extracao.servedFromCache,
+        ...(opts.fontesPorCampo !== undefined
+            ? {
+                field_sources: opts.fontesPorCampo.map(f => ({
+                    fields: f.fields,
+                    source_url: f.source_url,
+                    dataset_id: f.dataset_id ?? null,
+                    data_vintage: f.data_vintage ?? null,
+                    retrieved_at: extracao.retrievedAt.toISOString()
+                }))
+            }
+            : {})
+    });
+}
+/** Nota fixa das tools que calculam (o motor mora no `@sbissoli/mcp-stats`). */
+export const NOTA_DERIVACAO_ESTATISTICA = "Estatísticas calculadas pelo servidor a partir das observações brutas da fonte " +
+    "(motor: @sbissoli/mcp-stats); os valores observados permanecem os originais do BCB.";
+/** Nota das tools que ACUMULAM uma série que já é variação (IPCA, IGP-M mensais). */
+export const NOTA_DERIVACAO_ENCADEAMENTO = "Variação acumulada por encadeamento das variações por período publicadas pela fonte " +
+    "(motor: @sbissoli/mcp-stats); os valores observados permanecem os originais do BCB.";
+/** Nota fixa da harmonização de frequência. */
+export const NOTA_DERIVACAO_HARMONIZACAO = "Observações agregadas pelo servidor para a periodicidade pedida; os valores de origem " +
+    "não foram alterados.";
+/** Nota fixa da deflação (o SGS não publica número-índice — ver `bcb/docs/05`). */
+export const NOTA_DERIVACAO_DEFLACAO = "Valores convertidos para moeda constante pelo servidor: o SGS não publica número-índice " +
+    "de preço, então o índice é reconstruído encadeando as variações mensais da série " +
+    "deflatora. Os valores nominais permanecem os originais do BCB.";
+// ==================== EMISSÃO ====================
+/**
+ * Resultado de sucesso com os canais de proveniência.
+ *
+ * Aceita um bloco ou um ARRAY (multi-procedência). O formato do fio segue o
+ * formato da entrada — objeto vira objeto, array vira array —, casando com o
+ * `outputSchema` que a tool anuncia (`comProveniencia` × `comProvenienciaMulti`).
+ */
+export function resultadoComProveniencia(payload, proveniencia) {
+    const blocos = Array.isArray(proveniencia) ? proveniencia : [proveniencia];
+    if (blocos.length === 0) {
+        throw new Error("resultadoComProveniencia exige ao menos um bloco de proveniência");
+    }
+    const projetados = blocos.map(b => renderConcise(b));
+    const saida = Array.isArray(proveniencia) ? projetados : projetados[0];
+    const attribution = attributionList(blocos);
+    const resultado = structuredResult({ ...payload, provenance: saida, attribution });
+    resultado._meta = {
+        [PROVENANCE_META_KEY]: saida,
+        [ATTRIBUTION_META_KEY]: attribution
+    };
+    return resultado;
+}
+// ==================== SCHEMA (JSON Schema verbatim) ====================
+//
+// A superfície publicada deste servidor é JSON Schema escrito à mão e servido
+// verbatim (`CLAUDE.md`): nada de derivar schema de zod aqui, mesmo com o zod
+// tendo voltado como dependência transitiva do pacote de proveniência.
+/** Projeção `concise` de um bloco — a forma que vai em `structuredContent`/`_meta`. */
+export const PROVENANCE_BLOCK_SCHEMA = {
+    type: "object",
+    description: "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+    properties: {
+        source: { type: "string", description: "Fonte oficial do dado" },
+        source_url: { type: "string", description: "URL canônica que reproduz a consulta" },
+        data_vintage: {
+            type: ["string", "null"],
+            description: "Competência do dado segundo a fonte; null quando a fonte não expõe"
+        },
+        retrieved_at: {
+            type: "string",
+            description: "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida " +
+                "de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante."
+        },
+        citation: { type: "string", description: "Citação pronta para uso" },
+        license: { type: ["string", "null"], description: "Regime legal do dado" }
+    },
+    required: ["source", "source_url", "data_vintage", "retrieved_at", "citation", "license"]
+};
+const ATTRIBUTION_SCHEMA = {
+    type: "array",
+    description: "URLs canônicas das fontes desta resposta (lista de atribuição)",
+    items: { type: "string" }
+};
+function estender(schema, blocoProvenance) {
+    const properties = (schema.properties ?? {});
+    const required = (schema.required ?? []);
+    return {
+        ...schema,
+        properties: { ...properties, provenance: blocoProvenance, attribution: ATTRIBUTION_SCHEMA },
+        required: [...required, "provenance", "attribution"]
+    };
+}
+/**
+ * Acrescenta o canal de proveniência ao `outputSchema` de uma tool de fonte
+ * única. Os dois campos são OBRIGATÓRIOS: toda resposta de sucesso os carrega.
+ */
+export function comProveniencia(schema) {
+    return estender(schema, PROVENANCE_BLOCK_SCHEMA);
+}
+/**
+ * Variante multi-procedência: um bloco por procedência que contribuiu com dado.
+ * As licenças nunca se fundem — é regra do contrato.
+ */
+export function comProvenienciaMulti(schema) {
+    return estender(schema, {
+        type: "array",
+        description: "Um bloco por procedência que contribuiu com esta resposta (contrato v1.0; licenças nunca se fundem)",
+        items: PROVENANCE_BLOCK_SCHEMA
+    });
+}
+//# sourceMappingURL=provenance.js.map

package/dist/provenance.js.map

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

package/dist/series.d.ts

@@ -124,6 +124,7 @@ export interface ResultadoSerie {
     /** Requisições gastas à origem, contando a sonda. */
     requisicoes: number;
 }
+export declare function urlSerie(codigo: number, inicio?: string, fim?: string): string;
 /** `dd/MM/yyyy` de hoje — a origem usa este formato e o fuso do BCB é -03:00. */
 export declare function hojeSgs(): string;
 /**

package/dist/series.d.ts.map

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