memorix 1.0.9 → 1.0.10

package/dist/index.js

@@ -1607,6 +1607,7 @@ var init_mini_skills = __esm({
 // src/config/yaml-loader.ts
 var yaml_loader_exports = {};
 __export(yaml_loader_exports, {
+  clearProjectRoot: () => clearProjectRoot,
   initProjectRoot: () => initProjectRoot,
   loadYamlConfig: () => loadYamlConfig,
   resetYamlConfigCache: () => resetYamlConfigCache
@@ -1618,6 +1619,9 @@ function initProjectRoot(root) {
   globalProjectRoot = root;
   configCache.delete(root);
 }
+function clearProjectRoot() {
+  globalProjectRoot = null;
+}
 function loadYamlConfig(projectRoot) {
   const resolvedRoot = projectRoot === null ? null : projectRoot ?? globalProjectRoot ?? null;
   const cached2 = configCache.get(resolvedRoot ?? null);
@@ -1645,6 +1649,7 @@ function loadYamlConfig(projectRoot) {
     ...projectConfig,
     // Deep merge for nested objects where both exist
     llm: { ...userConfig.llm, ...projectConfig.llm },
+    agent: { ...userConfig.agent, ...projectConfig.agent },
     embedding: { ...userConfig.embedding, ...projectConfig.embedding },
     git: { ...userConfig.git, ...projectConfig.git },
     behavior: { ...userConfig.behavior, ...projectConfig.behavior },
@@ -1747,6 +1752,10 @@ var init_dotenv_loader = __esm({
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
+  getAgentLLMApiKey: () => getAgentLLMApiKey,
+  getAgentLLMBaseUrl: () => getAgentLLMBaseUrl,
+  getAgentLLMModel: () => getAgentLLMModel,
+  getAgentLLMProvider: () => getAgentLLMProvider,
   getEmbeddingApiKey: () => getEmbeddingApiKey,
   getEmbeddingBaseUrl: () => getEmbeddingBaseUrl,
   getEmbeddingDimensions: () => getEmbeddingDimensions,
@@ -1806,6 +1815,23 @@ function getLLMModel(providerDefault) {
 function getLLMBaseUrl(providerDefault) {
   return process.env.MEMORIX_LLM_BASE_URL || loadYamlConfig().llm?.baseUrl || loadFileConfig().llm?.baseUrl || providerDefault;
 }
+function getAgentLLMApiKey() {
+  return process.env.MEMORIX_AGENT_LLM_API_KEY || loadYamlConfig().agent?.apiKey || loadFileConfig().agent?.apiKey || getLLMApiKey();
+}
+function getAgentLLMProvider() {
+  if (process.env.MEMORIX_AGENT_LLM_PROVIDER) return process.env.MEMORIX_AGENT_LLM_PROVIDER;
+  const yml = loadYamlConfig();
+  if (yml.agent?.provider) return yml.agent.provider;
+  const cfg = loadFileConfig();
+  if (cfg.agent?.provider) return cfg.agent.provider;
+  return getLLMProvider();
+}
+function getAgentLLMModel(providerDefault) {
+  return process.env.MEMORIX_AGENT_LLM_MODEL || loadYamlConfig().agent?.model || loadFileConfig().agent?.model || getLLMModel(providerDefault);
+}
+function getAgentLLMBaseUrl(providerDefault) {
+  return process.env.MEMORIX_AGENT_LLM_BASE_URL || loadYamlConfig().agent?.baseUrl || loadFileConfig().agent?.baseUrl || getLLMBaseUrl(providerDefault);
+}
 function getEmbeddingMode() {
   const env = process.env.MEMORIX_EMBEDDING?.toLowerCase()?.trim();
   if (env === "fastembed" || env === "transformers" || env === "api" || env === "auto") return env;
@@ -3095,20 +3121,20 @@ async function* callLLMWithToolsStream(messages, tools) {
   }
   yield* callOpenAIWithToolsStream(messages, tools);
 }
-function initLLM() {
-  const { getLLMApiKey: getLLMApiKey2, getLLMProvider: getLLMProvider2, getLLMModel: getLLMModel2, getLLMBaseUrl: getLLMBaseUrl2 } = (init_config(), __toCommonJS(config_exports));
-  const apiKey = getLLMApiKey2();
+function initLLM(options = {}) {
+  const scope = options.scope ?? "memory";
+  const apiKey = scope === "agent" ? getAgentLLMApiKey() : getLLMApiKey();
   if (!apiKey) {
     currentConfig = null;
     return null;
   }
-  const provider2 = getLLMProvider2();
+  const provider2 = scope === "agent" ? getAgentLLMProvider() : getLLMProvider();
   const defaults = PROVIDER_DEFAULTS[provider2] ?? PROVIDER_DEFAULTS.openai;
   currentConfig = {
     provider: provider2,
     apiKey,
-    model: getLLMModel2(defaults.model),
-    baseUrl: getLLMBaseUrl2(defaults.baseUrl)
+    model: scope === "agent" ? getAgentLLMModel(defaults.model) : getLLMModel(defaults.model),
+    baseUrl: scope === "agent" ? getAgentLLMBaseUrl(defaults.baseUrl) : getLLMBaseUrl(defaults.baseUrl)
   };
   return currentConfig;
 }
@@ -3615,6 +3641,7 @@ var init_provider2 = __esm({
   "src/llm/provider.ts"() {
     "use strict";
     init_esm_shims();
+    init_config();
     LLM_TIMEOUT_DEFAULT_MS = 3e4;
     LLM_TIMEOUT_MIN_MS = 1e3;
     LLM_TIMEOUT_MAX_MS = 3e5;
@@ -10279,6 +10306,7 @@ var init_knowledge_graph = __esm({
 // src/dashboard/server.ts
 var server_exports = {};
 __export(server_exports, {
+  prepareDashboardConfig: () => prepareDashboardConfig,
   startDashboard: () => startDashboard
 });
 import { createServer } from "http";
@@ -10304,6 +10332,25 @@ function isActiveStatus(status) {
 function filterActiveByProject(items, projectId) {
   return items.filter((item) => item.projectId === projectId && isActiveStatus(item.status));
 }
+function prepareDashboardConfig(projectRoot) {
+  if (!projectRoot) {
+    if (preparedDashboardProjectRoot !== null) {
+      resetDotenv();
+      preparedDashboardProjectRoot = null;
+    }
+    clearProjectRoot();
+    return;
+  }
+  try {
+    if (preparedDashboardProjectRoot !== null && preparedDashboardProjectRoot !== projectRoot) {
+      resetDotenv();
+    }
+    initProjectRoot(projectRoot);
+    loadDotenv(projectRoot);
+    preparedDashboardProjectRoot = projectRoot;
+  } catch {
+  }
+}
 function computeProjectGraphCounts(allEntities, allRelations, projectObs) {
   const entityNames = new Set(
     projectObs.filter((o) => (o.status ?? "active") === "active" && o.entityName).map((o) => o.entityName)
@@ -10329,6 +10376,7 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
     effectiveProjectResolved = true;
     effectiveProjectRoot = null;
   }
+  prepareDashboardConfig(effectiveProjectRoot);
   try {
     switch (apiPath) {
       case "/projects": {
@@ -10583,7 +10631,7 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
         const configProjectRoot = effectiveProjectRoot;
         try {
           const { loadYamlConfig: loadYamlConfig2 } = await Promise.resolve().then(() => (init_yaml_loader(), yaml_loader_exports));
-          yml = loadYamlConfig2();
+          yml = configProjectRoot ? loadYamlConfig2(configProjectRoot) : loadYamlConfig2(null);
         } catch {
         }
         if (configProjectRoot) {
@@ -10646,6 +10694,19 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
         } else {
           values.push({ key: "llm.apiKey", value: "not set", source: "none" });
         }
+        const agentProvider = process.env.MEMORIX_AGENT_LLM_PROVIDER || yml.agent?.provider;
+        if (agentProvider) values.push({ key: "agent.llm.provider", value: agentProvider, source: await getEnvSource("MEMORIX_AGENT_LLM_PROVIDER", yml.agent?.provider ? "memorix.yml" : void 0) });
+        const agentModel = process.env.MEMORIX_AGENT_LLM_MODEL || yml.agent?.model;
+        if (agentModel) values.push({ key: "agent.llm.model", value: agentModel, source: await getEnvSource("MEMORIX_AGENT_LLM_MODEL", yml.agent?.model ? "memorix.yml" : void 0) });
+        const agentKey = process.env.MEMORIX_AGENT_LLM_API_KEY || yml.agent?.apiKey;
+        if (agentKey) {
+          let src = "unknown";
+          if (process.env.MEMORIX_AGENT_LLM_API_KEY) src = await getEnvSource("MEMORIX_AGENT_LLM_API_KEY");
+          else if (yml.agent?.apiKey) src = "memorix.yml (move to .env!)";
+          values.push({ key: "agent.llm.apiKey", value: "****" + agentKey.slice(-4), source: src, sensitive: true });
+        } else {
+          values.push({ key: "agent.llm.apiKey", value: "fallback to llm.apiKey", source: "default" });
+        }
         const embProvider = process.env.MEMORIX_EMBEDDING || yml.embedding?.provider || "off";
         values.push({ key: "embedding.provider", value: embProvider, source: await getEnvSource("MEMORIX_EMBEDDING", yml.embedding?.provider ? "memorix.yml" : void 0) });
         values.push({ key: "git.autoHook", value: String(yml.git?.autoHook ?? false), source: yml.git?.autoHook !== void 0 ? "memorix.yml" : "default" });
@@ -11081,7 +11142,7 @@ async function startDashboard(dataDir, port, staticDir, projectId, projectName,
     });
   });
 }
-var MIME_TYPES;
+var MIME_TYPES, preparedDashboardProjectRoot;
 var init_server = __esm({
   "src/dashboard/server.ts"() {
     "use strict";
@@ -11090,6 +11151,10 @@ var init_server = __esm({
     init_obs_store();
     init_session_store();
     init_graph_store();
+    init_dotenv_loader();
+    init_dotenv_loader();
+    init_yaml_loader();
+    init_yaml_loader();
     MIME_TYPES = {
       ".html": "text/html; charset=utf-8",
       ".css": "text/css; charset=utf-8",
@@ -11099,6 +11164,7 @@ var init_server = __esm({
       ".png": "image/png",
       ".ico": "image/x-icon"
     };
+    preparedDashboardProjectRoot = null;
   }
 });
 
@@ -12255,7 +12321,7 @@ function generateKiroHookFiles() {
         when: { type: "promptSubmit" },
         then: {
           type: "askAgent",
-          prompt: "Before responding, load context:\n1. Call memorix_session_start to get previous session summary and key memories\n2. Call memorix_search with a query related to the user's prompt for additional context\n3. If search results are found, use memorix_detail to fetch the most relevant ones\n4. Reference relevant memories naturally in your response"
+          prompt: "Before responding, load useful project context:\n1. Call memorix_search with a query related to the user's prompt for relevant memories\n2. If search results are found, use memorix_detail to fetch the most relevant ones\n3. If memorix_search says this is a fresh project with no Memorix memories yet, do not repeat memorix_search again in the same turn unless the user explicitly asks for history/context or new memories were written\n4. Call memorix_session_start only when explicit session semantics are useful, such as handoff, long-running work, team coordination, or HTTP project binding\n5. Reference relevant memories naturally in your response"
         }
       }, null, 2)
     },
@@ -12866,20 +12932,18 @@ alwaysApply: true
 
 You have access to Memorix memory tools. Follow these rules to maintain persistent context across sessions.
 
-## RULE 1: Session Start \u2014 Bind Project, Then Load Context
+## RULE 1: Use Memory When Useful
 
-At the **beginning of every conversation**, BEFORE responding to the user:
+At the beginning of a conversation, use Memorix when prior project context would materially help the task. Do not require a session bind for every conversation.
 
-1. Call \`memorix_session_start\` with parameters:
-   - \`agent\`: your agent identifier (e.g. "windsurf", "codex", "antigravity")
-   - \`projectRoot\`: the **absolute path** of the current workspace or repo root
-   This binds the session to the correct project. Without \`projectRoot\`, memories may go to the wrong bucket.
-2. Then call \`memorix_search\` with a query related to the user's first message for additional context
-3. If search results are found, use \`memorix_detail\` to fetch the most relevant ones
-4. Reference relevant memories naturally \u2014 the user should feel you "remember" them
+1. Call \`memorix_search\` with a query related to the user's first message or current task.
+2. If search results are found, use \`memorix_detail\` to fetch the most relevant ones.
+3. If \`memorix_search\` says this is a fresh project with no Memorix memories yet, treat that as a successful cold-start signal. Do not repeat \`memorix_search\` again in the same turn unless the user explicitly asks for history/context or new memories were written.
+4. Call \`memorix_session_start\` only when explicit session semantics are useful: handoff, long-running work, team coordination, restoring prior session context, or HTTP project binding.
+5. Reference relevant memories naturally \u2014 the user should feel you understand the project, not that you are following a ritual.
 
 **Important:** \`projectRoot\` is a detection anchor only; Git remains the source of truth for project identity.
-In HTTP control-plane mode (\`memorix serve-http\` / \`memorix background start\`), explicit \`projectRoot\` binding is required for correct multi-project isolation.
+In HTTP control-plane mode (\`memorix serve-http\` / \`memorix background start\`), explicit \`projectRoot\` binding is recommended when the workspace path is available and required for correct multi-project isolation.
 \`memorix_session_start\` is lightweight by default: it starts memory/session context only. Do not set \`joinTeam\` unless the user explicitly needs autonomous Agent Team tasks, messages, file locks, or orchestrated CLI-agent workflows.
 
 ## RULE 2: Store Important Context
@@ -13724,7 +13788,18 @@ init_mini_skills();
 init_secret_filter();
 async function compactSearch(options) {
   const entries = await searchObservations(options);
-  const formatted = formatIndexTable(entries, options.query, !options.projectId);
+  let formatted = formatIndexTable(entries, options.query, !options.projectId);
+  if (entries.length === 0 && options.projectId) {
+    const allObservations = getAllObservations();
+    const projectHasStoredMemory = allObservations.some((obs) => obs.projectId === options.projectId);
+    if (!projectHasStoredMemory) {
+      formatted = `This project does not have any Memorix memories yet.
+
+It looks like a fresh project: the tool call worked, but there is nothing stored to retrieve yet.
+
+Memories will start appearing after observations, session summaries, hook captures, or git-memory are written.`;
+    }
+  }
   const totalTokens = countTextTokens(formatted);
   return { entries, formatted, totalTokens };
 }
@@ -16392,7 +16467,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.0.9" : "1.0.1"
+    version: true ? "1.0.10" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {