@orquentra/codebuddy 2.6.2 → 2.7.0

package/dist/{chunk-2XDPKFUW.js → chunk-AK2UAE32.js}

@@ -13,11 +13,7 @@ import {
   sessionSummaries,
   shares,
   validSearchVector
-} from "./chunk-S6VEG4S2.js";
-import {
-  REDACTED,
-  redactPersisted
-} from "./chunk-GDJH7XJC.js";
+} from "./chunk-JUAFCLRB.js";
 import {
   clampBudgetForCallerModel,
   computeContentHash,
@@ -25,13 +21,17 @@ import {
   countTokens,
   generateEntityId,
   generateSessionId
-} from "./chunk-XBJQKCLU.js";
+} from "./chunk-CAEPHLHC.js";
 import {
   OpenRouterEmbeddingProvider
-} from "./chunk-JFDRBPYF.js";
+} from "./chunk-6JCKMIQY.js";
 import {
   LocalModelProvider
-} from "./chunk-IBLJOHJL.js";
+} from "./chunk-3QGW53GD.js";
+import {
+  REDACTED,
+  redactPersisted
+} from "./chunk-AL6VBTNA.js";
 import {
   DEFAULT_CLOUD_EMBEDDING_MODELS,
   DEFAULT_EMBEDDING_MODELS,
@@ -39,7 +39,7 @@ import {
   EMBEDDING_DIMENSIONS,
   assertCompatibleEmbeddingModels,
   getModelDefinition
-} from "./chunk-JPHJBCZB.js";
+} from "./chunk-HPOR6YXA.js";
 import {
   MISSING_DATABASE_URL,
   checkConfigPermissions,
@@ -49,7 +49,7 @@ import {
   migrateLegacyNamespace,
   readConfigFile,
   redactSecrets
-} from "./chunk-5KZY6OTG.js";
+} from "./chunk-KNR2P2UY.js";
 
 // src/db/bootstrap.ts
 async function enablePgvector(sql2) {
@@ -252,12 +252,20 @@ var PostgresMemoryRepository = class {
   }
   async writeFact(input) {
     return this.db.transaction(async (tx) => {
+      const key = input.fact.idempotencyKey;
       const existing = await tx.select({ id: facts.id }).from(facts).where(
         and(
           eq(facts.namespaceId, input.fact.namespaceId),
-          eq(facts.contentHash, input.fact.contentHash)
+          key ? (
+            // Rows written before 0006 stored the key as their content hash.
+            or(
+              eq(facts.idempotencyKey, key),
+              eq(facts.contentHash, key),
+              eq(facts.contentHash, input.fact.contentHash)
+            )
+          ) : eq(facts.contentHash, input.fact.contentHash)
         )
-      ).limit(1);
+      ).orderBy(key ? sql`(${facts.idempotencyKey} = ${key}) desc nulls last` : facts.id).limit(1);
       const existingRow = existing[0];
       if (existingRow) {
         return {
@@ -280,6 +288,7 @@ var PostgresMemoryRepository = class {
         content: input.fact.content,
         contentHash: input.fact.contentHash,
         propositionKey: input.fact.propositionKey ?? null,
+        idempotencyKey: input.fact.idempotencyKey ?? null,
         confidence: String(input.fact.confidence ?? 1),
         sourceDeleted: input.fact.sourceDeleted ?? false,
         supersededBy: input.fact.supersededBy ?? null,
@@ -370,6 +379,7 @@ var PostgresMemoryRepository = class {
         sourceDeleted: fact.sourceDeleted,
         supersededBy: fact.supersededBy,
         propositionKey: fact.propositionKey ?? null,
+        idempotencyKey: fact.idempotencyKey ?? null,
         createdByAgent: fact.createdByAgent ?? null,
         createdAt: fact.createdAt,
         fileBacked: true
@@ -381,7 +391,7 @@ var PostgresMemoryRepository = class {
         return { status: "inserted" };
       }
       const contentChanged = existing.content !== fact.content;
-      const metadataChanged = existing.subject !== values.subject || existing.predicate !== values.predicate || existing.object !== values.object || Number(existing.confidence) !== Number(fact.confidence.toFixed(4)) || existing.sourceInteractionId !== values.sourceInteractionId || existing.sourceDeleted !== values.sourceDeleted || existing.supersededBy !== values.supersededBy || existing.propositionKey !== values.propositionKey || existing.createdByAgent !== values.createdByAgent || existing.createdAt.getTime() !== values.createdAt.getTime();
+      const metadataChanged = existing.subject !== values.subject || existing.predicate !== values.predicate || existing.object !== values.object || Number(existing.confidence) !== Number(fact.confidence.toFixed(4)) || existing.sourceInteractionId !== values.sourceInteractionId || existing.sourceDeleted !== values.sourceDeleted || existing.supersededBy !== values.supersededBy || existing.propositionKey !== values.propositionKey || existing.idempotencyKey !== values.idempotencyKey || existing.createdByAgent !== values.createdByAgent || existing.createdAt.getTime() !== values.createdAt.getTime();
       if (contentChanged || metadataChanged || !existing.fileBacked) {
         await tx.update(facts).set({ ...values, updatedAt: sql`now()` }).where(and(eq(facts.namespaceId, fact.namespaceId), eq(facts.id, fact.id)));
       }
@@ -1358,8 +1368,10 @@ var DefaultPolicy = class {
       if (!isEligibleMemory(fact)) continue;
       const candidate = factCandidate(fact, useFallback ? fact.score : 0.35 * fact.score);
       const existing = byKey.get(candidate.key);
-      if (existing) existing.score = Math.max(existing.score, candidate.score);
-      else byKey.set(candidate.key, candidate);
+      if (existing) {
+        existing.score = Math.max(existing.score, candidate.score);
+        existing.lexical = true;
+      } else byKey.set(candidate.key, { ...candidate, lexical: true });
     }
     candidates = [...byKey.values()];
     candidates = this.applyRecencyFloor(candidates, recencyInteractions);
@@ -1379,7 +1391,8 @@ var DefaultPolicy = class {
         itemsSkipped += 1;
         continue;
       }
-      if (!candidate.isRecencyFloor && candidate.score < this.minVectorScore && !useFallback) {
+      const floor = candidate.lexical || input.relevanceFloor === void 0 ? this.minVectorScore : Math.max(this.minVectorScore, input.relevanceFloor);
+      if (!candidate.isRecencyFloor && candidate.score < floor && !useFallback) {
         bump(skipReasons, "low_score");
         itemsSkipped += 1;
         continue;
@@ -2049,7 +2062,8 @@ var providerSchema = z.object({
   type: z.enum(["local", "huggingface", "openrouter"]),
   apiKey: z.string().min(1).optional(),
   model: z.string().min(1).optional(),
-  relevanceFloor: z.number().min(-1).max(1).optional()
+  relevanceFloor: z.number().min(-1).max(1).optional(),
+  recallFloor: z.number().min(-1).max(1).optional()
 });
 var codeBuddyConfigSchema = z.object({
   postgresUrl: z.string().min(1, "postgresUrl is required"),
@@ -2343,6 +2357,9 @@ var CodeBuddy = class {
     if (!content || content.length === 0) {
       throw new Error("remember: content must not be empty.");
     }
+    if (input.idempotencyKey !== void 0 && (input.idempotencyKey.length === 0 || input.idempotencyKey.length > 200)) {
+      throw new Error("remember: idempotencyKey must be 1\u2013200 characters.");
+    }
     const result = await this.repo.withSessionLock(
       namespaceId,
       sessionId,
@@ -2387,7 +2404,8 @@ var CodeBuddy = class {
       conflictMode: input.conflictMode ?? "all",
       queryEmbedding,
       repository: this.repo,
-      ...input.callerModel !== void 0 ? { callerModel: input.callerModel } : {}
+      ...input.callerModel !== void 0 ? { callerModel: input.callerModel } : {},
+      relevanceFloor: this.recallFloor(queryEmbedding?.space.model)
     };
     const planned = await this.tracer.withSpan(
       "codebuddy.recall",
@@ -2406,6 +2424,11 @@ var CodeBuddy = class {
     }
     return planned;
   }
+  /** Cosine floor for an explicit `recall` of the query's embedding model. */
+  recallFloor(model) {
+    const definition = model ? getModelDefinition(model) : void 0;
+    return this.config.provider.recallFloor ?? definition?.recallFloor ?? this.config.provider.relevanceFloor ?? definition?.relevanceFloor;
+  }
   /**
    * Dense evidence for file facts supplied by the context engine: the cosine of
    * each fact whose stored vector clears the embedding model's calibrated
@@ -2763,7 +2786,7 @@ var CodeBuddy = class {
       content: input.content
     });
     const content = input.type === "fact" ? claim.content : input.content;
-    const contentHash = input.idempotencyKey ?? (input.type === "fact" ? factContentHash(this.config.namespace, ownerId, content) : computeContentHash(this.config.namespace, input.sessionId, input.content));
+    const contentHash = input.type === "fact" ? factContentHash(this.config.namespace, ownerId, content) : input.idempotencyKey ?? computeContentHash(this.config.namespace, input.sessionId, input.content);
     const tokenCount = estimateTokenCount(content);
     const embeddingId = generateEntityId("emb");
     const embedding = {
@@ -2803,6 +2826,7 @@ var CodeBuddy = class {
         subject: claim.subject,
         predicate: claim.predicate,
         object: claim.object,
+        ...input.idempotencyKey !== void 0 ? { idempotencyKey: input.idempotencyKey } : {},
         ...input.agentId !== void 0 ? { createdByAgent: input.agentId } : {}
       };
       const result2 = await this.repo.writeFact({ fact, embedding, audit });
@@ -2826,6 +2850,7 @@ var CodeBuddy = class {
           createdByAgent: input.agentId ?? null,
           sourceInteractionId: fact.sourceInteractionId ?? null,
           sourceDeleted: false,
+          ...input.idempotencyKey !== void 0 ? { idempotencyKey: input.idempotencyKey } : {},
           content: fact.content
         });
       }
@@ -2890,6 +2915,7 @@ var CodeBuddy = class {
         sourceDeleted: file.sourceDeleted,
         supersededBy: file.supersededBy,
         propositionKey: file.propositionKey ?? null,
+        idempotencyKey: file.idempotencyKey ?? null,
         createdByAgent: file.createdByAgent ?? void 0,
         createdAt: new Date(file.createdAt)
       },
@@ -3294,4 +3320,4 @@ export {
   inspectNamespace,
   runDoctor
 };
-//# sourceMappingURL=chunk-2XDPKFUW.js.map
+//# sourceMappingURL=chunk-AK2UAE32.js.map