@askexenow/exe-os 0.9.127 → 0.9.129

package/dist/chunk-DL52JPGF.js

@@ -0,0 +1,706 @@
+import {
+  attachDocumentMetadata,
+  buildRawVisibilityFilter,
+  buildWikiScopeFilter,
+  searchMemories
+} from "./chunk-HSRM6PNM.js";
+import {
+  getClient,
+  init_database
+} from "./chunk-A2NZP64U.js";
+
+// src/lib/hybrid-search.ts
+init_database();
+var RRF_K = 60;
+function buildTemporalFilter(options, columnPrefix) {
+  const asOf = options?.asOf;
+  if (asOf) {
+    return {
+      clause: ` AND (${columnPrefix}valid_from IS NULL OR ${columnPrefix}valid_from <= ?) AND (${columnPrefix}invalid_at IS NULL OR ${columnPrefix}invalid_at > ?)`,
+      args: [asOf, asOf]
+    };
+  }
+  return {
+    clause: ` AND ${columnPrefix}invalid_at IS NULL`,
+    args: []
+  };
+}
+function appendMemoryTypeFilter(sql, args, column, options) {
+  if (options?.memoryTypes && options.memoryTypes.length > 0) {
+    const uniqueTypes = [...new Set(options.memoryTypes)];
+    sql += ` AND ${column} IN (${uniqueTypes.map(() => "?").join(",")})`;
+    args.push(...uniqueTypes);
+  } else if (options?.memoryType) {
+    sql += ` AND ${column} = ?`;
+    args.push(options.memoryType);
+  }
+  return sql;
+}
+async function hybridSearch(queryText, agentId, options) {
+  const { loadConfig } = await import("./lib/config.js");
+  const config = await loadConfig();
+  const searchStartMs = Date.now();
+  if (config.searchMode === "fts") {
+    return lightweightSearch(queryText, agentId, options);
+  }
+  const limit = options?.limit ?? 10;
+  const trajectoryResults = await trajectoryBypass(queryText, agentId, options, limit);
+  if (trajectoryResults !== null) return trajectoryResults;
+  let effectiveQuery = queryText;
+  let effectiveOptions = { ...options };
+  let _isBroadQuery = false;
+  if (config.selfQueryRouter && process.env.ANTHROPIC_API_KEY) {
+    try {
+      const { routeQuery } = await import("./self-query-router-IZANO632.js");
+      const routed = await routeQuery(queryText, config.selfQueryModel);
+      effectiveQuery = routed.semanticQuery;
+      _isBroadQuery = routed.isBroadQuery;
+      if (routed.projectFilter && !effectiveOptions.projectName) {
+        effectiveOptions.projectName = routed.projectFilter;
+      }
+      if (routed.timeFilter && !effectiveOptions.since) {
+        effectiveOptions.since = routed.timeFilter;
+      }
+    } catch {
+    }
+  }
+  const { getMemoryCardinality } = await import("./lib/store.js");
+  const cardinality = await getMemoryCardinality(agentId);
+  const { rerankerAutoTrigger } = config.scalingRoadmap ?? {};
+  const minCardForBroad = rerankerAutoTrigger?.broadQueryMinCardinality ?? 5e4;
+  const useNarrowPath = cardinality < 1e4;
+  const useBroadPath = cardinality > minCardForBroad || _isBroadQuery && cardinality >= 1e4;
+  const effectiveIsBroad = useBroadPath && !useNarrowPath;
+  if (effectiveIsBroad !== _isBroadQuery) {
+    process.stderr.write(
+      `[hybrid-search] Adaptive routing override: cardinality=${cardinality}, router=${_isBroadQuery ? "broad" : "narrow"} \u2192 ${effectiveIsBroad ? "broad" : "narrow"}
+`
+    );
+  }
+  let rerankerAvailable = false;
+  if (process.env.EXE_IS_DAEMON === "1") {
+    try {
+      const { isRerankerAvailable } = await import("./reranker-LFJ73RRS.js");
+      rerankerAvailable = isRerankerAvailable();
+    } catch {
+    }
+  }
+  const broadFetchTopK = config.scalingRoadmap?.rerankerAutoTrigger?.fetchTopK ?? 150;
+  const fetchLimit = effectiveIsBroad ? Math.max(limit * 5, broadFetchTopK) : rerankerAvailable ? Math.max(limit * 4, 60) : Math.max(limit * 3, 30);
+  const fetchOptions = { ...effectiveOptions, limit: fetchLimit, includeSource: false };
+  let queryVector = null;
+  try {
+    const { embed } = await import("./lib/embedder.js");
+    queryVector = await embed(effectiveQuery);
+  } catch {
+    if (!process.env.VITEST) {
+      process.stderr.write("[hybrid-search] Embed daemon unavailable \u2014 FTS-only mode\n");
+    }
+  }
+  let grepPromise = Promise.resolve([]);
+  if (config.fileGrepEnabled === true && !process.env.VITEST) {
+    try {
+      const { getProjectName } = await import("./project-name-PL2ZDWNU.js");
+      const projectRoot = process.cwd();
+      const projectName = getProjectName(projectRoot);
+      if (projectName && projectName !== "tmp") {
+        const { grepProjectFiles } = await import("./lib/file-grep.js");
+        grepPromise = grepProjectFiles(effectiveQuery, projectRoot, {
+          maxResults: 10
+        }).catch(() => []);
+      }
+    } catch {
+    }
+  }
+  const includeStructuredCards = effectiveIsBroad || effectiveOptions.includeStructuredCards === true;
+  const [ftsResults, vectorResults, cardResults, grepResults] = await Promise.all([
+    lightweightSearch(effectiveQuery, agentId, fetchOptions),
+    queryVector ? searchMemories(queryVector, agentId, fetchOptions) : Promise.resolve([]),
+    includeStructuredCards ? (async () => {
+      try {
+        const { searchMemoryCards } = await import("./memory-cards-RIL5BZHK.js");
+        return await searchMemoryCards(effectiveQuery, agentId, fetchOptions);
+      } catch {
+        return [];
+      }
+    })() : Promise.resolve([]),
+    grepPromise
+  ]);
+  const lists = [];
+  const weights = [];
+  if (ftsResults.length > 0) {
+    lists.push(ftsResults);
+    weights.push(1);
+  }
+  if (vectorResults.length > 0) {
+    lists.push(vectorResults);
+    weights.push(1);
+  }
+  if (cardResults.length > 0) {
+    lists.push(cardResults);
+    weights.push(1.2);
+  }
+  if (grepResults.length > 0) {
+    lists.push(grepResults);
+    weights.push(0.5);
+  }
+  if (lists.length === 0) return [];
+  if (lists.length === 1 && !effectiveIsBroad) return lists[0].slice(0, limit);
+  const rrfLimit = effectiveIsBroad ? Math.max(limit * 5, broadFetchTopK) : limit;
+  let merged = lists.length === 1 ? lists[0].slice(0, rrfLimit) : rrfMergeMulti(lists, rrfLimit, RRF_K, weights);
+  let graphContextMap = /* @__PURE__ */ new Map();
+  let entityBoostRan = false;
+  if (merged.length > 0) {
+    try {
+      const { applyEntityBoost } = await import("./entity-boost-IOER4VRR.js");
+      const boosted = await applyEntityBoost(merged, effectiveQuery, getClient());
+      merged = boosted.results;
+      graphContextMap = boosted.graphContext;
+      entityBoostRan = true;
+    } catch {
+    }
+  }
+  const auto = config.scalingRoadmap?.rerankerAutoTrigger ?? {
+    enabled: config.rerankerEnabled ?? true,
+    broadQueryMinCardinality: 5e4,
+    fetchTopK: 150,
+    returnTopK: 5
+  };
+  let rerankedAndBlended = null;
+  const rerankReturnLimit = Math.max(limit, auto.returnTopK ?? 5);
+  if (effectiveIsBroad && auto.enabled && rerankerAvailable) {
+    const cardinality2 = await estimateCardinality(agentId, effectiveOptions);
+    if (cardinality2 > auto.broadQueryMinCardinality) {
+      try {
+        let rerankedRecords;
+        if (graphContextMap.size > 0) {
+          const { rerankWithContext } = await import("./reranker-LFJ73RRS.js");
+          const candidates = merged.map((m) => ({
+            text: m.raw_text,
+            context: graphContextMap.get(m.id)
+          }));
+          const scored = await rerankWithContext(effectiveQuery, candidates, rerankReturnLimit);
+          rerankedRecords = scored.map((s) => merged[s.index]);
+        } else {
+          const { rerank } = await import("./reranker-LFJ73RRS.js");
+          rerankedRecords = await rerank(effectiveQuery, merged, rerankReturnLimit);
+        }
+        if (rerankedRecords.length > 0) {
+          rerankedAndBlended = rrfMergeMulti(
+            [rerankedRecords],
+            rerankReturnLimit,
+            RRF_K
+          );
+        }
+      } catch {
+      }
+    }
+  }
+  const finalResults = (rerankedAndBlended ?? merged).slice(0, limit);
+  if (options?.includeSource && finalResults.length > 0) {
+    await attachDocumentMetadata(finalResults);
+  }
+  if (process.env.EXE_SEARCH_LOG !== "0") {
+    const logEntry = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      query: queryText,
+      agentId,
+      signals: {
+        fts: ftsResults.length,
+        vector: vectorResults.length,
+        cards: cardResults.length,
+        grep: grepResults.length,
+        entityBoost: entityBoostRan,
+        reranker: rerankedAndBlended !== null,
+        selfQueryRouter: effectiveQuery !== queryText
+      },
+      topResults: finalResults.slice(0, 10).map((r, i) => {
+        const scored = r;
+        return {
+          rank: i + 1,
+          id: r.id.slice(0, 8),
+          tool: r.tool_name,
+          score: scored.distance ?? null,
+          age_hours: Math.round((Date.now() - new Date(r.timestamp).getTime()) / 36e5)
+        };
+      }),
+      latencyMs: Date.now() - searchStartMs
+    };
+    try {
+      const fs = await import("fs");
+      const path = await import("path");
+      const os = await import("os");
+      const logPath = path.join(os.homedir(), ".exe-os", "search-quality.jsonl");
+      fs.mkdirSync(path.dirname(logPath), { recursive: true });
+      fs.appendFileSync(logPath, JSON.stringify(logEntry) + "\n");
+    } catch {
+    }
+  }
+  if (finalResults.length > 0) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const ids = finalResults.map((r) => r.id);
+    const placeholders = ids.map(() => "?").join(",");
+    try {
+      const client = getClient();
+      void client.execute({
+        sql: `UPDATE memories SET last_accessed = ?, retrieval_count = COALESCE(retrieval_count, 0) + 1, strength = MIN(1.0, COALESCE(strength, 1.0) + 0.1) WHERE id IN (${placeholders})`,
+        args: [now, ...ids]
+      }).catch(() => {
+      });
+    } catch {
+    }
+  }
+  return finalResults;
+}
+async function estimateCardinality(agentId, options) {
+  const client = getClient();
+  let sql = `SELECT COUNT(*) as cnt FROM memories
+             WHERE agent_id = ?
+               AND COALESCE(status, 'active') = 'active'
+               AND COALESCE(confidence, 0.7) >= 0.3`;
+  const args = [agentId];
+  const temporal = buildTemporalFilter(options, "");
+  sql += temporal.clause;
+  args.push(...temporal.args);
+  const rawVisibility = buildRawVisibilityFilter(options, "");
+  sql += rawVisibility.clause;
+  args.push(...rawVisibility.args);
+  if (options?.projectName) {
+    sql += ` AND project_name = ?`;
+    args.push(options.projectName);
+  }
+  if (options?.toolName) {
+    sql += ` AND tool_name = ?`;
+    args.push(options.toolName);
+  }
+  if (options?.hasError !== void 0) {
+    sql += ` AND has_error = ?`;
+    args.push(options.hasError ? 1 : 0);
+  }
+  if (options?.since) {
+    sql += ` AND timestamp >= ?`;
+    args.push(options.since);
+  }
+  sql = appendMemoryTypeFilter(sql, args, "memory_type", options);
+  try {
+    const result = await client.execute({ sql, args });
+    return Number(result.rows[0]?.cnt) || 0;
+  } catch {
+    return 0;
+  }
+}
+function rrfMerge(listA, listB, limit, k = RRF_K) {
+  return rrfMergeMulti([listA, listB], limit, k);
+}
+function recencyScore(timestamp) {
+  const daysSince = (Date.now() - new Date(timestamp).getTime()) / (1e3 * 60 * 60 * 24);
+  return 1 / (1 + daysSince * 0.01);
+}
+function normalizedImportance(importance) {
+  return ((importance ?? 5) - 1) / 9;
+}
+function frecencyBoost(lastAccessed, timestamp) {
+  const accessTime = lastAccessed ? new Date(lastAccessed).getTime() : new Date(timestamp).getTime();
+  const hoursSince = Math.max(0, (Date.now() - accessTime) / (1e3 * 60 * 60));
+  return Math.exp(-0.01 * hoursSince);
+}
+function sourceConfidence(record) {
+  const tool = record.tool_name?.toLowerCase() ?? "";
+  if (tool === "manual" || tool === "store_memory") return 0.95;
+  if (tool === "auto-summary" || tool === "consolidation") return 0.9;
+  if (tool === "userprompt" || tool === "assistantresponse") return 0.75;
+  if (tool === "bash" || tool === "write" || tool === "edit") return 0.6;
+  if (tool === "file_grep" || tool === "file_read") return 0.5;
+  return record.confidence ?? 0.5;
+}
+function rrfMergeMulti(lists, limit, k = RRF_K, weights) {
+  const scores = /* @__PURE__ */ new Map();
+  for (let listIdx = 0; listIdx < lists.length; listIdx++) {
+    const list = lists[listIdx];
+    const weight = weights?.[listIdx] ?? 1;
+    for (let i = 0; i < list.length; i++) {
+      const rec = list[i];
+      const entry = scores.get(rec.id) ?? { rrfScore: 0, record: rec };
+      entry.rrfScore += weight * (1 / (k + i + 1));
+      scores.set(rec.id, entry);
+    }
+  }
+  const entries = Array.from(scores.values()).map((e) => {
+    const recency = recencyScore(e.record.timestamp);
+    const importance = normalizedImportance(e.record.importance);
+    const confidence = sourceConfidence(e.record);
+    const frecency = frecencyBoost(e.record.last_accessed, e.record.timestamp);
+    const baseScore = e.rrfScore * 0.45 + recency * 0.24 + importance * 0.21 + confidence * 0.1;
+    const procedureBoost = e.record.memory_type === "procedure" ? 0.1 : 0;
+    const finalScore = (baseScore + procedureBoost) * (1 + 0.3 * frecency);
+    return { score: finalScore, record: e.record };
+  });
+  return entries.sort((a, b) => b.score - a.score).slice(0, limit).map((e) => e.record);
+}
+async function lightweightSearch(queryText, agentId, options) {
+  const client = getClient();
+  const limit = options?.limit ?? 5;
+  const terms = queryText.toLowerCase().split(/\s+/).filter((t) => t.length >= 3).map((t) => t.replace(/[^a-z0-9_]/g, "")).filter((t) => t.length >= 3);
+  if (terms.length === 0) {
+    return recentRecords(agentId, options, limit);
+  }
+  const prefixTerms = terms.map((t) => `${t}*`);
+  const useAnd = terms.length >= 3;
+  const matchExpr = useAnd ? prefixTerms.join(" AND ") : prefixTerms.join(" OR ");
+  const results = await ftsQuery(client, matchExpr, agentId, options, limit);
+  if (useAnd && results.length < limit) {
+    const orExpr = prefixTerms.join(" OR ");
+    const orResults = await ftsQuery(client, orExpr, agentId, options, limit);
+    const seen = new Set(results.map((r) => r.id));
+    for (const r of orResults) {
+      if (!seen.has(r.id) && results.length < limit) {
+        results.push(r);
+        seen.add(r.id);
+      }
+    }
+  }
+  if (options?.includeSource && results.length > 0) {
+    await attachDocumentMetadata(results);
+  }
+  if (options?.includeStructuredCards !== true) return results;
+  try {
+    const { searchMemoryCards } = await import("./memory-cards-RIL5BZHK.js");
+    const cardResults = await searchMemoryCards(queryText, agentId, options);
+    if (cardResults.length > 0) {
+      return rrfMergeMulti([results, cardResults], limit, RRF_K, [1, 1.2]);
+    }
+  } catch {
+  }
+  return results;
+}
+async function ftsQuery(client, matchExpr, agentId, options, limit) {
+  const statusFilter = options?.includeArchived ? "" : `
+               AND COALESCE(m.status, 'active') = 'active'`;
+  const draftFilter = options?.includeDrafts ? "" : `
+               AND (m.draft = 0 OR m.draft IS NULL)`;
+  let sql = `SELECT m.id, m.agent_id, m.agent_role, m.session_id, m.timestamp,
+                    m.tool_name, m.project_name,
+                    m.has_error, m.raw_text, m.vector, m.task_id,
+                    m.importance, m.status, m.confidence, m.last_accessed,
+                    m.workspace_id, m.document_id, m.user_id,
+                    m.char_offset, m.page_number,
+                    m.source_path, m.source_type, m.memory_type
+             FROM memories m
+             JOIN memories_fts fts ON m.rowid = fts.rowid
+             WHERE memories_fts MATCH ?
+               AND m.agent_id = ?${statusFilter}${draftFilter}
+               AND COALESCE(m.confidence, 0.7) >= 0.3`;
+  const args = [matchExpr, agentId];
+  const temporal = buildTemporalFilter(options, "m.");
+  sql += temporal.clause;
+  args.push(...temporal.args);
+  const scope = buildWikiScopeFilter(options, "m.");
+  sql += scope.clause;
+  args.push(...scope.args);
+  const rawVisibility = buildRawVisibilityFilter(options, "m.");
+  sql += rawVisibility.clause;
+  args.push(...rawVisibility.args);
+  if (options?.projectName) {
+    sql += ` AND m.project_name = ?`;
+    args.push(options.projectName);
+  }
+  if (options?.toolName) {
+    sql += ` AND m.tool_name = ?`;
+    args.push(options.toolName);
+  }
+  if (options?.hasError !== void 0) {
+    sql += ` AND m.has_error = ?`;
+    args.push(options.hasError ? 1 : 0);
+  }
+  if (options?.since) {
+    sql += ` AND m.timestamp >= ?`;
+    args.push(options.since);
+  }
+  sql = appendMemoryTypeFilter(sql, args, "m.memory_type", options);
+  sql += ` ORDER BY rank LIMIT ?`;
+  args.push(limit);
+  let result;
+  try {
+    result = await client.execute({ sql, args });
+  } catch (ftsErr) {
+    const msg = ftsErr instanceof Error ? ftsErr.message : String(ftsErr);
+    if (msg.includes("fts5") || msg.includes("FTS") || msg.includes("database disk image is malformed")) {
+      process.stderr.write(
+        `[hybrid-search] FTS5 corruption detected during query: ${msg}
+[hybrid-search] Attempting auto-rebuild of memories_fts index...
+`
+      );
+      try {
+        await client.execute("INSERT INTO memories_fts(memories_fts) VALUES('rebuild')");
+        process.stderr.write("[hybrid-search] FTS5 index rebuilt successfully \u2014 retrying query.\n");
+        result = await client.execute({ sql, args });
+      } catch (rebuildErr) {
+        process.stderr.write(
+          `[hybrid-search] FTS5 rebuild failed: ${rebuildErr instanceof Error ? rebuildErr.message : String(rebuildErr)}
+`
+        );
+        return [];
+      }
+    } else {
+      throw ftsErr;
+    }
+  }
+  return result.rows.map((row) => ({
+    id: row.id,
+    agent_id: row.agent_id,
+    agent_role: row.agent_role,
+    session_id: row.session_id,
+    timestamp: row.timestamp,
+    tool_name: row.tool_name,
+    project_name: row.project_name,
+    has_error: row.has_error === 1,
+    raw_text: row.raw_text,
+    vector: row.vector == null ? [] : Array.isArray(row.vector) ? row.vector : Array.from(row.vector),
+    task_id: row.task_id ?? null,
+    importance: row.importance ?? 5,
+    status: row.status ?? "active",
+    confidence: row.confidence ?? 0.7,
+    last_accessed: row.last_accessed ?? row.timestamp,
+    workspace_id: row.workspace_id ?? null,
+    document_id: row.document_id ?? null,
+    user_id: row.user_id ?? null,
+    char_offset: row.char_offset ?? null,
+    page_number: row.page_number ?? null,
+    source_path: row.source_path ?? null,
+    source_type: row.source_type ?? null,
+    memory_type: row.memory_type ?? void 0
+  }));
+}
+async function recentRecords(agentId, options, limit, textFilter) {
+  const client = getClient();
+  let sessionBoundaryMemories = [];
+  try {
+    const kills = await client.execute({
+      sql: `SELECT killed_at FROM session_kills
+            WHERE agent_id = ?
+            ORDER BY killed_at DESC LIMIT 2`,
+      args: [agentId]
+    });
+    if (kills.rows.length > 0) {
+      const boundarySlots = Math.min(5, Math.floor(limit / 2));
+      for (const kill of kills.rows) {
+        const killedAt = kill.killed_at;
+        const windowStart = new Date(new Date(killedAt).getTime() - 10 * 60 * 1e3).toISOString();
+        const boundaryResult = await client.execute({
+          sql: `SELECT id, agent_id, agent_role, session_id, timestamp,
+                       tool_name, project_name,
+                       has_error, raw_text, vector, task_id,
+                       importance, status, confidence, last_accessed,
+                       workspace_id, document_id, user_id,
+                       char_offset, page_number,
+                       source_path, source_type, memory_type
+                FROM memories
+                WHERE agent_id = ?
+                  AND timestamp >= ? AND timestamp <= ?
+                  AND COALESCE(status, 'active') = 'active'
+                  AND ${options?.includeRaw === false ? "COALESCE(memory_type, 'raw') != 'raw'" : "1 = 1"}
+                  ${options?.memoryTypes?.length ? `AND memory_type IN (${options.memoryTypes.map(() => "?").join(",")})` : options?.memoryType ? "AND memory_type = ?" : ""}
+                  AND COALESCE(confidence, 0.7) >= 0.3
+                ORDER BY timestamp DESC LIMIT ?`,
+          args: [
+            agentId,
+            windowStart,
+            killedAt,
+            ...options?.memoryTypes?.length ? [...new Set(options.memoryTypes)] : options?.memoryType ? [options.memoryType] : [],
+            boundarySlots
+          ]
+        });
+        for (const row of boundaryResult.rows) {
+          sessionBoundaryMemories.push(rowToMemoryRecord(row));
+        }
+      }
+    }
+  } catch {
+  }
+  const statusFilter = options?.includeArchived ? "" : `
+               AND COALESCE(status, 'active') = 'active'`;
+  const draftFilter = options?.includeDrafts ? "" : `
+               AND (draft = 0 OR draft IS NULL)`;
+  let sql = `SELECT id, agent_id, agent_role, session_id, timestamp,
+                    tool_name, project_name,
+                    has_error, raw_text, vector, task_id,
+                    importance, status, confidence, last_accessed,
+                    workspace_id, document_id, user_id,
+                    char_offset, page_number,
+                    source_path, source_type, memory_type
+             FROM memories
+             WHERE agent_id = ?${statusFilter}${draftFilter}
+               AND COALESCE(confidence, 0.7) >= 0.3`;
+  const args = [agentId];
+  const temporal = buildTemporalFilter(options, "");
+  sql += temporal.clause;
+  args.push(...temporal.args);
+  const scope = buildWikiScopeFilter(options, "");
+  sql += scope.clause;
+  args.push(...scope.args);
+  const rawVisibility = buildRawVisibilityFilter(options, "");
+  sql += rawVisibility.clause;
+  args.push(...rawVisibility.args);
+  if (options?.projectName) {
+    sql += ` AND project_name = ?`;
+    args.push(options.projectName);
+  }
+  if (options?.toolName) {
+    sql += ` AND tool_name = ?`;
+    args.push(options.toolName);
+  }
+  if (options?.hasError !== void 0) {
+    sql += ` AND has_error = ?`;
+    args.push(options.hasError ? 1 : 0);
+  }
+  if (options?.since) {
+    sql += ` AND timestamp >= ?`;
+    args.push(options.since);
+  }
+  sql = appendMemoryTypeFilter(sql, args, "memory_type", options);
+  if (textFilter) {
+    sql += ` AND raw_text LIKE '%' || ? || '%'`;
+    args.push(textFilter);
+  }
+  sql += ` ORDER BY timestamp DESC LIMIT ?`;
+  args.push(limit);
+  const result = await client.execute({ sql, args });
+  const recentResults = result.rows.map((row) => rowToMemoryRecord(row));
+  if (sessionBoundaryMemories.length > 0) {
+    const seenIds = new Set(recentResults.map((r) => r.id));
+    for (const bm of sessionBoundaryMemories) {
+      if (!seenIds.has(bm.id)) {
+        recentResults.push(bm);
+        seenIds.add(bm.id);
+      }
+    }
+    recentResults.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    return recentResults.slice(0, limit);
+  }
+  return recentResults;
+}
+function rowToMemoryRecord(row) {
+  return {
+    id: row.id,
+    agent_id: row.agent_id,
+    agent_role: row.agent_role,
+    session_id: row.session_id,
+    timestamp: row.timestamp,
+    tool_name: row.tool_name,
+    project_name: row.project_name,
+    has_error: row.has_error === 1,
+    raw_text: row.raw_text,
+    vector: row.vector == null ? [] : Array.isArray(row.vector) ? row.vector : Array.from(row.vector),
+    task_id: row.task_id ?? null,
+    importance: row.importance ?? 5,
+    status: row.status ?? "active",
+    confidence: row.confidence ?? 0.7,
+    last_accessed: row.last_accessed ?? row.timestamp,
+    workspace_id: row.workspace_id ?? null,
+    document_id: row.document_id ?? null,
+    user_id: row.user_id ?? null,
+    char_offset: row.char_offset ?? null,
+    page_number: row.page_number ?? null,
+    source_path: row.source_path ?? null,
+    source_type: row.source_type ?? null,
+    memory_type: row.memory_type ?? void 0
+  };
+}
+var KNOWN_TOOLS = /* @__PURE__ */ new Set([
+  "Bash",
+  "Read",
+  "Write",
+  "Edit",
+  "Grep",
+  "Glob",
+  "Agent",
+  "Skill",
+  "WebSearch",
+  "WebFetch"
+]);
+function detectToolQuery(query) {
+  const lower = query.toLowerCase().trim();
+  for (const tool of KNOWN_TOOLS) {
+    if (lower === tool.toLowerCase()) return tool;
+    if (lower.startsWith(tool.toLowerCase() + " ")) return tool;
+    if (lower.includes(`tool:${tool.toLowerCase()}`)) return tool;
+  }
+  return null;
+}
+async function trajectoryBypass(queryText, agentId, options, limit) {
+  const toolName = detectToolQuery(queryText);
+  if (!toolName) return null;
+  try {
+    const client = getClient();
+    const statusFilter = options?.includeArchived ? "" : `
+               AND COALESCE(status, 'active') = 'active'`;
+    const draftFilter = options?.includeDrafts ? "" : `
+               AND (draft = 0 OR draft IS NULL)`;
+    let sql = `SELECT id, agent_id, agent_role, session_id, timestamp,
+                      tool_name, project_name,
+                      has_error, raw_text, vector, task_id,
+                      importance, status, confidence, last_accessed,
+                      workspace_id, document_id, user_id,
+                      char_offset, page_number,
+                      source_path, source_type, memory_type
+               FROM memories
+               WHERE trajectory IS NOT NULL
+                 AND json_extract(trajectory, '$.tool') = ?
+                 AND agent_id = ?${statusFilter}${draftFilter}`;
+    const args = [toolName, agentId];
+    const temporal = buildTemporalFilter(options, "");
+    sql += temporal.clause;
+    args.push(...temporal.args);
+    const rawVisibility = buildRawVisibilityFilter(options, "");
+    sql += rawVisibility.clause;
+    args.push(...rawVisibility.args);
+    if (options?.projectName) {
+      sql += ` AND project_name = ?`;
+      args.push(options.projectName);
+    }
+    if (options?.since) {
+      sql += ` AND timestamp >= ?`;
+      args.push(options.since);
+    }
+    sql += ` ORDER BY timestamp DESC LIMIT ?`;
+    args.push(limit);
+    const result = await client.execute({ sql, args });
+    if (result.rows.length < 3) return null;
+    return result.rows.map((row) => ({
+      id: row.id,
+      agent_id: row.agent_id,
+      agent_role: row.agent_role,
+      session_id: row.session_id,
+      timestamp: row.timestamp,
+      tool_name: row.tool_name,
+      project_name: row.project_name,
+      has_error: row.has_error === 1,
+      raw_text: row.raw_text,
+      vector: row.vector == null ? [] : Array.isArray(row.vector) ? row.vector : Array.from(row.vector),
+      task_id: row.task_id ?? null,
+      importance: row.importance ?? 5,
+      status: row.status ?? "active",
+      confidence: row.confidence ?? 0.7,
+      last_accessed: row.last_accessed ?? row.timestamp,
+      workspace_id: row.workspace_id ?? null,
+      document_id: row.document_id ?? null,
+      user_id: row.user_id ?? null,
+      char_offset: row.char_offset ?? null,
+      page_number: row.page_number ?? null,
+      source_path: row.source_path ?? null,
+      source_type: row.source_type ?? null,
+      memory_type: row.memory_type ?? void 0
+    }));
+  } catch {
+    return null;
+  }
+}
+
+export {
+  hybridSearch,
+  estimateCardinality,
+  rrfMerge,
+  rrfMergeMulti,
+  lightweightSearch,
+  recentRecords
+};