vault-go 0.2.0 → 0.4.0

package/README.md

@@ -66,7 +66,10 @@ renovação automática da sessão.
 - `vault_go_search`: busca textual com ranking e trechos.
 - `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.
 - `vault_go_stats`: contagens isoladas da conta.
+- `vault_go_jobs`: fila PostgreSQL da conta, sem payload sensível.
+- `vault_go_job_retry` e `vault_go_job_cancel`: controle idempotente do processamento.
 - `vault_go_forget`: exclusão explícita de uma memória.
 
 O recurso `vault-go://status` fornece o resumo sanitizado em JSON.

package/dist/cloud.d.ts

@@ -10,7 +10,11 @@ export interface VaultMemoryApi {
     search(input: Record<string, unknown>): Promise<unknown>;
     timeline(input: Record<string, unknown>): Promise<unknown>;
     context(input: Record<string, unknown>): Promise<unknown>;
+    fileContext(input: Record<string, unknown>): Promise<unknown>;
     stats(): Promise<unknown>;
+    jobs(input: Record<string, unknown>): Promise<unknown>;
+    retryJob(id: string): Promise<unknown>;
+    cancelJob(id: string): Promise<unknown>;
 }
 export declare class VaultCloudClient implements VaultMemoryApi {
     private readonly home;
@@ -27,7 +31,11 @@ export declare class VaultCloudClient implements VaultMemoryApi {
     search(input: Record<string, unknown>): Promise<unknown>;
     timeline(input: Record<string, unknown>): Promise<unknown>;
     context(input: Record<string, unknown>): Promise<unknown>;
+    fileContext(input: Record<string, unknown>): Promise<unknown>;
     stats(): Promise<unknown>;
+    jobs(input: Record<string, unknown>): Promise<unknown>;
+    retryJob(id: string): Promise<unknown>;
+    cancelJob(id: string): Promise<unknown>;
     private endpoint;
     private accessToken;
     private request;

package/dist/cloud.js

@@ -40,9 +40,27 @@ export class VaultCloudClient {
     async context(input) {
         return this.request('/memory/context', { method: 'POST', body: input });
     }
+    async fileContext(input) {
+        return this.request('/memory/files/context', { method: 'POST', body: input });
+    }
     async stats() {
         return this.request('/memory/stats');
     }
+    async jobs(input) {
+        const query = new URLSearchParams();
+        for (const [key, value] of Object.entries(input)) {
+            if (value !== undefined)
+                query.set(key, String(value));
+        }
+        const suffix = query.size > 0 ? `?${query.toString()}` : '';
+        return this.request(`/memory/jobs${suffix}`);
+    }
+    async retryJob(id) {
+        return this.request(`/memory/jobs/${encodeURIComponent(id)}/retry`, { method: 'POST' });
+    }
+    async cancelJob(id) {
+        return this.request(`/memory/jobs/${encodeURIComponent(id)}/cancel`, { method: 'POST' });
+    }
     endpoint(path) {
         const base = validateApiUrl(loadConfig(this.home).apiUrl);
         const prefix = base.pathname.replace(/\/$/u, '');

package/dist/server.js

@@ -141,12 +141,45 @@ export function createVaultGoServer(home = vaultHome(), cloud = new VaultCloudCl
         },
         annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
     }, async (input) => run(() => cloud.context(input)));
+    server.registerTool('vault_go_file_context', {
+        title: 'Contexto de arquivos',
+        description: 'Recupera memórias anteriores associadas a um ou mais arquivos do projeto.',
+        inputSchema: {
+            projectId: uuid,
+            paths: z.array(z.string().trim().min(1).max(2_000)).min(1).max(20),
+            limit: z.number().int().min(1).max(100).default(20),
+            maxChars: z.number().int().min(1_000).max(100_000).default(16_000),
+        },
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    }, async (input) => run(() => cloud.fileContext(input)));
     server.registerTool('vault_go_stats', {
         title: 'Estatísticas do Vault',
         description: 'Mostra contagens da conta autenticada.',
         inputSchema: {},
         annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
     }, async () => run(() => cloud.stats()));
+    server.registerTool('vault_go_jobs', {
+        title: 'Fila de processamento',
+        description: 'Lista jobs da conta sem expor o conteúdo dos eventos.',
+        inputSchema: {
+            projectId: uuid.optional(),
+            status: z.enum(['queued', 'processing', 'completed', 'failed', 'cancelled']).optional(),
+            limit: z.number().int().min(1).max(200).default(20),
+        },
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    }, async (input) => run(() => cloud.jobs(input)));
+    server.registerTool('vault_go_job_retry', {
+        title: 'Reprocessar job',
+        description: 'Recoloca um job com falha ou cancelado na fila PostgreSQL.',
+        inputSchema: { id: uuid },
+        annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ id }) => run(() => cloud.retryJob(id)));
+    server.registerTool('vault_go_job_cancel', {
+        title: 'Cancelar job',
+        description: 'Cancela de forma idempotente um job pendente ou em processamento.',
+        inputSchema: { id: uuid },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
+    }, async ({ id }) => run(() => cloud.cancelJob(id)));
     server.registerResource('vault-go-status', 'vault-go://status', {
         title: 'Status do Vault Go',
         description: 'Resumo sanitizado da conexão cloud.',

package/package.json

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