anantham-v2 2.0.0-alpha.1

package/dist/compaction/compaction-engine.js

@@ -0,0 +1,208 @@
+import { randomUUID } from "node:crypto";
+import { ContextEngine } from "../context/context-engine.js";
+import { EventTypes } from "../domain/event.js";
+import { CompactionPreviewSchema, CompactionResultSchema, CompactionSummarySchema, } from "./compaction-types.js";
+export class CompactionEngine {
+    eventStore;
+    undoSnapshots = new Map();
+    constructor(eventStore) {
+        this.eventStore = eventStore;
+    }
+    /**
+     * Generates a non-destructive preview of what compaction will achieve without mutating state.
+     * PRD Part 1 Section 80.
+     */
+    preview(currentPlan, _options) {
+        let preservedCount = 0;
+        let summarizedCount = 0;
+        let omittedCount = 0;
+        for (const item of currentPlan.items) {
+            if (item.priority === "CRITICAL" || item.sourceType === "system") {
+                preservedCount++;
+            }
+            else if (item.priority === "HIGH" || item.priority === "NORMAL") {
+                summarizedCount++;
+            }
+            else {
+                omittedCount++;
+            }
+        }
+        // Estimated structured summary tokens (~350 tokens)
+        const estimatedSummaryTokens = 350;
+        const systemTokens = currentPlan.items
+            .filter((i) => i.sourceType === "system")
+            .reduce((sum, i) => sum + i.estimatedTokens, 0);
+        const projectedTokens = systemTokens + estimatedSummaryTokens;
+        const estimatedSavings = Math.max(0, currentPlan.estimatedTokens - projectedTokens);
+        const warnings = [];
+        if (currentPlan.items.length === 0) {
+            warnings.push("ContextPlan is empty; compaction will have no effect.");
+        }
+        if (currentPlan.estimatedTokens < 500) {
+            warnings.push("Context size is already very small; compaction may yield negligible token savings.");
+        }
+        const previewData = {
+            currentTokens: currentPlan.estimatedTokens,
+            projectedTokens,
+            estimatedSavings,
+            preservedItemCount: preservedCount,
+            summarizedItemCount: summarizedCount,
+            omittedItemCount: omittedCount,
+            warnings,
+        };
+        return Object.freeze(CompactionPreviewSchema.parse(previewData));
+    }
+    /**
+     * Executes deterministic session compaction.
+     * Emits an immutable 'context.compacted' event to EventStore and returns a compacted ContextPlan.
+     * PRD Part 1 Sections 79-82.
+     */
+    async compact(params) {
+        const compactionId = `cmp_${randomUUID().slice(0, 12)}`;
+        const now = new Date().toISOString();
+        // 1. Save rollback snapshot for undo
+        this.undoSnapshots.set(params.sessionId, params.currentPlan);
+        // 2. Extract facts, decisions, unresolved items, and artifacts from current context
+        const facts = [];
+        const decisions = [];
+        const constraints = [...(params.options?.customConstraints || [])];
+        const unresolved = [];
+        const artifactReferences = [];
+        const sourceEventIds = [];
+        let activeObjective = params.options?.customObjective || "Maintain task progress and invariants.";
+        let activeState = "Compacted active session state.";
+        for (const item of params.currentPlan.items) {
+            sourceEventIds.push(item.id);
+            if (item.sourceType === "task" && item.priority === "CRITICAL") {
+                if (item.content) {
+                    activeObjective = item.content.slice(0, 200);
+                    activeState = `Active task invariant: ${activeObjective}`;
+                }
+            }
+            if (item.sourceType === "artifact") {
+                artifactReferences.push({
+                    artifactId: item.sourceId,
+                    uri: item.uri,
+                    description: item.selectedBecause,
+                });
+            }
+            if (item.content) {
+                if (/decision|agreed|chosen|selected/i.test(item.content)) {
+                    decisions.push(item.content.slice(0, 150));
+                }
+                else if (/error|fail|unresolved|blocked/i.test(item.content)) {
+                    unresolved.push(item.content.slice(0, 150));
+                }
+                else if (/constraint|invariant|must not|must/i.test(item.content)) {
+                    constraints.push(item.content.slice(0, 150));
+                }
+                else {
+                    facts.push(`Preserved fact from ${item.sourceType} (${item.sourceId})`);
+                }
+            }
+        }
+        const summary = {
+            objective: activeObjective,
+            facts: facts.slice(0, 10),
+            decisions: decisions.slice(0, 10),
+            constraints: Array.from(new Set(constraints)).slice(0, 10),
+            currentState: activeState,
+            unresolved: unresolved.slice(0, 10),
+            artifactReferences,
+            provenance: {
+                sourceEventIds,
+                compactedAt: now,
+            },
+            pendingActions: ["Resume active task execution from compacted summary."],
+        };
+        const validatedSummary = CompactionSummarySchema.parse(summary);
+        const summaryText = JSON.stringify(validatedSummary, null, 2);
+        // 3. Assemble new ContextPlan with CompactionSummary as a CRITICAL item
+        const summaryCandidate = {
+            id: `ctx_summary_${compactionId}`,
+            sourceType: "memory",
+            sourceId: `compaction_summary_${compactionId}`,
+            rawContent: `[COMPACTED SESSION SUMMARY]\n${summaryText}`,
+            priority: "CRITICAL",
+            authority: "system",
+            projectId: params.projectId,
+            selectedBecause: "Authoritative structured compaction summary replacing historical raw messages.",
+            metadata: { compactionId },
+        };
+        // Retain original system prompts
+        const systemItem = params.currentPlan.items.find((i) => i.sourceType === "system");
+        const compactedPlan = await ContextEngine.assembleContext({
+            sessionId: params.sessionId,
+            projectId: params.projectId,
+            modelProfile: {
+                modelId: "default",
+                supportedModalities: ["text"],
+            },
+            systemPrompt: systemItem?.content,
+            candidates: [summaryCandidate],
+            checkpointSource: params.currentPlan.checkpointSource,
+        });
+        // 4. Emit immutable 'context.compacted' event to EventStore (History Preservation!)
+        const eventId = `evt_cmp_${randomUUID().slice(0, 12)}`;
+        const event = {
+            id: eventId,
+            schemaVersion: 1,
+            projectId: params.projectId,
+            sessionId: params.sessionId,
+            type: EventTypes.CONTEXT_COMPACTED,
+            actor: "system",
+            timestamp: now,
+            payload: {
+                compactionId,
+                tokensBefore: params.currentPlan.estimatedTokens,
+                tokensAfter: compactedPlan.estimatedTokens,
+                summary: validatedSummary,
+            },
+        };
+        this.eventStore.append(event);
+        const result = {
+            compactionId,
+            sessionId: params.sessionId,
+            compactedPlan,
+            summary: validatedSummary,
+            tokensBefore: params.currentPlan.estimatedTokens,
+            tokensAfter: compactedPlan.estimatedTokens,
+            eventId,
+        };
+        return Object.freeze(CompactionResultSchema.parse(result));
+    }
+    /**
+     * Restores the previous ContextPlan prior to compaction.
+     * Critical: Authoritative event history in EventStore remains completely untouched.
+     * PRD Part 1 Section 81.
+     */
+    async undo(sessionId) {
+        const priorPlan = this.undoSnapshots.get(sessionId);
+        if (!priorPlan) {
+            throw new Error(`No undo snapshot found for session '${sessionId}'.`);
+        }
+        this.undoSnapshots.delete(sessionId);
+        return priorPlan;
+    }
+    /**
+     * Automatically triggers compaction if the current ContextPlan exceeds the configured token threshold.
+     * PRD Part 1 Section 82.
+     */
+    async autoCompact(params) {
+        if (params.currentPlan.estimatedTokens >= params.thresholdTokens) {
+            // Check if already compacted to prevent loops
+            const hasSummary = params.currentPlan.items.some((i) => i.sourceId.startsWith("compaction_summary_"));
+            if (hasSummary && params.currentPlan.items.length <= 2) {
+                return null; // Already maximally compacted
+            }
+            return this.compact({
+                sessionId: params.sessionId,
+                projectId: params.projectId,
+                currentPlan: params.currentPlan,
+                options: params.options,
+            });
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=compaction-engine.js.map

package/dist/compaction/compaction-engine.js.map

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

package/dist/compaction/compaction-types.d.ts

@@ -0,0 +1,454 @@
+import { z } from "zod";
+export declare const CompactionArtifactRefSchema: z.ZodObject<{
+    artifactId: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    artifactId: string;
+    uri?: string | undefined;
+    description?: string | undefined;
+}, {
+    artifactId: string;
+    uri?: string | undefined;
+    description?: string | undefined;
+}>;
+export type CompactionArtifactRef = z.infer<typeof CompactionArtifactRefSchema>;
+export declare const CompactionSummarySchema: z.ZodObject<{
+    objective: z.ZodString;
+    facts: z.ZodArray<z.ZodString, "many">;
+    decisions: z.ZodArray<z.ZodString, "many">;
+    constraints: z.ZodArray<z.ZodString, "many">;
+    currentState: z.ZodString;
+    unresolved: z.ZodArray<z.ZodString, "many">;
+    artifactReferences: z.ZodArray<z.ZodObject<{
+        artifactId: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        artifactId: string;
+        uri?: string | undefined;
+        description?: string | undefined;
+    }, {
+        artifactId: string;
+        uri?: string | undefined;
+        description?: string | undefined;
+    }>, "many">;
+    provenance: z.ZodObject<{
+        sourceEventIds: z.ZodArray<z.ZodString, "many">;
+        compactedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sourceEventIds: string[];
+        compactedAt: string;
+    }, {
+        sourceEventIds: string[];
+        compactedAt: string;
+    }>;
+    pendingActions: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    provenance: {
+        sourceEventIds: string[];
+        compactedAt: string;
+    };
+    decisions: string[];
+    objective: string;
+    facts: string[];
+    constraints: string[];
+    currentState: string;
+    unresolved: string[];
+    artifactReferences: {
+        artifactId: string;
+        uri?: string | undefined;
+        description?: string | undefined;
+    }[];
+    pendingActions: string[];
+}, {
+    provenance: {
+        sourceEventIds: string[];
+        compactedAt: string;
+    };
+    decisions: string[];
+    objective: string;
+    facts: string[];
+    constraints: string[];
+    currentState: string;
+    unresolved: string[];
+    artifactReferences: {
+        artifactId: string;
+        uri?: string | undefined;
+        description?: string | undefined;
+    }[];
+    pendingActions: string[];
+}>;
+export type CompactionSummary = z.infer<typeof CompactionSummarySchema>;
+export declare const CompactionPreviewSchema: z.ZodObject<{
+    currentTokens: z.ZodNumber;
+    projectedTokens: z.ZodNumber;
+    estimatedSavings: z.ZodNumber;
+    preservedItemCount: z.ZodNumber;
+    summarizedItemCount: z.ZodNumber;
+    omittedItemCount: z.ZodNumber;
+    warnings: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    warnings: string[];
+    currentTokens: number;
+    projectedTokens: number;
+    estimatedSavings: number;
+    preservedItemCount: number;
+    summarizedItemCount: number;
+    omittedItemCount: number;
+}, {
+    warnings: string[];
+    currentTokens: number;
+    projectedTokens: number;
+    estimatedSavings: number;
+    preservedItemCount: number;
+    summarizedItemCount: number;
+    omittedItemCount: number;
+}>;
+export type CompactionPreview = z.infer<typeof CompactionPreviewSchema>;
+export declare const CompactionResultSchema: z.ZodObject<{
+    compactionId: z.ZodString;
+    sessionId: z.ZodString;
+    compactedPlan: z.ZodObject<{
+        id: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sourceType: z.ZodEnum<["project", "task", "history", "memory", "file", "attachment", "artifact", "skill", "tool-schema", "diagnostic", "system"]>;
+            sourceId: z.ZodString;
+            representationType: z.ZodString;
+            priority: z.ZodEnum<["CRITICAL", "HIGH", "NORMAL", "LOW", "DROP"]>;
+            estimatedTokens: z.ZodNumber;
+            selectedBecause: z.ZodString;
+            authority: z.ZodEnum<["system", "security-policy", "developer", "user", "project-instruction", "skill", "agent", "tool-output", "mcp-output", "repository-content", "web-content", "attachment"]>;
+            content: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            authority: "repository-content" | "web-content" | "system" | "security-policy" | "developer" | "user" | "project-instruction" | "skill" | "agent" | "tool-output" | "mcp-output" | "attachment";
+            sourceType: "system" | "skill" | "attachment" | "artifact" | "project" | "task" | "history" | "memory" | "file" | "tool-schema" | "diagnostic";
+            sourceId: string;
+            id: string;
+            priority: "CRITICAL" | "HIGH" | "NORMAL" | "LOW" | "DROP";
+            representationType: string;
+            estimatedTokens: number;
+            selectedBecause: string;
+            metadata?: Record<string, unknown> | undefined;
+            uri?: string | undefined;
+            content?: string | undefined;
+        }, {
+            authority: "repository-content" | "web-content" | "system" | "security-policy" | "developer" | "user" | "project-instruction" | "skill" | "agent" | "tool-output" | "mcp-output" | "attachment";
+            sourceType: "system" | "skill" | "attachment" | "artifact" | "project" | "task" | "history" | "memory" | "file" | "tool-schema" | "diagnostic";
+            sourceId: string;
+            id: string;
+            priority: "CRITICAL" | "HIGH" | "NORMAL" | "LOW" | "DROP";
+            representationType: string;
+            estimatedTokens: number;
+            selectedBecause: string;
+            metadata?: Record<string, unknown> | undefined;
+            uri?: string | undefined;
+            content?: string | undefined;
+        }>, "many">;
+        estimatedTokens: z.ZodNumber;
+        modalityUsage: z.ZodObject<{
+            text: z.ZodOptional<z.ZodNumber>;
+            image: z.ZodOptional<z.ZodNumber>;
+            audio: z.ZodOptional<z.ZodNumber>;
+            video: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            text?: number | undefined;
+            image?: number | undefined;
+            audio?: number | undefined;
+            video?: number | undefined;
+        }, {
+            text?: number | undefined;
+            image?: number | undefined;
+            audio?: number | undefined;
+            video?: number | undefined;
+        }>;
+        omitted: z.ZodArray<z.ZodObject<{
+            sourceId: z.ZodString;
+            reason: z.ZodString;
+            estimatedTokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            sourceId: string;
+            estimatedTokens: number;
+            reason: string;
+        }, {
+            sourceId: string;
+            estimatedTokens: number;
+            reason: string;
+        }>, "many">;
+        decisions: z.ZodArray<z.ZodObject<{
+            decisionType: z.ZodEnum<["include", "compress", "omit", "defer-schema", "prune-tool-result"]>;
+            rationale: z.ZodString;
+            affectedItems: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            decisionType: "include" | "compress" | "omit" | "defer-schema" | "prune-tool-result";
+            rationale: string;
+            affectedItems: string[];
+        }, {
+            decisionType: "include" | "compress" | "omit" | "defer-schema" | "prune-tool-result";
+            rationale: string;
+            affectedItems: string[];
+        }>, "many">;
+        checkpointSource: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        createdAt: string;
+        estimatedTokens: number;
+        items: {
+            authority: "repository-content" | "web-content" | "system" | "security-policy" | "developer" | "user" | "project-instruction" | "skill" | "agent" | "tool-output" | "mcp-output" | "attachment";
+            sourceType: "system" | "skill" | "attachment" | "artifact" | "project" | "task" | "history" | "memory" | "file" | "tool-schema" | "diagnostic";
+            sourceId: string;
+            id: string;
+            priority: "CRITICAL" | "HIGH" | "NORMAL" | "LOW" | "DROP";
+            representationType: string;
+            estimatedTokens: number;
+            selectedBecause: string;
+            metadata?: Record<string, unknown> | undefined;
+            uri?: string | undefined;
+            content?: string | undefined;
+        }[];
+        modalityUsage: {
+            text?: number | undefined;
+            image?: number | undefined;
+            audio?: number | undefined;
+            video?: number | undefined;
+        };
+        omitted: {
+            sourceId: string;
+            estimatedTokens: number;
+            reason: string;
+        }[];
+        decisions: {
+            decisionType: "include" | "compress" | "omit" | "defer-schema" | "prune-tool-result";
+            rationale: string;
+            affectedItems: string[];
+        }[];
+        checkpointSource?: string | undefined;
+    }, {
+        id: string;
+        createdAt: string;
+        estimatedTokens: number;
+        items: {
+            authority: "repository-content" | "web-content" | "system" | "security-policy" | "developer" | "user" | "project-instruction" | "skill" | "agent" | "tool-output" | "mcp-output" | "attachment";
+            sourceType: "system" | "skill" | "attachment" | "artifact" | "project" | "task" | "history" | "memory" | "file" | "tool-schema" | "diagnostic";
+            sourceId: string;
+            id: string;
+            priority: "CRITICAL" | "HIGH" | "NORMAL" | "LOW" | "DROP";
+            representationType: string;
+            estimatedTokens: number;
+            selectedBecause: string;
+            metadata?: Record<string, unknown> | undefined;
+            uri?: string | undefined;
+            content?: string | undefined;
+        }[];
+        modalityUsage: {
+            text?: number | undefined;
+            image?: number | undefined;
+            audio?: number | undefined;
+            video?: number | undefined;
+        };
+        omitted: {
+            sourceId: string;
+            estimatedTokens: number;
+            reason: string;
+        }[];
+        decisions: {
+            decisionType: "include" | "compress" | "omit" | "defer-schema" | "prune-tool-result";
+            rationale: string;
+            affectedItems: string[];
+        }[];
+        checkpointSource?: string | undefined;
+    }>;
+    summary: z.ZodObject<{
+        objective: z.ZodString;
+        facts: z.ZodArray<z.ZodString, "many">;
+        decisions: z.ZodArray<z.ZodString, "many">;
+        constraints: z.ZodArray<z.ZodString, "many">;
+        currentState: z.ZodString;
+        unresolved: z.ZodArray<z.ZodString, "many">;
+        artifactReferences: z.ZodArray<z.ZodObject<{
+            artifactId: z.ZodString;
+            uri: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            artifactId: string;
+            uri?: string | undefined;
+            description?: string | undefined;
+        }, {
+            artifactId: string;
+            uri?: string | undefined;
+            description?: string | undefined;
+        }>, "many">;
+        provenance: z.ZodObject<{
+            sourceEventIds: z.ZodArray<z.ZodString, "many">;
+            compactedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            sourceEventIds: string[];
+            compactedAt: string;
+        }, {
+            sourceEventIds: string[];
+            compactedAt: string;
+        }>;
+        pendingActions: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        provenance: {
+            sourceEventIds: string[];
+            compactedAt: string;
+        };
+        decisions: string[];
+        objective: string;
+        facts: string[];
+        constraints: string[];
+        currentState: string;
+        unresolved: string[];
+        artifactReferences: {
+            artifactId: string;
+            uri?: string | undefined;
+            description?: string | undefined;
+        }[];
+        pendingActions: string[];
+    }, {
+        provenance: {
+            sourceEventIds: string[];
+            compactedAt: string;
+        };
+        decisions: string[];
+        objective: string;
+        facts: string[];
+        constraints: string[];
+        currentState: string;
+        unresolved: string[];
+        artifactReferences: {
+            artifactId: string;
+            uri?: string | undefined;
+            description?: string | undefined;
+        }[];
+        pendingActions: string[];
+    }>;
+    tokensBefore: z.ZodNumber;
+    tokensAfter: z.ZodNumber;
+    eventId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    eventId: string;
+    summary: {
+        provenance: {
+            sourceEventIds: string[];
+            compactedAt: string;
+        };
+        decisions: string[];
+        objective: string;
+        facts: string[];
+        constraints: string[];
+        currentState: string;
+        unresolved: string[];
+        artifactReferences: {
+            artifactId: string;
+            uri?: string | undefined;
+            description?: string | undefined;
+        }[];
+        pendingActions: string[];
+    };
+    compactionId: string;
+    compactedPlan: {
+        id: string;
+        createdAt: string;
+        estimatedTokens: number;
+        items: {
+            authority: "repository-content" | "web-content" | "system" | "security-policy" | "developer" | "user" | "project-instruction" | "skill" | "agent" | "tool-output" | "mcp-output" | "attachment";
+            sourceType: "system" | "skill" | "attachment" | "artifact" | "project" | "task" | "history" | "memory" | "file" | "tool-schema" | "diagnostic";
+            sourceId: string;
+            id: string;
+            priority: "CRITICAL" | "HIGH" | "NORMAL" | "LOW" | "DROP";
+            representationType: string;
+            estimatedTokens: number;
+            selectedBecause: string;
+            metadata?: Record<string, unknown> | undefined;
+            uri?: string | undefined;
+            content?: string | undefined;
+        }[];
+        modalityUsage: {
+            text?: number | undefined;
+            image?: number | undefined;
+            audio?: number | undefined;
+            video?: number | undefined;
+        };
+        omitted: {
+            sourceId: string;
+            estimatedTokens: number;
+            reason: string;
+        }[];
+        decisions: {
+            decisionType: "include" | "compress" | "omit" | "defer-schema" | "prune-tool-result";
+            rationale: string;
+            affectedItems: string[];
+        }[];
+        checkpointSource?: string | undefined;
+    };
+    tokensBefore: number;
+    tokensAfter: number;
+}, {
+    sessionId: string;
+    eventId: string;
+    summary: {
+        provenance: {
+            sourceEventIds: string[];
+            compactedAt: string;
+        };
+        decisions: string[];
+        objective: string;
+        facts: string[];
+        constraints: string[];
+        currentState: string;
+        unresolved: string[];
+        artifactReferences: {
+            artifactId: string;
+            uri?: string | undefined;
+            description?: string | undefined;
+        }[];
+        pendingActions: string[];
+    };
+    compactionId: string;
+    compactedPlan: {
+        id: string;
+        createdAt: string;
+        estimatedTokens: number;
+        items: {
+            authority: "repository-content" | "web-content" | "system" | "security-policy" | "developer" | "user" | "project-instruction" | "skill" | "agent" | "tool-output" | "mcp-output" | "attachment";
+            sourceType: "system" | "skill" | "attachment" | "artifact" | "project" | "task" | "history" | "memory" | "file" | "tool-schema" | "diagnostic";
+            sourceId: string;
+            id: string;
+            priority: "CRITICAL" | "HIGH" | "NORMAL" | "LOW" | "DROP";
+            representationType: string;
+            estimatedTokens: number;
+            selectedBecause: string;
+            metadata?: Record<string, unknown> | undefined;
+            uri?: string | undefined;
+            content?: string | undefined;
+        }[];
+        modalityUsage: {
+            text?: number | undefined;
+            image?: number | undefined;
+            audio?: number | undefined;
+            video?: number | undefined;
+        };
+        omitted: {
+            sourceId: string;
+            estimatedTokens: number;
+            reason: string;
+        }[];
+        decisions: {
+            decisionType: "include" | "compress" | "omit" | "defer-schema" | "prune-tool-result";
+            rationale: string;
+            affectedItems: string[];
+        }[];
+        checkpointSource?: string | undefined;
+    };
+    tokensBefore: number;
+    tokensAfter: number;
+}>;
+export type CompactionResult = z.infer<typeof CompactionResultSchema>;
+//# sourceMappingURL=compaction-types.d.ts.map

package/dist/compaction/compaction-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-types.d.ts","sourceRoot":"","sources":["../../src/compaction/compaction-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAItC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAalC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;EAQlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}