vault-go 0.7.0 → 0.8.0

package/README.md

@@ -104,6 +104,8 @@ limitados.
 - `vault_go_event`: eventos de prompt, ferramenta e resultado.
 - `vault_go_remember`: observações, decisões, descobertas e resumos.
 - `vault_go_search`: busca textual com ranking e trechos.
+- `vault_go_search_index`: índice compacto com filtros, trechos e custo estimado.
+- `vault_go_observations`: carrega em lote somente os IDs selecionados.
 - `vault_go_timeline`: contexto anterior e posterior a uma memória.
 - `vault_go_context`: contexto progressivo com limite de caracteres.
 - `vault_go_file_context`: histórico ligado aos arquivos lidos ou modificados.
@@ -121,6 +123,15 @@ limitados.
 
 O recurso `vault-go://status` fornece o resumo sanitizado em JSON.
 
+Para reduzir o uso de contexto, prefira a recuperação em três camadas:
+
+1. Pesquise com `vault_go_search_index`, usando projeto, origem, conceitos,
+   arquivos e intervalo de datas quando conhecidos.
+2. Abra `vault_go_timeline` somente para os resultados que precisam de
+   contexto cronológico.
+3. Envie os IDs escolhidos a `vault_go_observations` para carregar o conteúdo
+   completo em um único lote tenant-scoped.
+
 As bases, filtros, vínculos e feed ficam exclusivamente no PostgreSQL da
 plataforma. A consulta retorna evidências e `synthesisAvailable: false`; o
 cliente MCP faz a síntese, evitando respostas inventadas e chaves ocultas no

package/dist/cloud.d.ts

@@ -8,6 +8,8 @@ export interface VaultMemoryApi {
     remember(input: Record<string, unknown>): Promise<unknown>;
     forget(id: string): Promise<unknown>;
     search(input: Record<string, unknown>): Promise<unknown>;
+    searchIndex(input: Record<string, unknown>): Promise<unknown>;
+    observations(ids: string[]): Promise<unknown>;
     timeline(input: Record<string, unknown>): Promise<unknown>;
     context(input: Record<string, unknown>): Promise<unknown>;
     fileContext(input: Record<string, unknown>): Promise<unknown>;
@@ -40,6 +42,8 @@ export declare class VaultCloudClient implements VaultMemoryApi {
     remember(input: Record<string, unknown>): Promise<unknown>;
     forget(id: string): Promise<unknown>;
     search(input: Record<string, unknown>): Promise<unknown>;
+    searchIndex(input: Record<string, unknown>): Promise<unknown>;
+    observations(ids: string[]): Promise<unknown>;
     timeline(input: Record<string, unknown>): Promise<unknown>;
     context(input: Record<string, unknown>): Promise<unknown>;
     fileContext(input: Record<string, unknown>): Promise<unknown>;

package/dist/cloud.js

@@ -34,6 +34,12 @@ export class VaultCloudClient {
     async search(input) {
         return this.request('/memory/search', { method: 'POST', body: input });
     }
+    async searchIndex(input) {
+        return this.request('/memory/search/index', { method: 'POST', body: input });
+    }
+    async observations(ids) {
+        return this.request('/memory/memories/batch', { method: 'POST', body: { ids } });
+    }
     async timeline(input) {
         return this.request('/memory/timeline', { method: 'POST', body: input });
     }

package/dist/server.js

@@ -127,10 +127,40 @@ export function createVaultGoServer(home = vaultHome(), cloud = new VaultCloudCl
             projectId: uuid.optional(),
             kind: z.string().trim().max(100).optional(),
             memoryType: z.string().trim().max(100).optional(),
+            platformSource: z.string().trim().max(100).optional(),
+            concepts: z.array(z.string().trim().min(1).max(500)).max(50).default([]),
+            files: z.array(z.string().trim().min(1).max(2_000)).max(50).default([]),
+            dateStartEpoch: z.number().int().positive().optional(),
+            dateEndEpoch: z.number().int().positive().optional(),
             limit: z.number().int().min(1).max(200).default(20),
         },
         annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
     }, async (input) => run(() => cloud.search(input)));
+    server.registerTool('vault_go_search_index', {
+        title: 'Pesquisar índice compacto',
+        description: 'Primeira camada de recuperação: retorna metadados, trechos e custo estimado sem carregar o conteúdo completo.',
+        inputSchema: {
+            query: z.string().trim().min(1).max(1_000),
+            projectId: uuid.optional(),
+            kind: z.string().trim().max(100).optional(),
+            memoryType: z.string().trim().max(100).optional(),
+            platformSource: z.string().trim().max(100).optional(),
+            concepts: z.array(z.string().trim().min(1).max(500)).max(50).default([]),
+            files: z.array(z.string().trim().min(1).max(2_000)).max(50).default([]),
+            dateStartEpoch: z.number().int().positive().optional(),
+            dateEndEpoch: z.number().int().positive().optional(),
+            limit: z.number().int().min(1).max(200).default(20),
+        },
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    }, async (input) => run(() => cloud.searchIndex(input)));
+    server.registerTool('vault_go_observations', {
+        title: 'Carregar observações por ID',
+        description: 'Terceira camada de recuperação: carrega em lote somente as observações escolhidas no índice ou na linha do tempo.',
+        inputSchema: {
+            ids: z.array(uuid).min(1).max(100),
+        },
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    }, async ({ ids }) => run(() => cloud.observations(ids)));
     server.registerTool('vault_go_timeline', {
         title: 'Abrir linha do tempo',
         description: 'Retorna memórias anteriores e posteriores a uma memória âncora.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vault-go",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Servidor MCP Bun para pesquisar e registrar memória na plataforma Vault.",
   "type": "module",
   "bin": {