@psiclawops/hypermem 0.9.0 → 0.9.1

package/dist/composition-snapshot-store.d.ts

@@ -1,44 +0,0 @@
-import type { DatabaseSync } from 'node:sqlite';
-import { type SnapshotIntegrityVerification, type SnapshotSlotsRecord } from './composition-snapshot-integrity.js';
-export interface CompositionSnapshotRecord {
-    id: number;
-    contextId: number;
-    headMessageId: number | null;
-    schemaVersion: number;
-    capturedAt: string;
-    model: string;
-    contextWindow: number;
-    totalTokens: number;
-    fillPct: number;
-    snapshotKind: string;
-    repairDepth: number;
-    slotsJson: string;
-    slotsIntegrityHash: string;
-    createdAt: string;
-}
-export interface InsertCompositionSnapshotInput {
-    contextId: number;
-    headMessageId?: number | null;
-    schemaVersion?: number;
-    capturedAt?: string;
-    model: string;
-    contextWindow: number;
-    totalTokens: number;
-    fillPct: number;
-    snapshotKind?: string;
-    repairDepth?: number;
-    slots: SnapshotSlotsRecord | string;
-    createdAt?: string;
-}
-export interface LatestValidCompositionSnapshot {
-    snapshot: CompositionSnapshotRecord;
-    verification: SnapshotIntegrityVerification;
-    fallbackUsed: boolean;
-}
-export declare const MAX_WARM_RESTORE_REPAIR_DEPTH = 1;
-export declare function insertCompositionSnapshot(db: DatabaseSync, input: InsertCompositionSnapshotInput): CompositionSnapshotRecord;
-export declare function listCompositionSnapshots(db: DatabaseSync, contextId: number, limit?: number): CompositionSnapshotRecord[];
-export declare function getCompositionSnapshot(db: DatabaseSync, snapshotId: number): CompositionSnapshotRecord | null;
-export declare function verifyCompositionSnapshot(snapshot: CompositionSnapshotRecord): SnapshotIntegrityVerification;
-export declare function getLatestValidCompositionSnapshot(db: DatabaseSync, contextId: number): LatestValidCompositionSnapshot | null;
-//# sourceMappingURL=composition-snapshot-store.d.ts.map

package/dist/composition-snapshot-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"composition-snapshot-store.d.ts","sourceRoot":"","sources":["../src/composition-snapshot-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAOL,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACzB,MAAM,qCAAqC,CAAC;AAE7C,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,yBAAyB,CAAC;IACpC,YAAY,EAAE,6BAA6B,CAAC;IAC5C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,6BAA6B,IAAI,CAAC;AA4C/C,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,8BAA8B,GACpC,yBAAyB,CA4D3B;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,SAAI,GACR,yBAAyB,EAAE,CAU7B;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,UAAU,EAAE,MAAM,GACjB,yBAAyB,GAAG,IAAI,CAIlC;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,yBAAyB,GAClC,6BAA6B,CAE/B;AAED,wBAAgB,iCAAiC,CAC/C,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,MAAM,GAChB,8BAA8B,GAAG,IAAI,CAevC"}

package/dist/composition-snapshot-store.js

@@ -1,117 +0,0 @@
-import { attachInlineIntegrityHash, canonicalizeSnapshotJson, computeSlotsIntegrityHash, isInlineSnapshotSlotPayload, parseSnapshotSlotsJson, verifySnapshotSlotsIntegrity, } from './composition-snapshot-integrity.js';
-export const MAX_WARM_RESTORE_REPAIR_DEPTH = 1;
-function nowIso() {
-    return new Date().toISOString();
-}
-function parseSnapshotRow(row) {
-    return {
-        id: row.id,
-        contextId: row.context_id,
-        headMessageId: row.head_message_id ?? null,
-        schemaVersion: row.schema_version,
-        capturedAt: row.captured_at,
-        model: row.model,
-        contextWindow: row.context_window,
-        totalTokens: row.total_tokens,
-        fillPct: row.fill_pct,
-        snapshotKind: row.snapshot_kind,
-        repairDepth: row.repair_depth,
-        slotsJson: row.slots_json,
-        slotsIntegrityHash: row.slots_integrity_hash,
-        createdAt: row.created_at,
-    };
-}
-function normalizeSlots(slots) {
-    const parsed = typeof slots === 'string' ? parseSnapshotSlotsJson(slots) : parseSnapshotSlotsJson(canonicalizeSnapshotJson(slots));
-    const normalized = {};
-    for (const [slotKey, slotValue] of Object.entries(parsed)) {
-        normalized[slotKey] = isInlineSnapshotSlotPayload(slotValue)
-            ? attachInlineIntegrityHash(slotValue)
-            : slotValue;
-    }
-    return normalized;
-}
-function normalizeRepairDepth(repairDepth) {
-    const normalized = repairDepth ?? 0;
-    if (!Number.isInteger(normalized) || normalized < 0 || normalized > MAX_WARM_RESTORE_REPAIR_DEPTH) {
-        throw new Error(`composition snapshot repair_depth must be an integer between 0 and ${MAX_WARM_RESTORE_REPAIR_DEPTH}`);
-    }
-    return normalized;
-}
-export function insertCompositionSnapshot(db, input) {
-    const capturedAt = input.capturedAt ?? nowIso();
-    const createdAt = input.createdAt ?? capturedAt;
-    const repairDepth = normalizeRepairDepth(input.repairDepth);
-    const normalizedSlots = normalizeSlots(input.slots);
-    const slotsJson = canonicalizeSnapshotJson(normalizedSlots);
-    const slotsIntegrityHash = computeSlotsIntegrityHash(normalizedSlots);
-    const result = db.prepare(`
-    INSERT INTO composition_snapshots (
-      context_id,
-      head_message_id,
-      schema_version,
-      captured_at,
-      model,
-      context_window,
-      total_tokens,
-      fill_pct,
-      snapshot_kind,
-      repair_depth,
-      slots_json,
-      slots_integrity_hash,
-      created_at
-    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(input.contextId, input.headMessageId ?? null, input.schemaVersion ?? 1, capturedAt, input.model, input.contextWindow, input.totalTokens, input.fillPct, input.snapshotKind ?? 'full', repairDepth, slotsJson, slotsIntegrityHash, createdAt);
-    db.prepare(`
-    DELETE FROM composition_snapshots
-    WHERE context_id = ?
-      AND id NOT IN (
-        SELECT id
-        FROM composition_snapshots
-        WHERE context_id = ?
-        ORDER BY captured_at DESC, id DESC
-        LIMIT 2
-      )
-  `).run(input.contextId, input.contextId);
-    const row = db.prepare('SELECT * FROM composition_snapshots WHERE id = ?')
-        .get(Number(result.lastInsertRowid));
-    if (!row) {
-        throw new Error('Failed to read back inserted composition snapshot');
-    }
-    return parseSnapshotRow(row);
-}
-export function listCompositionSnapshots(db, contextId, limit = 2) {
-    const rows = db.prepare(`
-    SELECT *
-    FROM composition_snapshots
-    WHERE context_id = ?
-    ORDER BY captured_at DESC, id DESC
-    LIMIT ?
-  `).all(contextId, limit);
-    return rows.map(parseSnapshotRow);
-}
-export function getCompositionSnapshot(db, snapshotId) {
-    const row = db.prepare('SELECT * FROM composition_snapshots WHERE id = ?')
-        .get(snapshotId);
-    return row ? parseSnapshotRow(row) : null;
-}
-export function verifyCompositionSnapshot(snapshot) {
-    return verifySnapshotSlotsIntegrity(snapshot.slotsJson, snapshot.slotsIntegrityHash);
-}
-export function getLatestValidCompositionSnapshot(db, contextId) {
-    const candidates = listCompositionSnapshots(db, contextId, 2)
-        .filter(snapshot => snapshot.repairDepth < MAX_WARM_RESTORE_REPAIR_DEPTH);
-    for (let i = 0; i < candidates.length; i++) {
-        const snapshot = candidates[i];
-        const verification = verifyCompositionSnapshot(snapshot);
-        if (verification.ok) {
-            return {
-                snapshot,
-                verification,
-                fallbackUsed: i > 0,
-            };
-        }
-    }
-    return null;
-}
-//# sourceMappingURL=composition-snapshot-store.js.map

package/dist/compositor-utils.d.ts

@@ -1,31 +0,0 @@
-/**
- * compositor-utils.ts — Utility functions for context window composition.
- *
- * Provides ordering strategies that improve LLM attention over retrieved
- * documents placed into a prompt.
- */
-/**
- * Reorder documents using zigzag placement to mitigate
- * "Lost in the Middle" attention degradation in LLMs.
- *
- * LLMs exhibit a U-shaped attention curve: items at the beginning and end
- * of context receive ~30% more attention than items in the middle.
- * This function places the most relevant items at the edges and the least
- * relevant items near the center, maximising effective attention on the
- * information that matters most.
- *
- * Reference: Liu et al., "Lost in the Middle: How Language Models Use Long
- * Contexts", ICLR 2025. https://arxiv.org/abs/2307.03172
- *
- * Input:  [d1, d2, d3, d4, d5]  (sorted by relevance, descending)
- * Output: [d1, d3, d5, d4, d2]  (most relevant at edges, least in middle)
- *
- * Algorithm:
- *   - Items at even positions in the input (0, 2, 4, …) fill from the front.
- *   - Items at odd positions in the input (1, 3, 5, …) fill from the back.
- *
- * @param docs - Array sorted by relevance (most relevant first).
- * @returns A new array reordered so the most relevant items sit at the edges.
- */
-export declare function zigzagOrder<T>(docs: T[]): T[];
-//# sourceMappingURL=compositor-utils.d.ts.map

package/dist/compositor-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compositor-utils.d.ts","sourceRoot":"","sources":["../src/compositor-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAkB7C"}

package/dist/compositor-utils.js

@@ -1,47 +0,0 @@
-/**
- * compositor-utils.ts — Utility functions for context window composition.
- *
- * Provides ordering strategies that improve LLM attention over retrieved
- * documents placed into a prompt.
- */
-/**
- * Reorder documents using zigzag placement to mitigate
- * "Lost in the Middle" attention degradation in LLMs.
- *
- * LLMs exhibit a U-shaped attention curve: items at the beginning and end
- * of context receive ~30% more attention than items in the middle.
- * This function places the most relevant items at the edges and the least
- * relevant items near the center, maximising effective attention on the
- * information that matters most.
- *
- * Reference: Liu et al., "Lost in the Middle: How Language Models Use Long
- * Contexts", ICLR 2025. https://arxiv.org/abs/2307.03172
- *
- * Input:  [d1, d2, d3, d4, d5]  (sorted by relevance, descending)
- * Output: [d1, d3, d5, d4, d2]  (most relevant at edges, least in middle)
- *
- * Algorithm:
- *   - Items at even positions in the input (0, 2, 4, …) fill from the front.
- *   - Items at odd positions in the input (1, 3, 5, …) fill from the back.
- *
- * @param docs - Array sorted by relevance (most relevant first).
- * @returns A new array reordered so the most relevant items sit at the edges.
- */
-export function zigzagOrder(docs) {
-    if (docs.length <= 2) {
-        return docs.slice();
-    }
-    const result = new Array(docs.length);
-    let front = 0;
-    let back = docs.length - 1;
-    for (let i = 0; i < docs.length; i++) {
-        if (i % 2 === 0) {
-            result[front++] = docs[i];
-        }
-        else {
-            result[back--] = docs[i];
-        }
-    }
-    return result;
-}
-//# sourceMappingURL=compositor-utils.js.map