qlogicagent 2.19.12 → 2.19.14

package/dist/types/skills/memory/memory-consolidation.d.ts

@@ -1,64 +0,0 @@
-import { LocalMemoryStore } from "./local-store.js";
-/** A pre-extracted memory item ready to be stored (no LLM needed). */
-export interface ExtractedMemoryItem {
-    text: string;
-    category?: string;
-    importance?: number;
-    speaker?: string;
-    event_date?: string;
-    tags?: string[];
-    /** Ids of already-uploaded attachments to link to this memory on commit. */
-    attachmentIds?: string[];
-    /**
-     * Explicit confidence for evidence-bearing sources (feedback distillation — §10). When set,
-     * proposeExtracted uses it verbatim instead of the source-derived default. Other callers omit it.
-     */
-    confidence?: number;
-    /**
-     * Evidence trail for distillation-style sources. `refs` (e.g. feedbackIds + turn:<id>) is stored
-     * on the observation for audit; `idempotencyKey` makes the proposal insert crash-safe + dedup'd.
-     */
-    evidence?: {
-        kind: string;
-        refs: string[];
-        idempotencyKey: string;
-    };
-}
-export interface MemoryConsolidationOptions {
-    source?: string;
-    sessionId?: string;
-}
-export interface MemoryConsolidationResult {
-    observationsAdded: number;
-    proposalsAdded: number;
-    claimsAdded: number;
-    conflictsAdded: number;
-    memoriesAdded: number;
-    observationIds: string[];
-    proposalIds: string[];
-    claimIds: string[];
-    conflictIds: string[];
-}
-export declare class MemoryConsolidator {
-    private readonly store;
-    private readonly embed;
-    constructor(store: LocalMemoryStore, embed: (text: string) => Promise<Float32Array | undefined>);
-    observe(items: ExtractedMemoryItem[], userId: string, options?: MemoryConsolidationOptions): Promise<MemoryConsolidationResult>;
-    proposeExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryConsolidationOptions): Promise<MemoryConsolidationResult>;
-    commitExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryConsolidationOptions): Promise<MemoryConsolidationResult>;
-    /**
-     * Find an existing active memory that is a near-duplicate of `text`.
-     * Token containment (Latin/digit words + CJK bigrams) against recent
-     * memories; digit-bearing token mismatches veto the match because numbers
-     * and ids are precise facts, not phrasing variance.
-     */
-    private findNearDuplicateMemory;
-}
-/** Containment threshold above which two texts count as the same memory.
- * Exported: the proposal consumer uses the SAME bar to group same-fact proposals. */
-export declare const NEAR_DUPLICATE_CONTAINMENT = 0.82;
-/** Latin/digit words plus CJK character bigrams from normalized text. */
-export declare function dedupTokens(text: string): Set<string>;
-/** True when either side has a digit-bearing token the other side lacks. */
-export declare function digitTokensDiffer(a: Set<string>, b: Set<string>): boolean;
-export declare function sourcePriorityOf(source: string): number;

package/dist/types/skills/memory/memory-db-path.d.ts

@@ -1,13 +0,0 @@
-import type { PathService } from "../../runtime/ports/index.js";
-/**
- * Resolve the database file path for L2 vector memory storage.
- * L2 vector memory is cross-project for one owner, but physically isolated by
- * profile at ~/.qlogicagent/profiles/<owner_user_id>/memory/.
- */
-export declare function resolveMemoryDbPath(ownerUserId?: string, pathService?: PathService): string;
-/**
- * Persistent attachment directory for long-term memory, beside the memory DB:
- * ~/.qlogicagent/profiles/<owner_user_id>/memory/attachments/
- * Files here live as long as the memories that reference them (no expiry).
- */
-export declare function resolveMemoryAttachmentsDir(ownerUserId?: string, pathService?: PathService): string;

package/dist/types/skills/memory/proposal-consumer.d.ts

@@ -1,51 +0,0 @@
-/**
- * Proposal consumer (P0 — the factual-memory half of the promotion ladder).
- *
- * implicit-extract / feedback-distillation / dream all write PROPOSALS
- * (status=pending). Before this module existed nothing ever read them back:
- * the three automatic learning paths burned model calls writing dead rows.
- *
- * Trust ladder — evidence gates autonomy, mirroring the V3 skill-promotion
- * doctrine (automatic only when the data says so; visible; revertible):
- *   - CORROBORATED: the same fact proposed >=2 times from independent
- *     contexts (different session, or different source) -> auto-commit as
- *     source "corroborated" (priority 70, so it actually becomes an active
- *     searchable memory — committing with the original implicit-extract
- *     priority 40 would just create another pending claim, i.e. the black
- *     hole one level deeper).
- *   - feedback-distillation proposals commit ALONE: their >=2-evidence bar
- *     was already enforced upstream (MIN_EVIDENCE + idempotency key, §10).
- *   - dream-tier sources (priority <= 20) never commit alone; they only
- *     corroborate facts seen elsewhere.
- *   - Everything else waits, and past the TTL flips to status "expired" —
- *     a visible terminal state, not a silent delete; the memory surface can
- *     still show expired proposals for manual rescue.
- *
- * Pure planning logic — no I/O; the provider executes the plan.
- */
-import type { MemoryProposalRecord } from "./local-store-records.js";
-import type { ExtractedMemoryItem } from "./memory-consolidation.js";
-/** Uncorroborated proposals older than this flip to "expired". */
-export declare const PROPOSAL_TTL_MS: number;
-/** Independent contexts required for auto-commit. */
-export declare const PROPOSAL_MIN_CORROBORATION = 2;
-/** Idle-pass work cap; the rest stays pending for the next pass. */
-export declare const PROPOSAL_MAX_COMMITS_PER_PASS = 20;
-/** Source stamped on corroborated commits — registered in sourcePriorityOf. */
-export declare const CORROBORATED_SOURCE = "corroborated";
-export interface ProposalCommitGroup {
-    proposalIds: string[];
-    item: ExtractedMemoryItem;
-    /** Source used for the commit (drives claim authority). */
-    source: string;
-}
-export interface ProposalConsumptionSummary {
-    commitGroups: ProposalCommitGroup[];
-    expiredIds: string[];
-}
-export interface ProposalConsumptionOptions {
-    now?: number;
-    ttlMs?: number;
-    maxCommitsPerPass?: number;
-}
-export declare function planProposalConsumption(pending: readonly MemoryProposalRecord[], opts?: ProposalConsumptionOptions): ProposalConsumptionSummary;

package/dist/types/skills/memory/sqlite-memory-mappers.d.ts

@@ -1,7 +0,0 @@
-import type { MemoryClaimRecord, MemoryConflictRecord, MemoryProposalRecord, MemoryRecord } from "./local-store-records.js";
-export declare function rowToRecord(row: unknown): MemoryRecord;
-export declare function rowToClaimRecord(row: unknown): MemoryClaimRecord;
-export declare function rowToProposalRecord(row: unknown): MemoryProposalRecord;
-export declare function rowToConflictRecord(row: unknown): MemoryConflictRecord;
-export declare function parseJsonObject(raw: unknown): Record<string, unknown>;
-export declare function parseJsonArray(raw: unknown): string[];

package/dist/types/skills/memory/sqlite-memory-schema.d.ts

@@ -1,11 +0,0 @@
-import type { SqliteDatabase } from "./local-store-records.js";
-export declare const MEMORY_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS memories (\n  id TEXT PRIMARY KEY,\n  text TEXT NOT NULL,\n  user_id TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  source TEXT NOT NULL DEFAULT 'agent',\n  session_id TEXT NOT NULL DEFAULT '',\n  event_date TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  embedding BLOB,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  access_count INTEGER NOT NULL DEFAULT 0,\n  last_accessed_at INTEGER NOT NULL DEFAULT 0,\n  is_archived INTEGER NOT NULL DEFAULT 0,\n  text_seg TEXT NOT NULL DEFAULT '',\n  embedding_model TEXT NOT NULL DEFAULT '',\n  embedding_dims INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE INDEX IF NOT EXISTS idx_memories_user ON memories(user_id);\nCREATE INDEX IF NOT EXISTS idx_memories_user_category ON memories(user_id, category);\nCREATE INDEX IF NOT EXISTS idx_memories_user_importance ON memories(user_id, importance DESC);\nCREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at DESC);\n\nCREATE TABLE IF NOT EXISTS memory_observations (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  text TEXT NOT NULL,\n  source TEXT NOT NULL,\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  session_id TEXT NOT NULL DEFAULT '',\n  evidence_type TEXT NOT NULL DEFAULT 'text',\n  payload TEXT NOT NULL DEFAULT '{}',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_observations_user_created ON memory_observations(user_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_memory_observations_source ON memory_observations(user_id, source);\n\nCREATE TABLE IF NOT EXISTS memory_proposals (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  observation_ids TEXT NOT NULL DEFAULT '[]',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  valid_time TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  status TEXT NOT NULL DEFAULT 'pending',\n  related_claim_ids TEXT NOT NULL DEFAULT '[]',\n  idempotency_key TEXT,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_user_status ON memory_proposals(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_fact ON memory_proposals(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_claims (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  status TEXT NOT NULL DEFAULT 'active',\n  valid_time TEXT NOT NULL DEFAULT '',\n  evidence_ids TEXT NOT NULL DEFAULT '[]',\n  supersedes_claim_id TEXT NOT NULL DEFAULT '',\n  conflict_group_id TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_claims_user_status ON memory_claims(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_memory ON memory_claims(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_fact ON memory_claims(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_conflicts (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  claim_a_id TEXT NOT NULL,\n  claim_b_id TEXT NOT NULL,\n  reason TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'open',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_conflicts_user_status ON memory_conflicts(user_id, status);\n\nCREATE TABLE IF NOT EXISTS memory_attachments (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  kind TEXT NOT NULL DEFAULT 'file',\n  filename TEXT NOT NULL DEFAULT '',\n  mime_type TEXT NOT NULL DEFAULT '',\n  size INTEGER NOT NULL DEFAULT 0,\n  rel_path TEXT NOT NULL,\n  extracted_text TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_memory ON memory_attachments(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_orphan ON memory_attachments(user_id, memory_id, created_at);\n\n";
-/**
- * FTS index + sync triggers, kept as a separate DDL block because the CJK
- * migration below must DROP and re-create exactly this set — a second copy
- * would drift. The index covers the pre-segmented shadow column `text_seg`
- * (see fts-segment.ts), NOT raw `text`: unicode61 cannot segment CJK, so raw
- * Chinese text is unsearchable by keyword.
- */
-export declare const MEMORY_FTS_SCHEMA_SQL = "\nCREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(\n  id UNINDEXED,\n  user_id UNINDEXED,\n  text_seg,\n  category,\n  tags,\n  content=memories,\n  content_rowid=rowid,\n  tokenize='unicode61 remove_diacritics 2'\n);\n\nCREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN\n  INSERT INTO memories_fts(rowid, id, user_id, text_seg, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text_seg, new.category, new.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text_seg, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text_seg, old.category, old.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text_seg, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text_seg, old.category, old.tags);\n  INSERT INTO memories_fts(rowid, id, user_id, text_seg, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text_seg, new.category, new.tags);\nEND;\n";
-export declare function initializeMemorySchema(db: SqliteDatabase): void;