@andespindola/brainlink 0.1.0-beta.165 → 0.1.0-beta.166

package/dist/application/analyze-vault.js

@@ -50,7 +50,7 @@ export const getExtendedStats = async (vaultPath, agentId) => {
     await searchKnowledge(absoluteVaultPath, probeQuery, Math.min(defaults.defaultSearchLimit, 8), agentId, 'hybrid');
     const searchLatency = performance.now() - searchStart;
     const contextStart = performance.now();
-    await buildContextPackage(absoluteVaultPath, probeQuery, Math.min(defaults.defaultSearchLimit, 8), defaults.defaultContextTokens, agentId, 'hybrid');
+    await buildContextPackage(absoluteVaultPath, probeQuery, Math.min(defaults.defaultSearchLimit, 8), defaults.defaultContextTokens, agentId, 'hybrid', undefined, defaults.defaultContextCacheTtlMs);
     const contextLatency = performance.now() - contextStart;
     return {
         stats,

package/dist/application/build-context.js

@@ -5,7 +5,6 @@ import { readContextPack, writeContextPack } from '../infrastructure/context-pac
 import { indexStoragePath } from '../infrastructure/file-index.js';
 import { searchVolatileMemory, volatileMemoryStoragePath } from '../infrastructure/volatile-memory.js';
 import { searchKnowledge } from './search-knowledge.js';
-const contextCacheTtlMs = 45_000;
 const contextCacheMaxEntries = 200;
 const contextCache = new Map();
 const readFileSignature = async (path) => {
@@ -31,7 +30,7 @@ const withCacheMetadata = (context, cache) => ({
     ...context,
     cache
 });
-const contextCacheGet = (key, dataSignature) => {
+const contextCacheGet = (key, dataSignature, contextCacheTtlMs) => {
     const entry = contextCache.get(key);
     if (!entry) {
         return undefined;
@@ -70,11 +69,11 @@ const emptyMetrics = (context, totalMs, overrides = {}) => ({
     estimatedTokens: estimateSectionTokens(context),
     ...overrides
 });
-export const buildContextPackage = async (vaultPath, query, limit, maxTokens, agentId, mode, strategy = 'rag') => {
+export const buildContextPackage = async (vaultPath, query, limit, maxTokens, agentId, mode, strategy = 'rag', contextCacheTtlMs = 120_000) => {
     const totalStart = performance.now();
     const cacheKey = toCacheKey(vaultPath, query, limit, maxTokens, agentId, mode, strategy);
     const dataSignature = await readContextDataSignature(vaultPath);
-    const cached = contextCacheGet(cacheKey, dataSignature);
+    const cached = contextCacheGet(cacheKey, dataSignature, contextCacheTtlMs);
     if (cached) {
         return cached;
     }
@@ -164,7 +163,7 @@ export const buildContextPackage = async (vaultPath, query, limit, maxTokens, ag
     });
     return contextWithMetrics;
 };
-export const buildContext = async (vaultPath, query, limit, maxTokens, agentId, mode, strategy) => {
-    const contextPackage = await buildContextPackage(vaultPath, query, limit, maxTokens, agentId, mode, strategy);
+export const buildContext = async (vaultPath, query, limit, maxTokens, agentId, mode, strategy, contextCacheTtlMs = 120_000) => {
+    const contextPackage = await buildContextPackage(vaultPath, query, limit, maxTokens, agentId, mode, strategy, contextCacheTtlMs);
     return contextPackage.content;
 };

package/dist/application/server/routes.js

@@ -28,6 +28,11 @@ const readContextStrategy = async (url) => {
     const defaults = resolveAgentRuntimeDefaults(config, readAgentQuery(url));
     return sanitizeContextStrategy(url.searchParams.get('strategy'), defaults.defaultContextStrategy);
 };
+const readContextCacheTtlMs = async (url) => {
+    const config = await loadBrainlinkConfig();
+    const defaults = resolveAgentRuntimeDefaults(config, readAgentQuery(url));
+    return defaults.defaultContextCacheTtlMs;
+};
 const hasInvalidSearchMode = (url) => {
     const mode = url.searchParams.get('mode');
     return mode !== null && !['fts', 'semantic', 'hybrid'].includes(mode);
@@ -381,13 +386,14 @@ export const route = async (request, url, vaultPath) => {
         const tokens = parsePositiveInteger(url.searchParams.get('tokens'), 2000);
         const mode = await readSearchMode(url);
         const strategy = await readContextStrategy(url);
+        const contextCacheTtlMs = await readContextCacheTtlMs(url);
         if (hasInvalidSearchMode(url)) {
             return createResponse(createJsonResponse({ error: 'Invalid mode. Use fts, semantic or hybrid.' }), 400, contentTypes['.json']);
         }
         if (hasInvalidContextStrategy(url)) {
             return createResponse(createJsonResponse({ error: 'Invalid strategy. Use rag, cag or auto.' }), 400, contentTypes['.json']);
         }
-        return createResponse(createJsonResponse(await buildContextPackage(vaultPath, query, limit, tokens, readAgentQuery(url), mode, strategy)), 200, contentTypes['.json']);
+        return createResponse(createJsonResponse(await buildContextPackage(vaultPath, query, limit, tokens, readAgentQuery(url), mode, strategy, contextCacheTtlMs)), 200, contentTypes['.json']);
     }
     if (isReadMethod(request) && url.pathname === '/api/links') {
         return createResponse(createJsonResponse({ links: await listLinks(vaultPath, readAgentQuery(url)) }), 200, contentTypes['.json']);

package/dist/cli/commands/read-commands.js

@@ -69,7 +69,7 @@ export const registerReadCommands = (program) => {
         const resolved = await resolveOptions(options);
         const mode = sanitizeSearchMode(options.mode, resolved.defaults.defaultSearchMode);
         const strategy = sanitizeContextStrategy(options.strategy, resolved.defaults.defaultContextStrategy);
-        const contextPackage = await buildContextPackage(resolved.vault, query, parsePositiveInteger(options.limit ?? String(resolved.defaults.defaultSearchLimit), resolved.defaults.defaultSearchLimit), parsePositiveInteger(options.tokens ?? String(resolved.defaults.defaultContextTokens), resolved.defaults.defaultContextTokens), resolved.agent, mode, strategy);
+        const contextPackage = await buildContextPackage(resolved.vault, query, parsePositiveInteger(options.limit ?? String(resolved.defaults.defaultSearchLimit), resolved.defaults.defaultSearchLimit), parsePositiveInteger(options.tokens ?? String(resolved.defaults.defaultContextTokens), resolved.defaults.defaultContextTokens), resolved.agent, mode, strategy, resolved.defaults.defaultContextCacheTtlMs);
         print(options.json, contextPackage, () => contextPackage.content);
     });
     program

package/dist/cli/commands/write-commands.js

@@ -1135,7 +1135,7 @@ export const registerWriteCommands = (program) => {
         const policy = await getBootstrapPolicy();
         const bootstrapStatus = await getBootstrapSessionStatus(resolved.vault, resolved.agent);
         const context = options.query
-            ? await buildContextPackage(resolved.vault, options.query, limit, tokens, resolved.agent, mode, strategy)
+            ? await buildContextPackage(resolved.vault, options.query, limit, tokens, resolved.agent, mode, strategy, resolved.defaults.defaultContextCacheTtlMs)
             : null;
         const agentIntegration = options.installAgent === false
             ? null

package/dist/infrastructure/config.js

@@ -14,6 +14,7 @@ export const defaultBrainlinkConfig = {
     defaultSearchLimit: 10,
     defaultContextTokens: 2000,
     defaultContextStrategy: 'rag',
+    defaultContextCacheTtlMs: 120_000,
     embeddingProvider: 'local',
     defaultSearchMode: 'hybrid',
     chunkSize: 1200,
@@ -90,11 +91,17 @@ const sanitizeAgentProfile = (value) => {
     const defaultContextStrategy = typeof value.defaultContextStrategy === 'string' && contextStrategies.has(value.defaultContextStrategy)
         ? value.defaultContextStrategy
         : undefined;
+    const defaultContextCacheTtlMs = typeof value.defaultContextCacheTtlMs === 'number' &&
+        Number.isFinite(value.defaultContextCacheTtlMs) &&
+        value.defaultContextCacheTtlMs > 0
+        ? Math.floor(value.defaultContextCacheTtlMs)
+        : undefined;
     const profile = {
         ...(defaultSearchLimit ? { defaultSearchLimit } : {}),
         ...(defaultContextTokens ? { defaultContextTokens } : {}),
         ...(defaultSearchMode ? { defaultSearchMode } : {}),
-        ...(defaultContextStrategy ? { defaultContextStrategy } : {})
+        ...(defaultContextStrategy ? { defaultContextStrategy } : {}),
+        ...(defaultContextCacheTtlMs ? { defaultContextCacheTtlMs } : {})
     };
     return Object.keys(profile).length > 0 ? profile : null;
 };
@@ -177,6 +184,9 @@ const sanitizeConfig = (value) => ({
         ? value.defaultContextTokens
         : defaultBrainlinkConfig.defaultContextTokens,
     defaultContextStrategy: sanitizeContextStrategy(value.defaultContextStrategy, defaultBrainlinkConfig.defaultContextStrategy),
+    defaultContextCacheTtlMs: typeof value.defaultContextCacheTtlMs === 'number' && Number.isFinite(value.defaultContextCacheTtlMs) && value.defaultContextCacheTtlMs > 0
+        ? Math.floor(value.defaultContextCacheTtlMs)
+        : defaultBrainlinkConfig.defaultContextCacheTtlMs,
     allowedVaults: [...sanitizeAllowedVaults(value.allowedVaults), ...readAllowedVaultsFromEnv()],
     chunkSize: typeof value.chunkSize === 'number' && value.chunkSize > 0 ? value.chunkSize : defaultBrainlinkConfig.chunkSize,
     searchPack: sanitizeSearchPackConfig(value.searchPack),
@@ -191,7 +201,8 @@ export const resolveAgentRuntimeDefaults = (config, agent) => {
         defaultSearchLimit: profile?.defaultSearchLimit ?? config.defaultSearchLimit,
         defaultContextTokens: profile?.defaultContextTokens ?? config.defaultContextTokens,
         defaultSearchMode: profile?.defaultSearchMode ?? config.defaultSearchMode,
-        defaultContextStrategy: profile?.defaultContextStrategy ?? config.defaultContextStrategy
+        defaultContextStrategy: profile?.defaultContextStrategy ?? config.defaultContextStrategy,
+        defaultContextCacheTtlMs: profile?.defaultContextCacheTtlMs ?? config.defaultContextCacheTtlMs
     };
 };
 const mergeConfigLayers = (layers) => layers.reduce((state, config) => ({

package/dist/mcp/tools.js

@@ -399,7 +399,7 @@ export const contextTool = async (input) => {
     const strategy = sanitizeContextStrategy(input.strategy, context.defaults.defaultContextStrategy);
     const limit = input.limit ?? context.defaults.defaultSearchLimit;
     const tokens = input.tokens ?? context.defaults.defaultContextTokens;
-    const contextPackage = await buildContextPackage(context.vault, input.query, limit, tokens, context.agent, mode, strategy);
+    const contextPackage = await buildContextPackage(context.vault, input.query, limit, tokens, context.agent, mode, strategy, context.defaults.defaultContextCacheTtlMs);
     const contextSession = await touchContextSession(context.vault, context.agent);
     return jsonResult({
         vault: context.vault,
@@ -718,7 +718,7 @@ export const syncTool = async (input) => {
     const strategy = sanitizeContextStrategy(input.strategy, context.defaults.defaultContextStrategy);
     const contextLimit = input.contextLimit ?? context.defaults.defaultSearchLimit;
     const contextTokens = input.contextTokens ?? context.defaults.defaultContextTokens;
-    const contextPackage = await buildContextPackage(context.vault, input.contextQuery, contextLimit, contextTokens, context.agent, mode, strategy);
+    const contextPackage = await buildContextPackage(context.vault, input.contextQuery, contextLimit, contextTokens, context.agent, mode, strategy, context.defaults.defaultContextCacheTtlMs);
     const contextSession = await touchContextSession(context.vault, context.agent);
     return jsonResult({
         ...response,
@@ -740,7 +740,7 @@ export const bootstrapTool = async (input) => {
     const limit = input.limit ?? context.defaults.defaultSearchLimit;
     const tokens = input.tokens ?? context.defaults.defaultContextTokens;
     const contextPackage = input.query
-        ? await buildContextPackage(context.vault, input.query, limit, tokens, context.agent, mode, strategy)
+        ? await buildContextPackage(context.vault, input.query, limit, tokens, context.agent, mode, strategy, context.defaults.defaultContextCacheTtlMs)
         : undefined;
     const contextSession = input.query ? await touchContextSession(context.vault, context.agent) : undefined;
     const guidance = stats.documentCount === 0

package/docs/AGENT_USAGE.md

@@ -51,7 +51,7 @@ Set `BRAINLINK_HOME` when the whole Brainlink home directory should live somewhe
 Use `blink config where` and `blink config doctor` to inspect active paths and effective source.
 
 You can also set `defaultAgent` in `brainlink.config.json` / `.brainlink.json` (for example `"defaultAgent": "coding-agent"`). When set, CLI commands and MCP calls reuse it when `--agent`/`agent` is not passed.
-You can set `agentProfiles` to define per-agent defaults for `defaultSearchMode`, `defaultSearchLimit`, `defaultContextTokens` and `defaultContextStrategy`.
+You can set `agentProfiles` to define per-agent defaults for `defaultSearchMode`, `defaultSearchLimit`, `defaultContextTokens`, `defaultContextStrategy` and `defaultContextCacheTtlMs`.
 You can tune search-pack compression with `searchPack.rowChunkSize`, `searchPack.compressionLevel` and `searchPack.useDictionary`.
 Guardrails for benchmark acceptance are configured with `searchPack.guardrailMinSavingsPercent` and `searchPack.guardrailMaxLatencyRegressionPercent`.
 

package/docs/QUICKSTART.md

@@ -51,7 +51,8 @@ Optional per-agent retrieval defaults in `brainlink.config.json`:
       "defaultSearchMode": "semantic",
       "defaultSearchLimit": 8,
       "defaultContextTokens": 2400,
-      "defaultContextStrategy": "auto"
+      "defaultContextStrategy": "auto",
+      "defaultContextCacheTtlMs": 120000
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andespindola/brainlink",
-  "version": "0.1.0-beta.165",
+  "version": "0.1.0-beta.166",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",