@bastani/atomic 0.8.31-alpha.5 → 0.9.0-alpha.1

package/dist/core/compaction/context-compaction-runner.js

@@ -0,0 +1,181 @@
+import { Agent } from "@earendil-works/pi-agent-core";
+import { createAssistantMessageEventStream, isContextOverflow, streamSimple } from "@earendil-works/pi-ai";
+import { formatCopilotProviderError } from "../copilot-errors.js";
+import { CONTEXT_COMPACTION_AUTO_QUERY } from "./context-compaction-types.js";
+import { createContextCompactionBudgetDetails, contextCompactionProgressKey, contextCompactionProgressPercent, contextCompactionTargetLabel, contextCompactionTargetMet, formatErrorMessage, } from "./context-compaction-metrics.js";
+import { getTranscriptCompactionParameters, normalizeContextCompactionParameters, } from "./context-compaction-strategy.js";
+import { CONTEXT_COMPACTION_BUDGET_TOOL_NAME, CONTEXT_DELETE_TOOL_NAME, CONTEXT_GREP_DELETE_TOOL_NAME, CONTEXT_READ_ENTRY_TOOL_NAME, CONTEXT_SEARCH_TRANSCRIPT_TOOL_NAME, } from "./context-deletion-tool-definitions.js";
+import { createContextDeletionTool } from "./context-deletion-tools.js";
+import { buildContextCompactionPrompt, CONTEXT_COMPACTION_SYSTEM_PROMPT, writeContextCompactionTranscriptFile, } from "./context-compaction-prompt.js";
+function createContextCompactionTargetNudgeMessage(result, parameters) {
+    const currentReductionPercent = contextCompactionProgressPercent(result);
+    const targetLabel = contextCompactionTargetLabel(parameters);
+    const tokensToDelete = result
+        ? createContextCompactionBudgetDetails(result.stats, 0, undefined, parameters).tokensToDeleteForTarget
+        : undefined;
+    const remainingText = tokensToDelete !== undefined ? ` Delete about ${tokensToDelete} more token(s) if safe candidates exist.` : "";
+    return {
+        role: "user",
+        content: [
+            {
+                type: "text",
+                text: `The strict ${targetLabel} context-reduction requirement is not met yet; current validated reduction is ${currentReductionPercent}%.${remainingText} Continue removing low-value message entries or message content blocks using ${CONTEXT_DELETE_TOOL_NAME} or ${CONTEXT_GREP_DELETE_TOOL_NAME}. Use the focus query ${JSON.stringify(parameters.query)} to preserve relevant context. Call ${CONTEXT_COMPACTION_BUDGET_TOOL_NAME} to verify progress, and do not provide a final answer until the validated reduction is at least ${targetLabel}.`,
+            },
+        ],
+        timestamp: Date.now(),
+    };
+}
+function createContextCompactionAssistantMessage(model, content, stopReason, errorMessage) {
+    return {
+        role: "assistant",
+        content,
+        api: model.api,
+        provider: model.provider,
+        model: model.id,
+        usage: {
+            input: 0,
+            output: 0,
+            cacheRead: 0,
+            cacheWrite: 0,
+            totalTokens: 0,
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+        },
+        stopReason,
+        ...(errorMessage !== undefined ? { errorMessage } : {}),
+        timestamp: Date.now(),
+    };
+}
+function createContextCompactionStopStream(model, text) {
+    const stream = createAssistantMessageEventStream();
+    queueMicrotask(() => {
+        const message = createContextCompactionAssistantMessage(model, [{ type: "text", text }], "stop");
+        stream.push({ type: "done", reason: "stop", message });
+        stream.end(message);
+    });
+    return stream;
+}
+function isContextCompactionOverflowError(model, errorMessage) {
+    return isContextOverflow(createContextCompactionAssistantMessage(model, [], "error", errorMessage), model.contextWindow);
+}
+async function runContextDeletionAssistant(inputTranscript, model, apiKey, headers, signal, thinkingLevel = "off", parameters = getTranscriptCompactionParameters(inputTranscript)) {
+    const transcript = { ...inputTranscript, parameters };
+    const maxTokens = model.maxTokens > 0 ? model.maxTokens : Number.POSITIVE_INFINITY;
+    if (signal?.aborted) {
+        throw new Error("Context compaction failed: Request was aborted");
+    }
+    const transcriptFile = writeContextCompactionTranscriptFile(transcript);
+    const promptMessage = {
+        role: "user",
+        content: [{ type: "text", text: buildContextCompactionPrompt(transcript, transcriptFile.path, parameters) }],
+        timestamp: Date.now(),
+    };
+    const deletionTool = createContextDeletionTool(transcript, { contextWindow: model.contextWindow, ...parameters });
+    const agent = new Agent({
+        initialState: {
+            systemPrompt: CONTEXT_COMPACTION_SYSTEM_PROMPT,
+            model,
+            thinkingLevel,
+            tools: deletionTool.tools,
+        },
+        toolExecution: "parallel",
+        streamFn: async (requestModel, context, streamOptions) => {
+            const currentResult = deletionTool.getValidatedResult();
+            if (contextCompactionTargetMet(currentResult, parameters)) {
+                return createContextCompactionStopStream(requestModel, `Reached the strict ${contextCompactionTargetLabel(parameters)} context-reduction requirement (${currentResult.stats.percentReduction}%); using the validated deletions recorded so far.`);
+            }
+            return streamSimple(requestModel, context, {
+                ...streamOptions,
+                maxTokens,
+                apiKey,
+                headers: headers ?? streamOptions?.headers,
+            });
+        },
+    });
+    let lastNudgedProgressKey;
+    const unsubscribeNudge = agent.subscribe((event, eventSignal) => {
+        if (event.type !== "turn_end" || signal?.aborted || eventSignal.aborted)
+            return;
+        if (event.message.role !== "assistant")
+            return;
+        if (event.message.stopReason === "error" || event.message.stopReason === "aborted")
+            return;
+        if (event.message.content.some((content) => content.type === "toolCall"))
+            return;
+        const currentResult = deletionTool.getValidatedResult();
+        if (contextCompactionTargetMet(currentResult, parameters))
+            return;
+        const progressKey = contextCompactionProgressKey(currentResult);
+        if (progressKey === lastNudgedProgressKey)
+            return;
+        lastNudgedProgressKey = progressKey;
+        agent.followUp(createContextCompactionTargetNudgeMessage(currentResult, parameters));
+    });
+    const abortOnSignal = () => agent.abort();
+    signal?.addEventListener("abort", abortOnSignal, { once: true });
+    try {
+        await agent.prompt(promptMessage);
+    }
+    catch (error) {
+        if (signal?.aborted) {
+            throw new Error("Context compaction failed: Request was aborted");
+        }
+        throw new Error(`Context compaction failed: ${formatCopilotProviderError(model.provider, formatErrorMessage(error))}`);
+    }
+    finally {
+        signal?.removeEventListener("abort", abortOnSignal);
+        unsubscribeNudge();
+        transcriptFile.cleanup();
+    }
+    if (signal?.aborted) {
+        throw new Error("Context compaction failed: Request was aborted");
+    }
+    if (agent.state.errorMessage) {
+        const formattedErrorMessage = formatCopilotProviderError(model.provider, agent.state.errorMessage);
+        if (isContextCompactionOverflowError(model, agent.state.errorMessage)) {
+            return {
+                validatedResult: deletionTool.getValidatedResult(),
+                lastToolError: deletionTool.getLastError(),
+                providerError: formattedErrorMessage === agent.state.errorMessage ? undefined : formattedErrorMessage,
+            };
+        }
+        throw new Error(`Context compaction failed: ${formattedErrorMessage}`);
+    }
+    if (deletionTool.getCallCount() === 0) {
+        throw new Error(`Context compaction did not call any transcript inspection, budget, or deletion tools (${CONTEXT_SEARCH_TRANSCRIPT_TOOL_NAME}, ${CONTEXT_READ_ENTRY_TOOL_NAME}, ${CONTEXT_COMPACTION_BUDGET_TOOL_NAME}, ${CONTEXT_DELETE_TOOL_NAME}, or ${CONTEXT_GREP_DELETE_TOOL_NAME})`);
+    }
+    return {
+        validatedResult: deletionTool.getValidatedResult(),
+        lastToolError: deletionTool.getLastError(),
+        providerError: undefined,
+    };
+}
+function hasMetContextCompactionTarget(run, parameters) {
+    return contextCompactionTargetMet(run.validatedResult, parameters);
+}
+function formatContextCompactionTargetFailureMessage(attempts, parameters) {
+    const targetLabel = contextCompactionTargetLabel(parameters);
+    if (attempts.length === 0) {
+        return `Context compaction did not meet the strict ${targetLabel} reduction requirement`;
+    }
+    const attemptDetails = attempts
+        .map((attempt) => {
+        const reduction = contextCompactionProgressPercent(attempt.validatedResult);
+        const deletionCount = attempt.validatedResult?.deletedTargets.length ?? 0;
+        const toolErrorText = attempt.lastToolError ? `; last deletion tool error: ${attempt.lastToolError}` : "";
+        const providerErrorText = attempt.providerError ? `; provider error: ${attempt.providerError}` : "";
+        return `attempt reached ${reduction}% with ${deletionCount} validated deletion target(s)${toolErrorText}${providerErrorText}`;
+    })
+        .join("; ");
+    return `Context compaction did not meet the strict ${targetLabel} reduction requirement; ${attemptDetails}`;
+}
+export async function contextCompact(preparation, model, apiKey, headers, signal, thinkingLevel = "off") {
+    const parameters = normalizeContextCompactionParameters(preparation.parameters ?? preparation.transcript.parameters, preparation.parameters?.query ?? preparation.transcript.parameters?.query ?? CONTEXT_COMPACTION_AUTO_QUERY);
+    const transcript = { ...preparation.transcript, parameters };
+    const attempts = [];
+    const standardRun = await runContextDeletionAssistant(transcript, model, apiKey, headers, signal, thinkingLevel, parameters);
+    if (hasMetContextCompactionTarget(standardRun, parameters))
+        return standardRun.validatedResult;
+    attempts.push({ ...standardRun });
+    throw new Error(formatContextCompactionTargetFailureMessage(attempts, parameters));
+}
+//# sourceMappingURL=context-compaction-runner.js.map

package/dist/core/compaction/context-compaction-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compaction-runner.js","sourceRoot":"","sources":["../../../src/core/compaction/context-compaction-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { Agent, type AgentMessage, type ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, AssistantMessage, Model } from \"@earendil-works/pi-ai\";\nimport { createAssistantMessageEventStream, isContextOverflow, streamSimple } from \"@earendil-works/pi-ai\";\nimport { formatCopilotProviderError } from \"../copilot-errors.ts\";\nimport type {\n\tCompactableTranscript,\n\tContextCompactionParameters,\n\tContextCompactionPreparation,\n\tValidatedContextDeletionResult,\n} from \"./context-compaction-types.ts\";\nimport { CONTEXT_COMPACTION_AUTO_QUERY } from \"./context-compaction-types.ts\";\nimport {\n\tcreateContextCompactionBudgetDetails,\n\tcontextCompactionProgressKey,\n\tcontextCompactionProgressPercent,\n\tcontextCompactionTargetLabel,\n\tcontextCompactionTargetMet,\n\tformatErrorMessage,\n} from \"./context-compaction-metrics.ts\";\nimport {\n\tgetTranscriptCompactionParameters,\n\tnormalizeContextCompactionParameters,\n} from \"./context-compaction-strategy.ts\";\nimport {\n\tCONTEXT_COMPACTION_BUDGET_TOOL_NAME,\n\tCONTEXT_DELETE_TOOL_NAME,\n\tCONTEXT_GREP_DELETE_TOOL_NAME,\n\tCONTEXT_READ_ENTRY_TOOL_NAME,\n\tCONTEXT_SEARCH_TRANSCRIPT_TOOL_NAME,\n} from \"./context-deletion-tool-definitions.ts\";\nimport { createContextDeletionTool } from \"./context-deletion-tools.ts\";\nimport {\n\tbuildContextCompactionPrompt,\n\tCONTEXT_COMPACTION_SYSTEM_PROMPT,\n\twriteContextCompactionTranscriptFile,\n} from \"./context-compaction-prompt.ts\";\n\nfunction createContextCompactionTargetNudgeMessage(\n\tresult: ValidatedContextDeletionResult | undefined,\n\tparameters: ContextCompactionParameters,\n): AgentMessage {\n\tconst currentReductionPercent = contextCompactionProgressPercent(result);\n\tconst targetLabel = contextCompactionTargetLabel(parameters);\n\tconst tokensToDelete = result\n\t\t? createContextCompactionBudgetDetails(result.stats, 0, undefined, parameters).tokensToDeleteForTarget\n\t\t: undefined;\n\tconst remainingText = tokensToDelete !== undefined ? ` Delete about ${tokensToDelete} more token(s) if safe candidates exist.` : \"\";\n\treturn {\n\t\trole: \"user\",\n\t\tcontent: [\n\t\t\t{\n\t\t\t\ttype: \"text\",\n\t\t\t\ttext: `The strict ${targetLabel} context-reduction requirement is not met yet; current validated reduction is ${currentReductionPercent}%.${remainingText} Continue removing low-value message entries or message content blocks using ${CONTEXT_DELETE_TOOL_NAME} or ${CONTEXT_GREP_DELETE_TOOL_NAME}. Use the focus query ${JSON.stringify(parameters.query)} to preserve relevant context. Call ${CONTEXT_COMPACTION_BUDGET_TOOL_NAME} to verify progress, and do not provide a final answer until the validated reduction is at least ${targetLabel}.`,\n\t\t\t},\n\t\t],\n\t\ttimestamp: Date.now(),\n\t};\n}\nfunction createContextCompactionAssistantMessage(\n\tmodel: Model<Api>,\n\tcontent: AssistantMessage[\"content\"],\n\tstopReason: AssistantMessage[\"stopReason\"],\n\terrorMessage?: string,\n): AssistantMessage {\n\treturn {\n\t\trole: \"assistant\",\n\t\tcontent,\n\t\tapi: model.api,\n\t\tprovider: model.provider,\n\t\tmodel: model.id,\n\t\tusage: {\n\t\t\tinput: 0,\n\t\t\toutput: 0,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t\ttotalTokens: 0,\n\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t},\n\t\tstopReason,\n\t\t...(errorMessage !== undefined ? { errorMessage } : {}),\n\t\ttimestamp: Date.now(),\n\t};\n}\n\nfunction createContextCompactionStopStream(model: Model<Api>, text: string) {\n\tconst stream = createAssistantMessageEventStream();\n\tqueueMicrotask(() => {\n\t\tconst message = createContextCompactionAssistantMessage(model, [{ type: \"text\", text }], \"stop\");\n\t\tstream.push({ type: \"done\", reason: \"stop\", message });\n\t\tstream.end(message);\n\t});\n\treturn stream;\n}\n\nfunction isContextCompactionOverflowError(model: Model<Api>, errorMessage: string): boolean {\n\treturn isContextOverflow(\n\t\tcreateContextCompactionAssistantMessage(model, [], \"error\", errorMessage),\n\t\tmodel.contextWindow,\n\t);\n}\n\ninterface ContextDeletionRun {\n\tvalidatedResult: ValidatedContextDeletionResult | undefined;\n\tlastToolError: string | undefined;\n\tproviderError: string | undefined;\n}\n\nasync function runContextDeletionAssistant(\n\tinputTranscript: CompactableTranscript,\n\tmodel: Model<Api>,\n\tapiKey: string,\n\theaders?: Record<string, string>,\n\tsignal?: AbortSignal,\n\tthinkingLevel: ThinkingLevel = \"off\",\n\tparameters: ContextCompactionParameters = getTranscriptCompactionParameters(inputTranscript),\n): Promise<ContextDeletionRun> {\n\tconst transcript: CompactableTranscript = { ...inputTranscript, parameters };\n\tconst maxTokens = model.maxTokens > 0 ? model.maxTokens : Number.POSITIVE_INFINITY;\n\tif (signal?.aborted) {\n\t\tthrow new Error(\"Context compaction failed: Request was aborted\");\n\t}\n\tconst transcriptFile = writeContextCompactionTranscriptFile(transcript);\n\tconst promptMessage: AgentMessage = {\n\t\trole: \"user\",\n\t\tcontent: [{ type: \"text\", text: buildContextCompactionPrompt(transcript, transcriptFile.path, parameters) }],\n\t\ttimestamp: Date.now(),\n\t};\n\tconst deletionTool = createContextDeletionTool(transcript, { contextWindow: model.contextWindow, ...parameters });\n\tconst agent = new Agent({\n\t\tinitialState: {\n\t\t\tsystemPrompt: CONTEXT_COMPACTION_SYSTEM_PROMPT,\n\t\t\tmodel,\n\t\t\tthinkingLevel,\n\t\t\ttools: deletionTool.tools,\n\t\t},\n\t\ttoolExecution: \"parallel\",\n\t\tstreamFn: async (requestModel, context, streamOptions) => {\n\t\t\tconst currentResult = deletionTool.getValidatedResult();\n\t\t\tif (contextCompactionTargetMet(currentResult, parameters)) {\n\t\t\t\treturn createContextCompactionStopStream(\n\t\t\t\t\trequestModel,\n\t\t\t\t\t`Reached the strict ${contextCompactionTargetLabel(parameters)} context-reduction requirement (${currentResult.stats.percentReduction}%); using the validated deletions recorded so far.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn streamSimple(requestModel, context, {\n\t\t\t\t...streamOptions,\n\t\t\t\tmaxTokens,\n\t\t\t\tapiKey,\n\t\t\t\theaders: headers ?? streamOptions?.headers,\n\t\t\t});\n\t\t},\n\t});\n\n\tlet lastNudgedProgressKey: string | undefined;\n\tconst unsubscribeNudge = agent.subscribe((event, eventSignal) => {\n\t\tif (event.type !== \"turn_end\" || signal?.aborted || eventSignal.aborted) return;\n\t\tif (event.message.role !== \"assistant\") return;\n\t\tif (event.message.stopReason === \"error\" || event.message.stopReason === \"aborted\") return;\n\t\tif (event.message.content.some((content) => content.type === \"toolCall\")) return;\n\t\tconst currentResult = deletionTool.getValidatedResult();\n\t\tif (contextCompactionTargetMet(currentResult, parameters)) return;\n\t\tconst progressKey = contextCompactionProgressKey(currentResult);\n\t\tif (progressKey === lastNudgedProgressKey) return;\n\t\tlastNudgedProgressKey = progressKey;\n\t\tagent.followUp(createContextCompactionTargetNudgeMessage(currentResult, parameters));\n\t});\n\n\tconst abortOnSignal = () => agent.abort();\n\tsignal?.addEventListener(\"abort\", abortOnSignal, { once: true });\n\ttry {\n\t\tawait agent.prompt(promptMessage);\n\t} catch (error) {\n\t\tif (signal?.aborted) {\n\t\t\tthrow new Error(\"Context compaction failed: Request was aborted\");\n\t\t}\n\t\tthrow new Error(`Context compaction failed: ${formatCopilotProviderError(model.provider, formatErrorMessage(error))}`);\n\t} finally {\n\t\tsignal?.removeEventListener(\"abort\", abortOnSignal);\n\t\tunsubscribeNudge();\n\t\ttranscriptFile.cleanup();\n\t}\n\n\tif (signal?.aborted) {\n\t\tthrow new Error(\"Context compaction failed: Request was aborted\");\n\t}\n\tif (agent.state.errorMessage) {\n\t\tconst formattedErrorMessage = formatCopilotProviderError(model.provider, agent.state.errorMessage);\n\t\tif (isContextCompactionOverflowError(model, agent.state.errorMessage)) {\n\t\t\treturn {\n\t\t\t\tvalidatedResult: deletionTool.getValidatedResult(),\n\t\t\t\tlastToolError: deletionTool.getLastError(),\n\t\t\t\tproviderError: formattedErrorMessage === agent.state.errorMessage ? undefined : formattedErrorMessage,\n\t\t\t};\n\t\t}\n\t\tthrow new Error(`Context compaction failed: ${formattedErrorMessage}`);\n\t}\n\tif (deletionTool.getCallCount() === 0) {\n\t\tthrow new Error(\n\t\t\t`Context compaction did not call any transcript inspection, budget, or deletion tools (${CONTEXT_SEARCH_TRANSCRIPT_TOOL_NAME}, ${CONTEXT_READ_ENTRY_TOOL_NAME}, ${CONTEXT_COMPACTION_BUDGET_TOOL_NAME}, ${CONTEXT_DELETE_TOOL_NAME}, or ${CONTEXT_GREP_DELETE_TOOL_NAME})`,\n\t\t);\n\t}\n\treturn {\n\t\tvalidatedResult: deletionTool.getValidatedResult(),\n\t\tlastToolError: deletionTool.getLastError(),\n\t\tproviderError: undefined,\n\t};\n}\n\nfunction hasMetContextCompactionTarget(\n\trun: ContextDeletionRun,\n\tparameters: ContextCompactionParameters,\n): run is ContextDeletionRun & { validatedResult: ValidatedContextDeletionResult } {\n\treturn contextCompactionTargetMet(run.validatedResult, parameters);\n}\n\nfunction formatContextCompactionTargetFailureMessage(\n\tattempts: readonly ContextDeletionRunAttempt[],\n\tparameters: ContextCompactionParameters,\n): string {\n\tconst targetLabel = contextCompactionTargetLabel(parameters);\n\tif (attempts.length === 0) {\n\t\treturn `Context compaction did not meet the strict ${targetLabel} reduction requirement`;\n\t}\n\tconst attemptDetails = attempts\n\t\t.map((attempt) => {\n\t\t\tconst reduction = contextCompactionProgressPercent(attempt.validatedResult);\n\t\t\tconst deletionCount = attempt.validatedResult?.deletedTargets.length ?? 0;\n\t\t\tconst toolErrorText = attempt.lastToolError ? `; last deletion tool error: ${attempt.lastToolError}` : \"\";\n\t\t\tconst providerErrorText = attempt.providerError ? `; provider error: ${attempt.providerError}` : \"\";\n\t\t\treturn `attempt reached ${reduction}% with ${deletionCount} validated deletion target(s)${toolErrorText}${providerErrorText}`;\n\t\t})\n\t\t.join(\"; \");\n\treturn `Context compaction did not meet the strict ${targetLabel} reduction requirement; ${attemptDetails}`;\n}\n\ninterface ContextDeletionRunAttempt extends ContextDeletionRun {}\n\nexport async function contextCompact(\n\tpreparation: ContextCompactionPreparation,\n\tmodel: Model<Api>,\n\tapiKey: string,\n\theaders?: Record<string, string>,\n\tsignal?: AbortSignal,\n\tthinkingLevel: ThinkingLevel = \"off\",\n): Promise<ValidatedContextDeletionResult> {\n\tconst parameters = normalizeContextCompactionParameters(\n\t\tpreparation.parameters ?? preparation.transcript.parameters,\n\t\tpreparation.parameters?.query ?? preparation.transcript.parameters?.query ?? CONTEXT_COMPACTION_AUTO_QUERY,\n\t);\n\tconst transcript: CompactableTranscript = { ...preparation.transcript, parameters };\n\tconst attempts: ContextDeletionRunAttempt[] = [];\n\tconst standardRun = await runContextDeletionAssistant(\n\t\ttranscript,\n\t\tmodel,\n\t\tapiKey,\n\t\theaders,\n\t\tsignal,\n\t\tthinkingLevel,\n\t\tparameters,\n\t);\n\tif (hasMetContextCompactionTarget(standardRun, parameters)) return standardRun.validatedResult;\n\tattempts.push({ ...standardRun });\n\n\tthrow new Error(formatContextCompactionTargetFailureMessage(attempts, parameters));\n}\n"]}

package/dist/core/compaction/context-compaction-strategy.d.ts

@@ -0,0 +1,5 @@
+import { type CompactableTranscript, type ContextCompactionParameters } from "./context-compaction-types.ts";
+export declare function normalizeContextCompactionQuery(value: string | undefined, fallbackQuery: string): string;
+export declare function normalizeContextCompactionParameters(input?: Partial<ContextCompactionParameters>, fallbackQuery?: string): ContextCompactionParameters;
+export declare function getTranscriptCompactionParameters(transcript: CompactableTranscript): ContextCompactionParameters;
+//# sourceMappingURL=context-compaction-strategy.d.ts.map

package/dist/core/compaction/context-compaction-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compaction-strategy.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/context-compaction-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,MAAM,+BAA+B,CAAC;AAcvC,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKxG;AAED,wBAAgB,oCAAoC,CACnD,KAAK,GAAE,OAAO,CAAC,2BAA2B,CAAM,EAChD,aAAa,GAAE,MAAsC,GACnD,2BAA2B,CAM7B;AAED,wBAAgB,iCAAiC,CAAC,UAAU,EAAE,qBAAqB,GAAG,2BAA2B,CAKhH","sourcesContent":["import {\n\tCONTEXT_COMPACTION_AUTO_QUERY,\n\tCONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO,\n\tCONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT,\n\ttype CompactableTranscript,\n\ttype ContextCompactionParameters,\n} from \"./context-compaction-types.ts\";\n\nconst CONTEXT_COMPACTION_QUERY_MAX_CHARS = 1000;\n\nfunction normalizeCompressionRatio(value: number | undefined): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) && value > 0 && value < 1\n\t\t? value\n\t\t: CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO;\n}\n\nfunction normalizePreserveRecent(value: number | undefined): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) ? Math.max(0, Math.floor(value)) : CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT;\n}\n\nexport function normalizeContextCompactionQuery(value: string | undefined, fallbackQuery: string): string {\n\tconst query = value?.trim() || fallbackQuery.trim() || CONTEXT_COMPACTION_AUTO_QUERY;\n\treturn query.length > CONTEXT_COMPACTION_QUERY_MAX_CHARS\n\t\t? `${query.slice(0, CONTEXT_COMPACTION_QUERY_MAX_CHARS)}\\n[... ${query.length - CONTEXT_COMPACTION_QUERY_MAX_CHARS} more characters omitted from compaction query]`\n\t\t: query;\n}\n\nexport function normalizeContextCompactionParameters(\n\tinput: Partial<ContextCompactionParameters> = {},\n\tfallbackQuery: string = CONTEXT_COMPACTION_AUTO_QUERY,\n): ContextCompactionParameters {\n\treturn {\n\t\tcompression_ratio: normalizeCompressionRatio(input.compression_ratio),\n\t\tpreserve_recent: normalizePreserveRecent(input.preserve_recent),\n\t\tquery: normalizeContextCompactionQuery(input.query, fallbackQuery),\n\t};\n}\n\nexport function getTranscriptCompactionParameters(transcript: CompactableTranscript): ContextCompactionParameters {\n\treturn normalizeContextCompactionParameters(\n\t\ttranscript.parameters ?? transcript.settings,\n\t\ttranscript.parameters?.query ?? transcript.settings.query ?? CONTEXT_COMPACTION_AUTO_QUERY,\n\t);\n}\n"]}

package/dist/core/compaction/context-compaction-strategy.js

@@ -0,0 +1,27 @@
+import { CONTEXT_COMPACTION_AUTO_QUERY, CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO, CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT, } from "./context-compaction-types.js";
+const CONTEXT_COMPACTION_QUERY_MAX_CHARS = 1000;
+function normalizeCompressionRatio(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 && value < 1
+        ? value
+        : CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO;
+}
+function normalizePreserveRecent(value) {
+    return typeof value === "number" && Number.isFinite(value) ? Math.max(0, Math.floor(value)) : CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT;
+}
+export function normalizeContextCompactionQuery(value, fallbackQuery) {
+    const query = value?.trim() || fallbackQuery.trim() || CONTEXT_COMPACTION_AUTO_QUERY;
+    return query.length > CONTEXT_COMPACTION_QUERY_MAX_CHARS
+        ? `${query.slice(0, CONTEXT_COMPACTION_QUERY_MAX_CHARS)}\n[... ${query.length - CONTEXT_COMPACTION_QUERY_MAX_CHARS} more characters omitted from compaction query]`
+        : query;
+}
+export function normalizeContextCompactionParameters(input = {}, fallbackQuery = CONTEXT_COMPACTION_AUTO_QUERY) {
+    return {
+        compression_ratio: normalizeCompressionRatio(input.compression_ratio),
+        preserve_recent: normalizePreserveRecent(input.preserve_recent),
+        query: normalizeContextCompactionQuery(input.query, fallbackQuery),
+    };
+}
+export function getTranscriptCompactionParameters(transcript) {
+    return normalizeContextCompactionParameters(transcript.parameters ?? transcript.settings, transcript.parameters?.query ?? transcript.settings.query ?? CONTEXT_COMPACTION_AUTO_QUERY);
+}
+//# sourceMappingURL=context-compaction-strategy.js.map

package/dist/core/compaction/context-compaction-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compaction-strategy.js","sourceRoot":"","sources":["../../../src/core/compaction/context-compaction-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,6BAA6B,EAC7B,4CAA4C,EAC5C,0CAA0C,GAG1C,MAAM,+BAA+B,CAAC;AAEvC,MAAM,kCAAkC,GAAG,IAAI,CAAC;AAEhD,SAAS,yBAAyB,CAAC,KAAyB;IAC3D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC;QACnF,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,4CAA4C,CAAC;AACjD,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAyB;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,0CAA0C,CAAC;AAC1I,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAyB,EAAE,aAAqB;IAC/F,MAAM,KAAK,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,6BAA6B,CAAC;IACrF,OAAO,KAAK,CAAC,MAAM,GAAG,kCAAkC;QACvD,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,kCAAkC,CAAC,UAAU,KAAK,CAAC,MAAM,GAAG,kCAAkC,iDAAiD;QACnK,CAAC,CAAC,KAAK,CAAC;AACV,CAAC;AAED,MAAM,UAAU,oCAAoC,CACnD,KAAK,GAAyC,EAAE,EAChD,aAAa,GAAW,6BAA6B;IAErD,OAAO;QACN,iBAAiB,EAAE,yBAAyB,CAAC,KAAK,CAAC,iBAAiB,CAAC;QACrE,eAAe,EAAE,uBAAuB,CAAC,KAAK,CAAC,eAAe,CAAC;QAC/D,KAAK,EAAE,+BAA+B,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC;KAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,UAAiC;IAClF,OAAO,oCAAoC,CAC1C,UAAU,CAAC,UAAU,IAAI,UAAU,CAAC,QAAQ,EAC5C,UAAU,CAAC,UAAU,EAAE,KAAK,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,6BAA6B,CAC1F,CAAC;AACH,CAAC","sourcesContent":["import {\n\tCONTEXT_COMPACTION_AUTO_QUERY,\n\tCONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO,\n\tCONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT,\n\ttype CompactableTranscript,\n\ttype ContextCompactionParameters,\n} from \"./context-compaction-types.ts\";\n\nconst CONTEXT_COMPACTION_QUERY_MAX_CHARS = 1000;\n\nfunction normalizeCompressionRatio(value: number | undefined): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) && value > 0 && value < 1\n\t\t? value\n\t\t: CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO;\n}\n\nfunction normalizePreserveRecent(value: number | undefined): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) ? Math.max(0, Math.floor(value)) : CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT;\n}\n\nexport function normalizeContextCompactionQuery(value: string | undefined, fallbackQuery: string): string {\n\tconst query = value?.trim() || fallbackQuery.trim() || CONTEXT_COMPACTION_AUTO_QUERY;\n\treturn query.length > CONTEXT_COMPACTION_QUERY_MAX_CHARS\n\t\t? `${query.slice(0, CONTEXT_COMPACTION_QUERY_MAX_CHARS)}\\n[... ${query.length - CONTEXT_COMPACTION_QUERY_MAX_CHARS} more characters omitted from compaction query]`\n\t\t: query;\n}\n\nexport function normalizeContextCompactionParameters(\n\tinput: Partial<ContextCompactionParameters> = {},\n\tfallbackQuery: string = CONTEXT_COMPACTION_AUTO_QUERY,\n): ContextCompactionParameters {\n\treturn {\n\t\tcompression_ratio: normalizeCompressionRatio(input.compression_ratio),\n\t\tpreserve_recent: normalizePreserveRecent(input.preserve_recent),\n\t\tquery: normalizeContextCompactionQuery(input.query, fallbackQuery),\n\t};\n}\n\nexport function getTranscriptCompactionParameters(transcript: CompactableTranscript): ContextCompactionParameters {\n\treturn normalizeContextCompactionParameters(\n\t\ttranscript.parameters ?? transcript.settings,\n\t\ttranscript.parameters?.query ?? transcript.settings.query ?? CONTEXT_COMPACTION_AUTO_QUERY,\n\t);\n}\n"]}

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

@@ -0,0 +1,73 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { ContextCompactionStats, ContextDeletionTarget, SessionEntry } from "../session-manager.ts";
+import type { CompactionSettings } from "./compaction.ts";
+export declare const CONTEXT_COMPACTION_PROMPT_VERSION: 1;
+export interface ContextCompactionParameters {
+    /** Fraction of compactable context to keep. 0.3 is aggressive, 0.7 is light. */
+    compression_ratio: number;
+    /** Number of recent context-eligible messages to preserve. */
+    preserve_recent: number;
+    /** Focus query for relevance-based pruning. */
+    query: string;
+}
+export interface ContextDeletionRequest {
+    deletions: Array<{
+        kind: "entry" | "content_block";
+        entryId: string;
+        blockIndex?: number;
+    }>;
+}
+export interface CompactableContentBlock {
+    entryId: string;
+    blockIndex: number;
+    type: string;
+    text: string;
+    tokenEstimate: number;
+    protected: boolean;
+    toolCallId?: string;
+}
+export interface CompactableTranscriptEntry {
+    entryId: string;
+    entryType: SessionEntry["type"];
+    role: AgentMessage["role"];
+    text: string;
+    tokenEstimate: number;
+    protected: boolean;
+    contentBlocks: CompactableContentBlock[];
+    message: AgentMessage;
+    toolCallIds: string[];
+    toolResultFor?: string;
+}
+export interface CompactableTranscript {
+    entries: CompactableTranscriptEntry[];
+    protectedEntryIds: string[];
+    tokensBefore: number;
+    settings: CompactionSettings;
+    parameters?: ContextCompactionParameters;
+}
+export interface ContextCompactionPreparation {
+    transcript: CompactableTranscript;
+    branchEntries: SessionEntry[];
+    parameters: ContextCompactionParameters;
+}
+export interface ValidatedContextDeletionResult {
+    deletedTargets: ContextDeletionTarget[];
+    protectedEntryIds: string[];
+    stats: ContextCompactionStats;
+}
+export interface ContextCompactionResult extends ValidatedContextDeletionResult {
+    promptVersion: typeof CONTEXT_COMPACTION_PROMPT_VERSION;
+    parameters: ContextCompactionParameters;
+    backupPath?: string;
+}
+export interface ContextCompactionRunOptions {
+    contextWindow?: number;
+    compression_ratio?: number;
+    preserve_recent?: number;
+    query?: string;
+}
+export declare const CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO: 0.5;
+export declare const CONTEXT_COMPACTION_TARGET_REDUCTION_PERCENT: 50;
+export declare const CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT: 2;
+export declare const CONTEXT_COMPACTION_AUTO_QUERY: "auto-detected";
+//# sourceMappingURL=context-compaction-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-compaction-types.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/context-compaction-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACzG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,eAAO,MAAM,iCAAiC,EAAG,CAAU,CAAC;AAE5D,MAAM,WAAW,2BAA2B;IAC3C,gFAAgF;IAChF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACtC,SAAS,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,OAAO,GAAG,eAAe,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,uBAAuB,EAAE,CAAC;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,0BAA0B,EAAE,CAAC;IACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,UAAU,CAAC,EAAE,2BAA2B,CAAC;CACzC;AAED,MAAM,WAAW,4BAA4B;IAC5C,UAAU,EAAE,qBAAqB,CAAC;IAClC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,UAAU,EAAE,2BAA2B,CAAC;CACxC;AAED,MAAM,WAAW,8BAA8B;IAC9C,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE,sBAAsB,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAwB,SAAQ,8BAA8B;IAC9E,aAAa,EAAE,OAAO,iCAAiC,CAAC;IACxD,UAAU,EAAE,2BAA2B,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,4CAA4C,EAAG,GAAY,CAAC;AACzE,eAAO,MAAM,2CAA2C,EAAG,EAAW,CAAC;AACvE,eAAO,MAAM,0CAA0C,EAAG,CAAU,CAAC;AACrE,eAAO,MAAM,6BAA6B,EAAG,eAAwB,CAAC","sourcesContent":["import type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport type { ContextCompactionStats, ContextDeletionTarget, SessionEntry } from \"../session-manager.ts\";\nimport type { CompactionSettings } from \"./compaction.ts\";\n\nexport const CONTEXT_COMPACTION_PROMPT_VERSION = 1 as const;\n\nexport interface ContextCompactionParameters {\n\t/** Fraction of compactable context to keep. 0.3 is aggressive, 0.7 is light. */\n\tcompression_ratio: number;\n\t/** Number of recent context-eligible messages to preserve. */\n\tpreserve_recent: number;\n\t/** Focus query for relevance-based pruning. */\n\tquery: string;\n}\n\nexport interface ContextDeletionRequest {\n\tdeletions: Array<{\n\t\tkind: \"entry\" | \"content_block\";\n\t\tentryId: string;\n\t\tblockIndex?: number;\n\t}>;\n}\n\nexport interface CompactableContentBlock {\n\tentryId: string;\n\tblockIndex: number;\n\ttype: string;\n\ttext: string;\n\ttokenEstimate: number;\n\tprotected: boolean;\n\ttoolCallId?: string;\n}\n\nexport interface CompactableTranscriptEntry {\n\tentryId: string;\n\tentryType: SessionEntry[\"type\"];\n\trole: AgentMessage[\"role\"];\n\ttext: string;\n\ttokenEstimate: number;\n\tprotected: boolean;\n\tcontentBlocks: CompactableContentBlock[];\n\tmessage: AgentMessage;\n\ttoolCallIds: string[];\n\ttoolResultFor?: string;\n}\n\nexport interface CompactableTranscript {\n\tentries: CompactableTranscriptEntry[];\n\tprotectedEntryIds: string[];\n\ttokensBefore: number;\n\tsettings: CompactionSettings;\n\tparameters?: ContextCompactionParameters;\n}\n\nexport interface ContextCompactionPreparation {\n\ttranscript: CompactableTranscript;\n\tbranchEntries: SessionEntry[];\n\tparameters: ContextCompactionParameters;\n}\n\nexport interface ValidatedContextDeletionResult {\n\tdeletedTargets: ContextDeletionTarget[];\n\tprotectedEntryIds: string[];\n\tstats: ContextCompactionStats;\n}\n\nexport interface ContextCompactionResult extends ValidatedContextDeletionResult {\n\tpromptVersion: typeof CONTEXT_COMPACTION_PROMPT_VERSION;\n\tparameters: ContextCompactionParameters;\n\tbackupPath?: string;\n}\n\nexport interface ContextCompactionRunOptions {\n\tcontextWindow?: number;\n\tcompression_ratio?: number;\n\tpreserve_recent?: number;\n\tquery?: string;\n}\n\nexport const CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO = 0.5 as const;\nexport const CONTEXT_COMPACTION_TARGET_REDUCTION_PERCENT = 50 as const;\nexport const CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT = 2 as const;\nexport const CONTEXT_COMPACTION_AUTO_QUERY = \"auto-detected\" as const;\n"]}

package/dist/core/compaction/context-compaction-types.js

@@ -0,0 +1,6 @@
+export const CONTEXT_COMPACTION_PROMPT_VERSION = 1;
+export const CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO = 0.5;
+export const CONTEXT_COMPACTION_TARGET_REDUCTION_PERCENT = 50;
+export const CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT = 2;
+export const CONTEXT_COMPACTION_AUTO_QUERY = "auto-detected";
+//# sourceMappingURL=context-compaction-types.js.map

package/dist/core/compaction/context-compaction-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compaction-types.js","sourceRoot":"","sources":["../../../src/core/compaction/context-compaction-types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAU,CAAC;AA2E5D,MAAM,CAAC,MAAM,4CAA4C,GAAG,GAAY,CAAC;AACzE,MAAM,CAAC,MAAM,2CAA2C,GAAG,EAAW,CAAC;AACvE,MAAM,CAAC,MAAM,0CAA0C,GAAG,CAAU,CAAC;AACrE,MAAM,CAAC,MAAM,6BAA6B,GAAG,eAAwB,CAAC","sourcesContent":["import type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport type { ContextCompactionStats, ContextDeletionTarget, SessionEntry } from \"../session-manager.ts\";\nimport type { CompactionSettings } from \"./compaction.ts\";\n\nexport const CONTEXT_COMPACTION_PROMPT_VERSION = 1 as const;\n\nexport interface ContextCompactionParameters {\n\t/** Fraction of compactable context to keep. 0.3 is aggressive, 0.7 is light. */\n\tcompression_ratio: number;\n\t/** Number of recent context-eligible messages to preserve. */\n\tpreserve_recent: number;\n\t/** Focus query for relevance-based pruning. */\n\tquery: string;\n}\n\nexport interface ContextDeletionRequest {\n\tdeletions: Array<{\n\t\tkind: \"entry\" | \"content_block\";\n\t\tentryId: string;\n\t\tblockIndex?: number;\n\t}>;\n}\n\nexport interface CompactableContentBlock {\n\tentryId: string;\n\tblockIndex: number;\n\ttype: string;\n\ttext: string;\n\ttokenEstimate: number;\n\tprotected: boolean;\n\ttoolCallId?: string;\n}\n\nexport interface CompactableTranscriptEntry {\n\tentryId: string;\n\tentryType: SessionEntry[\"type\"];\n\trole: AgentMessage[\"role\"];\n\ttext: string;\n\ttokenEstimate: number;\n\tprotected: boolean;\n\tcontentBlocks: CompactableContentBlock[];\n\tmessage: AgentMessage;\n\ttoolCallIds: string[];\n\ttoolResultFor?: string;\n}\n\nexport interface CompactableTranscript {\n\tentries: CompactableTranscriptEntry[];\n\tprotectedEntryIds: string[];\n\ttokensBefore: number;\n\tsettings: CompactionSettings;\n\tparameters?: ContextCompactionParameters;\n}\n\nexport interface ContextCompactionPreparation {\n\ttranscript: CompactableTranscript;\n\tbranchEntries: SessionEntry[];\n\tparameters: ContextCompactionParameters;\n}\n\nexport interface ValidatedContextDeletionResult {\n\tdeletedTargets: ContextDeletionTarget[];\n\tprotectedEntryIds: string[];\n\tstats: ContextCompactionStats;\n}\n\nexport interface ContextCompactionResult extends ValidatedContextDeletionResult {\n\tpromptVersion: typeof CONTEXT_COMPACTION_PROMPT_VERSION;\n\tparameters: ContextCompactionParameters;\n\tbackupPath?: string;\n}\n\nexport interface ContextCompactionRunOptions {\n\tcontextWindow?: number;\n\tcompression_ratio?: number;\n\tpreserve_recent?: number;\n\tquery?: string;\n}\n\nexport const CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO = 0.5 as const;\nexport const CONTEXT_COMPACTION_TARGET_REDUCTION_PERCENT = 50 as const;\nexport const CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT = 2 as const;\nexport const CONTEXT_COMPACTION_AUTO_QUERY = \"auto-detected\" as const;\n"]}

package/dist/core/compaction/context-compaction.d.ts

@@ -1,201 +1,10 @@
-import { type AgentMessage, type AgentTool, type ThinkingLevel } from "@earendil-works/pi-agent-core";
-import type { Api, Model } from "@earendil-works/pi-ai";
-import { Type } from "typebox";
-import { type ContextCompactionStats, type ContextDeletionTarget, type SessionEntry } from "../session-manager.ts";
-import type { CompactionSettings } from "./compaction.ts";
-export declare const CONTEXT_COMPACTION_PROMPT_VERSION: 1;
-export interface ContextCompactionParameters {
-    /** Fraction of compactable context to keep. 0.3 is aggressive, 0.7 is light. */
-    compression_ratio: number;
-    /** Number of recent context-eligible messages to preserve. */
-    preserve_recent: number;
-    /** Focus query for relevance-based pruning. */
-    query: string;
-}
-export interface ContextDeletionRequest {
-    deletions: Array<{
-        kind: "entry" | "content_block";
-        entryId: string;
-        blockIndex?: number;
-    }>;
-}
-export interface CompactableContentBlock {
-    entryId: string;
-    blockIndex: number;
-    type: string;
-    text: string;
-    tokenEstimate: number;
-    protected: boolean;
-    toolCallId?: string;
-}
-export interface CompactableTranscriptEntry {
-    entryId: string;
-    entryType: SessionEntry["type"];
-    role: AgentMessage["role"];
-    text: string;
-    tokenEstimate: number;
-    protected: boolean;
-    contentBlocks: CompactableContentBlock[];
-    message: AgentMessage;
-    toolCallIds: string[];
-    toolResultFor?: string;
-}
-export interface CompactableTranscript {
-    entries: CompactableTranscriptEntry[];
-    protectedEntryIds: string[];
-    tokensBefore: number;
-    settings: CompactionSettings;
-    parameters?: ContextCompactionParameters;
-}
-export interface ContextCompactionPreparation {
-    transcript: CompactableTranscript;
-    branchEntries: SessionEntry[];
-    parameters: ContextCompactionParameters;
-}
-export interface ValidatedContextDeletionResult {
-    deletedTargets: ContextDeletionTarget[];
-    protectedEntryIds: string[];
-    stats: ContextCompactionStats;
-}
-export interface ContextCompactionResult extends ValidatedContextDeletionResult {
-    promptVersion: typeof CONTEXT_COMPACTION_PROMPT_VERSION;
-    parameters: ContextCompactionParameters;
-    backupPath?: string;
-}
-export declare const CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO: 0.5;
-export declare const CONTEXT_COMPACTION_TARGET_REDUCTION_PERCENT: 50;
-export declare const CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT: 2;
-export declare const CONTEXT_COMPACTION_AUTO_QUERY: "auto-detected";
-declare const ContextDeleteToolParameters: Type.TObject<{
-    deletions: Type.TArray<Type.TObject<{
-        kind: Type.TUnsafe<"content_block" | "entry">;
-        entryId: Type.TString;
-        blockIndex: Type.TOptional<Type.TInteger>;
-    }>>;
-}>;
-declare const ContextGrepDeleteToolParameters: Type.TObject<{
-    pattern: Type.TString;
-    regex: Type.TOptional<Type.TBoolean>;
-    caseSensitive: Type.TOptional<Type.TBoolean>;
-    target: Type.TOptional<Type.TUnsafe<"content_block" | "entry">>;
-    maxMatches: Type.TOptional<Type.TInteger>;
-    expectedMatchCount: Type.TOptional<Type.TInteger>;
-}>;
-declare const ContextSearchTranscriptToolParameters: Type.TObject<{
-    pattern: Type.TString;
-    regex: Type.TOptional<Type.TBoolean>;
-    caseSensitive: Type.TOptional<Type.TBoolean>;
-    target: Type.TOptional<Type.TUnsafe<"content_block" | "entry">>;
-    maxMatches: Type.TOptional<Type.TInteger>;
-    contextChars: Type.TOptional<Type.TInteger>;
-}>;
-declare const ContextReadEntryToolParameters: Type.TObject<{
-    entryId: Type.TString;
-    blockIndex: Type.TOptional<Type.TInteger>;
-    offset: Type.TOptional<Type.TInteger>;
-    maxChars: Type.TOptional<Type.TInteger>;
-}>;
-declare const ContextCompactionBudgetToolParameters: Type.TObject<{}>;
-export interface ContextDeletionToolDetails {
-    deletions: ContextDeletionRequest["deletions"];
-    deletedTargets: ContextDeletionTarget[];
-    stats: ContextCompactionStats;
-    callCount: number;
-    error?: string;
-}
-export interface ContextGrepDeletionMatch {
-    entryId: string;
-    target: "entry" | "content_block";
-    blockIndex?: number;
-    text: string;
-}
-export interface ContextGrepDeletionSkipped {
-    entryId?: string;
-    target?: "entry" | "content_block";
-    blockIndex?: number;
-    reason: "protected_entry" | "protected_block" | "assistant_thinking_entry" | "assistant_thinking_block" | "already_deleted" | "max_matches_exceeded" | "expected_match_count_mismatch";
-    text?: string;
-}
-export interface ContextGrepDeletionToolDetails {
-    pattern: string;
-    regex: boolean;
-    caseSensitive: boolean;
-    target: "entry" | "content_block";
-    matches: ContextGrepDeletionMatch[];
-    skipped: ContextGrepDeletionSkipped[];
-    deletedTargets: ContextDeletionTarget[];
-    stats: ContextCompactionStats;
-    callCount: number;
-    error?: string;
-}
-export interface ContextTranscriptSearchMatch {
-    entryId: string;
-    target: "entry" | "content_block";
-    blockIndex?: number;
-    matchIndex: number;
-    snippet: string;
-    protected: boolean;
-}
-export interface ContextTranscriptSearchToolDetails {
-    pattern: string;
-    regex: boolean;
-    caseSensitive: boolean;
-    target: "entry" | "content_block";
-    matches: ContextTranscriptSearchMatch[];
-    truncated: boolean;
-    callCount: number;
-    error?: string;
-}
-export interface ContextReadEntryToolDetails {
-    entryId: string;
-    blockIndex?: number;
-    offset: number;
-    maxChars: number;
-    totalChars: number;
-    text: string;
-    truncatedBefore: boolean;
-    truncatedAfter: boolean;
-    callCount: number;
-    error?: string;
-}
-export interface ContextCompactionBudgetToolDetails {
-    contextWindow?: number;
-    compression_ratio: number;
-    tokensBefore: number;
-    currentTokensAfter: number;
-    deletedTokens: number;
-    currentReductionPercent: number;
-    targetReductionPercent: number;
-    targetTokensAfter: number;
-    tokensToDeleteForTarget: number;
-    contextWindowBeforePercent?: number;
-    contextWindowAfterPercent?: number;
-    callCount: number;
-}
-export interface ContextDeletionToolController {
-    tool: AgentTool<typeof ContextDeleteToolParameters, ContextDeletionToolDetails>;
-    grepTool: AgentTool<typeof ContextGrepDeleteToolParameters, ContextGrepDeletionToolDetails>;
-    searchTool: AgentTool<typeof ContextSearchTranscriptToolParameters, ContextTranscriptSearchToolDetails>;
-    readEntryTool: AgentTool<typeof ContextReadEntryToolParameters, ContextReadEntryToolDetails>;
-    budgetTool: AgentTool<typeof ContextCompactionBudgetToolParameters, ContextCompactionBudgetToolDetails>;
-    tools: AgentTool[];
-    getDeletionRequest(): ContextDeletionRequest;
-    getValidatedResult(): ValidatedContextDeletionResult | undefined;
-    getLastError(): string | undefined;
-    getCallCount(): number;
-}
-export interface ContextCompactionRunOptions {
-    contextWindow?: number;
-    compression_ratio?: number;
-    preserve_recent?: number;
-    query?: string;
-}
-export declare function autoDetectContextCompactionQuery(pathEntries: readonly SessionEntry[]): string;
-export declare function normalizeContextCompactionParameters(input?: Partial<ContextCompactionParameters>, fallbackQuery?: string): ContextCompactionParameters;
-export declare function prepareContextCompaction(pathEntries: SessionEntry[], settings: CompactionSettings, options?: ContextCompactionRunOptions): ContextCompactionPreparation | undefined;
-export declare function validateContextDeletionRequest(request: ContextDeletionRequest, transcript: CompactableTranscript): ValidatedContextDeletionResult;
-export declare function createContextDeletionTool(inputTranscript: CompactableTranscript, options?: ContextCompactionRunOptions): ContextDeletionToolController;
-export declare function buildContextCompactionPrompt(transcript: CompactableTranscript, transcriptFilePath?: string, parameters?: ContextCompactionParameters): string;
-export declare function contextCompact(preparation: ContextCompactionPreparation, model: Model<Api>, apiKey: string, headers?: Record<string, string>, signal?: AbortSignal, thinkingLevel?: ThinkingLevel): Promise<ValidatedContextDeletionResult>;
-export {};
+export { CONTEXT_COMPACTION_AUTO_QUERY, CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO, CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT, CONTEXT_COMPACTION_PROMPT_VERSION, CONTEXT_COMPACTION_TARGET_REDUCTION_PERCENT, } from "./context-compaction-types.ts";
+export type { CompactableContentBlock, CompactableTranscript, CompactableTranscriptEntry, ContextCompactionParameters, ContextCompactionPreparation, ContextCompactionResult, ContextCompactionRunOptions, ContextDeletionRequest, ValidatedContextDeletionResult, } from "./context-compaction-types.ts";
+export type { ContextCompactionBudgetToolDetails, ContextDeletionToolController, ContextDeletionToolDetails, ContextGrepDeletionMatch, ContextGrepDeletionSkipped, ContextGrepDeletionToolDetails, ContextReadEntryToolDetails, ContextTranscriptSearchMatch, ContextTranscriptSearchToolDetails, } from "./context-deletion-tool-definitions.ts";
+export { normalizeContextCompactionParameters } from "./context-compaction-strategy.ts";
+export { autoDetectContextCompactionQuery, prepareContextCompaction, } from "./context-transcript-analysis.ts";
+export { validateContextDeletionRequest } from "./context-deletion-application.ts";
+export { createContextDeletionTool } from "./context-deletion-tools.ts";
+export { buildContextCompactionPrompt } from "./context-compaction-prompt.ts";
+export { contextCompact } from "./context-compaction-runner.ts";
 //# sourceMappingURL=context-compaction.d.ts.map