centient 2.20.0

package/dist/utils/DockerSandbox.js

@@ -0,0 +1,277 @@
+import { spawn, spawnSync } from "child_process";
+import * as path from "path";
+import * as fs from "fs/promises";
+const DEFAULT_CONFIG = {
+    mode: process.env.SKILL_SANDBOX_MODE || "none",
+    memory: process.env.SKILL_SANDBOX_MEMORY || "256m",
+    cpu: process.env.SKILL_SANDBOX_CPU || "0.5",
+    timeout: parseInt(process.env.SKILL_SANDBOX_TIMEOUT || "30000", 10),
+    networkEnabled: false,
+    allowedEnvVars: [],
+    imagePrefix: process.env.SKILL_SANDBOX_IMAGE_PREFIX || "mcp-skill-sandbox",
+};
+const LANGUAGE_IMAGES = {
+    typescript: "ts",
+    python: "py",
+    go: "go",
+    rust: "rs",
+};
+const LANGUAGE_COMMANDS = {
+    typescript: { cmd: "node", args: ["/skill/skill.js"] },
+    python: { cmd: "python3", args: ["/skill/skill.py"] },
+    go: { cmd: "go", args: ["run", "/skill/skill.go"] },
+    rust: {
+        cmd: "cargo",
+        args: ["run", "--quiet", "--manifest-path", "/skill/Cargo.toml"],
+    },
+};
+export class DockerSandbox {
+    config;
+    dockerAvailable = null;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    async isAvailable() {
+        if (this.dockerAvailable !== null) {
+            return this.dockerAvailable;
+        }
+        try {
+            const versionResult = spawnSync("docker", ["--version"], {
+                stdio: "ignore",
+            });
+            if (versionResult.status !== 0) {
+                this.dockerAvailable = false;
+                return false;
+            }
+            const infoResult = spawnSync("docker", ["info"], { stdio: "ignore" });
+            this.dockerAvailable = infoResult.status === 0;
+        }
+        catch {
+            this.dockerAvailable = false;
+        }
+        return this.dockerAvailable;
+    }
+    getImageName(language) {
+        return `${this.config.imagePrefix}-${LANGUAGE_IMAGES[language]}:latest`;
+    }
+    async imageExists(language) {
+        const imageName = this.getImageName(language);
+        const result = spawnSync("docker", ["image", "inspect", imageName], {
+            stdio: "ignore",
+        });
+        return result.status === 0;
+    }
+    async buildImage(language) {
+        const imageName = this.getImageName(language);
+        const dockerfileName = `Dockerfile.${LANGUAGE_IMAGES[language]}`;
+        const dockerfilePath = path.join(process.cwd(), "docker", dockerfileName);
+        try {
+            await fs.access(dockerfilePath);
+        }
+        catch {
+            return {
+                success: false,
+                error: `Dockerfile not found: docker/${dockerfileName}`,
+            };
+        }
+        return new Promise((resolve) => {
+            const proc = spawn("docker", ["build", "-t", imageName, "-f", dockerfilePath, "docker"], {
+                cwd: process.cwd(),
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            let stderr = "";
+            proc.stderr.on("data", (data) => {
+                stderr += data.toString();
+            });
+            proc.on("close", (code) => {
+                if (code === 0) {
+                    resolve({ success: true });
+                }
+                else {
+                    resolve({ success: false, error: `Docker build failed: ${stderr}` });
+                }
+            });
+            proc.on("error", (error) => {
+                resolve({ success: false, error: error.message });
+            });
+        });
+    }
+    async ensureImage(language) {
+        if (await this.imageExists(language)) {
+            return { available: true };
+        }
+        const buildResult = await this.buildImage(language);
+        if (!buildResult.success) {
+            return { available: false, error: buildResult.error };
+        }
+        return { available: true };
+    }
+    async execute(skillPath, language, input, overrides) {
+        const startTime = Date.now();
+        if (!(await this.isAvailable())) {
+            return {
+                success: false,
+                error: "Docker is not available. Install Docker or set SKILL_SANDBOX_MODE=subprocess",
+                language,
+                duration: Date.now() - startTime,
+            };
+        }
+        if (overrides?.sandbox === false) {
+            return {
+                success: false,
+                error: "Sandbox disabled for this skill - use subprocess execution",
+                language,
+                duration: Date.now() - startTime,
+            };
+        }
+        const imageResult = await this.ensureImage(language);
+        if (!imageResult.available) {
+            return {
+                success: false,
+                error: imageResult.error || "Failed to ensure Docker image",
+                language,
+                duration: Date.now() - startTime,
+            };
+        }
+        const memory = overrides?.memory || this.config.memory;
+        const cpu = overrides?.cpu || this.config.cpu;
+        const timeout = overrides?.timeout || this.config.timeout;
+        const networkEnabled = overrides?.networkEnabled ?? this.config.networkEnabled;
+        const imageName = this.getImageName(language);
+        const langCmd = LANGUAGE_COMMANDS[language];
+        const absoluteSkillPath = path.resolve(skillPath);
+        const skillDir = path.dirname(absoluteSkillPath);
+        const skillFile = path.basename(absoluteSkillPath);
+        let containerSkillPath;
+        if (language === "rust") {
+            containerSkillPath = "/skill";
+        }
+        else {
+            containerSkillPath = `/skill/skill${path.extname(skillFile)}`;
+        }
+        const dockerArgs = [
+            "run",
+            "--rm",
+            "--interactive",
+            "--memory",
+            memory,
+            "--cpus",
+            cpu,
+            "--cap-drop",
+            "ALL",
+            "--security-opt",
+            "no-new-privileges:true",
+            "--user",
+            "65532:65532",
+        ];
+        const isCompiledLanguage = language === "go" || language === "rust";
+        if (isCompiledLanguage) {
+        }
+        else {
+            dockerArgs.push("--read-only");
+            dockerArgs.push("--tmpfs", "/tmp:rw,noexec,nosuid,size=64m");
+        }
+        if (!networkEnabled) {
+            dockerArgs.push("--network", "none");
+        }
+        if (language === "rust") {
+            dockerArgs.push("-v", `${skillDir}:/skill`);
+        }
+        else if (language === "go") {
+            dockerArgs.push("-v", `${absoluteSkillPath}:${containerSkillPath}`);
+        }
+        else {
+            dockerArgs.push("-v", `${absoluteSkillPath}:${containerSkillPath}:ro`);
+        }
+        for (const envVar of this.config.allowedEnvVars) {
+            if (process.env[envVar]) {
+                dockerArgs.push("-e", `${envVar}=${process.env[envVar]}`);
+            }
+        }
+        dockerArgs.push(imageName);
+        dockerArgs.push(langCmd.cmd, ...langCmd.args);
+        return new Promise((resolve) => {
+            let stdout = "";
+            let stderr = "";
+            let resolved = false;
+            const proc = spawn("docker", dockerArgs, {
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            const timeoutId = setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    proc.kill("SIGTERM");
+                    resolve({
+                        success: false,
+                        error: `Execution timed out after ${timeout}ms`,
+                        stdout,
+                        stderr,
+                        language,
+                        duration: Date.now() - startTime,
+                    });
+                }
+            }, timeout);
+            proc.stdin.write(JSON.stringify(input));
+            proc.stdin.end();
+            proc.stdout.on("data", (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr.on("data", (data) => {
+                stderr += data.toString();
+            });
+            proc.on("close", (exitCode) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                clearTimeout(timeoutId);
+                let output;
+                try {
+                    output = JSON.parse(stdout.trim());
+                }
+                catch {
+                    output = stdout.trim();
+                }
+                resolve({
+                    success: exitCode === 0,
+                    output,
+                    stdout,
+                    stderr,
+                    exitCode: exitCode ?? undefined,
+                    language,
+                    duration: Date.now() - startTime,
+                });
+            });
+            proc.on("error", (error) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                clearTimeout(timeoutId);
+                resolve({
+                    success: false,
+                    error: error.message,
+                    stdout,
+                    stderr,
+                    language,
+                    duration: Date.now() - startTime,
+                });
+            });
+        });
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getMode() {
+        return this.config.mode;
+    }
+}
+let dockerSandboxInstance = null;
+export function getDockerSandbox(config) {
+    if (!dockerSandboxInstance || config) {
+        dockerSandboxInstance = new DockerSandbox(config);
+    }
+    return dockerSandboxInstance;
+}
+export function resetDockerSandbox() {
+    dockerSandboxInstance = null;
+}
+//# sourceMappingURL=DockerSandbox.js.map

package/dist/utils/DockerSandbox.js.map

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

package/dist/utils/FinalizationCompressor.d.ts

@@ -0,0 +1,70 @@
+import { SessionArtifact } from "./artifacts.js";
+export interface CompressionResult {
+    compressed: CompressedArtifact;
+    metrics: CompressionMetrics;
+}
+export interface CompressedArtifact {
+    version: "1.0";
+    sessionId: string;
+    project: string;
+    date: string;
+    gist: string;
+    keyValues: {
+        decisions: string[];
+        outcomes: string[];
+        blockers: string[];
+        nextActions: string[];
+    };
+    preservedLiterals: {
+        numbers: string[];
+        dates: string[];
+        names: string[];
+        codeRefs: string[];
+    };
+    originalHash: string;
+    originalTokens: number;
+    compressedTokens: number;
+}
+export interface CompressionMetrics {
+    originalTokens: number;
+    compressedTokens: number;
+    compressionRatio: number;
+    preservedDecisions: number;
+    preservedLiterals: number;
+    gistLength: number;
+}
+export declare class FinalizationCompressor {
+    compress(artifact: SessionArtifact): CompressionResult;
+    expand(compressed: CompressedArtifact): string;
+    private extractKeyValues;
+    private extractFromContent;
+    private extractLiterals;
+    private generateGist;
+    private hashContent;
+    verifyIntegrity(compressed: CompressedArtifact, original: SessionArtifact): boolean;
+}
+export interface KVCompressedContext {
+    version: "1.0";
+    sessionId: string;
+    context: {
+        what: string;
+        why: string;
+        how: string;
+        next: string;
+    };
+    embeddingHash?: string;
+    compressedAt: string;
+    originalTokens: number;
+    compressedTokens: number;
+}
+export declare class KVCompressor {
+    compressForHandoff(artifact: SessionArtifact): KVCompressedContext;
+    expandForQuery(compressed: KVCompressedContext, query: string): string;
+    private extractWhat;
+    private extractWhy;
+    private extractHow;
+    private extractNext;
+}
+export declare const finalizationCompressor: FinalizationCompressor;
+export declare const kvCompressor: KVCompressor;
+//# sourceMappingURL=FinalizationCompressor.d.ts.map

package/dist/utils/FinalizationCompressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinalizationCompressor.d.ts","sourceRoot":"","sources":["../../src/utils/FinalizationCompressor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IAGb,IAAI,EAAE,MAAM,CAAC;IAGb,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IAGF,iBAAiB,EAAE;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IAGF,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,sBAAsB;IAIjC,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,iBAAiB;IAiDtD,MAAM,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM;IAgE9C,OAAO,CAAC,gBAAgB;IAoDxB,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,eAAe;IA0DvB,OAAO,CAAC,YAAY;IAgCpB,OAAO,CAAC,WAAW;IAanB,eAAe,CACb,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,eAAe,GACxB,OAAO;CAKX;AAMD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAGF,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,YAAY;IAOvB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,mBAAmB;IA6BlE,cAAc,CAAC,UAAU,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAmDtE,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,WAAW;CAYpB;AAMD,eAAO,MAAM,sBAAsB,wBAA+B,CAAC;AACnE,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/utils/FinalizationCompressor.js

@@ -0,0 +1,295 @@
+import { estimateTokens } from "./tokenEstimator.js";
+export class FinalizationCompressor {
+    compress(artifact) {
+        const originalContent = JSON.stringify(artifact);
+        const originalTokens = estimateTokens(originalContent);
+        const keyValues = this.extractKeyValues(artifact);
+        const preservedLiterals = this.extractLiterals(originalContent);
+        const gist = this.generateGist(artifact, keyValues);
+        const compressed = {
+            version: "1.0",
+            sessionId: artifact.sessionId,
+            project: artifact.project,
+            date: artifact.date,
+            gist,
+            keyValues,
+            preservedLiterals,
+            originalHash: this.hashContent(originalContent),
+            originalTokens,
+            compressedTokens: 0,
+        };
+        const compressedContent = JSON.stringify(compressed);
+        compressed.compressedTokens = estimateTokens(compressedContent);
+        const compressionRatio = 1 - compressed.compressedTokens / originalTokens;
+        const metrics = {
+            originalTokens,
+            compressedTokens: compressed.compressedTokens,
+            compressionRatio,
+            preservedDecisions: keyValues.decisions.length,
+            preservedLiterals: preservedLiterals.numbers.length +
+                preservedLiterals.dates.length +
+                preservedLiterals.names.length,
+            gistLength: gist.length,
+        };
+        return { compressed, metrics };
+    }
+    expand(compressed) {
+        const sections = [];
+        sections.push(`# Session: ${compressed.sessionId}`);
+        sections.push(`**Project:** ${compressed.project}`);
+        sections.push(`**Date:** ${compressed.date}`);
+        sections.push("");
+        sections.push("## Summary");
+        sections.push(compressed.gist);
+        sections.push("");
+        if (compressed.keyValues.decisions.length > 0) {
+            sections.push("## Decisions");
+            compressed.keyValues.decisions.forEach((d, i) => {
+                sections.push(`${i + 1}. ${d}`);
+            });
+            sections.push("");
+        }
+        if (compressed.keyValues.outcomes.length > 0) {
+            sections.push("## Outcomes");
+            compressed.keyValues.outcomes.forEach((o, i) => {
+                sections.push(`${i + 1}. ${o}`);
+            });
+            sections.push("");
+        }
+        if (compressed.keyValues.blockers.length > 0) {
+            sections.push("## Blockers");
+            compressed.keyValues.blockers.forEach((b, i) => {
+                sections.push(`${i + 1}. ${b}`);
+            });
+            sections.push("");
+        }
+        if (compressed.keyValues.nextActions.length > 0) {
+            sections.push("## Next Actions");
+            compressed.keyValues.nextActions.forEach((a, i) => {
+                sections.push(`${i + 1}. ${a}`);
+            });
+            sections.push("");
+        }
+        if (compressed.preservedLiterals.codeRefs.length > 0) {
+            sections.push("## Code References");
+            compressed.preservedLiterals.codeRefs.forEach((ref) => {
+                sections.push(`- ${ref}`);
+            });
+        }
+        return sections.join("\n");
+    }
+    extractKeyValues(artifact) {
+        const decisions = [];
+        const outcomes = [];
+        const blockers = [];
+        const nextActions = [];
+        if (artifact.content?.decisions) {
+            decisions.push(...artifact.content.decisions);
+        }
+        if (artifact.content?.implementations) {
+            outcomes.push(...artifact.content.implementations);
+        }
+        if (artifact.content?.challenges) {
+            blockers.push(...artifact.content.challenges);
+        }
+        if (artifact.content?.nextSteps) {
+            nextActions.push(...artifact.content.nextSteps);
+        }
+        if (artifact.content?.summary) {
+            const contentDecisions = this.extractFromContent(artifact.content.summary, ["decided", "decision:", "chose", "selected"]);
+            decisions.push(...contentDecisions);
+            const contentBlockers = this.extractFromContent(artifact.content.summary, ["blocked", "blocker:", "issue:", "problem:"]);
+            blockers.push(...contentBlockers);
+        }
+        return {
+            decisions: [...new Set(decisions)].slice(0, 10),
+            outcomes: [...new Set(outcomes)].slice(0, 10),
+            blockers: [...new Set(blockers)].slice(0, 5),
+            nextActions: [...new Set(nextActions)].slice(0, 5),
+        };
+    }
+    extractFromContent(content, keywords) {
+        const sentences = content.split(/[.!?]\s+/);
+        const matches = [];
+        for (const sentence of sentences) {
+            const lower = sentence.toLowerCase();
+            if (keywords.some((kw) => lower.includes(kw))) {
+                const cleaned = sentence.trim();
+                if (cleaned.length > 10 && cleaned.length < 200) {
+                    matches.push(cleaned);
+                }
+            }
+        }
+        return matches.slice(0, 5);
+    }
+    extractLiterals(content) {
+        const numbers = [...new Set(content.match(/\b\d+\.?\d*%?\b/g) || [])].slice(0, 20);
+        const dates = [
+            ...new Set(content.match(/\b\d{4}-\d{2}-\d{2}\b|\b\d{1,2}\/\d{1,2}\/\d{2,4}\b/g) ||
+                []),
+        ].slice(0, 10);
+        const namePattern = /\b[A-Z][a-z]+(?:\s+[A-Z][a-z]+)*\b/g;
+        const potentialNames = content.match(namePattern) || [];
+        const commonWords = new Set([
+            "The",
+            "This",
+            "That",
+            "These",
+            "Those",
+            "When",
+            "Where",
+            "What",
+            "Which",
+            "How",
+            "Why",
+            "If",
+            "Then",
+            "Now",
+            "Here",
+            "There",
+        ]);
+        const names = [
+            ...new Set(potentialNames.filter((n) => !commonWords.has(n))),
+        ].slice(0, 15);
+        const codeRefs = [
+            ...new Set(content.match(/\b[a-zA-Z_][a-zA-Z0-9_]*\.(ts|js|tsx|jsx|py|go|rs)\b|\b[a-zA-Z_][a-zA-Z0-9_]*\(\)/g) || []),
+        ].slice(0, 20);
+        return { numbers, dates, names, codeRefs };
+    }
+    generateGist(artifact, keyValues) {
+        const parts = [];
+        if (artifact.content?.summary) {
+            const sentences = artifact.content.summary.split(/[.!?]\s+/).slice(0, 2);
+            parts.push(sentences.join(". ") + ".");
+        }
+        const decisionCount = keyValues.decisions.length;
+        const blockerCount = keyValues.blockers.length;
+        const actionCount = keyValues.nextActions.length;
+        if (decisionCount > 0 || blockerCount > 0 || actionCount > 0) {
+            const metrics = [];
+            if (decisionCount > 0)
+                metrics.push(`${decisionCount} decisions`);
+            if (blockerCount > 0)
+                metrics.push(`${blockerCount} blockers`);
+            if (actionCount > 0)
+                metrics.push(`${actionCount} next actions`);
+            parts.push(`Contains ${metrics.join(", ")}.`);
+        }
+        return parts.join(" ").slice(0, 500);
+    }
+    hashContent(content) {
+        let hash = 0;
+        for (let i = 0; i < content.length; i++) {
+            const char = content.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash;
+        }
+        return Math.abs(hash).toString(16).padStart(8, "0");
+    }
+    verifyIntegrity(compressed, original) {
+        const originalContent = JSON.stringify(original);
+        const expectedHash = this.hashContent(originalContent);
+        return compressed.originalHash === expectedHash;
+    }
+}
+export class KVCompressor {
+    compressForHandoff(artifact) {
+        const originalContent = JSON.stringify(artifact);
+        const originalTokens = estimateTokens(originalContent);
+        const context = {
+            what: this.extractWhat(artifact),
+            why: this.extractWhy(artifact),
+            how: this.extractHow(artifact),
+            next: this.extractNext(artifact),
+        };
+        const compressed = {
+            version: "1.0",
+            sessionId: artifact.sessionId || "unknown",
+            context,
+            compressedAt: new Date().toISOString(),
+            originalTokens,
+            compressedTokens: 0,
+        };
+        compressed.compressedTokens = estimateTokens(JSON.stringify(compressed));
+        return compressed;
+    }
+    expandForQuery(compressed, query) {
+        const lower = query.toLowerCase();
+        const aspects = [];
+        if (lower.includes("what") ||
+            lower.includes("accomplish") ||
+            lower.includes("do")) {
+            aspects.push(`**What was accomplished:** ${compressed.context.what}`);
+        }
+        if (lower.includes("why") ||
+            lower.includes("reason") ||
+            lower.includes("decision")) {
+            aspects.push(`**Why:** ${compressed.context.why}`);
+        }
+        if (lower.includes("how") ||
+            lower.includes("implement") ||
+            lower.includes("approach")) {
+            aspects.push(`**How:** ${compressed.context.how}`);
+        }
+        if (lower.includes("next") ||
+            lower.includes("todo") ||
+            lower.includes("action")) {
+            aspects.push(`**Next steps:** ${compressed.context.next}`);
+        }
+        if (aspects.length === 0) {
+            return [
+                `**What:** ${compressed.context.what}`,
+                `**Why:** ${compressed.context.why}`,
+                `**How:** ${compressed.context.how}`,
+                `**Next:** ${compressed.context.next}`,
+            ].join("\n\n");
+        }
+        return aspects.join("\n\n");
+    }
+    extractWhat(artifact) {
+        if (artifact.content?.summary) {
+            return (artifact.content.summary
+                .split(/[.!?]\s+/)
+                .slice(0, 2)
+                .join(". ") + ".");
+        }
+        if (artifact.content?.implementations &&
+            artifact.content.implementations.length > 0) {
+            return artifact.content.implementations.slice(0, 3).join("; ");
+        }
+        return "Session completed.";
+    }
+    extractWhy(artifact) {
+        if (artifact.content?.decisions && artifact.content.decisions.length > 0) {
+            const decisions = artifact.content.decisions.slice(0, 3);
+            return decisions.join("; ");
+        }
+        return "Decisions based on project requirements.";
+    }
+    extractHow(artifact) {
+        if (artifact.content?.implementations &&
+            artifact.content.implementations.length > 0) {
+            return artifact.content.implementations
+                .slice(0, 2)
+                .join("; ")
+                .slice(0, 200);
+        }
+        if (artifact.codeBlocks && artifact.codeBlocks.length > 0) {
+            return `${artifact.codeBlocks.length} code changes implemented.`;
+        }
+        return "Standard implementation approach.";
+    }
+    extractNext(artifact) {
+        if (artifact.content?.nextSteps && artifact.content.nextSteps.length > 0) {
+            return artifact.content.nextSteps.slice(0, 3).join("; ");
+        }
+        if (artifact.content?.challenges &&
+            artifact.content.challenges.length > 0) {
+            return `Resolve: ${artifact.content.challenges.slice(0, 2).join("; ")}`;
+        }
+        return "Continue development.";
+    }
+}
+export const finalizationCompressor = new FinalizationCompressor();
+export const kvCompressor = new KVCompressor();
+//# sourceMappingURL=FinalizationCompressor.js.map