@signetai/core 0.147.21 → 0.147.24

package/dist/index.js

@@ -7097,6 +7097,278 @@ function defaultPipelineModel(provider) {
   return modelDefaultForProvider(provider);
 }
 
+// src/recall.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function withDefined(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+function normalizeRememberTags(tags) {
+  if (typeof tags === "string") {
+    const value = tags.split(",").map((tag) => tag.trim()).filter((tag) => tag.length > 0).join(",");
+    return value.length > 0 ? value : undefined;
+  }
+  if (Array.isArray(tags)) {
+    const value = tags.map((tag) => tag.trim()).filter((tag) => tag.length > 0).join(",");
+    return value.length > 0 ? value : undefined;
+  }
+  return;
+}
+function normalizeRecallLimit(limit) {
+  if (typeof limit !== "number" || !Number.isFinite(limit))
+    return 10;
+  return Math.min(100, Math.max(1, Math.trunc(limit)));
+}
+function partitionRecallRows(rows) {
+  return {
+    primary: rows.filter((row) => row.supplementary !== true),
+    supporting: rows.filter((row) => row.supplementary === true)
+  };
+}
+function parseRecallMeta(raw, fallbackCount) {
+  if (!isRecord(raw)) {
+    return {
+      totalReturned: fallbackCount,
+      hasSupplementary: false,
+      noHits: fallbackCount === 0
+    };
+  }
+  const totalReturned = typeof raw.totalReturned === "number" ? raw.totalReturned : fallbackCount;
+  const hasSupplementary = raw.hasSupplementary === true;
+  const noHits = "noHits" in raw ? raw.noHits === true : totalReturned === 0;
+  const dedupe = isRecord(raw.dedupe) ? {
+    enabled: raw.dedupe.enabled === true,
+    contextEpoch: typeof raw.dedupe.contextEpoch === "number" ? raw.dedupe.contextEpoch : undefined,
+    suppressed: typeof raw.dedupe.suppressed === "number" ? raw.dedupe.suppressed : 0,
+    repeatedReturned: typeof raw.dedupe.repeatedReturned === "number" ? raw.dedupe.repeatedReturned : 0
+  } : undefined;
+  const temporal = isRecord(raw.temporal) ? raw.temporal : undefined;
+  return { totalReturned, hasSupplementary, noHits, ...dedupe ? { dedupe } : {}, ...temporal ? { temporal } : {} };
+}
+function parseRecallPayload(raw) {
+  const payload = isRecord(raw) ? raw : {};
+  const results = Array.isArray(payload.results) ? payload.results : Array.isArray(payload.memories) ? payload.memories : [];
+  const rows = results.filter(isRecord);
+  return {
+    query: typeof payload.query === "string" ? payload.query : undefined,
+    method: typeof payload.method === "string" ? payload.method : undefined,
+    rows,
+    meta: parseRecallMeta(payload.meta, rows.length),
+    message: typeof payload.message === "string" ? payload.message : undefined
+  };
+}
+function applyRecallScoreThreshold(raw, minScore) {
+  if (typeof minScore !== "number" || !Number.isFinite(minScore) || typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return raw;
+  }
+  const payload = raw;
+  const rows = Array.isArray(payload.results) ? payload.results : [];
+  const filtered = rows.filter((row) => typeof row.score !== "number" || row.score >= minScore);
+  return {
+    ...payload,
+    results: filtered,
+    meta: {
+      ...isRecord(payload.meta) ? payload.meta : {},
+      totalReturned: filtered.length,
+      hasSupplementary: filtered.some((row) => row.supplementary === true),
+      noHits: filtered.length === 0
+    }
+  };
+}
+function formatDate(value) {
+  return typeof value === "string" && value.length > 0 ? value.slice(0, 10) : "unknown";
+}
+function formatRecallRow(row, options) {
+  const score = typeof row.score === "number" ? `[${(row.score * 100).toFixed(0)}%] ` : "";
+  const source = typeof row.source === "string" ? row.source : "unknown";
+  const type = typeof row.type === "string" ? row.type : "memory";
+  const who = typeof row.who === "string" && row.who.length > 0 ? `, by ${row.who}` : "";
+  const createdAt = formatDate(row.created_at);
+  const id = typeof row.id === "string" && row.id.length > 0 ? `id: ${row.id}; ` : "";
+  const prefix = options?.includeIndex ? `${options.includeIndex}. ` : "- ";
+  return `${prefix}${score}${id}${row.content ?? ""} (${type}, ${source}, ${createdAt}${who})`;
+}
+function temporalGroupLabel(row) {
+  if (row.temporal_facet === "session")
+    return "Sessions";
+  if (row.temporal_facet === "source")
+    return "Source Activity";
+  if (row.temporal_facet === "occurred" || row.temporal_facet === "observed" || row.temporal_facet === "valid") {
+    return "Events";
+  }
+  return "Memories Captured";
+}
+function formatTemporalDate(value) {
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime()))
+    return value.slice(0, 10);
+  return parsed.toLocaleDateString("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric",
+    timeZone: "UTC"
+  });
+}
+function formatTemporalRecallText(rows, meta) {
+  const parts = [formatTemporalDate(meta.start)];
+  const groups = new Map;
+  for (const row of rows) {
+    const label = temporalGroupLabel(row);
+    groups.set(label, [...groups.get(label) ?? [], row]);
+  }
+  for (const label of ["Sessions", "Source Activity", "Events", "Memories Captured"]) {
+    const group = groups.get(label);
+    if (!group || group.length === 0)
+      continue;
+    parts.push("", label, ...group.map((row) => formatRecallRow(row)));
+  }
+  return parts.join(`
+`);
+}
+function formatRecallText(raw) {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return typeof raw === "string" ? raw : JSON.stringify(raw, null, 2);
+  }
+  const payload = raw;
+  const parsed = parseRecallPayload(payload);
+  if (parsed.message && parsed.rows.length === 0)
+    return parsed.message;
+  if (parsed.meta.noHits || parsed.rows.length === 0)
+    return "No matching memories found.";
+  const { primary, supporting } = partitionRecallRows(parsed.rows);
+  if (parsed.meta.temporal?.mode === "timeline")
+    return formatTemporalRecallText(primary, parsed.meta.temporal);
+  const noun = parsed.meta.totalReturned === 1 ? "memory" : "memories";
+  const parts = payload.aggregate?.partial === true && typeof payload.aggregate.message === "string" ? [
+    payload.aggregate.message,
+    "",
+    `Found ${parsed.meta.totalReturned} ${noun}${parsed.method ? ` (${parsed.method})` : ""}.`
+  ] : [`Found ${parsed.meta.totalReturned} ${noun}${parsed.method ? ` (${parsed.method})` : ""}.`];
+  if (primary.length > 0) {
+    parts.push("", "Primary matches:", ...primary.map((row) => formatRecallRow(row)));
+  }
+  if (supporting.length > 0) {
+    parts.push("", "Supporting context:", ...supporting.map((row) => formatRecallRow(row)));
+  }
+  return parts.join(`
+`);
+}
+function buildRecallRequestBody(query, options = {}) {
+  return withDefined({
+    query,
+    keywordQuery: options.keywordQuery ?? options.keyword_query,
+    limit: normalizeRecallLimit(options.limit),
+    project: options.project,
+    type: options.type,
+    tags: options.tags,
+    who: options.who,
+    pinned: options.pinned === true ? true : undefined,
+    importance_min: options.importance_min,
+    since: options.since,
+    until: options.until,
+    time: options.time,
+    expand: options.expand === true ? true : undefined,
+    agentId: options.agentId ?? options.agent_id ?? options.contextAgentId,
+    sessionKey: options.sessionKey ?? options.session_key,
+    includeRecalled: options.includeRecalled === true || options.include_recalled === true ? true : undefined,
+    scope: options.scope,
+    sourceOnly: options.sourceOnly === true || options.source_only === true ? true : undefined,
+    aggregate: options.aggregate === true ? true : undefined,
+    aggregateBudget: options.aggregateBudget ?? options.aggregate_budget,
+    saveAggregate: options.saveAggregate === false || options.save_aggregate === false ? false : options.saveAggregate === true || options.save_aggregate === true ? true : undefined
+  });
+}
+function normalizeStructuredMemoryPayload(value) {
+  if (!isRecord(value))
+    return value;
+  const aspects = value.aspects;
+  if (!Array.isArray(aspects))
+    return value;
+  return {
+    ...value,
+    aspects: aspects.map((aspect) => {
+      if (!isRecord(aspect))
+        return aspect;
+      if (typeof aspect.entityName === "string" && Array.isArray(aspect.attributes))
+        return aspect;
+      if (typeof aspect.entity === "string" && typeof aspect.aspect === "string" && typeof aspect.value === "string") {
+        return {
+          entityName: aspect.entity,
+          aspect: aspect.aspect,
+          attributes: [
+            withDefined({
+              content: aspect.value,
+              groupKey: typeof aspect.groupKey === "string" ? aspect.groupKey : undefined,
+              claimKey: typeof aspect.claimKey === "string" ? aspect.claimKey : undefined,
+              confidence: typeof aspect.confidence === "number" ? aspect.confidence : undefined,
+              importance: typeof aspect.importance === "number" ? aspect.importance : undefined
+            })
+          ]
+        };
+      }
+      return aspect;
+    })
+  };
+}
+function buildRememberRequestBody(content, options = {}) {
+  return withDefined({
+    content,
+    type: options.type,
+    importance: options.importance,
+    tags: normalizeRememberTags(options.tags),
+    who: options.who,
+    pinned: options.pinned === true ? true : undefined,
+    sourceType: options.sourceType,
+    sourceId: options.sourceId,
+    sourcePath: options.sourcePath,
+    createdAt: options.createdAt,
+    occurredAt: options.occurredAt,
+    observedAt: options.observedAt,
+    validFrom: options.validFrom,
+    validUntil: options.validUntil,
+    sourceCreatedAt: options.sourceCreatedAt,
+    hints: options.hints,
+    transcript: options.transcript,
+    structured: normalizeStructuredMemoryPayload(options.structured),
+    agentId: options.agentId,
+    visibility: options.visibility,
+    mode: options.mode,
+    idempotencyKey: options.idempotencyKey,
+    runtimePath: options.runtimePath,
+    harness: options.harness,
+    source: options.source
+  });
+}
+function withHookRecallCompat(result) {
+  return {
+    ...result,
+    memories: result.results,
+    count: result.results.length,
+    message: formatRecallText(result)
+  };
+}
+function emptyHookRecallResponse(query, extras) {
+  const response = {
+    results: [],
+    memories: [],
+    count: 0,
+    query,
+    method: "hybrid",
+    meta: {
+      totalReturned: 0,
+      hasSupplementary: false,
+      noHits: true
+    },
+    message: "No matching memories found."
+  };
+  return {
+    ...response,
+    ...extras?.bypassed ? { bypassed: true } : {},
+    ...extras?.internal ? { internal: true } : {}
+  };
+}
+
 // src/database.ts
 import { existsSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
@@ -11991,16 +12263,16 @@ var ONTOLOGY_PROPOSAL_OPERATIONS = [
 // src/network.ts
 var NETWORK_MODES = ["localhost", "tailscale"];
 var LOCAL_BINDS = new Set(["127.0.0.1", "localhost", "::1", "::ffff:127.0.0.1"]);
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null;
 }
 function normalizeNetworkMode(value) {
   return value === "localhost" || value === "tailscale" ? value : null;
 }
 function readNetworkMode(raw) {
-  if (!isRecord(raw))
+  if (!isRecord2(raw))
     return "localhost";
-  if (!isRecord(raw.network))
+  if (!isRecord2(raw.network))
     return "localhost";
   return normalizeNetworkMode(raw.network.mode) ?? "localhost";
 }
@@ -12055,7 +12327,7 @@ function loadConfiguredHarnesses(agentsDir) {
       continue;
     try {
       const parsed = parseSimpleYaml(readFileSync2(path, "utf-8"));
-      if (!isRecord2(parsed))
+      if (!isRecord3(parsed))
         return [];
       return parseHarnessList(parsed.harnesses);
     } catch {
@@ -12073,7 +12345,7 @@ function parseHarnessList(value) {
   }
   return [];
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null;
 }
 // src/daemon-url.ts
@@ -12289,360 +12561,88 @@ function hybridSearch(db, queryVector, queryText, options) {
         source = "vector";
       } else {
         score = keywordScore;
-        source = "keyword";
-      }
-      if (score >= minScore) {
-        scored.push({ id, score, source });
-      }
-    }
-    scored.sort((a, b) => b.score - a.score);
-  }
-  const topIds = scored.slice(0, limit).map((s) => s.id);
-  if (topIds.length === 0) {
-    return [];
-  }
-  const placeholders = topIds.map(() => "?").join(", ");
-  let typeFilter = "";
-  const params = [...topIds];
-  if (options?.type) {
-    typeFilter = " AND type = ?";
-    params.push(options.type);
-  }
-  const rows = db.prepare(`
-    SELECT id, content, type, tags, confidence
-    FROM memories
-    WHERE id IN (${placeholders})${typeFilter}
-  `).all(...params);
-  const rowMap = new Map(rows.map((r) => [r.id, r]));
-  return scored.slice(0, limit).filter((s) => rowMap.has(s.id)).map((s) => {
-    const r = rowMap.get(s.id);
-    if (!r)
-      return null;
-    return {
-      id: s.id,
-      content: r.content,
-      score: Math.round(s.score * 100) / 100,
-      type: r.type,
-      source: s.source,
-      tags: safeParseTags(r.tags),
-      confidence: r.confidence
-    };
-  }).filter((r) => r !== null);
-}
-function hasPrepareMethod(db) {
-  return typeof db === "object" && db !== null && "prepare" in db && typeof db.prepare === "function";
-}
-function getRawDb(db) {
-  if (typeof db === "object" && db !== null && "db" in db && db.db !== null && hasPrepareMethod(db.db)) {
-    return db.db;
-  }
-  if (hasPrepareMethod(db)) {
-    return db;
-  }
-  return null;
-}
-async function search(db, options) {
-  const { query, limit = 10, alpha = DEFAULT_HYBRID_ALPHA, minScore = 0.1, topK = 50 } = options;
-  const rawDb = getRawDb(db);
-  if (rawDb) {
-    const results = hybridSearch(rawDb, null, query, {
-      limit,
-      alpha,
-      minScore,
-      topK,
-      type: options.type
-    });
-    if (results.length > 0) {
-      return results;
-    }
-  }
-  try {
-    const wrapper = db;
-    const memories = typeof wrapper.getMemories === "function" ? wrapper.getMemories(options.type) : [];
-    return memories.filter((m) => m.content.toLowerCase().includes(query.toLowerCase())).slice(0, limit).map((m) => ({
-      id: m.id,
-      content: m.content,
-      score: 1,
-      type: m.type,
-      source: "keyword",
-      tags: m.tags,
-      confidence: m.confidence
-    }));
-  } catch {
-    return [];
-  }
-}
-// src/recall.ts
-function isRecord3(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function withDefined(value) {
-  return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
-}
-function normalizeRememberTags(tags) {
-  if (typeof tags === "string") {
-    const value = tags.split(",").map((tag) => tag.trim()).filter((tag) => tag.length > 0).join(",");
-    return value.length > 0 ? value : undefined;
-  }
-  if (Array.isArray(tags)) {
-    const value = tags.map((tag) => tag.trim()).filter((tag) => tag.length > 0).join(",");
-    return value.length > 0 ? value : undefined;
-  }
-  return;
-}
-function normalizeRecallLimit(limit) {
-  if (typeof limit !== "number" || !Number.isFinite(limit))
-    return 10;
-  return Math.min(100, Math.max(1, Math.trunc(limit)));
-}
-function partitionRecallRows(rows) {
-  return {
-    primary: rows.filter((row) => row.supplementary !== true),
-    supporting: rows.filter((row) => row.supplementary === true)
-  };
-}
-function parseRecallMeta(raw, fallbackCount) {
-  if (!isRecord3(raw)) {
-    return {
-      totalReturned: fallbackCount,
-      hasSupplementary: false,
-      noHits: fallbackCount === 0
-    };
-  }
-  const totalReturned = typeof raw.totalReturned === "number" ? raw.totalReturned : fallbackCount;
-  const hasSupplementary = raw.hasSupplementary === true;
-  const noHits = "noHits" in raw ? raw.noHits === true : totalReturned === 0;
-  const dedupe = isRecord3(raw.dedupe) ? {
-    enabled: raw.dedupe.enabled === true,
-    contextEpoch: typeof raw.dedupe.contextEpoch === "number" ? raw.dedupe.contextEpoch : undefined,
-    suppressed: typeof raw.dedupe.suppressed === "number" ? raw.dedupe.suppressed : 0,
-    repeatedReturned: typeof raw.dedupe.repeatedReturned === "number" ? raw.dedupe.repeatedReturned : 0
-  } : undefined;
-  const temporal = isRecord3(raw.temporal) ? raw.temporal : undefined;
-  return { totalReturned, hasSupplementary, noHits, ...dedupe ? { dedupe } : {}, ...temporal ? { temporal } : {} };
-}
-function parseRecallPayload(raw) {
-  const payload = isRecord3(raw) ? raw : {};
-  const results = Array.isArray(payload.results) ? payload.results : Array.isArray(payload.memories) ? payload.memories : [];
-  const rows = results.filter(isRecord3);
-  return {
-    query: typeof payload.query === "string" ? payload.query : undefined,
-    method: typeof payload.method === "string" ? payload.method : undefined,
-    rows,
-    meta: parseRecallMeta(payload.meta, rows.length),
-    message: typeof payload.message === "string" ? payload.message : undefined
-  };
-}
-function applyRecallScoreThreshold(raw, minScore) {
-  if (typeof minScore !== "number" || !Number.isFinite(minScore) || typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    return raw;
-  }
-  const payload = raw;
-  const rows = Array.isArray(payload.results) ? payload.results : [];
-  const filtered = rows.filter((row) => typeof row.score !== "number" || row.score >= minScore);
-  return {
-    ...payload,
-    results: filtered,
-    meta: {
-      totalReturned: filtered.length,
-      hasSupplementary: filtered.some((row) => row.supplementary === true),
-      noHits: filtered.length === 0,
-      ...isRecord3(payload.meta) && isRecord3(payload.meta.dedupe) ? { dedupe: payload.meta.dedupe } : {},
-      ...isRecord3(payload.meta) && isRecord3(payload.meta.temporal) ? { temporal: payload.meta.temporal } : {}
+        source = "keyword";
+      }
+      if (score >= minScore) {
+        scored.push({ id, score, source });
+      }
     }
-  };
-}
-function formatDate(value) {
-  return typeof value === "string" && value.length > 0 ? value.slice(0, 10) : "unknown";
-}
-function formatRecallRow(row, options) {
-  const score = typeof row.score === "number" ? `[${(row.score * 100).toFixed(0)}%] ` : "";
-  const source = typeof row.source === "string" ? row.source : "unknown";
-  const type = typeof row.type === "string" ? row.type : "memory";
-  const who = typeof row.who === "string" && row.who.length > 0 ? `, by ${row.who}` : "";
-  const createdAt = formatDate(row.created_at);
-  const id = typeof row.id === "string" && row.id.length > 0 ? `id: ${row.id}; ` : "";
-  const prefix = options?.includeIndex ? `${options.includeIndex}. ` : "- ";
-  return `${prefix}${score}${id}${row.content ?? ""} (${type}, ${source}, ${createdAt}${who})`;
-}
-function temporalGroupLabel(row) {
-  if (row.temporal_facet === "session")
-    return "Sessions";
-  if (row.temporal_facet === "source")
-    return "Source Activity";
-  if (row.temporal_facet === "occurred" || row.temporal_facet === "observed" || row.temporal_facet === "valid") {
-    return "Events";
+    scored.sort((a, b) => b.score - a.score);
   }
-  return "Memories Captured";
+  const topIds = scored.slice(0, limit).map((s) => s.id);
+  if (topIds.length === 0) {
+    return [];
+  }
+  const placeholders = topIds.map(() => "?").join(", ");
+  let typeFilter = "";
+  const params = [...topIds];
+  if (options?.type) {
+    typeFilter = " AND type = ?";
+    params.push(options.type);
+  }
+  const rows = db.prepare(`
+    SELECT id, content, type, tags, confidence
+    FROM memories
+    WHERE id IN (${placeholders})${typeFilter}
+  `).all(...params);
+  const rowMap = new Map(rows.map((r) => [r.id, r]));
+  return scored.slice(0, limit).filter((s) => rowMap.has(s.id)).map((s) => {
+    const r = rowMap.get(s.id);
+    if (!r)
+      return null;
+    return {
+      id: s.id,
+      content: r.content,
+      score: Math.round(s.score * 100) / 100,
+      type: r.type,
+      source: s.source,
+      tags: safeParseTags(r.tags),
+      confidence: r.confidence
+    };
+  }).filter((r) => r !== null);
 }
-function formatTemporalDate(value) {
-  const parsed = new Date(value);
-  if (Number.isNaN(parsed.getTime()))
-    return value.slice(0, 10);
-  return parsed.toLocaleDateString("en-US", {
-    month: "long",
-    day: "numeric",
-    year: "numeric",
-    timeZone: "UTC"
-  });
+function hasPrepareMethod(db) {
+  return typeof db === "object" && db !== null && "prepare" in db && typeof db.prepare === "function";
 }
-function formatTemporalRecallText(rows, meta) {
-  const parts = [formatTemporalDate(meta.start)];
-  const groups = new Map;
-  for (const row of rows) {
-    const label = temporalGroupLabel(row);
-    groups.set(label, [...groups.get(label) ?? [], row]);
+function getRawDb(db) {
+  if (typeof db === "object" && db !== null && "db" in db && db.db !== null && hasPrepareMethod(db.db)) {
+    return db.db;
   }
-  for (const label of ["Sessions", "Source Activity", "Events", "Memories Captured"]) {
-    const group = groups.get(label);
-    if (!group || group.length === 0)
-      continue;
-    parts.push("", label, ...group.map((row) => formatRecallRow(row)));
+  if (hasPrepareMethod(db)) {
+    return db;
   }
-  return parts.join(`
-`);
+  return null;
 }
-function formatRecallText(raw) {
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    return typeof raw === "string" ? raw : JSON.stringify(raw, null, 2);
-  }
-  const payload = raw;
-  const parsed = parseRecallPayload(payload);
-  if (parsed.message && parsed.rows.length === 0)
-    return parsed.message;
-  if (parsed.meta.noHits || parsed.rows.length === 0)
-    return "No matching memories found.";
-  const { primary, supporting } = partitionRecallRows(parsed.rows);
-  if (parsed.meta.temporal?.mode === "timeline")
-    return formatTemporalRecallText(primary, parsed.meta.temporal);
-  const noun = parsed.meta.totalReturned === 1 ? "memory" : "memories";
-  const parts = payload.aggregate?.partial === true && typeof payload.aggregate.message === "string" ? [
-    payload.aggregate.message,
-    "",
-    `Found ${parsed.meta.totalReturned} ${noun}${parsed.method ? ` (${parsed.method})` : ""}.`
-  ] : [`Found ${parsed.meta.totalReturned} ${noun}${parsed.method ? ` (${parsed.method})` : ""}.`];
-  if (primary.length > 0) {
-    parts.push("", "Primary matches:", ...primary.map((row) => formatRecallRow(row)));
+async function search(db, options) {
+  const { query, limit = 10, alpha = DEFAULT_HYBRID_ALPHA, minScore = 0.1, topK = 50 } = options;
+  const rawDb = getRawDb(db);
+  if (rawDb) {
+    const results = hybridSearch(rawDb, null, query, {
+      limit,
+      alpha,
+      minScore,
+      topK,
+      type: options.type
+    });
+    if (results.length > 0) {
+      return results;
+    }
   }
-  if (supporting.length > 0) {
-    parts.push("", "Supporting context:", ...supporting.map((row) => formatRecallRow(row)));
+  try {
+    const wrapper = db;
+    const memories = typeof wrapper.getMemories === "function" ? wrapper.getMemories(options.type) : [];
+    return memories.filter((m) => m.content.toLowerCase().includes(query.toLowerCase())).slice(0, limit).map((m) => ({
+      id: m.id,
+      content: m.content,
+      score: 1,
+      type: m.type,
+      source: "keyword",
+      tags: m.tags,
+      confidence: m.confidence
+    }));
+  } catch {
+    return [];
   }
-  return parts.join(`
-`);
-}
-function buildRecallRequestBody(query, options = {}) {
-  return withDefined({
-    query,
-    keywordQuery: options.keywordQuery ?? options.keyword_query,
-    limit: normalizeRecallLimit(options.limit),
-    project: options.project,
-    type: options.type,
-    tags: options.tags,
-    who: options.who,
-    pinned: options.pinned === true ? true : undefined,
-    importance_min: options.importance_min,
-    since: options.since,
-    until: options.until,
-    time: options.time,
-    expand: options.expand === true ? true : undefined,
-    agentId: options.agentId ?? options.agent_id ?? options.contextAgentId,
-    sessionKey: options.sessionKey ?? options.session_key,
-    includeRecalled: options.includeRecalled === true || options.include_recalled === true ? true : undefined,
-    scope: options.scope,
-    sourceOnly: options.sourceOnly === true || options.source_only === true ? true : undefined,
-    aggregate: options.aggregate === true ? true : undefined,
-    aggregateBudget: options.aggregateBudget ?? options.aggregate_budget,
-    saveAggregate: options.saveAggregate === false || options.save_aggregate === false ? false : options.saveAggregate === true || options.save_aggregate === true ? true : undefined
-  });
-}
-function normalizeStructuredMemoryPayload(value) {
-  if (!isRecord3(value))
-    return value;
-  const aspects = value.aspects;
-  if (!Array.isArray(aspects))
-    return value;
-  return {
-    ...value,
-    aspects: aspects.map((aspect) => {
-      if (!isRecord3(aspect))
-        return aspect;
-      if (typeof aspect.entityName === "string" && Array.isArray(aspect.attributes))
-        return aspect;
-      if (typeof aspect.entity === "string" && typeof aspect.aspect === "string" && typeof aspect.value === "string") {
-        return {
-          entityName: aspect.entity,
-          aspect: aspect.aspect,
-          attributes: [
-            withDefined({
-              content: aspect.value,
-              groupKey: typeof aspect.groupKey === "string" ? aspect.groupKey : undefined,
-              claimKey: typeof aspect.claimKey === "string" ? aspect.claimKey : undefined,
-              confidence: typeof aspect.confidence === "number" ? aspect.confidence : undefined,
-              importance: typeof aspect.importance === "number" ? aspect.importance : undefined
-            })
-          ]
-        };
-      }
-      return aspect;
-    })
-  };
-}
-function buildRememberRequestBody(content, options = {}) {
-  return withDefined({
-    content,
-    type: options.type,
-    importance: options.importance,
-    tags: normalizeRememberTags(options.tags),
-    who: options.who,
-    pinned: options.pinned === true ? true : undefined,
-    sourceType: options.sourceType,
-    sourceId: options.sourceId,
-    sourcePath: options.sourcePath,
-    createdAt: options.createdAt,
-    occurredAt: options.occurredAt,
-    observedAt: options.observedAt,
-    validFrom: options.validFrom,
-    validUntil: options.validUntil,
-    sourceCreatedAt: options.sourceCreatedAt,
-    hints: options.hints,
-    transcript: options.transcript,
-    structured: normalizeStructuredMemoryPayload(options.structured),
-    agentId: options.agentId,
-    visibility: options.visibility,
-    mode: options.mode,
-    idempotencyKey: options.idempotencyKey,
-    runtimePath: options.runtimePath,
-    harness: options.harness,
-    source: options.source
-  });
-}
-function withHookRecallCompat(result) {
-  return {
-    ...result,
-    memories: result.results,
-    count: result.results.length,
-    message: formatRecallText(result)
-  };
-}
-function emptyHookRecallResponse(query, extras) {
-  const response = {
-    results: [],
-    memories: [],
-    count: 0,
-    query,
-    method: "hybrid",
-    meta: {
-      totalReturned: 0,
-      hasSupplementary: false,
-      noHits: true
-    },
-    message: "No matching memories found."
-  };
-  return {
-    ...response,
-    ...extras?.bypassed ? { bypassed: true } : {},
-    ...extras?.internal ? { internal: true } : {}
-  };
 }
 // src/migrate.ts
 async function migrate(options) {

package/dist/recall.d.ts

@@ -119,7 +119,8 @@ export interface RecallRequestOptions {
     readonly session_key?: string;
     readonly includeRecalled?: boolean;
     readonly include_recalled?: boolean;
-    readonly scope?: "global" | "agent" | "session";
+    /** Exact daemon memory-scope string; agent/session isolation use their dedicated fields. */
+    readonly scope?: string;
     readonly sourceOnly?: boolean;
     readonly source_only?: boolean;
     readonly aggregate?: boolean;

package/dist/recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"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"}

package/dist/recall.js

@@ -0,0 +1,317 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/recall.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function withDefined(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+function normalizeRememberTags(tags) {
+  if (typeof tags === "string") {
+    const value = tags.split(",").map((tag) => tag.trim()).filter((tag) => tag.length > 0).join(",");
+    return value.length > 0 ? value : undefined;
+  }
+  if (Array.isArray(tags)) {
+    const value = tags.map((tag) => tag.trim()).filter((tag) => tag.length > 0).join(",");
+    return value.length > 0 ? value : undefined;
+  }
+  return;
+}
+function normalizeRecallLimit(limit) {
+  if (typeof limit !== "number" || !Number.isFinite(limit))
+    return 10;
+  return Math.min(100, Math.max(1, Math.trunc(limit)));
+}
+function partitionRecallRows(rows) {
+  return {
+    primary: rows.filter((row) => row.supplementary !== true),
+    supporting: rows.filter((row) => row.supplementary === true)
+  };
+}
+function parseRecallMeta(raw, fallbackCount) {
+  if (!isRecord(raw)) {
+    return {
+      totalReturned: fallbackCount,
+      hasSupplementary: false,
+      noHits: fallbackCount === 0
+    };
+  }
+  const totalReturned = typeof raw.totalReturned === "number" ? raw.totalReturned : fallbackCount;
+  const hasSupplementary = raw.hasSupplementary === true;
+  const noHits = "noHits" in raw ? raw.noHits === true : totalReturned === 0;
+  const dedupe = isRecord(raw.dedupe) ? {
+    enabled: raw.dedupe.enabled === true,
+    contextEpoch: typeof raw.dedupe.contextEpoch === "number" ? raw.dedupe.contextEpoch : undefined,
+    suppressed: typeof raw.dedupe.suppressed === "number" ? raw.dedupe.suppressed : 0,
+    repeatedReturned: typeof raw.dedupe.repeatedReturned === "number" ? raw.dedupe.repeatedReturned : 0
+  } : undefined;
+  const temporal = isRecord(raw.temporal) ? raw.temporal : undefined;
+  return { totalReturned, hasSupplementary, noHits, ...dedupe ? { dedupe } : {}, ...temporal ? { temporal } : {} };
+}
+function parseRecallPayload(raw) {
+  const payload = isRecord(raw) ? raw : {};
+  const results = Array.isArray(payload.results) ? payload.results : Array.isArray(payload.memories) ? payload.memories : [];
+  const rows = results.filter(isRecord);
+  return {
+    query: typeof payload.query === "string" ? payload.query : undefined,
+    method: typeof payload.method === "string" ? payload.method : undefined,
+    rows,
+    meta: parseRecallMeta(payload.meta, rows.length),
+    message: typeof payload.message === "string" ? payload.message : undefined
+  };
+}
+function applyRecallScoreThreshold(raw, minScore) {
+  if (typeof minScore !== "number" || !Number.isFinite(minScore) || typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return raw;
+  }
+  const payload = raw;
+  const rows = Array.isArray(payload.results) ? payload.results : [];
+  const filtered = rows.filter((row) => typeof row.score !== "number" || row.score >= minScore);
+  return {
+    ...payload,
+    results: filtered,
+    meta: {
+      ...isRecord(payload.meta) ? payload.meta : {},
+      totalReturned: filtered.length,
+      hasSupplementary: filtered.some((row) => row.supplementary === true),
+      noHits: filtered.length === 0
+    }
+  };
+}
+function formatDate(value) {
+  return typeof value === "string" && value.length > 0 ? value.slice(0, 10) : "unknown";
+}
+function formatRecallRow(row, options) {
+  const score = typeof row.score === "number" ? `[${(row.score * 100).toFixed(0)}%] ` : "";
+  const source = typeof row.source === "string" ? row.source : "unknown";
+  const type = typeof row.type === "string" ? row.type : "memory";
+  const who = typeof row.who === "string" && row.who.length > 0 ? `, by ${row.who}` : "";
+  const createdAt = formatDate(row.created_at);
+  const id = typeof row.id === "string" && row.id.length > 0 ? `id: ${row.id}; ` : "";
+  const prefix = options?.includeIndex ? `${options.includeIndex}. ` : "- ";
+  return `${prefix}${score}${id}${row.content ?? ""} (${type}, ${source}, ${createdAt}${who})`;
+}
+function temporalGroupLabel(row) {
+  if (row.temporal_facet === "session")
+    return "Sessions";
+  if (row.temporal_facet === "source")
+    return "Source Activity";
+  if (row.temporal_facet === "occurred" || row.temporal_facet === "observed" || row.temporal_facet === "valid") {
+    return "Events";
+  }
+  return "Memories Captured";
+}
+function formatTemporalDate(value) {
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime()))
+    return value.slice(0, 10);
+  return parsed.toLocaleDateString("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric",
+    timeZone: "UTC"
+  });
+}
+function formatTemporalRecallText(rows, meta) {
+  const parts = [formatTemporalDate(meta.start)];
+  const groups = new Map;
+  for (const row of rows) {
+    const label = temporalGroupLabel(row);
+    groups.set(label, [...groups.get(label) ?? [], row]);
+  }
+  for (const label of ["Sessions", "Source Activity", "Events", "Memories Captured"]) {
+    const group = groups.get(label);
+    if (!group || group.length === 0)
+      continue;
+    parts.push("", label, ...group.map((row) => formatRecallRow(row)));
+  }
+  return parts.join(`
+`);
+}
+function formatRecallText(raw) {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return typeof raw === "string" ? raw : JSON.stringify(raw, null, 2);
+  }
+  const payload = raw;
+  const parsed = parseRecallPayload(payload);
+  if (parsed.message && parsed.rows.length === 0)
+    return parsed.message;
+  if (parsed.meta.noHits || parsed.rows.length === 0)
+    return "No matching memories found.";
+  const { primary, supporting } = partitionRecallRows(parsed.rows);
+  if (parsed.meta.temporal?.mode === "timeline")
+    return formatTemporalRecallText(primary, parsed.meta.temporal);
+  const noun = parsed.meta.totalReturned === 1 ? "memory" : "memories";
+  const parts = payload.aggregate?.partial === true && typeof payload.aggregate.message === "string" ? [
+    payload.aggregate.message,
+    "",
+    `Found ${parsed.meta.totalReturned} ${noun}${parsed.method ? ` (${parsed.method})` : ""}.`
+  ] : [`Found ${parsed.meta.totalReturned} ${noun}${parsed.method ? ` (${parsed.method})` : ""}.`];
+  if (primary.length > 0) {
+    parts.push("", "Primary matches:", ...primary.map((row) => formatRecallRow(row)));
+  }
+  if (supporting.length > 0) {
+    parts.push("", "Supporting context:", ...supporting.map((row) => formatRecallRow(row)));
+  }
+  return parts.join(`
+`);
+}
+function buildRecallRequestBody(query, options = {}) {
+  return withDefined({
+    query,
+    keywordQuery: options.keywordQuery ?? options.keyword_query,
+    limit: normalizeRecallLimit(options.limit),
+    project: options.project,
+    type: options.type,
+    tags: options.tags,
+    who: options.who,
+    pinned: options.pinned === true ? true : undefined,
+    importance_min: options.importance_min,
+    since: options.since,
+    until: options.until,
+    time: options.time,
+    expand: options.expand === true ? true : undefined,
+    agentId: options.agentId ?? options.agent_id ?? options.contextAgentId,
+    sessionKey: options.sessionKey ?? options.session_key,
+    includeRecalled: options.includeRecalled === true || options.include_recalled === true ? true : undefined,
+    scope: options.scope,
+    sourceOnly: options.sourceOnly === true || options.source_only === true ? true : undefined,
+    aggregate: options.aggregate === true ? true : undefined,
+    aggregateBudget: options.aggregateBudget ?? options.aggregate_budget,
+    saveAggregate: options.saveAggregate === false || options.save_aggregate === false ? false : options.saveAggregate === true || options.save_aggregate === true ? true : undefined
+  });
+}
+function normalizeStructuredMemoryPayload(value) {
+  if (!isRecord(value))
+    return value;
+  const aspects = value.aspects;
+  if (!Array.isArray(aspects))
+    return value;
+  return {
+    ...value,
+    aspects: aspects.map((aspect) => {
+      if (!isRecord(aspect))
+        return aspect;
+      if (typeof aspect.entityName === "string" && Array.isArray(aspect.attributes))
+        return aspect;
+      if (typeof aspect.entity === "string" && typeof aspect.aspect === "string" && typeof aspect.value === "string") {
+        return {
+          entityName: aspect.entity,
+          aspect: aspect.aspect,
+          attributes: [
+            withDefined({
+              content: aspect.value,
+              groupKey: typeof aspect.groupKey === "string" ? aspect.groupKey : undefined,
+              claimKey: typeof aspect.claimKey === "string" ? aspect.claimKey : undefined,
+              confidence: typeof aspect.confidence === "number" ? aspect.confidence : undefined,
+              importance: typeof aspect.importance === "number" ? aspect.importance : undefined
+            })
+          ]
+        };
+      }
+      return aspect;
+    })
+  };
+}
+function buildRememberRequestBody(content, options = {}) {
+  return withDefined({
+    content,
+    type: options.type,
+    importance: options.importance,
+    tags: normalizeRememberTags(options.tags),
+    who: options.who,
+    pinned: options.pinned === true ? true : undefined,
+    sourceType: options.sourceType,
+    sourceId: options.sourceId,
+    sourcePath: options.sourcePath,
+    createdAt: options.createdAt,
+    occurredAt: options.occurredAt,
+    observedAt: options.observedAt,
+    validFrom: options.validFrom,
+    validUntil: options.validUntil,
+    sourceCreatedAt: options.sourceCreatedAt,
+    hints: options.hints,
+    transcript: options.transcript,
+    structured: normalizeStructuredMemoryPayload(options.structured),
+    agentId: options.agentId,
+    visibility: options.visibility,
+    mode: options.mode,
+    idempotencyKey: options.idempotencyKey,
+    runtimePath: options.runtimePath,
+    harness: options.harness,
+    source: options.source
+  });
+}
+function withHookRecallCompat(result) {
+  return {
+    ...result,
+    memories: result.results,
+    count: result.results.length,
+    message: formatRecallText(result)
+  };
+}
+function emptyHookRecallResponse(query, extras) {
+  const response = {
+    results: [],
+    memories: [],
+    count: 0,
+    query,
+    method: "hybrid",
+    meta: {
+      totalReturned: 0,
+      hasSupplementary: false,
+      noHits: true
+    },
+    message: "No matching memories found."
+  };
+  return {
+    ...response,
+    ...extras?.bypassed ? { bypassed: true } : {},
+    ...extras?.internal ? { internal: true } : {}
+  };
+}
+export {
+  withHookRecallCompat,
+  partitionRecallRows,
+  parseRecallPayload,
+  parseRecallMeta,
+  normalizeStructuredMemoryPayload,
+  formatRecallText,
+  emptyHookRecallResponse,
+  buildRememberRequestBody,
+  buildRecallRequestBody,
+  applyRecallScoreThreshold
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signetai/core",
-  "version": "0.147.21",
+  "version": "0.147.24",
   "license": "Apache-2.0",
   "description": "Core library for Signet - portable AI agent identity",
   "type": "module",
@@ -18,6 +18,10 @@
     "./llm-model-catalog": {
       "import": "./dist/llm-model-catalog.js",
       "types": "./dist/llm-model-catalog.d.ts"
+    },
+    "./recall": {
+      "import": "./dist/recall.js",
+      "types": "./dist/recall.d.ts"
     }
   },
   "files": [
@@ -26,7 +30,7 @@
     "!dist/**/__tests__/**"
   ],
   "scripts": {
-    "build": "bun build ./src/index.ts ./src/pipeline-providers.ts ./src/llm-model-catalog.ts --outdir ./dist --target node --external better-sqlite3 && bun run build:types",
+    "build": "bun build ./src/index.ts ./src/pipeline-providers.ts ./src/llm-model-catalog.ts ./src/recall.ts --outdir ./dist --target node --external better-sqlite3 && bun run build:types",
     "build:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
     "dev": "bun --watch src/index.ts",
     "test": "bun test",