@remnic/core 1.1.31 → 9.3.516

package/dist/{chunk-2NMMFZ5T.js → chunk-OD4FM2U7.js}

@@ -7,10 +7,13 @@ function clamp(value, min, max) {
 function parseRecallQuality(reason) {
   if (!reason) return "unknown";
   const text = reason.toLowerCase();
-  if (/(recall[_\s-]?good|quality[:=]\s*(good|high)|improv(ed|e)|resolved)/i.test(text)) {
+  if (/\bunresolved\b|\b(?:not|never|no|without)\s+(?:yet\s+)?resolved\b/.test(text)) {
+    return "poor";
+  }
+  if (/(recall[_\s-]?good|quality[:=]\s*(good|high)|\bimprov(?:e|ed|ing)\b|\bresolved\b)/.test(text)) {
     return "good";
   }
-  if (/(recall[_\s-]?poor|quality[:=]\s*(poor|low)|degrad(ed|e)|miss(ed|ing)|irrelevant)/i.test(text)) {
+  if (/(recall[_\s-]?poor|quality[:=]\s*(poor|low)|\bdegrad(?:e|ed|ing)\b|\bmiss(?:ed|ing)\b|\birrelevant\b)/.test(text)) {
     return "poor";
   }
   return "unknown";
@@ -213,4 +216,4 @@ export {
   renderCompressionGuidelinesMarkdown,
   buildCompressionGuidelinesMarkdown
 };
-//# sourceMappingURL=chunk-2NMMFZ5T.js.map
+//# sourceMappingURL=chunk-OD4FM2U7.js.map

package/dist/chunk-OD4FM2U7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compression-optimizer.ts"],"sourcesContent":["import type {\n  CompressionGuidelineOptimizerActionSummary,\n  CompressionGuidelineOptimizerEventCounts,\n  CompressionGuidelineOptimizerRuleUpdate,\n  CompressionGuidelineOptimizerState,\n  MemoryActionEvent,\n  MemoryActionOutcome,\n  MemoryActionType,\n} from \"./types.js\";\n\nexport interface CompressionGuidelineCandidate {\n  generatedAt: string;\n  sourceWindow: {\n    from: string;\n    to: string;\n  };\n  eventCounts: CompressionGuidelineOptimizerEventCounts;\n  actionSummaries: CompressionGuidelineOptimizerActionSummary[];\n  ruleUpdates: CompressionGuidelineOptimizerRuleUpdate[];\n  guidelineVersion: number;\n  optimizerVersion: number;\n}\n\nexport interface CompressionSemanticRuleRefinement {\n  action: MemoryActionType;\n  delta?: number;\n  confidence?: \"low\" | \"medium\" | \"high\";\n  note?: string;\n}\n\nexport interface CompressionSemanticRefinementResult {\n  updates: CompressionSemanticRuleRefinement[];\n}\n\nexport interface CompressionSemanticRefinementOptions {\n  enabled: boolean;\n  timeoutMs: number;\n  runRefinement?: (\n    candidate: CompressionGuidelineCandidate,\n  ) => Promise<CompressionSemanticRefinementResult | null>;\n}\n\nconst MAX_DELTA = 0.15;\nconst SPARSE_SAMPLE = 5;\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value));\n}\n\nfunction parseRecallQuality(reason: string | undefined): \"good\" | \"poor\" | \"unknown\" {\n  if (!reason) return \"unknown\";\n  const text = reason.toLowerCase();\n  if (/\\bunresolved\\b|\\b(?:not|never|no|without)\\s+(?:yet\\s+)?resolved\\b/.test(text)) {\n    return \"poor\";\n  }\n  if (/(recall[_\\s-]?good|quality[:=]\\s*(good|high)|\\bimprov(?:e|ed|ing)\\b|\\bresolved\\b)/.test(text)) {\n    return \"good\";\n  }\n  if (/(recall[_\\s-]?poor|quality[:=]\\s*(poor|low)|\\bdegrad(?:e|ed|ing)\\b|\\bmiss(?:ed|ing)\\b|\\birrelevant\\b)/.test(text)) {\n    return \"poor\";\n  }\n  return \"unknown\";\n}\n\nfunction nextGuidelineVersion(previousState: CompressionGuidelineOptimizerState | null): number {\n  if (!previousState) return 1;\n  return Math.max(1, previousState.guidelineVersion + 1);\n}\n\nfunction nextOptimizerVersion(previousState: CompressionGuidelineOptimizerState | null): number {\n  if (!previousState) return 1;\n  return Math.max(1, previousState.version + 1);\n}\n\nfunction roundDelta(value: number): number {\n  return Math.round(value * 1000) / 1000;\n}\n\nfunction confidenceForDelta(delta: number): \"low\" | \"medium\" | \"high\" {\n  const magnitude = Math.abs(delta);\n  return magnitude >= 0.09 ? \"high\" : magnitude >= 0.04 ? \"medium\" : \"low\";\n}\n\nfunction directionForDelta(delta: number): \"increase\" | \"decrease\" | \"hold\" {\n  return delta > 0 ? \"increase\" : delta < 0 ? \"decrease\" : \"hold\";\n}\n\nexport function computeCompressionGuidelineCandidate(\n  events: MemoryActionEvent[],\n  options: {\n    generatedAtIso?: string;\n    previousState?: CompressionGuidelineOptimizerState | null;\n  } = {},\n): CompressionGuidelineCandidate {\n  const generatedAt = options.generatedAtIso ?? new Date().toISOString();\n  const previousState = options.previousState ?? null;\n  const effectiveEvents = events.filter((event) => event.dryRun !== true);\n  const totalCounts: CompressionGuidelineOptimizerEventCounts = {\n    total: effectiveEvents.length,\n    applied: 0,\n    skipped: 0,\n    failed: 0,\n  };\n\n  const actionMap = new Map<MemoryActionType, CompressionGuidelineOptimizerActionSummary>();\n  let windowFrom = effectiveEvents[0]?.timestamp ?? generatedAt;\n  let windowTo = effectiveEvents[0]?.timestamp ?? generatedAt;\n\n  for (const event of effectiveEvents) {\n    if (event.timestamp < windowFrom) windowFrom = event.timestamp;\n    if (event.timestamp > windowTo) windowTo = event.timestamp;\n    totalCounts[event.outcome] += 1;\n\n    let summary = actionMap.get(event.action);\n    if (!summary) {\n      summary = {\n        action: event.action,\n        total: 0,\n        outcomes: { applied: 0, skipped: 0, failed: 0 },\n        quality: { good: 0, poor: 0, unknown: 0 },\n      };\n      actionMap.set(event.action, summary);\n    }\n\n    summary.total += 1;\n    summary.outcomes[event.outcome] += 1;\n    const quality = parseRecallQuality(event.reason);\n    summary.quality[quality] += 1;\n  }\n\n  const actionSummaries = [...actionMap.values()].sort((a, b) => {\n    if (b.total !== a.total) return b.total - a.total;\n    return a.action.localeCompare(b.action);\n  });\n\n  const ruleUpdates = actionSummaries.map((summary): CompressionGuidelineOptimizerRuleUpdate => {\n    const notes: string[] = [];\n    if (summary.total < SPARSE_SAMPLE) {\n      notes.push(\"Sparse sample size; holding baseline policy.\");\n      return {\n        action: summary.action,\n        delta: 0,\n        direction: \"hold\",\n        confidence: \"low\",\n        notes,\n      };\n    }\n\n    const successRate = summary.outcomes.applied / summary.total;\n    const failureRate = summary.outcomes.failed / summary.total;\n    const qualitySeen = summary.quality.good + summary.quality.poor;\n    const qualitySignal = qualitySeen > 0\n      ? (summary.quality.good - summary.quality.poor) / qualitySeen\n      : 0;\n    const rawDelta = clamp((successRate - failureRate) * 0.12 + qualitySignal * 0.06, -MAX_DELTA, MAX_DELTA);\n    const delta = roundDelta(rawDelta);\n\n    const direction = directionForDelta(delta);\n    if (direction === \"decrease\" && summary.outcomes.failed > summary.outcomes.applied) {\n      notes.push(\"Failures exceed applied outcomes; conservative down-adjustment.\");\n    } else if (direction === \"increase\" && summary.quality.good > summary.quality.poor) {\n      notes.push(\"Good recall quality markers support this action.\");\n    } else if (direction === \"decrease\" && summary.quality.poor > summary.quality.good) {\n      notes.push(\"Poor recall quality markers exceed good markers.\");\n    } else {\n      notes.push(\"Outcomes are stable; keep bounded adjustments.\");\n    }\n\n    const confidence = confidenceForDelta(delta);\n    return {\n      action: summary.action,\n      delta,\n      direction,\n      confidence,\n      notes,\n    };\n  });\n\n  return {\n    generatedAt,\n    sourceWindow: {\n      from: effectiveEvents.length > 0 ? windowFrom : generatedAt,\n      to: effectiveEvents.length > 0 ? windowTo : generatedAt,\n    },\n    eventCounts: totalCounts,\n    actionSummaries,\n    ruleUpdates,\n    guidelineVersion: nextGuidelineVersion(previousState),\n    optimizerVersion: nextOptimizerVersion(previousState),\n  };\n}\n\nexport async function refineCompressionGuidelineCandidateSemantically(\n  baseline: CompressionGuidelineCandidate,\n  options: CompressionSemanticRefinementOptions,\n): Promise<CompressionGuidelineCandidate> {\n  if (!options.enabled) return baseline;\n  if (typeof options.runRefinement !== \"function\") return baseline;\n\n  const timeoutMs = Math.max(1, Math.floor(options.timeoutMs));\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  const timeout = new Promise<CompressionSemanticRefinementResult | null>((resolve) => {\n    timeoutId = setTimeout(() => resolve(null), timeoutMs);\n  });\n\n  const refinementPromise = options.runRefinement(baseline).catch(() => null);\n\n  let refinement: CompressionSemanticRefinementResult | null = null;\n  try {\n    refinement = await Promise.race([refinementPromise, timeout]);\n  } catch {\n    if (timeoutId) clearTimeout(timeoutId);\n    return baseline;\n  }\n  if (timeoutId) clearTimeout(timeoutId);\n  if (!refinement || !Array.isArray(refinement.updates) || refinement.updates.length === 0) {\n    return baseline;\n  }\n\n  const updatesByAction = new Map<MemoryActionType, CompressionSemanticRuleRefinement>();\n  for (const update of refinement.updates) {\n    if (!update || typeof update.action !== \"string\") continue;\n    updatesByAction.set(update.action, update);\n  }\n\n  let changed = false;\n  const ruleUpdates = baseline.ruleUpdates.map((rule) => {\n    const patch = updatesByAction.get(rule.action);\n    if (!patch) return rule;\n\n    const nextDelta =\n      typeof patch.delta === \"number\" && Number.isFinite(patch.delta)\n        ? roundDelta(clamp(patch.delta, -MAX_DELTA, MAX_DELTA))\n        : rule.delta;\n    const nextConfidence = patch.confidence ?? confidenceForDelta(nextDelta);\n    const nextDirection = directionForDelta(nextDelta);\n    const nextNotes =\n      typeof patch.note === \"string\" && patch.note.trim().length > 0\n        ? [patch.note.trim()]\n        : rule.notes;\n\n    if (\n      nextDelta !== rule.delta ||\n      nextDirection !== rule.direction ||\n      nextConfidence !== rule.confidence ||\n      nextNotes.join(\"\\n\") !== rule.notes.join(\"\\n\")\n    ) {\n      changed = true;\n    }\n\n    return {\n      ...rule,\n      delta: nextDelta,\n      direction: nextDirection,\n      confidence: nextConfidence,\n      notes: nextNotes,\n    };\n  });\n\n  if (!changed) return baseline;\n  return {\n    ...baseline,\n    ruleUpdates,\n  };\n}\n\nexport function renderCompressionGuidelinesMarkdown(candidate: CompressionGuidelineCandidate): string {\n  const actionLines =\n    candidate.actionSummaries.length === 0\n      ? [\"- (none)\"]\n      : candidate.actionSummaries.map((item) => `- ${item.action}: ${item.total}`);\n  const outcomeLines: string[] = [\n    `- applied: ${candidate.eventCounts.applied}`,\n    `- skipped: ${candidate.eventCounts.skipped}`,\n    `- failed: ${candidate.eventCounts.failed}`,\n  ];\n  const updateLines =\n    candidate.ruleUpdates.length === 0\n      ? [\"- No telemetry events available yet. Keep defaults conservative and gather action data first.\"]\n      : candidate.ruleUpdates.map((update) => {\n          const sign = update.delta > 0 ? \"+\" : \"\";\n          return `- ${update.action}: ${update.direction} (${sign}${update.delta.toFixed(3)}, confidence=${update.confidence}) — ${update.notes.join(\" \")}`;\n        });\n\n  return [\n    \"# Compression Guidelines\",\n    \"\",\n    `Generated: ${candidate.generatedAt}`,\n    `Source events analyzed: ${candidate.eventCounts.total}`,\n    `Source window: ${candidate.sourceWindow.from} -> ${candidate.sourceWindow.to}`,\n    `Guideline version: ${candidate.guidelineVersion}`,\n    \"\",\n    \"## Action Distribution\",\n    ...actionLines,\n    \"\",\n    \"## Outcome Distribution\",\n    ...outcomeLines,\n    \"\",\n    \"## Suggested Guidelines\",\n    ...updateLines,\n    \"\",\n  ].join(\"\\n\");\n}\n\nexport function buildCompressionGuidelinesMarkdown(\n  events: MemoryActionEvent[],\n  generatedAtIso: string = new Date().toISOString(),\n  previousState: CompressionGuidelineOptimizerState | null = null,\n): string {\n  const candidate = computeCompressionGuidelineCandidate(events, {\n    generatedAtIso,\n    previousState,\n  });\n  return renderCompressionGuidelinesMarkdown(candidate);\n}\n"],"mappings":";AA0CA,IAAM,YAAY;AAClB,IAAM,gBAAgB;AAEtB,SAAS,MAAM,OAAe,KAAa,KAAqB;AAC9D,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAC3C;AAEA,SAAS,mBAAmB,QAAyD;AACnF,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,OAAO,OAAO,YAAY;AAChC,MAAI,oEAAoE,KAAK,IAAI,GAAG;AAClF,WAAO;AAAA,EACT;AACA,MAAI,oFAAoF,KAAK,IAAI,GAAG;AAClG,WAAO;AAAA,EACT;AACA,MAAI,wGAAwG,KAAK,IAAI,GAAG;AACtH,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,qBAAqB,eAAkE;AAC9F,MAAI,CAAC,cAAe,QAAO;AAC3B,SAAO,KAAK,IAAI,GAAG,cAAc,mBAAmB,CAAC;AACvD;AAEA,SAAS,qBAAqB,eAAkE;AAC9F,MAAI,CAAC,cAAe,QAAO;AAC3B,SAAO,KAAK,IAAI,GAAG,cAAc,UAAU,CAAC;AAC9C;AAEA,SAAS,WAAW,OAAuB;AACzC,SAAO,KAAK,MAAM,QAAQ,GAAI,IAAI;AACpC;AAEA,SAAS,mBAAmB,OAA0C;AACpE,QAAM,YAAY,KAAK,IAAI,KAAK;AAChC,SAAO,aAAa,OAAO,SAAS,aAAa,OAAO,WAAW;AACrE;AAEA,SAAS,kBAAkB,OAAiD;AAC1E,SAAO,QAAQ,IAAI,aAAa,QAAQ,IAAI,aAAa;AAC3D;AAEO,SAAS,qCACd,QACA,UAGI,CAAC,GAC0B;AAC/B,QAAM,cAAc,QAAQ,mBAAkB,oBAAI,KAAK,GAAE,YAAY;AACrE,QAAM,gBAAgB,QAAQ,iBAAiB;AAC/C,QAAM,kBAAkB,OAAO,OAAO,CAAC,UAAU,MAAM,WAAW,IAAI;AACtE,QAAM,cAAwD;AAAA,IAC5D,OAAO,gBAAgB;AAAA,IACvB,SAAS;AAAA,IACT,SAAS;AAAA,IACT,QAAQ;AAAA,EACV;AAEA,QAAM,YAAY,oBAAI,IAAkE;AACxF,MAAI,aAAa,gBAAgB,CAAC,GAAG,aAAa;AAClD,MAAI,WAAW,gBAAgB,CAAC,GAAG,aAAa;AAEhD,aAAW,SAAS,iBAAiB;AACnC,QAAI,MAAM,YAAY,WAAY,cAAa,MAAM;AACrD,QAAI,MAAM,YAAY,SAAU,YAAW,MAAM;AACjD,gBAAY,MAAM,OAAO,KAAK;AAE9B,QAAI,UAAU,UAAU,IAAI,MAAM,MAAM;AACxC,QAAI,CAAC,SAAS;AACZ,gBAAU;AAAA,QACR,QAAQ,MAAM;AAAA,QACd,OAAO;AAAA,QACP,UAAU,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,EAAE;AAAA,QAC9C,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE;AAAA,MAC1C;AACA,gBAAU,IAAI,MAAM,QAAQ,OAAO;AAAA,IACrC;AAEA,YAAQ,SAAS;AACjB,YAAQ,SAAS,MAAM,OAAO,KAAK;AACnC,UAAM,UAAU,mBAAmB,MAAM,MAAM;AAC/C,YAAQ,QAAQ,OAAO,KAAK;AAAA,EAC9B;AAEA,QAAM,kBAAkB,CAAC,GAAG,UAAU,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM;AAC7D,QAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAC5C,WAAO,EAAE,OAAO,cAAc,EAAE,MAAM;AAAA,EACxC,CAAC;AAED,QAAM,cAAc,gBAAgB,IAAI,CAAC,YAAqD;AAC5F,UAAM,QAAkB,CAAC;AACzB,QAAI,QAAQ,QAAQ,eAAe;AACjC,YAAM,KAAK,8CAA8C;AACzD,aAAO;AAAA,QACL,QAAQ,QAAQ;AAAA,QAChB,OAAO;AAAA,QACP,WAAW;AAAA,QACX,YAAY;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AAEA,UAAM,cAAc,QAAQ,SAAS,UAAU,QAAQ;AACvD,UAAM,cAAc,QAAQ,SAAS,SAAS,QAAQ;AACtD,UAAM,cAAc,QAAQ,QAAQ,OAAO,QAAQ,QAAQ;AAC3D,UAAM,gBAAgB,cAAc,KAC/B,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,QAAQ,cAChD;AACJ,UAAM,WAAW,OAAO,cAAc,eAAe,OAAO,gBAAgB,MAAM,CAAC,WAAW,SAAS;AACvG,UAAM,QAAQ,WAAW,QAAQ;AAEjC,UAAM,YAAY,kBAAkB,KAAK;AACzC,QAAI,cAAc,cAAc,QAAQ,SAAS,SAAS,QAAQ,SAAS,SAAS;AAClF,YAAM,KAAK,iEAAiE;AAAA,IAC9E,WAAW,cAAc,cAAc,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,MAAM;AAClF,YAAM,KAAK,kDAAkD;AAAA,IAC/D,WAAW,cAAc,cAAc,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,MAAM;AAClF,YAAM,KAAK,kDAAkD;AAAA,IAC/D,OAAO;AACL,YAAM,KAAK,gDAAgD;AAAA,IAC7D;AAEA,UAAM,aAAa,mBAAmB,KAAK;AAC3C,WAAO;AAAA,MACL,QAAQ,QAAQ;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL;AAAA,IACA,cAAc;AAAA,MACZ,MAAM,gBAAgB,SAAS,IAAI,aAAa;AAAA,MAChD,IAAI,gBAAgB,SAAS,IAAI,WAAW;AAAA,IAC9C;AAAA,IACA,aAAa;AAAA,IACb;AAAA,IACA;AAAA,IACA,kBAAkB,qBAAqB,aAAa;AAAA,IACpD,kBAAkB,qBAAqB,aAAa;AAAA,EACtD;AACF;AAEA,eAAsB,gDACpB,UACA,SACwC;AACxC,MAAI,CAAC,QAAQ,QAAS,QAAO;AAC7B,MAAI,OAAO,QAAQ,kBAAkB,WAAY,QAAO;AAExD,QAAM,YAAY,KAAK,IAAI,GAAG,KAAK,MAAM,QAAQ,SAAS,CAAC;AAC3D,MAAI,YAAkD;AACtD,QAAM,UAAU,IAAI,QAAoD,CAAC,YAAY;AACnF,gBAAY,WAAW,MAAM,QAAQ,IAAI,GAAG,SAAS;AAAA,EACvD,CAAC;AAED,QAAM,oBAAoB,QAAQ,cAAc,QAAQ,EAAE,MAAM,MAAM,IAAI;AAE1E,MAAI,aAAyD;AAC7D,MAAI;AACF,iBAAa,MAAM,QAAQ,KAAK,CAAC,mBAAmB,OAAO,CAAC;AAAA,EAC9D,QAAQ;AACN,QAAI,UAAW,cAAa,SAAS;AACrC,WAAO;AAAA,EACT;AACA,MAAI,UAAW,cAAa,SAAS;AACrC,MAAI,CAAC,cAAc,CAAC,MAAM,QAAQ,WAAW,OAAO,KAAK,WAAW,QAAQ,WAAW,GAAG;AACxF,WAAO;AAAA,EACT;AAEA,QAAM,kBAAkB,oBAAI,IAAyD;AACrF,aAAW,UAAU,WAAW,SAAS;AACvC,QAAI,CAAC,UAAU,OAAO,OAAO,WAAW,SAAU;AAClD,oBAAgB,IAAI,OAAO,QAAQ,MAAM;AAAA,EAC3C;AAEA,MAAI,UAAU;AACd,QAAM,cAAc,SAAS,YAAY,IAAI,CAAC,SAAS;AACrD,UAAM,QAAQ,gBAAgB,IAAI,KAAK,MAAM;AAC7C,QAAI,CAAC,MAAO,QAAO;AAEnB,UAAM,YACJ,OAAO,MAAM,UAAU,YAAY,OAAO,SAAS,MAAM,KAAK,IAC1D,WAAW,MAAM,MAAM,OAAO,CAAC,WAAW,SAAS,CAAC,IACpD,KAAK;AACX,UAAM,iBAAiB,MAAM,cAAc,mBAAmB,SAAS;AACvE,UAAM,gBAAgB,kBAAkB,SAAS;AACjD,UAAM,YACJ,OAAO,MAAM,SAAS,YAAY,MAAM,KAAK,KAAK,EAAE,SAAS,IACzD,CAAC,MAAM,KAAK,KAAK,CAAC,IAClB,KAAK;AAEX,QACE,cAAc,KAAK,SACnB,kBAAkB,KAAK,aACvB,mBAAmB,KAAK,cACxB,UAAU,KAAK,IAAI,MAAM,KAAK,MAAM,KAAK,IAAI,GAC7C;AACA,gBAAU;AAAA,IACZ;AAEA,WAAO;AAAA,MACL,GAAG;AAAA,MACH,OAAO;AAAA,MACP,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,OAAO;AAAA,IACT;AAAA,EACF,CAAC;AAED,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,EACF;AACF;AAEO,SAAS,oCAAoC,WAAkD;AACpG,QAAM,cACJ,UAAU,gBAAgB,WAAW,IACjC,CAAC,UAAU,IACX,UAAU,gBAAgB,IAAI,CAAC,SAAS,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,EAAE;AAC/E,QAAM,eAAyB;AAAA,IAC7B,cAAc,UAAU,YAAY,OAAO;AAAA,IAC3C,cAAc,UAAU,YAAY,OAAO;AAAA,IAC3C,aAAa,UAAU,YAAY,MAAM;AAAA,EAC3C;AACA,QAAM,cACJ,UAAU,YAAY,WAAW,IAC7B,CAAC,+FAA+F,IAChG,UAAU,YAAY,IAAI,CAAC,WAAW;AACpC,UAAM,OAAO,OAAO,QAAQ,IAAI,MAAM;AACtC,WAAO,KAAK,OAAO,MAAM,KAAK,OAAO,SAAS,KAAK,IAAI,GAAG,OAAO,MAAM,QAAQ,CAAC,CAAC,gBAAgB,OAAO,UAAU,YAAO,OAAO,MAAM,KAAK,GAAG,CAAC;AAAA,EACjJ,CAAC;AAEP,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,cAAc,UAAU,WAAW;AAAA,IACnC,2BAA2B,UAAU,YAAY,KAAK;AAAA,IACtD,kBAAkB,UAAU,aAAa,IAAI,OAAO,UAAU,aAAa,EAAE;AAAA,IAC7E,sBAAsB,UAAU,gBAAgB;AAAA,IAChD;AAAA,IACA;AAAA,IACA,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA,GAAG;AAAA,IACH;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEO,SAAS,mCACd,QACA,kBAAyB,oBAAI,KAAK,GAAE,YAAY,GAChD,gBAA2D,MACnD;AACR,QAAM,YAAY,qCAAqC,QAAQ;AAAA,IAC7D;AAAA,IACA;AAAA,EACF,CAAC;AACD,SAAO,oCAAoC,SAAS;AACtD;","names":[]}

package/dist/{chunk-OZHRDTDX.js → chunk-OKTXM5H4.js}

@@ -1,4 +1,13 @@
 // src/connectors-cli.ts
+function buildConnectorRowsFromDefinitions(definitions, states) {
+  const stateMap = new Map(states.map((state) => [state.id, state]));
+  return definitions.map((definition) => ({
+    id: definition.id,
+    displayName: definition.displayName,
+    enabled: definition.enabled,
+    state: stateMap.get(definition.id) ?? null
+  }));
+}
 var CONNECTORS_OUTPUT_FORMATS = ["text", "markdown", "json"];
 function parseConnectorsFormat(value, defaultFormat = "text") {
   if (value === void 0 || value === null) return defaultFormat;
@@ -228,6 +237,7 @@ function escapePipes(value) {
 }
 
 export {
+  buildConnectorRowsFromDefinitions,
   CONNECTORS_OUTPUT_FORMATS,
   parseConnectorsFormat,
   parseConnectorsListOptions,
@@ -237,4 +247,4 @@ export {
   renderConnectorsRunResult,
   runConnectorPollOnce
 };
-//# sourceMappingURL=chunk-OZHRDTDX.js.map
+//# sourceMappingURL=chunk-OKTXM5H4.js.map

package/dist/chunk-OKTXM5H4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connectors-cli.ts"],"sourcesContent":["/**\n * `remnic connectors` CLI helpers (issue #683 PR 6/N).\n *\n * Three subcommands:\n *\n *   remnic connectors list\n *     Lists all configured live connectors, their enabled state, last poll\n *     time, and last error.  Output formats: text (default), markdown, json.\n *\n *   remnic connectors status\n *     Identical data to `list` but defaults to JSON output so scripts can\n *     reliably parse it.  Accepts `--format` to override.\n *\n *   remnic connectors run <name>\n *     Manually triggers a single `syncIncremental()` pass for the named\n *     connector.  Operator debug surface — useful when you want to test\n *     credentials without waiting for the scheduler tick.  Prints the\n *     number of new documents imported plus any error.\n *\n * Design decisions:\n *\n *   - Pure functions for list / status / run option parsing so they can be\n *     unit-tested without booting an orchestrator (CLAUDE.md rules 14 + 51).\n *   - Rendering lives here (not in cli.ts) so HTTP/MCP surfaces can reuse the\n *     same output without forking formatting (CLAUDE.md rule 22).\n *   - The `run` command requires the caller to pass a `pollFn` callback\n *     (wrapping the actual connector's `syncIncremental`).  This keeps the\n *     helper module free of direct orchestrator / live-connector imports while\n *     still being testable (CLAUDE.md rule 33 — mock signatures must match\n *     production).\n *   - CLAUDE.md rule 51: invalid `--format` throws with listed options; unknown\n *     connector name in `run` throws a descriptive error; `--format` without a\n *     value is caught by Commander's built-in argument check.\n *   - `runConnectorPollOnce` encapsulates the persist-before-cursor-advance\n *     contract (CLAUDE.md gotcha #25, #43) so it can be unit-tested in\n *     isolation without an orchestrator.\n */\n\nimport {\n  type ConnectorCursor,\n  type ConnectorDocument,\n  type ConnectorState,\n  type ConnectorSyncStatus,\n} from \"./connectors/live/index.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types that cross the module boundary\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * A lightweight descriptor for one live connector, assembled from the parsed\n * config and any persisted state.  The CLI handler builds this from\n * `orchestrator.config.connectors` + `listConnectorStates(memoryDir)`.\n */\nexport interface ConnectorRow {\n  /** Stable connector id (e.g. `\"google-drive\"`, `\"notion\"`). */\n  id: string;\n  /** Human-readable display name. */\n  displayName: string;\n  /** Whether the operator has enabled this connector in config. */\n  enabled: boolean;\n  /** Persisted sync state, or `null` if no sync has ever run. */\n  state: ConnectorState | null;\n}\n\nexport interface ConnectorRowDefinition {\n  id: string;\n  displayName: string;\n  enabled: boolean;\n}\n\nexport function buildConnectorRowsFromDefinitions(\n  definitions: readonly ConnectorRowDefinition[],\n  states: readonly ConnectorState[],\n): ConnectorRow[] {\n  const stateMap = new Map(states.map((state) => [state.id, state]));\n  return definitions.map((definition) => ({\n    id: definition.id,\n    displayName: definition.displayName,\n    enabled: definition.enabled,\n    state: stateMap.get(definition.id) ?? null,\n  }));\n}\n\n/**\n * Result returned by the `run` command's poll function.\n */\nexport interface ConnectorRunResult {\n  /** Number of new documents imported in this pass. */\n  docsImported: number;\n  /**\n   * Error message if the sync or ingest failed, undefined on full success.\n   * When only the cursor write failed after a successful ingest, this field is\n   * undefined and `stateWriteError` carries the failure. When persisting error\n   * state fails after a sync/ingest error, both fields are set so callers can\n   * preserve the primary failure while also reporting stale persisted state.\n   */\n  error?: string;\n  /**\n   * Set when cursor/error-state persistence fails. On the success path,\n   * `docsImported` reflects the actual count of successfully ingested docs so\n   * the operator knows data was persisted even though the cursor did not\n   * advance. On the error path, `error` preserves the primary sync/ingest\n   * failure and this field reports the secondary persistence failure.\n   */\n  stateWriteError?: string;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Output formats\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const CONNECTORS_OUTPUT_FORMATS = [\"text\", \"markdown\", \"json\"] as const;\nexport type ConnectorsOutputFormat = (typeof CONNECTORS_OUTPUT_FORMATS)[number];\n\n/**\n * Validate `--format <fmt>`.  Throws a listed-options error for any value not\n * in `CONNECTORS_OUTPUT_FORMATS`.  Returns the given default when the value is\n * `undefined` (no flag supplied).\n */\nexport function parseConnectorsFormat(\n  value: unknown,\n  defaultFormat: ConnectorsOutputFormat = \"text\",\n): ConnectorsOutputFormat {\n  if (value === undefined || value === null) return defaultFormat;\n  if (\n    typeof value !== \"string\" ||\n    !(CONNECTORS_OUTPUT_FORMATS as readonly string[]).includes(value)\n  ) {\n    throw new Error(\n      `--format expects one of ${CONNECTORS_OUTPUT_FORMATS.join(\", \")}; got ${JSON.stringify(value)}`,\n    );\n  }\n  return value as ConnectorsOutputFormat;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Parsed option types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface ParsedConnectorsListOptions {\n  format: ConnectorsOutputFormat;\n}\n\nexport interface ParsedConnectorsStatusOptions {\n  /** `status` defaults to JSON for scripting; `--format` can override. */\n  format: ConnectorsOutputFormat;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Option parsers (pure, unit-testable)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Validate the option bag for `remnic connectors list`.\n */\nexport function parseConnectorsListOptions(\n  options: Record<string, unknown>,\n): ParsedConnectorsListOptions {\n  return {\n    format: parseConnectorsFormat(options.format, \"text\"),\n  };\n}\n\n/**\n * Validate the option bag for `remnic connectors status`.\n * Defaults to `json` (machine-readable) unless `--format` overrides.\n */\nexport function parseConnectorsStatusOptions(\n  options: Record<string, unknown>,\n): ParsedConnectorsStatusOptions {\n  return {\n    format: parseConnectorsFormat(options.format, \"json\"),\n  };\n}\n\n/**\n * Validate the positional `<name>` argument for `remnic connectors run`.\n */\nexport function parseConnectorsRunName(rawName: unknown): string {\n  if (typeof rawName !== \"string\" || rawName.trim().length === 0) {\n    throw new Error(\n      \"connectors run: <name> is required and must be a non-empty connector id\",\n    );\n  }\n  return rawName.trim();\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Formatters: shared helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Human-readable summary of `ConnectorSyncStatus`.\n *\n * Does NOT fold in the enabled/disabled state — the text and markdown\n * renderers already display that separately.  Mixing them produced\n * \"state: disabled, disabled\" when `enabled=false` and `status=\"never\"`.\n */\nfunction statusLabel(status: ConnectorSyncStatus): string {\n  switch (status) {\n    case \"never\":\n      return \"never synced\";\n    case \"success\":\n      return \"ok\";\n    case \"error\":\n      return \"error\";\n    default:\n      return status;\n  }\n}\n\n/**\n * Format a UTC ISO timestamp for display.  If the value is `null` / `undefined`\n * returns the given fallback string.\n */\nfunction fmtTimestamp(value: string | null | undefined, fallback = \"—\"): string {\n  if (!value) return fallback;\n  return value;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Renderers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Render connector rows for `remnic connectors list` / `remnic connectors status`.\n */\nexport function renderConnectorsList(\n  rows: readonly ConnectorRow[],\n  format: ConnectorsOutputFormat,\n): string {\n  if (format === \"json\") {\n    const out = rows.map((row) => ({\n      id: row.id,\n      displayName: row.displayName,\n      enabled: row.enabled,\n      lastSyncAt: row.state?.lastSyncAt ?? null,\n      lastSyncStatus: row.state?.lastSyncStatus ?? \"never\",\n      lastSyncError: row.state?.lastSyncError ?? null,\n      totalDocsImported: row.state?.totalDocsImported ?? 0,\n      updatedAt: row.state?.updatedAt ?? null,\n    }));\n    return JSON.stringify(out, null, 2);\n  }\n\n  if (rows.length === 0) {\n    if (format === \"markdown\") {\n      return \"# Live connectors\\n\\n_No live connectors are configured._\\n\";\n    }\n    return \"No live connectors configured.\";\n  }\n\n  if (format === \"markdown\") {\n    const lines: string[] = [\"# Live connectors\", \"\"];\n    lines.push(\"| ID | Display name | Enabled | Last poll | Docs imported | Status |\");\n    lines.push(\"| --- | --- | --- | --- | --- | --- |\");\n    for (const row of rows) {\n      const lastPoll = fmtTimestamp(row.state?.lastSyncAt);\n      const docs = row.state?.totalDocsImported ?? 0;\n      const status = statusLabel(row.state?.lastSyncStatus ?? \"never\");\n      lines.push(\n        `| \\`${row.id}\\` | ${row.displayName} | ${row.enabled ? \"yes\" : \"no\"} | ${lastPoll} | ${docs} | ${status} |`,\n      );\n      if (row.state?.lastSyncError) {\n        lines.push(\n          `| | | | | | _Error: ${escapePipes(row.state.lastSyncError)}_ |`,\n        );\n      }\n    }\n    return lines.join(\"\\n\") + \"\\n\";\n  }\n\n  // text\n  const lines: string[] = [`Live connectors (${rows.length}):`];\n  lines.push(\"\");\n  for (const row of rows) {\n    const enabledStr = row.enabled ? \"enabled\" : \"disabled\";\n    const status = statusLabel(row.state?.lastSyncStatus ?? \"never\");\n    const lastPoll = fmtTimestamp(row.state?.lastSyncAt, \"(never polled)\");\n    const docs = row.state?.totalDocsImported ?? 0;\n    lines.push(`  ${row.id}  (${row.displayName})`);\n    lines.push(`    state:         ${enabledStr}, ${status}`);\n    lines.push(`    last_poll:     ${lastPoll}`);\n    lines.push(`    docs_imported: ${docs}`);\n    if (row.state?.lastSyncError) {\n      lines.push(`    last_error:    ${row.state.lastSyncError}`);\n    }\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Render the result of a manual `remnic connectors run <name>` invocation.\n */\nexport function renderConnectorsRunResult(\n  connectorId: string,\n  result: ConnectorRunResult,\n  format: ConnectorsOutputFormat,\n): string {\n  // A run is \"ok\" when neither a sync/ingest error nor a state-write error\n  // is present.  A partial success (ingest ok, cursor write failed) still\n  // surfaces as a non-ok status so the operator knows to investigate.\n  const ok = result.error === undefined && result.stateWriteError === undefined;\n\n  if (format === \"json\") {\n    return JSON.stringify(\n      {\n        connector: connectorId,\n        docsImported: result.docsImported,\n        error: result.error ?? null,\n        stateWriteError: result.stateWriteError ?? null,\n        ok,\n      },\n      null,\n      2,\n    );\n  }\n\n  if (format === \"markdown\") {\n    const lines: string[] = [`# connectors run: \\`${connectorId}\\``, \"\"];\n    lines.push(`- **Status:** ${ok ? \"success\" : \"error\"}`);\n    lines.push(`- **Docs imported:** ${result.docsImported}`);\n    if (result.error !== undefined) {\n      lines.push(`- **Error:** ${result.error}`);\n    }\n    if (result.stateWriteError !== undefined) {\n      const label =\n        result.error === undefined\n          ? \"State-write error (cursor not advanced)\"\n          : \"State-write error (error state not persisted)\";\n      lines.push(`- **${label}:** ${result.stateWriteError}`);\n    }\n    return lines.join(\"\\n\") + \"\\n\";\n  }\n\n  // text\n  const lines: string[] = [];\n  if (ok) {\n    lines.push(`connectors run: ${connectorId} — OK`);\n    lines.push(`  docs_imported: ${result.docsImported}`);\n  } else {\n    lines.push(`connectors run: ${connectorId} — FAILED`);\n    lines.push(`  docs_imported: ${result.docsImported}`);\n    if (result.error !== undefined) {\n      lines.push(`  error:         ${result.error}`);\n    }\n    if (result.stateWriteError !== undefined) {\n      lines.push(\n        `  state_write_error: ${result.stateWriteError}`,\n      );\n      if (result.error === undefined) {\n        lines.push(\n          result.docsImported > 0\n            ? `  (docs were ingested; cursor was not advanced — next poll will re-fetch from prior position)`\n            : `  (cursor was not advanced — next poll will retry from prior position)`,\n        );\n      } else {\n        lines.push(\n          `  (error state was not persisted — next poll will retry from prior position)`,\n        );\n      }\n    }\n  }\n  return lines.join(\"\\n\");\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Poll orchestration helper\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Arguments for a single connector poll pass.\n *\n * All I/O is injectable so callers (cli.ts) can supply real implementations\n * and tests can supply lightweight stubs without booting an orchestrator.\n */\nexport interface RunConnectorPollOnceArgs {\n  /** Connector identifier (used in error/success state writes). */\n  connectorId: string;\n  /** Prior persisted state, or `null` on the very first sync. */\n  priorState: ConnectorState | null;\n  /**\n   * Perform a single incremental sync.  Returns newly-fetched documents and\n   * the cursor that should be persisted on success.\n   */\n  syncFn: (\n    cursor: ConnectorCursor | null,\n  ) => Promise<{ newDocs: ConnectorDocument[]; nextCursor: ConnectorCursor }>;\n  /**\n   * Ingest fetched documents into the memory layer.  Called BEFORE the cursor\n   * is advanced.  If this throws the cursor is NOT advanced (CLAUDE.md gotcha\n   * #25 — don't destroy old state before confirming new state succeeds).\n   */\n  ingestFn: (docs: ConnectorDocument[]) => Promise<void>;\n  /**\n   * Persist connector state (cursor + metadata).  Called after `ingestFn`\n   * succeeds (success path) or when `syncFn` / `ingestFn` throws (error path,\n   * with old cursor retained).\n   */\n  writeCursorFn: (state: {\n    cursor: ConnectorCursor | null;\n    lastSyncStatus: ConnectorSyncStatus;\n    lastSyncError?: string;\n    totalDocsImported: number;\n  }) => Promise<void>;\n}\n\n/**\n * Execute one `syncIncremental` pass for a live connector, enforcing the\n * persist-before-advance-cursor contract.\n *\n * Invariant (CLAUDE.md gotcha #25 + #43):\n *   1. `syncFn` fetches new docs and a next cursor.\n *   2. `ingestFn` persists the docs into the memory layer.\n *   3. Only if (2) succeeds does `writeCursorFn` advance the cursor.\n *   4. If (1) or (2) throws, `writeCursorFn` is still called but retains the\n *      **prior** cursor so the next poll re-fetches the same window.\n *\n * Returns the `ConnectorRunResult` that `cli.ts` uses for output rendering.\n */\nexport async function runConnectorPollOnce(\n  args: RunConnectorPollOnceArgs,\n): Promise<ConnectorRunResult> {\n  const { connectorId, priorState, syncFn, ingestFn, writeCursorFn } = args;\n\n  let syncResult: Awaited<ReturnType<typeof syncFn>> | undefined;\n  let ingestError: string | undefined;\n\n  // ── Phase 1: fetch ──────────────────────────────────────────────────────────\n  try {\n    syncResult = await syncFn(priorState?.cursor ?? null);\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    // syncFn failed — persist error state with the OLD cursor.\n    let stateWriteError: string | undefined;\n    try {\n      await writeCursorFn({\n        cursor: priorState?.cursor ?? null,\n        lastSyncStatus: \"error\",\n        lastSyncError: msg,\n        totalDocsImported: priorState?.totalDocsImported ?? 0,\n      });\n    } catch (writeErr) {\n      stateWriteError = writeErr instanceof Error ? writeErr.message : String(writeErr);\n      console.error(\n        `[remnic] connectors/${connectorId}: failed to persist error state after syncFn failure (${stateWriteError}); original error: ${msg}`,\n      );\n    }\n    return {\n      docsImported: 0,\n      error: msg,\n      ...(stateWriteError !== undefined ? { stateWriteError } : {}),\n    };\n  }\n\n  // ── Phase 2: ingest ─────────────────────────────────────────────────────────\n  // CRITICAL: ingest docs BEFORE advancing the cursor (CLAUDE.md gotcha #25).\n  // If ingestFn throws, write the error state with the OLD cursor so the\n  // next poll re-fetches the same document window.\n  if (syncResult.newDocs.length > 0) {\n    try {\n      await ingestFn(syncResult.newDocs);\n    } catch (err) {\n      ingestError = err instanceof Error ? err.message : String(err);\n    }\n  }\n\n  if (ingestError !== undefined) {\n    // ingestFn failed — persist error state with the OLD cursor.\n    let stateWriteError: string | undefined;\n    try {\n      await writeCursorFn({\n        cursor: priorState?.cursor ?? null,\n        lastSyncStatus: \"error\",\n        lastSyncError: ingestError,\n        totalDocsImported: priorState?.totalDocsImported ?? 0,\n      });\n    } catch (writeErr) {\n      stateWriteError = writeErr instanceof Error ? writeErr.message : String(writeErr);\n      // Intentionally not re-throwing: the original ingest error is the\n      // actionable failure for the operator.  The state-write failure is\n      // secondary and should not replace it in the rendered output.\n      // (CLAUDE.md gotcha #13; Codex P2 thread PRRT_kwDORJXyws59sk8K,\n      //  Cursor thread PRRT_kwDORJXyws59slAG)\n      console.error(\n        `[remnic] connectors/${connectorId}: failed to persist error state after ingestFn failure (${stateWriteError}); original error: ${ingestError}`,\n      );\n    }\n    return {\n      docsImported: 0,\n      error: ingestError,\n      ...(stateWriteError !== undefined ? { stateWriteError } : {}),\n    };\n  }\n\n  // ── Phase 3: advance cursor ─────────────────────────────────────────────────\n  // Ingest succeeded — advance the cursor.  If the cursor write fails, the\n  // docs ARE already in the memory layer so we must report the actual\n  // docsImported count.  Surface the state-write failure as a separate\n  // `stateWriteError` field so the operator can diagnose it without\n  // confusing it with a sync/ingest failure (Codex P1 thread\n  // PRRT_kwDORJXyws59sm76, Cursor thread PRRT_kwDORJXyws59sm_N).\n  const docsImported = syncResult.newDocs.length;\n  try {\n    await writeCursorFn({\n      cursor: syncResult.nextCursor,\n      lastSyncStatus: \"success\",\n      totalDocsImported: (priorState?.totalDocsImported ?? 0) + docsImported,\n    });\n  } catch (writeErr) {\n    const writeMsg = writeErr instanceof Error ? writeErr.message : String(writeErr);\n    // Docs are already ingested — preserve the count so the operator knows\n    // data was persisted.  The next poll will re-fetch from the prior cursor\n    // position but that only causes duplicate-ingest, not data loss.\n    return { docsImported, stateWriteError: writeMsg };\n  }\n\n  return { docsImported };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Internal helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Escape characters that would break a Markdown table cell (backslash first,\n * then pipe).  Same pattern as in `patterns-cli.ts`.\n */\nfunction escapePipes(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\|/g, \"\\\\|\");\n}\n"],"mappings":"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","names":["lines"]}

package/dist/{chunk-RXDLTSWT.js → chunk-ONPLNAPX.js}

@@ -1,3 +1,9 @@
+import {
+  withTimeoutSignal
+} from "./chunk-CINZGPSJ.js";
+import {
+  isAbortError
+} from "./chunk-PVGDJXVK.js";
 import {
   log
 } from "./chunk-2ODBA7MQ.js";
@@ -24,21 +30,23 @@ var EmbedHelper = class {
   /**
    * Embed a single text string. Returns null if no provider is available.
    */
-  async embed(text) {
+  async embed(text, options = {}) {
     const provider = this.getProvider();
     if (!provider) return null;
-    return this.callEmbed(text, provider);
+    return this.callEmbed(text, provider, options.signal);
   }
   /**
    * Embed a batch of texts. Returns an array parallel to input; entries are null on failure.
    */
-  async embedBatch(texts, batchSize = 32) {
+  async embedBatch(texts, batchSize = 32, options = {}) {
     const provider = this.getProvider();
     if (!provider) return texts.map(() => null);
     const results = new Array(texts.length).fill(null);
     for (let i = 0; i < texts.length; i += batchSize) {
       const batch = texts.slice(i, i + batchSize);
-      const batchResults = await Promise.all(batch.map((t) => this.callEmbed(t, provider)));
+      const batchResults = await Promise.all(
+        batch.map((t) => this.callEmbed(t, provider, options.signal))
+      );
       for (let j = 0; j < batchResults.length; j++) {
         results[i + j] = batchResults[j];
       }
@@ -88,7 +96,7 @@ var EmbedHelper = class {
     }
     return null;
   }
-  async callEmbed(input, provider) {
+  async callEmbed(input, provider, signal) {
     try {
       const res = await fetch(provider.endpoint, {
         method: "POST",
@@ -98,7 +106,7 @@ var EmbedHelper = class {
           input: input.slice(0, 8e3),
           encoding_format: "float"
         }),
-        signal: AbortSignal.timeout(3e4)
+        signal: withTimeoutSignal(signal, 3e4)
       });
       if (!res.ok) {
         log.debug(`EmbedHelper request failed: ${provider.type} ${res.status}`);
@@ -112,6 +120,7 @@ var EmbedHelper = class {
         return Number.isFinite(v) ? v : 0;
       });
     } catch (err) {
+      if (isAbortError(err)) throw err;
       log.debug(`EmbedHelper error: ${err}`);
       return null;
     }
@@ -121,4 +130,4 @@ var EmbedHelper = class {
 export {
   EmbedHelper
 };
-//# sourceMappingURL=chunk-RXDLTSWT.js.map
+//# sourceMappingURL=chunk-ONPLNAPX.js.map

package/dist/chunk-ONPLNAPX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/search/embed-helper.ts"],"sourcesContent":["import { log } from \"../logger.js\";\nimport type { PluginConfig } from \"../types.js\";\nimport { isAbortError } from \"../abort-error.js\";\nimport { withTimeoutSignal } from \"./abort.js\";\n\ntype ProviderConfig = {\n  type: \"openai\" | \"local\";\n  model: string;\n  endpoint: string;\n  headers: Record<string, string>;\n};\n\nconst DEFAULT_OPENAI_MODEL = \"text-embedding-3-small\";\n\n/**\n * Standalone embedding helper for search backend adapters.\n *\n * NOTE: This intentionally duplicates provider resolution from EmbeddingFallback.\n * EmbeddingFallback is tightly integrated with the plugin lifecycle (telemetry,\n * rate-limit backoff, provider rotation). This class is a lightweight standalone\n * utility used by LanceDB/Orama backends which operate outside plugin context.\n * Merging them would break the port/adapter separation between search and plugin layers.\n */\nexport class EmbedHelper {\n  private provider: ProviderConfig | null | undefined; // undefined = not yet resolved\n\n  constructor(private readonly config: PluginConfig) {}\n\n  /**\n   * Whether an embedding provider is available.\n   * Resolves the provider on first call.\n   */\n  isAvailable(): boolean {\n    if (this.provider === undefined) {\n      this.provider = this.resolveProvider();\n    }\n    return this.provider !== null;\n  }\n\n  /**\n   * Embed a single text string. Returns null if no provider is available.\n   */\n  async embed(text: string, options: { signal?: AbortSignal } = {}): Promise<number[] | null> {\n    const provider = this.getProvider();\n    if (!provider) return null;\n    return this.callEmbed(text, provider, options.signal);\n  }\n\n  /**\n   * Embed a batch of texts. Returns an array parallel to input; entries are null on failure.\n   */\n  async embedBatch(\n    texts: string[],\n    batchSize = 32,\n    options: { signal?: AbortSignal } = {},\n  ): Promise<(number[] | null)[]> {\n    const provider = this.getProvider();\n    if (!provider) return texts.map(() => null);\n\n    const results: (number[] | null)[] = new Array(texts.length).fill(null);\n    for (let i = 0; i < texts.length; i += batchSize) {\n      const batch = texts.slice(i, i + batchSize);\n      const batchResults = await Promise.all(\n        batch.map((t) => this.callEmbed(t, provider, options.signal)),\n      );\n      for (let j = 0; j < batchResults.length; j++) {\n        results[i + j] = batchResults[j];\n      }\n    }\n    return results;\n  }\n\n  private getProvider(): ProviderConfig | null {\n    if (this.provider === undefined) {\n      this.provider = this.resolveProvider();\n    }\n    return this.provider;\n  }\n\n  private resolveProvider(): ProviderConfig | null {\n    if (!this.config.embeddingFallbackEnabled) return null;\n\n    const preferred = this.config.embeddingFallbackProvider;\n    const providers = preferred === \"auto\" ? [\"openai\", \"local\"] : [preferred];\n\n    for (const p of providers) {\n      if (p === \"openai\" && this.config.openaiApiKey) {\n        const baseUrl = this.config.openaiBaseUrl ?? \"https://api.openai.com/v1\";\n        return {\n          type: \"openai\",\n          model: DEFAULT_OPENAI_MODEL,\n          endpoint: `${baseUrl.replace(/\\/$/, \"\")}/embeddings`,\n          headers: {\n            \"Content-Type\": \"application/json\",\n            Authorization: `Bearer ${this.config.openaiApiKey}`,\n          },\n        };\n      }\n\n      if (p === \"local\" && this.config.localLlmEnabled && this.config.localLlmUrl) {\n        const base = this.config.localLlmUrl.replace(/\\/$/, \"\");\n        const endpoint = /\\/v1$/i.test(base) ? `${base}/embeddings` : `${base}/v1/embeddings`;\n        const headers: Record<string, string> = {\n          \"Content-Type\": \"application/json\",\n          ...(this.config.localLlmHeaders ?? {}),\n        };\n        if (this.config.localLlmApiKey && this.config.localLlmAuthHeader !== false) {\n          headers.Authorization = `Bearer ${this.config.localLlmApiKey}`;\n        }\n        return {\n          type: \"local\",\n          model:\n            this.config.embeddingFallbackModel ||\n            this.config.localLlmModel ||\n            DEFAULT_OPENAI_MODEL,\n          endpoint,\n          headers,\n        };\n      }\n    }\n\n    return null;\n  }\n\n  private async callEmbed(\n    input: string,\n    provider: ProviderConfig,\n    signal?: AbortSignal,\n  ): Promise<number[] | null> {\n    try {\n      const res = await fetch(provider.endpoint, {\n        method: \"POST\",\n        headers: provider.headers,\n        body: JSON.stringify({\n          model: provider.model,\n          input: input.slice(0, 8000),\n          encoding_format: \"float\",\n        }),\n        signal: withTimeoutSignal(signal, 30_000),\n      });\n      if (!res.ok) {\n        log.debug(`EmbedHelper request failed: ${provider.type} ${res.status}`);\n        return null;\n      }\n      const payload = (await res.json()) as any;\n      const vector = payload?.data?.[0]?.embedding;\n      if (!Array.isArray(vector)) return null;\n      return vector.map((n: unknown) => { const v = Number(n); return Number.isFinite(v) ? v : 0; });\n    } catch (err) {\n      if (isAbortError(err)) throw err;\n      log.debug(`EmbedHelper error: ${err}`);\n      return null;\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-FJ43PRLT.js → chunk-ORFGK3XI.js}

@@ -42,21 +42,25 @@ function resolveDefaultFaissScriptPath(fromModuleUrl = import.meta.url) {
 var FaissConversationIndexAdapter = class {
   constructor(config) {
     this.config = config;
+    if (!Number.isInteger(config.maxBatchSize) || config.maxBatchSize <= 0) {
+      throw new RangeError("FAISS maxBatchSize must be a positive integer");
+    }
     this.pythonBin = config.pythonBin && config.pythonBin.trim().length > 0 ? config.pythonBin.trim() : "python3";
     this.scriptPath = config.scriptPath && config.scriptPath.trim().length > 0 ? config.scriptPath.trim() : resolveDefaultFaissScriptPath();
     this.indexPath = path.isAbsolute(config.indexDir) ? config.indexDir : path.join(config.memoryDir, config.indexDir);
+    this.maxBatchSize = config.maxBatchSize;
     this.spawnFn = config.spawnFn ?? launchProcess;
   }
   config;
   pythonBin;
   scriptPath;
   indexPath;
+  maxBatchSize;
   spawnFn;
-  async upsertChunks(chunks) {
-    if (this.config.maxBatchSize <= 0) return 0;
+  async upsertChunks(chunks, options = {}) {
     let totalUpserted = 0;
-    for (let offset = 0; offset < chunks.length; offset += this.config.maxBatchSize) {
-      const batch = chunks.slice(offset, offset + this.config.maxBatchSize);
+    for (let offset = 0; offset < chunks.length; offset += this.maxBatchSize) {
+      const batch = chunks.slice(offset, offset + this.maxBatchSize);
       if (batch.length === 0) continue;
       const payload = {
         modelId: this.config.modelId,
@@ -67,7 +71,8 @@ var FaissConversationIndexAdapter = class {
           text: chunk.text,
           startTs: chunk.startTs,
           endTs: chunk.endTs
-        }))
+        })),
+        ...typeof options.retentionCutoffMs === "number" && Number.isFinite(options.retentionCutoffMs) ? { retentionCutoffMs: options.retentionCutoffMs } : {}
       };
       const result = await this.runCommand("upsert", payload, this.config.upsertTimeoutMs);
       const upserted = result.upserted;
@@ -138,12 +143,10 @@ var FaissConversationIndexAdapter = class {
     };
   }
   async rebuildChunks(chunks) {
-    if (this.config.maxBatchSize <= 0) return 0;
-    const firstBatch = chunks.slice(0, this.config.maxBatchSize);
     const rebuildPayload = {
       modelId: this.config.modelId,
       indexPath: this.indexPath,
-      chunks: firstBatch.map((chunk) => ({
+      chunks: chunks.map((chunk) => ({
         id: chunk.id,
         sessionKey: chunk.sessionKey,
         text: chunk.text,
@@ -156,11 +159,14 @@ var FaissConversationIndexAdapter = class {
     if (typeof rebuilt !== "number" || !Number.isFinite(rebuilt)) {
       throw new FaissAdapterError("FAISS sidecar produced malformed rebuild response", "malformed_output");
     }
-    const rebuildCount = Math.max(0, Math.floor(rebuilt));
-    const remaining = chunks.slice(firstBatch.length);
-    if (remaining.length === 0) return rebuildCount;
-    const upserted = await this.upsertChunks(remaining);
-    return rebuildCount + upserted;
+    const rebuildCount = Math.floor(rebuilt);
+    if (rebuildCount !== chunks.length) {
+      throw new FaissAdapterError(
+        `FAISS sidecar rebuilt ${rebuildCount} chunk(s), expected ${chunks.length}`,
+        "malformed_output"
+      );
+    }
+    return rebuildCount;
   }
   async runCommand(command, payload, timeoutMs) {
     const args = [this.scriptPath, command];
@@ -269,4 +275,4 @@ export {
   FaissConversationIndexAdapter,
   failOpenFaissHealth
 };
-//# sourceMappingURL=chunk-FJ43PRLT.js.map
+//# sourceMappingURL=chunk-ORFGK3XI.js.map

package/dist/chunk-ORFGK3XI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/conversation-index/faiss-adapter.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport path from \"node:path\";\nimport { log } from \"../logger.js\";\nimport type { ConversationChunk } from \"./chunker.js\";\nimport type { ConversationSearchResult } from \"./search.js\";\nimport { launchProcess } from \"../runtime/child-process.js\";\n\nexport interface FaissAdapterConfig {\n  memoryDir: string;\n  scriptPath?: string;\n  pythonBin?: string;\n  modelId: string;\n  indexDir: string;\n  upsertTimeoutMs: number;\n  searchTimeoutMs: number;\n  healthTimeoutMs: number;\n  maxBatchSize: number;\n  maxSearchK: number;\n  spawnFn?: typeof launchProcess;\n}\n\nexport interface FaissHealthResult {\n  ok: boolean;\n  status: \"ok\" | \"degraded\" | \"error\";\n  indexPath: string;\n  message?: string;\n  manifest?: {\n    version: number;\n    modelId: string;\n    normalizedModelId: string;\n    dimension: number;\n    chunkCount: number;\n    updatedAt: string;\n    lastSuccessfulRebuildAt: string;\n  };\n}\n\nexport interface FaissInspectResult extends FaissHealthResult {\n  metadata: {\n    chunkCount: number;\n    hasIndex: boolean;\n    hasMetadata: boolean;\n    hasManifest: boolean;\n  };\n}\n\ntype SidecarCommand = \"upsert\" | \"search\" | \"health\" | \"inspect\" | \"rebuild\";\n\nexport class FaissAdapterError extends Error {\n  constructor(message: string, readonly code: \"timeout\" | \"non_zero_exit\" | \"malformed_output\") {\n    super(message);\n    this.name = \"FaissAdapterError\";\n  }\n}\n\ninterface SidecarResult {\n  ok?: boolean;\n  error?: string;\n  upserted?: number;\n  rebuilt?: number;\n  status?: \"ok\" | \"degraded\" | \"error\";\n  manifest?: {\n    version?: number;\n    modelId?: string;\n    normalizedModelId?: string;\n    dimension?: number;\n    chunkCount?: number;\n    updatedAt?: string;\n    lastSuccessfulRebuildAt?: string;\n  };\n  results?: Array<{\n    path: string;\n    snippet: string;\n    score: number;\n  }>;\n  metadata?: {\n    chunkCount?: number;\n    hasIndex?: boolean;\n    hasMetadata?: boolean;\n    hasManifest?: boolean;\n  };\n}\n\nfunction parseSidecarManifest(result: SidecarResult): FaissHealthResult[\"manifest\"] | undefined {\n  const manifest = result.manifest;\n  if (\n    !manifest ||\n    typeof manifest.version !== \"number\" ||\n    typeof manifest.modelId !== \"string\" ||\n    typeof manifest.normalizedModelId !== \"string\" ||\n    typeof manifest.dimension !== \"number\" ||\n    typeof manifest.chunkCount !== \"number\" ||\n    typeof manifest.updatedAt !== \"string\" ||\n    typeof manifest.lastSuccessfulRebuildAt !== \"string\"\n  ) {\n    return undefined;\n  }\n\n  return {\n    version: manifest.version,\n    modelId: manifest.modelId,\n    normalizedModelId: manifest.normalizedModelId,\n    dimension: manifest.dimension,\n    chunkCount: manifest.chunkCount,\n    updatedAt: manifest.updatedAt,\n    lastSuccessfulRebuildAt: manifest.lastSuccessfulRebuildAt,\n  };\n}\n\nexport function resolveDefaultFaissScriptPath(fromModuleUrl: string = import.meta.url): string {\n  const currentFile = fileURLToPath(fromModuleUrl);\n  const moduleDir = path.dirname(currentFile);\n\n  // Source runtime: src/conversation-index/faiss-adapter.ts\n  if (moduleDir.endsWith(`${path.sep}conversation-index`)) {\n    return path.resolve(moduleDir, \"..\", \"..\", \"scripts\", \"faiss_index.py\");\n  }\n\n  // Bundled runtime: dist/index.js (or neighboring dist chunks)\n  return path.resolve(moduleDir, \"..\", \"scripts\", \"faiss_index.py\");\n}\n\nexport class FaissConversationIndexAdapter {\n  private readonly pythonBin: string;\n  private readonly scriptPath: string;\n  private readonly indexPath: string;\n  private readonly maxBatchSize: number;\n  private readonly spawnFn: typeof launchProcess;\n\n  constructor(private readonly config: FaissAdapterConfig) {\n    if (!Number.isInteger(config.maxBatchSize) || config.maxBatchSize <= 0) {\n      throw new RangeError(\"FAISS maxBatchSize must be a positive integer\");\n    }\n    this.pythonBin = config.pythonBin && config.pythonBin.trim().length > 0 ? config.pythonBin.trim() : \"python3\";\n    this.scriptPath = config.scriptPath && config.scriptPath.trim().length > 0\n      ? config.scriptPath.trim()\n      : resolveDefaultFaissScriptPath();\n    this.indexPath = path.isAbsolute(config.indexDir)\n      ? config.indexDir\n      : path.join(config.memoryDir, config.indexDir);\n    this.maxBatchSize = config.maxBatchSize;\n    this.spawnFn = config.spawnFn ?? launchProcess;\n  }\n\n  async upsertChunks(\n    chunks: ConversationChunk[],\n    options: { retentionCutoffMs?: number } = {},\n  ): Promise<number> {\n    let totalUpserted = 0;\n    for (let offset = 0; offset < chunks.length; offset += this.maxBatchSize) {\n      const batch = chunks.slice(offset, offset + this.maxBatchSize);\n      if (batch.length === 0) continue;\n      const payload = {\n        modelId: this.config.modelId,\n        indexPath: this.indexPath,\n        chunks: batch.map((chunk) => ({\n          id: chunk.id,\n          sessionKey: chunk.sessionKey,\n          text: chunk.text,\n          startTs: chunk.startTs,\n          endTs: chunk.endTs,\n        })),\n        ...(typeof options.retentionCutoffMs === \"number\" &&\n        Number.isFinite(options.retentionCutoffMs)\n          ? { retentionCutoffMs: options.retentionCutoffMs }\n          : {}),\n      };\n      const result = await this.runCommand(\"upsert\", payload, this.config.upsertTimeoutMs);\n      const upserted = result.upserted;\n      if (typeof upserted !== \"number\" || !Number.isFinite(upserted)) {\n        throw new FaissAdapterError(\"FAISS sidecar produced malformed upsert response\", \"malformed_output\");\n      }\n      totalUpserted += Math.max(0, Math.floor(upserted));\n    }\n    return totalUpserted;\n  }\n\n  async searchChunks(query: string, topK: number): Promise<ConversationSearchResult[]> {\n    const requestedTopK = Number.isFinite(topK) ? Math.floor(topK) : 0;\n    const boundedTopK = this.config.maxSearchK > 0\n      ? Math.max(0, Math.min(requestedTopK, this.config.maxSearchK))\n      : 0;\n    if (boundedTopK <= 0 || query.trim().length === 0) return [];\n    const payload = {\n      modelId: this.config.modelId,\n      indexPath: this.indexPath,\n      query,\n      topK: boundedTopK,\n    };\n    const result = await this.runCommand(\"search\", payload, this.config.searchTimeoutMs);\n    if (!Array.isArray(result.results)) {\n      throw new FaissAdapterError(\"FAISS sidecar produced malformed search response\", \"malformed_output\");\n    }\n    const rows = result.results;\n    return rows\n      .filter((row) =>\n        row &&\n        typeof row.path === \"string\" &&\n        typeof row.snippet === \"string\" &&\n        typeof row.score === \"number\"\n      )\n      .map((row) => ({ path: row.path, snippet: row.snippet, score: row.score }));\n  }\n\n  async health(): Promise<FaissHealthResult> {\n    const payload = {\n      modelId: this.config.modelId,\n      indexPath: this.indexPath,\n    };\n    const result = await this.runCommand(\"health\", payload, this.config.healthTimeoutMs);\n    if (result.status !== \"ok\" && result.status !== \"degraded\" && result.status !== \"error\") {\n      throw new FaissAdapterError(\"FAISS sidecar produced malformed health response\", \"malformed_output\");\n    }\n    return {\n      ok: result.ok === true,\n      status: result.status,\n      indexPath: this.indexPath,\n      message: typeof result.error === \"string\" && result.error.length > 0 ? result.error : undefined,\n      manifest: parseSidecarManifest(result),\n    };\n  }\n\n  async inspect(): Promise<FaissInspectResult> {\n    const payload = {\n      modelId: this.config.modelId,\n      indexPath: this.indexPath,\n    };\n    const result = await this.runCommand(\"inspect\", payload, this.config.healthTimeoutMs);\n    if (result.status !== \"ok\" && result.status !== \"degraded\" && result.status !== \"error\") {\n      throw new FaissAdapterError(\"FAISS sidecar produced malformed inspect response\", \"malformed_output\");\n    }\n    return {\n      ok: result.ok === true,\n      status: result.status,\n      indexPath: this.indexPath,\n      message: typeof result.error === \"string\" && result.error.length > 0 ? result.error : undefined,\n      manifest: parseSidecarManifest(result),\n      metadata: {\n        chunkCount:\n          result.metadata && typeof result.metadata.chunkCount === \"number\"\n            ? result.metadata.chunkCount\n            : 0,\n        hasIndex: result.metadata?.hasIndex === true,\n        hasMetadata: result.metadata?.hasMetadata === true,\n        hasManifest: result.metadata?.hasManifest === true,\n      },\n    };\n  }\n\n  async rebuildChunks(chunks: ConversationChunk[]): Promise<number> {\n    const rebuildPayload = {\n      modelId: this.config.modelId,\n      indexPath: this.indexPath,\n      chunks: chunks.map((chunk) => ({\n        id: chunk.id,\n        sessionKey: chunk.sessionKey,\n        text: chunk.text,\n        startTs: chunk.startTs,\n        endTs: chunk.endTs,\n      })),\n    };\n    const result = await this.runCommand(\"rebuild\", rebuildPayload, this.config.upsertTimeoutMs);\n    const rebuilt = result.rebuilt;\n    if (typeof rebuilt !== \"number\" || !Number.isFinite(rebuilt)) {\n      throw new FaissAdapterError(\"FAISS sidecar produced malformed rebuild response\", \"malformed_output\");\n    }\n    const rebuildCount = Math.floor(rebuilt);\n    if (rebuildCount !== chunks.length) {\n      throw new FaissAdapterError(\n        `FAISS sidecar rebuilt ${rebuildCount} chunk(s), expected ${chunks.length}`,\n        \"malformed_output\",\n      );\n    }\n    return rebuildCount;\n  }\n\n  private async runCommand(command: SidecarCommand, payload: object, timeoutMs: number): Promise<SidecarResult> {\n    const args = [this.scriptPath, command];\n    const child = this.spawnFn(this.pythonBin, args, {\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n    });\n    if (!child.stdin || !child.stdout || !child.stderr) {\n      throw new FaissAdapterError(\n        `FAISS sidecar missing stdio pipes (${command})`,\n        \"non_zero_exit\",\n      );\n    }\n    const stdinPipe = child.stdin;\n    const stdoutPipe = child.stdout;\n    const stderrPipe = child.stderr;\n\n    const stdoutChunks: Buffer[] = [];\n    const stderrChunks: Buffer[] = [];\n    let timedOut = false;\n\n    const timer = timeoutMs > 0\n      ? setTimeout(() => {\n        timedOut = true;\n        child.kill(\"SIGKILL\");\n      }, timeoutMs)\n      : undefined;\n\n    stdoutPipe.on(\"data\", (chunk: Buffer | string) => {\n      stdoutChunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n    });\n    stderrPipe.on(\"data\", (chunk: Buffer | string) => {\n      stderrChunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n    });\n\n    let code: number | null;\n    try {\n      stdinPipe.write(JSON.stringify(payload));\n      stdinPipe.end();\n\n      code = await new Promise<number | null>((resolve, reject) => {\n        const rejectAsProcessError = (err: unknown) => {\n          const msg = err instanceof Error ? err.message : String(err);\n          reject(new FaissAdapterError(`FAISS sidecar stream/process error (${command}): ${msg}`, \"non_zero_exit\"));\n        };\n        child.once(\"error\", rejectAsProcessError);\n        stdinPipe.once(\"error\", rejectAsProcessError);\n        child.once(\"close\", (exitCode) => resolve(exitCode));\n      });\n    } catch (err) {\n      if (err instanceof FaissAdapterError) throw err;\n      const msg = err instanceof Error ? err.message : String(err);\n      throw new FaissAdapterError(`FAISS sidecar stream/process error (${command}): ${msg}`, \"non_zero_exit\");\n    } finally {\n      if (timer) clearTimeout(timer);\n    }\n\n    const stdout = Buffer.concat(stdoutChunks).toString(\"utf-8\").trim();\n    const stderr = Buffer.concat(stderrChunks).toString(\"utf-8\").trim();\n\n    if (timedOut) {\n      throw new FaissAdapterError(\n        `FAISS sidecar command timed out (${command}, ${timeoutMs}ms)`,\n        \"timeout\",\n      );\n    }\n    if (code !== 0) {\n      throw new FaissAdapterError(\n        `FAISS sidecar exited non-zero (${command}, code=${code ?? \"null\"})${stderr ? `: ${stderr}` : \"\"}`,\n        \"non_zero_exit\",\n      );\n    }\n    if (stdout.length === 0) {\n      throw new FaissAdapterError(\n        `FAISS sidecar produced empty output (${command})`,\n        \"malformed_output\",\n      );\n    }\n\n    let parsed: SidecarResult;\n    try {\n      parsed = JSON.parse(stdout) as SidecarResult;\n    } catch {\n      throw new FaissAdapterError(\n        `FAISS sidecar produced malformed JSON (${command})`,\n        \"malformed_output\",\n      );\n    }\n\n    if (parsed.ok === false) {\n      const message = typeof parsed.error === \"string\" && parsed.error.length > 0\n        ? parsed.error\n        : `FAISS sidecar command failed (${command})`;\n      throw new FaissAdapterError(message, \"non_zero_exit\");\n    }\n    if (parsed.ok !== true) {\n      throw new FaissAdapterError(\n        `FAISS sidecar produced malformed success envelope (${command})`,\n        \"malformed_output\",\n      );\n    }\n\n    return parsed;\n  }\n}\n\nexport async function failOpenFaissHealth(\n  adapter: FaissConversationIndexAdapter | undefined,\n): Promise<FaissHealthResult> {\n  if (!adapter) {\n    return { ok: false, status: \"error\", indexPath: \"\", message: \"adapter-unavailable\" };\n  }\n  try {\n    return await adapter.health();\n  } catch (err) {\n    log.debug(`faiss adapter health failed (fail-open): ${err}`);\n    return { ok: false, status: \"error\", indexPath: \"\", message: \"adapter-error\" };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-DOM4GKSW.js → chunk-OZKVVUJB.js}

@@ -1,9 +1,9 @@
 import {
   looksLikeEngramJsonExport
-} from "./chunk-W4L6CZKA.js";
+} from "./chunk-2DL3OFLD.js";
 import {
   looksLikeEngramMdExport
-} from "./chunk-6H2TESSP.js";
+} from "./chunk-765K3SAT.js";
 
 // src/transfer/autodetect.ts
 import path from "path";
@@ -31,4 +31,4 @@ async function detectImportFormat(fromPath) {
 export {
   detectImportFormat
 };
-//# sourceMappingURL=chunk-DOM4GKSW.js.map
+//# sourceMappingURL=chunk-OZKVVUJB.js.map

package/dist/{chunk-3TNBOMQT.js → chunk-PCI747N2.js}

@@ -9,10 +9,10 @@ import {
 import {
   getCachedQmdSearch,
   setCachedQmdSearch
-} from "./chunk-PFV5C235.js";
+} from "./chunk-CPPS65WS.js";
 import {
   mergeEnv
-} from "./chunk-XIG5PDM7.js";
+} from "./chunk-JUC24CTX.js";
 import {
   log
 } from "./chunk-2ODBA7MQ.js";
@@ -1351,9 +1351,10 @@ var QmdClient = class _QmdClient {
     return args;
   }
   async search(query, collection, maxResults, options, execution) {
-    if (!this.isAvailable()) return [];
     const trimmed = query.trim();
     if (!trimmed) return [];
+    await this.maybeProbeDaemon();
+    if (!this.isAvailable()) return [];
     const col = collection ?? this.collection;
     const n = maxResults ?? this.maxResults;
     const searchOptions = this.resolveSearchOptions(options);
@@ -1364,7 +1365,6 @@ var QmdClient = class _QmdClient {
       log.debug(`QMD search cache hit (${cached.length} results)`);
       return cached;
     }
-    await this.maybeProbeDaemon();
     if (this.daemonAvailable) {
       let results;
       try {
@@ -1394,12 +1394,12 @@ var QmdClient = class _QmdClient {
     return subprocessResults;
   }
   async searchGlobal(query, maxResults, execution) {
-    if (!this.isAvailable()) return [];
     const trimmed = query.trim();
     if (!trimmed) return [];
+    await this.maybeProbeDaemon();
+    if (!this.isAvailable()) return [];
     const n = maxResults ?? 6;
     const searchOptions = this.resolveSearchOptions();
-    await this.maybeProbeDaemon();
     if (this.daemonAvailable) {
       let results;
       try {
@@ -1429,12 +1429,12 @@ var QmdClient = class _QmdClient {
    * BM25 keyword search (fast, ~0.3s). Uses `qmd search`.
    */
   async bm25Search(query, collection, maxResults, execution) {
-    if (!this.isAvailable()) return [];
     const trimmed = query.trim();
     if (!trimmed) return [];
+    await this.maybeProbeDaemon();
+    if (!this.isAvailable()) return [];
     const col = collection ?? this.collection;
     const n = maxResults ?? this.maxResults;
-    await this.maybeProbeDaemon();
     if (this.daemonAvailable && this.daemonSession) {
       let results;
       try {
@@ -1464,12 +1464,12 @@ var QmdClient = class _QmdClient {
    * Vector similarity search (~3-4s). Uses `qmd vsearch`.
    */
   async vectorSearch(query, collection, maxResults, execution) {
-    if (!this.isAvailable()) return [];
     const trimmed = query.trim();
     if (!trimmed) return [];
+    await this.maybeProbeDaemon();
+    if (!this.isAvailable()) return [];
     const col = collection ?? this.collection;
     const n = maxResults ?? this.maxResults;
-    await this.maybeProbeDaemon();
     if (this.daemonAvailable && this.daemonSession) {
       let results;
       try {
@@ -1944,11 +1944,11 @@ var QmdClient = class _QmdClient {
       log.warn(`QMD embed failed for collection ${name}: ${msg}`);
     }
   }
-  async ensureCollection(memoryDir) {
+  async ensureCollection(memoryDir, execution) {
     if (this.available === false && !this.daemonAvailable) return "unknown";
     if (this.available === false) return "skipped";
     try {
-      const { stdout } = await this.runQmdCommand(["collection", "list"], QMD_TIMEOUT_MS);
+      const { stdout } = await this.runQmdCommand(["collection", "list"], QMD_TIMEOUT_MS, execution?.signal);
       const collectionRegex = new RegExp(
         `^${this.collection}\\s+\\(qmd://`,
         "m"
@@ -1982,4 +1982,4 @@ export {
   getQmdCommandName,
   QmdClient
 };
-//# sourceMappingURL=chunk-3TNBOMQT.js.map
+//# sourceMappingURL=chunk-PCI747N2.js.map