qlogicagent 2.18.9 → 2.18.10

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

@@ -1,325 +0,0 @@
-/**
- * Local Memory Provider - implements MemoryProvider using local SQLite store.
- *
- * This is the default provider for desktop use. Requires no external service.
- * Uses FTS5 for keyword search and optionally embedding API for vector search.
- *
- * Falls back gracefully:
- *   - With embedding API configured: hybrid search (FTS + vector)
- *   - Without embedding: FTS-only search (still useful for exact/keyword matches)
- */
-import type { MemoryProvider, MemorySearchResult, MemorySearchOptions, MemoryIngestOptions } from "../../protocol/wire/index.js";
-import type { MemoryClaimRecord, MemoryConflictRecord, MemoryProposalRecord, MemoryUpdateInput, SqliteDatabase } from "./local-store.js";
-import { type AdoptedAttachment } from "./memory-attachment-store.js";
-import { type LocalEmbeddingConfig } from "./local-embedding.js";
-import { type ExtractedMemoryItem, type MemoryConsolidationResult } from "./memory-consolidation.js";
-export type { ExtractedMemoryItem } from "./memory-consolidation.js";
-export interface LocalMemoryProviderConfig {
-    /** Active owner profile. Determines the physical SQLite database location. */
-    ownerUserId?: string;
-    /** Embedding configuration. If omitted, uses FTS-only search. */
-    embedding?: LocalEmbeddingConfig;
-    /** User ID prefix for multi-tenant isolation. */
-    userIdPrefix?: string;
-    /** Factory function to create the SQLite database instance. */
-    createDatabase?: (dbPath: string) => SqliteDatabase;
-}
-export declare class LocalMemoryProvider implements MemoryProvider {
-    readonly providerId = "qmemory-local";
-    private store;
-    private embedding;
-    private consolidator;
-    private attachmentStore;
-    private userIdPrefix;
-    private dbPath;
-    private attachmentsDir;
-    /** Active embedding model id — stamped onto stored vectors and used to skip
-     * incomparable vectors at search time (model switch = silent noise otherwise). */
-    private embeddingModelId;
-    /** One-shot flag: the embedding-degradation trace is logged once per provider instance. */
-    private embeddingFailureLogged;
-    constructor(config: LocalMemoryProviderConfig);
-    /** Persist an uploaded attachment (orphan until linked at commit). */
-    adoptAttachment(input: {
-        data?: Buffer;
-        sourceUrl?: string;
-        filename: string;
-        mimeType: string;
-        userId: string;
-    }): Promise<AdoptedAttachment>;
-    /** Resolve an attachment id to its on-disk path (for serving). */
-    locateAttachment(id: string): Promise<{
-        absPath: string;
-        mimeType: string;
-        filename: string;
-    } | null>;
-    /** Drop uploads that were never saved to a memory. */
-    purgeOrphanAttachments(): Promise<void>;
-    /** Read an attachment's bytes + mime (P2 multimodal understanding). */
-    readAttachmentBytes(id: string): Promise<{
-        bytes: Buffer;
-        mimeType: string;
-    } | null>;
-    /** Persist the understood/extracted text on an attachment row. */
-    setAttachmentText(id: string, text: string): void;
-    private resolveUserId;
-    /**
-     * The embedding API failing silently downgrades every search to FTS-only —
-     * leave one error-level trace per provider instance (deduped so a broken
-     * endpoint does not flood the log on every query).
-     */
-    private noteEmbeddingFailure;
-    private buildEmbedding;
-    search(query: string, userId: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
-    /** Public embedding access for task-distillation signatures (R3). Null when
-     * the embedding provider is unavailable — callers must degrade, not throw.
-     * B3(X7): returns number[] (not Float32Array) — this method is on the 16-method
-     * host-state proxy surface and its result crosses the x/host.request JSON wire
-     * in host mode; typed arrays do not survive JSON serialization. */
-    embedText(text: string): Promise<number[] | null>;
-    addText(text: string, userId: string, options?: MemoryIngestOptions & {
-        category?: string;
-        importance?: number;
-    }): Promise<{
-        memoriesAdded: number;
-    }>;
-    remove(memoryId: string): Promise<boolean>;
-    update(memoryId: string, input: MemoryUpdateInput): Promise<boolean>;
-    /**
-     * Prompt-injection screen for L2 writes. The memory-tool path already checks
-     * this, but implicit extraction / distillation / RPC ingestion used to write
-     * UNSCREENED — recalled memories land in a system message, so this is the
-     * last write-side gate. Rejections are traced, never silent.
-     */
-    private screenUnsafeItems;
-    /**
-     * Commit extracted memory items through the single consolidation pipeline.
-     */
-    ingestExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationResult>;
-    observeExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationResult>;
-    proposeExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationResult>;
-    /**
-     * Consume the pending-proposal backlog (the "proposals black hole" fix).
-     *
-     * Trust ladder, mirroring V3's graduated autonomy:
-     *   - CORROBORATED facts — the same fact proposed again from an independent
-     *     context (different session or different source) — commit automatically,
-     *     with a trace. Evidence, not a confidence score, is the auto gate.
-     *   - Feedback-distillation proposals commit alone: their >=2-evidence bar
-     *     was already enforced upstream (idempotency-keyed sweep, §10).
-     *   - dream-source proposals never commit alone; they only corroborate.
-     *   - Everything else waits for corroboration and EXPIRES after the TTL —
-     *     visibly (status=expired), not by silent deletion.
-     */
-    consumePendingProposals(userId: string, opts?: {
-        now?: number;
-        ttlMs?: number;
-        maxCommitsPerPass?: number;
-    }): Promise<{
-        committed: number;
-        merged: number;
-        expiredIds: string[];
-        pendingLeft: number;
-    }>;
-    /** Proposals for the memory candidate surface: pending (default) or the
-     * read-only expired history. Other statuses stay internal. */
-    listPendingProposals(userId: string, limit?: number, status?: "pending" | "expired"): MemoryProposalRecord[];
-    /** Resolve one pending proposal from the UI: confirm -> commit now; dismiss -> rejected. */
-    resolveProposal(userId: string, proposalId: string, action: "confirm" | "dismiss"): Promise<boolean>;
-    listClaims(userId: string): MemoryClaimRecord[];
-    listConflicts(userId: string): MemoryConflictRecord[];
-    /**
-     * Drain the consolidation backlog: auto-resolve open conflicts and promote
-     * corroborated pending claims. Called by dream after consolidation so the
-     * observation→proposal→claim pipeline doesn't accumulate unresolved state
-     * forever (the "proposals black hole").
-     *
-     * Conflict winner = higher source priority, then confidence, then recency.
-     * The loser claim is superseded and its backing memory archived.
-     */
-    resolveConflicts(userId: string, opts?: {
-        minEvidenceToPromote?: number;
-    }): Promise<{
-        conflictsResolved: number;
-        claimsPromoted: number;
-    }>;
-    /**
-     * Trigger memory decay - multi-strategy (temporal + staleness + noise).
-     * Also enforces capacity limit and runs vacuum for space reclamation.
-     */
-    triggerDecay(userId: string): Promise<{
-        decayed: number;
-    }>;
-    /**
-     * Apply feedback to a memory (useful/irrelevant/outdated/wrong).
-     * Adjusts importance or archives/deletes based on signal.
-     */
-    /** V3 promote/demote: archive(技能接棒,记忆退役)与 unarchive(降格回归)成对。
-     * claims 状态随动,防 archived 记忆的 claim 继续参与冲突/召回。
-     * B3(X7)异步化:16 面 host-state proxy 方法,签名统一 Promise(实现体仍同步)。 */
-    setMemoryArchived(memoryId: string, archived: boolean): Promise<boolean>;
-    feedback(memoryIds: string[], signal: "useful" | "irrelevant" | "outdated" | "wrong"): Promise<{
-        affected: number;
-    }>;
-    /**
-     * Get a user profile value.
-     */
-    getProfile(userId: string, key: string): string | null;
-    /**
-     * Set a user profile value (upsert).
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    setProfile(userId: string, key: string, value: string): Promise<void>;
-    /**
-     * Get all profile entries for a user.
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    getAllProfiles(userId: string): Promise<Record<string, string>>;
-    /**
-     * Delete a profile entry.
-     */
-    deleteProfile(userId: string, key: string): boolean;
-    /**
-     * Get memories within a time range, grouped by day.
-     * Powers "what happened last week" type queries.
-     */
-    getTemporalSlice(userId: string, startMs: number, endMs: number, options?: {
-        category?: string;
-        limit?: number;
-    }): {
-        date: string;
-        memories: Array<{
-            id: string;
-            text: string;
-            category: string;
-            importance: number;
-        }>;
-    }[];
-    /**
-     * Get activity summary over recent N days (daily counts + highlights).
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    getActivitySummary(userId: string, days?: number): Promise<{
-        dailyCounts: Array<{
-            date: string;
-            count: number;
-        }>;
-        highlights: Array<{
-            id: string;
-            text: string;
-            category: string;
-            importance: number;
-            date: string;
-        }>;
-    }>;
-    /**
-     * List full memory records for a user (paginated). Used by the memory atlas
-     * visualization, which needs the complete record shape (confidence, importance,
-     * accessCount, timestamps, tags) to drive its 3D rendering.
-     */
-    list(userId: string, options?: {
-        page?: number;
-        pageSize?: number;
-        activeOnly?: boolean;
-    }): import("./local-store-records.js").MemoryRecord[];
-    /**
-     * Return the final atlas payload: a bounded interactive record window plus
-     * whole-history buckets/clusters for large timelines.
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    getAtlas(userId: string, options?: {
-        pageSize?: number;
-        windowStartAt?: number;
-        windowEndAt?: number;
-        windowCenterAt?: number;
-        bucketCount?: number;
-        clusterLimit?: number;
-        activeOnly?: boolean;
-    }): Promise<import("./local-store-records.js").MemoryAtlasResult>;
-    /** Complete tag-scoped listing (resident refresh / onboarding purge) — see store.listByTag. */
-    listMemoriesByTag(userId: string, tag: string): import("./local-store-records.js").MemoryRecord[];
-    /**
-     * Find related memories (event continuity detection).
-     * Given a new memory, finds existing memories that are semantically related
-     * (cosine 0.6-0.82) and from the past 14 days. These represent continuations
-     * of an ongoing event/thread.
-     *
-     * Example: "interviewed with ByteDance on Monday" -> finds "sent ByteDance resume last week" -> linked event chain.
-     */
-    findRelatedEvents(text: string, userId: string, options?: {
-        maxDaysBack?: number;
-        minSimilarity?: number;
-        maxSimilarity?: number;
-        limit?: number;
-    }): Promise<Array<{
-        id: string;
-        text: string;
-        score: number;
-        date: string;
-    }>>;
-    /**
-     * Synthesize a temporal narrative from memories in a time range.
-     * Returns a structured timeline suitable for prompt injection.
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    synthesizeTimeline(userId: string, startMs: number, endMs: number): Promise<string>;
-    /**
-     * Rerank search results by applying recency boost, access frequency,
-     * and importance weighting. No LLM needed - pure scoring heuristics.
-     *
-     * This goes beyond basic search scoring by considering:
-     *   - Temporal proximity (recent memories get boosted)
-     *   - Access frequency (frequently recalled = more relevant)
-     *   - Category alignment (if preferredCategories specified)
-     */
-    rerank(results: Array<{
-        id: string;
-        text: string;
-        score: number;
-        category?: string;
-        metadata?: Record<string, unknown>;
-    }>, options?: {
-        preferredCategories?: string[];
-        recencyBoostDays?: number;
-    }): Array<{
-        id: string;
-        text: string;
-        score: number;
-        category?: string;
-        metadata?: Record<string, unknown>;
-    }>;
-    /**
-     * Health check — a real probe, not a constant: reports the actual active row
-     * count and turns DB access errors into status "error" instead of "healthy".
-     */
-    health(): Promise<{
-        status: string;
-        memoryCount: number;
-        dbPath: string;
-    }>;
-    /**
-     * Get memory count for a user.
-     */
-    count(userId: string): number;
-    /**
-     * Reset ALL long-term memory state for a user: every SQLite table (memories,
-     * observations, proposals, claims, conflicts, attachments index, profile KV),
-     * the attachment files on disk, and the task-distillation working stores
-     * (candidate prompts are stored in clear text — they are memory-domain data
-     * and must not survive a "clear my memory"). promotion-proposals.json is
-     * deliberately KEPT: it is the audit trail of the user's own promote/demote
-     * decisions and the demote map for already-created skills.
-     *
-     * Returns the number of memory rows removed (wire-compat with the old shape).
-     */
-    resetUser(userId: string): Promise<number>;
-    /**
-     * Close the database connection.
-     */
-    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/memory-provider-factory.d.ts

@@ -1,33 +0,0 @@
-/**
- * Memory Provider Factory — creates local SQLite memory provider.
- *
- * No remote/cloud memory service exists. Memory is always local.
- * This factory is the single integration point for stdio-server.ts.
- */
-import type { LocalMemoryProvider } from "./local-memory-provider.js";
-import { type MemoryProviderFactoryConfig } from "./memory-embedding-config.js";
-export type { MemoryProviderFactoryConfig } from "./memory-embedding-config.js";
-export interface MemoryProviderFactoryResult {
-    provider: LocalMemoryProvider | null;
-    mode: "local" | "none";
-    error?: string;
-}
-/**
- * Create the local SQLite memory provider.
- * Returns null (mode "none") only if better-sqlite3 is not available.
- */
-export declare function createMemoryProvider(config: MemoryProviderFactoryConfig): MemoryProviderFactoryResult;
-/**
- * Build MemoryProviderFactoryConfig from environment variables.
- * Used by stdio-server to auto-configure memory.
- *
- * Environment variables:
- *   QMEMORY_EMBEDDING_TIMEOUT_MS — embedding request timeout (default: 1500)
- *   QMEMORY_USER_PREFIX        — user ID prefix for multi-tenant
- *
- * 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)
- */
-export declare function resolveMemoryConfigFromEnv(): MemoryProviderFactoryConfig;