@graphorin/memory 0.5.0

package/dist/context-engine/compaction/compactor.js

@@ -0,0 +1,196 @@
+import { HEURISTIC_TOKEN_COUNTER, countMessageTokens, renderMessageText } from "../token-counter.js";
+import { clearOldToolResults } from "./clear-tool-results.js";
+import { SUMMARY_TEMPLATE_NAME, SUMMARY_TEMPLATE_VERSION, buildSummarizerPrompt, renderFinalSummary } from "./templates/summary-9-section.js";
+import { scanImperativePatterns } from "@graphorin/observability/redaction";
+
+//#region src/context-engine/compaction/compactor.ts
+/**
+* Default count of recent turns preserved verbatim by the
+* `summarize-old-preserve-recent` strategy.
+*
+* @stable
+*/
+const DEFAULT_PRESERVE_RECENT_TURNS = 6;
+/** Opening marker of the inbound-untrusted envelope (tools sanitize layer). */
+const UNTRUSTED_MARKER = "<<<untrusted_content";
+/**
+* Wall-clock budget for the CE-15 injection scan of the summarizer
+* output. The scanner's 5ms default exists for the per-tool-result
+* hot path; here a compaction already paid for an LLM call, and on a
+* contended host (slow CI runners included) scheduler noise can cross
+* 5ms between pattern iterations — making the scanner return `null`
+* (verdict unknown) and the security check silently fail open.
+*/
+const COMPACTION_SCAN_BUDGET_MS = 50;
+/** CE-15: does the compacted window carry inbound-untrusted envelopes? */
+function windowContainsUntrusted(messages) {
+	return messages.some((message) => renderMessageText(message).includes(UNTRUSTED_MARKER));
+}
+/**
+* CE-15: wrap the LLM-authored summary body in a derived-trust
+* envelope. Envelope marker sequences inside the body are neutralized
+* first so summarizer output influenced by injected text cannot break
+* out of the envelope and masquerade as authoritative system text.
+*/
+function wrapSummaryAsDerived(body) {
+	return `<<<untrusted_content trust="derived" tool="compaction-summarizer">>>\n${body.replaceAll("<<</untrusted_content>>>", "[[/untrusted_content]]").replaceAll(UNTRUSTED_MARKER, "[[untrusted_content")}\n<<</untrusted_content>>>`;
+}
+/**
+* Perform a compaction call. Returns the result envelope containing
+* the produced summary, the dropped/preserved message slices, and
+* the per-event metadata. Phase 12 / `agent.compact()` is the
+* lifecycle owner; this function is the trim primitive.
+*
+* @stable
+*/
+async function executeCompaction(input) {
+	const counter = input.tokenCounter ?? HEURISTIC_TOKEN_COUNTER;
+	const now = input.now ?? Date.now;
+	const startTs = now();
+	const beforeTokens = await countMessageTokens(input.messages, counter);
+	if (input.strategy.kind === "custom") {
+		const ctx = {
+			runId: input.runId,
+			sessionId: input.sessionId,
+			agentId: input.agentId,
+			scope: input.scope,
+			source: input.source,
+			messages: input.messages,
+			beforeTokens,
+			thresholdTokens: input.thresholdTokens,
+			preserveRecentTurns: DEFAULT_PRESERVE_RECENT_TURNS,
+			providerTrust: input.providerTrust ?? "public-tls"
+		};
+		return await input.strategy.compact(ctx);
+	}
+	if (input.strategy.kind === "clear-old-tool-results") return executeClearStrategy(input, input.strategy, counter, now, startTs, beforeTokens);
+	const preserveRecentTurns = input.strategy.preserveRecentTurns ?? DEFAULT_PRESERVE_RECENT_TURNS;
+	const summarizerModelInput = input.strategy.summarizerModel;
+	const summarizerTimeoutMs = input.strategy.summarizerTimeoutMs;
+	const olderCount = Math.max(0, input.messages.length - preserveRecentTurns);
+	const olderMessages = input.messages.slice(0, olderCount);
+	const preservedMessages = input.messages.slice(olderCount);
+	if (olderMessages.length === 0) return Object.freeze({
+		summary: "",
+		summaryTokens: 0,
+		beforeTokens,
+		afterTokens: beforeTokens,
+		droppedMessageIds: Object.freeze([]),
+		droppedMessageIndices: Object.freeze([]),
+		preservedMessages: Object.freeze([...preservedMessages]),
+		trimmedMessages: Object.freeze([...preservedMessages]),
+		source: input.source,
+		durationMs: now() - startTs,
+		hooksFiredCount: 0,
+		summaryTrust: "trusted"
+	});
+	const template = {
+		preamble: input.localePack.compactionSummaryTemplate.preamble,
+		sections: input.localePack.compactionSummaryTemplate.sections
+	};
+	const summarizerInput = { prompt: buildSummarizerPrompt({
+		template,
+		olderMessages
+	}) };
+	if (summarizerModelInput !== void 0) summarizerInput.model = summarizerModelInput;
+	if (input.signal !== void 0) summarizerInput.signal = input.signal;
+	if (summarizerTimeoutMs !== void 0) summarizerInput.timeoutMs = summarizerTimeoutMs;
+	const summarized = await input.summarizer.summarize(summarizerInput);
+	const metadata = {
+		compactedAtIso: new Date(startTs).toISOString(),
+		compactedFromMessageIds: Object.freeze(olderMessages.map((_, idx) => `c${startTs}_msg_${idx}`)),
+		compactedFromMessageIndices: Object.freeze(olderMessages.map((_, idx) => idx)),
+		compactedFromTokens: await countMessageTokens(olderMessages, counter),
+		summaryTokens: summarized.usageTokens ?? await counter.countText(summarized.text),
+		summarizerModel: resolveSummarizerModelLabel(summarizerModelInput, input.summarizer.id),
+		templateName: SUMMARY_TEMPLATE_NAME,
+		templateVersion: SUMMARY_TEMPLATE_VERSION,
+		preserveRecentTurns
+	};
+	const summaryScan = scanImperativePatterns(summarized.text, void 0, COMPACTION_SCAN_BUDGET_MS);
+	const summaryTrust = windowContainsUntrusted(olderMessages) || summaryScan !== null && summaryScan.hits.length > 0 ? "untrusted-derived" : "trusted";
+	const finalSummary = renderFinalSummary({
+		template,
+		summaryFromLlm: summaryTrust === "untrusted-derived" ? wrapSummaryAsDerived(summarized.text) : summarized.text,
+		preservedMessages,
+		metadata
+	});
+	const summaryTokens = await counter.countText(finalSummary);
+	const summaryMessage = {
+		role: "system",
+		content: finalSummary
+	};
+	const trimmedMessages = Object.freeze([summaryMessage, ...preservedMessages]);
+	const afterTokens = await countMessageTokens(trimmedMessages, counter);
+	const durationMs = now() - startTs;
+	return Object.freeze({
+		summary: finalSummary,
+		summaryTokens,
+		beforeTokens,
+		afterTokens,
+		droppedMessageIds: metadata.compactedFromMessageIds,
+		droppedMessageIndices: metadata.compactedFromMessageIndices,
+		preservedMessages: Object.freeze([...preservedMessages]),
+		trimmedMessages,
+		source: input.source,
+		durationMs,
+		hooksFiredCount: 0,
+		summaryTrust
+	});
+}
+/**
+* SOTA-1: clear the oldest tool results (zero-LLM), then summarize only if the
+* cleared buffer is still over the threshold. The summarizer runs on the
+* already-reduced window, so a few-tool-result buffer compacts for free.
+*/
+async function executeClearStrategy(input, strategy, counter, now, startTs, beforeTokens) {
+	const outcome = await clearOldToolResults(input.messages, {
+		...strategy.keepToolUses !== void 0 ? { keepToolUses: strategy.keepToolUses } : {},
+		...strategy.clearAtLeast !== void 0 ? { clearAtLeast: strategy.clearAtLeast } : {},
+		...strategy.excludeTools !== void 0 ? { excludeTools: strategy.excludeTools } : {},
+		...strategy.externalize !== void 0 ? { externalize: strategy.externalize } : {}
+	}, counter);
+	const afterClearTokens = await countMessageTokens(outcome.messages, counter);
+	const fallback = strategy.summarizeFallback;
+	if (fallback !== false && afterClearTokens > input.thresholdTokens) {
+		const summarized = await executeCompaction({
+			...input,
+			messages: outcome.messages,
+			strategy: {
+				kind: "summarize-old-preserve-recent",
+				...fallback ?? {}
+			}
+		});
+		return Object.freeze({
+			...summarized,
+			beforeTokens,
+			droppedMessageIndices: Object.freeze([...outcome.clearedIndices, ...summarized.droppedMessageIndices.filter((i) => !outcome.clearedIndices.includes(i))]),
+			durationMs: now() - startTs
+		});
+	}
+	const clearedSet = new Set(outcome.clearedIndices);
+	const preservedMessages = outcome.messages.filter((_, i) => !clearedSet.has(i));
+	return Object.freeze({
+		summary: "",
+		summaryTokens: 0,
+		beforeTokens,
+		afterTokens: afterClearTokens,
+		droppedMessageIds: Object.freeze(outcome.clearedIndices.map((i) => `c${startTs}_cleared_${i}`)),
+		droppedMessageIndices: Object.freeze([...outcome.clearedIndices]),
+		preservedMessages: Object.freeze(preservedMessages),
+		trimmedMessages: Object.freeze([...outcome.messages]),
+		source: input.source,
+		durationMs: now() - startTs,
+		hooksFiredCount: 0,
+		summaryTrust: "trusted"
+	});
+}
+function resolveSummarizerModelLabel(modelInput, summarizerId) {
+	if (typeof modelInput === "string") return modelInput;
+	if (modelInput !== void 0) return "provider" in modelInput ? `${modelInput.provider.name}:${modelInput.model}` : `${modelInput.name}:${modelInput.modelId}`;
+	return summarizerId ?? null;
+}
+
+//#endregion
+export { DEFAULT_PRESERVE_RECENT_TURNS, executeCompaction };
+//# sourceMappingURL=compactor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.js","names":["ctx: CompactionContext","summarizerInput: {\n    prompt: string;\n    model?: ModelSpec | string;\n    signal?: AbortSignal;\n    timeoutMs?: number;\n  }","metadata: CompactionMetadataPayload","summaryTrust: 'trusted' | 'untrusted-derived'","summaryMessage: SystemMessage","trimmedMessages: ReadonlyArray<Message>"],"sources":["../../../src/context-engine/compaction/compactor.ts"],"sourcesContent":["/**\n * Auto-compaction subsystem core (RB-46 / suggested DEC-162 /\n * ADR-050). Trims the in-flight ContextEngine message buffer when\n * the assembled token count crosses a per-provider threshold; the\n * trim is summarized via the configured 9-section template; the\n * trim is followed by synchronous-await firing of registered\n * post-compaction hooks (lifecycle owned by Phase 12; this module\n * exposes the trim primitive).\n *\n * Disjoint from the Phase 10c consolidator: never writes to\n * `semantic_facts` / `episodic_episodes` / `procedural_rules`;\n * reads only `memory.metadata(...)` / `memory.semantic.search(...)`\n * / `memory.procedural.activate(...)` / `memory.working.read(...)`\n * (non-mutating).\n *\n * @packageDocumentation\n */\n\nimport type { Message, ModelSpec, SystemMessage } from '@graphorin/core';\nimport { scanImperativePatterns } from '@graphorin/observability/redaction';\nimport type { ContextLocalePack } from '../locale-packs/index.js';\nimport {\n  type ContextTokenCounter,\n  countMessageTokens,\n  HEURISTIC_TOKEN_COUNTER,\n  renderMessageText,\n} from '../token-counter.js';\nimport { clearOldToolResults } from './clear-tool-results.js';\nimport {\n  buildSummarizerPrompt,\n  type CompactionMetadataPayload,\n  renderFinalSummary,\n  SUMMARY_TEMPLATE_NAME,\n  SUMMARY_TEMPLATE_VERSION,\n} from './templates/summary-9-section.js';\nimport type {\n  CompactionContext,\n  CompactionResult,\n  CompactionSource,\n  CompactionStrategy,\n  CompactionSummarizer,\n} from './types.js';\n\n/**\n * Default count of recent turns preserved verbatim by the\n * `summarize-old-preserve-recent` strategy.\n *\n * @stable\n */\nexport const DEFAULT_PRESERVE_RECENT_TURNS = 6;\n\n/** Opening marker of the inbound-untrusted envelope (tools sanitize layer). */\nconst UNTRUSTED_MARKER = '<<<untrusted_content';\n\n/**\n * Wall-clock budget for the CE-15 injection scan of the summarizer\n * output. The scanner's 5ms default exists for the per-tool-result\n * hot path; here a compaction already paid for an LLM call, and on a\n * contended host (slow CI runners included) scheduler noise can cross\n * 5ms between pattern iterations — making the scanner return `null`\n * (verdict unknown) and the security check silently fail open.\n */\nconst COMPACTION_SCAN_BUDGET_MS = 50;\n\n/** CE-15: does the compacted window carry inbound-untrusted envelopes? */\nfunction windowContainsUntrusted(messages: ReadonlyArray<Message>): boolean {\n  return messages.some((message) => renderMessageText(message).includes(UNTRUSTED_MARKER));\n}\n\n/**\n * CE-15: wrap the LLM-authored summary body in a derived-trust\n * envelope. Envelope marker sequences inside the body are neutralized\n * first so summarizer output influenced by injected text cannot break\n * out of the envelope and masquerade as authoritative system text.\n */\nfunction wrapSummaryAsDerived(body: string): string {\n  const neutralized = body\n    .replaceAll('<<</untrusted_content>>>', '[[/untrusted_content]]')\n    .replaceAll(UNTRUSTED_MARKER, '[[untrusted_content');\n  return `<<<untrusted_content trust=\"derived\" tool=\"compaction-summarizer\">>>\\n${neutralized}\\n<<</untrusted_content>>>`;\n}\n\n/**\n * Trim the in-flight buffer using the\n * `summarize-old-preserve-recent` strategy. Returns the trimmed\n * messages + summary metadata; the caller is responsible for\n * appending the summary to the message buffer (Phase 12 owns the\n * lifecycle; this module exposes the primitive).\n *\n * @stable\n */\nexport interface ExecuteCompactionInput {\n  readonly messages: ReadonlyArray<Message>;\n  readonly source: CompactionSource;\n  readonly strategy: CompactionStrategy;\n  readonly localePack: ContextLocalePack;\n  readonly summarizer: CompactionSummarizer;\n  readonly tokenCounter?: ContextTokenCounter;\n  readonly thresholdTokens: number;\n  readonly runId: string;\n  readonly sessionId: string;\n  readonly agentId: string;\n  readonly scope: import('@graphorin/core').SessionScope;\n  readonly providerTrust?: import('@graphorin/core').LocalProviderTrust;\n  readonly now?: () => number;\n  readonly signal?: AbortSignal;\n}\n\n/**\n * Perform a compaction call. Returns the result envelope containing\n * the produced summary, the dropped/preserved message slices, and\n * the per-event metadata. Phase 12 / `agent.compact()` is the\n * lifecycle owner; this function is the trim primitive.\n *\n * @stable\n */\nexport async function executeCompaction(input: ExecuteCompactionInput): Promise<CompactionResult> {\n  const counter = input.tokenCounter ?? HEURISTIC_TOKEN_COUNTER;\n  const now = input.now ?? Date.now;\n  const startTs = now();\n  const beforeTokens = await countMessageTokens(input.messages, counter);\n\n  if (input.strategy.kind === 'custom') {\n    const ctx: CompactionContext = {\n      runId: input.runId,\n      sessionId: input.sessionId,\n      agentId: input.agentId,\n      scope: input.scope,\n      source: input.source,\n      messages: input.messages,\n      beforeTokens,\n      thresholdTokens: input.thresholdTokens,\n      preserveRecentTurns: DEFAULT_PRESERVE_RECENT_TURNS,\n      providerTrust: input.providerTrust ?? 'public-tls',\n    };\n    const result = await input.strategy.compact(ctx);\n    return result;\n  }\n\n  if (input.strategy.kind === 'clear-old-tool-results') {\n    return executeClearStrategy(input, input.strategy, counter, now, startTs, beforeTokens);\n  }\n\n  const preserveRecentTurns = input.strategy.preserveRecentTurns ?? DEFAULT_PRESERVE_RECENT_TURNS;\n  const summarizerModelInput = input.strategy.summarizerModel;\n  const summarizerTimeoutMs = input.strategy.summarizerTimeoutMs;\n\n  // Slice the older portion + preserve the recent N turns. We treat\n  // a \"turn\" as a single message for the v0.1 surface; the spec\n  // notes more nuanced segmentation is post-MVP per Q-121.\n  const olderCount = Math.max(0, input.messages.length - preserveRecentTurns);\n  const olderMessages = input.messages.slice(0, olderCount);\n  const preservedMessages = input.messages.slice(olderCount);\n\n  if (olderMessages.length === 0) {\n    return Object.freeze({\n      summary: '',\n      summaryTokens: 0,\n      beforeTokens,\n      afterTokens: beforeTokens,\n      droppedMessageIds: Object.freeze([]),\n      droppedMessageIndices: Object.freeze([]),\n      preservedMessages: Object.freeze([...preservedMessages]),\n      trimmedMessages: Object.freeze([...preservedMessages]),\n      source: input.source,\n      durationMs: now() - startTs,\n      hooksFiredCount: 0,\n      summaryTrust: 'trusted',\n    });\n  }\n\n  const template = {\n    preamble: input.localePack.compactionSummaryTemplate.preamble,\n    sections: input.localePack.compactionSummaryTemplate.sections,\n  };\n  const prompt = buildSummarizerPrompt({ template, olderMessages });\n\n  const summarizerInput: {\n    prompt: string;\n    model?: ModelSpec | string;\n    signal?: AbortSignal;\n    timeoutMs?: number;\n  } = { prompt };\n  if (summarizerModelInput !== undefined) summarizerInput.model = summarizerModelInput;\n  if (input.signal !== undefined) summarizerInput.signal = input.signal;\n  if (summarizerTimeoutMs !== undefined) summarizerInput.timeoutMs = summarizerTimeoutMs;\n  const summarized = await input.summarizer.summarize(summarizerInput);\n\n  // Section 9 metadata payload — stable shape so consumers can\n  // deserialize and reason about a compaction event.\n  const metadata: CompactionMetadataPayload = {\n    compactedAtIso: new Date(startTs).toISOString(),\n    // CE-14: positional labels, prefixed with the compaction instant so\n    // they no longer collide across compaction events (core Message has\n    // no id — these are indices into THIS compaction's dropped slice).\n    compactedFromMessageIds: Object.freeze(olderMessages.map((_, idx) => `c${startTs}_msg_${idx}`)),\n    compactedFromMessageIndices: Object.freeze(olderMessages.map((_, idx) => idx)),\n    compactedFromTokens: await countMessageTokens(olderMessages, counter),\n    summaryTokens: summarized.usageTokens ?? (await counter.countText(summarized.text)),\n    summarizerModel: resolveSummarizerModelLabel(summarizerModelInput, input.summarizer.id),\n    templateName: SUMMARY_TEMPLATE_NAME,\n    templateVersion: SUMMARY_TEMPLATE_VERSION,\n    preserveRecentTurns,\n  };\n\n  // CE-15: the summary must not launder untrusted content into a\n  // trusted system message. When the compacted window carried\n  // untrusted envelopes — or the injection heuristics flag the\n  // summarizer output itself — the LLM-authored body is committed\n  // inside a derived-trust envelope (sticky across re-compactions:\n  // the envelope re-triggers this detection next time around).\n  const summaryScan = scanImperativePatterns(summarized.text, undefined, COMPACTION_SCAN_BUDGET_MS);\n  const summaryTrust: 'trusted' | 'untrusted-derived' =\n    windowContainsUntrusted(olderMessages) || (summaryScan !== null && summaryScan.hits.length > 0)\n      ? 'untrusted-derived'\n      : 'trusted';\n  const finalSummary = renderFinalSummary({\n    template,\n    summaryFromLlm:\n      summaryTrust === 'untrusted-derived'\n        ? wrapSummaryAsDerived(summarized.text)\n        : summarized.text,\n    preservedMessages,\n    metadata,\n  });\n  const summaryTokens = await counter.countText(finalSummary);\n\n  const summaryMessage: SystemMessage = {\n    role: 'system',\n    content: finalSummary,\n  };\n  const trimmedMessages: ReadonlyArray<Message> = Object.freeze([\n    summaryMessage,\n    ...preservedMessages,\n  ]);\n  const afterTokens = await countMessageTokens(trimmedMessages, counter);\n  const durationMs = now() - startTs;\n\n  return Object.freeze({\n    summary: finalSummary,\n    summaryTokens,\n    beforeTokens,\n    afterTokens,\n    droppedMessageIds: metadata.compactedFromMessageIds,\n    droppedMessageIndices: metadata.compactedFromMessageIndices,\n    preservedMessages: Object.freeze([...preservedMessages]),\n    trimmedMessages,\n    source: input.source,\n    durationMs,\n    hooksFiredCount: 0,\n    summaryTrust,\n  });\n}\n\n/**\n * SOTA-1: clear the oldest tool results (zero-LLM), then summarize only if the\n * cleared buffer is still over the threshold. The summarizer runs on the\n * already-reduced window, so a few-tool-result buffer compacts for free.\n */\nasync function executeClearStrategy(\n  input: ExecuteCompactionInput,\n  strategy: Extract<CompactionStrategy, { kind: 'clear-old-tool-results' }>,\n  counter: ContextTokenCounter,\n  now: () => number,\n  startTs: number,\n  beforeTokens: number,\n): Promise<CompactionResult> {\n  const outcome = await clearOldToolResults(\n    input.messages,\n    {\n      ...(strategy.keepToolUses !== undefined ? { keepToolUses: strategy.keepToolUses } : {}),\n      ...(strategy.clearAtLeast !== undefined ? { clearAtLeast: strategy.clearAtLeast } : {}),\n      ...(strategy.excludeTools !== undefined ? { excludeTools: strategy.excludeTools } : {}),\n      ...(strategy.externalize !== undefined ? { externalize: strategy.externalize } : {}),\n    },\n    counter,\n  );\n  const afterClearTokens = await countMessageTokens(outcome.messages, counter);\n\n  const fallback = strategy.summarizeFallback;\n  if (fallback !== false && afterClearTokens > input.thresholdTokens) {\n    // Clearing did not reclaim enough — summarize the ALREADY-cleared buffer.\n    const summarized = await executeCompaction({\n      ...input,\n      messages: outcome.messages,\n      strategy: { kind: 'summarize-old-preserve-recent', ...(fallback ?? {}) },\n    });\n    return Object.freeze({\n      ...summarized,\n      // Report against the original buffer + carry the cleared indices.\n      beforeTokens,\n      droppedMessageIndices: Object.freeze([\n        ...outcome.clearedIndices,\n        ...summarized.droppedMessageIndices.filter((i) => !outcome.clearedIndices.includes(i)),\n      ]),\n      durationMs: now() - startTs,\n    });\n  }\n\n  // Zero-LLM clear-only outcome: content replaced in place, nothing summarized.\n  const clearedSet = new Set(outcome.clearedIndices);\n  const preservedMessages = outcome.messages.filter((_, i) => !clearedSet.has(i));\n  return Object.freeze({\n    summary: '',\n    summaryTokens: 0,\n    beforeTokens,\n    afterTokens: afterClearTokens,\n    droppedMessageIds: Object.freeze(outcome.clearedIndices.map((i) => `c${startTs}_cleared_${i}`)),\n    droppedMessageIndices: Object.freeze([...outcome.clearedIndices]),\n    preservedMessages: Object.freeze(preservedMessages),\n    trimmedMessages: Object.freeze([...outcome.messages]),\n    source: input.source,\n    durationMs: now() - startTs,\n    hooksFiredCount: 0,\n    summaryTrust: 'trusted',\n  });\n}\n\nfunction resolveSummarizerModelLabel(\n  modelInput: ModelSpec | string | undefined,\n  summarizerId: string | undefined,\n): string | null {\n  if (typeof modelInput === 'string') return modelInput;\n  if (modelInput !== undefined) {\n    const provider =\n      'provider' in modelInput\n        ? `${modelInput.provider.name}:${modelInput.model}`\n        : `${modelInput.name}:${modelInput.modelId}`;\n    return provider;\n  }\n  return summarizerId ?? null;\n}\n"],"mappings":"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"}

package/dist/context-engine/compaction/hooks/reanchor-persona-block.d.ts

@@ -0,0 +1,15 @@
+import { NamedPostCompactionHook } from "./types.js";
+
+//#region src/context-engine/compaction/hooks/reanchor-persona-block.d.ts
+
+/**
+ * Build a `reanchorPersonaBlock` hook.
+ *
+ * @stable
+ */
+declare function reanchorPersonaBlock(options?: {
+  readonly blockLabel?: string;
+}): NamedPostCompactionHook;
+//#endregion
+export { reanchorPersonaBlock };
+//# sourceMappingURL=reanchor-persona-block.d.ts.map

package/dist/context-engine/compaction/hooks/reanchor-persona-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reanchor-persona-block.d.ts","names":[],"sources":["../../../../src/context-engine/compaction/hooks/reanchor-persona-block.ts"],"sourcesContent":[],"mappings":";;;;;;;;;iBAiBgB,oBAAA;;IAEb"}

package/dist/context-engine/compaction/hooks/reanchor-persona-block.js

@@ -0,0 +1,27 @@
+//#region src/context-engine/compaction/hooks/reanchor-persona-block.ts
+/**
+* Build a `reanchorPersonaBlock` hook.
+*
+* @stable
+*/
+function reanchorPersonaBlock(options = {}) {
+	const blockLabel = options.blockLabel ?? "persona";
+	return {
+		id: "reanchorPersonaBlock",
+		async resolveContent(deps) {
+			const value = await deps.memory.working.read(deps.scope, blockLabel);
+			if (value === null || value.length === 0) return [];
+			return [{
+				type: "text",
+				text: `<memory_blocks anchor="post-compaction">\n  <block label="${escapeXml(blockLabel)}">\n    ${escapeXml(value)}\n  </block>\n</memory_blocks>`
+			}];
+		}
+	};
+}
+function escapeXml(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+
+//#endregion
+export { reanchorPersonaBlock };
+//# sourceMappingURL=reanchor-persona-block.js.map

package/dist/context-engine/compaction/hooks/reanchor-persona-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reanchor-persona-block.js","names":[],"sources":["../../../../src/context-engine/compaction/hooks/reanchor-persona-block.ts"],"sourcesContent":["/**\n * `reanchorPersonaBlock({ blockLabel = 'persona' })` — built-in\n * post-compaction hook. Queries `memory.working.read(...)` for the\n * persona block and returns it as a system-content fragment for\n * re-injection.\n *\n * @packageDocumentation\n */\n\nimport type { MessageContent } from '@graphorin/core';\nimport type { HookDeps, NamedPostCompactionHook } from './types.js';\n\n/**\n * Build a `reanchorPersonaBlock` hook.\n *\n * @stable\n */\nexport function reanchorPersonaBlock(\n  options: { readonly blockLabel?: string } = {},\n): NamedPostCompactionHook {\n  const blockLabel = options.blockLabel ?? 'persona';\n  return {\n    id: 'reanchorPersonaBlock',\n    async resolveContent(deps: HookDeps): Promise<ReadonlyArray<MessageContent>> {\n      const value = await deps.memory.working.read(deps.scope, blockLabel);\n      if (value === null || value.length === 0) return [];\n      return [\n        {\n          type: 'text',\n          text: `<memory_blocks anchor=\"post-compaction\">\\n  <block label=\"${escapeXml(blockLabel)}\">\\n    ${escapeXml(value)}\\n  </block>\\n</memory_blocks>`,\n        },\n      ];\n    },\n  };\n}\n\nfunction escapeXml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n"],"mappings":";;;;;;AAiBA,SAAgB,qBACd,UAA4C,EAAE,EACrB;CACzB,MAAM,aAAa,QAAQ,cAAc;AACzC,QAAO;EACL,IAAI;EACJ,MAAM,eAAe,MAAwD;GAC3E,MAAM,QAAQ,MAAM,KAAK,OAAO,QAAQ,KAAK,KAAK,OAAO,WAAW;AACpE,OAAI,UAAU,QAAQ,MAAM,WAAW,EAAG,QAAO,EAAE;AACnD,UAAO,CACL;IACE,MAAM;IACN,MAAM,6DAA6D,UAAU,WAAW,CAAC,UAAU,UAAU,MAAM,CAAC;IACrH,CACF;;EAEJ;;AAGH,SAAS,UAAU,OAAuB;AACxC,QAAO,MACJ,QAAQ,MAAM,QAAQ,CACtB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,SAAS"}

package/dist/context-engine/compaction/hooks/reanchor-pinned-facts.d.ts

@@ -0,0 +1,18 @@
+import { ContextTokenCounter } from "../../token-counter.js";
+import { NamedPostCompactionHook } from "./types.js";
+
+//#region src/context-engine/compaction/hooks/reanchor-pinned-facts.d.ts
+
+/**
+ * Build a `reanchorPinnedFacts` hook.
+ *
+ * @stable
+ */
+declare function reanchorPinnedFacts(options: {
+  readonly pinnedFactIds: ReadonlyArray<string>;
+  readonly maxTokens?: number;
+  readonly tokenCounter?: ContextTokenCounter;
+}): NamedPostCompactionHook;
+//#endregion
+export { reanchorPinnedFacts };
+//# sourceMappingURL=reanchor-pinned-facts.d.ts.map

package/dist/context-engine/compaction/hooks/reanchor-pinned-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reanchor-pinned-facts.d.ts","names":[],"sources":["../../../../src/context-engine/compaction/hooks/reanchor-pinned-facts.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;iBAkBgB,mBAAA;0BACU;;0BAEA;IACtB"}

package/dist/context-engine/compaction/hooks/reanchor-pinned-facts.js

@@ -0,0 +1,47 @@
+import { HEURISTIC_TOKEN_COUNTER } from "../../token-counter.js";
+
+//#region src/context-engine/compaction/hooks/reanchor-pinned-facts.ts
+/**
+* Build a `reanchorPinnedFacts` hook.
+*
+* @stable
+*/
+function reanchorPinnedFacts(options) {
+	const ids = options.pinnedFactIds;
+	const maxTokens = Math.max(0, options.maxTokens ?? 2e3);
+	const counter = options.tokenCounter ?? HEURISTIC_TOKEN_COUNTER;
+	return {
+		id: "reanchorPinnedFacts",
+		async resolveContent(deps) {
+			if (ids.length === 0) return [];
+			const lines = ["<memory_pinned_facts anchor=\"post-compaction\">"];
+			let runningTokens = 0;
+			for (const id of ids) {
+				const fact = await deps.memory.semantic.get(deps.scope, id).catch(() => null);
+				if (fact === null || fact.deletedAt !== void 0) continue;
+				const tagBlob = fact.tags !== void 0 ? ` tags="${escapeXml((fact.tags ?? []).join(","))}"` : "";
+				const fragment = `  <fact id="${escapeXml(fact.id)}"${tagBlob}>${escapeXml(fact.text)}</fact>`;
+				const fragmentTokens = await counter.countText(fragment);
+				if (maxTokens > 0 && runningTokens + fragmentTokens > maxTokens) {
+					lines.push("  <!-- additional pinned facts truncated to fit budget -->");
+					break;
+				}
+				runningTokens += fragmentTokens;
+				lines.push(fragment);
+			}
+			if (lines.length === 1) return [];
+			lines.push("</memory_pinned_facts>");
+			return [{
+				type: "text",
+				text: lines.join("\n")
+			}];
+		}
+	};
+}
+function escapeXml(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+
+//#endregion
+export { reanchorPinnedFacts };
+//# sourceMappingURL=reanchor-pinned-facts.js.map

package/dist/context-engine/compaction/hooks/reanchor-pinned-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reanchor-pinned-facts.js","names":[],"sources":["../../../../src/context-engine/compaction/hooks/reanchor-pinned-facts.ts"],"sourcesContent":["/**\n * `reanchorPinnedFacts({ pinnedFactIds, maxTokens })` — built-in\n * post-compaction hook. Looks up the explicitly-pinned fact IDs\n * via `memory.semantic.get(...)` and returns them as a\n * system-content fragment with their tags.\n *\n * @packageDocumentation\n */\n\nimport type { MessageContent } from '@graphorin/core';\nimport { type ContextTokenCounter, HEURISTIC_TOKEN_COUNTER } from '../../token-counter.js';\nimport type { HookDeps, NamedPostCompactionHook } from './types.js';\n\n/**\n * Build a `reanchorPinnedFacts` hook.\n *\n * @stable\n */\nexport function reanchorPinnedFacts(options: {\n  readonly pinnedFactIds: ReadonlyArray<string>;\n  readonly maxTokens?: number;\n  readonly tokenCounter?: ContextTokenCounter;\n}): NamedPostCompactionHook {\n  const ids = options.pinnedFactIds;\n  const maxTokens = Math.max(0, options.maxTokens ?? 2000);\n  const counter = options.tokenCounter ?? HEURISTIC_TOKEN_COUNTER;\n  return {\n    id: 'reanchorPinnedFacts',\n    async resolveContent(deps: HookDeps): Promise<ReadonlyArray<MessageContent>> {\n      if (ids.length === 0) return [];\n      const lines = ['<memory_pinned_facts anchor=\"post-compaction\">'];\n      let runningTokens = 0;\n      for (const id of ids) {\n        const fact = await deps.memory.semantic.get(deps.scope, id).catch(() => null);\n        if (fact === null || fact.deletedAt !== undefined) continue;\n        const tagBlob =\n          fact.tags !== undefined ? ` tags=\"${escapeXml((fact.tags ?? []).join(','))}\"` : '';\n        const fragment = `  <fact id=\"${escapeXml(fact.id)}\"${tagBlob}>${escapeXml(fact.text)}</fact>`;\n        const fragmentTokens = await counter.countText(fragment);\n        if (maxTokens > 0 && runningTokens + fragmentTokens > maxTokens) {\n          lines.push('  <!-- additional pinned facts truncated to fit budget -->');\n          break;\n        }\n        runningTokens += fragmentTokens;\n        lines.push(fragment);\n      }\n      if (lines.length === 1) return [];\n      lines.push('</memory_pinned_facts>');\n      return [{ type: 'text', text: lines.join('\\n') }];\n    },\n  };\n}\n\nfunction escapeXml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n"],"mappings":";;;;;;;;AAkBA,SAAgB,oBAAoB,SAIR;CAC1B,MAAM,MAAM,QAAQ;CACpB,MAAM,YAAY,KAAK,IAAI,GAAG,QAAQ,aAAa,IAAK;CACxD,MAAM,UAAU,QAAQ,gBAAgB;AACxC,QAAO;EACL,IAAI;EACJ,MAAM,eAAe,MAAwD;AAC3E,OAAI,IAAI,WAAW,EAAG,QAAO,EAAE;GAC/B,MAAM,QAAQ,CAAC,mDAAiD;GAChE,IAAI,gBAAgB;AACpB,QAAK,MAAM,MAAM,KAAK;IACpB,MAAM,OAAO,MAAM,KAAK,OAAO,SAAS,IAAI,KAAK,OAAO,GAAG,CAAC,YAAY,KAAK;AAC7E,QAAI,SAAS,QAAQ,KAAK,cAAc,OAAW;IACnD,MAAM,UACJ,KAAK,SAAS,SAAY,UAAU,WAAW,KAAK,QAAQ,EAAE,EAAE,KAAK,IAAI,CAAC,CAAC,KAAK;IAClF,MAAM,WAAW,eAAe,UAAU,KAAK,GAAG,CAAC,GAAG,QAAQ,GAAG,UAAU,KAAK,KAAK,CAAC;IACtF,MAAM,iBAAiB,MAAM,QAAQ,UAAU,SAAS;AACxD,QAAI,YAAY,KAAK,gBAAgB,iBAAiB,WAAW;AAC/D,WAAM,KAAK,6DAA6D;AACxE;;AAEF,qBAAiB;AACjB,UAAM,KAAK,SAAS;;AAEtB,OAAI,MAAM,WAAW,EAAG,QAAO,EAAE;AACjC,SAAM,KAAK,yBAAyB;AACpC,UAAO,CAAC;IAAE,MAAM;IAAQ,MAAM,MAAM,KAAK,KAAK;IAAE,CAAC;;EAEpD;;AAGH,SAAS,UAAU,OAAuB;AACxC,QAAO,MACJ,QAAQ,MAAM,QAAQ,CACtB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,SAAS"}

package/dist/context-engine/compaction/hooks/reanchor-project-rules.d.ts

@@ -0,0 +1,15 @@
+import { NamedPostCompactionHook } from "./types.js";
+
+//#region src/context-engine/compaction/hooks/reanchor-project-rules.d.ts
+
+/**
+ * Build a `reanchorProjectRules` hook.
+ *
+ * @stable
+ */
+declare function reanchorProjectRules(options?: {
+  readonly ruleTagsAllowlist?: ReadonlyArray<string>;
+}): NamedPostCompactionHook;
+//#endregion
+export { reanchorProjectRules };
+//# sourceMappingURL=reanchor-project-rules.d.ts.map

package/dist/context-engine/compaction/hooks/reanchor-project-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reanchor-project-rules.d.ts","names":[],"sources":["../../../../src/context-engine/compaction/hooks/reanchor-project-rules.ts"],"sourcesContent":[],"mappings":";;;;;;;;;iBAiBgB,oBAAA;+BAC0B;IACvC"}

package/dist/context-engine/compaction/hooks/reanchor-project-rules.js

@@ -0,0 +1,32 @@
+//#region src/context-engine/compaction/hooks/reanchor-project-rules.ts
+/**
+* Build a `reanchorProjectRules` hook.
+*
+* @stable
+*/
+function reanchorProjectRules(options = {}) {
+	const allowlist = options.ruleTagsAllowlist !== void 0 ? new Set(options.ruleTagsAllowlist) : null;
+	return {
+		id: "reanchorProjectRules",
+		async resolveContent(deps) {
+			const procedural = deps.procedural ?? {};
+			const rules = await deps.memory.procedural.activate(deps.scope, procedural);
+			const filtered = allowlist === null ? rules : rules.filter((rule) => (rule.tags ?? []).some((tag) => allowlist.has(tag)));
+			if (filtered.length === 0) return [];
+			const lines = ["<memory_rules anchor=\"post-compaction\">"];
+			for (const rule of filtered) lines.push(`  <rule priority="${rule.priority}" tags="${escapeXml((rule.tags ?? []).join(","))}">${escapeXml(rule.text)}</rule>`);
+			lines.push("</memory_rules>");
+			return [{
+				type: "text",
+				text: lines.join("\n")
+			}];
+		}
+	};
+}
+function escapeXml(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+
+//#endregion
+export { reanchorProjectRules };
+//# sourceMappingURL=reanchor-project-rules.js.map

package/dist/context-engine/compaction/hooks/reanchor-project-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reanchor-project-rules.js","names":[],"sources":["../../../../src/context-engine/compaction/hooks/reanchor-project-rules.ts"],"sourcesContent":["/**\n * `reanchorProjectRules({ ruleTagsAllowlist? })` — built-in\n * post-compaction hook. Queries `memory.procedural.activate(...)`\n * and returns the active rule set as a system-content fragment for\n * re-injection into the trimmed buffer.\n *\n * @packageDocumentation\n */\n\nimport type { MessageContent } from '@graphorin/core';\nimport type { HookDeps, NamedPostCompactionHook } from './types.js';\n\n/**\n * Build a `reanchorProjectRules` hook.\n *\n * @stable\n */\nexport function reanchorProjectRules(\n  options: { readonly ruleTagsAllowlist?: ReadonlyArray<string> } = {},\n): NamedPostCompactionHook {\n  const allowlist =\n    options.ruleTagsAllowlist !== undefined ? new Set(options.ruleTagsAllowlist) : null;\n  return {\n    id: 'reanchorProjectRules',\n    async resolveContent(deps: HookDeps): Promise<ReadonlyArray<MessageContent>> {\n      const procedural = deps.procedural ?? {};\n      const rules = await deps.memory.procedural.activate(deps.scope, procedural);\n      const filtered =\n        allowlist === null\n          ? rules\n          : rules.filter((rule) => (rule.tags ?? []).some((tag) => allowlist.has(tag)));\n      if (filtered.length === 0) return [];\n      const lines = ['<memory_rules anchor=\"post-compaction\">'];\n      for (const rule of filtered) {\n        lines.push(\n          `  <rule priority=\"${rule.priority}\" tags=\"${escapeXml((rule.tags ?? []).join(','))}\">${escapeXml(rule.text)}</rule>`,\n        );\n      }\n      lines.push('</memory_rules>');\n      return [{ type: 'text', text: lines.join('\\n') }];\n    },\n  };\n}\n\nfunction escapeXml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n"],"mappings":";;;;;;AAiBA,SAAgB,qBACd,UAAkE,EAAE,EAC3C;CACzB,MAAM,YACJ,QAAQ,sBAAsB,SAAY,IAAI,IAAI,QAAQ,kBAAkB,GAAG;AACjF,QAAO;EACL,IAAI;EACJ,MAAM,eAAe,MAAwD;GAC3E,MAAM,aAAa,KAAK,cAAc,EAAE;GACxC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,SAAS,KAAK,OAAO,WAAW;GAC3E,MAAM,WACJ,cAAc,OACV,QACA,MAAM,QAAQ,UAAU,KAAK,QAAQ,EAAE,EAAE,MAAM,QAAQ,UAAU,IAAI,IAAI,CAAC,CAAC;AACjF,OAAI,SAAS,WAAW,EAAG,QAAO,EAAE;GACpC,MAAM,QAAQ,CAAC,4CAA0C;AACzD,QAAK,MAAM,QAAQ,SACjB,OAAM,KACJ,qBAAqB,KAAK,SAAS,UAAU,WAAW,KAAK,QAAQ,EAAE,EAAE,KAAK,IAAI,CAAC,CAAC,IAAI,UAAU,KAAK,KAAK,CAAC,SAC9G;AAEH,SAAM,KAAK,kBAAkB;AAC7B,UAAO,CAAC;IAAE,MAAM;IAAQ,MAAM,MAAM,KAAK,KAAK;IAAE,CAAC;;EAEpD;;AAGH,SAAS,UAAU,OAAuB;AACxC,QAAO,MACJ,QAAQ,MAAM,QAAQ,CACtB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,SAAS"}

package/dist/context-engine/compaction/hooks/types.d.ts

@@ -0,0 +1,42 @@
+import { PostCompactionHookContext } from "../types.js";
+import { Memory } from "../../../facade.js";
+import { MessageContent, SessionScope } from "@graphorin/core";
+
+//#region src/context-engine/compaction/hooks/types.d.ts
+
+/**
+ * Resolved dependency surface every built-in hook reads. Threaded
+ * through Phase 12's lifecycle; tests pass a fixture
+ * implementation.
+ *
+ * @stable
+ */
+interface HookDeps {
+  readonly memory: Memory;
+  readonly scope: SessionScope;
+  /** Optional context tags surfaced to the procedural-rules query. */
+  readonly procedural?: {
+    readonly topic?: string;
+    readonly tags?: ReadonlyArray<string>;
+  };
+}
+/**
+ * Tagged hook returned by every factory below. The `id` field is
+ * surfaced on the `context.compaction.hook.executed.total{hookName}`
+ * counter family.
+ *
+ * @stable
+ */
+interface NamedPostCompactionHook {
+  readonly id: string;
+  /**
+   * `ctx` carries the REAL compaction outcome (CE-6) — result, scope,
+   * runId, sessionId, agentId, source — built by `compactNow` after the
+   * pipeline finishes. Record-form built-ins may ignore it; the
+   * function-form wrapper forwards it to the operator's hook verbatim.
+   */
+  resolveContent(deps: HookDeps, ctx?: PostCompactionHookContext): Promise<ReadonlyArray<MessageContent>>;
+}
+//#endregion
+export { HookDeps, NamedPostCompactionHook };
+//# sourceMappingURL=types.d.ts.map

package/dist/context-engine/compaction/hooks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/context-engine/compaction/hooks/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;UA6BiB,QAAA;mBACE;kBACD;;;;oBAEiD;;;;;;;;;;UAUlD,uBAAA;;;;;;;;uBASP,gBAAQ,4BAEb,QAAQ,cAAc"}

package/dist/context-engine/compaction/index.d.ts

@@ -0,0 +1,9 @@
+import { CLEARED_TOOL_RESULT_MARKER, ClearToolResultsOptions, ClearToolResultsOutcome, clearOldToolResults } from "./clear-tool-results.js";
+import { CompactionConfig, CompactionContext, CompactionResult, CompactionSource, CompactionStrategy, CompactionSummarizer, CompactionTriggerConfig, PostCompactionHook, PostCompactionHookContext } from "./types.js";
+import { DEFAULT_PRESERVE_RECENT_TURNS, ExecuteCompactionInput, executeCompaction } from "./compactor.js";
+import { HookDeps, NamedPostCompactionHook } from "./hooks/types.js";
+import { reanchorPersonaBlock } from "./hooks/reanchor-persona-block.js";
+import { reanchorPinnedFacts } from "./hooks/reanchor-pinned-facts.js";
+import { reanchorProjectRules } from "./hooks/reanchor-project-rules.js";
+import { CompactionMetadataPayload, RenderedTemplate, SUMMARY_TEMPLATE_NAME, SUMMARY_TEMPLATE_VERSION, buildSummarizerPrompt, renderFinalSummary } from "./templates/summary-9-section.js";
+import { AutoCompactionDefault, DEFAULT_RESERVED_FOR_COMPACTION, DEFAULT_RESERVED_FOR_RESPONSE, DEFAULT_THRESHOLD_RATIO, resolveAutoCompactionDefault, resolveTriggerThreshold } from "./thresholds.js";

package/dist/context-engine/compaction/index.js

@@ -0,0 +1,9 @@
+import { CLEARED_TOOL_RESULT_MARKER, DEFAULT_KEEP_TOOL_USES, clearOldToolResults } from "./clear-tool-results.js";
+import { SUMMARY_TEMPLATE_NAME, SUMMARY_TEMPLATE_VERSION, buildSummarizerPrompt, renderFinalSummary } from "./templates/summary-9-section.js";
+import { DEFAULT_PRESERVE_RECENT_TURNS, executeCompaction } from "./compactor.js";
+import { reanchorPersonaBlock } from "./hooks/reanchor-persona-block.js";
+import { reanchorPinnedFacts } from "./hooks/reanchor-pinned-facts.js";
+import { reanchorProjectRules } from "./hooks/reanchor-project-rules.js";
+import { DEFAULT_RESERVED_FOR_COMPACTION, DEFAULT_RESERVED_FOR_RESPONSE, DEFAULT_THRESHOLD_RATIO, resolveAutoCompactionDefault, resolveTriggerThreshold } from "./thresholds.js";
+
+export {  };

package/dist/context-engine/compaction/templates/summary-9-section.d.ts

@@ -0,0 +1,84 @@
+import { ContextLocalePack } from "../../locale-packs/types.js";
+import { Message } from "@graphorin/core";
+
+//#region src/context-engine/compaction/templates/summary-9-section.d.ts
+
+/**
+ * Template version surfaced into the summary's section 9 metadata.
+ * Bumped when the section structure / preamble wording changes in
+ * a way that consumers may want to detect.
+ *
+ * @stable
+ */
+declare const SUMMARY_TEMPLATE_VERSION = "1.2";
+/**
+ * Stable identifier of the bundled template.
+ *
+ * @stable
+ */
+declare const SUMMARY_TEMPLATE_NAME = "summary-9-section";
+/**
+ * Preamble + section-headers payload extracted from a locale pack.
+ * Surfaced as a separate type so test fixtures can assert against
+ * the resolved template independently from the locale pack.
+ *
+ * @stable
+ */
+interface RenderedTemplate {
+  readonly preamble: string;
+  readonly sections: ContextLocalePack['compactionSummaryTemplate']['sections'];
+}
+/**
+ * Build the prompt the summarizer LLM receives. The prompt
+ * contains:
+ *
+ *  1. The locale-resolved preamble.
+ *  2. The verbatim section list (1-9, with a note that section 8
+ *     is filled by the harness).
+ *  3. A delimited dump of the older messages the harness is about
+ *     to drop.
+ *
+ * The summarizer produces every section except the last two; those
+ * (recent turns + metadata) are stitched in by the harness before the
+ * result is committed to the in-flight buffer.
+ *
+ * @stable
+ */
+declare function buildSummarizerPrompt(input: {
+  readonly template: RenderedTemplate;
+  readonly olderMessages: ReadonlyArray<Message>;
+}): string;
+/**
+ * Section-9 metadata payload. Stable shape so consumers can
+ * deserialize and reason about a compaction event.
+ *
+ * @stable
+ */
+interface CompactionMetadataPayload {
+  readonly compactedAtIso: string;
+  readonly compactedFromMessageIds: ReadonlyArray<string>;
+  readonly compactedFromMessageIndices: ReadonlyArray<number>;
+  readonly compactedFromTokens: number;
+  readonly summaryTokens: number;
+  readonly summarizerModel: string | null;
+  readonly templateName: string;
+  readonly templateVersion: string;
+  readonly preserveRecentTurns: number;
+}
+/**
+ * Render the produced summary into the final text the harness commits
+ * to the in-flight buffer. The LLM-produced sections come from
+ * `summaryFromLlm`; the last two are stitched in mechanically — the
+ * preserved recent turns and the `metadata` block.
+ *
+ * @stable
+ */
+declare function renderFinalSummary(input: {
+  readonly template: RenderedTemplate;
+  readonly summaryFromLlm: string;
+  readonly preservedMessages: ReadonlyArray<Message>;
+  readonly metadata: CompactionMetadataPayload;
+}): string;
+//#endregion
+export { CompactionMetadataPayload, RenderedTemplate, SUMMARY_TEMPLATE_NAME, SUMMARY_TEMPLATE_VERSION, buildSummarizerPrompt, renderFinalSummary };
+//# sourceMappingURL=summary-9-section.d.ts.map

package/dist/context-engine/compaction/templates/summary-9-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-9-section.d.ts","names":[],"sources":["../../../../src/context-engine/compaction/templates/summary-9-section.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;cAmCa,wBAAA;;;;;;cAOA,qBAAA;;;;;;;;UASI,gBAAA;;qBAEI;;;;;;;;;;;;;;;;;;iBAmBL,qBAAA;qBACK;0BACK,cAAc;;;;;;;;UAkCvB,yBAAA;;oCAEmB;wCACI;;;;;;;;;;;;;;;;iBAiBxB,kBAAA;qBACK;;8BAES,cAAc;qBACvB"}