qlogicagent 2.10.13 → 2.10.14

package/dist/types/skills/memory/local-memory-provider.d.ts

@@ -9,7 +9,7 @@
  *   - Without embedding: FTS-only search (still useful for exact/keyword matches)
  */
 import type { MemoryProvider, MemorySearchResult, MemorySearchOptions, MemoryIngestMessage, MemoryIngestOptions } from "../../protocol/wire/index.js";
-import type { SqliteDatabase } from "./local-store.js";
+import type { MemoryUpdateInput, SqliteDatabase } from "./local-store.js";
 import { type LocalEmbeddingConfig } from "./local-embedding.js";
 /** A pre-extracted memory item ready to be stored (no LLM needed). */
 export interface ExtractedMemoryItem {
@@ -38,6 +38,9 @@ export declare class LocalMemoryProvider implements MemoryProvider {
     private dbPath;
     constructor(config: LocalMemoryProviderConfig);
     private resolveUserId;
+    private buildEmbedding;
+    private findExistingDuplicate;
+    private insertDeduped;
     search(query: string, userId: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
     ingest(messages: MemoryIngestMessage[], userId: string, options?: MemoryIngestOptions): Promise<void>;
     addText(text: string, userId: string, options?: MemoryIngestOptions & {
@@ -47,6 +50,7 @@ export declare class LocalMemoryProvider implements MemoryProvider {
         memoriesAdded: number;
     }>;
     remove(memoryId: string): Promise<boolean>;
+    update(memoryId: string, input: MemoryUpdateInput): Promise<boolean>;
     /**
      * Ingest pre-extracted memory items (no LLM needed).
      * Compatible with qmemory-adapter's ingestExtracted interface.
@@ -129,6 +133,19 @@ export declare class LocalMemoryProvider implements MemoryProvider {
     /**
      * Find memories by event date (±tolerance). For temporal context retrieval.
      */
+    /**
+     * Return the final atlas payload: a bounded interactive record window plus
+     * whole-history buckets/clusters for large timelines.
+     */
+    getAtlas(userId: string, options?: {
+        pageSize?: number;
+        windowStartAt?: number;
+        windowEndAt?: number;
+        windowCenterAt?: number;
+        bucketCount?: number;
+        clusterLimit?: number;
+        activeOnly?: boolean;
+    }): import("./local-store.js").MemoryAtlasResult;
     findByEventDate(userId: string, targetDate: string, toleranceDays?: number): import("./local-store.js").MemorySearchHit[];
     /**
      * Find related memories (event continuity detection).
@@ -200,8 +217,4 @@ export declare class LocalMemoryProvider implements MemoryProvider {
      */
     close(): void;
 }
-/**
- * Create a local memory provider (convenience factory).
- * Caller must provide the createDatabase factory to avoid hard dependency on better-sqlite3.
- */
 export declare function createLocalMemoryProvider(config: LocalMemoryProviderConfig): LocalMemoryProvider;

package/dist/types/skills/memory/local-store.d.ts

@@ -42,6 +42,15 @@ export interface MemoryInsertInput {
     tags?: string[];
     embedding?: Float32Array;
 }
+export interface MemoryUpdateInput {
+    text?: string;
+    category?: string;
+    importance?: number;
+    source?: string;
+    eventDate?: string;
+    tags?: string[];
+    embedding?: Float32Array | null;
+}
 export interface MemorySearchHit {
     id: string;
     text: string;
@@ -50,6 +59,45 @@ export interface MemorySearchHit {
     importance: number;
     metadata: Record<string, unknown>;
 }
+export interface MemoryAtlasBucket {
+    id: string;
+    startAt: number;
+    endAt: number;
+    count: number;
+    avgImportance: number;
+    avgConfidence: number;
+    topCategory: string;
+}
+export interface MemoryAtlasCluster {
+    id: string;
+    label: string;
+    kind: "source" | "category" | "tag";
+    count: number;
+    startAt: number;
+    endAt: number;
+    avgImportance: number;
+    avgConfidence: number;
+    topCategory: string;
+}
+export interface MemoryAtlasWindowCursor {
+    startAt: number;
+    endAt: number;
+    centerAt: number;
+    pageSize: number;
+    hasBefore: boolean;
+    hasAfter: boolean;
+}
+export interface MemoryAtlasResult {
+    totalCount: number;
+    records: MemoryRecord[];
+    buckets: MemoryAtlasBucket[];
+    clusters: MemoryAtlasCluster[];
+    windowCursor: MemoryAtlasWindowCursor | null;
+    timeRange: {
+        startAt: number;
+        endAt: number;
+    } | null;
+}
 export interface SqliteDatabase {
     exec(sql: string): void;
     prepare(sql: string): SqliteStatement;
@@ -89,6 +137,24 @@ export declare class LocalMemoryStore {
      * Get all memories for a user (paginated).
      */
     listByUser(userId: string, page?: number, pageSize?: number, activeOnly?: boolean): MemoryRecord[];
+    /**
+     * Return a windowed atlas payload for large-history visualization.
+     *
+     * `records` are only the interactive window. `buckets` and `clusters` summarize
+     * the whole history so the UI can render distant history as star dust /
+     * aggregate galaxies without loading every memory as an interactive object.
+     */
+    getAtlas(userId: string, options?: {
+        pageSize?: number;
+        windowStartAt?: number;
+        windowEndAt?: number;
+        windowCenterAt?: number;
+        bucketCount?: number;
+        clusterLimit?: number;
+        activeOnly?: boolean;
+    }): MemoryAtlasResult;
+    private getAtlasBuckets;
+    private getAtlasClusters;
     /**
      * Get a single memory by ID.
      */
@@ -97,6 +163,10 @@ export declare class LocalMemoryStore {
      * Update memory text and bump updatedAt.
      */
     updateText(id: string, text: string, embedding?: Float32Array): boolean;
+    /**
+     * Update editable memory fields and bump updatedAt.
+     */
+    update(id: string, input: MemoryUpdateInput): boolean;
     /**
      * Delete a memory by ID.
      */

package/dist/types/skills/memory/memory-provider-factory.d.ts

@@ -29,19 +29,13 @@ export declare function createMemoryProvider(config: MemoryProviderFactoryConfig
  * Used by stdio-server to auto-configure memory.
  *
  * Environment variables:
- *   QMEMORY_EMBEDDING_STRATEGY — "auto" | "api" | "onnx" | "none" (default: "none")
- *     - "auto": detect LLM provider → use their embedding API directly
- *   QMEMORY_EMBEDDING_BASE_URL — required when strategy=api
- *   QMEMORY_EMBEDDING_API_KEY  — required when strategy=api
- *   QMEMORY_EMBEDDING_MODEL    — model name (default: "text-embedding-3-small")
- *   QMEMORY_ONNX_MODEL_ID      — model for ONNX (default: "Xenova/bge-small-zh-v1.5")
+ *   QMEMORY_EMBEDDING_TIMEOUT_MS — embedding request timeout (default: 1500)
  *   QMEMORY_USER_PREFIX        — user ID prefix for multi-tenant
  *
- * Auto-cascade (strategy=auto):
- *   Layer 0: LLM provider's embedding API (detected from LLM_PROVIDER + *_API_KEY)
- *   Layer 1: Self-hosted TEI bge-m3 (QMEMORY_TEI_URL / QMEMORY_TEI_FALLBACK_URL)
- *   Layer 2: ONNX local (@xenova/transformers)
- *   Layer 3: FTS5 pure text (NullEmbeddingProvider)
+ * Fixed embedding resolution:
+ *   Layer 0: Explicit ModelRegistry "embedding" binding
+ *   Layer 1: LLM Router default embedding endpoint (BAAI/bge-m3)
+ *   Layer 2: FTS5 pure text (NullEmbeddingProvider)
  *
  * @param projectRoot — Project root for local storage path
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.10.13",
+  "version": "2.10.14",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -70,9 +70,6 @@
     "pino": "^9.6.0",
     "pino-pretty": "^13.0.0"
   },
-  "optionalDependencies": {
-    "@xenova/transformers": "^2.17.2"
-  },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.15.0",