@nextclaw/kernel 0.19.2 → 0.19.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,3 @@
1
- import { K as appendCurrentTimeContextTail, L as renderAgentBootstrapContext, N as renderAgentSafetyContext, P as renderSystemExecutionPolicy, R as truncateContextText, S as AgentManager, Ut as composeAgentToolCatalog, _ as createQuestionMessage, _t as SessionEventReplayer, at as applyNcpAgentRunLifecycleEvent, b as SessionManager, c as Contribution, l as NextclawHarnessError, q as serializeModelInputTail, t as NextclawHarness, tt as SessionMessageCursorError, ut as createNcpAgentSessionSummary, v as createQuestionResolutionMessage, w as createShowContentTools, x as createWorkspaceByteTools, y as projectUserQuestions } from "../../nextclaw-harness.manager-toewDc-x.js";
1
+ import { K as appendCurrentTimeContextTail, L as renderAgentBootstrapContext, N as renderAgentSafetyContext, P as renderSystemExecutionPolicy, R as truncateContextText, S as AgentManager, Ut as composeAgentToolCatalog, _ as createQuestionMessage, _t as SessionEventReplayer, at as applyNcpAgentRunLifecycleEvent, b as SessionManager, c as Contribution, l as NextclawHarnessError, q as serializeModelInputTail, t as NextclawHarness, tt as SessionMessageCursorError, ut as createNcpAgentSessionSummary, v as createQuestionResolutionMessage, w as createShowContentTools, x as createWorkspaceByteTools, y as projectUserQuestions } from "../../nextclaw-harness.manager-DHzYOORP.js";
2
2
  import { EventBus, Ingress, createTypedKey, eventKeys, ingressKeys } from "@nextclaw/shared";
3
3
  export { AgentManager, Contribution, EventBus, Ingress, NextclawHarness, NextclawHarnessError, SessionEventReplayer, SessionManager, SessionMessageCursorError, appendCurrentTimeContextTail, applyNcpAgentRunLifecycleEvent, composeAgentToolCatalog, createNcpAgentSessionSummary, createQuestionMessage, createQuestionResolutionMessage, createShowContentTools, createTypedKey, createWorkspaceByteTools, eventKeys, ingressKeys, projectUserQuestions, renderAgentBootstrapContext, renderAgentSafetyContext, renderSystemExecutionPolicy, serializeModelInputTail, truncateContextText };
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- import { $ as coalesceSessionJournalDeltas, $t as DEFAULT_AGENT_RUNTIME_ENTRY_ID, A as ContextProviderRunContextService, At as NEXTCLAW_TIMELINE_KIND_METADATA_KEY, B as normalizeOptionalString, Bt as readLatestContextCompactionCheckpoint, C as ToolProviderRunContextService, Ct as ContextCompactionPreflightService, D as readProjectId, Dt as CONTEXT_COMPACTION_PROJECTION_METADATA_KEY, E as createAgentToolRunTriggerInput, Et as CONTEXT_COMPACTION_PROJECTION_KIND, F as CurrentSessionContextProvider, Ft as isContextCompactionProjectionMessage, G as syncSessionThinkingPreference, Gt as assertObservationJsonValue, H as readMetadataThinking, Ht as shouldRefreshContextWindowImmediately, I as AgentBootstrapContextProvider, It as isContextCompactionTimelineMessage, J as describeAgentRuntimeSessionTypes, Jt as evaluateObservationEventAdmission, K as appendCurrentTimeContextTail, Kt as assertObservationPredicate, L as renderAgentBootstrapContext, Lt as isContextWindowSnapshot, M as ExecutionPolicyContextProvider, Mt as buildContextCompactionTimelineNcpMessage, N as renderAgentSafetyContext, Nt as createContextCompactionMessageId, O as readProjectRoot, Ot as CONTEXT_COMPACTION_SYSTEM_PREAMBLE, P as renderSystemExecutionPolicy, Pt as createContextWindowSignature, Q as canCoalesceSessionJournalDeltas, Qt as toBoundedJson, R as truncateContextText, Rt as readContextCompactionCheckpoint, S as AgentManager, St as readEventToolCallId, T as attachSourceToolCall, Tt as CONTEXT_COMPACTION_PART_START, U as resolveEffectiveModel, Ut as composeAgentToolCatalog, V as readMetadataModel, Vt as shouldRefreshContextWindowDuringStream, W as resolveSessionChannelContext, Wt as ContextCompactionJournalRecoveryService, X as resolveAgentRuntimeEntries, Xt as parseObservationDuration, Y as normalizeAgentRuntimeSessionTypeIcon, Yt as matchesObservationPredicate, Zt as readJsonPointer, _ as createQuestionMessage, _t as SessionEventReplayer, a as dispatchAgentRuntimeSessionRequest, at as applyNcpAgentRunLifecycleEvent, b as SessionManager, bt as SessionReplaySupersessionTracker, c as Contribution, ct as NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE, d as dispatchPromptOverNcpResult, dt as isRecord$15, en as STRUCTURED_RESULT_TOOL_NAME, et as isSessionJournalDelta, f as startPromptOverNcpExecution, ft as normalizeNcpAgentId, g as USER_QUESTION_EXTENSION_TYPE, gt as upsertNcpAgentSessionSummaryEvent, h as UserQuestionManager, ht as toIsoString, i as createAgentRuntimeSessionRequestSourceNotifier, it as isSessionSettingsError, j as WorkspaceMemoryContextProvider, jt as buildContextCompactionModelProjection, k as buildRunMetadata, kt as CONTEXT_COMPACTION_TIMELINE_KIND, l as NextclawHarnessError, lt as createNcpAgentSessionJournalMetadataEntry, m as UserQuestionError, mt as safeNcpSessionFilename, n as buildSessionRequestCompletionMessage, nn as CommandRegistry, nt as SessionSettingsError, o as waitForAgentRuntimeSessionReply, ot as isNcpAgentRunLifecycleEvent, p as buildAgentRunSendPayload, pt as normalizeNcpSessionId, q as serializeModelInputTail, qt as buildObservationEventModelMessage, r as createAgentRuntimeSessionRequestDispatcher, rt as isSessionMessageCursorError, s as SessionRequestManager, st as NCP_AGENT_SESSION_JOURNAL_INDEX_FILE, t as NextclawHarness, tn as AgentRunClient, tt as SessionMessageCursorError, u as dispatchPromptOverNcp, ut as createNcpAgentSessionSummary, v as createQuestionResolutionMessage, vt as readReplayToolOwners, w as createShowContentTools, wt as CONTEXT_COMPACTION_CONTINUATION_TEXT, x as createWorkspaceByteTools, xt as readEventMessageId, y as projectUserQuestions, yt as seedReplayToolOwners, z as buildNextclawNcpRunContext, zt as readContextWindowEventSessionId } from "./nextclaw-harness.manager-toewDc-x.js";
1
+ import { $ as coalesceSessionJournalDeltas, $t as DEFAULT_AGENT_RUNTIME_ENTRY_ID, A as ContextProviderRunContextService, At as NEXTCLAW_TIMELINE_KIND_METADATA_KEY, B as normalizeOptionalString, Bt as readLatestContextCompactionCheckpoint, C as ToolProviderRunContextService, Ct as ContextCompactionPreflightService, D as readProjectId, Dt as CONTEXT_COMPACTION_PROJECTION_METADATA_KEY, E as createAgentToolRunTriggerInput, Et as CONTEXT_COMPACTION_PROJECTION_KIND, F as CurrentSessionContextProvider, Ft as isContextCompactionProjectionMessage, G as syncSessionThinkingPreference, Gt as assertObservationJsonValue, H as readMetadataThinking, Ht as shouldRefreshContextWindowImmediately, I as AgentBootstrapContextProvider, It as isContextCompactionTimelineMessage, J as describeAgentRuntimeSessionTypes, Jt as evaluateObservationEventAdmission, K as appendCurrentTimeContextTail, Kt as assertObservationPredicate, L as renderAgentBootstrapContext, Lt as isContextWindowSnapshot, M as ExecutionPolicyContextProvider, Mt as buildContextCompactionTimelineNcpMessage, N as renderAgentSafetyContext, Nt as createContextCompactionMessageId, O as readProjectRoot, Ot as CONTEXT_COMPACTION_SYSTEM_PREAMBLE, P as renderSystemExecutionPolicy, Pt as createContextWindowSignature, Q as canCoalesceSessionJournalDeltas, Qt as toBoundedJson, R as truncateContextText, Rt as readContextCompactionCheckpoint, S as AgentManager, St as readEventToolCallId, T as attachSourceToolCall, Tt as CONTEXT_COMPACTION_PART_START, U as resolveEffectiveModel, Ut as composeAgentToolCatalog, V as readMetadataModel, Vt as shouldRefreshContextWindowDuringStream, W as resolveSessionChannelContext, Wt as ContextCompactionJournalRecoveryService, X as resolveAgentRuntimeEntries, Xt as parseObservationDuration, Y as normalizeAgentRuntimeSessionTypeIcon, Yt as matchesObservationPredicate, Zt as readJsonPointer, _ as createQuestionMessage, _t as SessionEventReplayer, a as dispatchAgentRuntimeSessionRequest, at as applyNcpAgentRunLifecycleEvent, b as SessionManager, bt as SessionReplaySupersessionTracker, c as Contribution, ct as NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE, d as dispatchPromptOverNcpResult, dt as isRecord$15, en as STRUCTURED_RESULT_TOOL_NAME, et as isSessionJournalDelta, f as startPromptOverNcpExecution, ft as normalizeNcpAgentId, g as USER_QUESTION_EXTENSION_TYPE, gt as upsertNcpAgentSessionSummaryEvent, h as UserQuestionManager, ht as toIsoString, i as createAgentRuntimeSessionRequestSourceNotifier, it as isSessionSettingsError, j as WorkspaceMemoryContextProvider, jt as buildContextCompactionModelProjection, k as buildRunMetadata, kt as CONTEXT_COMPACTION_TIMELINE_KIND, l as NextclawHarnessError, lt as createNcpAgentSessionJournalMetadataEntry, m as UserQuestionError, mt as safeNcpSessionFilename, n as buildSessionRequestCompletionMessage, nn as CommandRegistry, nt as SessionSettingsError, o as waitForAgentRuntimeSessionReply, ot as isNcpAgentRunLifecycleEvent, p as buildAgentRunSendPayload, pt as normalizeNcpSessionId, q as serializeModelInputTail, qt as buildObservationEventModelMessage, r as createAgentRuntimeSessionRequestDispatcher, rt as isSessionMessageCursorError, s as SessionRequestManager, st as NCP_AGENT_SESSION_JOURNAL_INDEX_FILE, t as NextclawHarness, tn as AgentRunClient, tt as SessionMessageCursorError, u as dispatchPromptOverNcp, ut as createNcpAgentSessionSummary, v as createQuestionResolutionMessage, vt as readReplayToolOwners, w as createShowContentTools, wt as CONTEXT_COMPACTION_CONTINUATION_TEXT, x as createWorkspaceByteTools, xt as readEventMessageId, y as projectUserQuestions, yt as seedReplayToolOwners, z as buildNextclawNcpRunContext, zt as readContextWindowEventSessionId } from "./nextclaw-harness.manager-DHzYOORP.js";
2
2
  import { AUTOMATIC_UPDATE_CHECK_INTERVAL_MS, getAutomaticUpdateCheckDelay, resolveAutomaticUpdateCheckIntervalMs } from "./utils/automatic-update-check.utils.js";
3
3
  import { n as getUnsignedUpdateManifest, r as serializeUnsignedUpdateManifest, t as UpdateManifestReader } from "./update-manifest.types-CBp2VTM1.js";
4
4
  import { createRequire } from "node:module";
@@ -979,10 +979,83 @@ function estimateToolInputTokens(tools) {
979
979
  return estimateInputTokens(buildProviderTools(tools));
980
980
  }
981
981
  //#endregion
982
+ //#region src/utils/context-compaction-summary-source.utils.ts
983
+ const SOURCE_FIELDS = [
984
+ "role",
985
+ "content",
986
+ "reasoning_content",
987
+ "name",
988
+ "tool_calls",
989
+ "tool_call_id",
990
+ "timestamp",
991
+ "ncp_message_id",
992
+ "ncp_part_start",
993
+ "ncp_part_end"
994
+ ];
995
+ const IDENTITY_FIELDS = new Set([
996
+ "role",
997
+ "name",
998
+ "id",
999
+ "type",
1000
+ "tool_call_id",
1001
+ "ncp_message_id",
1002
+ "timestamp"
1003
+ ]);
1004
+ const MIN_SOURCE_TEXT_CHARS = 128;
1005
+ function truncateSummarySourceString(value, maxChars) {
1006
+ if (typeof value !== "string" || value.length <= maxChars) return value;
1007
+ const marker = `[${value.length - maxChars} chars omitted]`;
1008
+ const kept = Math.max(0, maxChars - marker.length - 2);
1009
+ const head = Math.ceil(kept / 2);
1010
+ return `${value.slice(0, head).trimEnd()}\n${marker}\n${kept > head ? value.slice(-(kept - head)).trimStart() : ""}`;
1011
+ }
1012
+ function sourceMessages(messages) {
1013
+ return messages.map((message) => Object.fromEntries(SOURCE_FIELDS.filter((field) => message[field] !== void 0).map((field) => [field, message[field]])));
1014
+ }
1015
+ function serializeSource(messages, textChars) {
1016
+ const summaries = new Set(messages.filter((message) => (message.role === "system" || message.role === "service") && typeof message.content === "string" && message.content.includes("# Compressed Working Context")).map((message) => message.content));
1017
+ return JSON.stringify(sourceMessages(messages), (key, value) => IDENTITY_FIELDS.has(key) || summaries.has(value) ? value : truncateSummarySourceString(value, textChars));
1018
+ }
1019
+ /** Shrink verbose fields, never discard a message or break the outer JSON. */
1020
+ function stringifyCompactionSource(messages, maxChars) {
1021
+ if (messages.length === 0) return "[]";
1022
+ const minimal = serializeSource(messages, MIN_SOURCE_TEXT_CHARS);
1023
+ if (minimal.length > maxChars) throw new Error("Compaction source identities exceed the input budget; split the source before summarizing.");
1024
+ let fitted = minimal;
1025
+ let lower = MIN_SOURCE_TEXT_CHARS;
1026
+ let upper = maxChars;
1027
+ while (lower <= upper) {
1028
+ const limit = Math.floor((lower + upper) / 2);
1029
+ const candidate = serializeSource(messages, limit);
1030
+ if (candidate.length <= maxChars) {
1031
+ fitted = candidate;
1032
+ lower = limit + 1;
1033
+ } else upper = limit - 1;
1034
+ }
1035
+ return fitted;
1036
+ }
1037
+ /** Bound identity overhead before fitting text; every source record belongs to one batch. */
1038
+ function splitCompactionSource(messages, maxChars) {
1039
+ const batches = [];
1040
+ let batch = [];
1041
+ let size = 2;
1042
+ for (const message of messages) {
1043
+ const messageSize = serializeSource([message], MIN_SOURCE_TEXT_CHARS).length;
1044
+ if (messageSize > maxChars) throw new Error("A compaction source record exceeds the minimum safe input budget.");
1045
+ if (batch.length > 0 && size + messageSize > maxChars) {
1046
+ batches.push(batch);
1047
+ batch = [];
1048
+ size = 2;
1049
+ }
1050
+ batch.push(message);
1051
+ size += messageSize;
1052
+ }
1053
+ if (batch.length > 0) batches.push(batch);
1054
+ return batches.length > 0 ? batches : [[]];
1055
+ }
1056
+ //#endregion
982
1057
  //#region src/utils/context-compaction-summary-input.utils.ts
983
1058
  const SUMMARY_SOURCE_MAX_CHARS = 12e4;
984
- const SUMMARY_SOURCE_HEAD_MESSAGES = 2;
985
- const SUMMARY_SOURCE_TAIL_MESSAGES = 8;
986
1059
  const SUMMARY_HEADING = "# Compressed Working Context";
987
1060
  const SUMMARY_ESSENTIAL_COMPLETE_MARKER = "<!-- nextclaw-essential-context-complete -->";
988
1061
  const SUMMARY_ESSENTIAL_SECTIONS = [
@@ -998,54 +1071,12 @@ const SUMMARY_OPTIONAL_SECTIONS = [
998
1071
  ["Older Relevant Context", "older-relevant-context"]
999
1072
  ];
1000
1073
  const SUMMARY_SYSTEM_PROMPT = [
1001
- "Compress a coding-agent session into standalone Markdown. Do not invent facts.",
1002
- "Start with '# Compressed Working Context'. Then use these sections in exact order: Active Request; Current Work State; Safety and User Constraints; Continuation Contract; Critical Technical Context; Evidence and Verification; Recent High-Fidelity Context; Older Relevant Context.",
1003
- "The first four sections are essential and must have non-empty bodies. End the Continuation Contract body with exactly '<!-- nextclaw-essential-context-complete -->'. Put no text after that marker before the next heading.",
1004
- "Optional sections follow in the listed order. End each body with '<!-- nextclaw-section-complete:SLUG -->', using slugs critical-technical-context, evidence-and-verification, recent-high-fidelity-context, and older-relevant-context. Omit an optional section unless you can close it.",
1005
- "Keep all essential facts in the first four sections: latest user intent, active task, current work, constraints, decisions, files and changes, tool/test evidence, failures, blockers, and exact next step.",
1006
- "Do not restart onboarding for missing profile fields unless onboarding is the active task. A greeting does not erase the prior task."
1074
+ "Summarize facts as Markdown starting '# Compressed Working Context'.",
1075
+ "Required nonempty headings, in order: Active Request; Current Work State; Safety and User Constraints; Continuation Contract. Close the last body with <!-- nextclaw-essential-context-complete -->.",
1076
+ "Include latest intent, decisions, constraints, changed files, evidence and next step. Distinguish Done/In Progress/Blocked/Failed; keep command/file identities and outcomes. Attempted calls alone are not completion.",
1077
+ "Update any previous summary: carry completed work and constraints forward, replace stale next steps. Completed requests are history. Repeat reads only for freshness/verification; recover uncertain side-effect status before repeating. A greeting does not erase the prior task or restart onboarding.",
1078
+ "Optional headings follow in order: Critical Technical Context; Evidence and Verification; Recent High-Fidelity Context; Older Relevant Context. Close each body with <!-- nextclaw-section-complete:SLUG -->, using critical-technical-context, evidence-and-verification, recent-high-fidelity-context, older-relevant-context respectively. Omit sections you cannot close."
1007
1079
  ].join("\n");
1008
- function toCompactionSourceMessage(message) {
1009
- return {
1010
- role: message.role,
1011
- content: message.content,
1012
- timestamp: message.timestamp,
1013
- ncp_message_id: message.ncp_message_id
1014
- };
1015
- }
1016
- function truncateSummarySourceString(value, maxChars) {
1017
- if (typeof value !== "string" || value.length <= maxChars) return value;
1018
- const marker = `[${value.length - maxChars} chars omitted]`;
1019
- const headChars = Math.floor((maxChars - marker.length) / 2);
1020
- const tailChars = maxChars - marker.length - headChars;
1021
- return [
1022
- value.slice(0, headChars).trimEnd(),
1023
- marker,
1024
- value.slice(-tailChars).trimStart()
1025
- ].join("\n");
1026
- }
1027
- function stringifyCompactionSource(messages, maxChars) {
1028
- const sourceMessages = messages.map(toCompactionSourceMessage);
1029
- const json = JSON.stringify(sourceMessages, null, 2);
1030
- if (json.length <= maxChars) return json;
1031
- const tailStart = Math.max(SUMMARY_SOURCE_HEAD_MESSAGES, sourceMessages.length - SUMMARY_SOURCE_TAIL_MESSAGES);
1032
- const compactedMessages = [
1033
- ...sourceMessages.slice(0, SUMMARY_SOURCE_HEAD_MESSAGES),
1034
- ...tailStart > SUMMARY_SOURCE_HEAD_MESSAGES ? [{
1035
- role: "system",
1036
- content: `[${tailStart - SUMMARY_SOURCE_HEAD_MESSAGES} middle messages omitted from compaction source]`
1037
- }] : [],
1038
- ...sourceMessages.slice(tailStart)
1039
- ];
1040
- const maxStringChars = Math.max(256, Math.floor(maxChars / Math.max(1, compactedMessages.length) * .7));
1041
- const compactedJson = JSON.stringify(compactedMessages, (_key, value) => truncateSummarySourceString(value, maxStringChars), 2);
1042
- if (compactedJson.length <= maxChars) return compactedJson;
1043
- const marker = "\n[truncated_compaction_source_middle]\n";
1044
- if (maxChars <= 38) return compactedJson.slice(0, maxChars);
1045
- const headChars = Math.floor((maxChars - 38) / 2);
1046
- const tailChars = maxChars - 38 - headChars;
1047
- return `${compactedJson.slice(0, headChars).trimEnd()}${marker}${compactedJson.slice(-tailChars).trimStart()}`;
1048
- }
1049
1080
  function buildSummaryProviderMessages(params) {
1050
1081
  const { essentialOnly, messages, sourceMaxChars, targetSummaryTokens } = params;
1051
1082
  return [{
@@ -1067,6 +1098,7 @@ function fitContextCompactionSummaryInput(params) {
1067
1098
  const { essentialOnly = false, maxInputTokens, messages, sourceMaxChars = SUMMARY_SOURCE_MAX_CHARS, targetSummaryTokens } = params;
1068
1099
  let lower = 0;
1069
1100
  let upper = Math.max(0, sourceMaxChars);
1101
+ let sourceFitted = messages.length === 0;
1070
1102
  let fitted = buildSummaryProviderMessages({
1071
1103
  essentialOnly,
1072
1104
  messages: [],
@@ -1076,17 +1108,25 @@ function fitContextCompactionSummaryInput(params) {
1076
1108
  if (estimateInputTokens(fitted) > maxInputTokens) throw new Error(`Context compaction summary prompt needs more than ${maxInputTokens} input tokens. Increase the agent contextTokens setting.`);
1077
1109
  while (lower <= upper) {
1078
1110
  const sourceMaxChars = Math.floor((lower + upper) / 2);
1079
- const candidate = buildSummaryProviderMessages({
1080
- essentialOnly,
1081
- messages,
1082
- sourceMaxChars,
1083
- targetSummaryTokens
1084
- });
1111
+ let candidate;
1112
+ try {
1113
+ candidate = buildSummaryProviderMessages({
1114
+ essentialOnly,
1115
+ messages,
1116
+ sourceMaxChars,
1117
+ targetSummaryTokens
1118
+ });
1119
+ } catch {
1120
+ lower = sourceMaxChars + 1;
1121
+ continue;
1122
+ }
1085
1123
  if (estimateInputTokens(candidate) <= maxInputTokens) {
1086
1124
  fitted = candidate;
1125
+ sourceFitted = true;
1087
1126
  lower = sourceMaxChars + 1;
1088
1127
  } else upper = sourceMaxChars - 1;
1089
1128
  }
1129
+ if (!sourceFitted) throw new Error("Compaction source cannot fit without dropping message identities.");
1090
1130
  return fitted;
1091
1131
  }
1092
1132
  function normalizeContextCompactionSummary(content) {
@@ -1168,18 +1208,21 @@ function fitContextCompactionSummaryOutput(params) {
1168
1208
  /**
1169
1209
  * Last-resort checkpoint used after bounded semantic generation failures.
1170
1210
  * It deliberately preserves exact recent source instead of inventing a
1171
- * natural-language summary, while older history is dropped Codex-style.
1211
+ * natural-language summary, and explicitly marks older execution status unknown.
1172
1212
  */
1173
1213
  function buildContextCompactionEmergencySummary(params) {
1174
1214
  const { maxInstallableSummaryTokens, messages } = params;
1175
1215
  const build = (sourceMaxChars) => {
1176
- const source = stringifyCompactionSource(messages, sourceMaxChars);
1216
+ let source = "";
1217
+ try {
1218
+ source = stringifyCompactionSource(messages.slice(-2), sourceMaxChars);
1219
+ } catch {}
1177
1220
  return [
1178
1221
  SUMMARY_HEADING,
1179
1222
  "## Active Request\n\nContinue the latest raw user request retained after this checkpoint. If no raw user request follows, continue the active run from the exact recent source below.",
1180
1223
  `## Current Work State\n\nModel-based compaction did not produce a safe summary. Exact retained recent source:\n\n${source ? source.split("\n").map((line) => `> ${line}`).join("\n") : "> No recent source text fit the emergency checkpoint budget."}`,
1181
1224
  "## Safety and User Constraints\n\nHonor the retained system, service, and user constraints verbatim. Treat dropped older context as unknown and do not invent it.",
1182
- `## Continuation Contract\n\nContinue from the exact recent source and following raw messages. Do not repeat work unless the retained evidence says it is incomplete.\n${SUMMARY_ESSENTIAL_COMPLETE_MARKER}`
1225
+ `## Continuation Contract\n\nContinue from the exact recent source and following raw messages. Older execution state is unknown: recover evidence before repeating any side effect. Do not repeat work unless the retained evidence says it is incomplete.\n${SUMMARY_ESSENTIAL_COMPLETE_MARKER}`
1183
1226
  ].join("\n\n");
1184
1227
  };
1185
1228
  let lower = 0;
@@ -1199,14 +1242,10 @@ function buildContextCompactionEmergencySummary(params) {
1199
1242
  /** Build a deterministic, smaller source for semantic compaction retries. */
1200
1243
  function selectContextCompactionAttemptMessages(messages, attempt) {
1201
1244
  if (attempt <= 1) return messages.map((message) => structuredClone(message));
1202
- const protectedHead = messages.slice(0, 2).filter((message) => message.role === "system" || message.role === "service");
1203
- const tailCount = attempt >= 3 ? 2 : 6;
1204
- const tail = messages.slice(-tailCount);
1205
- const seen = new Set(protectedHead);
1206
- const selectedMessages = [...protectedHead, ...tail].filter((message, index, selected) => selected.indexOf(message) === index && (index < protectedHead.length || !seen.has(message)));
1207
1245
  const contentRatio = attempt >= 3 ? .25 : .5;
1208
- return selectedMessages.map((message) => {
1246
+ return messages.map((message) => {
1209
1247
  const copy = structuredClone(message);
1248
+ if ((copy.role === "system" || copy.role === "service") && typeof copy.content === "string" && copy.content.includes("# Compressed Working Context")) return copy;
1210
1249
  if (typeof copy.content === "string" && copy.content.length > 32) {
1211
1250
  const maxChars = Math.max(16, Math.floor(copy.content.length * contentRatio));
1212
1251
  copy.content = truncateSummarySourceString(copy.content, maxChars);
@@ -1240,6 +1279,37 @@ var ContextCompactionSummaryGenerationService = class {
1240
1279
  this.providerManager = providerManager;
1241
1280
  }
1242
1281
  generate = async (params) => {
1282
+ const { maxInputTokens, targetSummaryTokens, messages: sourceMessages, signal } = params;
1283
+ const batches = splitCompactionSource(sourceMessages, Math.max(512, Math.min(6e4, (maxInputTokens - targetSummaryTokens - 1024) * 3)));
1284
+ let generated;
1285
+ const usage = {};
1286
+ let attemptCount = 0;
1287
+ let degraded = false;
1288
+ for (const [index, messages] of batches.entries()) {
1289
+ const previous = generated;
1290
+ generated = await this.generateBatch({
1291
+ ...params,
1292
+ messages: previous ? [{
1293
+ role: "system",
1294
+ content: previous.summary
1295
+ }, ...messages] : messages
1296
+ });
1297
+ if (batches.length > 1 && generated.diagnostics.recovery !== "provider-summary") throw new Error("Context compaction batch failed; refusing to install a partial-history checkpoint. The previous checkpoint was kept unchanged.");
1298
+ mergeProviderUsage(usage, generated.diagnostics.providerUsage);
1299
+ attemptCount += generated.diagnostics.attemptCount;
1300
+ degraded ||= generated.diagnostics.degraded;
1301
+ if (signal?.aborted) throw new DOMException("Context compaction summary generation was cancelled", "AbortError");
1302
+ generated.diagnostics = {
1303
+ ...generated.diagnostics,
1304
+ attemptCount,
1305
+ degraded,
1306
+ providerUsage: { ...usage },
1307
+ sourceBatchCount: index + 1
1308
+ };
1309
+ }
1310
+ return generated;
1311
+ };
1312
+ generateBatch = async (params) => {
1243
1313
  if (!this.providerManager) throw new Error("context compaction summary generation requires a provider manager");
1244
1314
  let lastFailure = "unknown summary failure";
1245
1315
  let lastFinishReason = "unknown";
@@ -1297,13 +1367,23 @@ var ContextCompactionSummaryGenerationService = class {
1297
1367
  runAttempt = async (input) => {
1298
1368
  const { attempt, params, previousInputTokens } = input;
1299
1369
  if (params.signal?.aborted) throw new DOMException("Context compaction summary generation was cancelled", "AbortError");
1300
- const providerMessages = fitContextCompactionSummaryInput({
1301
- essentialOnly: attempt === SUMMARY_ATTEMPT_SOURCE_MAX_CHARS.length,
1302
- maxInputTokens: params.maxInputTokens,
1303
- messages: selectContextCompactionAttemptMessages(params.messages, attempt),
1304
- sourceMaxChars: SUMMARY_ATTEMPT_SOURCE_MAX_CHARS[attempt - 1],
1305
- targetSummaryTokens: params.targetSummaryTokens
1306
- });
1370
+ let providerMessages;
1371
+ try {
1372
+ providerMessages = fitContextCompactionSummaryInput({
1373
+ essentialOnly: attempt === SUMMARY_ATTEMPT_SOURCE_MAX_CHARS.length,
1374
+ maxInputTokens: Math.min(params.maxInputTokens, Number.isFinite(previousInputTokens) ? Math.floor(previousInputTokens * .7) : params.maxInputTokens),
1375
+ messages: selectContextCompactionAttemptMessages(params.messages, attempt),
1376
+ sourceMaxChars: SUMMARY_ATTEMPT_SOURCE_MAX_CHARS[attempt - 1],
1377
+ targetSummaryTokens: params.targetSummaryTokens
1378
+ });
1379
+ } catch (error) {
1380
+ if (attempt === 1) throw error;
1381
+ return this.failedAttempt({
1382
+ calledProvider: false,
1383
+ inputTokens: 0,
1384
+ failure: error instanceof Error ? error.message : String(error)
1385
+ });
1386
+ }
1307
1387
  const inputTokens = estimateInputTokens(providerMessages);
1308
1388
  if (inputTokens >= previousInputTokens) return this.failedAttempt({
1309
1389
  calledProvider: false,
@@ -1454,10 +1534,10 @@ function buildMidRunContinuationMessage(params) {
1454
1534
  }]
1455
1535
  };
1456
1536
  }
1457
- function sliceMessageParts(message, start) {
1458
- if (!Number.isInteger(start) || start < 0 || start > message.parts.length) throw new Error("Invalid compacted message part boundary");
1537
+ function sliceMessageParts(message, start, end = message.parts.length) {
1538
+ if (!Number.isInteger(start) || start < 0 || start > end || !Number.isInteger(end) || end > message.parts.length) throw new Error("Invalid compacted message part boundary");
1459
1539
  const projected = structuredClone(message);
1460
- projected.parts = projected.parts.slice(start);
1540
+ projected.parts = projected.parts.slice(start, end);
1461
1541
  projected.metadata = {
1462
1542
  ...projected.metadata,
1463
1543
  [CONTEXT_COMPACTION_PART_START]: start
@@ -1465,11 +1545,13 @@ function sliceMessageParts(message, start) {
1465
1545
  const offsets = projected.metadata?.[MODEL_ROUND_PART_OFFSETS];
1466
1546
  if (Array.isArray(offsets)) projected.metadata = {
1467
1547
  ...projected.metadata,
1468
- [MODEL_ROUND_PART_OFFSETS]: offsets.filter((offset) => offset > start).map((offset) => offset - start)
1548
+ [MODEL_ROUND_PART_OFFSETS]: offsets.filter((offset) => offset > start && offset < end).map((offset) => offset - start)
1469
1549
  };
1470
1550
  return projected;
1471
1551
  }
1472
1552
  function projectMessageAfterCheckpoint(message, checkpoint) {
1553
+ const retainedEnd = checkpoint.retainedMessagePartEnds?.[message.id];
1554
+ if (typeof retainedEnd === "number") return message.parts.length > retainedEnd ? sliceMessageParts(message, retainedEnd) : null;
1473
1555
  const coveredPartCount = checkpoint.continuationMessageCoveredPartCount;
1474
1556
  if (message.id === checkpoint.continuationMessageId && typeof coveredPartCount === "number" && Number.isInteger(coveredPartCount) && coveredPartCount >= 0) return message.parts.slice(coveredPartCount).length > 0 ? sliceMessageParts(message, coveredPartCount) : null;
1475
1557
  return Date.parse(message.timestamp) > Date.parse(readCheckpointCoveredUntil(checkpoint)) ? structuredClone(message) : null;
@@ -1534,8 +1616,8 @@ function buildContextCompactionModelProjection(params) {
1534
1616
  const preservedUserMessageIds = readCheckpointMessageIds(checkpoint.preservedUserMessageIds);
1535
1617
  const retainedMessageIds = readCheckpointMessageIds(checkpoint.retainedMessageIds);
1536
1618
  const preservedUserMessages = regularMessages.filter((message) => message.role === "user" && preservedUserMessageIds.has(message.id)).map((message) => projectPreservedUserMessage(message, checkpoint)).sort((left, right) => Date.parse(left.timestamp) - Date.parse(right.timestamp));
1537
- const retainedMessages = regularMessages.filter((message) => retainedMessageIds.has(message.id)).map((message) => sliceMessageParts(message, checkpoint.retainedMessagePartStarts?.[message.id] ?? 0)).sort((left, right) => Date.parse(left.timestamp) - Date.parse(right.timestamp));
1538
- const projectedRegularMessages = regularMessages.filter((message) => !preservedUserMessageIds.has(message.id) && !retainedMessageIds.has(message.id)).map((message) => projectMessageAfterCheckpoint(message, checkpoint)).filter((message) => Boolean(message)).sort((left, right) => Date.parse(left.timestamp) - Date.parse(right.timestamp));
1619
+ const retainedMessages = regularMessages.filter((message) => retainedMessageIds.has(message.id)).map((message) => sliceMessageParts(message, checkpoint.retainedMessagePartStarts?.[message.id] ?? 0, checkpoint.retainedMessagePartEnds?.[message.id] ?? message.parts.length)).sort((left, right) => Date.parse(left.timestamp) - Date.parse(right.timestamp));
1620
+ const projectedRegularMessages = regularMessages.filter((message) => !preservedUserMessageIds.has(message.id) && (!retainedMessageIds.has(message.id) || checkpoint.retainedMessagePartEnds?.[message.id] !== void 0)).map((message) => projectMessageAfterCheckpoint(message, checkpoint)).filter((message) => Boolean(message)).sort((left, right) => Date.parse(left.timestamp) - Date.parse(right.timestamp));
1539
1621
  const stablePrefixMessages = [
1540
1622
  buildContextCompactionSummaryMessage({
1541
1623
  checkpoint,
@@ -1594,10 +1676,11 @@ function shouldRefreshContextWindowImmediately(event) {
1594
1676
  //#endregion
1595
1677
  //#region src/features/context-compaction/services/context-compaction-preflight.service.ts
1596
1678
  function toCompactionModelMessages(messages, assetStore) {
1597
- return messages.flatMap((message) => ncpMessageToOpenAiMessageGroups(message, { assetStore }).flatMap((group) => group.messages.map((providerMessage) => ({
1679
+ return messages.flatMap((message) => ncpMessageToOpenAiMessageGroups(message, { assetStore }).flatMap((group, index, groups) => group.messages.map((providerMessage) => ({
1598
1680
  ...providerMessage,
1599
1681
  ncp_message_id: message.id,
1600
1682
  ncp_part_start: group.partStart + Number(message.metadata?.["nextclaw_compaction_part_start"] ?? 0),
1683
+ ncp_part_end: (groups[index + 1]?.partStart ?? message.parts.length) + Number(message.metadata?.["nextclaw_compaction_part_start"] ?? 0),
1601
1684
  timestamp: message.timestamp
1602
1685
  }))));
1603
1686
  }
@@ -1739,7 +1822,8 @@ var ContextCompactionPreflightService = class {
1739
1822
  fixedInputTokens,
1740
1823
  preservableUserMessageIds,
1741
1824
  projectedTokenLimit: Math.max(1, budget.triggerTokens - estimateCompactionProjectionOverhead(phase)),
1742
- retainLatestMessage: phase === "pre-run"
1825
+ retainLatestMessage: phase === "pre-run",
1826
+ retainRecentTokens: 2e4
1743
1827
  });
1744
1828
  const coveredSessionMessageCount = plan ? (existingCheckpoint?.coveredSessionMessageCount ?? 0) + plan.coveredMessages.length - (existingCheckpoint ? 1 : 0) : 0;
1745
1829
  const serviceMessageId = createContextCompactionMessageId();
@@ -9042,4 +9126,4 @@ var NextclawHarness = class {
9042
9126
  //#endregion
9043
9127
  export { coalesceSessionJournalDeltas as $, DEFAULT_AGENT_RUNTIME_ENTRY_ID as $t, ContextProviderRunContextService as A, NEXTCLAW_TIMELINE_KIND_METADATA_KEY as At, normalizeOptionalString$2 as B, readLatestContextCompactionCheckpoint as Bt, ToolProviderRunContextService as C, ContextCompactionPreflightService as Ct, readProjectId as D, CONTEXT_COMPACTION_PROJECTION_METADATA_KEY as Dt, createAgentToolRunTriggerInput as E, CONTEXT_COMPACTION_PROJECTION_KIND as Et, CurrentSessionContextProvider as F, isContextCompactionProjectionMessage as Ft, syncSessionThinkingPreference as G, assertObservationJsonValue as Gt, readMetadataThinking as H, shouldRefreshContextWindowImmediately as Ht, AgentBootstrapContextProvider as I, isContextCompactionTimelineMessage as It, describeAgentRuntimeSessionTypes as J, evaluateObservationEventAdmission as Jt, appendCurrentTimeContextTail as K, assertObservationPredicate as Kt, renderAgentBootstrapContext as L, isContextWindowSnapshot as Lt, ExecutionPolicyContextProvider as M, buildContextCompactionTimelineNcpMessage as Mt, renderAgentSafetyContext as N, createContextCompactionMessageId as Nt, readProjectRoot as O, CONTEXT_COMPACTION_SYSTEM_PREAMBLE as Ot, renderSystemExecutionPolicy as P, createContextWindowSignature as Pt, canCoalesceSessionJournalDeltas as Q, toBoundedJson as Qt, truncateContextText as R, readContextCompactionCheckpoint as Rt, AgentManager as S, readEventToolCallId as St, attachSourceToolCall as T, CONTEXT_COMPACTION_PART_START as Tt, resolveEffectiveModel as U, composeAgentToolCatalog as Ut, readMetadataModel as V, shouldRefreshContextWindowDuringStream as Vt, resolveSessionChannelContext as W, ContextCompactionJournalRecoveryService as Wt, resolveAgentRuntimeEntries as X, parseObservationDuration as Xt, normalizeAgentRuntimeSessionTypeIcon as Y, matchesObservationPredicate as Yt, SESSION_JOURNAL_DELTA_MAX_BYTES as Z, readJsonPointer as Zt, createQuestionMessage as _, SessionEventReplayer as _t, dispatchAgentRuntimeSessionRequest as a, applyNcpAgentRunLifecycleEvent as at, SessionManager as b, SessionReplaySupersessionTracker as bt, Contribution$1 as c, NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE as ct, dispatchPromptOverNcpResult as d, isRecord$4 as dt, STRUCTURED_RESULT_TOOL_NAME as en, isSessionJournalDelta as et, startPromptOverNcpExecution as f, normalizeNcpAgentId as ft, USER_QUESTION_EXTENSION_TYPE as g, upsertNcpAgentSessionSummaryEvent as gt, UserQuestionManager as h, toIsoString as ht, createAgentRuntimeSessionRequestSourceNotifier as i, isSessionSettingsError as it, WorkspaceMemoryContextProvider as j, buildContextCompactionModelProjection as jt, buildRunMetadata as k, CONTEXT_COMPACTION_TIMELINE_KIND as kt, NextclawHarnessError as l, createNcpAgentSessionJournalMetadataEntry as lt, UserQuestionError as m, safeNcpSessionFilename as mt, buildSessionRequestCompletionMessage as n, CommandRegistry as nn, SessionSettingsError as nt, waitForAgentRuntimeSessionReply as o, isNcpAgentRunLifecycleEvent as ot, buildAgentRunSendPayload as p, normalizeNcpSessionId as pt, serializeModelInputTail as q, buildObservationEventModelMessage as qt, createAgentRuntimeSessionRequestDispatcher as r, isSessionMessageCursorError as rt, SessionRequestManager as s, NCP_AGENT_SESSION_JOURNAL_INDEX_FILE as st, NextclawHarness as t, AgentRunClient as tn, SessionMessageCursorError as tt, dispatchPromptOverNcp as u, createNcpAgentSessionSummary as ut, createQuestionResolutionMessage as v, readReplayToolOwners as vt, createShowContentTools as w, CONTEXT_COMPACTION_CONTINUATION_TEXT as wt, createWorkspaceByteTools as x, readEventMessageId as xt, projectUserQuestions as y, seedReplayToolOwners as yt, buildNextclawNcpRunContext as z, readContextWindowEventSessionId as zt };
9044
9128
 
9045
- //# sourceMappingURL=nextclaw-harness.manager-toewDc-x.js.map
9129
+ //# sourceMappingURL=nextclaw-harness.manager-DHzYOORP.js.map