bling-docs-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 João Vitor Labiak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,281 @@
+# Bling Docs MCP
+
+[![npm version](https://img.shields.io/npm/v/bling-docs-mcp.svg)](https://www.npmjs.com/package/bling-docs-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
+[![MCP](https://img.shields.io/badge/MCP-compatível-blue.svg)](https://modelcontextprotocol.io/)
+
+Servidor [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) que dá a assistentes de IA acesso especializado à **documentação da API do [Bling ERP](https://www.bling.com.br/)**. Em vez de carregar toda a especificação OpenAPI no contexto, a IA descobre e busca apenas o que precisa — endpoints, schemas, autenticação e guias — através de 6 ferramentas otimizadas.
+
+---
+
+## ✨ Funcionalidades
+
+- **6 ferramentas especializadas** — `describe`, `search_endpoints`, `get_endpoint_details`, `get_schema`, `read_documentation_page`, `search_documentation`
+- **Auto-descoberta** — encontra automaticamente a URL da spec OpenAPI mais recente no portal Bling (sem URLs hardcoded que quebram)
+- **Busca semântica** — embeddings Google AI (`text-embedding-004`) opcionais para busca em linguagem natural
+- **53 docs pré-incluídos** — guias, webhooks, changelogs, FAQs, migração JWT e mais — tudo disponível offline
+- **Cache inteligente** — spec cacheada em disco por 15 dias; embeddings cacheados para evitar regeneração a cada startup
+- **Zero configuração** — funciona direto via `npx`, nenhuma API key obrigatória (busca semântica é opcional)
+
+---
+
+## 🚀 Início Rápido
+
+```bash
+# Clonar e buildar
+git clone https://github.com/joaovitorlabiak-byte/bling-docs-mcp.git
+cd bling-docs-mcp
+npm install
+npm run build
+```
+
+Ou instale direto do GitHub via npm:
+
+```bash
+npm install -g github:joaovitorlabiak-byte/bling-docs-mcp
+```
+
+---
+
+## ⚙️ Configuração
+
+Adicione o servidor na configuração MCP do seu cliente de IA:
+
+### Claude Desktop
+
+Edite `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "bling-docs": {
+      "command": "node",
+      "args": ["/caminho/para/bling-docs-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+### VS Code (Copilot)
+
+Adicione em `.vscode/mcp.json` no seu workspace:
+
+```json
+{
+  "servers": {
+    "bling-docs": {
+      "command": "node",
+      "args": ["/caminho/para/bling-docs-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Adicione em `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "bling-docs": {
+      "command": "node",
+      "args": ["/caminho/para/bling-docs-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+### Windsurf / Codeium
+
+Adicione em `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "bling-docs": {
+      "command": "node",
+      "args": ["/caminho/para/bling-docs-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+### Com Busca Semântica (opcional)
+
+Para habilitar busca em linguagem natural nos endpoints, defina sua Google AI API key:
+
+```json
+{
+  "mcpServers": {
+    "bling-docs": {
+      "command": "node",
+      "args": ["/caminho/para/bling-docs-mcp/dist/index.js"],
+      "env": {
+        "GOOGLE_API_KEY": "sua-google-api-key"
+      }
+    }
+  }
+}
+```
+
+Obtenha uma API key gratuita em [Google AI Studio](https://aistudio.google.com/apikey).
+
+---
+
+## 🛠️ Ferramentas
+
+| Ferramenta | Descrição |
+|------------|-----------|
+| **`describe`** | Visão geral da API: título, versão, URL base, autenticação OAuth2, todos os módulos com contagem de endpoints. **Chame primeiro.** |
+| **`search_endpoints`** | Busca endpoints por palavra-chave, linguagem natural (com busca semântica), tag ou método HTTP. |
+| **`get_endpoint_details`** | Detalhes completos do endpoint: parâmetros, schema do request body, respostas, escopos de segurança e payload de exemplo gerado automaticamente. |
+| **`get_schema`** | Lista todos os schemas ou retorna um schema específico com definições completas de propriedades e JSON de exemplo. |
+| **`read_documentation_page`** | Lê uma página específica da documentação Bling (guias, webhooks, limites, changelogs, migração JWT, FAQs). |
+| **`search_documentation`** | Busca full-text em todas as 53 páginas de documentação incluídas. |
+
+### Exemplos de Uso
+
+Após configurar o servidor MCP, pergunte ao seu assistente de IA:
+
+- *"Quais endpoints existem para gerenciar produtos no Bling?"*
+- *"Como faço para criar um pedido de venda? Mostre os campos obrigatórios."*
+- *"Qual é o schema do ProdutoDTO?"*
+- *"Como funciona a autenticação OAuth2 na API do Bling?"*
+- *"Quais são os limites de requisição da API?"*
+- *"Mostre a estrutura do payload de webhook para pedidos"*
+
+---
+
+## 🏗️ Como Funciona
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     Bling Docs MCP Server                   │
+│                                                             │
+│  1. DESCOBERTA  Encontra a URL da spec OpenAPI mais         │
+│                 recente em developer.bling.com.br/referencia │
+│                                                             │
+│  2. CARGA       Baixa + resolve $refs da spec               │
+│                 (cacheado em disco por 15 dias)              │
+│                                                             │
+│  3. INDEXAÇÃO   Constrói índices de busca em memória:        │
+│                 • Endpoints por tag, path, método            │
+│                 • Schemas por nome                           │
+│                 • Embeddings vetoriais (opcional)            │
+│                                                             │
+│  4. SERVE       Responde às chamadas MCP do assistente      │
+│                                                             │
+│  📄 docs/       53 arquivos markdown pré-incluídos para     │
+│                 guias, webhooks, changelogs, FAQs            │
+└─────────────────────────────────────────────────────────────┘
+```
+
+As páginas de documentação em `docs/` são **pré-incluídas** — vêm no pacote e são lidas localmente em runtime. Nenhum crawling ou fetch externo é necessário.
+
+---
+
+## 💻 Desenvolvimento
+
+### Pré-requisitos
+
+- Node.js 18+
+- npm
+
+### Setup
+
+```bash
+# Clonar o repositório
+git clone https://github.com/joavitorlabiak-byte/bling-docs-mcp.git
+cd bling-docs-mcp
+
+# Instalar dependências
+npm install
+
+# Build
+npm run build
+
+# Executar localmente
+npm start
+```
+
+### Testes
+
+```bash
+# Executar todos os testes
+npm test
+
+# Modo watch
+npm run test:watch
+```
+
+### Estrutura do Projeto
+
+```
+bling-docs-mcp/
+├── src/
+│   ├── index.ts              # Entry point do servidor
+│   ├── lib/
+│   │   ├── loader.ts         # Auto-descoberta + carregamento da spec OpenAPI
+│   │   ├── indexer.ts         # Engine de indexação da spec
+│   │   ├── schema-resolver.ts # Resolução de $ref + achatamento de schemas
+│   │   ├── embeddings.ts      # Integração Google AI embeddings
+│   │   ├── vector-store.ts    # Busca por similaridade de cosseno em memória
+│   │   └── types.ts           # Definições de tipos TypeScript
+│   └── tools/
+│       ├── describe.ts
+│       ├── search-endpoints.ts
+│       ├── get-endpoint-details.ts
+│       ├── get-schema.ts
+│       ├── read-documentation-page.ts
+│       └── search-documentation.ts
+├── docs/                      # 53 páginas de documentação pré-incluídas
+├── scripts/
+│   └── fetch-bling-docs.js    # Crawler de documentação (ferramenta de manutenção)
+├── package.json
+├── tsconfig.json
+└── vitest.config.ts
+```
+
+### Atualizando as Páginas de Documentação
+
+A pasta `docs/` contém markdown pré-extraído do [Portal do Desenvolvedor Bling](https://developer.bling.com.br). Para atualizar esses docs, use o script crawler (requer uma instância [Crawl4AI](https://github.com/unclecode/crawl4ai)):
+
+```bash
+# Defina a URL da sua instância Crawl4AI
+export CRAWL4AI_URL=http://localhost:11235
+
+# Buscar todos os docs (pula existentes por padrão)
+npm run fetch-docs
+
+# Forçar re-fetch de tudo
+npm run fetch-docs -- --force
+
+# Buscar apenas uma seção específica
+npm run fetch-docs -- --section=webhooks
+```
+
+---
+
+## 🤝 Contribuindo
+
+Contribuições são bem-vindas! Por favor:
+
+1. Faça um fork do repositório
+2. Crie uma branch para sua feature (`git checkout -b feature/minha-feature`)
+3. Commit suas alterações (`git commit -am 'Adiciona minha feature'`)
+4. Push para a branch (`git push origin feature/minha-feature`)
+5. Abra um Pull Request
+
+---
+
+## 📄 Licença
+
+[MIT](LICENSE) © João Vitor Labiak
+
+---
+
+## ⚠️ Aviso
+
+Este projeto não é afiliado, endossado ou oficialmente conectado ao [Bling](https://www.bling.com.br/). Ele utiliza a especificação OpenAPI e documentação para desenvolvedores publicamente disponíveis.

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Bling Docs MCP Server — Optimized Edition
+ *
+ * 6 tools with semantic search via Google text-embedding-004:
+ *   1. describe                — API overview, auth, modules, usage guide
+ *   2. search_endpoints        — Semantic/keyword/browse search over endpoints
+ *   3. get_endpoint_details    — Full endpoint details + auto-generated example
+ *   4. get_schema              — List all schemas OR get full schema + example
+ *   5. read_documentation_page — Read a specific Bling docs page by name
+ *   6. search_documentation    — Full-text search across all docs pages
+ *
+ * Set GOOGLE_API_KEY env var to enable semantic search.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}

package/dist/index.js

@@ -0,0 +1,275 @@
+#!/usr/bin/env node
+/**
+ * Bling Docs MCP Server — Optimized Edition
+ *
+ * 6 tools with semantic search via Google text-embedding-004:
+ *   1. describe                — API overview, auth, modules, usage guide
+ *   2. search_endpoints        — Semantic/keyword/browse search over endpoints
+ *   3. get_endpoint_details    — Full endpoint details + auto-generated example
+ *   4. get_schema              — List all schemas OR get full schema + example
+ *   5. read_documentation_page — Read a specific Bling docs page by name
+ *   6. search_documentation    — Full-text search across all docs pages
+ *
+ * Set GOOGLE_API_KEY env var to enable semantic search.
+ */
+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 { loadOpenAPISpec, discoverOpenAPIUrl } from './lib/loader.js';
+import { indexOpenAPISpec } from './lib/indexer.js';
+import { VectorStore } from './lib/vector-store.js';
+import { embedTexts, embedText, isEmbeddingEnabled } from './lib/embeddings.js';
+import { promises as fs } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { tmpdir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { describe as describeTool } from './tools/describe.js';
+import { searchEndpoints, buildEndpointChunk } from './tools/search-endpoints.js';
+import { getEndpointDetails } from './tools/get-endpoint-details.js';
+import { getSchema } from './tools/get-schema.js';
+import { readDocumentationPage } from './tools/read-documentation-page.js';
+import { searchDocumentation } from './tools/search-documentation.js';
+// Resolve docs path relative to project root
+const __filename_local = fileURLToPath(import.meta.url);
+const __dirname_local = dirname(__filename_local);
+const DOCS_PATH = resolve(__dirname_local, '..', 'docs');
+// Global state
+let indexedData;
+let openAPISpec;
+let endpointVectorStore;
+// ─────────────────────────────────────────────
+// Tool definitions
+// ─────────────────────────────────────────────
+const TOOLS = [
+    {
+        name: 'describe',
+        description: 'Get a high-level overview of the Bling API: title, version, base URL, authentication (OAuth2 flows & scopes), all modules with endpoint counts, common parameters, and a usage guide. CALL THIS FIRST to understand the API structure before searching for endpoints.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'search_endpoints',
+        description: 'Search for API endpoints. Supports semantic search (natural language, e.g. "how to cancel an order"), keyword search, and browsing. Filter by tag/module or HTTP method. Returns path, method, summary, and similarity score when using semantic search.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Natural language or keyword query (e.g., "criar produto", "emitir nota fiscal"). Enables semantic search when Google API key is configured.',
+                },
+                tag: {
+                    type: 'string',
+                    description: 'Filter by module/tag name (e.g., "Produtos", "Pedidos de Venda", "Nota Fiscal de Serviço"). Use describe to see all available tags.',
+                },
+                method: {
+                    type: 'string',
+                    description: 'Filter by HTTP method: GET, POST, PUT, DELETE, PATCH',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return (default: 20)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_endpoint_details',
+        description: 'Get FULL details for a specific endpoint: all parameters (path, query, header), complete request body schema with field descriptions, all response schemas, required security scopes, and an auto-generated request body example. Use after finding an endpoint path with search_endpoints.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: 'The endpoint path, e.g. "/produtos" or "/pedidos/{idPedido}"',
+                },
+                method: {
+                    type: 'string',
+                    description: 'The HTTP method: GET, POST, PUT, DELETE, PATCH',
+                },
+            },
+            required: ['path', 'method'],
+        },
+    },
+    {
+        name: 'get_schema',
+        description: 'List available data schemas OR get a specific schema with full field details and an example JSON. Without "ref": lists all schemas with names and types. With "ref": returns complete schema definition (properties, types, validation rules, required fields) plus auto-generated example payload.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ref: {
+                    type: 'string',
+                    description: 'Schema name or $ref (e.g., "produtos", "#/components/schemas/produtos"). Omit to list all schemas.',
+                },
+                filter: {
+                    type: 'string',
+                    description: 'Text filter when listing schemas (only used when "ref" is omitted)',
+                },
+            },
+        },
+    },
+    {
+        name: 'read_documentation_page',
+        description: 'Read a specific Bling documentation page (Markdown). Use this to get detailed information about guides, webhooks, limits, changelogs, JWT migration, publishing, and FAQs. Supports partial/fuzzy name matching.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                page: {
+                    type: 'string',
+                    description: 'Name of the page/topic to read (e.g. "webhooks", "guias_introducao", "limites", "migracao-jwt"). Partial names are accepted.',
+                },
+            },
+            required: ['page'],
+        },
+    },
+    {
+        name: 'search_documentation',
+        description: 'Full-text search across all Bling documentation pages (Guides, Webhooks, Limits, Changelogs, FAQs, JWT Migration, Publishing). Returns matching files with a short text snippet. Use this to quickly find which documentation page contains a specific topic or keyword.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'The keyword or phrase to search for inside the documentation content (e.g. "OAuth", "retentativas", "access token", "homologação").',
+                },
+            },
+            required: ['query'],
+        },
+    },
+];
+function makeHandlers() {
+    return {
+        describe: () => describeTool(indexedData, openAPISpec),
+        search_endpoints: async (args) => {
+            const input = args;
+            return searchEndpoints(input, indexedData, endpointVectorStore, isEmbeddingEnabled() ? embedText : undefined);
+        },
+        get_endpoint_details: (args) => {
+            const input = args;
+            return getEndpointDetails(input, indexedData, openAPISpec);
+        },
+        get_schema: (args) => {
+            const input = args;
+            return getSchema(input, indexedData, openAPISpec);
+        },
+        read_documentation_page: (args) => {
+            const input = args;
+            return readDocumentationPage(input, DOCS_PATH);
+        },
+        search_documentation: (args) => {
+            const input = args;
+            return searchDocumentation(input, DOCS_PATH);
+        },
+    };
+}
+// ─────────────────────────────────────────────
+// Embedding cache (disk) — avoids 254 API calls on every startup
+// ─────────────────────────────────────────────
+const EMBED_CACHE_FILE = join(tmpdir(), 'bling-mcp-cache', 'embeddings-cache.json');
+async function loadEmbeddingsCache(specUrl) {
+    try {
+        const raw = await fs.readFile(EMBED_CACHE_FILE, 'utf-8');
+        const cache = JSON.parse(raw);
+        if (cache.specUrl === specUrl && cache.embeddings.length > 0) {
+            console.error(`⚡ Using cached embeddings (${cache.embeddings.length} vectors, spec unchanged)`);
+            return cache;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+async function saveEmbeddingsCache(specUrl, chunks, embeddings) {
+    try {
+        await fs.mkdir(join(tmpdir(), 'bling-mcp-cache'), { recursive: true });
+        const cache = { specUrl, chunks, embeddings };
+        await fs.writeFile(EMBED_CACHE_FILE, JSON.stringify(cache), 'utf-8');
+        console.error(`💾 Embeddings cached to disk (${embeddings.length} vectors)`);
+    }
+    catch (err) {
+        console.error(`⚠  Could not write embeddings cache: ${err.message}`);
+    }
+}
+// ─────────────────────────────────────────────
+// Embedding initialization
+// ─────────────────────────────────────────────
+async function initializeEmbeddings(specUrl) {
+    if (!isEmbeddingEnabled()) {
+        console.error('ℹ  GOOGLE_API_KEY not set — semantic search disabled, using keyword search');
+        return;
+    }
+    const endpoints = indexedData.endpoints;
+    const chunks = endpoints.map(buildEndpointChunk);
+    // Try loading from disk cache first
+    const cached = await loadEmbeddingsCache(specUrl);
+    let embeddings;
+    if (cached && cached.embeddings.length === endpoints.length) {
+        embeddings = cached.embeddings;
+    }
+    else {
+        console.error(`🔢 Generating embeddings for ${endpoints.length} endpoints via Google API...`);
+        embeddings = await embedTexts(chunks);
+        await saveEmbeddingsCache(specUrl, chunks, embeddings);
+    }
+    endpointVectorStore = new VectorStore();
+    endpointVectorStore.addBatch(endpoints.map((ep, i) => ({
+        id: `${ep.method} ${ep.path}`,
+        embedding: embeddings[i],
+        metadata: ep,
+    })));
+    console.error(`✅ Vector store ready: ${endpointVectorStore.size} endpoints indexed`);
+}
+// ─────────────────────────────────────────────
+// Server initialization
+// ─────────────────────────────────────────────
+async function initialize() {
+    console.error('📥 Loading Bling OpenAPI specification...');
+    const specUrl = await discoverOpenAPIUrl();
+    openAPISpec = await loadOpenAPISpec(specUrl);
+    console.error('🗂  Indexing API documentation...');
+    indexedData = indexOpenAPISpec(openAPISpec);
+    console.error(`✅ Indexed ${indexedData.endpoints.length} endpoints, ${indexedData.schemas.size} schemas, ${indexedData.tags.length} modules`);
+    // Initialize embeddings (non-blocking error — fallback to keyword)
+    try {
+        await initializeEmbeddings(specUrl);
+    }
+    catch (err) {
+        console.error('⚠  Embeddings failed, falling back to keyword search:', err.message);
+    }
+}
+// ─────────────────────────────────────────────
+// Main
+// ─────────────────────────────────────────────
+async function main() {
+    await initialize();
+    const server = new Server({ name: 'bling-docs-mcp', version: '3.0.0' }, { capabilities: { tools: {} } });
+    const handlers = makeHandlers();
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        const handler = handlers[name];
+        if (!handler) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        try {
+            const result = await handler(args);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: { code: 'TOOL_ERROR', message } }, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`🚀 Bling Docs MCP Server v3.0 running (6 tools, docs: ${DOCS_PATH})`);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    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/lib/embeddings.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Google Embeddings Module
+ * Uses Google's text-embedding-004 model to generate embeddings
+ * for semantic search over API endpoints and schemas
+ */
+/**
+ * Generate an embedding for a single text
+ */
+export declare function embedText(text: string): Promise<number[]>;
+/**
+ * Generate embeddings for multiple texts in batches
+ */
+export declare function embedTexts(texts: string[]): Promise<number[][]>;
+/**
+ * Check if the Google API key is configured
+ */
+export declare function isEmbeddingEnabled(): boolean;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/lib/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/lib/embeddings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAK/D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAerE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C"}