vault-go 0.26.0 → 0.27.0

package/README.md

@@ -148,7 +148,7 @@ Projects and sessions: `vault_go_projects`, `vault_go_project_create`, `vault_go
 
 Capture and recall: `vault_go_event`, `vault_go_remember`, `vault_go_forget`, `vault_go_search`, `vault_go_search_index`, `vault_go_retrieve`, `vault_go_observations`, `vault_go_timeline`, `vault_go_context`, `vault_go_file_context`, `vault_go_feed`, `vault_go_memory`, `vault_go_tool_uses`, `vault_go_stats`.
 
-`vault_go_retrieve` lets the central memory engine choose a bounded retrieval path while every explicit retrieval tool remains available. `vault_go_decision_status` reports sanitized rollout/circuit state. Jev and its credential remain in the engine; a healthy deployment does not by itself prove provider availability or decision quality.
+`vault_go_retrieve` lets the central memory engine choose a bounded retrieval path while every explicit retrieval tool remains available. `vault_go_decision_status` reports sanitized rollout/circuit state. Jev and its credential remain in the engine; a healthy deployment does not by itself prove provider availability or decision quality. `vault_go_decide` sends a caller-authored state plus up to 8 typed questions (`noul`, `choice`, `score`) to the central Jev and returns probabilities; it runs only in `full` rollout, one call at a time, refuses secrets, e-mails, identifiers, URLs and absolute local paths before anything leaves Vault, and persists nothing. The caller still owns the decision.
 
 Knowledge bases: `vault_go_knowledge_bases`, `vault_go_knowledge_base`, `vault_go_knowledge_build`, `vault_go_knowledge_rebuild`, `vault_go_knowledge_query`, `vault_go_knowledge_delete`, `vault_go_prime_corpus`, `vault_go_query_corpus`, `vault_go_reprime_corpus`.
 

package/dist/capabilities.d.ts

@@ -26,8 +26,8 @@ export declare const CAPABILITIES: {
     }, {
         readonly upstream: readonly ["automatic retrieval routing", "typed memory decisions"];
         readonly status: "available";
-        readonly tools: readonly ["vault_go_retrieve", "vault_go_decision_status"];
-        readonly requires: "Jev runs only in the central memory engine. Status is sanitized; deployment availability does not prove provider health or decision quality. Explicit retrieval tools remain available.";
+        readonly tools: readonly ["vault_go_retrieve", "vault_go_decision_status", "vault_go_decide"];
+        readonly requires: "Jev runs only in the central memory engine. Status is sanitized; deployment availability does not prove provider health or decision quality. vault_go_decide forwards caller-authored typed questions only in full rollout and refuses protected content. Explicit retrieval tools remain available.";
     }, {
         readonly upstream: readonly ["get_tool_uses"];
         readonly status: "available";
@@ -142,8 +142,8 @@ export declare function getCapabilities(home: string, cloud: VaultMemoryApi, ver
     }, {
         readonly upstream: readonly ["automatic retrieval routing", "typed memory decisions"];
         readonly status: "available";
-        readonly tools: readonly ["vault_go_retrieve", "vault_go_decision_status"];
-        readonly requires: "Jev runs only in the central memory engine. Status is sanitized; deployment availability does not prove provider health or decision quality. Explicit retrieval tools remain available.";
+        readonly tools: readonly ["vault_go_retrieve", "vault_go_decision_status", "vault_go_decide"];
+        readonly requires: "Jev runs only in the central memory engine. Status is sanitized; deployment availability does not prove provider health or decision quality. vault_go_decide forwards caller-authored typed questions only in full rollout and refuses protected content. Explicit retrieval tools remain available.";
     }, {
         readonly upstream: readonly ["get_tool_uses"];
         readonly status: "available";

package/dist/capabilities.js

@@ -11,7 +11,7 @@ export const CAPABILITIES = {
     capabilities: [
         { upstream: ['important_workflow'], status: 'available', tools: ['vault_go_workflow'] },
         { upstream: ['search', 'get_observations', 'timeline'], status: 'available', tools: ['vault_go_search_index', 'vault_go_observations', 'vault_go_timeline', 'vault_go_feed'], difference: 'Vault uses UUID identifiers. Search accepts an optional query, offset and date ordering; timeline accepts an explicit UUID or resolves an anchor from a query; feed uses stable cursor pagination.' },
-        { upstream: ['automatic retrieval routing', 'typed memory decisions'], status: 'available', tools: ['vault_go_retrieve', 'vault_go_decision_status'], requires: 'Jev runs only in the central memory engine. Status is sanitized; deployment availability does not prove provider health or decision quality. Explicit retrieval tools remain available.' },
+        { upstream: ['automatic retrieval routing', 'typed memory decisions'], status: 'available', tools: ['vault_go_retrieve', 'vault_go_decision_status', 'vault_go_decide'], requires: 'Jev runs only in the central memory engine. Status is sanitized; deployment availability does not prove provider health or decision quality. vault_go_decide forwards caller-authored typed questions only in full rollout and refuses protected content. Explicit retrieval tools remain available.' },
         { upstream: ['get_tool_uses'], status: 'available', tools: ['vault_go_tool_uses'], requires: 'Verified POST /memory/events/batch contract. Historical output exists only when captured; private fields and secrets are redacted from retrieval.' },
         { upstream: ['session_start_context', 'multi-project context'], status: 'available', tools: ['vault_go_session_start_context', 'vault_go_context', 'vault_go_file_context', 'vault_go_context_chain', 'vault_go_context_chain_configure'], requires: 'Context chains require explicit local configuration and share one bounded character budget. Native hooks cover Claude, Codex, Grok, Agy and Gemini; OpenCode 1.x remains context-only.' },
         { upstream: ['smart_search', 'smart_outline', 'smart_unfold'], status: 'available', tools: ['vault_go_smart_search', 'vault_go_smart_outline', 'vault_go_smart_unfold', 'vault_go_smart_languages'], requires: 'Real grammars for all 24 upstream languages plus HTML. Availability is reported per running platform; SCSS has no Linux ARM64 prebuild. Workspace reads and results are bounded.' },

package/dist/cloud.d.ts

@@ -26,6 +26,7 @@ export interface VaultMemoryApi {
     search(input: Record<string, unknown>): Promise<unknown>;
     retrieve?(input: Record<string, unknown>): Promise<unknown>;
     decisionStatus?(): Promise<unknown>;
+    decide?(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>;
@@ -73,6 +74,7 @@ export declare class VaultCloudClient implements VaultMemoryApi {
     search(input: Record<string, unknown>): Promise<unknown>;
     retrieve(input: Record<string, unknown>): Promise<unknown>;
     decisionStatus(): Promise<unknown>;
+    decide(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>;

package/dist/cloud.js

@@ -108,6 +108,9 @@ export class VaultCloudClient {
     async decisionStatus() {
         return this.request('/memory/decisions/status');
     }
+    async decide(input) {
+        return this.request('/memory/decisions/evaluate', { method: 'POST', body: input });
+    }
     async searchIndex(input) {
         return this.request('/memory/search/index', { method: 'POST', body: input });
     }

package/dist/server.js

@@ -218,6 +218,40 @@ export function createVaultGoServer(home = vaultHome(), cloud = new VaultCloudCl
             throw new Error('Decision status is unavailable on this deployment.');
         return cloud.decisionStatus();
     }));
+    const decisionText = (max) => z.string().trim().min(1).max(max);
+    const decisionQuestion = z.discriminatedUnion('type', [
+        z.object({
+            type: z.literal('noul'),
+            instructions: decisionText(2_000),
+            criteria: z.object({ true: decisionText(500), false: decisionText(500) }).strict().optional(),
+        }).strict(),
+        z.object({
+            type: z.literal('choice'),
+            instructions: decisionText(2_000),
+            criteria: z.record(z.string().regex(/^[a-z0-9][a-z0-9_-]{0,47}$/), decisionText(500))
+                .refine((options) => Object.keys(options).length >= 2 && Object.keys(options).length <= 32, 'choice needs 2 to 32 options'),
+        }).strict(),
+        z.object({
+            type: z.literal('score'),
+            instructions: decisionText(2_000),
+            criteria: z.array(decisionText(500)).min(2).max(10),
+        }).strict(),
+    ]);
+    server.registerTool('vault_go_decide', {
+        title: 'Decidir com o Jev',
+        description: 'Envia ao Jev central um estado e até 8 perguntas tipadas (noul = probabilidade de sim; choice = uma opção entre 2–32; score = nível entre 2–10) e retorna respostas com probabilidades. '
+            + 'Exige rollout full. Segredos, e-mails, UUIDs, URLs e caminhos locais absolutos são recusados antes de sair do Vault. Nada é persistido; a decisão final continua sendo de quem chama.',
+        inputSchema: {
+            state: z.union([z.string().trim().min(1), z.record(z.string(), z.unknown()), z.array(z.unknown()).min(1)]),
+            questions: z.record(z.string().regex(/^[a-z][a-z0-9_]{0,47}$/), decisionQuestion)
+                .refine((questions) => Object.keys(questions).length >= 1 && Object.keys(questions).length <= 8, 'questions must contain 1 to 8 entries'),
+        },
+        annotations: { readOnlyHint: true, idempotentHint: false, openWorldHint: true },
+    }, async (input) => run(() => {
+        if (!cloud.decide)
+            throw new Error('Jev decisions are unavailable on this deployment.');
+        return cloud.decide(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.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vault-go",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "MCP server and installer for Vault Memory: search, capture, and use account memory across AI clients.",
   "type": "module",
   "bin": {