@pellux/goodvibes-sdk 0.18.13 → 0.18.15

package/dist/_internal/platform/core/compaction-sections.d.ts

@@ -0,0 +1,98 @@
+/**
+ * compaction-sections.ts
+ *
+ * Section builder functions for prompt compaction.
+ *
+ * Rule-based builders return CompactionSection | null directly.
+ * LLM-assisted builders return a string prompt to be sent to the LLM by the
+ * orchestrator; the caller assembles the section from the LLM response.
+ *
+ * Empty sections return null — the orchestrator omits them entirely (no header).
+ */
+import type { ProviderMessage } from '../providers/interface.js';
+import type { AgentRecord } from '../tools/agent/index.js';
+import type { WrfcChain } from '../agents/wrfc-types.js';
+import type { ExecutionPlan } from '@pellux/goodvibes-sdk/platform/core/execution-plan';
+import type { CompactionSection, SessionMemory } from './compaction-types.js';
+/**
+ * buildHandoffHeader — always returns the mandatory handoff header.
+ * This is the first line of every compacted output.
+ */
+export declare function buildHandoffHeader(): CompactionSection;
+/**
+ * buildSessionMemories — format pinned memories.
+ * Returns null if there are no memories.
+ */
+export declare function buildSessionMemories(memories: SessionMemory[]): CompactionSection | null;
+/**
+ * buildCurrentTask — one line stating what the user is currently doing.
+ * Uses plan title if a plan exists, otherwise falls back to the last user message.
+ */
+export declare function buildCurrentTask(planTitle: string | null, lastUserMessage: string | null): CompactionSection | null;
+/**
+ * buildRunningAgents — list agents in running or pending status.
+ * Includes WRFC chain ID, agent ID, and task (truncated to 80 chars).
+ * Returns null if no agents are running.
+ */
+export declare function buildRunningAgents(agents: AgentRecord[], chains: WrfcChain[]): CompactionSection | null;
+/**
+ * gatherRecentConversation — collect user/assistant messages backward from most
+ * recent, stopping when adding the next message would exceed maxTokens.
+ * Returns full messages only (no partial messages).
+ *
+ * The returned messages are raw — they will be further filtered by the LLM
+ * substance filter in the orchestrator.
+ */
+export declare function gatherRecentConversation(messages: ProviderMessage[], maxTokens?: number): ProviderMessage[];
+/**
+ * buildToolResultsPrompt — build the prompt for LLM-assisted tool relevance extraction.
+ *
+ * The caller sends this to the LLM and uses the response as the section content.
+ */
+export declare function buildToolResultsPrompt(toolMessages: ProviderMessage[]): string;
+/**
+ * buildConversationFilterPrompt — build the LLM prompt for filtering gathered
+ * recent messages for substance.
+ *
+ * The caller sends this to the LLM; the response replaces the raw gathered messages.
+ * Multi-turn coherence rule: keep user-assistant PAIRS.
+ */
+export declare function buildConversationFilterPrompt(gatheredMessages: ProviderMessage[]): string;
+/**
+ * buildAgentActivityTable — rule-based table from WRFC chain data.
+ * One row per chain, most recent first. Skips intermediate reviews/fix cycles.
+ * Stops when adding the next row would exceed the token budget.
+ *
+ * Returns:
+ *   - section: the table section (or null if no chains)
+ *   - remainingChains: chains that did not fit in the table (for older summary)
+ */
+export declare function buildAgentActivityTable(chains: WrfcChain[], tokenBudget: number): {
+    section: CompactionSection | null;
+    remainingChains: WrfcChain[];
+};
+/**
+ * buildOlderAgentSummaryPrompt — build the prompt for LLM-assisted summary of
+ * agents that did not fit in the activity table.
+ *
+ * Returns empty string if no older chains.
+ */
+export declare function buildOlderAgentSummaryPrompt(olderChains: WrfcChain[]): string;
+/**
+ * buildResolvedProblemsPrompt — build the prompt for LLM-assisted extraction
+ * of problem → resolution pairs from the conversation.
+ *
+ * Returns empty string if no messages.
+ */
+export declare function buildResolvedProblemsPrompt(messages: ProviderMessage[]): string;
+/**
+ * buildPlanProgress — rule-based from plan state.
+ * Returns null if no active plan.
+ */
+export declare function buildPlanProgress(plan: ExecutionPlan | null): CompactionSection | null;
+/**
+ * buildSessionLineage — format the append-only micro-log.
+ * Each compaction adds one entry; prior entries are never modified.
+ */
+export declare function buildSessionLineage(originalTask: string | undefined, lineageEntries: string[], compactionCount: number): CompactionSection | null;
+//# sourceMappingURL=compaction-sections.d.ts.map

package/dist/_internal/platform/core/compaction-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-sections.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/core/compaction-sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,2BAA2B,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,oDAAoD,CAAC;AAClG,OAAO,KAAK,EAAE,iBAAiB,EAAoB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAoChG;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAStD;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EAAE,GACxB,iBAAiB,GAAG,IAAI,CAQ1B;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,iBAAiB,GAAG,IAAI,CAM1B;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,SAAS,EAAE,GAClB,iBAAiB,GAAG,IAAI,CAqB1B;AAMD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,SAAO,GACf,eAAe,EAAE,CAkBnB;AAMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,MAAM,CA0B9E;AAMD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,gBAAgB,EAAE,eAAe,EAAE,GAClC,MAAM,CA4BR;AAMD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EAAE,EACnB,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,SAAS,EAAE,CAAA;CAAE,CA8CrE;AAsBD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CA2B7E;AAMD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,eAAe,EAAE,GAC1B,MAAM,CA0BR;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,GAAG,IAAI,GACzB,iBAAiB,GAAG,IAAI,CAuC1B;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,cAAc,EAAE,MAAM,EAAE,EACxB,eAAe,EAAE,MAAM,GACtB,iBAAiB,GAAG,IAAI,CAa1B"}

package/dist/_internal/platform/core/compaction-sections.js

@@ -0,0 +1,394 @@
+/**
+ * compaction-sections.ts
+ *
+ * Section builder functions for prompt compaction.
+ *
+ * Rule-based builders return CompactionSection | null directly.
+ * LLM-assisted builders return a string prompt to be sent to the LLM by the
+ * orchestrator; the caller assembles the section from the LLM response.
+ *
+ * Empty sections return null — the orchestrator omits them entirely (no header).
+ */
+import { estimateTokens } from './compaction-types.js';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Extract plain text from a ProviderMessage content field. */
+function extractText(content) {
+    if (typeof content === 'string')
+        return content;
+    return content
+        .filter((p) => p.type === 'text')
+        .map((p) => p.text)
+        .join('');
+}
+/** Build a CompactionSection. Returns null if content is empty. */
+function makeSection(id, header, content) {
+    const trimmed = content.trim();
+    if (!trimmed)
+        return null;
+    return {
+        id,
+        header,
+        content: trimmed,
+        tokens: estimateTokens(header + '\n' + trimmed),
+    };
+}
+// ---------------------------------------------------------------------------
+// Handoff header
+// ---------------------------------------------------------------------------
+/**
+ * buildHandoffHeader — always returns the mandatory handoff header.
+ * This is the first line of every compacted output.
+ */
+export function buildHandoffHeader() {
+    const content = 'IMPORTANT: This session is not new! Context was compacted, please read the following for proper handoff so you may resume work!';
+    return {
+        id: 'handoff-header',
+        header: '',
+        content,
+        tokens: estimateTokens(content),
+    };
+}
+// ---------------------------------------------------------------------------
+// Session memories
+// ---------------------------------------------------------------------------
+/**
+ * buildSessionMemories — format pinned memories.
+ * Returns null if there are no memories.
+ */
+export function buildSessionMemories(memories) {
+    if (memories.length === 0)
+        return null;
+    const lines = memories.map((m) => `- [${m.id}] ${m.text}`);
+    return makeSection('session-memories', '## Session Memories (pinned)', lines.join('\n'));
+}
+// ---------------------------------------------------------------------------
+// Current task
+// ---------------------------------------------------------------------------
+/**
+ * buildCurrentTask — one line stating what the user is currently doing.
+ * Uses plan title if a plan exists, otherwise falls back to the last user message.
+ */
+export function buildCurrentTask(planTitle, lastUserMessage) {
+    const task = planTitle ??
+        (lastUserMessage ? lastUserMessage.slice(0, 200).trim() : null);
+    if (!task)
+        return null;
+    return makeSection('current-task', '## Current Task', task);
+}
+// ---------------------------------------------------------------------------
+// Running agents
+// ---------------------------------------------------------------------------
+/**
+ * buildRunningAgents — list agents in running or pending status.
+ * Includes WRFC chain ID, agent ID, and task (truncated to 80 chars).
+ * Returns null if no agents are running.
+ */
+export function buildRunningAgents(agents, chains) {
+    const active = agents.filter((a) => a.status === 'running' || a.status === 'pending');
+    if (active.length === 0)
+        return null;
+    // Build a map from agent ID to chain ID for quick lookup
+    const agentToChain = new Map();
+    for (const chain of chains) {
+        for (const agentId of chain.allAgentIds) {
+            agentToChain.set(agentId, chain.id);
+        }
+    }
+    const lines = active.map((a) => {
+        const chainId = a.wrfcId ?? agentToChain.get(a.id) ?? 'no-chain';
+        const task = a.task.slice(0, 80).replace(/\n/g, ' ');
+        return `- ${chainId} | ${a.id} | ${task}`;
+    });
+    return makeSection('running-agents', '## Currently Running', lines.join('\n'));
+}
+// ---------------------------------------------------------------------------
+// Recent conversation gather
+// ---------------------------------------------------------------------------
+/**
+ * gatherRecentConversation — collect user/assistant messages backward from most
+ * recent, stopping when adding the next message would exceed maxTokens.
+ * Returns full messages only (no partial messages).
+ *
+ * The returned messages are raw — they will be further filtered by the LLM
+ * substance filter in the orchestrator.
+ */
+export function gatherRecentConversation(messages, maxTokens = 3000) {
+    const eligible = messages.filter((m) => m.role === 'user' || m.role === 'assistant');
+    const gathered = [];
+    let tokenCount = 0;
+    // Work backward from most recent
+    for (let i = eligible.length - 1; i >= 0; i--) {
+        const msg = eligible[i];
+        const msgTokens = estimateTokens(extractText(msg.content));
+        if (tokenCount + msgTokens > maxTokens)
+            break;
+        gathered.unshift(msg);
+        tokenCount += msgTokens;
+    }
+    return gathered;
+}
+// ---------------------------------------------------------------------------
+// LLM substance filter prompt
+// ---------------------------------------------------------------------------
+/**
+ * buildToolResultsPrompt — build the prompt for LLM-assisted tool relevance extraction.
+ *
+ * The caller sends this to the LLM and uses the response as the section content.
+ */
+export function buildToolResultsPrompt(toolMessages) {
+    if (toolMessages.length === 0)
+        return '';
+    const parts = [
+        'From these tool call results, select the ones that are still relevant for ongoing work.',
+        'Include: file paths touched with what was done (created/edited/deleted), any error outputs',
+        'that have not been resolved, any build/test results.',
+        'Max 1,500 tokens. Use relative paths and short descriptions.',
+        '',
+        '--- TOOL RESULTS ---',
+        '',
+    ];
+    for (const msg of toolMessages) {
+        const text = extractText(msg.content);
+        if (text.trim()) {
+            parts.push(`[tool]: ${text.trim().slice(0, 2000)}`);
+            parts.push('');
+        }
+    }
+    parts.push('--- END TOOL RESULTS ---');
+    parts.push('');
+    parts.push('Provide a concise summary of relevant tool results now:');
+    return parts.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Recent conversation substance filter prompt
+// ---------------------------------------------------------------------------
+/**
+ * buildConversationFilterPrompt — build the LLM prompt for filtering gathered
+ * recent messages for substance.
+ *
+ * The caller sends this to the LLM; the response replaces the raw gathered messages.
+ * Multi-turn coherence rule: keep user-assistant PAIRS.
+ */
+export function buildConversationFilterPrompt(gatheredMessages) {
+    if (gatheredMessages.length === 0)
+        return '';
+    const parts = [
+        'From these recent messages, remove anything that does not advance the work:',
+        'short acknowledgments, agent count updates, repetitive system nudges, status confirmations.',
+        'Keep: instructions, planning, decisions, task assignments, requirement changes.',
+        'ALL user messages are high-priority — bias toward keeping them even if short.',
+        'Keep user-assistant pairs together: if you keep an assistant message, keep the user message that prompted it.',
+        'Return only the messages worth preserving, in original order.',
+        '',
+        '--- RECENT MESSAGES ---',
+        '',
+    ];
+    for (const msg of gatheredMessages) {
+        const text = extractText(msg.content);
+        if (text.trim()) {
+            parts.push(`[${msg.role}]: ${text.trim()}`);
+            parts.push('');
+        }
+    }
+    parts.push('--- END RECENT MESSAGES ---');
+    parts.push('');
+    parts.push('Return the filtered messages in the same [role]: content format:');
+    return parts.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Agent activity table
+// ---------------------------------------------------------------------------
+/**
+ * buildAgentActivityTable — rule-based table from WRFC chain data.
+ * One row per chain, most recent first. Skips intermediate reviews/fix cycles.
+ * Stops when adding the next row would exceed the token budget.
+ *
+ * Returns:
+ *   - section: the table section (or null if no chains)
+ *   - remainingChains: chains that did not fit in the table (for older summary)
+ */
+export function buildAgentActivityTable(chains, tokenBudget) {
+    if (chains.length === 0) {
+        return { section: null, remainingChains: [] };
+    }
+    // Sort most recent first
+    const sorted = [...chains].sort((a, b) => b.createdAt - a.createdAt);
+    const header = '## Agent Activity';
+    const tableHeader = '| Chain | Task | Scores | Result |\n|-------|------|--------|--------|';
+    const rows = [];
+    const included = [];
+    const remaining = [];
+    let tokensSoFar = estimateTokens(header + '\n' + tableHeader);
+    for (const chain of sorted) {
+        const task = chain.task.slice(0, 60).replace(/\n/g, ' ');
+        const scores = chain.reviewScores.length > 0
+            ? chain.reviewScores.map((s) => s.toFixed(1)).join(' → ')
+            : '—';
+        const result = terminalResult(chain.state);
+        const row = `| ${chain.id.slice(0, 12)} | ${task} | ${scores} | ${result} |`;
+        const rowTokens = estimateTokens(row + '\n');
+        if (tokensSoFar + rowTokens > tokenBudget) {
+            remaining.push(chain);
+            // All further chains also go to remaining
+            const idx = sorted.indexOf(chain);
+            remaining.push(...sorted.slice(idx + 1));
+            break;
+        }
+        rows.push(row);
+        tokensSoFar += rowTokens;
+        included.push(chain);
+    }
+    if (rows.length === 0) {
+        return { section: null, remainingChains: sorted };
+    }
+    const content = tableHeader + '\n' + rows.join('\n');
+    const section = makeSection('agent-activity', header, content);
+    return { section, remainingChains: remaining };
+}
+/** Map WRFC chain state to display result. */
+function terminalResult(state) {
+    switch (state) {
+        case 'passed': return 'PASSED';
+        case 'failed': return 'FAILED';
+        case 'committing': return 'IN_PROGRESS';
+        case 'gating': return 'IN_PROGRESS';
+        case 'awaiting_gates': return 'IN_PROGRESS';
+        case 'reviewing': return 'IN_PROGRESS';
+        case 'fixing': return 'IN_PROGRESS';
+        case 'engineering': return 'IN_PROGRESS';
+        case 'pending': return 'IN_PROGRESS';
+        default: return 'UNKNOWN';
+    }
+}
+// ---------------------------------------------------------------------------
+// Older agent summary prompt (LLM-assisted)
+// ---------------------------------------------------------------------------
+/**
+ * buildOlderAgentSummaryPrompt — build the prompt for LLM-assisted summary of
+ * agents that did not fit in the activity table.
+ *
+ * Returns empty string if no older chains.
+ */
+export function buildOlderAgentSummaryPrompt(olderChains) {
+    if (olderChains.length === 0)
+        return '';
+    const parts = [
+        'Summarize what these agents accomplished in aggregate.',
+        'Focus on outcomes: what was built, fixed, reviewed. Max 500 tokens.',
+        '',
+        '--- OLDER AGENTS ---',
+        '',
+    ];
+    for (const chain of olderChains) {
+        const task = chain.task.slice(0, 200).replace(/\n/g, ' ');
+        const scores = chain.reviewScores.length > 0
+            ? chain.reviewScores.map((s) => s.toFixed(1)).join(' → ')
+            : 'no scores';
+        const result = terminalResult(chain.state);
+        parts.push(`- [${result}] ${task} (scores: ${scores})`);
+    }
+    parts.push('');
+    parts.push('--- END OLDER AGENTS ---');
+    parts.push('');
+    parts.push('Provide aggregate summary now:');
+    return parts.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Resolved problems prompt (LLM-assisted)
+// ---------------------------------------------------------------------------
+/**
+ * buildResolvedProblemsPrompt — build the prompt for LLM-assisted extraction
+ * of problem → resolution pairs from the conversation.
+ *
+ * Returns empty string if no messages.
+ */
+export function buildResolvedProblemsPrompt(messages) {
+    if (messages.length === 0)
+        return '';
+    const parts = [
+        'Extract problem → resolution pairs from this conversation.',
+        'Only include problems that were actually resolved. One line each.',
+        'Format: problem → resolution.',
+        'Highlight the resolution, not the debugging journey.',
+        '',
+        '--- CONVERSATION ---',
+        '',
+    ];
+    for (const msg of messages) {
+        const text = extractText(msg.content);
+        if (text.trim()) {
+            parts.push(`[${msg.role}]: ${text.trim().slice(0, 1000)}`);
+            parts.push('');
+        }
+    }
+    parts.push('--- END CONVERSATION ---');
+    parts.push('');
+    parts.push('List resolved problems now (or return empty if none):');
+    return parts.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Plan progress
+// ---------------------------------------------------------------------------
+/**
+ * buildPlanProgress — rule-based from plan state.
+ * Returns null if no active plan.
+ */
+export function buildPlanProgress(plan) {
+    if (!plan)
+        return null;
+    const lines = [];
+    // Group items by phase
+    const byPhase = new Map();
+    const phaseOrder = [];
+    for (const item of plan.items) {
+        if (!byPhase.has(item.phase)) {
+            byPhase.set(item.phase, []);
+            phaseOrder.push(item.phase);
+        }
+        byPhase.get(item.phase).push(item);
+    }
+    for (const phase of phaseOrder) {
+        const items = byPhase.get(phase);
+        const done = items.filter((i) => i.status === 'complete' || i.status === 'skipped').length;
+        const inProgress = items.some((i) => i.status === 'in_progress');
+        const failed = items.some((i) => i.status === 'failed');
+        const all = items.length;
+        const allDone = done === all;
+        let status;
+        if (allDone)
+            status = 'COMPLETE';
+        else if (failed)
+            status = `FAILED (${done}/${all} done)`;
+        else if (inProgress)
+            status = `IN_PROGRESS (${done}/${all} done)`;
+        else
+            status = `PENDING (${done}/${all} done)`;
+        lines.push(`- ${phase}: [${status}]`);
+    }
+    if (lines.length === 0)
+        return null;
+    const content = `**${plan.title}**\n${lines.join('\n')}`;
+    return makeSection('plan-progress', '## Plan Progress', content);
+}
+// ---------------------------------------------------------------------------
+// Session lineage
+// ---------------------------------------------------------------------------
+/**
+ * buildSessionLineage — format the append-only micro-log.
+ * Each compaction adds one entry; prior entries are never modified.
+ */
+export function buildSessionLineage(originalTask, lineageEntries, compactionCount) {
+    const lines = [];
+    if (originalTask) {
+        lines.push(`Original task: "${originalTask}"`);
+    }
+    lines.push(`Compactions: ${compactionCount}`);
+    for (const entry of lineageEntries) {
+        lines.push(entry);
+    }
+    if (lines.length === 0)
+        return null;
+    return makeSection('session-lineage', '## Session Lineage', lines.join('\n'));
+}

package/dist/_internal/platform/core/compaction-types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * compaction-types.ts
+ *
+ * Shared types for the prompt compaction engine.
+ */
+import type { ProviderMessage } from '../providers/interface.js';
+import type { SessionMemory } from '@pellux/goodvibes-sdk/platform/core/session-memory';
+import type { AgentRecord } from '../tools/agent/index.js';
+import type { WrfcChain } from '../agents/wrfc-types.js';
+import type { ExecutionPlan } from '@pellux/goodvibes-sdk/platform/core/execution-plan';
+/** A single compacted output section. */
+export interface CompactionSection {
+    /** Unique identifier for this section (e.g. 'handoff-header', 'current-task'). */
+    id: string;
+    /** Section heading text (e.g. '## Current Task'). Empty string for the handoff header. */
+    header: string;
+    /** Body content for this section. */
+    content: string;
+    /** Estimated token count for this section. */
+    tokens: number;
+}
+/** Per-section token budgets and threshold configuration. */
+export interface CompactionConfig {
+    /** Max tokens for recent conversation gather (default: 3000). */
+    recentConversationBudget: number;
+    /** Max tokens for tool results section (default: 1500). */
+    toolResultsBudget: number;
+    /** Max tokens for agent activity table (default: 1500). */
+    agentActivityBudget: number;
+    /** Max tokens for older agent summary (default: 500). */
+    olderAgentSummaryBudget: number;
+    /** Max tokens for resolved problems section (default: 300). */
+    resolvedProblemsBudget: number;
+    /** Overall ceiling for entire compacted output (default: 6500). */
+    totalCeiling: number;
+}
+/** Default compaction configuration. */
+export declare const DEFAULT_COMPACTION_CONFIG: CompactionConfig;
+export type { SessionMemory };
+/** Rough token estimate for a string: 4 chars ≈ 1 token. */
+export declare function estimateTokens(text: string): number;
+/** All data sources needed for compaction. Accept as plain data; do not import singletons. */
+export interface CompactionContext {
+    /** Current conversation messages (as sent to LLM — no system messages). */
+    messages: ProviderMessage[];
+    /** Pinned session memories (survive all compactions). */
+    sessionMemories: readonly SessionMemory[];
+    /** All agent records from AgentManager.list(). */
+    agents: AgentRecord[];
+    /** All WRFC chains from WrfcController.listChains(). */
+    wrfcChains: WrfcChain[];
+    /** Active execution plan, or null if none. */
+    activePlan: ExecutionPlan | null;
+    /** Append-only session lineage log entries (one per prior compaction). */
+    lineageEntries: string[];
+    /** Original task description for lineage. Set on first compaction. */
+    originalTask?: string;
+    /** Number of compactions performed so far (including this one). */
+    compactionCount: number;
+    /** Context window size for the current model (used for threshold scaling). */
+    contextWindow: number;
+    /** Whether this compaction was triggered automatically or manually. */
+    trigger: 'auto' | 'manual';
+    /** Model ID used for LLM extraction calls. */
+    extractionModelId: string;
+    /** Optional provider name for extraction model disambiguation. */
+    extractionProvider?: string;
+}
+/** Record of a completed compaction event. */
+export interface CompactionEvent {
+    timestamp: number;
+    messagesBeforeCompaction: number;
+    messagesAfterCompaction: number;
+    tokensBeforeEstimate: number;
+    tokensAfterEstimate: number;
+    modelId: string;
+    trigger: 'auto' | 'manual';
+    /** Sections included in this compaction (IDs). */
+    sectionsIncluded?: string[];
+    /** Whether post-compaction validation passed. */
+    validationPassed?: boolean;
+}
+/** Result of a compaction operation. */
+export interface CompactionResult {
+    /** The new compacted message list (single user message containing the handoff). */
+    messages: ProviderMessage[];
+    /** The full compacted context text. */
+    summary: string;
+    /** Token estimates before and after compaction. */
+    tokensBeforeEstimate: number;
+    tokensAfterEstimate: number;
+    /** The compaction event record for tracking. */
+    event: CompactionEvent;
+    /** Sections that were included (for debugging). */
+    sections: CompactionSection[];
+    /** Post-compaction validation warnings (empty = all checks passed). */
+    validationWarnings: string[];
+}
+//# sourceMappingURL=compaction-types.d.ts.map

package/dist/_internal/platform/core/compaction-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-types.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/core/compaction-types.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/core/compaction-types.js

@@ -0,0 +1,21 @@
+/**
+ * compaction-types.ts
+ *
+ * Shared types for the prompt compaction engine.
+ */
+/** Default compaction configuration. */
+export const DEFAULT_COMPACTION_CONFIG = {
+    recentConversationBudget: 3000,
+    toolResultsBudget: 1500,
+    agentActivityBudget: 1500,
+    olderAgentSummaryBudget: 500,
+    resolvedProblemsBudget: 300,
+    totalCeiling: 6500,
+};
+// ---------------------------------------------------------------------------
+// Token estimation utility (here to avoid circular imports)
+// ---------------------------------------------------------------------------
+/** Rough token estimate for a string: 4 chars ≈ 1 token. */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}