vault-go 0.14.0 → 0.16.0

package/README.md

@@ -88,6 +88,7 @@ Comandos explícitos:
 bunx --bun vault-go@latest setup
 bunx --bun vault-go@latest setup --clients codex,claude,copilot
 bunx --bun vault-go@latest setup --engine openrouter
+bunx --bun vault-go@latest setup --engine claude --model sonnet
 bunx --bun vault-go@latest login --force
 bunx --bun vault-go@latest serve
 bunx --bun vault-go@latest engine list
@@ -169,6 +170,8 @@ limitados.
 
 O seletor de motor segue o mesmo modelo do claude-mem: Claude (CLI da assinatura), OpenRouter (chave), Gemini (chave) ou o Vault AI Resume da conta. Grave chaves com `vault-go engine key openrouter|gemini` ou no painel local; as ferramentas MCP não aceitam segredos.
 
+Na instalação, o Vault Go registra hooks no Claude Code e no Codex. Eles injetam contexto no início da sessão, capturam prompts e ferramentas, e o serviço local (`http://localhost:38850`) gera memórias com o motor escolhido — o mesmo ciclo do claude-mem, persistindo no Vault.
+
 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:

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 import { type McpClient } from './installer.js';
 import { type ContextEngineId } from './context-engines.js';
-export type CliMode = 'help' | 'version' | 'setup' | 'login' | 'serve' | 'local' | 'engine' | 'invalid';
+export type CliMode = 'help' | 'version' | 'setup' | 'login' | 'serve' | 'local' | 'engine' | 'hook' | 'invalid';
 export declare function resolveCliMode(argument: string | undefined, stdinIsTTY: boolean, stderrIsTTY: boolean): CliMode;
 export declare function parseEngineChoice(value: string): ContextEngineId;
 export declare function parseNumberedClients(value: string): McpClient[];

package/dist/cli.js

@@ -2,7 +2,7 @@ import { authenticateWithApiKey, authenticateWithBrowser, validateExistingAuthen
 import { vaultHome } from './config.js';
 import { detectMcpClients, installMcpClient, MCP_CLIENTS, parseClientSelection, } from './installer.js';
 import { promptSecret, promptText } from './prompt.js';
-import { CONTEXT_ENGINE_IDS, ENGINE_NAMES, isApiEngine, listContextEngines, loadEngineKey, saveEngineKey, selectContextEngine, } from './context-engines.js';
+import { CONTEXT_ENGINE_IDS, ENGINE_NAMES, engineModels, isApiEngine, listContextEngines, loadEngineKey, parseEngineModel, saveEngineKey, selectContextEngine, selectEngineModel, selectedContextEngine, selectedEngineModel, } from './context-engines.js';
 import { VaultCloudClient } from './cloud.js';
 import { copy, resolveLocale } from './locale.js';
 import { installLocal, localStatus, localUrl, openLocal, startLocal, stopLocal, uninstallLocal } from './local-install.js';
@@ -21,6 +21,8 @@ export function resolveCliMode(argument, stdinIsTTY, stderrIsTTY) {
         return 'local';
     if (argument === 'engine')
         return 'engine';
+    if (argument === 'hook')
+        return 'hook';
     if (argument === undefined)
         return stdinIsTTY && stderrIsTTY ? 'setup' : 'serve';
     return 'invalid';
@@ -110,6 +112,7 @@ async function chooseEngine(args, locale, home) {
     const engine = configured ? parseEngineChoice(configured) : await promptEngine(home, locale);
     selectContextEngine(home, engine);
     process.stderr.write(`  ✓ ${t.engineSaved}: ${ENGINE_NAMES[engine]}\n`);
+    await chooseModel(args, locale, home, engine);
     if (isApiEngine(engine) && !loadEngineKey(home, engine)) {
         try {
             const key = await promptSecret(`  ${t.engineKey} (${ENGINE_NAMES[engine]}): `);
@@ -145,6 +148,29 @@ async function promptEngine(home, locale) {
     const answer = await promptText(`${t.choose} [1. ${ENGINE_NAMES['vault-ai-resume']}]: `);
     return answer ? parseEngineChoice(answer) : 'vault-ai-resume';
 }
+async function chooseModel(args, locale, home, engine) {
+    const catalog = engineModels(engine);
+    if (catalog.length === 0)
+        return;
+    const t = copy[locale];
+    const configured = optionValue(args, '--model');
+    const model = configured
+        ? parseEngineModel(engine, configured)
+        : await promptModel(home, engine, locale);
+    selectEngineModel(home, engine, model);
+    process.stderr.write(`  ✓ ${t.modelSaved}: ${catalog.find((item) => item.id === model)?.label ?? model}\n`);
+}
+async function promptModel(home, engine, locale) {
+    const t = copy[locale];
+    const catalog = engineModels(engine);
+    process.stderr.write(`  ${t.modelHelp}\n`);
+    for (const [index, item] of catalog.entries()) {
+        process.stderr.write(`  ${index + 1}. ${item.label}\n`);
+    }
+    const fallback = selectedEngineModel(home, engine) || catalog[0].id;
+    const answer = await promptText(`${t.choose} [${catalog[0].label}]: `);
+    return answer ? parseEngineModel(engine, answer) : fallback;
+}
 export function cliArguments(args) {
     const remaining = [...args];
     for (let i = 0; i < remaining.length; i++) {
@@ -280,9 +306,10 @@ Uso:
   bunx --bun vault-go@latest
       Abre o login Vault no navegador e instala nos clientes detectados.
 
-  bunx --bun vault-go@latest setup [--clients lista] [--engine motor] [--reauth]
+  bunx --bun vault-go@latest setup [--clients lista] [--engine motor] [--model modelo] [--reauth]
       Executa o assistente de autenticação e instalação. Pergunta o motor
-      (Vault AI, Claude, OpenRouter, Gemini ou ChatGPT/Codex).
+      (Vault AI, Claude, OpenRouter, Gemini ou ChatGPT/Codex) e o modelo
+      (Haiku, Sonnet, Opus no Claude).
 
   bunx --bun vault-go@latest login [--force] [--api-key]
       Autentica sem alterar clientes MCP.
@@ -293,9 +320,12 @@ Uso:
   vault-go local [install|start|open|status|stop|uninstall|serve]
       Painel local em http://localhost:38850; install ativa início automático no macOS.
 
-  vault-go engine list|use <motor>|key openrouter|gemini
-      Escolhe o motor de contexto: vault-ai-resume, claude-subscription,
-      openai-subscription, openrouter ou gemini. key grava a chave em prompt oculto.
+  vault-go engine list|use <motor> [--model haiku|sonnet|opus]|key openrouter|gemini
+      Escolhe o motor e o modelo de contexto. No Claude: haiku, sonnet ou opus.
+
+  vault-go hook <adaptador> <evento>
+      Usado pelos hooks do Claude/Codex: injeta contexto, captura atividade
+      e enfileira geração com o motor escolhido.
 
   --lang pt|en|es
       Idioma do assistente (padrão: idioma do sistema).
@@ -344,7 +374,21 @@ export async function runEngine(args) {
         if (!engine || !CONTEXT_ENGINE_IDS.includes(engine)) {
             throw new Error(`Motor inválido. Use: ${CONTEXT_ENGINE_IDS.join(', ')}`);
         }
-        process.stdout.write(`${selectContextEngine(home, engine)}\n`);
+        const selected = parseEngineChoice(engine);
+        selectContextEngine(home, selected);
+        const modelFlag = optionValue(args, '--model');
+        const model = modelFlag
+            ? selectEngineModel(home, selected, parseEngineModel(selected, modelFlag))
+            : selectedEngineModel(home, selected);
+        process.stdout.write(`${JSON.stringify({ selected, ...(model ? { model } : {}) })}\n`);
+        return 0;
+    }
+    if (action === 'model') {
+        const engine = selectContextEngine(home, selectedContextEngine(home));
+        const value = positional[1] ?? optionValue(args, '--model');
+        if (!value)
+            throw new Error('Use vault-go engine model haiku|sonnet|opus');
+        process.stdout.write(`${selectEngineModel(home, engine, parseEngineModel(engine, value))}\n`);
         return 0;
     }
     if (action === 'key') {
@@ -355,5 +399,5 @@ export async function runEngine(args) {
         process.stderr.write(`Chave ${engine} gravada com permissão privada.\n`);
         return 0;
     }
-    throw new Error('vault-go engine list|use <motor>|key openrouter|gemini');
+    throw new Error('vault-go engine list|use <motor> [--model haiku|sonnet|opus]|model <modelo>|key openrouter|gemini');
 }

package/dist/cloud.d.ts

@@ -1,6 +1,7 @@
 export interface VaultMemoryApi {
     observerStatus?(): Promise<unknown>;
     observerGenerate?(text: string, signal?: AbortSignal): Promise<unknown>;
+    preferences?(): Promise<unknown>;
     health(): Promise<unknown>;
     projects(): Promise<unknown>;
     createProject(input: Record<string, unknown>): Promise<unknown>;
@@ -38,6 +39,7 @@ export declare class VaultCloudClient implements VaultMemoryApi {
     constructor(home?: string, cloudFetch?: typeof fetch, journal?: boolean);
     health(): Promise<unknown>;
     observerStatus(): Promise<unknown>;
+    preferences(): Promise<unknown>;
     observerGenerate(text: string, signal?: AbortSignal): Promise<unknown>;
     registerDevice(input: Record<string, unknown>): Promise<unknown>;
     rotateDevice(id: string): Promise<unknown>;

package/dist/cloud.js

@@ -13,6 +13,20 @@ export class VaultCloudClient {
         return this.request('/health', { authenticated: false });
     }
     async observerStatus() { return this.request('/memory/observer/status'); }
+    async preferences() {
+        try {
+            return await this.request('/preferences');
+        }
+        catch {
+            return {
+                automaticCapture: true,
+                captureMode: 'balanced',
+                includeToolResults: false,
+                contextItems: 20,
+                contextMaxChars: 24_000,
+            };
+        }
+    }
     async observerGenerate(text, signal) {
         return this.request('/memory/observer/generate', { method: 'POST', body: { text }, timeoutMs: 60_000, ...(signal ? { signal } : {}) });
     }

package/dist/context-engines.d.ts

@@ -3,6 +3,12 @@ export declare const API_ENGINE_IDS: readonly ["openrouter", "gemini"];
 export type ContextEngineId = (typeof CONTEXT_ENGINE_IDS)[number];
 export type ApiEngineId = (typeof API_ENGINE_IDS)[number];
 export declare const ENGINE_NAMES: Record<ContextEngineId, string>;
+export interface EngineModelOption {
+    id: string;
+    label: string;
+    aliases?: readonly string[];
+}
+export declare const ENGINE_MODELS: Record<ContextEngineId, readonly EngineModelOption[]>;
 export interface ContextResult {
     title: string;
     content: string;
@@ -18,6 +24,8 @@ export interface EngineAvailability {
 export interface ContextEngine extends EngineAvailability {
     id: ContextEngineId;
     name: string;
+    models: EngineModelOption[];
+    model?: string;
 }
 export interface CommandRequest {
     command: "claude" | "codex";
@@ -38,6 +46,10 @@ export declare function selectedContextEngine(home: string): ContextEngineId;
 export declare function selectContextEngine(home: string, engine: unknown): ContextEngineId;
 export declare function saveEngineKey(home: string, engine: unknown, key: unknown): ApiEngineId;
 export declare function loadEngineKey(home: string, engine: ApiEngineId, environment?: NodeJS.ProcessEnv): string | undefined;
+export declare function engineModels(engine: ContextEngineId): EngineModelOption[];
+export declare function parseEngineModel(engine: unknown, value: unknown): string;
+export declare function selectedEngineModel(home: string, engine: ContextEngineId): string;
+export declare function selectEngineModel(home: string, engine: unknown, model: unknown): string;
 export declare function contextEnvironment(source?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
 /** Never includes process stderr or model input in an error message. */
 export declare const runContextCommand: CommandRunner;
@@ -46,6 +58,7 @@ export declare function listContextEngines(home: string, managedStatus?: EngineA
     env?: NodeJS.ProcessEnv;
 }): Promise<{
     selected: ContextEngineId;
+    model?: string;
     engines: ContextEngine[];
 }>;
 export declare function validateContextResult(value: unknown, engine: ContextEngineId): ContextResult;

package/dist/context-engines.js

@@ -17,10 +17,37 @@ export const ENGINE_NAMES = {
     openrouter: "OpenRouter",
     gemini: "Gemini",
 };
+export const ENGINE_MODELS = {
+    "vault-ai-resume": [],
+    "claude-subscription": [
+        { id: "haiku", label: "Haiku" },
+        { id: "sonnet", label: "Sonnet" },
+        { id: "opus", label: "Opus" },
+    ],
+    "openai-subscription": [
+        { id: "gpt-5-mini", label: "GPT-5 mini" },
+        { id: "gpt-5", label: "GPT-5" },
+        { id: "o3", label: "o3" },
+    ],
+    openrouter: [
+        { id: "xiaomi/mimo-v2-flash:free", label: "Free", aliases: ["free"] },
+        { id: "anthropic/claude-haiku-4.5", label: "Haiku", aliases: ["haiku"] },
+        { id: "anthropic/claude-sonnet-4.5", label: "Sonnet", aliases: ["sonnet"] },
+        { id: "anthropic/claude-opus-4.1", label: "Opus", aliases: ["opus"] },
+    ],
+    gemini: [
+        { id: "gemini-flash-latest", label: "Flash", aliases: ["flash"] },
+        { id: "gemini-2.5-pro", label: "Pro", aliases: ["pro"] },
+    ],
+};
 const DEFAULT_MODELS = {
+    "vault-ai-resume": "",
+    "claude-subscription": "haiku",
+    "openai-subscription": "gpt-5-mini",
     openrouter: "xiaomi/mimo-v2-flash:free",
     gemini: "gemini-flash-latest",
 };
+const CUSTOM_MODEL = /^[a-zA-Z0-9][a-zA-Z0-9_.:/-]{0,199}$/;
 const KEY_ENV = {
     openrouter: ["VAULT_GO_OPENROUTER_API_KEY", "OPENROUTER_API_KEY"],
     gemini: ["VAULT_GO_GEMINI_API_KEY", "GEMINI_API_KEY", "GOOGLE_API_KEY"],
@@ -87,14 +114,61 @@ export function loadEngineKey(home, engine, environment = process.env) {
     const stored = readJson(secretsPath(home))[engine];
     return typeof stored === "string" && stored.trim() ? stored.trim() : undefined;
 }
-function engineModel(home, engine) {
+export function engineModels(engine) {
+    return ENGINE_MODELS[engine].map(({ id, label }) => ({ id, label }));
+}
+export function parseEngineModel(engine, value) {
+    if (!isContextEngine(engine))
+        throw new Error("Unknown context engine.");
+    const catalog = ENGINE_MODELS[engine];
+    if (catalog.length === 0)
+        throw new Error("This engine does not select a model.");
+    if (typeof value !== "string" || !value.trim())
+        throw new Error("Unknown model.");
+    const input = value.trim();
+    const index = /^\d+$/.test(input) ? Number(input) - 1 : -1;
+    const numbered = catalog[index];
+    if (numbered)
+        return numbered.id;
+    const lower = input.toLowerCase();
+    const match = catalog.find((item) => item.id.toLowerCase() === lower ||
+        item.label.toLowerCase() === lower ||
+        item.aliases?.some((alias) => alias.toLowerCase() === lower));
+    if (match)
+        return match.id;
+    if ((engine === "openrouter" || engine === "gemini") && CUSTOM_MODEL.test(input))
+        return input;
+    throw new Error("Unknown model.");
+}
+export function selectedEngineModel(home, engine) {
     const models = readJson(settingsPath(home)).models;
     const configured = models && typeof models === "object" && !Array.isArray(models)
         ? models[engine]
         : undefined;
-    return typeof configured === "string" && configured.trim()
-        ? configured.trim().slice(0, 200)
-        : DEFAULT_MODELS[engine];
+    if (typeof configured === "string" && configured.trim()) {
+        try {
+            return parseEngineModel(engine, configured);
+        }
+        catch {
+            return DEFAULT_MODELS[engine];
+        }
+    }
+    return DEFAULT_MODELS[engine];
+}
+export function selectEngineModel(home, engine, model) {
+    if (!isContextEngine(engine))
+        throw new Error("Unknown context engine.");
+    const resolved = parseEngineModel(engine, model);
+    const current = readJson(settingsPath(home));
+    const models = current.models && typeof current.models === "object" && !Array.isArray(current.models)
+        ? { ...current.models }
+        : {};
+    models[engine] = resolved;
+    writePrivateJson(settingsPath(home), { ...current, engine, models });
+    return resolved;
+}
+function engineModel(home, engine) {
+    return selectedEngineModel(home, engine);
 }
 export function contextEnvironment(source = process.env) {
     const env = {};
@@ -252,22 +326,24 @@ export async function listContextEngines(home, managedStatus = {
             checkSubscription("claude-subscription", cwd, runner, env),
             checkSubscription("openai-subscription", cwd, runner, env),
         ]);
+        const selected = selectedContextEngine(home);
+        const withModels = (id, availability) => ({
+            id,
+            name: ENGINE_NAMES[id],
+            ...availability,
+            models: engineModels(id),
+            ...(engineModels(id).length > 0 ? { model: selectedEngineModel(home, id) } : {}),
+        });
+        const selectedModel = selectedEngineModel(home, selected);
         return {
-            selected: selectedContextEngine(home),
+            selected,
+            ...(selectedModel ? { model: selectedModel } : {}),
             engines: [
-                { id: "vault-ai-resume", name: ENGINE_NAMES["vault-ai-resume"], ...managedStatus },
-                { id: "claude-subscription", name: ENGINE_NAMES["claude-subscription"], ...claude },
-                { id: "openai-subscription", name: ENGINE_NAMES["openai-subscription"], ...codex },
-                {
-                    id: "openrouter",
-                    name: ENGINE_NAMES.openrouter,
-                    ...apiAvailability(home, "openrouter", options.env),
-                },
-                {
-                    id: "gemini",
-                    name: ENGINE_NAMES.gemini,
-                    ...apiAvailability(home, "gemini", options.env),
-                },
+                withModels("vault-ai-resume", managedStatus),
+                withModels("claude-subscription", claude),
+                withModels("openai-subscription", codex),
+                withModels("openrouter", apiAvailability(home, "openrouter", options.env)),
+                withModels("gemini", apiAvailability(home, "gemini", options.env)),
             ],
         };
     }
@@ -469,6 +545,8 @@ export async function generateContext(home, engine, text, options = {}) {
             args = [
                 "--safe-mode",
                 "-p",
+                "--model",
+                engineModel(home, engine),
                 "--tools",
                 "",
                 "--strict-mcp-config",
@@ -498,6 +576,8 @@ export async function generateContext(home, engine, text, options = {}) {
                 "-c",
                 'forced_login_method="chatgpt"',
                 "-c",
+                `model=${JSON.stringify(engineModel(home, engine))}`,
+                "-c",
                 'approval_policy="never"',
                 "-c",
                 'web_search="disabled"',

package/dist/hook-queue.d.ts

@@ -0,0 +1,13 @@
+import { VaultCloudClient } from "./cloud.js";
+import { generateContext } from "./context-engines.js";
+export interface GenerationJob {
+    id: string;
+    projectId: string;
+    sessionId?: string;
+    text: string;
+    title?: string;
+    kind: "observation" | "summary" | "prompt";
+}
+export declare function enqueueGeneration(home: string, job: GenerationJob): void;
+export declare function takeGeneration(home: string): GenerationJob | undefined;
+export declare function processGenerationQueue(home?: string, cloud?: VaultCloudClient, generate?: typeof generateContext): Promise<boolean>;

package/dist/hook-queue.js

@@ -0,0 +1,72 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync } from "node:fs";
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { VaultCloudClient } from "./cloud.js";
+import { vaultHome } from "./config.js";
+import { generateContext, selectedContextEngine, } from "./context-engines.js";
+function queuePath(home) {
+    return join(home, "generation-queue.json");
+}
+function readQueue(home) {
+    try {
+        const value = JSON.parse(readFileSync(queuePath(home), "utf8"));
+        return Array.isArray(value) ? value : [];
+    }
+    catch {
+        return [];
+    }
+}
+function writeQueue(home, jobs) {
+    mkdirSync(home, { recursive: true, mode: 0o700 });
+    const destination = queuePath(home);
+    const temporary = destination + "." + process.pid + ".tmp";
+    writeFileSync(temporary, JSON.stringify(jobs.slice(0, 50)) + "\n", { mode: 0o600 });
+    chmodSync(temporary, 0o600);
+    renameSync(temporary, destination);
+    chmodSync(destination, 0o600);
+}
+export function enqueueGeneration(home, job) {
+    if (!job.text.trim() || job.text.length > 16_000)
+        return;
+    const jobs = readQueue(home);
+    if (jobs.some((item) => item.id === job.id))
+        return;
+    writeQueue(home, [...jobs, job]);
+}
+export function takeGeneration(home) {
+    const jobs = readQueue(home);
+    const next = jobs[0];
+    if (!next)
+        return;
+    writeQueue(home, jobs.slice(1));
+    return next;
+}
+export async function processGenerationQueue(home = vaultHome(), cloud = new VaultCloudClient(home), generate = generateContext) {
+    const job = takeGeneration(home);
+    if (!job)
+        return false;
+    const engine = selectedContextEngine(home);
+    try {
+        const result = await generate(home, engine, job.text.slice(0, 16_000), {
+            ...(cloud.observerGenerate
+                ? {
+                    managedGenerate: (text, options) => cloud.observerGenerate(text, options.signal),
+                }
+                : {}),
+        });
+        await cloud.remember({
+            projectId: job.projectId,
+            ...(job.sessionId ? { sessionId: job.sessionId } : {}),
+            kind: job.kind === "summary" ? "summary" : "observation",
+            memoryType: "discovery",
+            title: result.title || job.title,
+            content: result.content,
+            facts: result.facts,
+            concepts: result.concepts,
+        });
+    }
+    catch {
+        // Drop poison items so the watcher keeps draining.
+    }
+    return existsSync(queuePath(home)) && readQueue(home).length > 0;
+}

package/dist/hooks.d.ts

@@ -0,0 +1,9 @@
+import { type VaultMemoryApi } from "./cloud.js";
+export declare const HOOK_EVENTS: readonly ["context", "session-init", "observation", "file-context", "summarize"];
+export type HookEvent = (typeof HOOK_EVENTS)[number];
+type RecordValue = Record<string, unknown>;
+export declare function hookOutput(event: HookEvent, context?: string): RecordValue;
+export declare function executeHook(adapter: string, event: HookEvent, value: unknown, cloud?: VaultMemoryApi, home?: string): Promise<RecordValue>;
+export declare function readHookInput(stream?: NodeJS.ReadableStream): Promise<unknown>;
+export declare function runHook(adapter: string, event: string): Promise<void>;
+export {};

package/dist/hooks.js

@@ -0,0 +1,227 @@
+import { createHash } from "node:crypto";
+import { basename, dirname, resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { VaultCloudClient } from "./cloud.js";
+import { vaultHome } from "./config.js";
+import { enqueueGeneration } from "./hook-queue.js";
+export const HOOK_EVENTS = [
+    "context",
+    "session-init",
+    "observation",
+    "file-context",
+    "summarize",
+];
+const record = (value) => value && typeof value === "object" && !Array.isArray(value)
+    ? value
+    : {};
+const string = (...values) => values.find((value) => typeof value === "string" && value.trim()) ||
+    "";
+function root(cwd) {
+    const initial = resolve(cwd);
+    let dir = initial;
+    while (dirname(dir) !== dir) {
+        if (existsSync(resolve(dir, ".git")))
+            return dir;
+        dir = dirname(dir);
+    }
+    return initial;
+}
+function redact(value) {
+    if (typeof value === "string") {
+        return value
+            .replace(/<private>[\s\S]*?<\/private>/gi, "[redacted]")
+            .replace(/(api[_-]?key|secret|token|password)\s*[:=]\s*['"]?[^\s'"]+/gi, "$1=[redacted]");
+    }
+    if (Array.isArray(value))
+        return value.map(redact);
+    if (value && typeof value === "object") {
+        const output = {};
+        for (const [key, nested] of Object.entries(value)) {
+            output[key] = /api[_-]?key|secret|token|password|authorization/i.test(key)
+                ? "[redacted]"
+                : redact(nested);
+        }
+        return output;
+    }
+    return value;
+}
+export function hookOutput(event, context = "") {
+    const result = { continue: true, suppressOutput: true };
+    const name = event === "context"
+        ? "SessionStart"
+        : event === "file-context"
+            ? "PreToolUse"
+            : event === "session-init"
+                ? "UserPromptSubmit"
+                : "";
+    if (name && context) {
+        result.hookSpecificOutput = {
+            hookEventName: name,
+            additionalContext: context,
+        };
+    }
+    return result;
+}
+async function preferences(cloud) {
+    try {
+        if (cloud.preferences)
+            return record(await cloud.preferences());
+    }
+    catch {
+        /* use defaults */
+    }
+    return {
+        automaticCapture: true,
+        captureMode: "balanced",
+        includeToolResults: false,
+        contextItems: 20,
+        contextMaxChars: 24_000,
+    };
+}
+export async function executeHook(adapter, event, value, cloud = new VaultCloudClient(), home = vaultHome()) {
+    const input = record(value);
+    const toolName = string(input.tool_name, input.toolName);
+    if (input.private === true ||
+        input.is_private === true ||
+        /vault[_-]go|vault[_-]mem/.test(toolName)) {
+        return hookOutput(event);
+    }
+    const prefs = await preferences(cloud);
+    const reading = event === "context" || event === "file-context";
+    if (!reading && prefs.automaticCapture !== true)
+        return hookOutput(event);
+    const tool = record(input.tool_input ?? input.toolInput);
+    const file = string(tool.file_path, tool.path, tool.notebook_path);
+    const modifies = /write|edit|patch|create|delete|move|rename/i.test(toolName);
+    if (!reading && prefs.captureMode === "focused" && event !== "summarize")
+        return hookOutput(event);
+    if (event === "observation" && prefs.captureMode === "balanced" && !modifies)
+        return hookOutput(event);
+    if (event === "file-context" && !file)
+        return hookOutput(event);
+    const sessionId = string(input.session_id, input.sessionId, input.thread_id, input.conversation_id);
+    if (!reading && !sessionId)
+        return hookOutput(event);
+    const cwd = root(string(input.cwd, input.workspace) || process.cwd());
+    const projects = await cloud.projects();
+    if (!Array.isArray(projects))
+        throw new Error("Resposta de projetos inválida");
+    let project = projects.find((item) => item &&
+        typeof item === "object" &&
+        resolve(String(item.rootPath || "")) === cwd);
+    if (!project && reading)
+        return hookOutput(event);
+    if (!project) {
+        project = record(await cloud.createProject({
+            name: (basename(cwd) || "workspace").padEnd(3, "_").slice(0, 80),
+            rootPath: cwd,
+        }));
+    }
+    if (typeof project.id !== "string")
+        throw new Error("Projeto inválido");
+    const limits = {
+        projectId: project.id,
+        limit: 20,
+        maxChars: 24_000,
+    };
+    if (reading) {
+        const result = record(event === "file-context"
+            ? await cloud.fileContext({
+                ...limits,
+                paths: [...new Set([file, resolve(cwd, file)])],
+            })
+            : await cloud.context(limits));
+        return hookOutput(event, string(result.context).slice(0, 24_000));
+    }
+    const session = record(await cloud.startSession({
+        projectId: project.id,
+        externalSessionId: sessionId,
+        platformSource: adapter,
+    }));
+    if (typeof session.id !== "string")
+        throw new Error("Sessão inválida");
+    const prompt = string(input.prompt, input.user_prompt);
+    const response = string(input.last_assistant_message, input.response, input.summary);
+    const rawContent = event === "session-init"
+        ? prompt
+        : event === "summarize"
+            ? response
+            : JSON.stringify(redact({
+                toolName,
+                toolInput: tool,
+            }));
+    const content = String(redact(rawContent));
+    if (content.trim()) {
+        const eventType = event === "session-init"
+            ? "user_prompt"
+            : event === "summarize"
+                ? "session_summary"
+                : "tool_use";
+        const sourceEventId = createHash("sha256")
+            .update(JSON.stringify([
+            adapter,
+            event,
+            cwd,
+            sessionId,
+            input.tool_use_id,
+            input.turn_id,
+            input.timestamp,
+        ]))
+            .digest("hex");
+        await cloud.event({
+            projectId: project.id,
+            sessionId: session.id,
+            sourceAdapter: adapter,
+            sourceEventId,
+            eventType,
+            payload: {
+                title: toolName ||
+                    (event === "summarize" ? "Resumo da sessão" : "Solicitação do usuário"),
+                content,
+                filesRead: !modifies && file ? [file] : [],
+                filesModified: modifies && file ? [file] : [],
+            },
+            occurredAtEpoch: Date.now(),
+        });
+        enqueueGeneration(home, {
+            id: sourceEventId,
+            projectId: project.id,
+            sessionId: session.id,
+            text: content.slice(0, 16_000),
+            title: toolName ||
+                (event === "summarize" ? "Resumo da sessão" : "Solicitação do usuário"),
+            kind: event === "summarize" ? "summary" : event === "session-init" ? "prompt" : "observation",
+        });
+    }
+    if (event === "summarize")
+        await cloud.endSession(session.id);
+    return hookOutput(event);
+}
+export async function readHookInput(stream = process.stdin) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of stream) {
+        const buffer = Buffer.from(chunk);
+        size += buffer.length;
+        if (size > 1_000_000)
+            throw new Error("Hook excede o limite de entrada");
+        chunks.push(buffer);
+    }
+    return JSON.parse(Buffer.concat(chunks).toString("utf8") || "{}");
+}
+export async function runHook(adapter, event) {
+    if (!HOOK_EVENTS.includes(event)) {
+        throw new Error("Evento de hook desconhecido.");
+    }
+    if (event === "context") {
+        try {
+            const { startLocal } = await import("./local-install.js");
+            await startLocal();
+        }
+        catch {
+            /* dashboard already running or unavailable */
+        }
+    }
+    const result = await executeHook(adapter === "auto" ? "claude" : adapter, event, await readHookInput());
+    process.stdout.write(JSON.stringify(result) + "\n");
+}

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { cliArguments, helpText, resolveCliMode, runEngine, runLocal, runLogin, runSetup } from './cli.js';
+import { HOOK_EVENTS, runHook } from './hooks.js';
 import { createVaultGoServer, VERSION } from './server.js';
 const { argument, options } = cliArguments(process.argv.slice(2));
 const mode = resolveCliMode(argument, process.stdin.isTTY === true, process.stderr.isTTY === true);
@@ -32,6 +33,15 @@ async function main() {
         process.exitCode = await runEngine(options);
         return;
     }
+    if (mode === 'hook') {
+        const adapter = options.find((item) => !item.startsWith('--')) ?? 'auto';
+        const event = options.filter((item) => !item.startsWith('--'))[1];
+        if (!event || !HOOK_EVENTS.includes(event)) {
+            throw new Error('Uso: vault-go hook <adaptador> context|session-init|observation|file-context|summarize');
+        }
+        await runHook(adapter, event);
+        return;
+    }
     const server = createVaultGoServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/installer.d.ts

@@ -2,6 +2,9 @@ export declare const MCP_SERVER_NAME = "vault-go";
 export declare const MCP_SERVER_COMMAND: readonly ["bunx", "--bun", "vault-go@latest", "serve"];
 export declare const MCP_CLIENTS: readonly ["codex", "claude", "claude-desktop", "cursor", "vscode", "copilot", "windsurf", "roo", "opencode"];
 export type McpClient = (typeof MCP_CLIENTS)[number];
+export declare function quoteShell(value: string): string;
+export declare function hookEntryPath(configHome?: string): string;
+export declare function hookCommand(adapter: string, event: string, configHome?: string): string;
 export interface DetectedClient {
     client: McpClient;
     detected: boolean;

package/dist/installer.js

@@ -1,7 +1,10 @@
 import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync, } from 'node:fs';
 import { homedir, platform } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { spawnSync } from 'node:child_process';
+import { vaultHome } from './config.js';
+import { stageLocalRuntime } from './local-install.js';
 export const MCP_SERVER_NAME = 'vault-go';
 export const MCP_SERVER_COMMAND = ['bunx', '--bun', 'vault-go@latest', 'serve'];
 export const MCP_CLIENTS = [
@@ -15,6 +18,75 @@ export const MCP_CLIENTS = [
     'roo',
     'opencode',
 ];
+const HOOK_OWNER = 'Vault Go: captura e contexto';
+const HOOK_EVENTS = {
+    SessionStart: 'context',
+    UserPromptSubmit: 'session-init',
+    PreToolUse: 'file-context',
+    PostToolUse: 'observation',
+    Stop: 'summarize',
+};
+export function quoteShell(value) {
+    return "'" + value.replaceAll("'", "'\\''") + "'";
+}
+export function hookEntryPath(configHome = vaultHome()) {
+    const staged = join(configHome, 'local-runtime', 'dist', 'index.js');
+    if (existsSync(staged))
+        return staged;
+    return join(dirname(fileURLToPath(import.meta.url)), 'index.js');
+}
+export function hookCommand(adapter, event, configHome = vaultHome()) {
+    return `${quoteShell(process.execPath)} ${quoteShell(hookEntryPath(configHome))} hook ${adapter} ${event}`;
+}
+function hookManifest(adapter, configHome = vaultHome()) {
+    return {
+        hooks: Object.fromEntries(Object.entries(HOOK_EVENTS).map(([name, event]) => [
+            name,
+            [
+                {
+                    hooks: [
+                        {
+                            type: 'command',
+                            command: hookCommand(adapter, event, configHome),
+                            timeout: event === 'context' ? 60 : 20,
+                            statusMessage: HOOK_OWNER,
+                            ...(event === 'observation' || event === 'summarize' || event === 'file-context'
+                                ? { async: true }
+                                : {}),
+                        },
+                    ],
+                },
+            ],
+        ])),
+    };
+}
+function installClientHooks(client, userHome, configHome = vaultHome()) {
+    try {
+        stageLocalRuntime(configHome);
+    }
+    catch {
+        /* tests and incomplete installs still write the hook command */
+    }
+    const path = join(userHome, client === 'claude' ? '.claude/settings.json' : '.codex/hooks.json');
+    const config = readJsonObject(path);
+    const hooks = { ...(config.hooks && typeof config.hooks === 'object' && !Array.isArray(config.hooks) ? config.hooks : {}) };
+    const desired = hookManifest(client, configHome).hooks;
+    for (const event of Object.keys(HOOK_EVENTS)) {
+        const current = hooks[event];
+        const retained = Array.isArray(current)
+            ? current
+                .map((group) => {
+                if (!group || typeof group !== 'object' || !Array.isArray(group.hooks))
+                    return group;
+                const filtered = group.hooks.filter((hook) => !hook || typeof hook !== 'object' || hook.statusMessage !== HOOK_OWNER);
+                return { ...group, hooks: filtered };
+            })
+                .filter((group) => !group || typeof group !== 'object' || !Array.isArray(group.hooks) || group.hooks.length > 0)
+            : [];
+        hooks[event] = [...retained, ...(desired[event] || [])];
+    }
+    atomicWriteJson(path, { ...config, hooks });
+}
 const runCommand = (command, args) => spawnSync(command, [...args], { stdio: 'ignore' });
 function readJsonObject(path) {
     if (!existsSync(path))
@@ -83,10 +155,12 @@ export function installMcpClient(client, options = {}) {
     const cwd = options.cwd ?? process.cwd();
     const runner = options.runner ?? runCommand;
     if (client === 'codex') {
-        return installViaCli(client, 'codex', ['mcp', 'get', MCP_SERVER_NAME], ['mcp', 'add', MCP_SERVER_NAME, '--', ...MCP_SERVER_COMMAND], runner);
+        const result = installViaCli(client, 'codex', ['mcp', 'get', MCP_SERVER_NAME], ['mcp', 'add', MCP_SERVER_NAME, '--', ...MCP_SERVER_COMMAND], runner);
+        installClientHooks('codex', home);
+        return result;
     }
     if (client === 'claude') {
-        return installViaCli(client, 'claude', ['mcp', 'get', MCP_SERVER_NAME], [
+        const result = installViaCli(client, 'claude', ['mcp', 'get', MCP_SERVER_NAME], [
             'mcp',
             'add',
             '--scope',
@@ -97,6 +171,8 @@ export function installMcpClient(client, options = {}) {
             '--',
             ...MCP_SERVER_COMMAND,
         ], runner);
+        installClientHooks('claude', home);
+        return result;
     }
     if (client === 'vscode') {
         const payload = JSON.stringify({

package/dist/local-dashboard.js

@@ -5,7 +5,7 @@ export function dashboardHtml() {
 
 /* Same identity tokens and glass surfaces as the Vault portal. */
 :root{--c-canvas:8 11 18;--c-surface:24 29 45;--c-surface-2:32 38 56;--c-line:53 61 81;--c-fg:241 243 252;--c-muted:172 180 203;--c-faint:148 159 187;--c-accent:185 182 255;color:rgb(var(--c-fg));background:rgb(var(--c-canvas))}body{background:radial-gradient(ellipse at 85% 8%,#534ca02e,transparent 45%),linear-gradient(145deg,#080b12,#101321 58%,#080b12)}[hidden]{display:none!important}.shell{grid-template-columns:258px 1fr;max-width:1600px}.rail{background:linear-gradient(160deg,#1c2135f5,#101522f5);border-color:#cdd8ff26}.brand{font-size:15px;letter-spacing:-.3px;gap:10px;white-space:nowrap}.brand img,.onboarding-logo{object-fit:contain;filter:drop-shadow(0 5px 12px #7775c533)}.brand-sub{display:block;font-size:9px;letter-spacing:1.7px;color:#acb4cb;margin-top:7px}.card,.panel,.onboarding,.step,.notice{background:linear-gradient(135deg,#272c3ed1,#131724e0);border-color:#cdd8ff26;box-shadow:0 24px 70px -30px #0009,inset 0 1px 0 #ffffff0c;backdrop-filter:blur(28px) saturate(135%)}.nav a.active,.nav a:hover{background:#b9b6ff20;color:#d3d1ff}.eyebrow,.step-number,.empty-symbol{color:#b9b6ff}p,.card-label{color:#acb4cb}.card-note,.row-meta,.rail-footer,.rail-label,.footer{color:#949fbb}.pulse{color:#b9b6ff;border-color:#b9b6ff30;background:#b9b6ff0d}.button{background:#202638;color:#f1f3fc;border-color:#cdd8ff26;text-decoration:none;justify-content:center}.button:hover{border-color:#b9b6ff88}.primary{background:linear-gradient(135deg,#c8c5ff,#9d9bed);color:#15152f;border-color:transparent;font-weight:650;padding:13px 20px;font-size:14px}.primary:hover{background:#d3d1ff}.onboarding{border:1px solid #cdd8ff26;border-radius:20px;overflow:hidden;margin-top:30px;animation:arrive .6s ease both}.onboarding-hero{position:relative;padding:38px;background:radial-gradient(ellipse at 100% 0%,#7370d02c,transparent 62%)}.onboarding-logo{width:86px;height:86px;margin-bottom:24px}.onboarding h1{font-size:36px;max-width:600px;line-height:1.12;margin:12px 0 18px}.onboarding-hero>p{max-width:570px;font-size:14px;line-height:1.8}.actions{display:flex;gap:12px;align-items:center;flex-wrap:wrap;margin-top:25px}.link{color:#d3d1ff;text-decoration:none;font-size:12px}.link:hover{text-decoration:underline}.onboarding-hint{font-size:11px!important;color:#949fbb;margin-top:15px!important}.steps{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));border-top:1px solid #cdd8ff26}.step{padding:25px;background:#080b122b;box-shadow:none;border-right:1px solid #cdd8ff16}.step:last-child{border:0}.step-number{font-family:monospace;font-size:11px;margin-bottom:13px}.step h2{margin-bottom:9px}.step p{font-size:12px}.terminal-fallback{padding:22px 30px;border-top:1px solid #cdd8ff26;background:#080b1233}.terminal-fallback p{font-size:12px}.terminal-fallback code{display:block;margin-top:10px;font-size:12px;color:#d3d1ff;overflow-wrap:anywhere}.connection-message{margin-top:18px;font-size:12px;color:#d3d1ff;min-height:18px}.next-step{display:flex;justify-content:space-between;align-items:center;gap:20px;margin-top:22px;padding:23px;border:1px solid #b9b6ff30;border-radius:14px;background:#b9b6ff09}.next-step h2{margin-bottom:8px}.next-step p{font-size:12px}.next-step .actions{margin:0;flex-shrink:0}button:focus-visible,a:focus-visible,input:focus-visible,select:focus-visible{outline-color:#b9b6ff}.notice code{color:#d3d1ff}.search{border-color:#cdd8ff26;background:#0307117a}.breadcrumb b{color:#f1f3fc}.rail-footer .dot{background:#b9b6ff}.footer{margin-top:28px}@media(max-width:1100px){.shell{grid-template-columns:225px 1fr}.brand{font-size:13px}.main{padding:25px}.onboarding-hero{padding:30px}.next-step{align-items:flex-start;flex-direction:column}}@media(max-width:680px){.shell{display:block}.brand{font-size:16px}.onboarding{margin-top:22px}.onboarding-hero{padding:26px}.onboarding h1{font-size:30px}.onboarding-logo{width:65px;height:65px;margin-bottom:15px}.steps{grid-template-columns:1fr}.step{padding:20px 26px;border-right:0;border-bottom:1px solid #cdd8ff16}.step-number{margin-bottom:8px}.terminal-fallback{padding:22px 26px}.main{padding:20px}.next-step .actions{flex-shrink:1}.onboarding .actions .button{width:100%}.onboarding .actions .link{padding:8px 0}.card-value{overflow-wrap:anywhere}.nav{padding-bottom:2px}}
-.danger{border-color:#ed9a9a66;color:#ffb5b5;background:#53272d55}.danger:hover{border-color:#ffb5b5}.danger-title{color:#ffb5b5}.pagination{display:flex;gap:9px;align-items:center;flex-wrap:wrap;border-top:1px solid #cdd8ff20;margin-top:15px;padding-top:15px;color:#acb4cb;font-size:11px}.pagination label{display:flex;align-items:center;gap:7px}.pagination .page-summary{flex:1;min-width:95px}.pagination select{padding:7px}.pagination .button{padding:7px 10px}.pagination button:disabled{cursor:default}.row-open{background:transparent;border:0;text-align:left;padding:0;color:#d3d1ff;cursor:pointer;font:inherit}.row-open:hover{text-decoration:underline}.row-actions{padding-top:5px}.detail-dialog{color:#f1f3fc;background:linear-gradient(135deg,#272c3e,#131724);border:1px solid #cdd8ff40;border-radius:18px;max-width:800px;width:calc(100% - 32px);max-height:85vh;padding:26px;box-shadow:0 30px 100px #0009}.detail-dialog::backdrop{background:#050710bd;backdrop-filter:blur(5px)}.detail-dialog h2{font-size:20px;overflow-wrap:anywhere}.detail-fields{margin:0}.detail-fields dt{color:#acb4cb;font-size:11px;margin:20px 0 8px}.detail-fields dd{margin:0;font-size:13px;line-height:1.7;white-space:pre-wrap;overflow-wrap:anywhere}.detail-fields pre{font:inherit;white-space:pre-wrap;margin:0}.engine-options{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:12px;margin-top:18px}.engine-keys{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:12px;margin-top:16px}.engine-keys label{display:block;font-size:12px;margin-bottom:8px}.engine-keys input{width:100%;background:#0307117a;color:#f1f3fc;border:1px solid #cdd8ff26;border-radius:9px;padding:10px 12px;font:inherit;font-size:13px;margin-bottom:8px}.engine-option{display:block;padding:17px;border:1px solid #cdd8ff26;border-radius:10px;background:#080b1233;cursor:pointer}.engine-option:has(input:checked){border-color:#b9b6ff;background:#b9b6ff12}.engine-option:has(input:disabled){opacity:.7;cursor:default}.engine-option input{accent-color:#b9b6ff;margin-right:8px}.engine-option strong{font-size:12px}.engine-option p{font-size:11px;margin-top:9px}.engine-message{margin-top:13px;font-size:12px;color:#d3d1ff}.context-editor{margin-top:20px}.context-editor label{display:block;font-size:12px;margin-bottom:8px}.context-editor textarea{width:100%;min-height:130px;resize:vertical;background:#0307117a;color:#f1f3fc;border:1px solid #cdd8ff26;border-radius:9px;padding:12px;font:inherit;font-size:13px}.context-editor textarea:focus-visible{outline:2px solid #b9b6ff;outline-offset:3px}@media(max-width:800px){.engine-options{grid-template-columns:1fr}}@media(prefers-reduced-motion:reduce){.detail-dialog::backdrop{backdrop-filter:none}}</style><script src="/app.js" defer></script></head><body><div class="shell"><aside class="rail"><div class="brand"><img src="/logo.png" alt="" width="46" height="46"><div>AI Vault Memory<span class="brand-sub">LOCAL AGENT</span></div></div><div class="rail-label" data-i18n="workspace">WORKSPACE</div><nav class="nav" aria-label="Navigation"><a class="active" href="#overview"><span class="icon">◈</span><span data-i18n="overview">Overview</span></a><a href="#activity"><span class="icon">⌁</span><span data-i18n="activity">Activity</span></a><a href="#memories"><span class="icon">▤</span><span data-i18n="memories">Memories</span></a><a href="#context"><span class="icon">✧</span><span data-i18n="contextEngine">Context engine</span></a><a href="#projects"><span class="icon">▱</span><span data-i18n="projects">Projects</span></a></nav><div class="rail-footer"><span class="dot"></span><span data-i18n="localWorkspace">Your local workspace</span><br><span data-i18n="privacy">Activity metadata stays local.</span></div></aside><main class="main" id="overview"><header class="top"><div class="breadcrumb">Vault <span aria-hidden="true"> / </span><b data-i18n="localMonitor">Local monitor</b></div><div class="controls"><select id="locale" aria-label="Language"><option value="en">English</option><option value="pt">Português</option><option value="es">Español</option></select><button class="button" id="logout" type="button" hidden data-i18n="logout">Sign out of dashboard</button><button class="button" id="reconnect" type="button" hidden data-i18n="reconnect">Reconnect account</button><button class="button" id="refresh" type="button"><span aria-hidden="true">↻</span><span data-i18n="refresh">Refresh cloud</span></button></div></header><div id="error" class="error" role="status" aria-live="polite"></div><section class="onboarding" id="onboarding"><div class="onboarding-hero"><img class="onboarding-logo" src="/logo.png" alt="" width="86" height="86"><div class="eyebrow" data-i18n="connectEyebrow">AI VAULT MEMORY · LOCAL</div><h1 data-i18n="connectTitle">Your memory. Connected to this machine.</h1><p data-i18n="connectIntro">Connect your Vault account to see your memories, projects and recent activity in one place.</p><div class="actions"><button type="button" class="button primary" id="connect" data-i18n="connect">Connect to Vault</button><a class="link" href="https://vault.resolveup.com.br/app" target="_blank" rel="noopener noreferrer" data-i18n="openPortal">Open Vault portal ↗</a></div><p class="onboarding-hint" data-i18n="connectHint">Sign in securely in a separate window. Your password stays with the Vault portal.</p><div class="connection-message" id="connection-message" role="status" aria-live="polite"></div><a id="auth-fallback" class="button" hidden target="_blank" rel="noopener noreferrer" data-i18n="continueAuth">Continue sign-in ↗</a></div><div class="steps"><article class="step"><div class="step-number">01 / VAULT</div><h2 data-i18n="stepAccount">Connect your account</h2><p data-i18n="stepAccountBody">Sign in to Vault and authorize this local agent.</p></article><article class="step"><div class="step-number">02 / MCP</div><h2 data-i18n="stepClient">Connect your AI client</h2><p data-i18n="stepClientBody">Configure Vault MCP in Codex, Cursor or another compatible client.</p></article><article class="step"><div class="step-number">03 / MEMORY</div><h2 data-i18n="stepMemory">Build your first memory</h2><p data-i18n="stepMemoryBody">Ask your connected client to save useful context, then follow its activity here.</p></article></div><div class="terminal-fallback"><button class="button" id="verify-connection" type="button" data-i18n="verifyConnection">Already signed in? Check connection</button><p style="margin-top:16px" data-i18n="terminalFallback">Already connected through the CLI? Open a secure local session:</p><code>bunx --bun vault-go@latest local open</code></div></section><div id="dashboard" hidden><div class="welcome"><div><div class="eyebrow" data-i18n="eyebrow">YOUR KNOWLEDGE, CONNECTED</div><h1 data-i18n="title">Your local workspace.</h1><p data-i18n="subtitle">Your Vault account, memories and activity on this machine.</p></div><img src="/logo.png" alt="" width="56" height="56"></div><div id="session-notice" hidden></div><section class="cards" aria-label="Status"><article class="card"><div class="card-label"><span data-i18n="localService">Local service</span><span aria-hidden="true">◈</span></div><div class="card-value" id="local-status">—</div><div class="card-note" id="local-note">localhost:38850</div></article><article class="card"><div class="card-label"><span data-i18n="cloudConnection">Cloud connection</span><span aria-hidden="true">↗</span></div><div class="card-value" id="cloud-status">—</div><div class="card-note" id="cloud-note">—</div></article><article class="card"><div class="card-label"><span data-i18n="recentOperations">Recent operations</span><span aria-hidden="true">⌁</span></div><div class="card-value" id="activity-total">—</div><div class="card-note" data-i18n="operationsNote">Recent MCP request metadata</div></article></section><section class="next-step" id="first-memory"><div><h2 data-i18n="firstTitle">Create your first memory</h2><p data-i18n="firstBody">Connect Vault MCP to your AI client, then ask it to save context. Your memories will appear here after a cloud refresh.</p><code id="mcp-command" style="display:block;margin-top:12px;font-size:12px;overflow-wrap:anywhere"></code><p data-i18n="rememberPrompt" style="margin-top:10px"></p></div><div class="actions"><a class="button" href="https://vault.resolveup.com.br/mcp" target="_blank" rel="noopener noreferrer" data-i18n="setupMcp">Set up MCP ↗</a><a class="link" href="https://vault.resolveup.com.br/app/memory" target="_blank" rel="noopener noreferrer" data-i18n="openMemories">Open memories ↗</a></div></section><div class="layout"><section class="panel wide" id="security"><div class="panel-head"><h2 data-i18n="securityTitle">Security on this machine</h2></div><div id="security-facts"></div><div class="actions"><button class="button danger" id="disconnect-device" type="button" data-i18n="disconnectDevice">Disconnect device</button></div></section><section class="panel wide" id="context"><div class="panel-head"><h2 data-i18n="contextEngine">Context engine</h2></div><p data-i18n="engineIntro">Choose how Vault prepares your context.</p><div class="engine-options" id="engine-options" role="radiogroup" aria-label="Context engine"></div><div class="engine-keys" id="engine-keys"></div><div class="engine-message" id="engine-message" role="status" aria-live="polite"></div><div class="context-editor"><label for="context-text" data-i18n="contextText">Text to prepare</label><textarea id="context-text" maxlength="16000" aria-describedby="context-note"></textarea><p id="context-note" data-i18n="contextNote"></p><div class="actions"><button class="button primary" id="context-preview" type="button" data-i18n="contextPreview"></button><button class="button" id="context-stop" type="button" data-i18n="cancel" hidden></button></div><p id="context-progress" role="status" aria-live="polite"></p></div></section><section class="panel" id="activity"><div class="panel-head"><h2 data-i18n="activity">Activity</h2><span class="count" id="activity-count">0</span></div><input class="search" id="activity-search" type="search" data-placeholder="searchActivity" aria-label="Search activity"><div id="activity-list"></div><div class="pagination" id="activity-pagination"></div></section><section class="panel" id="memories"><div class="panel-head"><h2 data-i18n="memories">Memories</h2><span class="count" id="memory-count">0</span></div><input class="search" id="memory-search" type="search" data-placeholder="searchMemories" aria-label="Search memories"><div id="memory-list"></div><div class="pagination" id="memory-pagination"></div></section><section class="panel wide" id="projects"><div class="panel-head"><h2 data-i18n="projects">Projects</h2><span class="count" id="project-count">0</span></div><input class="search" id="project-search" type="search" data-placeholder="searchProjects" aria-label="Search projects"><div id="project-list"></div><div class="pagination" id="project-pagination"></div></section></div></div><footer class="footer"><span data-i18n="footer">Vault Local · Context with a place to call home.</span><span id="updated" aria-live="off">—</span></footer></main></div><dialog class="detail-dialog" id="detail-dialog" aria-labelledby="detail-title"><div class="panel-head"><h2 id="detail-title"></h2><button class="button" type="button" id="detail-copy" hidden data-i18n="copyResult">Copy result</button><button class="button" type="button" id="detail-close" data-i18n="close">Close</button></div><dl class="detail-fields" id="detail-fields"></dl></dialog><dialog class="detail-dialog" id="logout-dialog" aria-labelledby="logout-title" aria-describedby="logout-description"><h2 id="logout-title" data-i18n="logout"></h2><p id="logout-description" data-i18n="logoutDescription" style="margin-top:16px"></p><div class="actions"><button class="button" type="button" id="logout-cancel" data-i18n="cancel"></button><button class="button primary" type="button" id="logout-confirm" data-i18n="logoutConfirm"></button></div></dialog><dialog class="detail-dialog" id="context-confirm-dialog" aria-labelledby="context-confirm-title" aria-describedby="context-confirm-note"><h2 id="context-confirm-title" data-i18n="contextPreview"></h2><p id="context-confirm-engine" style="margin-top:16px"></p><p id="context-confirm-billing"></p><p id="context-confirm-note" data-i18n="contextConsentNote" style="margin-top:16px"></p><pre id="context-confirm-text" style="white-space:pre-wrap;overflow-wrap:anywhere;max-height:32vh;overflow:auto;font-size:12px;line-height:1.7"></pre><label style="display:flex;gap:10px;align-items:flex-start;font-size:12px"><input id="context-consent" type="checkbox"><span data-i18n="contextConsent"></span></label><div class="actions"><button class="button" id="context-cancel" type="button" data-i18n="cancel"></button><button class="button primary" id="context-generate" type="button" disabled data-i18n="contextGenerate"></button></div></dialog><dialog class="detail-dialog" id="disconnect-dialog" aria-labelledby="disconnect-title" aria-describedby="disconnect-description"><h2 class="danger-title" id="disconnect-title" data-i18n="disconnectDevice"></h2><p id="disconnect-description" data-i18n="disconnectDescription" style="margin-top:16px"></p><p id="disconnect-error" class="error" role="alert"></p><div class="actions"><button class="button" type="button" id="disconnect-cancel" data-i18n="cancel"></button><button class="button danger" type="button" id="disconnect-confirm" data-i18n="disconnectConfirm"></button></div></dialog></body></html>`;
+.danger{border-color:#ed9a9a66;color:#ffb5b5;background:#53272d55}.danger:hover{border-color:#ffb5b5}.danger-title{color:#ffb5b5}.pagination{display:flex;gap:9px;align-items:center;flex-wrap:wrap;border-top:1px solid #cdd8ff20;margin-top:15px;padding-top:15px;color:#acb4cb;font-size:11px}.pagination label{display:flex;align-items:center;gap:7px}.pagination .page-summary{flex:1;min-width:95px}.pagination select{padding:7px}.pagination .button{padding:7px 10px}.pagination button:disabled{cursor:default}.row-open{background:transparent;border:0;text-align:left;padding:0;color:#d3d1ff;cursor:pointer;font:inherit}.row-open:hover{text-decoration:underline}.row-actions{padding-top:5px}.detail-dialog{color:#f1f3fc;background:linear-gradient(135deg,#272c3e,#131724);border:1px solid #cdd8ff40;border-radius:18px;max-width:800px;width:calc(100% - 32px);max-height:85vh;padding:26px;box-shadow:0 30px 100px #0009}.detail-dialog::backdrop{background:#050710bd;backdrop-filter:blur(5px)}.detail-dialog h2{font-size:20px;overflow-wrap:anywhere}.detail-fields{margin:0}.detail-fields dt{color:#acb4cb;font-size:11px;margin:20px 0 8px}.detail-fields dd{margin:0;font-size:13px;line-height:1.7;white-space:pre-wrap;overflow-wrap:anywhere}.detail-fields pre{font:inherit;white-space:pre-wrap;margin:0}.engine-options{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:12px;margin-top:18px}.engine-keys{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:12px;margin-top:16px}.engine-keys label{display:block;font-size:12px;margin-bottom:8px}.engine-keys input{width:100%;background:#0307117a;color:#f1f3fc;border:1px solid #cdd8ff26;border-radius:9px;padding:10px 12px;font:inherit;font-size:13px;margin-bottom:8px}.engine-option{display:block;padding:17px;border:1px solid #cdd8ff26;border-radius:10px;background:#080b1233;cursor:pointer}.engine-option:has(input:checked){border-color:#b9b6ff;background:#b9b6ff12}.engine-option:has(input:disabled){opacity:.7;cursor:default}.engine-option input{accent-color:#b9b6ff;margin-right:8px}.engine-option strong{font-size:12px}.engine-option p{font-size:11px;margin-top:9px}.engine-message{margin-top:13px;font-size:12px;color:#d3d1ff}.context-editor{margin-top:20px}.context-editor label{display:block;font-size:12px;margin-bottom:8px}.context-editor textarea{width:100%;min-height:130px;resize:vertical;background:#0307117a;color:#f1f3fc;border:1px solid #cdd8ff26;border-radius:9px;padding:12px;font:inherit;font-size:13px}.context-editor textarea:focus-visible{outline:2px solid #b9b6ff;outline-offset:3px}@media(max-width:800px){.engine-options{grid-template-columns:1fr}}@media(prefers-reduced-motion:reduce){.detail-dialog::backdrop{backdrop-filter:none}}</style><script src="/app.js" defer></script></head><body><div class="shell"><aside class="rail"><div class="brand"><img src="/logo.png" alt="" width="46" height="46"><div>AI Vault Memory<span class="brand-sub">LOCAL AGENT</span></div></div><div class="rail-label" data-i18n="workspace">WORKSPACE</div><nav class="nav" aria-label="Navigation"><a class="active" href="#overview"><span class="icon">◈</span><span data-i18n="overview">Overview</span></a><a href="#activity"><span class="icon">⌁</span><span data-i18n="activity">Activity</span></a><a href="#memories"><span class="icon">▤</span><span data-i18n="memories">Memories</span></a><a href="#context"><span class="icon">✧</span><span data-i18n="contextEngine">Context engine</span></a><a href="#projects"><span class="icon">▱</span><span data-i18n="projects">Projects</span></a></nav><div class="rail-footer"><span class="dot"></span><span data-i18n="localWorkspace">Your local workspace</span><br><span data-i18n="privacy">Activity metadata stays local.</span></div></aside><main class="main" id="overview"><header class="top"><div class="breadcrumb">Vault <span aria-hidden="true"> / </span><b data-i18n="localMonitor">Local monitor</b></div><div class="controls"><select id="locale" aria-label="Language"><option value="en">English</option><option value="pt">Português</option><option value="es">Español</option></select><button class="button" id="logout" type="button" hidden data-i18n="logout">Sign out of dashboard</button><button class="button" id="reconnect" type="button" hidden data-i18n="reconnect">Reconnect account</button><button class="button" id="refresh" type="button"><span aria-hidden="true">↻</span><span data-i18n="refresh">Refresh cloud</span></button></div></header><div id="error" class="error" role="status" aria-live="polite"></div><section class="onboarding" id="onboarding"><div class="onboarding-hero"><img class="onboarding-logo" src="/logo.png" alt="" width="86" height="86"><div class="eyebrow" data-i18n="connectEyebrow">AI VAULT MEMORY · LOCAL</div><h1 data-i18n="connectTitle">Your memory. Connected to this machine.</h1><p data-i18n="connectIntro">Connect your Vault account to see your memories, projects and recent activity in one place.</p><div class="actions"><button type="button" class="button primary" id="connect" data-i18n="connect">Connect to Vault</button><a class="link" href="https://vault.resolveup.com.br/app" target="_blank" rel="noopener noreferrer" data-i18n="openPortal">Open Vault portal ↗</a></div><p class="onboarding-hint" data-i18n="connectHint">Sign in securely in a separate window. Your password stays with the Vault portal.</p><div class="connection-message" id="connection-message" role="status" aria-live="polite"></div><a id="auth-fallback" class="button" hidden target="_blank" rel="noopener noreferrer" data-i18n="continueAuth">Continue sign-in ↗</a></div><div class="steps"><article class="step"><div class="step-number">01 / VAULT</div><h2 data-i18n="stepAccount">Connect your account</h2><p data-i18n="stepAccountBody">Sign in to Vault and authorize this local agent.</p></article><article class="step"><div class="step-number">02 / MCP</div><h2 data-i18n="stepClient">Connect your AI client</h2><p data-i18n="stepClientBody">Configure Vault MCP in Codex, Cursor or another compatible client.</p></article><article class="step"><div class="step-number">03 / MEMORY</div><h2 data-i18n="stepMemory">Build your first memory</h2><p data-i18n="stepMemoryBody">Ask your connected client to save useful context, then follow its activity here.</p></article></div><div class="terminal-fallback"><button class="button" id="verify-connection" type="button" data-i18n="verifyConnection">Already signed in? Check connection</button><p style="margin-top:16px" data-i18n="terminalFallback">Already connected through the CLI? Open a secure local session:</p><code>bunx --bun vault-go@latest local open</code></div></section><div id="dashboard" hidden><div class="welcome"><div><div class="eyebrow" data-i18n="eyebrow">YOUR KNOWLEDGE, CONNECTED</div><h1 data-i18n="title">Your local workspace.</h1><p data-i18n="subtitle">Your Vault account, memories and activity on this machine.</p></div><img src="/logo.png" alt="" width="56" height="56"></div><div id="session-notice" hidden></div><section class="cards" aria-label="Status"><article class="card"><div class="card-label"><span data-i18n="localService">Local service</span><span aria-hidden="true">◈</span></div><div class="card-value" id="local-status">—</div><div class="card-note" id="local-note">localhost:38850</div></article><article class="card"><div class="card-label"><span data-i18n="cloudConnection">Cloud connection</span><span aria-hidden="true">↗</span></div><div class="card-value" id="cloud-status">—</div><div class="card-note" id="cloud-note">—</div></article><article class="card"><div class="card-label"><span data-i18n="recentOperations">Recent operations</span><span aria-hidden="true">⌁</span></div><div class="card-value" id="activity-total">—</div><div class="card-note" data-i18n="operationsNote">Recent MCP request metadata</div></article></section><section class="next-step" id="first-memory"><div><h2 data-i18n="firstTitle">Create your first memory</h2><p data-i18n="firstBody">Connect Vault MCP to your AI client, then ask it to save context. Your memories will appear here after a cloud refresh.</p><code id="mcp-command" style="display:block;margin-top:12px;font-size:12px;overflow-wrap:anywhere"></code><p data-i18n="rememberPrompt" style="margin-top:10px"></p></div><div class="actions"><a class="button" href="https://vault.resolveup.com.br/mcp" target="_blank" rel="noopener noreferrer" data-i18n="setupMcp">Set up MCP ↗</a><a class="link" href="https://vault.resolveup.com.br/app/memory" target="_blank" rel="noopener noreferrer" data-i18n="openMemories">Open memories ↗</a></div></section><div class="layout"><section class="panel wide" id="security"><div class="panel-head"><h2 data-i18n="securityTitle">Security on this machine</h2></div><div id="security-facts"></div><div class="actions"><button class="button danger" id="disconnect-device" type="button" data-i18n="disconnectDevice">Disconnect device</button></div></section><section class="panel wide" id="context"><div class="panel-head"><h2 data-i18n="contextEngine">Context engine</h2></div><p data-i18n="engineIntro">Choose how Vault prepares your context.</p><div class="engine-options" id="engine-options" role="radiogroup" aria-label="Context engine"></div><div class="engine-options" id="model-options" role="radiogroup" aria-label="Context model"></div><div class="engine-keys" id="engine-keys"></div><div class="engine-message" id="engine-message" role="status" aria-live="polite"></div><div class="context-editor"><label for="context-text" data-i18n="contextText">Text to prepare</label><textarea id="context-text" maxlength="16000" aria-describedby="context-note"></textarea><p id="context-note" data-i18n="contextNote"></p><div class="actions"><button class="button primary" id="context-preview" type="button" data-i18n="contextPreview"></button><button class="button" id="context-stop" type="button" data-i18n="cancel" hidden></button></div><p id="context-progress" role="status" aria-live="polite"></p></div></section><section class="panel" id="activity"><div class="panel-head"><h2 data-i18n="activity">Activity</h2><span class="count" id="activity-count">0</span></div><input class="search" id="activity-search" type="search" data-placeholder="searchActivity" aria-label="Search activity"><div id="activity-list"></div><div class="pagination" id="activity-pagination"></div></section><section class="panel" id="memories"><div class="panel-head"><h2 data-i18n="memories">Memories</h2><span class="count" id="memory-count">0</span></div><input class="search" id="memory-search" type="search" data-placeholder="searchMemories" aria-label="Search memories"><div id="memory-list"></div><div class="pagination" id="memory-pagination"></div></section><section class="panel wide" id="projects"><div class="panel-head"><h2 data-i18n="projects">Projects</h2><span class="count" id="project-count">0</span></div><input class="search" id="project-search" type="search" data-placeholder="searchProjects" aria-label="Search projects"><div id="project-list"></div><div class="pagination" id="project-pagination"></div></section></div></div><footer class="footer"><span data-i18n="footer">Vault Local · Context with a place to call home.</span><span id="updated" aria-live="off">—</span></footer></main></div><dialog class="detail-dialog" id="detail-dialog" aria-labelledby="detail-title"><div class="panel-head"><h2 id="detail-title"></h2><button class="button" type="button" id="detail-copy" hidden data-i18n="copyResult">Copy result</button><button class="button" type="button" id="detail-close" data-i18n="close">Close</button></div><dl class="detail-fields" id="detail-fields"></dl></dialog><dialog class="detail-dialog" id="logout-dialog" aria-labelledby="logout-title" aria-describedby="logout-description"><h2 id="logout-title" data-i18n="logout"></h2><p id="logout-description" data-i18n="logoutDescription" style="margin-top:16px"></p><div class="actions"><button class="button" type="button" id="logout-cancel" data-i18n="cancel"></button><button class="button primary" type="button" id="logout-confirm" data-i18n="logoutConfirm"></button></div></dialog><dialog class="detail-dialog" id="context-confirm-dialog" aria-labelledby="context-confirm-title" aria-describedby="context-confirm-note"><h2 id="context-confirm-title" data-i18n="contextPreview"></h2><p id="context-confirm-engine" style="margin-top:16px"></p><p id="context-confirm-billing"></p><p id="context-confirm-note" data-i18n="contextConsentNote" style="margin-top:16px"></p><pre id="context-confirm-text" style="white-space:pre-wrap;overflow-wrap:anywhere;max-height:32vh;overflow:auto;font-size:12px;line-height:1.7"></pre><label style="display:flex;gap:10px;align-items:flex-start;font-size:12px"><input id="context-consent" type="checkbox"><span data-i18n="contextConsent"></span></label><div class="actions"><button class="button" id="context-cancel" type="button" data-i18n="cancel"></button><button class="button primary" id="context-generate" type="button" disabled data-i18n="contextGenerate"></button></div></dialog><dialog class="detail-dialog" id="disconnect-dialog" aria-labelledby="disconnect-title" aria-describedby="disconnect-description"><h2 class="danger-title" id="disconnect-title" data-i18n="disconnectDevice"></h2><p id="disconnect-description" data-i18n="disconnectDescription" style="margin-top:16px"></p><p id="disconnect-error" class="error" role="alert"></p><div class="actions"><button class="button" type="button" id="disconnect-cancel" data-i18n="cancel"></button><button class="button danger" type="button" id="disconnect-confirm" data-i18n="disconnectConfirm"></button></div></dialog></body></html>`;
 }
 export function dashboardScript() {
     return `"use strict";
@@ -146,6 +146,19 @@ export function dashboardScript() {
       label.append(input,name,node('p','',engineReason(engine)));if(engine.billing)label.append(node('p','',engineBilling(engine)));target.append(label);
     }
     text('engine-message',engineMessage?t(engineMessage):!engines?t('engineLoading'):'');
+    const models=el('model-options');models.replaceChildren();models.setAttribute('aria-label',t('contextEngine'));
+    const current=array(engines&&engines.engines).find(engine=>engine.id===engines.selected);
+    for(const item of array(current&&current.models)) {
+      const label=node('label','engine-option'),input=node('input',''),name=node('strong','',scalar(item.label)||scalar(item.id));
+      input.type='radio';input.name='context-model';input.value=item.id;input.checked=(current.model||engines.model)===item.id;input.disabled=engineBusy||!!contextJob||contextStarting;
+      input.addEventListener('change',async()=>{
+        if(!input.checked||engineBusy)return;const epoch=sessionEpoch;engineBusy=true;engineMessage='';renderEngines();
+        try {const result=await request('/api/context/model',{method:'PUT',headers:{'Content-Type':'application/json'},body:JSON.stringify({engine:current.id,model:item.id})});if(result&&!sessionRequired&&epoch===sessionEpoch&&engines){current.model=item.id;engines.model=item.id;engineMessage='engineSaved';}}
+        catch {if(epoch===sessionEpoch)engineMessage='engineFailed';}
+        finally{engineBusy=false;render();}
+      });
+      label.append(input,name);models.append(label);
+    }
     const keys=el('engine-keys');keys.replaceChildren();
     if(engines) for(const provider of ['openrouter','gemini']) {
       const wrap=node('div',''),label=node('label','',t(provider==='openrouter'?'openrouterKey':'geminiKey')),input=node('input',''),button=node('button','button',t('saveKey'));

package/dist/local-install.js

@@ -51,7 +51,7 @@ export function stageLocalRuntime(home = vaultHome(), source = dirname(fileURLTo
     mkdirSync(target, { recursive: true, mode: 0o700 });
     chmodSync(root, 0o700);
     chmodSync(target, 0o700);
-    const excluded = new Set(["index.js", "server.js", "installer.js", "cli.js"]);
+    const excluded = new Set(["server.js", "installer.js", "cli.js"]);
     if (!existsSync(join(source, "local-worker.js")))
         throw new Error("Local worker is missing. Build or reinstall vault-go first.");
     for (const file of readdirSync(source)) {

package/dist/local-service.js

@@ -12,7 +12,8 @@ import { resolveLocale } from "./locale.js";
 import { callbackPage } from "./callback-page.js";
 import { privateStore } from "./private-store.js";
 import { localDevice } from "./local-device.js";
-import { generateContext, isApiEngine, isContextEngine, listContextEngines, saveEngineKey, selectContextEngine, selectedContextEngine, } from "./context-engines.js";
+import { processGenerationQueue } from "./hook-queue.js";
+import { generateContext, isApiEngine, isContextEngine, listContextEngines, parseEngineModel, saveEngineKey, selectContextEngine, selectEngineModel, selectedContextEngine, } from "./context-engines.js";
 export const LOCAL_PORT = 38850;
 const safeEqual = (a, b) => a.length === b.length &&
     /^[A-Za-z0-9_-]{43}$/.test(a) &&
@@ -258,6 +259,11 @@ export async function startLocalService(options = {}) {
                 connected = true;
                 cloudError = undefined;
                 storage?.write(cache, { owner, projects, memories, updatedAt });
+                if (!generating && !options.cloud) {
+                    generating = processGenerationQueue(home, accountCloud).finally(() => {
+                        generating = null;
+                    });
+                }
             }
             catch {
                 if (requestOwner === identity()) {
@@ -271,6 +277,7 @@ export async function startLocalService(options = {}) {
         })();
         return syncing;
     }
+    let generating = null;
     const server = createServer(async (req, res) => {
         res.setHeader("Cache-Control", "no-store");
         res.setHeader("Referrer-Policy", "no-referrer");
@@ -467,6 +474,21 @@ export async function startLocalService(options = {}) {
                 json(200, { selected: data.engine });
                 return;
             }
+            if (url.pathname === "/api/context/model" && req.method === "PUT") {
+                const data = (await readBody(req));
+                const engine = isContextEngine(data.engine)
+                    ? data.engine
+                    : selectedContextEngine(home);
+                try {
+                    const model = selectEngineModel(home, engine, parseEngineModel(engine, data.model));
+                    engineCache = undefined;
+                    json(200, { selected: engine, model });
+                }
+                catch {
+                    json(400, { error: "invalid_model" });
+                }
+                return;
+            }
             if (url.pathname === "/api/context/secret" && req.method === "PUT") {
                 const data = (await readBody(req));
                 if (!isApiEngine(data.provider) || typeof data.key !== "string") {

package/dist/locale.d.ts

@@ -17,6 +17,8 @@ export declare const copy: {
         engineKey: string;
         engineKeySaved: string;
         engineKeyLater: string;
+        modelHelp: string;
+        modelSaved: string;
         choose: string;
         detected: string;
         available: string;
@@ -54,6 +56,8 @@ export declare const copy: {
         engineKey: string;
         engineKeySaved: string;
         engineKeyLater: string;
+        modelHelp: string;
+        modelSaved: string;
         choose: string;
         detected: string;
         available: string;
@@ -91,6 +95,8 @@ export declare const copy: {
         engineKey: string;
         engineKeySaved: string;
         engineKeyLater: string;
+        modelHelp: string;
+        modelSaved: string;
         choose: string;
         detected: string;
         available: string;

package/dist/locale.js

@@ -26,6 +26,8 @@ export const copy = {
         engineKey: "Cole a chave (não será exibida). Enter para pular",
         engineKeySaved: "Chave gravada com permissão privada.",
         engineKeyLater: "Sem chave ainda. Depois execute:",
+        modelHelp: "Haiku é mais rápido; Sonnet é o equilíbrio; Opus é o mais capaz.",
+        modelSaved: "Modelo selecionado",
         choose: "Números ou nomes, separados por vírgula",
         detected: "detectado",
         available: "disponível",
@@ -63,6 +65,8 @@ export const copy = {
         engineKey: "Paste the API key (it will not be shown). Enter to skip",
         engineKeySaved: "Key stored with private file permissions.",
         engineKeyLater: "No key yet. Later run:",
+        modelHelp: "Haiku is faster; Sonnet is the balance; Opus is the most capable.",
+        modelSaved: "Model selected",
         choose: "Numbers or names, separated by commas",
         detected: "detected",
         available: "available",
@@ -100,6 +104,8 @@ export const copy = {
         engineKey: "Pega la clave (no se mostrará). Enter para omitir",
         engineKeySaved: "Clave guardada con permisos privados.",
         engineKeyLater: "Aún no hay clave. Después ejecuta:",
+        modelHelp: "Haiku es más rápido; Sonnet es el equilibrio; Opus es el más capaz.",
+        modelSaved: "Modelo seleccionado",
         choose: "Números o nombres, separados por comas",
         detected: "detectado",
         available: "disponible",

package/dist/server.js

@@ -2,7 +2,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { VaultCloudClient } from './cloud.js';
 import { getStatus, vaultHome } from './config.js';
-import { CONTEXT_ENGINE_IDS, generateContext, listContextEngines, selectContextEngine, selectedContextEngine, } from './context-engines.js';
+import { CONTEXT_ENGINE_IDS, generateContext, listContextEngines, parseEngineModel, selectContextEngine, selectEngineModel, selectedContextEngine, selectedEngineModel, } from './context-engines.js';
 import packageJson from '../package.json' with { type: 'json' };
 export const VERSION = packageJson.version;
 function jsonResult(value) {
@@ -70,10 +70,19 @@ export function createVaultGoServer(home = vaultHome(), cloud = new VaultCloudCl
     }, async () => run(async () => listContextEngines(home, await managedEngineStatus(cloud))));
     server.registerTool('vault_go_engine_select', {
         title: 'Escolher motor de contexto',
-        description: 'Define o motor local: vault-ai-resume, claude-subscription, openai-subscription, openrouter ou gemini. Chaves de API não são aceitas por esta ferramenta.',
-        inputSchema: { engine: z.enum(CONTEXT_ENGINE_IDS) },
+        description: 'Define o motor local e, opcionalmente, o modelo (no Claude: haiku, sonnet ou opus). Chaves de API não são aceitas por esta ferramenta.',
+        inputSchema: {
+            engine: z.enum(CONTEXT_ENGINE_IDS),
+            model: z.string().trim().min(1).max(200).optional(),
+        },
         annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: false },
-    }, async ({ engine }) => jsonResult({ selected: selectContextEngine(home, engine) }));
+    }, async ({ engine, model }) => {
+        selectContextEngine(home, engine);
+        const selectedModel = model
+            ? selectEngineModel(home, engine, parseEngineModel(engine, model))
+            : selectedEngineModel(home, engine);
+        return jsonResult({ selected: engine, ...(selectedModel ? { model: selectedModel } : {}) });
+    });
     server.registerTool('vault_go_generate_context', {
         title: 'Gerar contexto',
         description: 'Gera título, conteúdo, fatos e conceitos com o motor selecionado (Claude, OpenRouter, Gemini ou Vault AI). Não persiste memória automaticamente.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vault-go",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Servidor MCP universal com autenticação e instalação multi-cliente para a plataforma Vault.",
   "type": "module",
   "bin": {
@@ -34,6 +34,10 @@
     "dist/config.d.ts",
     "dist/context-engines.js",
     "dist/context-engines.d.ts",
+    "dist/hook-queue.js",
+    "dist/hook-queue.d.ts",
+    "dist/hooks.js",
+    "dist/hooks.d.ts",
     "dist/index.js",
     "dist/index.d.ts",
     "dist/installer.js",