bcb-br-mcp 1.3.4 → 1.4.1

package/dist/register.d.ts

@@ -0,0 +1,61 @@
+/**
+ * SDK v2 registration layer — the SINGLE place where tools, resources and
+ * prompts are projected onto an `McpServer`.
+ *
+ * Design decisions of the v2 migration (fase bcb, Sessão 02):
+ *
+ * - Before this module there were two independent surfaces: `index.ts`
+ *   derived its schemas from Zod for stdio, while `worker.ts` hand-rolled the
+ *   JSON-RPC protocol and served the JSON Schemas from `TOOL_DEFINITIONS`.
+ *   They had drifted apart (the HTTP contract lacked `minItems`/`maxItems`,
+ *   `default`, `minimum`/`maximum` and `additionalProperties`; resources were
+ *   published under different names). `baselines/README.md` records the
+ *   measured divergence. Both transports now read this module.
+ *
+ * - The advertised JSON Schemas are the exact objects in `TOOL_DEFINITIONS`,
+ *   passed through `fromJsonSchema` so `tools/list` publishes them verbatim
+ *   instead of a re-derived dialect.
+ *
+ * - INPUT is validated, OUTPUT is not. Rationale: under SDK 1.x the
+ *   stdio channel validated arguments through the Zod input schema, but the
+ *   hand-rolled Worker never did — sending `{}` to `bcb_serie_valores` on the
+ *   hosted endpoint produced a request for "série undefined" against the BCB
+ *   API. Validating here restores the stdio guarantee and closes that hole,
+ *   with one contract for both transports. The handlers never validated on
+ *   their own, so there is no pedagogical Zod error to preserve. Output stays
+ *   unvalidated at runtime: shapes are covered by the characterization tests,
+ *   and a strict runtime check could only turn a good answer into an error.
+ *
+ * - SDK v2 hard rule: a tool declaring `outputSchema` MUST return
+ *   `structuredContent` on every non-error result. The check runs before any
+ *   validator and cannot be disabled. All 8 handlers go through
+ *   `structuredResult()`, and `register.test.ts` pins it.
+ */
+import { McpServer } from "@modelcontextprotocol/server";
+/**
+ * Optional per-tool usage hook: `tool_call` on every invocation, `tool_error`
+ * additionally when the call fails. stdio passes nothing; the Cloudflare
+ * Worker passes its UsageTracker recorder. Names and counts only — never
+ * arguments, never results.
+ */
+export type ToolUsageRecorder = (kind: "tool_call" | "tool_error", name: string) => void;
+export interface RegisterOptions {
+    /** Per-transport timeout/retry budget (the Worker uses a tighter one). */
+    config?: {
+        TIMEOUT_MS: number;
+        MAX_RETRIES: number;
+    };
+    record?: ToolUsageRecorder;
+}
+/**
+ * Registers the whole surface onto a given server. Kept separate from
+ * `createServer` so the Worker — which builds a fresh `McpServer` per
+ * request — reuses the exact same registrations.
+ */
+export declare function registerAll(server: McpServer, options?: RegisterOptions): void;
+/**
+ * Builds a fresh, fully registered server. No transport is connected, so it is
+ * safe to call from tests and once per request on stateless HTTP transports.
+ */
+export declare function createServer(version: string, options?: RegisterOptions): McpServer;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EACL,SAAS,EAOV,MAAM,8BAA8B,CAAC;AAyCtC;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzF,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,MAAM,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI,CAsDlF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,SAAS,CAItF"}

package/dist/register.js

@@ -0,0 +1,116 @@
+/**
+ * SDK v2 registration layer — the SINGLE place where tools, resources and
+ * prompts are projected onto an `McpServer`.
+ *
+ * Design decisions of the v2 migration (fase bcb, Sessão 02):
+ *
+ * - Before this module there were two independent surfaces: `index.ts`
+ *   derived its schemas from Zod for stdio, while `worker.ts` hand-rolled the
+ *   JSON-RPC protocol and served the JSON Schemas from `TOOL_DEFINITIONS`.
+ *   They had drifted apart (the HTTP contract lacked `minItems`/`maxItems`,
+ *   `default`, `minimum`/`maximum` and `additionalProperties`; resources were
+ *   published under different names). `baselines/README.md` records the
+ *   measured divergence. Both transports now read this module.
+ *
+ * - The advertised JSON Schemas are the exact objects in `TOOL_DEFINITIONS`,
+ *   passed through `fromJsonSchema` so `tools/list` publishes them verbatim
+ *   instead of a re-derived dialect.
+ *
+ * - INPUT is validated, OUTPUT is not. Rationale: under SDK 1.x the
+ *   stdio channel validated arguments through the Zod input schema, but the
+ *   hand-rolled Worker never did — sending `{}` to `bcb_serie_valores` on the
+ *   hosted endpoint produced a request for "série undefined" against the BCB
+ *   API. Validating here restores the stdio guarantee and closes that hole,
+ *   with one contract for both transports. The handlers never validated on
+ *   their own, so there is no pedagogical Zod error to preserve. Output stays
+ *   unvalidated at runtime: shapes are covered by the characterization tests,
+ *   and a strict runtime check could only turn a good answer into an error.
+ *
+ * - SDK v2 hard rule: a tool declaring `outputSchema` MUST return
+ *   `structuredContent` on every non-error result. The check runs before any
+ *   validator and cannot be disabled. All 8 handlers go through
+ *   `structuredResult()`, and `register.test.ts` pins it.
+ */
+import { McpServer, fromJsonSchema } from "@modelcontextprotocol/server";
+// O validador do SDK para Cloudflare Workers, usado nos DOIS runtimes de
+// propósito. O provider baseado em ajv compila os validadores com `new
+// Function`, que o runtime da Cloudflare proíbe — no wrangler dev isso derruba
+// TODA chamada ao /mcp com "Error compiling schema" + HTTP 500. Este aqui
+// interpreta o schema em vez de gerar código, funciona igual no Node, e assim
+// os dois transportes validam exatamente da mesma forma.
+import { CfWorkerJsonSchemaValidator } from "@modelcontextprotocol/server/validators/cf-worker";
+import { TOOL_DEFINITIONS, RESOURCE_DEFINITIONS, PROMPT_DEFINITIONS, dispatchTool, CONFIG } from "./tools.js";
+/** Accepts every value — used for output schemas only (see module docstring). */
+const permissiveValidator = {
+    getValidator() {
+        return (input) => ({
+            valid: true,
+            data: input,
+            errorMessage: undefined
+        });
+    }
+};
+const inputValidator = new CfWorkerJsonSchemaValidator();
+/** Advertise a JSON Schema verbatim AND enforce it on incoming arguments. */
+function validatedSchema(schema) {
+    return fromJsonSchema(schema, inputValidator);
+}
+/** Advertise a JSON Schema verbatim, without runtime checking. */
+function passthroughSchema(schema) {
+    return fromJsonSchema(schema, permissiveValidator);
+}
+/**
+ * Registers the whole surface onto a given server. Kept separate from
+ * `createServer` so the Worker — which builds a fresh `McpServer` per
+ * request — reuses the exact same registrations.
+ */
+export function registerAll(server, options = {}) {
+    const { config = CONFIG, record } = options;
+    for (const tool of TOOL_DEFINITIONS) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: validatedSchema(tool.inputSchema),
+            outputSchema: passthroughSchema(tool.outputSchema),
+            annotations: tool.annotations
+        }, async (args) => {
+            try {
+                const result = await dispatchTool(tool.name, (args ?? {}), config.TIMEOUT_MS, config.MAX_RETRIES);
+                record?.("tool_call", tool.name);
+                if (result.isError === true)
+                    record?.("tool_error", tool.name);
+                return result;
+            }
+            catch (error) {
+                // Handlers already trap their own failures; this is the last resort
+                // so an unexpected throw never breaks the transport.
+                const message = error instanceof Error ? error.message : String(error);
+                record?.("tool_call", tool.name);
+                record?.("tool_error", tool.name);
+                return {
+                    content: [{ type: "text", text: `Erro ao executar a tool "${tool.name}": ${message}` }],
+                    isError: true
+                };
+            }
+        });
+    }
+    for (const resource of RESOURCE_DEFINITIONS) {
+        server.registerResource(resource.name, resource.uri, { description: resource.description, mimeType: resource.mimeType }, async () => ({
+            contents: [{ uri: resource.uri, mimeType: resource.mimeType, text: resource.read() }]
+        }));
+    }
+    for (const prompt of PROMPT_DEFINITIONS) {
+        server.registerPrompt(prompt.name, { description: prompt.description }, async () => ({
+            messages: [{ role: "user", content: { type: "text", text: prompt.text } }]
+        }));
+    }
+}
+/**
+ * Builds a fresh, fully registered server. No transport is connected, so it is
+ * safe to call from tests and once per request on stateless HTTP transports.
+ */
+export function createServer(version, options = {}) {
+    const server = new McpServer({ name: "bcb-br-mcp", version });
+    registerAll(server, options);
+    return server;
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

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

package/dist/shared.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Primitivos compartilhados por todas as APIs do BCB que o servidor consome.
+ *
+ * Extraído de `tools.ts` na sessão de D3, quando o servidor deixou de falar com
+ * uma API só (SGS) e passou a falar com três (SGS, Olinda/Expectativas e PTAX).
+ * `tools.ts` re-exporta tudo daqui, de propósito: worker e testes importam
+ * desses nomes desde a fundação, e o D3 não é hora de mexer em quem importa o
+ * quê. A regra de dependência é uma só — `shared.ts` não importa ninguém, e é
+ * por isso que não há ciclo entre os módulos de tool.
+ */
+export declare const CONFIG: {
+    TIMEOUT_MS: number;
+    MAX_RETRIES: number;
+    RETRY_DELAY_MS: number;
+};
+export declare const WORKER_CONFIG: {
+    TIMEOUT_MS: number;
+    MAX_RETRIES: number;
+    RETRY_DELAY_MS: number;
+};
+export declare function setServerVersion(version: string): void;
+export declare function getUserAgent(): string;
+export interface SerieValor {
+    data: string;
+    valor: string;
+}
+export interface SerieMetadados {
+    codigo: number;
+    nome: string;
+    unidade: string;
+    periodicidade: string;
+    fonte: string;
+    especial: boolean;
+}
+export interface SeriePopular {
+    codigo: number;
+    nome: string;
+    categoria: string;
+    periodicidade: string;
+}
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+}
+/**
+ * Builds a ToolResult that satisfies an MCP tool's outputSchema:
+ * the same payload is exposed as machine-readable structuredContent and,
+ * for backward compatibility, serialized into a TextContent block.
+ */
+export declare function structuredResult(payload: Record<string, unknown>): ToolResult;
+/** Falha de tool: `isError` com texto em pt-BR, nunca erro de protocolo. */
+export declare function erroResult(texto: string): ToolResult;
+export declare function mensagemDeErro(error: unknown): string;
+export declare function normalizeString(str: string): string;
+export declare function formatDateForApi(dateStr: string): string;
+export declare function sleep(ms: number): Promise<void>;
+export declare function fetchWithTimeout(url: string, timeoutMs: number): Promise<Response>;
+export declare function fetchBcbApi(url: string, timeoutMs?: number, maxRetries?: number): Promise<unknown>;
+export declare function calculateVariation(valorInicial: number, valorFinal: number): number;
+/**
+ * Seals every object node of a JSON Schema (`additionalProperties: false`),
+ * recursively. Zod sealed objects by construction, so the stdio channel always
+ * advertised sealed schemas; doing it here in one place keeps that guarantee
+ * after the SDK v2 migration and extends it to the HTTP channel, which never
+ * had it.
+ */
+export declare function sealDeep<T>(schema: T): T;
+/** Definição canônica de uma tool, igual para os dois transportes. */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+}
+/** Anotações padrão do portfólio: toda tool aqui é leitura de API pública. */
+export declare function leituraRemota(title: string): ToolDefinition["annotations"];
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,eAAO,MAAM,MAAM;;;;CAIlB,CAAC;AAGF,eAAO,MAAM,aAAa;;;;CAIzB,CAAC;AAaF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAK7E;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD;AAID,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgBxF;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAA0B,EACrC,UAAU,GAAE,MAA2B,GACtC,OAAO,CAAC,OAAO,CAAC,CAoClB;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGnF;AAID;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAUxC;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,aAAa,CAAC,CAE1E"}

package/dist/shared.js

@@ -0,0 +1,151 @@
+/**
+ * Primitivos compartilhados por todas as APIs do BCB que o servidor consome.
+ *
+ * Extraído de `tools.ts` na sessão de D3, quando o servidor deixou de falar com
+ * uma API só (SGS) e passou a falar com três (SGS, Olinda/Expectativas e PTAX).
+ * `tools.ts` re-exporta tudo daqui, de propósito: worker e testes importam
+ * desses nomes desde a fundação, e o D3 não é hora de mexer em quem importa o
+ * quê. A regra de dependência é uma só — `shared.ts` não importa ninguém, e é
+ * por isso que não há ciclo entre os módulos de tool.
+ */
+// ==================== CONFIG ====================
+export const CONFIG = {
+    TIMEOUT_MS: 30000,
+    MAX_RETRIES: 3,
+    RETRY_DELAY_MS: 1000
+};
+// Worker uses shorter timeout (Cloudflare has its own limits)
+export const WORKER_CONFIG = {
+    TIMEOUT_MS: 10000,
+    MAX_RETRIES: 2,
+    RETRY_DELAY_MS: 1000
+};
+// ==================== VERSION (single source of truth) ====================
+//
+// This module runs under two builds that resolve package.json differently, so the
+// version is injected by each entry point instead of imported here:
+//   - index.ts (Node/stdio) reads it via createRequire and calls setServerVersion()
+//   - the Worker reads it via a JSON import inlined by esbuild and calls it too
+// A static `import "../package.json"` is avoided on purpose: it breaks tsc's rootDir
+// and createRequire is unavailable in the Worker runtime (no nodejs_compat).
+// The fallback is only used if no entry point injects a version; keep it = package.json.
+let serverVersion = "1.3.5";
+export function setServerVersion(version) {
+    serverVersion = version;
+}
+export function getUserAgent() {
+    return `bcb-br-mcp/${serverVersion}`;
+}
+// ==================== OUTPUT HELPERS ====================
+/**
+ * Builds a ToolResult that satisfies an MCP tool's outputSchema:
+ * the same payload is exposed as machine-readable structuredContent and,
+ * for backward compatibility, serialized into a TextContent block.
+ */
+export function structuredResult(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload
+    };
+}
+/** Falha de tool: `isError` com texto em pt-BR, nunca erro de protocolo. */
+export function erroResult(texto) {
+    return { content: [{ type: "text", text: texto }], isError: true };
+}
+export function mensagemDeErro(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+// ==================== UTILITY FUNCTIONS ====================
+export function normalizeString(str) {
+    return str
+        .toLowerCase()
+        .normalize("NFD")
+        .replace(/\p{M}/gu, ""); // marcas de combinação — equivalente a [̀-ͯ] sem escape literal
+}
+export function formatDateForApi(dateStr) {
+    if (dateStr.includes("-")) {
+        const [year, month, day] = dateStr.split("-");
+        return `${day}/${month}/${year}`;
+    }
+    return dateStr;
+}
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export async function fetchWithTimeout(url, timeoutMs) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            signal: controller.signal,
+            headers: {
+                "Accept": "application/json",
+                "User-Agent": getUserAgent()
+            }
+        });
+        return response;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+export async function fetchBcbApi(url, timeoutMs = CONFIG.TIMEOUT_MS, maxRetries = CONFIG.MAX_RETRIES) {
+    let lastError = null;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            const response = await fetchWithTimeout(url, timeoutMs);
+            if (!response.ok) {
+                if (response.status === 404) {
+                    throw new Error(`Série não encontrada ou sem dados para o período solicitado`);
+                }
+                throw new Error(`Erro na API do BCB: ${response.status} ${response.statusText}`);
+            }
+            return response.json();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (lastError.message.includes("não encontrada")) {
+                throw lastError;
+            }
+            const isTimeout = lastError.name === "AbortError" ||
+                lastError.message.includes("aborted") ||
+                lastError.message.includes("timeout");
+            if (attempt < maxRetries) {
+                const delayMs = CONFIG.RETRY_DELAY_MS * Math.pow(2, attempt - 1);
+                const reason = isTimeout ? "timeout" : "erro";
+                console.error(`Tentativa ${attempt}/${maxRetries} falhou (${reason}). Aguardando ${delayMs}ms...`);
+                await sleep(delayMs);
+            }
+        }
+    }
+    throw new Error(`Falha após ${maxRetries} tentativas: ${lastError?.message || "Erro desconhecido"}`);
+}
+export function calculateVariation(valorInicial, valorFinal) {
+    if (valorInicial === 0)
+        return 0;
+    return ((valorFinal - valorInicial) / Math.abs(valorInicial)) * 100;
+}
+// ==================== SCHEMA ====================
+/**
+ * Seals every object node of a JSON Schema (`additionalProperties: false`),
+ * recursively. Zod sealed objects by construction, so the stdio channel always
+ * advertised sealed schemas; doing it here in one place keeps that guarantee
+ * after the SDK v2 migration and extends it to the HTTP channel, which never
+ * had it.
+ */
+export function sealDeep(schema) {
+    if (Array.isArray(schema))
+        return schema.map(sealDeep);
+    if (schema === null || typeof schema !== "object")
+        return schema;
+    const node = schema;
+    const sealedEntries = Object.fromEntries(Object.entries(node).map(([k, v]) => [k, sealDeep(v)]));
+    return (node.type === "object" && node.properties !== undefined
+        ? { ...sealedEntries, additionalProperties: false }
+        : sealedEntries);
+}
+/** Anotações padrão do portfólio: toda tool aqui é leitura de API pública. */
+export function leituraRemota(title) {
+    return { title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

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