@superblocksteam/vite-plugin-file-sync 1.99.99-next.3 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/ai-service/llm/context-v2/phase2-session-summarizer.js

@@ -0,0 +1,377 @@
+import { getErrorMeta, getPrefixedLogger } from "../../../util/logger.js";
+import { LLMObsTracer } from "../../llmobs/tracer.js";
+import { isTokenLimitError } from "../error.js";
+import { COMPACTION_PROMPT, formatCompactionRequest, formatSummaryMessage, } from "./prompts/compaction.js";
+import { createTruncationFallback } from "./truncation-fallback.js";
+import { toStoredMessage } from "./types.js";
+function getModelId(model) {
+    if (typeof model === "string")
+        return model;
+    return model.modelId ?? "unknown";
+}
+function getProviderId(model) {
+    if (typeof model === "string")
+        return "string-model";
+    return model.provider ?? "unknown";
+}
+const logger = getPrefixedLogger("[phase2-session-summarizer]");
+function getMediaType(value) {
+    if (value.mediaType) {
+        return value.mediaType;
+    }
+    if (value.type === "media" && value.data?.startsWith("data:")) {
+        const match = value.data.match(/^data:([^;,]+)/);
+        return match?.[1] ?? null;
+    }
+    return null;
+}
+function formatMediaTag(mediaType) {
+    if (!mediaType)
+        return "[media]";
+    if (mediaType.startsWith("image/"))
+        return "[image]";
+    if (mediaType.startsWith("video/"))
+        return "[video]";
+    if (mediaType.startsWith("audio/"))
+        return "[audio]";
+    if (mediaType === "application/pdf")
+        return "[pdf]";
+    return `[media: ${mediaType}]`;
+}
+function formatFileTag(part) {
+    const name = part.filename;
+    const mediaType = part.mediaType;
+    if (name && mediaType)
+        return `[file: ${name} (${mediaType})]`;
+    if (name)
+        return `[file: ${name}]`;
+    if (mediaType)
+        return `[file: ${mediaType}]`;
+    return "[file]";
+}
+function stripMedia(msg) {
+    if (!Array.isArray(msg.content)) {
+        return msg;
+    }
+    const strippedContent = msg.content.map((part) => {
+        if (typeof part === "object" &&
+            part !== null &&
+            "type" in part &&
+            part.type === "image") {
+            return { type: "text", text: "[image]" };
+        }
+        if (typeof part === "object" &&
+            part !== null &&
+            "type" in part &&
+            part.type === "file") {
+            const filePart = part;
+            return { type: "text", text: formatFileTag(filePart) };
+        }
+        if (part.type === "tool-result" &&
+            part.output?.type === "content" &&
+            Array.isArray(part.output.value)) {
+            const firstMediaType = part.output.value
+                .map(getMediaType)
+                .find((t) => t !== null);
+            if (firstMediaType) {
+                const tag = formatMediaTag(firstMediaType);
+                return { type: "text", text: tag };
+            }
+        }
+        return part;
+    });
+    return { ...msg, content: strippedContent };
+}
+function stripProviderOptions(msg) {
+    if (!Array.isArray(msg.content)) {
+        return msg;
+    }
+    const strippedContent = msg.content.map((part) => {
+        if (part.type === "reasoning") {
+            const { providerOptions, ...rest } = part;
+            return rest;
+        }
+        return part;
+    });
+    return { ...msg, content: strippedContent };
+}
+function stripSuperblocksMeta({ _superblocks, ...msg }) {
+    return msg;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function getStringField(value, key) {
+    const field = value[key];
+    return typeof field === "string" ? field : undefined;
+}
+function getToolOutputRecord(part) {
+    const outputValue = part.output?.value;
+    return isRecord(outputValue) ? outputValue : null;
+}
+function getToolResultStatus(part) {
+    const outputRecord = getToolOutputRecord(part);
+    const status = outputRecord ? getStringField(outputRecord, "status") : null;
+    if (status)
+        return status;
+    if (part.output?.type?.startsWith("error"))
+        return "error";
+    return "unknown";
+}
+function findLatestBuildToolResult(messages, toolName) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (!msg)
+            continue;
+        if (!Array.isArray(msg.content))
+            continue;
+        for (let j = msg.content.length - 1; j >= 0; j--) {
+            const contentPart = msg.content[j];
+            if (!contentPart)
+                continue;
+            const part = contentPart;
+            if (part.type !== "tool-result" || part.toolName !== toolName) {
+                continue;
+            }
+            const outputRecord = getToolOutputRecord(part);
+            return {
+                toolName,
+                status: getToolResultStatus(part),
+                message: outputRecord
+                    ? getStringField(outputRecord, "message")
+                    : undefined,
+                typeErrors: outputRecord
+                    ? getStringField(outputRecord, "typeErrors")
+                    : undefined,
+            };
+        }
+    }
+    return null;
+}
+function formatBuildToolResult(result) {
+    const details = result.message ? ` - ${result.message}` : "";
+    return `- Latest ${result.toolName} result: ${result.status}${details}`;
+}
+function isSuccessfulStatus(status) {
+    return ["success", "succeeded", "completed"].includes(status);
+}
+function summarizeTypeErrors(typeErrors) {
+    const firstLine = typeErrors
+        .split("\n")
+        .find((line) => line.trim().length > 0)
+        ?.trim();
+    return firstLine ?? "TypeScript errors were reported.";
+}
+function buildGroundingFacts(messages) {
+    const latestBuildDebug = findLatestBuildToolResult(messages, "build_debug");
+    const latestBuildFinalize = findLatestBuildToolResult(messages, "build_finalize");
+    if (!latestBuildDebug && !latestBuildFinalize) {
+        return null;
+    }
+    const lines = [
+        "## Grounding facts extracted from tool results",
+        "Assistant narration, plans, and intentions are not proof of completion; tool results below override conflicting assistant text.",
+    ];
+    if (latestBuildDebug) {
+        lines.push(formatBuildToolResult(latestBuildDebug));
+        if (!isSuccessfulStatus(latestBuildDebug.status)) {
+            lines.push("- build_debug has not passed successfully.");
+        }
+        if (latestBuildDebug.typeErrors) {
+            lines.push(`- Latest build_debug TypeScript errors include: ${summarizeTypeErrors(latestBuildDebug.typeErrors)}`);
+        }
+    }
+    if (latestBuildFinalize) {
+        lines.push(formatBuildToolResult(latestBuildFinalize));
+    }
+    if (!latestBuildFinalize || !isSuccessfulStatus(latestBuildFinalize.status)) {
+        lines.push("- build_finalize has not completed successfully.");
+    }
+    lines.push("Use these facts when deciding Build Status, Completed Work, and Active Task State.");
+    return lines.join("\n");
+}
+function formatGroundedCompactionRequest(groundingFacts, messagesJson) {
+    if (!groundingFacts) {
+        return formatCompactionRequest(messagesJson);
+    }
+    return `${groundingFacts}
+
+## Conversation JSON
+${formatCompactionRequest(messagesJson)}`;
+}
+/**
+ * Summarizes a session, automatically handling oversized inputs by recursively
+ * splitting messages in half until they fit within the model's context window.
+ */
+export async function summarizeSession(options) {
+    const { messages, groundingMessages = messages, model, targetTokens, abortSignal, tracer = LLMObsTracer.instance, summarizeLLM, providerConfig, } = options;
+    const cleanedGroundingMessages = groundingMessages
+        .map(stripMedia)
+        .map(stripProviderOptions)
+        .map(stripSuperblocksMeta);
+    const groundingFacts = buildGroundingFacts(cleanedGroundingMessages);
+    return tracer.trace({ name: "session.summarize", kind: "task" }, async (summarizeSpan) => {
+        async function callLLM(msgs) {
+            return tracer.trace({ name: "session.summarize.llm", kind: "task" }, async (llmSpan) => {
+                const cleanedMessages = msgs
+                    .map(stripMedia)
+                    .map(stripProviderOptions)
+                    .map(stripSuperblocksMeta);
+                // Serialize messages as JSON to avoid provider-specific format issues
+                // (e.g., reasoning blocks, signatures) that cause errors on Bedrock/Vertex
+                const messagesJson = JSON.stringify(cleanedMessages, null, 2);
+                const userMessage = formatGroundedCompactionRequest(groundingFacts, messagesJson);
+                const inputMetadata = {
+                    messageCount: msgs.length,
+                    promptLength: userMessage.length,
+                };
+                // Route the compaction call through the injected summarizer so it
+                // inherits the shared LLMClient's retry, idle-monitor stall
+                // handling, and standardized observer pipeline. Errors propagate to
+                // the splitter below, which still detects token-limit errors and
+                // recurses.
+                let result;
+                try {
+                    result = await summarizeLLM({
+                        model,
+                        system: COMPACTION_PROMPT,
+                        messages: [{ role: "user", content: userMessage }],
+                        maxOutputTokens: 16384,
+                        abortSignal,
+                        providerConfig,
+                    });
+                }
+                catch (err) {
+                    // Keep failed compaction visible at the compaction level: record
+                    // the input shape + error on the summarize.llm span before the
+                    // error propagates to the splitter (which may recurse or truncate).
+                    tracer.annotate(llmSpan, {
+                        metadata: { input: inputMetadata },
+                        error: err,
+                    });
+                    throw err;
+                }
+                const summary = result.text ?? "";
+                const usage = result.usage;
+                const finishReason = result.finishReason;
+                if (!summary) {
+                    const debugInfo = {
+                        model: {
+                            id: getModelId(model),
+                            provider: getProviderId(model),
+                        },
+                        messageCount: msgs.length,
+                        finishReason,
+                        usage: {
+                            inputTokens: usage?.inputTokens,
+                            outputTokens: usage?.outputTokens,
+                            cachedInputTokens: usage?.cachedInputTokens,
+                        },
+                    };
+                    logger.warn("Summarization produced empty summary - debug info:", debugInfo);
+                    throw new Error(`Summarization produced empty summary. finishReason=${finishReason}, ` +
+                        `model=${getModelId(model)}, inputTokens=${usage?.inputTokens}, ` +
+                        `outputTokens=${usage?.outputTokens}`);
+                }
+                tracer.annotate(llmSpan, {
+                    metadata: {
+                        input: inputMetadata,
+                        result: {
+                            summaryLength: summary.length,
+                            inputTokens: usage?.inputTokens,
+                            outputTokens: usage?.outputTokens,
+                            finishReason,
+                        },
+                    },
+                });
+                const summaryWithPreamble = formatSummaryMessage(summary);
+                const summaryMessage = toStoredMessage({ role: "user", content: summaryWithPreamble }, { isSummary: true, tokenCount: usage?.outputTokens });
+                return {
+                    summary,
+                    messages: [summaryMessage],
+                };
+            });
+        }
+        const MAX_SPLIT_DEPTH = 10;
+        async function summarizeWithSplitting(msgs, depth = 0) {
+            // Guard against infinite recursion via depth limit
+            if (depth >= MAX_SPLIT_DEPTH) {
+                logger.warn(`Summarization split depth limit reached (${MAX_SPLIT_DEPTH}). Falling back to truncation.`);
+                return createTruncationFallback(messages, tracer);
+            }
+            // Cannot split further - try to summarize directly, fall back to truncation on failure
+            if (msgs.length < 2) {
+                try {
+                    return await callLLM(msgs);
+                }
+                catch (error) {
+                    if (isTokenLimitError(error)) {
+                        logger.warn(`Token limit exceeded even with ${msgs.length} message(s). Falling back to truncation.`);
+                        return createTruncationFallback(messages, tracer);
+                    }
+                    logger.error("LLM summarization failed. Falling back to truncation.", getErrorMeta(error));
+                    return createTruncationFallback(messages, tracer);
+                }
+            }
+            try {
+                const result = await callLLM(msgs);
+                return result;
+            }
+            catch (error) {
+                if (!isTokenLimitError(error)) {
+                    logger.error("LLM summarization failed. Falling back to truncation.", getErrorMeta(error));
+                    return createTruncationFallback(messages, tracer);
+                }
+                // Token limit exceeded - split messages in half and summarize recursively
+                const midpoint = Math.floor(msgs.length / 2);
+                const firstHalf = msgs.slice(0, midpoint);
+                const secondHalf = msgs.slice(midpoint);
+                logger.warn(`Token limit exceeded with ${msgs.length} messages (depth=${depth}). ` +
+                    `Splitting: first half (${firstHalf.length}), second half (${secondHalf.length})`);
+                // Each recursive split gets its own session.summarize span
+                const firstResult = await tracer.trace({ name: "session.summarize.split", kind: "task" }, async (splitSpan) => {
+                    tracer.annotate(splitSpan, {
+                        metadata: {
+                            input: {
+                                messageCount: firstHalf.length,
+                                splitHalf: "first",
+                                depth: depth + 1,
+                            },
+                        },
+                    });
+                    return summarizeWithSplitting(firstHalf, depth + 1);
+                });
+                return tracer.trace({ name: "session.summarize.split", kind: "task" }, async (splitSpan) => {
+                    tracer.annotate(splitSpan, {
+                        metadata: {
+                            input: {
+                                messageCount: firstResult.messages.length + secondHalf.length,
+                                splitHalf: "combined",
+                                depth: depth + 1,
+                            },
+                        },
+                    });
+                    return summarizeWithSplitting([...firstResult.messages, ...secondHalf], depth + 1);
+                });
+            }
+        }
+        const result = await summarizeWithSplitting(messages);
+        tracer.annotate(summarizeSpan, {
+            metadata: {
+                input: {
+                    messageCount: messages.length,
+                },
+                config: {
+                    targetTokens,
+                },
+                result: {
+                    messageCount: result.messages.length,
+                    summary: result.summary,
+                    summaryLength: result.summary.length,
+                },
+            },
+        });
+        return result;
+    });
+}
+//# sourceMappingURL=phase2-session-summarizer.js.map

package/dist/ai-service/llm/context-v2/phase2-session-summarizer.js.map

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

package/dist/ai-service/llm/context-v2/prompts/compaction.d.ts

@@ -0,0 +1,11 @@
+export declare const COMPACTION_PROMPT = "You will be given a conversation history to summarize. Write a continuation summary that will allow you (or another instance of yourself) to resume work efficiently in a future context window where the conversation history will be replaced with this summary.\n\nWrite a state summary, not a transcript. Treat tool calls and tool results as evidence for the project state. Do not invent, emit, or format fake tool calls, function calls, JSON message objects, or code blocks that pretend to continue tool execution. Report actual accomplishments, current state, unresolved errors, and remaining work in prose or concise bullets. You MUST distinguish completed work from planned, attempted, or failed work.\n\nDo not write the next assistant response. Do not continue the task, apply planned edits, run tools, or describe new tool results as if they happened during summarization. Never include tool-call markup such as <tool-call>, <tool_call>, <tool-result>, <tool_response>, JSON objects with \"name\"/\"arguments\"/\"parameters\", or any other executable-looking tool transcript. Summarize tool activity in prose only.\n\nTreat prior [Session Continuation] summaries as historical context. Do not copy an earlier summary's Active Task State into the new Active Task State unless it is still true after reviewing the later messages. Recompute the active task from the end of the full conversation: later messages always override earlier continuation summaries.\n\nYour summary MUST have two parts:\n\n# PART 1: History Summary\nConcise summary of completed work. Include:\n\n1. Task Overview \u2014 the user's core request, success criteria, and constraints\n2. Completed Work \u2014 what has been done, files created/modified (with paths), key outputs. Only mark work complete when the conversation includes successful write/edit/finalize tool results for it.\n3. Important Discoveries \u2014 technical constraints, decisions and rationale, errors and resolutions\n4. Build Status \u2014 features implemented, `build_debug` results, unresolved errors, API test results, whether `build_finalize` is needed\n5. Context to Preserve \u2014 user preferences, domain-specific details, promises made\n\n# PART 2: Active Task State\nCRITICAL: Look at the END of the conversation. If the assistant was in the middle of executing a task (reading files, making edits, running tools), you MUST preserve the active working state.\n\nIf there is an active task, include:\n\n1. **User's Instruction** \u2014 reproduce the user's most recent request VERBATIM (copy-paste it exactly, do not paraphrase)\n2. **Files Already Read** \u2014 list every file path the assistant already read for this task, with a one-line summary of the relevant content found in each\n3. **Execution Progress** \u2014 what steps have been completed, what step was in progress, what remains\n4. **Plan** \u2014 if the assistant stated a plan, reproduce it\n\nOnly write \"No active task \u2014 all work is complete\" when the final user request has already been fully answered or implemented. Do not infer completion from a plan, attempted edits, or a failed tool call.\n\n---\n\nIn Part 2 be THOROUGH \u2014 use as much space as needed. Reproduce file contents, code snippets, SQL queries, and data that the assistant already retrieved. The resuming agent must be able to continue the active task WITHOUT re-reading files it already read and WITHOUT asking the user to repeat their instruction.\n\nOutput ONLY the summary content. No preamble, no wrapping tags.";
+/**
+ * Formats the conversation history into a user message for compaction.
+ */
+export declare function formatCompactionRequest(messagesJson: string): string;
+/**
+ * Wraps the generated summary with continuation context to help the model
+ * understand it's resuming a previous session.
+ */
+export declare function formatSummaryMessage(summary: string): string;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/ai-service/llm/context-v2/prompts/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context-v2/prompts/compaction.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB,w8GAmCkC,CAAC;AAEjE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY5D"}

package/dist/ai-service/llm/context-v2/prompts/compaction.js

@@ -0,0 +1,63 @@
+// Based on https://platform.claude.com/docs/en/build-with-claude/context-editing#client-side-compaction-sdk
+export const COMPACTION_PROMPT = `You will be given a conversation history to summarize. Write a continuation summary that will allow you (or another instance of yourself) to resume work efficiently in a future context window where the conversation history will be replaced with this summary.
+
+Write a state summary, not a transcript. Treat tool calls and tool results as evidence for the project state. Do not invent, emit, or format fake tool calls, function calls, JSON message objects, or code blocks that pretend to continue tool execution. Report actual accomplishments, current state, unresolved errors, and remaining work in prose or concise bullets. You MUST distinguish completed work from planned, attempted, or failed work.
+
+Do not write the next assistant response. Do not continue the task, apply planned edits, run tools, or describe new tool results as if they happened during summarization. Never include tool-call markup such as <tool-call>, <tool_call>, <tool-result>, <tool_response>, JSON objects with "name"/"arguments"/"parameters", or any other executable-looking tool transcript. Summarize tool activity in prose only.
+
+Treat prior [Session Continuation] summaries as historical context. Do not copy an earlier summary's Active Task State into the new Active Task State unless it is still true after reviewing the later messages. Recompute the active task from the end of the full conversation: later messages always override earlier continuation summaries.
+
+Your summary MUST have two parts:
+
+# PART 1: History Summary
+Concise summary of completed work. Include:
+
+1. Task Overview — the user's core request, success criteria, and constraints
+2. Completed Work — what has been done, files created/modified (with paths), key outputs. Only mark work complete when the conversation includes successful write/edit/finalize tool results for it.
+3. Important Discoveries — technical constraints, decisions and rationale, errors and resolutions
+4. Build Status — features implemented, \`build_debug\` results, unresolved errors, API test results, whether \`build_finalize\` is needed
+5. Context to Preserve — user preferences, domain-specific details, promises made
+
+# PART 2: Active Task State
+CRITICAL: Look at the END of the conversation. If the assistant was in the middle of executing a task (reading files, making edits, running tools), you MUST preserve the active working state.
+
+If there is an active task, include:
+
+1. **User's Instruction** — reproduce the user's most recent request VERBATIM (copy-paste it exactly, do not paraphrase)
+2. **Files Already Read** — list every file path the assistant already read for this task, with a one-line summary of the relevant content found in each
+3. **Execution Progress** — what steps have been completed, what step was in progress, what remains
+4. **Plan** — if the assistant stated a plan, reproduce it
+
+Only write "No active task — all work is complete" when the final user request has already been fully answered or implemented. Do not infer completion from a plan, attempted edits, or a failed tool call.
+
+---
+
+In Part 2 be THOROUGH — use as much space as needed. Reproduce file contents, code snippets, SQL queries, and data that the assistant already retrieved. The resuming agent must be able to continue the active task WITHOUT re-reading files it already read and WITHOUT asking the user to repeat their instruction.
+
+Output ONLY the summary content. No preamble, no wrapping tags.`;
+/**
+ * Formats the conversation history into a user message for compaction.
+ */
+export function formatCompactionRequest(messagesJson) {
+    return `\`\`\`json
+${messagesJson}
+\`\`\``;
+}
+/**
+ * Wraps the generated summary with continuation context to help the model
+ * understand it's resuming a previous session.
+ */
+export function formatSummaryMessage(summary) {
+    return `[Session Continuation]
+
+You are resuming a previous session. The following is a summary of what has been accomplished so far:
+
+---
+
+${summary}
+
+---
+
+Continue from where you left off. If there are next steps outlined above, proceed with them.`;
+}
+//# sourceMappingURL=compaction.js.map

package/dist/ai-service/llm/context-v2/prompts/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context-v2/prompts/compaction.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAmC+B,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,OAAO;EACP,YAAY;OACP,CAAC;AACR,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO;;;;;;EAMP,OAAO;;;;6FAIoF,CAAC;AAC9F,CAAC"}

package/dist/ai-service/llm/context-v2/session-capture.d.ts

@@ -0,0 +1,18 @@
+import type { LanguageModelUsage } from "ai";
+import type { StoredMessage } from "./types.js";
+export interface CapturedSession {
+    messages: StoredMessage[];
+    usage: LanguageModelUsage;
+}
+/**
+ * Capture full session data for debugging compaction failures.
+ * Sessions are saved to {rootDir}/.superblocks/captured-sessions/
+ *
+ * @param data - The session data to capture
+ * @param rootDir - The app root directory
+ */
+export declare function captureSession(data: {
+    messages: StoredMessage[];
+    usage: LanguageModelUsage;
+}, rootDir: string): string | null;
+//# sourceMappingURL=session-capture.d.ts.map

package/dist/ai-service/llm/context-v2/session-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-capture.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/llm/context-v2/session-capture.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAWhD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAwBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE;IACJ,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,kBAAkB,CAAC;CAC3B,EACD,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAyBf"}

package/dist/ai-service/llm/context-v2/session-capture.js

@@ -0,0 +1,64 @@
+/**
+ * Session capture utility for debugging compaction failures.
+ *
+ * Sessions are saved to the app's .superblocks/captured-sessions folder.
+ * Captured sessions can be replayed in integration tests to verify
+ * summarization quality using LLM-as-judge.
+ */
+import { writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { getPrefixedLogger } from "../../../util/logger.js";
+const logger = getPrefixedLogger("[session-capture]");
+/** Set to true to capture sessions for debugging compaction failures */
+const CAPTURE_ENABLED = false;
+function isTestEnvironment() {
+    return process.env.VITEST === "true" || process.env.NODE_ENV === "test";
+}
+function isEnabled() {
+    if (isTestEnvironment()) {
+        return false;
+    }
+    return CAPTURE_ENABLED;
+}
+function getCaptureDir(rootDir) {
+    return join(rootDir, ".superblocks", "captured-sessions");
+}
+function ensureDir(captureDir) {
+    if (!existsSync(captureDir)) {
+        mkdirSync(captureDir, { recursive: true });
+    }
+}
+function generateFilename() {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    return `session-${timestamp}.json`;
+}
+/**
+ * Capture full session data for debugging compaction failures.
+ * Sessions are saved to {rootDir}/.superblocks/captured-sessions/
+ *
+ * @param data - The session data to capture
+ * @param rootDir - The app root directory
+ */
+export function captureSession(data, rootDir) {
+    if (!isEnabled()) {
+        return null;
+    }
+    try {
+        const captureDir = getCaptureDir(rootDir);
+        ensureDir(captureDir);
+        const session = {
+            messages: data.messages,
+            usage: data.usage,
+        };
+        const filename = generateFilename();
+        const filepath = join(captureDir, filename);
+        writeFileSync(filepath, JSON.stringify(session, null, 2));
+        logger.info(`Captured session to ${filepath}`);
+        return filepath;
+    }
+    catch (err) {
+        logger.error(`Failed to capture session: ${err}`);
+        return null;
+    }
+}
+//# sourceMappingURL=session-capture.js.map

package/dist/ai-service/llm/context-v2/session-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-capture.js","sourceRoot":"","sources":["../../../../src/ai-service/llm/context-v2/session-capture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,MAAM,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;AAEtD,wEAAwE;AACxE,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,SAAS,iBAAiB;IACxB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC;AAC1E,CAAC;AAOD,SAAS,SAAS;IAChB,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,mBAAmB,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,SAAS,CAAC,UAAkB;IACnC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,OAAO,WAAW,SAAS,OAAO,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,IAGC,EACD,OAAe;IAEf,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1C,SAAS,CAAC,UAAU,CAAC,CAAC;QAEtB,MAAM,OAAO,GAAoB;YAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QAEF,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAE5C,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,IAAI,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;QAE/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}