@dmsdc-ai/aigentry-brain 0.0.1

package/dist/context/ContextBudgetPolicy.js

@@ -0,0 +1,136 @@
+const INPUT_RATIO = 0.78;
+const OUTPUT_RATIO = 0.22;
+const OUTPUT_MIN = 900;
+const INPUT_MIN = 512;
+const MUST_KEEP_ABS_CAP = 2200;
+const MUST_KEEP_RATIO_CAP = 0.18;
+const RECALL_CONFIDENCE_THRESHOLD = 0.65;
+const FIXED_MIN_RATIOS = {
+    systemPolicy: 0.08,
+    userRequest: 0.10,
+    mustKeep: 0.12,
+};
+const VARIABLE_RANGES = {
+    conversationSummary: { min: 0.08, max: 0.18 },
+    retrievalEvidence: { min: 0.20, max: 0.40 },
+    repackBuffer: { min: 0.10, max: 0.25 },
+};
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+function modeTargets(mode) {
+    if (mode === 'qa') {
+        return {
+            conversationSummary: 0.08,
+            retrievalEvidence: 0.40,
+            repackBuffer: 0.12,
+        };
+    }
+    if (mode === 'coding') {
+        return {
+            conversationSummary: 0.10,
+            retrievalEvidence: 0.30,
+            repackBuffer: 0.20,
+        };
+    }
+    return {
+        conversationSummary: 0.18,
+        retrievalEvidence: 0.22,
+        repackBuffer: 0.20,
+    };
+}
+function ratioToTokens(total, ratio) {
+    return Math.max(0, Math.floor(total * ratio));
+}
+function adjustTargetsToBudget(inputBudget, targets) {
+    const adjusted = { ...targets };
+    let total = Object.values(adjusted).reduce((sum, value) => sum + value, 0);
+    if (total > inputBudget) {
+        const reductionOrder = [
+            'repackBuffer',
+            'retrievalEvidence',
+            'conversationSummary',
+            'mustKeep',
+            'userRequest',
+            'systemPolicy',
+        ];
+        let overflow = total - inputBudget;
+        for (const key of reductionOrder) {
+            if (overflow <= 0)
+                break;
+            const reducible = Math.min(adjusted[key], overflow);
+            adjusted[key] -= reducible;
+            overflow -= reducible;
+        }
+    }
+    else if (total < inputBudget) {
+        adjusted.repackBuffer += (inputBudget - total);
+    }
+    total = Object.values(adjusted).reduce((sum, value) => sum + value, 0);
+    if (total !== inputBudget) {
+        adjusted.repackBuffer += (inputBudget - total);
+    }
+    return adjusted;
+}
+export function buildContextBudgetPlan(windowTokens, mode = 'coding') {
+    if (!Number.isFinite(windowTokens) || windowTokens <= 0) {
+        throw new Error('windowTokens must be a positive number');
+    }
+    const rawOutput = Math.max(Math.floor(windowTokens * OUTPUT_RATIO), OUTPUT_MIN);
+    const outputReserve = Math.min(rawOutput, Math.max(0, windowTokens - INPUT_MIN));
+    const inputBudget = Math.max(0, windowTokens - outputReserve);
+    const fixedMinTokens = {
+        systemPolicy: ratioToTokens(inputBudget, FIXED_MIN_RATIOS.systemPolicy),
+        userRequest: ratioToTokens(inputBudget, FIXED_MIN_RATIOS.userRequest),
+        mustKeep: ratioToTokens(inputBudget, FIXED_MIN_RATIOS.mustKeep),
+    };
+    const rawTargets = modeTargets(mode);
+    const variableTargetTokens = {
+        conversationSummary: ratioToTokens(inputBudget, clamp(rawTargets.conversationSummary, VARIABLE_RANGES.conversationSummary.min, VARIABLE_RANGES.conversationSummary.max)),
+        retrievalEvidence: ratioToTokens(inputBudget, clamp(rawTargets.retrievalEvidence, VARIABLE_RANGES.retrievalEvidence.min, VARIABLE_RANGES.retrievalEvidence.max)),
+        repackBuffer: ratioToTokens(inputBudget, clamp(rawTargets.repackBuffer, VARIABLE_RANGES.repackBuffer.min, VARIABLE_RANGES.repackBuffer.max)),
+    };
+    const adjustedTargets = adjustTargetsToBudget(inputBudget, {
+        systemPolicy: fixedMinTokens.systemPolicy,
+        userRequest: fixedMinTokens.userRequest,
+        mustKeep: fixedMinTokens.mustKeep,
+        conversationSummary: variableTargetTokens.conversationSummary,
+        retrievalEvidence: variableTargetTokens.retrievalEvidence,
+        repackBuffer: variableTargetTokens.repackBuffer,
+    });
+    const mustKeepCap = Math.min(MUST_KEEP_ABS_CAP, Math.floor(windowTokens * MUST_KEEP_RATIO_CAP));
+    return {
+        windowTokens,
+        inputBudget,
+        outputReserve,
+        mustKeepCap,
+        recallConfidenceThreshold: RECALL_CONFIDENCE_THRESHOLD,
+        slots: {
+            systemPolicy: {
+                minTokens: fixedMinTokens.systemPolicy,
+                targetTokens: adjustedTargets.systemPolicy,
+            },
+            userRequest: {
+                minTokens: fixedMinTokens.userRequest,
+                targetTokens: adjustedTargets.userRequest,
+            },
+            mustKeep: {
+                minTokens: fixedMinTokens.mustKeep,
+                targetTokens: adjustedTargets.mustKeep,
+            },
+            conversationSummary: {
+                minTokens: ratioToTokens(inputBudget, VARIABLE_RANGES.conversationSummary.min),
+                targetTokens: adjustedTargets.conversationSummary,
+            },
+            retrievalEvidence: {
+                minTokens: ratioToTokens(inputBudget, VARIABLE_RANGES.retrievalEvidence.min),
+                targetTokens: adjustedTargets.retrievalEvidence,
+            },
+            repackBuffer: {
+                minTokens: ratioToTokens(inputBudget, VARIABLE_RANGES.repackBuffer.min),
+                targetTokens: adjustedTargets.repackBuffer,
+            },
+        },
+    };
+}
+//# sourceMappingURL=ContextBudgetPolicy.js.map

package/dist/context/ContextBudgetPolicy.js.map

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

package/dist/context/ContextPacker.d.ts

@@ -0,0 +1,30 @@
+import type { ContextMode, ContextBudgetPlan } from './ContextBudgetPolicy.js';
+export type ContextSlot = 'system_policy' | 'user_request' | 'must_keep' | 'conversation_summary' | 'retrieval_evidence';
+export interface ContextBlock {
+    id: string;
+    slot: ContextSlot;
+    text: string;
+    tokens: number;
+    score?: number;
+    timestamp?: string;
+    duplicateKey?: string;
+    required?: boolean;
+    compressed?: boolean;
+}
+export interface PackContextInput {
+    windowTokens: number;
+    mode?: ContextMode;
+    blocks: ContextBlock[];
+    confidenceThreshold?: number;
+}
+export interface PackedContextResult {
+    plan: ContextBudgetPlan;
+    selected: ContextBlock[];
+    dropped: ContextBlock[];
+    usedInputTokens: number;
+    slotUsage: Record<ContextSlot, number>;
+    overflowHandled: boolean;
+    recallConfidence: number;
+    shouldAskClarification: boolean;
+}
+export declare function packContext(input: PackContextInput): PackedContextResult;

package/dist/context/ContextPacker.js

@@ -0,0 +1,219 @@
+import { buildContextBudgetPlan } from './ContextBudgetPolicy.js';
+import { evaluateRecallConfidence } from './ConfidenceGuard.js';
+const SLOT_BUDGET_KEY = {
+    system_policy: 'systemPolicy',
+    user_request: 'userRequest',
+    must_keep: 'mustKeep',
+    conversation_summary: 'conversationSummary',
+    retrieval_evidence: 'retrievalEvidence',
+};
+function tokenSum(items) {
+    return items.reduce((sum, item) => sum + item.tokens, 0);
+}
+function parseTimestamp(value) {
+    if (!value)
+        return 0;
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? 0 : parsed;
+}
+function scoreValue(block) {
+    return block.score ?? 0;
+}
+function byPriorityDesc(a, b) {
+    const reqA = a.required ? 1 : 0;
+    const reqB = b.required ? 1 : 0;
+    if (reqA !== reqB)
+        return reqB - reqA;
+    const scoreA = scoreValue(a);
+    const scoreB = scoreValue(b);
+    if (scoreA !== scoreB)
+        return scoreB - scoreA;
+    const tsA = parseTimestamp(a.timestamp);
+    const tsB = parseTimestamp(b.timestamp);
+    if (tsA !== tsB)
+        return tsB - tsA;
+    return a.id.localeCompare(b.id);
+}
+function cloneBlock(block) {
+    return { ...block };
+}
+function takeWithinBudget(sortedBlocks, budgetTokens) {
+    const selected = [];
+    const dropped = [];
+    let used = 0;
+    for (const block of sortedBlocks) {
+        const next = cloneBlock(block);
+        if (used + next.tokens <= budgetTokens || (next.required && selected.length === 0)) {
+            selected.push(next);
+            used += next.tokens;
+            continue;
+        }
+        dropped.push(next);
+    }
+    return { selected, dropped };
+}
+function dropLowestScoreEvidence(selected, dropped) {
+    const evidence = selected
+        .filter(item => item.slot === 'retrieval_evidence' && !item.required)
+        .sort((a, b) => {
+        const scoreDiff = scoreValue(a) - scoreValue(b);
+        if (scoreDiff !== 0)
+            return scoreDiff;
+        return parseTimestamp(a.timestamp) - parseTimestamp(b.timestamp);
+    });
+    const target = evidence[0];
+    if (!target)
+        return false;
+    const idx = selected.findIndex(item => item.id === target.id);
+    if (idx === -1)
+        return false;
+    dropped.push(selected[idx]);
+    selected.splice(idx, 1);
+    return true;
+}
+function dropOldestSummary(selected, dropped) {
+    const summaries = selected
+        .filter(item => item.slot === 'conversation_summary' && !item.required)
+        .sort((a, b) => parseTimestamp(a.timestamp) - parseTimestamp(b.timestamp));
+    const target = summaries[0];
+    if (!target)
+        return false;
+    const idx = selected.findIndex(item => item.id === target.id);
+    if (idx === -1)
+        return false;
+    dropped.push(selected[idx]);
+    selected.splice(idx, 1);
+    return true;
+}
+function dropDuplicateMemory(selected, dropped) {
+    const byKey = new Map();
+    for (const item of selected) {
+        if (!item.duplicateKey)
+            continue;
+        const list = byKey.get(item.duplicateKey) ?? [];
+        list.push(item);
+        byKey.set(item.duplicateKey, list);
+    }
+    for (const items of byKey.values()) {
+        if (items.length <= 1)
+            continue;
+        const ranked = [...items].sort(byPriorityDesc);
+        const keep = ranked[0];
+        for (const candidate of ranked.slice(1)) {
+            if (candidate.required)
+                continue;
+            const idx = selected.findIndex(item => item.id === candidate.id);
+            if (idx !== -1 && selected[idx].id !== keep.id) {
+                dropped.push(selected[idx]);
+                selected.splice(idx, 1);
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function compressLowPriorityBlocks(selected, budget) {
+    let changed = false;
+    let used = tokenSum(selected);
+    if (used <= budget)
+        return false;
+    const compressCandidates = selected
+        .filter(item => !item.required && !item.compressed)
+        .sort((a, b) => {
+        const rankA = a.slot === 'retrieval_evidence' ? 0 : 1;
+        const rankB = b.slot === 'retrieval_evidence' ? 0 : 1;
+        if (rankA !== rankB)
+            return rankA - rankB;
+        return scoreValue(a) - scoreValue(b);
+    });
+    for (const block of compressCandidates) {
+        if (used <= budget)
+            break;
+        const compressedTokens = Math.max(8, Math.ceil(block.tokens * 0.65));
+        if (compressedTokens >= block.tokens)
+            continue;
+        used -= (block.tokens - compressedTokens);
+        block.tokens = compressedTokens;
+        block.compressed = true;
+        changed = true;
+    }
+    return changed;
+}
+function runOverflowChain(selected, dropped, inputBudget) {
+    let handled = false;
+    while (tokenSum(selected) > inputBudget) {
+        if (dropLowestScoreEvidence(selected, dropped)) {
+            handled = true;
+            continue;
+        }
+        if (dropOldestSummary(selected, dropped)) {
+            handled = true;
+            continue;
+        }
+        if (dropDuplicateMemory(selected, dropped)) {
+            handled = true;
+            continue;
+        }
+        if (compressLowPriorityBlocks(selected, inputBudget)) {
+            handled = true;
+            continue;
+        }
+        break;
+    }
+    return handled;
+}
+export function packContext(input) {
+    const mode = input.mode ?? 'coding';
+    const plan = buildContextBudgetPlan(input.windowTokens, mode);
+    const slotBuckets = plan.slots;
+    const bySlot = {
+        system_policy: [],
+        user_request: [],
+        must_keep: [],
+        conversation_summary: [],
+        retrieval_evidence: [],
+    };
+    for (const block of input.blocks) {
+        if (block.tokens <= 0)
+            continue;
+        bySlot[block.slot].push(block);
+    }
+    let selected = [];
+    let dropped = [];
+    for (const slot of Object.keys(bySlot)) {
+        const sorted = [...bySlot[slot]].sort(byPriorityDesc);
+        const budgetKey = SLOT_BUDGET_KEY[slot];
+        let slotBudget = slotBuckets[budgetKey].targetTokens;
+        if (slot === 'must_keep') {
+            slotBudget = Math.min(slotBudget, plan.mustKeepCap);
+        }
+        const slotResult = takeWithinBudget(sorted, slotBudget);
+        selected = selected.concat(slotResult.selected);
+        dropped = dropped.concat(slotResult.dropped);
+    }
+    const overflowHandled = runOverflowChain(selected, dropped, plan.inputBudget);
+    const slotUsage = {
+        system_policy: 0,
+        user_request: 0,
+        must_keep: 0,
+        conversation_summary: 0,
+        retrieval_evidence: 0,
+    };
+    for (const block of selected) {
+        slotUsage[block.slot] += block.tokens;
+    }
+    const confidence = evaluateRecallConfidence(selected
+        .filter(item => item.slot === 'retrieval_evidence')
+        .map(item => ({ tokens: item.tokens, score: item.score })), input.confidenceThreshold ?? plan.recallConfidenceThreshold);
+    return {
+        plan,
+        selected,
+        dropped,
+        usedInputTokens: tokenSum(selected),
+        slotUsage,
+        overflowHandled,
+        recallConfidence: confidence.recallConfidence,
+        shouldAskClarification: confidence.shouldAskClarification,
+    };
+}
+//# sourceMappingURL=ContextPacker.js.map

package/dist/context/ContextPacker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextPacker.js","sourceRoot":"","sources":["../../src/context/ContextPacker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAuChE,MAAM,eAAe,GAA0D;IAC7E,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,aAAa;IAC3B,SAAS,EAAE,UAAU;IACrB,oBAAoB,EAAE,qBAAqB;IAC3C,kBAAkB,EAAE,mBAAmB;CACxC,CAAC;AAEF,SAAS,QAAQ,CAAC,KAAqB;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC;AAED,SAAS,UAAU,CAAC,KAAmB;IACrC,OAAO,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,CAAe,EAAE,CAAe;IACtD,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC;IAEtC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,GAAG,MAAM,CAAC;IAE9C,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,GAAG,GAAG,GAAG,CAAC;IAElC,OAAO,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,UAAU,CAAC,KAAmB;IACrC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,gBAAgB,CACvB,YAA4B,EAC5B,YAAoB;IAKpB,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACnF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC;YACpB,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,uBAAuB,CAAC,QAAwB,EAAE,OAAuB;IAChF,MAAM,QAAQ,GAAG,QAAQ;SACtB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;SACpE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACtC,OAAO,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IACL,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9D,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAwB,EAAE,OAAuB;IAC1E,MAAM,SAAS,GAAG,QAAQ;SACvB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,sBAAsB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;SACtE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9D,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAwB,EAAE,OAAuB;IAC5E,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,SAAS;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;YAAE,SAAS;QAChC,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,IAAI,SAAS,CAAC,QAAQ;gBAAE,SAAS;YACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC,CAAC;YACjE,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5B,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,yBAAyB,CAChC,QAAwB,EACxB,MAAc;IAEd,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,IAAI,IAAI,MAAM;QAAE,OAAO,KAAK,CAAC;IAEjC,MAAM,kBAAkB,GAAG,QAAQ;SAChC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;SAClD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,KAAK;YAAE,OAAO,KAAK,GAAG,KAAK,CAAC;QAC1C,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEL,KAAK,MAAM,KAAK,IAAI,kBAAkB,EAAE,CAAC;QACvC,IAAI,IAAI,IAAI,MAAM;YAAE,MAAM;QAC1B,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;QACrE,IAAI,gBAAgB,IAAI,KAAK,CAAC,MAAM;YAAE,SAAS;QAC/C,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC;QAC1C,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC;QAChC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;QACxB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CACvB,QAAwB,EACxB,OAAuB,EACvB,WAAmB;IAEnB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,WAAW,EAAE,CAAC;QACxC,IAAI,uBAAuB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;YAC/C,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;YACzC,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;YAC3C,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,yBAAyB,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;YACrD,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,MAAM;IACR,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC;IACpC,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;IAE/B,MAAM,MAAM,GAAwC;QAClD,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,EAAE;QACb,oBAAoB,EAAE,EAAE;QACxB,kBAAkB,EAAE,EAAE;KACvB,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;YAAE,SAAS;QAChC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,QAAQ,GAAmB,EAAE,CAAC;IAClC,IAAI,OAAO,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAkB,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC;QACrD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACxD,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAChD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,eAAe,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAE9E,MAAM,SAAS,GAAgC;QAC7C,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,CAAC;QACf,SAAS,EAAE,CAAC;QACZ,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,CAAC;KACtB,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC;IACxC,CAAC;IAED,MAAM,UAAU,GAAG,wBAAwB,CACzC,QAAQ;SACL,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB,CAAC;SAClD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAC5D,KAAK,CAAC,mBAAmB,IAAI,IAAI,CAAC,yBAAyB,CAC5D,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,OAAO;QACP,eAAe,EAAE,QAAQ,CAAC,QAAQ,CAAC;QACnC,SAAS;QACT,eAAe;QACf,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;QAC7C,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;KAC1D,CAAC;AACJ,CAAC"}

package/dist/context/ContextRestoreService.d.ts

@@ -0,0 +1,39 @@
+import type { ProfileManager } from '../core/ProfileManager.js';
+import type { Entry } from '../core/EntrySchema.js';
+import type { ContextBlock, PackedContextResult } from './ContextPacker.js';
+import type { ContextMode } from './ContextBudgetPolicy.js';
+import type { ResumeResult } from '../metrics/ResumeMetrics.js';
+import type { Clock } from '../shared/Clock.js';
+export interface ContextResumeOptions {
+    windowTokens: number;
+    mode?: ContextMode;
+    confidenceThreshold?: number;
+}
+export interface ContextResumeResult {
+    packed: PackedContextResult;
+    resume: ResumeResult;
+    restoredEntries: Entry[];
+}
+/** Convert a memory Entry to a ContextBlock for the packer. */
+export declare function entryToContextBlock(entry: Entry, nowMs: number): ContextBlock;
+export declare class ContextRestoreService {
+    private profileManager;
+    private clock;
+    constructor(profileManager: ProfileManager, clock?: Clock);
+    /**
+     * Build the Structured Judgment Protocol block (~50 tokens).
+     * Guides the LLM on how to judge what memories to store via brain_append.
+     */
+    private buildJudgmentProtocolBlock;
+    /**
+     * Build the Memory Context block — compact summary of protected entries.
+     * Enables LLM to perform dedup checks and upsert existing memories.
+     */
+    private buildMemoryContextBlock;
+    /**
+     * Restore context from synced profile.
+     * Loads active entries, converts to ContextBlocks, packs within budget.
+     * Includes Layer 1 (Judgment Protocol) and Layer 2 (Memory Context).
+     */
+    restore(options: ContextResumeOptions): Promise<ContextResumeResult>;
+}

package/dist/context/ContextRestoreService.js

@@ -0,0 +1,134 @@
+import { PROTECTED_CATEGORIES } from '../core/ProfileManager.js';
+import { packContext } from './ContextPacker.js';
+import { startResumeTimer } from '../metrics/ResumeMetrics.js';
+import { SystemClock } from '../shared/Clock.js';
+/** Category → ContextSlot mapping */
+const CATEGORY_SLOT_MAP = {
+    preference: 'must_keep',
+    constraint: 'must_keep',
+    identity: 'must_keep',
+    skill: 'must_keep',
+    habit: 'must_keep',
+    summary: 'conversation_summary',
+    decision: 'conversation_summary',
+    context: 'retrieval_evidence',
+    observation: 'retrieval_evidence',
+    fact: 'retrieval_evidence',
+};
+const DEFAULT_SLOT = 'retrieval_evidence';
+/** Rough token estimate: ~4 chars per token (conservative). */
+function estimateTokens(text) {
+    return Math.max(1, Math.ceil(text.length / 4));
+}
+/** Score an entry based on confidence + recency. */
+function scoreEntry(entry, nowMs) {
+    const base = entry.confidence ?? 0.5;
+    const updatedMs = new Date(entry.updated).getTime();
+    const ageMs = Math.max(0, nowMs - updatedMs);
+    const oneDay = 86_400_000;
+    // Recency boost: decays over 30 days (max +0.2 for very recent)
+    const recencyBoost = 0.2 * Math.max(0, 1 - ageMs / (30 * oneDay));
+    return Math.min(1, base + recencyBoost);
+}
+/** Convert a memory Entry to a ContextBlock for the packer. */
+export function entryToContextBlock(entry, nowMs) {
+    const slot = CATEGORY_SLOT_MAP[entry.category] ?? DEFAULT_SLOT;
+    const text = `[${entry.category}] ${entry.content}`;
+    return {
+        id: entry.id,
+        slot,
+        text,
+        tokens: estimateTokens(text),
+        score: scoreEntry(entry, nowMs),
+        timestamp: entry.updated,
+        required: slot === 'must_keep',
+    };
+}
+export class ContextRestoreService {
+    profileManager;
+    clock;
+    constructor(profileManager, clock) {
+        this.profileManager = profileManager;
+        this.clock = clock ?? SystemClock;
+    }
+    /**
+     * Build the Structured Judgment Protocol block (~50 tokens).
+     * Guides the LLM on how to judge what memories to store via brain_append.
+     */
+    buildJudgmentProtocolBlock() {
+        const text = [
+            '[Memory Guide]',
+            'Before storing via brain_append:',
+            '1. Useful next session? (temporal) 2. Useful on other devices? (cross-device)',
+            '3. Similar memory below? → upsert existing id (dedup) 4. Pick category:',
+            'Protected (permanent): preference|identity|skill|habit',
+            'Prunable: context|observation|fact',
+            '5. Confidence: user_stated=0.9 repeated=0.7 inferred=0.5 uncertain=0.3',
+        ].join('\n');
+        return {
+            id: '__judgment_protocol__',
+            slot: 'system_policy',
+            text,
+            tokens: estimateTokens(text),
+            score: 1.0,
+            required: true,
+        };
+    }
+    /**
+     * Build the Memory Context block — compact summary of protected entries.
+     * Enables LLM to perform dedup checks and upsert existing memories.
+     */
+    buildMemoryContextBlock(entries) {
+        const protectedEntries = entries.filter(e => PROTECTED_CATEGORIES.has(e.category));
+        if (protectedEntries.length === 0)
+            return null;
+        const lines = ['[Existing Memories]'];
+        for (const e of protectedEntries) {
+            const content = e.content.length > 50 ? e.content.slice(0, 47) + '...' : e.content;
+            lines.push(`- ${e.id} | ${e.category} | ${content}`);
+        }
+        const text = lines.join('\n');
+        return {
+            id: '__memory_context__',
+            slot: 'must_keep',
+            text,
+            tokens: estimateTokens(text),
+            score: 1.0,
+            required: true,
+        };
+    }
+    /**
+     * Restore context from synced profile.
+     * Loads active entries, converts to ContextBlocks, packs within budget.
+     * Includes Layer 1 (Judgment Protocol) and Layer 2 (Memory Context).
+     */
+    async restore(options) {
+        const timer = startResumeTimer();
+        // Load active (non-deleted) entries
+        const entries = await this.profileManager.getAll();
+        const nowMs = this.clock.now().getTime();
+        // Convert entries to context blocks
+        const blocks = [];
+        // Layer 1: Structured Judgment Protocol
+        blocks.push(this.buildJudgmentProtocolBlock());
+        // Layer 2: Memory Context (protected entries summary for LLM dedup)
+        const memoryCtx = this.buildMemoryContextBlock(entries);
+        if (memoryCtx)
+            blocks.push(memoryCtx);
+        // Entry-based blocks
+        blocks.push(...entries.map(e => entryToContextBlock(e, nowMs)));
+        // Pack within budget
+        const packed = packContext({
+            windowTokens: options.windowTokens,
+            mode: options.mode ?? 'coding',
+            blocks,
+            confidenceThreshold: options.confidenceThreshold,
+        });
+        // Measure resume quality: compare all entries vs actually packed entries
+        const selectedIds = new Set(packed.selected.map(b => b.id));
+        const actualEntries = entries.filter(e => selectedIds.has(e.id));
+        const resume = timer.stop(entries, actualEntries);
+        return { packed, resume, restoredEntries: entries };
+    }
+}
+//# sourceMappingURL=ContextRestoreService.js.map

package/dist/context/ContextRestoreService.js.map

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