@desplega.ai/agent-swarm 1.92.0 → 1.92.2

package/src/be/memory/reranker.ts

@@ -1,7 +1,10 @@
+import type { AgentMemorySource } from "@/types";
 import {
   ACCESS_BOOST_MAX_MULTIPLIER,
   ACCESS_BOOST_RECENCY_WINDOW_HOURS,
+  RECENCY_DECAY_HALF_LIFE,
   RECENCY_DECAY_HALF_LIFE_DAYS,
+  SOURCE_QUALITY_MULTIPLIER,
 } from "./constants";
 import type { MemoryCandidate, RerankOptions } from "./types";
 
@@ -9,13 +12,16 @@ const MS_PER_DAY = 1000 * 60 * 60 * 24;
 const MS_PER_HOUR = 1000 * 60 * 60;
 
 /**
- * Exponential decay based on age. A memory at exactly HALF_LIFE_DAYS old
- * gets multiplied by 0.5. Fresh memories get ~1.0.
+ * Exponential decay based on age and memory source.
+ * Source-aware: manual memories have no decay (Infinity half-life),
+ * file_index = 180d, task_completion = 14d, session_summary = 7d.
  */
-export function recencyDecay(createdAt: string, now: Date): number {
+export function recencyDecay(createdAt: string, now: Date, source?: AgentMemorySource): number {
+  const halfLife = source ? RECENCY_DECAY_HALF_LIFE[source] : RECENCY_DECAY_HALF_LIFE_DAYS;
+  if (!Number.isFinite(halfLife)) return 1.0;
   const ageDays = (now.getTime() - new Date(createdAt).getTime()) / MS_PER_DAY;
   if (ageDays <= 0) return 1.0;
-  return 2 ** (-ageDays / RECENCY_DECAY_HALF_LIFE_DAYS);
+  return 2 ** (-ageDays / halfLife);
 }
 
 /**
@@ -31,6 +37,14 @@ export function accessBoost(accessedAt: string, accessCount: number, now: Date):
   return boost;
 }
 
+/**
+ * Source-quality multiplier. Manual memories get a 1.5× boost,
+ * session summaries get 0.5×. Unknown sources default to 1.0.
+ */
+export function sourceQuality(source: AgentMemorySource): number {
+  return SOURCE_QUALITY_MULTIPLIER[source] ?? 1.0;
+}
+
 /**
  * Beta-Binomial usefulness factor for reranking.
  *
@@ -56,33 +70,37 @@ export function usefulness(alpha: number, beta: number): number {
 }
 
 /**
- * Final score combining similarity, recency decay, access boost, and
- * Beta-Binomial usefulness. With default Beta(1,1) and default
- * MEMORY_DEMOTION_FLOOR=1.0, the usefulness factor is exactly 1.0 and this
- * computation matches the pre-rater behaviour byte-for-byte.
- *
- * v2: optional edge-aware boost — see thoughts/taras/plans/2026-05-05-memory-rater-v1.5/root.md
+ * Final score combining similarity, recency decay, access boost,
+ * source quality, and Beta-Binomial usefulness.
  */
 export function computeScore(candidate: MemoryCandidate, now: Date): number {
   return (
     candidate.similarity *
-    recencyDecay(candidate.createdAt, now) *
+    recencyDecay(candidate.createdAt, now, candidate.source) *
     accessBoost(candidate.accessedAt, candidate.accessCount, now) *
+    sourceQuality(candidate.source) *
     usefulness(candidate.alpha, candidate.beta)
   );
 }
 
 /**
- * Rerank candidates by combining similarity with recency and access signals.
- * Returns the top `limit` candidates sorted by final score.
+ * Rerank candidates by combining similarity with recency, source quality,
+ * and access signals. Returns the top `limit` candidates sorted by composite
+ * score. Preserves raw similarity in `rawSimilarity` and sets `compositeScore`.
  */
 export function rerank(candidates: MemoryCandidate[], options: RerankOptions): MemoryCandidate[] {
   const { limit, now = new Date() } = options;
 
-  const scored = candidates.map((candidate) => ({
-    ...candidate,
-    similarity: computeScore(candidate, now),
-  }));
+  const scored = candidates.map((candidate) => {
+    const rawSimilarity = candidate.similarity;
+    const compositeScore = computeScore(candidate, now);
+    return {
+      ...candidate,
+      rawSimilarity,
+      compositeScore,
+      similarity: compositeScore,
+    };
+  });
 
   scored.sort((a, b) => b.similarity - a.similarity);
   return scored.slice(0, limit);

package/src/be/memory/types.ts

@@ -22,11 +22,17 @@ export interface MemoryStore {
   peek(id: string): AgentMemory | null;
   search(embedding: Float32Array, agentId: string, options: MemorySearchOptions): MemoryCandidate[];
   list(agentId: string, options: MemoryListOptions): AgentMemory[];
+  isSourceProtected(source: AgentMemorySource): boolean;
+  listForCuration(
+    agentId?: string,
+  ): { id: string; source: string; name: string; createdAt: string }[];
   listForReembedding(options?: { agentId?: string }): { id: string; content: string }[];
   delete(id: string): boolean;
   deleteBySourcePath(sourcePath: string, agentId: string): number;
+  purgeExpired(): number;
   updateEmbedding(id: string, embedding: Float32Array, model: string): void;
   getStats(agentId: string): MemoryStats;
+  getHealth(): MemoryHealth;
 }
 
 // ============================================================================
@@ -49,6 +55,10 @@ export interface MemoryInput {
 
 export interface MemoryCandidate extends AgentMemory {
   similarity: number;
+  /** Raw cosine similarity before reranking (preserved for diagnostics). */
+  rawSimilarity?: number;
+  /** Final composite score after reranking (recency × source × usefulness × access). */
+  compositeScore?: number;
   accessCount: number;
   expiresAt: string | null;
   embeddingModel: string | null;
@@ -81,6 +91,39 @@ export interface MemoryStats {
   expired: number;
 }
 
+export interface MemoryHealth {
+  sqliteVec: {
+    extensionLoaded: boolean;
+    tableExists: boolean;
+    initialized: boolean;
+    vectorDimensions: number;
+    distanceMetric: "cosine";
+    schema: string | null;
+    lastPopulate: MemoryVecPopulateStats | null;
+  };
+  counts: {
+    total: number;
+    withEmbedding: number;
+    validEmbedding: number;
+    invalidEmbedding: number;
+    searchable: number;
+    memoryVec: number;
+    missingFromVec: number;
+    extraInVec: number;
+  };
+  retrievalMode: "vec" | "fallback";
+  reasons: string[];
+}
+
+export interface MemoryVecPopulateStats {
+  attempted: number;
+  inserted: number;
+  skippedInvalidDimensions: number;
+  failed: number;
+  beforeCount: number;
+  afterCount: number;
+}
+
 export interface RerankOptions {
   limit: number;
   now?: Date;

package/src/be/migrations/084_script_run_journal_duration.sql

@@ -0,0 +1,5 @@
+-- Script Workflows: record real per-step wall-clock duration (ms) measured in the
+-- subprocess, so the dashboard can render a truthful waterfall. Nullable — existing
+-- journal rows stay NULL and are treated as "unmeasured".
+
+ALTER TABLE script_run_journal ADD COLUMN durationMs INTEGER;

package/src/be/migrations/085_script_runs_kind.sql

@@ -0,0 +1,9 @@
+-- Discriminate durable script-workflow runs from inline/one-off `/api/scripts/run`
+-- executions so both can be persisted in the same script_runs table.
+-- Existing rows are all durable workflow runs, hence the 'workflow' default.
+
+ALTER TABLE script_runs
+  ADD COLUMN kind TEXT NOT NULL DEFAULT 'workflow'
+  CHECK(kind IN ('workflow', 'inline'));
+
+CREATE INDEX IF NOT EXISTS idx_script_runs_kind ON script_runs(kind);

package/src/be/migrations/086_pages_default_authed.sql

@@ -0,0 +1,64 @@
+-- Flip the SQL-level default for new page rows from public to authed.
+-- Existing row values are preserved; this only changes behavior when a caller
+-- omits authMode at the database layer.
+
+CREATE TABLE pages_new (
+  id           TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  agentId      TEXT NOT NULL,
+  slug         TEXT NOT NULL,
+  title        TEXT NOT NULL,
+  description  TEXT,
+  contentType  TEXT NOT NULL CHECK (contentType IN ('text/html','application/json')),
+  authMode     TEXT NOT NULL DEFAULT 'authed' CHECK (authMode IN ('public','authed','password')),
+  passwordHash TEXT,
+  body         TEXT NOT NULL,
+  needsCredentials TEXT,
+  createdAt    TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updatedAt    TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  view_count   INTEGER NOT NULL DEFAULT 0,
+  created_by   TEXT REFERENCES users(id),
+  updated_by   TEXT REFERENCES users(id),
+  UNIQUE (agentId, slug)
+);
+
+INSERT INTO pages_new (
+  id,
+  agentId,
+  slug,
+  title,
+  description,
+  contentType,
+  authMode,
+  passwordHash,
+  body,
+  needsCredentials,
+  createdAt,
+  updatedAt,
+  view_count,
+  created_by,
+  updated_by
+)
+SELECT
+  id,
+  agentId,
+  slug,
+  title,
+  description,
+  contentType,
+  authMode,
+  passwordHash,
+  body,
+  needsCredentials,
+  createdAt,
+  updatedAt,
+  view_count,
+  created_by,
+  updated_by
+FROM pages;
+
+DROP TABLE pages;
+ALTER TABLE pages_new RENAME TO pages;
+
+CREATE INDEX IF NOT EXISTS idx_pages_agentId ON pages(agentId);
+CREATE INDEX IF NOT EXISTS idx_pages_updatedAt ON pages(updatedAt DESC);
+CREATE INDEX IF NOT EXISTS idx_pages_created_by ON pages(created_by) WHERE created_by IS NOT NULL;

package/src/be/migrations/087_skill_files.sql

@@ -0,0 +1,19 @@
+-- Migration 087: skill_files table for complex (multi-file) skills.
+-- Additive only: simple skills have zero rows and existing behavior is unchanged.
+
+CREATE TABLE IF NOT EXISTS skill_files (
+  id TEXT PRIMARY KEY,
+  skillId TEXT NOT NULL REFERENCES skills(id) ON DELETE CASCADE,
+  path TEXT NOT NULL,
+  content TEXT NOT NULL,
+  mimeType TEXT NOT NULL DEFAULT 'text/plain',
+  isBinary INTEGER NOT NULL DEFAULT 0,
+  size INTEGER,
+  createdAt TEXT NOT NULL,
+  lastUpdatedAt TEXT NOT NULL,
+  created_by TEXT REFERENCES users(id),
+  updated_by TEXT REFERENCES users(id),
+  UNIQUE(skillId, path)
+);
+
+CREATE INDEX IF NOT EXISTS idx_skill_files_skill ON skill_files(skillId);