7f0f8dd268
* ContextEngine: add runtime compaction delegate helper * plugin-sdk: expose compaction delegate through compat * docs: clarify delegated plugin compaction * docs: use scoped compaction delegate import
62 lines
2.6 KiB
TypeScript
62 lines
2.6 KiB
TypeScript
import type { ContextEngine, CompactResult, ContextEngineRuntimeContext } from "./types.js";
|
|
|
|
/**
|
|
* Delegate a context-engine compaction request to OpenClaw's built-in runtime compaction path.
|
|
*
|
|
* This is the same bridge used by the legacy context engine. Third-party
|
|
* engines can call it from their own `compact()` implementations when they do
|
|
* not own the compaction algorithm but still need `/compact` and overflow
|
|
* recovery to use the stock runtime behavior.
|
|
*
|
|
* Note: `compactionTarget` is part of the public `compact()` contract, but the
|
|
* built-in runtime compaction path does not expose that knob. This helper
|
|
* ignores it to preserve legacy behavior; engines that need target-specific
|
|
* compaction should implement their own `compact()` algorithm.
|
|
*/
|
|
export async function delegateCompactionToRuntime(
|
|
params: Parameters<ContextEngine["compact"]>[0],
|
|
): Promise<CompactResult> {
|
|
// Import through a dedicated runtime boundary so the lazy edge remains effective.
|
|
const { compactEmbeddedPiSessionDirect } =
|
|
await import("../agents/pi-embedded-runner/compact.runtime.js");
|
|
|
|
// runtimeContext carries the full CompactEmbeddedPiSessionParams fields set
|
|
// by runtime callers. We spread them and override the fields that come from
|
|
// the public ContextEngine compact() signature directly.
|
|
const runtimeContext: ContextEngineRuntimeContext = params.runtimeContext ?? {};
|
|
const currentTokenCount =
|
|
params.currentTokenCount ??
|
|
(typeof runtimeContext.currentTokenCount === "number" &&
|
|
Number.isFinite(runtimeContext.currentTokenCount) &&
|
|
runtimeContext.currentTokenCount > 0
|
|
? Math.floor(runtimeContext.currentTokenCount)
|
|
: undefined);
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any -- bridge runtimeContext matches CompactEmbeddedPiSessionParams
|
|
const result = await compactEmbeddedPiSessionDirect({
|
|
...runtimeContext,
|
|
sessionId: params.sessionId,
|
|
sessionFile: params.sessionFile,
|
|
tokenBudget: params.tokenBudget,
|
|
...(currentTokenCount !== undefined ? { currentTokenCount } : {}),
|
|
force: params.force,
|
|
customInstructions: params.customInstructions,
|
|
workspaceDir: (runtimeContext.workspaceDir as string) ?? process.cwd(),
|
|
} as Parameters<typeof compactEmbeddedPiSessionDirect>[0]);
|
|
|
|
return {
|
|
ok: result.ok,
|
|
compacted: result.compacted,
|
|
reason: result.reason,
|
|
result: result.result
|
|
? {
|
|
summary: result.result.summary,
|
|
firstKeptEntryId: result.result.firstKeptEntryId,
|
|
tokensBefore: result.result.tokensBefore,
|
|
tokensAfter: result.result.tokensAfter,
|
|
details: result.result.details,
|
|
}
|
|
: undefined,
|
|
};
|
|
}
|