qlogicagent 2.19.12 → 2.19.14

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

@@ -1,206 +0,0 @@
-/** Lightweight attachment reference carried on records / atlas wire (no bytes, no extractedText). */
-export interface MemoryAttachmentRef {
-    id: string;
-    kind: string;
-    filename: string;
-    mimeType: string;
-    size: number;
-    url: string;
-}
-export interface MemoryRecord {
-    id: string;
-    text: string;
-    userId: string;
-    category: string;
-    importance: number;
-    confidence: number;
-    source: string;
-    sessionId: string;
-    eventDate: string;
-    tags: string[];
-    embedding: Float32Array | null;
-    createdAt: number;
-    updatedAt: number;
-    accessCount: number;
-    lastAccessedAt: number;
-    isArchived: boolean;
-    /** Lightweight attachment refs (populated by the provider for atlas/detail). */
-    attachments?: MemoryAttachmentRef[];
-}
-export interface MemoryInsertInput {
-    text: string;
-    userId: string;
-    category?: string;
-    importance?: number;
-    confidence?: number;
-    source?: string;
-    sessionId?: string;
-    eventDate?: string;
-    tags?: string[];
-    embedding?: Float32Array;
-    /** Provenance of `embedding` (model id). Vectors from different models are not
-     * comparable; search skips rows whose model/dims mismatch the query's. */
-    embeddingModel?: string;
-}
-export interface MemoryUpdateInput {
-    text?: string;
-    category?: string;
-    importance?: number;
-    source?: string;
-    eventDate?: string;
-    tags?: string[];
-    embedding?: Float32Array | null;
-    /** Provenance of the replacement embedding (see MemoryInsertInput). */
-    embeddingModel?: string;
-}
-export interface MemorySearchHit {
-    id: string;
-    text: string;
-    score: number;
-    category: string;
-    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 type MemorySourceKind = "manual" | "explicit" | "document" | "image" | "video" | "auto" | "turn" | "dream" | "agent" | "feedback";
-export type MemoryClaimStatus = "active" | "superseded" | "conflicted" | "archived" | "pending_confirmation";
-export type MemoryProposalStatus = "pending" | "accepted" | "merged" | "conflicted" | "rejected" | "expired";
-export interface MemoryObservationInput {
-    userId: string;
-    text: string;
-    source: string;
-    sourcePriority: number;
-    sessionId?: string;
-    evidenceType?: string;
-    payload?: Record<string, unknown>;
-}
-export interface MemoryObservationRecord extends Required<Omit<MemoryObservationInput, "payload" | "sessionId" | "evidenceType">> {
-    id: string;
-    sessionId: string;
-    evidenceType: string;
-    payload: Record<string, unknown>;
-    createdAt: number;
-}
-export interface MemoryProposalInput {
-    userId: string;
-    observationIds: string[];
-    text: string;
-    category: string;
-    importance: number;
-    confidence: number;
-    source: string;
-    sourcePriority: number;
-    entity: string;
-    predicate: string;
-    value: Record<string, unknown>;
-    validTime?: string;
-    tags?: string[];
-    status?: MemoryProposalStatus;
-    relatedClaimIds?: string[];
-    /**
-     * Crash-safe dedup key for evidence-bearing sources (feedback distillation — §10). When set,
-     * proposeExtracted skips inserting a duplicate proposal for the same key. Left undefined by all
-     * existing callers (LLM extraction / dream / manual), so their behaviour is unchanged.
-     */
-    idempotencyKey?: string;
-}
-export interface MemoryProposalRecord extends Omit<MemoryProposalInput, "value" | "validTime" | "tags" | "status" | "relatedClaimIds"> {
-    id: string;
-    value: Record<string, unknown>;
-    validTime: string;
-    tags: string[];
-    status: MemoryProposalStatus;
-    relatedClaimIds: string[];
-    createdAt: number;
-    updatedAt: number;
-}
-export interface MemoryClaimInput {
-    userId: string;
-    memoryId?: string;
-    entity: string;
-    predicate: string;
-    value: Record<string, unknown>;
-    text: string;
-    category: string;
-    importance: number;
-    confidence: number;
-    source: string;
-    sourcePriority: number;
-    status: MemoryClaimStatus;
-    validTime?: string;
-    evidenceIds: string[];
-    supersedesClaimId?: string;
-    conflictGroupId?: string;
-}
-export interface MemoryClaimRecord extends Omit<MemoryClaimInput, "memoryId" | "value" | "validTime" | "supersedesClaimId" | "conflictGroupId"> {
-    id: string;
-    memoryId: string;
-    value: Record<string, unknown>;
-    validTime: string;
-    supersedesClaimId: string;
-    conflictGroupId: string;
-    createdAt: number;
-    updatedAt: number;
-}
-export interface MemoryConflictRecord {
-    id: string;
-    userId: string;
-    claimAId: string;
-    claimBId: string;
-    reason: string;
-    status: "open" | "resolved" | "dismissed";
-    createdAt: number;
-    updatedAt: number;
-}
-export interface SqliteDatabase {
-    exec(sql: string): void;
-    prepare(sql: string): SqliteStatement;
-    pragma(pragma: string): unknown;
-    close(): void;
-}
-export interface SqliteStatement {
-    run(...params: unknown[]): {
-        changes: number;
-        lastInsertRowid: number | bigint;
-    };
-    get(...params: unknown[]): unknown;
-    all(...params: unknown[]): unknown[];
-}

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

@@ -1,376 +0,0 @@
-/**
- * Local Memory Store - SQLite-backed persistence for qmemory.
- *
- * Ported from Python qmemory's memory_store.py + db.py.
- * Uses better-sqlite3 for synchronous, fast, single-file persistence.
- *
- * Storage location:
- *   ~/.qlogicagent/profiles/<owner_user_id>/memory/memories.db
- *
- * Schema:
- *   - memories: core fact storage with optional embedding blob
- *   - memories_fts: FTS5 full-text index for keyword search
- *   - profiles: user profile KV (future)
- */
-import type { MemoryAtlasResult, MemoryClaimInput, MemoryClaimRecord, MemoryClaimStatus, MemoryConflictRecord, MemoryInsertInput, MemoryObservationInput, MemoryProposalInput, MemoryProposalRecord, MemoryProposalStatus, MemoryRecord, MemorySearchHit, MemoryUpdateInput, SqliteDatabase } from "./local-store-records.js";
-export { resolveMemoryDbPath } from "./memory-db-path.js";
-export type { MemoryAtlasBucket, MemoryAtlasCluster, MemoryAtlasResult, MemoryAtlasWindowCursor, MemoryAttachmentRef, MemoryClaimInput, MemoryClaimRecord, MemoryClaimStatus, MemoryConflictRecord, MemoryInsertInput, MemoryObservationInput, MemoryObservationRecord, MemoryProposalInput, MemoryProposalRecord, MemoryProposalStatus, MemoryRecord, MemorySearchHit, MemorySourceKind, MemoryUpdateInput, SqliteDatabase, SqliteStatement, } from "./local-store-records.js";
-/** Full attachment index row (DB-backed; file bytes live on disk under the attachments dir). */
-export interface MemoryAttachmentRow {
-    id: string;
-    memoryId: string;
-    userId: string;
-    kind: string;
-    filename: string;
-    mimeType: string;
-    size: number;
-    relPath: string;
-    extractedText: string;
-    createdAt: number;
-}
-export interface MemoryAttachmentInsert {
-    id: string;
-    userId: string;
-    kind: string;
-    filename: string;
-    mimeType: string;
-    size: number;
-    relPath: string;
-    extractedText?: string;
-    memoryId?: string;
-}
-export declare class LocalMemoryStore {
-    private db;
-    /** Stamped onto rows whose embedding arrives without explicit provenance
-     * (the consolidation pipeline passes bare vectors). Set by the provider. */
-    private defaultEmbeddingModel;
-    constructor(db: SqliteDatabase);
-    setDefaultEmbeddingModel(model: string): void;
-    private initSchema;
-    /**
-     * Insert a new memory record. Returns the generated ID.
-     */
-    insert(input: MemoryInsertInput): string;
-    /**
-     * Full-text search using FTS5. Returns ranked results.
-     */
-    searchFts(query: string, userId: string, limit?: number): MemorySearchHit[];
-    /** One-shot flag: embedding provenance mismatches are traced once per store instance. */
-    private embeddingMismatchLogged;
-    /**
-     * Vector similarity search using pre-computed embeddings.
-     * Performs brute-force cosine similarity (efficient for <100k records per user).
-     *
-     * Rows whose embedding provenance (dims, and model when both sides are known)
-     * differs from the query's are SKIPPED, not scored: cosine between vectors of
-     * different models/dims is numeric noise, and truncated dot products silently
-     * corrupt ranking. Legacy rows (no provenance columns) are accepted when their
-     * dimension happens to match — dropping them all would blank historical recall.
-     */
-    searchVector(queryEmbedding: Float32Array, userId: string, limit?: number, minScore?: number, expectedModel?: string): MemorySearchHit[];
-    /**
-     * Hybrid search: FTS5 + vector similarity, fused by rank-tempered RRF.
-     *
-     * Two currencies, each carrying signal the other cannot:
-     *   - channel scores (0-1, isomorphic across FTS/vector) carry MAGNITUDE —
-     *     an exact lexical hit must beat weak-consensus noise, which pure rank
-     *     fusion cannot guarantee (rank ignores how strong a match is);
-     *   - reciprocal ranks carry CONSENSUS and are scale-invariant — as the
-     *     store grows, BM25 inflates until squashed top scores compress to
-     *     near-ties and the two channels' score distributions drift apart;
-     *     ranks keep differentiating where magnitudes saturate.
-     * fused = (1-w)*magnitude + w*rrfNorm keeps both properties. Magnitude of a
-     * dual hit is the stronger channel plus a fraction of the weaker (consensus
-     * also rewarded in score space); rrfNorm is the reciprocal-rank sum
-     * normalized so a dual #1 hit = 1.0. FTS ranks follow BM25 order, vector
-     * ranks follow the blended channel order — each channel's own relevance
-     * ordering. Rows found by FTS only (e.g. no embedding) compete in the same
-     * fused domain and remain reachable, not buried.
-     */
-    searchHybrid(query: string, queryEmbedding: Float32Array | null, userId: string, limit?: number, expectedModel?: string): MemorySearchHit[];
-    /**
-     * Get all memories for a user (paginated).
-     */
-    listByUser(userId: string, page?: number, pageSize?: number, activeOnly?: boolean): MemoryRecord[];
-    /**
-     * All active memories carrying a tag (LIKE match on the quoted JSON-array
-     * element). Tag consumers (resident refresh / onboarding replace-purge) need
-     * the COMPLETE tag set regardless of age — the windowed atlas read silently
-     * truncated them once history outgrew one page/time window. No LIMIT by
-     * design: a capped "complete" read is the same bug at a higher threshold
-     * (a purge that misses rows resurrects stale memories). Tag sets are small
-     * (one origin/resident group), and this is not a hot path.
-     */
-    listByTag(userId: string, tag: string): 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.
-     */
-    getById(id: string): MemoryRecord | null;
-    /**
-     * Update memory text and bump updatedAt.
-     */
-    updateText(id: string, text: string, embedding?: Float32Array, embeddingModel?: string): boolean;
-    /**
-     * Update editable memory fields and bump updatedAt.
-     */
-    update(id: string, input: MemoryUpdateInput): boolean;
-    /**
-     * Delete a memory by ID.
-     */
-    delete(id: string): boolean;
-    /**
-     * Archive a memory (soft-delete: set is_archived=1).
-     * Used by dedup gate when a similar but newer memory supersedes an older one.
-     */
-    archive(id: string): boolean;
-    /** V3 demote(降格)恢复:archived procedure 回归召回池,与 archive 成对。 */
-    unarchive(id: string): boolean;
-    /**
-     * Temporal expiry: archive event/plan memories whose event_date has passed
-     * beyond a grace period (e.g., "meeting tomorrow" 3 days after it happened).
-     */
-    decayTemporalExpiry(userId: string, graceDays?: number): number;
-    /**
-     * Staleness decay: reduce importance of memories not accessed in a long time.
-     * Memories accessed recently retain their importance; stale ones degrade.
-     */
-    decayStaleness(userId: string, staleDays?: number, decayFactor?: number): number;
-    /**
-     * Noise archival: archive low-importance memories that never got accessed.
-     * Memories written by the agent but never recalled are likely noise.
-     */
-    decayNoiseArchival(userId: string, minAgeDays?: number, maxImportance?: number): number;
-    /**
-     * Observation retention: memory_observations is an append-only audit trail
-     * (every propose/commit writes one) with NO reader of its own — without a
-     * retention window it grows forever, the same disease the proposals table
-     * had before the consumer existed. Delete rows older than the window that
-     * are NOT referenced by any claim's evidence_ids or proposal's
-     * observation_ids (referenced rows are live audit evidence and stay).
-     */
-    decayObservations(userId: string, retentionDays?: number): number;
-    /**
-     * Resolved-proposal retention: terminal rows (accepted/merged/rejected/
-     * expired) are processing history, not memory — past the window they only
-     * grow the table. Rows carrying an idempotency_key are KEPT FOREVER: they
-     * are the crash-safe ledger that stops feedback distillation from
-     * re-proposing the same evidence cluster (deleting them would re-open the
-     * exact duplicate-write hole the key exists to close). Pending rows are
-     * never touched here — the consumer owns their TTL (status=expired).
-     */
-    decayResolvedProposals(userId: string, retentionDays?: number): number;
-    /**
-     * Run all decay strategies. Returns total affected count.
-     */
-    runFullDecay(userId: string, options?: {
-        temporalGraceDays?: number;
-        staleDays?: number;
-        staleDecayFactor?: number;
-        noiseMinAgeDays?: number;
-        noiseMaxImportance?: number;
-    }): {
-        temporal: number;
-        stale: number;
-        noise: number;
-        total: number;
-    };
-    /**
-     * Apply feedback signal to a memory, adjusting importance accordingly.
-     *
-     * Signals:
-     *   - "useful" boosts importance by +0.15 (capped at 1.0)
-     *   - "irrelevant" reduces importance by -0.2
-     *   - "outdated" archives immediately
-     *   - "wrong" deletes immediately
-     */
-    applyFeedback(memoryId: string, signal: "useful" | "irrelevant" | "outdated" | "wrong"): boolean;
-    /**
-     * Get a profile value for a user.
-     */
-    getProfile(userId: string, key: string): string | null;
-    /**
-     * Set a profile value (upsert).
-     */
-    setProfile(userId: string, key: string, value: string): void;
-    /**
-     * Get all profile entries for a user.
-     */
-    getAllProfiles(userId: string): Record<string, string>;
-    /**
-     * Delete a profile entry.
-     */
-    deleteProfile(userId: string, key: string): boolean;
-    private profileTableCreated;
-    private ensureProfileTable;
-    /**
-     * Retrieve memories within a time range, grouped by day.
-     * Used for "what happened last week" type queries and dream synthesis.
-     */
-    getTemporalSlice(userId: string, startMs: number, endMs: number, options?: {
-        category?: string;
-        limit?: number;
-    }): Array<{
-        date: string;
-        memories: Array<{
-            id: string;
-            text: string;
-            category: string;
-            importance: number;
-        }>;
-    }>;
-    /**
-     * Get memory activity summary over recent N days.
-     * Returns daily counts and high-importance entries used by temporal synthesis.
-     */
-    getActivitySummary(userId: string, days?: number): {
-        dailyCounts: Array<{
-            date: string;
-            count: number;
-        }>;
-        highlights: Array<{
-            id: string;
-            text: string;
-            category: string;
-            importance: number;
-            date: string;
-        }>;
-    };
-    /**
-     * Record an access (for importance/relevance boosting).
-     */
-    recordAccess(id: string): void;
-    /** Total active memory rows across ALL users (health reporting). */
-    countAll(): number;
-    /**
-     * Get total memory count for a user.
-     */
-    count(userId: string, activeOnly?: boolean): number;
-    /**
-     * Delete ALL long-term memory state for a user — every table, not just
-     * `memories`. Claims carry entity/predicate/value facts in clear text and
-     * observations carry raw conversation excerpts; leaving them behind after a
-     * "clear my memory" is a broken privacy promise, not a smaller reset.
-     *
-     * Returns the attachment rel_paths so the caller can delete the on-disk
-     * files (the store only owns the index rows).
-     */
-    resetUser(userId: string): {
-        memories: number;
-        observations: number;
-        proposals: number;
-        claims: number;
-        conflicts: number;
-        profiles: number;
-        attachmentRelPaths: string[];
-    };
-    /**
-     * Run SQLite VACUUM to reclaim space after deletions/archival.
-     * Should be called periodically (e.g. after decay cycles).
-     */
-    vacuum(): void;
-    /**
-     * Get database size info for capacity monitoring.
-     */
-    getStorageStats(): {
-        pageCount: number;
-        pageSize: number;
-        totalBytes: number;
-        freePages: number;
-    };
-    /**
-     * List the oldest archived memories for cold-storage export. Read-only:
-     * purging is a SEPARATE step (purgeMemoriesByIds) the caller performs only
-     * after the export has durably landed on disk. The old fused
-     * export-then-delete shape destroyed data whenever the caller dropped the
-     * return value.
-     */
-    listArchivedForExport(userId: string, maxExport?: number): Array<{
-        id: string;
-        text: string;
-        category: string;
-        importance: number;
-        createdAt: number;
-        archivedAt: number;
-        tags: string[];
-    }>;
-    /** Physically delete memory rows by id (post-export purge step). */
-    purgeMemoriesByIds(ids: string[]): number;
-    /**
-     * Enforce capacity limit: if active memories exceed maxCount,
-     * archive the oldest lowest-importance ones.
-     */
-    enforceCapacityLimit(userId: string, maxCount?: number): number;
-    insertObservation(input: MemoryObservationInput): string;
-    insertProposal(input: MemoryProposalInput): string;
-    /**
-     * Look up an existing proposal by its idempotency key (feedback distillation — §10). Returns the
-     * proposal id if one already exists for this user + key, else null, letting proposeExtracted skip
-     * a duplicate crash-safely (the key survives a worker restart mid-sweep).
-     */
-    findProposalByIdempotencyKey(userId: string, idempotencyKey: string): string | null;
-    /**
-     * List proposals by status (oldest first) — the read side of the proposal
-     * consumer. Pending proposals from implicit-extract / feedback / dream used
-     * to have NO reader at all: they accumulated forever and never became
-     * searchable memories.
-     */
-    listProposalsByStatus(userId: string, status: MemoryProposalStatus, limit?: number): MemoryProposalRecord[];
-    /** Bulk status transition for the proposal consumer (corroborated / expired). */
-    markProposalsStatus(ids: string[], status: MemoryProposalStatus): number;
-    updateProposalStatus(id: string, status: MemoryProposalStatus, relatedClaimIds?: string[]): boolean;
-    insertClaim(input: MemoryClaimInput): string;
-    listClaims(userId: string, statuses?: MemoryClaimStatus[]): MemoryClaimRecord[];
-    findClaimsByFact(userId: string, entity: string, predicate: string, validTime?: string): MemoryClaimRecord[];
-    mergeClaimEvidence(id: string, evidenceIds: string[], confidence: number, importance: number): boolean;
-    updateClaimsByMemoryId(memoryId: string, status: MemoryClaimStatus): number;
-    insertConflict(input: {
-        userId: string;
-        claimAId: string;
-        claimBId: string;
-        reason: string;
-    }): string;
-    listConflicts(userId: string): MemoryConflictRecord[];
-    getClaimById(id: string): MemoryClaimRecord | undefined;
-    setClaimStatus(id: string, status: MemoryClaimStatus): boolean;
-    /** Mark a conflict resolved (the resolver has already updated the claims). */
-    setConflictStatus(id: string, status: "open" | "resolved" | "dismissed"): boolean;
-    /** Open conflicts only (the ones needing resolution). */
-    listOpenConflicts(userId: string): MemoryConflictRecord[];
-    /**
-     * Promote pending_confirmation claims that have accumulated enough independent
-     * evidence to become active. Returns the number promoted.
-     */
-    promotePendingClaims(userId: string, minEvidence: number): number;
-    insertAttachment(input: MemoryAttachmentInsert): void;
-    getAttachmentById(id: string): MemoryAttachmentRow | null;
-    listAttachmentsByMemoryId(memoryId: string): MemoryAttachmentRow[];
-    /** Batch-load attachments for many memories (for atlas windows). */
-    listAttachmentsByMemoryIds(memoryIds: string[]): Map<string, MemoryAttachmentRow[]>;
-    /** Link orphan/owned attachments to a committed memory. Returns linked count. */
-    linkAttachments(memoryId: string, attachmentIds: string[], userId: string): number;
-    setAttachmentExtractedText(id: string, text: string): boolean;
-    /** Delete attachment index rows for a memory; returns their rel paths for file cleanup. */
-    deleteAttachmentsByMemoryId(memoryId: string): string[];
-    /** Orphan attachments (uploaded but never saved to a memory) older than cutoff. */
-    listOrphanAttachments(cutoff: number): MemoryAttachmentRow[];
-    deleteAttachmentById(id: string): void;
-    close(): void;
-}

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

@@ -1,62 +0,0 @@
-/**
- * MemoryAttachmentStore — persistent attachment storage for long-term memory.
- *
- * Files live beside the memory DB, with no expiry:
- *   ~/.qlogicagent/profiles/<owner>/memory/attachments/<id><ext>
- * The DB (`memory_attachments` table, via LocalMemoryStore) is the index;
- * this class owns the on-disk bytes + ties index rows to files.
- *
- * Lifecycle: an attachment is `adopt`ed at upload time (orphan, memory_id=''),
- * then `link`ed to a memory at commit; on memory delete the files+rows are
- * removed; long-orphaned uploads are purged.
- */
-import type { LocalMemoryStore, MemoryAttachmentRef, MemoryAttachmentRow } from "./local-store.js";
-export declare const MAX_ATTACHMENT_BYTES: number;
-export type AttachmentKind = "image" | "audio" | "video" | "doc" | "file";
-export declare function attachmentKindFromMime(mimeType: string, filename?: string): AttachmentKind;
-export interface AdoptedAttachment {
-    id: string;
-    kind: AttachmentKind;
-    filename: string;
-    mimeType: string;
-    size: number;
-    url: string;
-}
-export interface AdoptInput {
-    /** Raw bytes (preferred). */
-    data?: Buffer;
-    /** Or a URL the store fetches (e.g. the gateway's temp MediaStore url). */
-    sourceUrl?: string;
-    filename: string;
-    mimeType: string;
-    userId: string;
-}
-export declare class MemoryAttachmentStore {
-    private readonly store;
-    private readonly dir;
-    constructor(store: LocalMemoryStore, dir: string);
-    urlFor(id: string): string;
-    toRef(row: MemoryAttachmentRow): MemoryAttachmentRef;
-    /** Persist an uploaded file + create an orphan index row (memory_id=''). */
-    adopt(input: AdoptInput): Promise<AdoptedAttachment>;
-    /** Read an attachment's bytes + mime (for multimodal understanding). */
-    readBytes(id: string): Promise<{
-        bytes: Buffer;
-        mimeType: string;
-    } | null>;
-    /** Resolve an attachment to an absolute on-disk path (for serving). Guards traversal. */
-    locate(id: string): Promise<{
-        absPath: string;
-        mimeType: string;
-        filename: string;
-    } | null>;
-    link(memoryId: string, attachmentIds: string[], userId: string): number;
-    setExtractedText(id: string, text: string): void;
-    refsForMemory(memoryId: string): MemoryAttachmentRef[];
-    /** Map of memoryId → refs, for atlas windows. */
-    refsForMemories(memoryIds: string[]): Map<string, MemoryAttachmentRef[]>;
-    /** Remove all files + index rows for a deleted memory. */
-    removeByMemoryId(memoryId: string): Promise<void>;
-    /** Purge uploads that were never linked to a saved memory. */
-    purgeOrphans(olderThanMs?: number): Promise<void>;
-}