audrey 0.17.0 → 0.20.0

package/dist/src/capsule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsule.d.ts","sourceRoot":"","sources":["../../src/capsule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAgB,aAAa,EAAc,WAAW,EAAE,MAAM,YAAY,CAAC;AAGvF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,eAAe,CAAC;AAExG,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE;QACN,IAAI,EAAE,WAAW,CAAC;QAClB,0BAA0B,EAAE,MAAM,CAAC;KACpC,CAAC;IACF,QAAQ,EAAE;QACR,WAAW,EAAE,YAAY,EAAE,CAAC;QAC5B,aAAa,EAAE,YAAY,EAAE,CAAC;QAC9B,gBAAgB,EAAE,YAAY,EAAE,CAAC;QACjC,UAAU,EAAE,YAAY,EAAE,CAAC;QAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;QACtB,cAAc,EAAE,YAAY,EAAE,CAAC;QAC/B,cAAc,EAAE,YAAY,EAAE,CAAC;QAC/B,qBAAqB,EAAE,YAAY,EAAE,CAAC;KACvC,CAAC;IACF,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AA+MD,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA4IxB"}

package/dist/src/capsule.js

@@ -0,0 +1,311 @@
+/**
+ * Memory Capsule — structured, evidence-backed retrieval packet.
+ *
+ * Replaces "loose list of relevant memories" with a ranked, categorized,
+ * token-budgeted, explainable packet organized into nine sections:
+ *   must_follow       — rules the agent must respect this turn
+ *   project_facts     — stable facts about entities/concepts in the project
+ *   user_preferences  — how this user works (told-by-user or tagged preference)
+ *   procedures        — procedural memories the agent should apply
+ *   risks             — recent failures + memories tagged risk/warning/failure
+ *   recent_changes    — memories created or reinforced in the last N hours
+ *   contradictions    — open contradictions in the memory store
+ *   uncertain_or_disputed — low-confidence or disputed-state memories
+ *   evidence          — IDs of every memory referenced in the other sections
+ *
+ * Every entry carries a `reason` explaining why it was included.
+ */
+import { recentFailures } from './events.js';
+const MUST_FOLLOW_TAGS = new Set(['must-follow', 'must', 'required', 'never', 'always', 'policy']);
+const PREFERENCE_TAGS = new Set(['preference', 'prefers', 'user-preference']);
+const RISK_TAGS = new Set(['risk', 'warning', 'failure', 'failure-prevention', 'danger']);
+const PROCEDURE_TAGS = new Set(['procedure', 'playbook', 'howto', 'workflow']);
+const SECTION_PRIORITY = [
+    'must_follow',
+    'risks',
+    'contradictions',
+    'procedures',
+    'project_facts',
+    'user_preferences',
+    'recent_changes',
+    'uncertain_or_disputed',
+];
+function parseTags(raw) {
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed))
+            return parsed.map(String);
+    }
+    catch {
+        // fall through: some rows may have been stored as comma-separated
+    }
+    return String(raw).split(',').map(t => t.trim()).filter(Boolean);
+}
+function parseEvidence(raw) {
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed))
+            return parsed.map(String);
+    }
+    catch {
+        // ignore
+    }
+    return [];
+}
+function memoryTypeOf(t) {
+    if (t === 'episodic')
+        return 'episode';
+    if (t === 'procedural')
+        return 'procedural';
+    return 'semantic';
+}
+function withinWindow(createdAt, windowMs) {
+    if (!createdAt)
+        return false;
+    const t = Date.parse(createdAt);
+    if (!Number.isFinite(t))
+        return false;
+    return Date.now() - t <= windowMs;
+}
+function hashMatchesAny(tags, pool) {
+    for (const tag of tags) {
+        if (pool.has(tag.toLowerCase()))
+            return true;
+    }
+    return false;
+}
+function buildRecallEntry(result, enrichment, reason) {
+    return {
+        memory_id: result.id,
+        memory_type: memoryTypeOf(result.type),
+        content: result.content,
+        confidence: result.confidence,
+        scope: enrichment.scope,
+        evidence: enrichment.evidence.length > 0 ? enrichment.evidence : undefined,
+        reason,
+        source: result.source,
+        tags: enrichment.tags.length > 0 ? enrichment.tags : undefined,
+        state: result.state,
+        created_at: result.createdAt,
+    };
+}
+function buildFailureEntry(f, reason) {
+    const toolLabel = f.tool_name || 'unknown tool';
+    const summary = f.last_error_summary
+        ? `${toolLabel} failed ${f.failure_count}x recently — last error: ${f.last_error_summary}`
+        : `${toolLabel} failed ${f.failure_count}x recently`;
+    return {
+        memory_id: `failure:${f.tool_name}:${f.last_failed_at}`,
+        memory_type: 'tool_failure',
+        content: summary,
+        confidence: Math.min(0.5 + (f.failure_count - 1) * 0.1, 0.95),
+        reason,
+        created_at: f.last_failed_at,
+        recommended_action: `Before re-running ${toolLabel}, check preflight conditions from the last failure.`,
+    };
+}
+function buildContradictionEntry(row, reason) {
+    return {
+        memory_id: row.id,
+        memory_type: 'contradiction',
+        content: `Contradiction between ${row.claim_a_type}:${row.claim_a_id} and ${row.claim_b_type}:${row.claim_b_id}`,
+        confidence: 0.5,
+        reason,
+        created_at: row.created_at,
+        state: 'disputed',
+        evidence: [row.claim_a_id, row.claim_b_id],
+        recommended_action: 'Resolve or mark context_dependent before acting on either claim.',
+    };
+}
+function loadEpisodeEnrichment(db, id) {
+    return db.prepare(`SELECT id, tags, source, created_at, private, agent FROM episodes WHERE id = ?`).get(id);
+}
+function loadSemanticEnrichment(db, id) {
+    return db.prepare(`SELECT id, state, evidence_episode_ids, created_at, last_reinforced_at FROM semantics WHERE id = ?`).get(id);
+}
+function loadProcedureEnrichment(db, id) {
+    return db.prepare(`SELECT id, state, evidence_episode_ids, created_at, last_reinforced_at FROM procedures WHERE id = ?`).get(id);
+}
+function loadOpenContradictions(db, limit) {
+    return db.prepare(`SELECT id, claim_a_id, claim_b_id, claim_a_type, claim_b_type, state, created_at
+     FROM contradictions
+     WHERE state = 'open'
+     ORDER BY created_at DESC
+     LIMIT ?`).all(limit);
+}
+function categorize(entry, result, tags, recentWindowMs) {
+    const sections = new Set();
+    const lowerTags = tags.map(t => t.toLowerCase());
+    if (hashMatchesAny(lowerTags, MUST_FOLLOW_TAGS)) {
+        sections.add('must_follow');
+    }
+    if (hashMatchesAny(lowerTags, RISK_TAGS)) {
+        sections.add('risks');
+    }
+    if (entry.memory_type === 'procedural' || hashMatchesAny(lowerTags, PROCEDURE_TAGS)) {
+        sections.add('procedures');
+    }
+    if (hashMatchesAny(lowerTags, PREFERENCE_TAGS) || result.source === 'told-by-user') {
+        sections.add('user_preferences');
+    }
+    if (entry.state === 'disputed' || entry.state === 'context_dependent' || result.confidence < 0.55) {
+        sections.add('uncertain_or_disputed');
+    }
+    if (withinWindow(result.createdAt, recentWindowMs)) {
+        sections.add('recent_changes');
+    }
+    if (sections.size === 0) {
+        if (entry.memory_type === 'semantic') {
+            sections.add('project_facts');
+        }
+        else if (entry.memory_type === 'episode') {
+            sections.add('project_facts');
+        }
+    }
+    return [...sections];
+}
+function charsOf(entry) {
+    return entry.content.length + (entry.recommended_action?.length ?? 0);
+}
+export async function buildCapsule(audrey, query, options = {}) {
+    const mode = options.mode
+        ?? (process.env['AUDREY_CAPSULE_MODE'] ?? 'balanced');
+    const budgetChars = options.budgetChars
+        ?? Number.parseInt(process.env['AUDREY_CONTEXT_BUDGET_CHARS'] ?? '4000', 10);
+    const recentChangeWindowHours = options.recentChangeWindowHours ?? 24;
+    const recallLimit = options.limit ?? (mode === 'conservative' ? 8 : mode === 'aggressive' ? 24 : 16);
+    const recentWindowMs = recentChangeWindowHours * 60 * 60 * 1000;
+    const includeRisks = options.includeRisks ?? true;
+    const includeContradictions = options.includeContradictions ?? true;
+    const sections = {
+        must_follow: [],
+        project_facts: [],
+        user_preferences: [],
+        procedures: [],
+        risks: [],
+        recent_changes: [],
+        contradictions: [],
+        uncertain_or_disputed: [],
+    };
+    const evidenceIds = new Set();
+    const seenPerSection = new Map();
+    function push(section, entry) {
+        let seen = seenPerSection.get(section);
+        if (!seen) {
+            seen = new Set();
+            seenPerSection.set(section, seen);
+        }
+        if (seen.has(entry.memory_id))
+            return;
+        seen.add(entry.memory_id);
+        sections[section].push(entry);
+        evidenceIds.add(entry.memory_id);
+        for (const id of entry.evidence ?? [])
+            evidenceIds.add(id);
+    }
+    // 1. Primary recall (vector + confidence scoring)
+    const results = await audrey.recall(query, {
+        limit: recallLimit,
+        ...(options.recall ?? {}),
+    });
+    const db = audrey.db;
+    for (const result of results) {
+        let tags = [];
+        let evidence = [];
+        let scope;
+        if (result.type === 'episodic') {
+            const row = loadEpisodeEnrichment(db, result.id);
+            tags = parseTags(row?.tags);
+            scope = row?.agent ? `agent:${row.agent}` : undefined;
+        }
+        else if (result.type === 'semantic') {
+            const row = loadSemanticEnrichment(db, result.id);
+            evidence = parseEvidence(row?.evidence_episode_ids);
+        }
+        else if (result.type === 'procedural') {
+            const row = loadProcedureEnrichment(db, result.id);
+            evidence = parseEvidence(row?.evidence_episode_ids);
+        }
+        const entry = buildRecallEntry(result, { tags, evidence, scope }, 'Matched query via semantic similarity.');
+        const assigned = categorize(entry, result, tags, recentWindowMs);
+        for (const section of assigned) {
+            const entryForSection = { ...entry };
+            if (section === 'recent_changes') {
+                entryForSection.reason = 'Created or reinforced inside the recent-change window.';
+            }
+            else if (section === 'must_follow') {
+                entryForSection.reason = 'Tagged as a must-follow rule.';
+            }
+            else if (section === 'procedures') {
+                entryForSection.reason = entry.memory_type === 'procedural' ? 'Procedural memory matching query.' : 'Tagged as a procedure.';
+            }
+            else if (section === 'user_preferences') {
+                entryForSection.reason = result.source === 'told-by-user' ? 'User-stated preference.' : 'Tagged as a user preference.';
+            }
+            else if (section === 'risks') {
+                entryForSection.reason = 'Tagged as a risk or warning.';
+            }
+            else if (section === 'uncertain_or_disputed') {
+                entryForSection.reason = entry.state === 'disputed' ? 'Disputed memory.' : 'Low-confidence memory.';
+            }
+            push(section, entryForSection);
+        }
+    }
+    // 2. Tool-failure risks from memory_events
+    if (includeRisks) {
+        const failures = recentFailures(db, { since: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString(), limit: 5 });
+        for (const failure of failures) {
+            push('risks', buildFailureEntry(failure, `Tool ${failure.tool_name ?? '(unknown)'} failed recently; treat as preflight warning.`));
+        }
+    }
+    // 3. Open contradictions
+    if (includeContradictions) {
+        const contradictions = loadOpenContradictions(db, 5);
+        for (const row of contradictions) {
+            push('contradictions', buildContradictionEntry(row, 'Open contradiction — both sides referenced in capsule.'));
+        }
+    }
+    // 4. Enforce the token budget. Iterate sections in priority order and trim.
+    let usedChars = 0;
+    let truncated = false;
+    const prunedSections = {
+        must_follow: [],
+        project_facts: [],
+        user_preferences: [],
+        procedures: [],
+        risks: [],
+        recent_changes: [],
+        contradictions: [],
+        uncertain_or_disputed: [],
+    };
+    for (const section of SECTION_PRIORITY) {
+        const ordered = [...sections[section]].sort((a, b) => b.confidence - a.confidence);
+        for (const entry of ordered) {
+            const cost = charsOf(entry);
+            if (usedChars + cost > budgetChars) {
+                truncated = true;
+                continue;
+            }
+            prunedSections[section].push(entry);
+            usedChars += cost;
+        }
+    }
+    return {
+        query,
+        generated_at: new Date().toISOString(),
+        budget_chars: budgetChars,
+        used_chars: usedChars,
+        truncated,
+        policy: {
+            mode,
+            recent_change_window_hours: recentChangeWindowHours,
+        },
+        sections: prunedSections,
+        evidence_ids: [...evidenceIds],
+    };
+}
+//# sourceMappingURL=capsule.js.map

package/dist/src/capsule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsule.js","sourceRoot":"","sources":["../../src/capsule.ts"],"names":[],"mappings":"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"}

package/dist/src/causal.d.ts

@@ -0,0 +1,28 @@
+import Database from 'better-sqlite3';
+import type { CausalLinkRow, LLMProvider } from './types.js';
+export declare function addCausalLink(db: Database.Database, { causeId, effectId, linkType, mechanism, confidence }: {
+    causeId: string;
+    effectId: string;
+    linkType?: string;
+    mechanism?: string;
+    confidence?: number;
+}): string;
+export declare function getCausalChain(db: Database.Database, memoryId: string, options?: {
+    depth?: number;
+}): CausalLinkRow[];
+export declare function articulateCausalLink(db: Database.Database, llmProvider: LLMProvider, cause: {
+    id: string;
+    content: string;
+    source: string;
+}, effect: {
+    id: string;
+    content: string;
+    source: string;
+}): Promise<{
+    linkId: string | null;
+    mechanism: string;
+    linkType: string;
+    confidence: number;
+    spurious: boolean;
+}>;
+//# sourceMappingURL=causal.d.ts.map

package/dist/src/causal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"causal.d.ts","sourceRoot":"","sources":["../../src/causal.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI7D,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAmB,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,MAAM,CAUR;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,aAAa,EAAE,CA8BjB;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACtD,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC,CAkCD"}

package/dist/src/causal.js

@@ -0,0 +1,65 @@
+import { generateId } from './ulid.js';
+import { buildCausalArticulationPrompt } from './prompts.js';
+export function addCausalLink(db, { causeId, effectId, linkType = 'causal', mechanism, confidence }) {
+    const id = generateId();
+    const now = new Date().toISOString();
+    db.prepare(`
+    INSERT INTO causal_links (id, cause_id, effect_id, link_type, mechanism, confidence, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `).run(id, causeId, effectId, linkType, mechanism, confidence, now);
+    return id;
+}
+export function getCausalChain(db, memoryId, options = {}) {
+    const { depth = 10 } = options;
+    const results = [];
+    const visited = new Set();
+    const queue = [memoryId];
+    let currentDepth = 0;
+    while (queue.length > 0 && currentDepth < depth) {
+        const nextQueue = [];
+        for (const nodeId of queue) {
+            if (visited.has(nodeId))
+                continue;
+            visited.add(nodeId);
+            const links = db.prepare('SELECT * FROM causal_links WHERE cause_id = ?').all(nodeId);
+            for (const link of links) {
+                if (!visited.has(link.effect_id)) {
+                    results.push(link);
+                    nextQueue.push(link.effect_id);
+                }
+            }
+        }
+        queue.length = 0;
+        queue.push(...nextQueue);
+        currentDepth++;
+    }
+    return results;
+}
+export async function articulateCausalLink(db, llmProvider, cause, effect) {
+    const messages = buildCausalArticulationPrompt(cause, effect);
+    const result = await llmProvider.json(messages);
+    if (result.spurious) {
+        return {
+            linkId: null,
+            mechanism: result.mechanism,
+            linkType: result.linkType,
+            confidence: result.confidence,
+            spurious: true,
+        };
+    }
+    const linkId = addCausalLink(db, {
+        causeId: cause.id,
+        effectId: effect.id,
+        linkType: result.linkType || 'correlational',
+        mechanism: result.mechanism,
+        confidence: result.confidence,
+    });
+    return {
+        linkId,
+        mechanism: result.mechanism,
+        linkType: result.linkType,
+        confidence: result.confidence,
+        spurious: false,
+    };
+}
+//# sourceMappingURL=causal.js.map

package/dist/src/causal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"causal.js","sourceRoot":"","sources":["../../src/causal.ts"],"names":[],"mappings":"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"}

package/dist/src/confidence.d.ts

@@ -0,0 +1,12 @@
+import type { ConfidenceWeights, HalfLives, SourceReliabilityMap, ComputeConfidenceParams } from './types.js';
+export declare const DEFAULT_SOURCE_RELIABILITY: SourceReliabilityMap;
+export declare const DEFAULT_WEIGHTS: ConfidenceWeights;
+export declare const DEFAULT_HALF_LIVES: HalfLives;
+export declare const MODEL_GENERATED_CONFIDENCE_CAP: number;
+export declare function sourceReliability(sourceType: string, customReliability?: SourceReliabilityMap): number;
+export declare function evidenceAgreement(supportingCount: number, contradictingCount: number): number;
+export declare function recencyDecay(ageDays: number, halfLifeDays: number): number;
+export declare function retrievalReinforcement(retrievalCount: number, daysSinceRetrieval: number): number;
+export declare function salienceModifier(salience?: number | null): number;
+export declare function computeConfidence({ sourceType, supportingCount, contradictingCount, ageDays, halfLifeDays, retrievalCount, daysSinceRetrieval, weights, customSourceReliability, }: ComputeConfidenceParams): number;
+//# sourceMappingURL=confidence.d.ts.map

package/dist/src/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../src/confidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE9G,eAAO,MAAM,0BAA0B,EAAE,oBAMxC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,iBAK7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,SAIhC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,MAAY,CAAC;AAE1D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAOtG;AAED,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAI7F;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAOjG;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGjE;AAED,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,OAAO,EACP,uBAAuB,GACxB,EAAE,uBAAuB,GAAG,MAAM,CAelC"}

package/dist/src/confidence.js

@@ -0,0 +1,63 @@
+export const DEFAULT_SOURCE_RELIABILITY = {
+    'direct-observation': 0.95,
+    'told-by-user': 0.90,
+    'tool-result': 0.85,
+    'inference': 0.60,
+    'model-generated': 0.40,
+};
+export const DEFAULT_WEIGHTS = {
+    source: 0.30,
+    evidence: 0.35,
+    recency: 0.20,
+    retrieval: 0.15,
+};
+export const DEFAULT_HALF_LIVES = {
+    episodic: 7,
+    semantic: 30,
+    procedural: 90,
+};
+export const MODEL_GENERATED_CONFIDENCE_CAP = 0.6;
+export function sourceReliability(sourceType, customReliability) {
+    const table = customReliability || DEFAULT_SOURCE_RELIABILITY;
+    const value = table[sourceType];
+    if (value === undefined) {
+        throw new Error(`Unknown source type: ${sourceType}. Valid types: ${Object.keys(table).join(', ')}`);
+    }
+    return value;
+}
+export function evidenceAgreement(supportingCount, contradictingCount) {
+    const total = supportingCount + contradictingCount;
+    if (total === 0)
+        return 1.0;
+    return supportingCount / total;
+}
+export function recencyDecay(ageDays, halfLifeDays) {
+    const lambda = Math.LN2 / halfLifeDays;
+    return Math.exp(-lambda * ageDays);
+}
+export function retrievalReinforcement(retrievalCount, daysSinceRetrieval) {
+    if (retrievalCount === 0)
+        return 0;
+    const lambdaRet = Math.LN2 / 14;
+    const baseReinforcement = 0.3 * Math.log(1 + retrievalCount);
+    const recencyWeight = Math.exp(-lambdaRet * daysSinceRetrieval);
+    const spacedBonus = Math.min(0.15, 0.02 * Math.log(1 + daysSinceRetrieval));
+    return Math.min(1.0, baseReinforcement * recencyWeight + spacedBonus);
+}
+export function salienceModifier(salience) {
+    const s = salience ?? 0.5;
+    return 0.5 + s;
+}
+export function computeConfidence({ sourceType, supportingCount, contradictingCount, ageDays, halfLifeDays, retrievalCount, daysSinceRetrieval, weights, customSourceReliability, }) {
+    const w = weights || DEFAULT_WEIGHTS;
+    const s = sourceReliability(sourceType, customSourceReliability);
+    const e = evidenceAgreement(supportingCount, contradictingCount);
+    const r = recencyDecay(ageDays, halfLifeDays);
+    const ret = retrievalReinforcement(retrievalCount, daysSinceRetrieval);
+    let confidence = w.source * s + w.evidence * e + w.recency * r + w.retrieval * ret;
+    if (sourceType === 'model-generated') {
+        confidence = Math.min(confidence, MODEL_GENERATED_CONFIDENCE_CAP);
+    }
+    return Math.max(0, Math.min(1, confidence));
+}
+//# sourceMappingURL=confidence.js.map

package/dist/src/confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../src/confidence.ts"],"names":[],"mappings":"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"}

package/dist/src/consolidate.d.ts

@@ -0,0 +1,8 @@
+import Database from 'better-sqlite3';
+import type { ConsolidationOptions, ConsolidationResult, EmbeddingProvider, EpisodeRow } from './types.js';
+export declare function clusterEpisodes(db: Database.Database, embeddingProvider: EmbeddingProvider, options?: {
+    similarityThreshold?: number;
+    minClusterSize?: number;
+}): EpisodeRow[][];
+export declare function runConsolidation(db: Database.Database, embeddingProvider: EmbeddingProvider, options?: ConsolidationOptions): Promise<ConsolidationResult>;
+//# sourceMappingURL=consolidate.d.ts.map

package/dist/src/consolidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.d.ts","sourceRoot":"","sources":["../../src/consolidate.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EAGX,MAAM,YAAY,CAAC;AAqFpB,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACtE,UAAU,EAAE,EAAE,CAahB;AA6BD,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAmL9B"}