@nextclaw/kernel 0.6.20 → 0.6.22

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { AUTOMATIC_UPDATE_CHECK_INTERVAL_MS, getAutomaticUpdateCheckDelay, resolveAutomaticUpdateCheckIntervalMs } from "./utils/automatic-update-check.utils.js";
 import { a as getUnsignedUpdateManifest, c as UpdateBlockReason, d as UpdateStatus, i as UpdateManifestReader, l as UpdateProgress, n as UpdateHostKind, o as serializeUnsignedUpdateManifest, r as UpdateManifest, s as InstallationKind, t as UnsignedUpdateManifest, u as UpdateSnapshot } from "./update-manifest.types-CQpbURTE.js";
-import { BaseChannel, Config, ContextCompactionCheckpoint, ContextCompactionPlan, ContextWindowSnapshot, CreateAgentProfileInput, CreateSessionContextInheritanceInput, CreateSessionInput, CreatedSession, CronService, EffectiveAgentProfile, ExtensionChannelBinding, ExtensionDiagnostic, ExtensionRegistry, ExtensionUiMetadata, GatewayController, InboundAttachment, InboundMessage, LLMProvider, LLMResponse, LLMStreamEvent, MessageBus, ModelThinkingCapability, OutboundMessage, RequestSessionParams, RequestedSkillsMetadataReader, SearchConfig, SessionMessage, SessionRequestDispatcher, SessionRequestRecord, SessionRequestToolResult, SessionSearchService, SkillInfo, SkillInfo as SkillInfo$1, SkillScope, SpawnSessionAndRequestParams, ThinkingLevel, UpdateAgentProfileInput, buildCompressingCompactionCheckpoint, resolveThinkingLevel } from "@nextclaw/core";
+import { BaseChannel, Config, ContextCompactionCheckpoint, ContextCompactionPhase, ContextCompactionPlan, ContextWindowSnapshot, CreateAgentProfileInput, CreateSessionContextInheritanceInput, CreateSessionInput, CreatedSession, CronService, EffectiveAgentProfile, ExtensionChannelBinding, ExtensionDiagnostic, ExtensionRegistry, ExtensionUiMetadata, GatewayController, InboundAttachment, InboundMessage, LLMProvider, LLMResponse, LLMStreamEvent, MessageBus, ModelThinkingCapability, OutboundMessage, ProviderModelDiscoveryResult, RequestSessionParams, RequestedSkillsMetadataReader, SearchConfig, SessionMessage, SessionRequestDispatcher, SessionRequestRecord, SessionRequestToolResult, SessionSearchService, SkillInfo, SkillInfo as SkillInfo$1, SkillScope, SpawnSessionAndRequestParams, ThinkingLevel, UpdateAgentProfileInput, buildCompressingCompactionCheckpoint, resolveThinkingLevel } from "@nextclaw/core";
 import { ListMessagesOptions, ListSessionsOptions, NcpAgentConversationStateManager, NcpAgentRuntime, NcpEndpointEvent, NcpEventType, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessage, NcpMessagePart, NcpRunHandle, NcpSessionApi, NcpSessionMessagePageInfo, NcpSessionPatch, NcpSessionSummary, NcpTool, OpenAIChatChunk } from "@nextclaw/ncp";
-import { LocalAssetStore } from "@nextclaw/ncp-agent-runtime";
 import { AgentRunSendIngressPayload, EventBus, InboxDelivery, InboxDeliveryContentType, InboxDeliveryContinueResult, InboxDeliveryListView, InboxDeliverySource, InboxDeliveryStateAction, Ingress, RuntimeModelSelectionMode, Unsubscribe } from "@nextclaw/shared";
+import { LocalAssetStore } from "@nextclaw/ncp-agent-runtime";
 import { AgentSessionRecord, ChatTarget, NcpReplyInput, RuntimeFactoryParams } from "@nextclaw/ncp-toolkit";
 
 //#region src/features/runtime-registry/utils/agent-runtime-registry.utils.d.ts
@@ -156,8 +156,16 @@ type ProviderConnectionTestInput = {
   maxTokens?: number;
   signal?: AbortSignal;
 };
+type ProviderModelsDiscoverInput = {
+  providerName: string | null;
+  apiKey?: string | null;
+  apiBase?: string | null;
+  extraHeaders?: Record<string, string> | null;
+  signal?: AbortSignal;
+};
 declare class LlmProviderManager {
   private readonly providerRegistry;
+  private readonly providerModelDiscovery;
   private readonly providerPool;
   private readonly missingProvider;
   private config;
@@ -167,10 +175,13 @@ declare class LlmProviderManager {
   readonly chat: (params: ProviderChatParams) => Promise<LLMResponse>;
   readonly chatStream: (this: LlmProviderManager, params: ProviderChatParams) => AsyncGenerator<LLMStreamEvent>;
   readonly testConnection: (input: ProviderConnectionTestInput) => Promise<void>;
+  supportsModelDiscovery: (providerName: string | null) => boolean;
+  discoverModels: (input: ProviderModelsDiscoverInput) => Promise<ProviderModelDiscoveryResult>;
   private resolveRoute;
   private resolveProvider;
   private matchPrefixedProvider;
   private resolveProviderType;
+  private resolveProviderApiKey;
   private rewriteModelForTemplate;
   private normalizeProviderModelConfigForRoute;
   private getOrCreateProvider;
@@ -179,6 +190,53 @@ declare class LlmProviderManager {
   private buildCacheKey;
 }
 //#endregion
+//#region src/managers/provider-model-catalog.manager.d.ts
+declare const PROVIDER_MODEL_CATALOG_REFRESH_INTERVAL_MS: number;
+type ProviderModelCatalogEntry = {
+  providerId: string;
+  models: string[];
+  source: "provider" | "catalog" | null;
+  fetchedAt: string | null;
+  lastError: {
+    message: string;
+    occurredAt: string;
+  } | null;
+};
+type ProviderModelCatalogSnapshot = {
+  refreshIntervalMs: number;
+  refreshing: boolean;
+  lastRefreshStartedAt: string | null;
+  lastRefreshCompletedAt: string | null;
+  providers: Record<string, ProviderModelCatalogEntry>;
+};
+type ProviderModelCatalogManagerOptions = {
+  refreshIntervalMs?: number;
+  providerTimeoutMs?: number;
+  now?: () => Date;
+};
+declare class ProviderModelCatalogManager {
+  private readonly providerManager;
+  private config;
+  private readonly entries;
+  private readonly providerTimeoutMs;
+  private readonly refreshIntervalMs;
+  private readonly now;
+  private refreshTask;
+  private refreshPending;
+  private refreshTimer;
+  private started;
+  private lastRefreshStartedAt;
+  private lastRefreshCompletedAt;
+  constructor(providerManager: Pick<LlmProviderManager, "discoverModels" | "supportsModelDiscovery">, options?: ProviderModelCatalogManagerOptions);
+  load: (config: Config) => void;
+  start: () => void;
+  dispose: () => void;
+  refresh: () => Promise<void>;
+  getSnapshot: () => ProviderModelCatalogSnapshot;
+  private refreshConfiguredProviders;
+  private refreshProvider;
+}
+//#endregion
 //#region src/managers/config.manager.d.ts
 type ConfigManagerRuntimeHooks = {
   resolveChannelConfig?: (config: Config) => Config;
@@ -198,6 +256,7 @@ type ConfigManagerOptions = {
   configPath?: string;
   channels: ChannelManager;
   providerManager: LlmProviderManager;
+  providerModelCatalogManager?: Pick<ProviderModelCatalogManager, "load">;
 };
 type ConfigMutationResult = Record<string, unknown> & {
   ok: boolean;
@@ -274,6 +333,10 @@ declare class AgentManager {
   getAgent: (agentId: string) => EffectiveAgentProfile | null;
   getDefaultAgentId: () => string;
   resolveAgentProfile: (agentId?: string | null) => ResolvedAgentProfile;
+  resolveAgentProfileForContextWindow: (params: {
+    agentId: string;
+    contextTokens: number;
+  }) => ResolvedAgentProfile;
   resolveAgentProfileForRun: (params?: {
     agentId?: string | null;
     requestMetadata?: Record<string, unknown>;
@@ -287,27 +350,6 @@ declare class AgentManager {
   private resolveAgentProfileFromConfig;
 }
 //#endregion
-//#region src/utils/ncp-agent-session-journal.utils.d.ts
-declare const NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE = "session.snapshot.message";
-declare const NCP_SESSION_REQUEST_ACCEPTED_EVENT_TYPE = "session.request.accepted";
-declare const NCP_SESSION_REQUEST_COMPLETED_EVENT_TYPE = "session.request.completed";
-declare const NCP_SESSION_REQUEST_FAILED_EVENT_TYPE = "session.request.failed";
-type NcpAgentSessionSnapshotMessageEvent = {
-  type: typeof NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE;
-  payload: Extract<NcpEndpointEvent, {
-    type: NcpEventType.MessageSent;
-  }>["payload"];
-};
-type NcpSessionRequestJournalEventType = typeof NCP_SESSION_REQUEST_ACCEPTED_EVENT_TYPE | typeof NCP_SESSION_REQUEST_COMPLETED_EVENT_TYPE | typeof NCP_SESSION_REQUEST_FAILED_EVENT_TYPE;
-type NcpSessionRequestJournalEvent = {
-  type: NcpSessionRequestJournalEventType;
-  payload: {
-    sessionId: string;
-    request: unknown;
-  };
-};
-type NcpAgentSessionJournalReplayEvent = NcpEndpointEvent | NcpAgentSessionSnapshotMessageEvent | NcpSessionRequestJournalEvent;
-//#endregion
 //#region src/types/agent-run.types.d.ts
 type ThinkingEffort = string;
 type ContextBlock = string;
@@ -349,6 +391,125 @@ type ToolProvider = {
   provide: (request: AgentRunRequest) => Promise<readonly NcpTool[]> | readonly NcpTool[];
 };
 //#endregion
+//#region src/managers/context-provider.manager.d.ts
+declare class ContextProviderManager {
+  private readonly providers;
+  register: (provider: ContextProvider) => (() => void);
+  buildContext: (request: AgentRunRequest) => Promise<readonly ContextBlock[]>;
+  dispose: () => void;
+}
+//#endregion
+//#region src/managers/tool-provider.manager.d.ts
+type ToolRunContext = {
+  agentId: string;
+  channel: string;
+  chatId: string;
+  config: Config;
+  execTimeoutSeconds: number;
+  handoffDepth: number;
+  metadata: Record<string, unknown>;
+  restrictToWorkspace: boolean;
+  searchConfig: SearchConfig;
+  sessionId: string;
+  workspace: string;
+};
+declare class ToolProviderManager {
+  private readonly providers;
+  register: (provider: ToolProvider) => (() => void);
+  buildTools: (request: AgentRunRequest) => Promise<readonly NcpTool[]>;
+  dispose: () => void;
+}
+//#endregion
+//#region src/managers/agent-context-window.manager.d.ts
+type AgentContextWindowEvaluation = {
+  agentId: string;
+  contextTokens: number;
+  fixedInputTokens: number;
+  minimumContextTokens: number;
+  reservedContextTokens: number;
+};
+type AgentRunSurface = {
+  contextBlocks: readonly string[];
+  tools: readonly NcpTool[];
+};
+declare class AgentContextWindowManager {
+  private readonly agentManager;
+  private readonly contextProviderManager;
+  private readonly toolProviderManager;
+  private readonly runInputBudgetBySession;
+  private readonly preflightService;
+  constructor(agentManager: AgentManager, contextProviderManager: ContextProviderManager, toolProviderManager: ToolProviderManager);
+  resolveRunSurface: (request: AgentRunRequest) => Promise<AgentRunSurface>;
+  forgetSession: (sessionId: string) => void;
+  previewSession: (params: {
+    requestMetadata: Record<string, unknown>;
+    sessionId: string;
+    sessionMessages: readonly NcpMessage[];
+    storedAgentId?: string;
+    storedMetadata: Record<string, unknown>;
+  }) => Promise<ContextWindowSnapshot | null>;
+  assertCanSave: (params: {
+    agentId: string;
+    contextTokens: number;
+  }) => Promise<AgentContextWindowEvaluation>;
+  assertDefaultCanSave: (contextTokens: number) => Promise<AgentContextWindowEvaluation[]>;
+  private createValidationRequest;
+  private estimateFixedInputTokens;
+  private resolveSessionFixedInputTokens;
+  private buildRunSurface;
+  private resolveMinimumContextTokens;
+}
+//#endregion
+//#region src/managers/agent-run-context-compaction.manager.d.ts
+type AgentRunContextCompactionInput = {
+  sessionId: string;
+  agentId: string;
+  contextBlocks: readonly string[];
+  messages: readonly NcpMessage[];
+  metadata: Record<string, unknown>;
+  model: string;
+  phase?: ContextCompactionPhase;
+  signal?: AbortSignal;
+  tools?: readonly NcpTool[];
+};
+declare class AgentRunContextCompactionManager {
+  private readonly preflightService;
+  constructor(agentManager: AgentManager, providerManager: LlmProviderRuntime);
+  runPreflight: (input: AgentRunContextCompactionInput) => AsyncIterable<NcpEndpointEvent>;
+  runManual: (input: AgentRunContextCompactionInput) => Promise<readonly NcpEndpointEvent[]>;
+  private run;
+  private toEvent;
+}
+//#endregion
+//#region src/utils/ncp-agent-session-journal.utils.d.ts
+declare const NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE = "session.snapshot.message";
+declare const NCP_SESSION_REQUEST_ACCEPTED_EVENT_TYPE = "session.request.accepted";
+declare const NCP_SESSION_REQUEST_COMPLETED_EVENT_TYPE = "session.request.completed";
+declare const NCP_SESSION_REQUEST_FAILED_EVENT_TYPE = "session.request.failed";
+type NcpAgentSessionSnapshotMessageEvent = {
+  type: typeof NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE;
+  payload: Extract<NcpEndpointEvent, {
+    type: NcpEventType.MessageSent;
+  }>["payload"];
+};
+type NcpSessionRequestJournalEventType = typeof NCP_SESSION_REQUEST_ACCEPTED_EVENT_TYPE | typeof NCP_SESSION_REQUEST_COMPLETED_EVENT_TYPE | typeof NCP_SESSION_REQUEST_FAILED_EVENT_TYPE;
+type NcpSessionRequestJournalEvent = {
+  type: NcpSessionRequestJournalEventType;
+  payload: {
+    sessionId: string;
+    request: unknown;
+  };
+};
+type NcpAgentSessionJournalReplayEvent = NcpEndpointEvent | NcpAgentSessionSnapshotMessageEvent | NcpSessionRequestJournalEvent;
+//#endregion
+//#region src/utils/ncp-agent-unfinished-run.utils.d.ts
+type UnfinishedNcpAgentRun = {
+  sessionId: string;
+  messageId?: string;
+  runId?: string;
+  startedAt?: string;
+};
+//#endregion
 //#region src/types/session.types.d.ts
 type SessionMessagePage = {
   messages: NcpMessage[];
@@ -408,6 +569,7 @@ declare class NcpAgentSessionJournalStore {
   private readonly writeChains;
   private readonly metadataStore;
   private readonly messageProjectionStore;
+  private readonly unfinishedRunStore;
   private readonly summaryIndexStore;
   constructor(journalDir: string);
   appendSessionEvent: (params: {
@@ -416,6 +578,7 @@ declare class NcpAgentSessionJournalStore {
   }) => Promise<void>;
   getSession: (sessionId: string) => Promise<AgentSessionRecord | null>;
   listSessionSummaries: () => Promise<NcpSessionSummary[]>;
+  listUnfinishedRuns: () => Promise<UnfinishedNcpAgentRun[]>;
   listSessionMessages: (sessionId: string) => Promise<NcpMessage[]>;
   listSessionMessagePage: (params: {
     sessionId: string;
@@ -504,6 +667,7 @@ type CreateNcpSessionInput = CreateSessionInput & {
   sessionId?: string;
 };
 type SessionManagerOptions = {
+  agentContextWindowManager: AgentContextWindowManager;
   agentManager: AgentManager;
   configManager: ConfigManager;
   eventBus: EventBus;
@@ -513,13 +677,10 @@ type SessionManagerOptions = {
 };
 declare class SessionManager implements NcpSessionApi {
   private readonly options;
-  readonly cleanups: Array<() => void>;
-  private readonly contextWindowPreview;
   private readonly eventIngestion;
   private readonly workingDirResolver;
-  private started;
   constructor(options: SessionManagerOptions);
-  start: () => void;
+  start: () => Promise<void>;
   dispose: () => void;
   createSession: (params: CreateNcpSessionInput) => Promise<CreatedSession>;
   appendSessionEvent: (params: {
@@ -547,31 +708,14 @@ declare class SessionManager implements NcpSessionApi {
   getOrCreateAgentRunSession: (params: CreateAgentRunSessionParams) => Promise<AgentRunSession>;
   patchSessionMetadata: (sessionId: string, patch: Record<string, unknown>) => Promise<void>;
   clearSessionMessages: (sessionId: string) => Promise<number>;
+  rewindSessionBeforeMessage: (sessionId: string, messageId: string) => Promise<AgentSessionRecord>;
   publishSessionChange: (sessionKey: string) => Promise<void>;
   private createSummaryFromRecord;
+  private createSummaryWithContextWindow;
   private publishSessionMetadataChanged;
   private applySessionProjectPatch;
 }
 //#endregion
-//#region src/managers/agent-run-context-compaction.manager.d.ts
-type AgentRunContextCompactionInput = {
-  sessionId: string;
-  agentId: string;
-  contextBlocks: readonly string[];
-  messages: readonly NcpMessage[];
-  metadata: Record<string, unknown>;
-  model: string;
-};
-declare class AgentRunContextCompactionManager {
-  private readonly sessionManager;
-  private readonly preflightService;
-  constructor(agentManager: AgentManager, providerManager: LlmProviderRuntime, sessionManager: SessionManager);
-  runPreflight: (input: AgentRunContextCompactionInput) => Promise<readonly NcpEndpointEvent[]>;
-  runManual: (input: AgentRunContextCompactionInput) => Promise<readonly NcpEndpointEvent[]>;
-  private run;
-  private toEvents;
-}
-//#endregion
 //#region src/managers/session-run.manager.d.ts
 type SessionRunQueuedRequest = {
   id: string;
@@ -604,6 +748,7 @@ declare class SessionRun {
     messages: readonly NcpMessage[];
   };
   applyEvents: (events: readonly NcpEndpointEvent[]) => Promise<void>;
+  replaceMessages: (messages: readonly NcpMessage[]) => void;
   onStatusChange: (listener: (status: "idle" | "running") => void) => (() => void);
   enqueueRequest: (request: AgentRunRequest, session: AgentRunSession) => SessionRunQueuedRequest;
   listQueuedRequests: () => readonly SessionRunQueuedRequest[];
@@ -691,56 +836,29 @@ declare class AgentRuntimeManager {
   private disposeAllRuntimes;
 }
 //#endregion
-//#region src/managers/context-provider.manager.d.ts
-declare class ContextProviderManager {
-  private readonly providers;
-  register: (provider: ContextProvider) => (() => void);
-  buildContext: (request: AgentRunRequest) => Promise<readonly ContextBlock[]>;
-  dispose: () => void;
-}
-//#endregion
-//#region src/managers/tool-provider.manager.d.ts
-type ToolRunContext = {
-  agentId: string;
-  channel: string;
-  chatId: string;
-  config: Config;
-  execTimeoutSeconds: number;
-  handoffDepth: number;
-  metadata: Record<string, unknown>;
-  restrictToWorkspace: boolean;
-  searchConfig: SearchConfig;
-  sessionId: string;
-  workspace: string;
-};
-declare class ToolProviderManager {
-  private readonly providers;
-  register: (provider: ToolProvider) => (() => void);
-  buildTools: (request: AgentRunRequest) => Promise<readonly NcpTool[]>;
-  dispose: () => void;
-}
-//#endregion
 //#region src/managers/agent-run-request.manager.d.ts
 declare class AgentRunRequestManager {
   private readonly agentRuntimeManager;
   private readonly agentManager;
   private readonly configManager;
-  private readonly contextProviderManager;
+  private readonly agentContextWindowManager;
   private readonly eventBus;
   private readonly ingress;
   private readonly sessionManager;
   private readonly sessionRunManager;
-  private readonly toolProviderManager;
   readonly cleanups: Array<() => void>;
   private readonly observedSessionRuns;
+  private readonly sessionCommandManager;
   private started;
-  constructor(agentRuntimeManager: AgentRuntimeManager, agentManager: AgentManager, configManager: ConfigManager, contextProviderManager: ContextProviderManager, eventBus: EventBus, ingress: Ingress, sessionManager: SessionManager, sessionRunManager: SessionRunManager, toolProviderManager: ToolProviderManager);
+  constructor(agentRuntimeManager: AgentRuntimeManager, agentManager: AgentManager, configManager: ConfigManager, agentContextWindowManager: AgentContextWindowManager, eventBus: EventBus, ingress: Ingress, sessionManager: SessionManager, sessionRunManager: SessionRunManager);
   start: () => void;
   dispose: () => void;
   listQueuedInputs: (sessionId: string) => readonly SessionQueuedInput[];
   removeQueuedInput: (sessionId: string, queuedInputId: string) => SessionQueuedInput | null;
   private handleSendRequest;
   private handleAbortRequest;
+  private handleEditMessageRequest;
+  private handleContinueRequest;
   private handleSessionMessageRequest;
   private send;
   private startQueuedRun;
@@ -1587,6 +1705,7 @@ declare class NextclawKernel {
   readonly ingress: Ingress;
   readonly messageBus: MessageBus;
   readonly llmProviders: LlmProviderManager;
+  readonly providerModelCatalog: ProviderModelCatalogManager;
   readonly llmUsage: LlmUsageManager;
   readonly configManager: ConfigManager;
   readonly accessManager: AccessManager;
@@ -1607,6 +1726,7 @@ declare class NextclawKernel {
   readonly serviceAppManager: ServiceAppManager;
   readonly extensions: ExtensionManager;
   readonly agentRuntimeManager: AgentRuntimeManager;
+  readonly agentContextWindowManager: AgentContextWindowManager;
   readonly contextCompactionManager: AgentRunContextCompactionManager;
   readonly contextProviderManager: ContextProviderManager;
   readonly sessionRunManager: SessionRunManager;
@@ -1871,23 +1991,19 @@ declare const DEFAULT_SERVICE_ACTION_RISK: ServiceActionRisk;
 declare function buildServiceActionId(appId: string, actionName: string): string;
 declare function getServiceActionName(actionId: string, appId: string): string;
 //#endregion
-//#region src/features/context-compaction/managers/context-compaction.manager.d.ts
-declare class ContextWindowPreviewManager {
-  private readonly preflightService;
-  constructor(agentManager: AgentManager);
-  preview: (params: {
-    requestMetadata: Record<string, unknown>;
-    sessionId: string;
-    sessionMessages: readonly NcpMessage[];
-    storedAgentId?: string;
-    storedMetadata: Record<string, unknown>;
-  }) => ContextWindowSnapshot | null;
+//#region src/features/context-compaction/services/context-compaction-journal-recovery.service.d.ts
+declare class ContextCompactionJournalRecoveryService {
+  private readonly pendingMessageIds;
+  private readonly recoveredTerminals;
+  seed: (messages: readonly NcpMessage[]) => void;
+  track: (event: NcpEndpointEvent) => void;
+  terminalize: (message: NcpMessage) => NcpMessage;
+  private readCheckpoint;
 }
 //#endregion
 //#region src/features/context-compaction/services/context-compaction-preflight.service.d.ts
 type ContextCompactionPreflightResult = {
   contextWindow: ContextWindowSnapshot;
-  metadataPatch: Record<string, unknown>;
   sessionMessages: NcpMessage[];
   timelineMessage: NcpMessage | null;
 };
@@ -1897,13 +2013,21 @@ type ContextCompactionPreflightBeginResult = {
   pendingCompaction: ContextCompactionPendingWork | null;
 };
 type ContextCompactionTrigger = "automatic" | "manual";
+type ContinuationMessageBoundary = {
+  messageId: string;
+  coveredPartCount: number;
+};
 type ContextCompactionPendingWork = {
   checkpoint: ReturnType<typeof buildCompressingCompactionCheckpoint>;
+  contextBlockMessages: Record<string, unknown>[];
+  continuationMessageBoundary: ContinuationMessageBoundary | null;
   contextTokens: number;
+  phase: ContextCompactionPhase;
   serviceMessageId: string;
   model: string;
   plan: ContextCompactionPlan;
   reservedContextTokens: number;
+  snapshotFixedInputTokens: number;
   sessionId: string;
   sessionMessages: NcpMessage[];
 };
@@ -1914,25 +2038,30 @@ declare class ContextCompactionPreflightService {
   private readonly contextWindowBudgetService;
   constructor(agentManager: AgentManager, providerManager?: LlmProviderRuntime | undefined);
   preview: (params: {
+    completeInputBudget?: boolean;
     contextBlocks?: readonly string[];
+    fixedInputTokens?: number;
     requestMetadata: Record<string, unknown>;
     sessionId: string;
     sessionMessages: readonly NcpMessage[];
     storedAgentId?: string;
     storedMetadata: Record<string, unknown>;
+    tools?: readonly NcpTool[];
   }) => ContextWindowSnapshot | null;
   begin: (params: {
     contextBlocks?: readonly string[];
     inputMessages: readonly NcpMessage[];
     model: string;
+    phase?: ContextCompactionPhase;
     requestMetadata: Record<string, unknown>;
     sessionId: string;
     sessionMessages: readonly NcpMessage[];
     storedAgentId?: string;
     storedMetadata: Record<string, unknown>;
+    tools?: readonly NcpTool[];
     trigger?: ContextCompactionTrigger;
   }) => ContextCompactionPreflightBeginResult;
-  finish: (pending: ContextCompactionPendingWork) => Promise<ContextCompactionPreflightResult>;
+  finish: (pending: ContextCompactionPendingWork, signal?: AbortSignal) => Promise<ContextCompactionPreflightResult>;
   private generateSummary;
   private resolveCompactionProfile;
 }
@@ -1942,7 +2071,10 @@ declare const NEXTCLAW_TIMELINE_KIND_METADATA_KEY = "nextclaw_timeline_kind";
 declare const CONTEXT_COMPACTION_TIMELINE_KIND = "context_compaction";
 declare const CONTEXT_COMPACTION_PROJECTION_METADATA_KEY = "nextclaw_context_projection";
 declare const CONTEXT_COMPACTION_PROJECTION_KIND = "compressed_context";
+declare const CONTEXT_COMPACTION_CONTINUATION_TEXT = "Continue the active run from the compressed working context. Do not repeat completed tool calls; proceed with the next required action.";
+declare const CONTEXT_COMPACTION_SYSTEM_PREAMBLE: string;
 type ContextCompactionTimelineCheckpoint = ContextCompactionCheckpoint;
+declare function readContextCompactionCheckpoint(message: NcpMessage): ContextCompactionCheckpoint | null;
 declare function createContextCompactionMessageId(): string;
 declare function buildContextCompactionTimelineNcpMessage(params: {
   messageId: string;
@@ -1956,10 +2088,14 @@ declare function isContextCompactionProjectionMessage(message: {
   metadata?: Record<string, unknown> | undefined;
 } | null | undefined): boolean;
 declare function readLatestContextCompactionCheckpoint(sessionMessages: readonly NcpMessage[]): ContextCompactionCheckpoint | null;
-declare function buildContextCompactionModelInput(params: {
+type ContextCompactionModelProjection = {
+  messages: NcpMessage[];
+  stablePrefixMessageCount: number;
+};
+declare function buildContextCompactionModelProjection(params: {
   sessionId: string;
   sessionMessages: readonly NcpMessage[];
-}): NcpMessage[];
+}): ContextCompactionModelProjection;
 declare function readContextWindowEventSessionId(event: NcpEndpointEvent): string | null;
 declare function isContextWindowSnapshot(value: unknown): value is Record<string, unknown>;
 declare function createContextWindowSignature(value: Record<string, unknown>): string;
@@ -2053,5 +2189,5 @@ declare function resolveLegacyEventType(message: SessionMessage): string;
 declare function getUiContentParamsBootstrapScript(): string;
 declare function injectUiContentParamsBootstrap(html: string): string;
 //#endregion
-export { AUTOMATIC_UPDATE_CHECK_INTERVAL_MS, AccessLoginResult, AccessManager, AccessManagerOptions, AccessPasswordStatus, AccessPrincipal, AccessRole, AccessSessionRecord, AccessSessionState, AgentManager, AgentManagerOptions, AgentRunClient, type AgentRunReply, type AgentRunReplyOptions, AgentRunSession, type AgentRunStreamOptions, AgentRuntimeEntry, AgentRuntimeProviderRegistration, AgentRuntimeSessionRequestDispatcherOptions, AgentRuntimeSessionTypeDescribeParams, AgentRuntimeSessionTypeIcon, AgentRuntimeSessionTypeOption, AgentRuntimeSessionTypeProvider, type AssetApi, AutomationManager, AutomationManagerOptions, type BuildAgentRunSendPayloadParams, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_PROJECTION_KIND, CONTEXT_COMPACTION_PROJECTION_METADATA_KEY, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelManager, ChannelReplyRouterDispatchParams, CommandRegistry, ConfigManager, ConfigManagerOptions, ConfigManagerRuntimeHooks, ConfigMutationResult, ContextCompactionPreflightBeginResult, ContextCompactionPreflightResult, ContextCompactionPreflightService, ContextCompactionTimelineCheckpoint, ContextCompactionTrigger, ContextWindowPreviewManager, CreateAgentRunSessionParams, CreateInboxDeliveryInput, CreateProjectInput, DEFAULT_AGENT_RUNTIME_ENTRY_ID, DEFAULT_SERVICE_ACTION_RISK, DirectPromptDispatchParams, ExtensionLoadProgress, ExtensionLoadResult, ExtensionManager, GatewayInboundLoopRuntime, GatewayInboundProcessor, InboxDeliveryError, InboxDeliveryErrorCode, InboxDeliveryManager, InboxDeliveryManagerOptions, InstallationKind, InstalledSkillDetail, InstalledSkillSummary, InstalledSkillsList, type LearningLoopRuntimeConfig, LlmProviderManager, LlmProviderRuntime, LlmUsageManager, LlmUsageManagerOptions, LlmUsageRecord, LlmUsageSnapshot, LlmUsageStats, LlmUsageStore, LlmUsageStoreOptions, LlmUsageSummary, LocalizedTextMap, MAX_INBOX_DELIVERY_CONTENT_LENGTH, McpManager, McpServiceAppRuntimeService, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NcpAgentSessionJournalStore, NextclawKernel, NextclawKernelOptions, NextclawNcpResolvedAgentProfile, NextclawNcpResolvedRunContext, NextclawNcpRunContextResolveParams, PANEL_APP_AGENT_CAPABILITIES, PROJECT_TEMPLATE_IDS, PanelAppAgentCapability, PanelAppAgentGenerateObjectInput, PanelAppAgentGenerateObjectRequest, PanelAppAgentGenerateObjectResult, PanelAppAgentRunClient, PanelAppAgentSendPayload, PanelAppAgentSendRequest, PanelAppAgentSendResult, PanelAppAssetTokenService, PanelAppBridgeSession, PanelAppCapabilityGrant, PanelAppCapabilityGrantCaller, type PanelAppClientGrant, PanelAppContent, PanelAppDeleteResult, PanelAppEntry, PanelAppError, PanelAppErrorCode, PanelAppList, PanelAppManager, type PanelAppPreferencesUpdate, PreferenceEntry, PreferenceError, PreferenceErrorCode, PreferenceJsonValue, PreferenceManager, PreferenceManagerOptions, ProjectError, ProjectErrorCode, ProjectManager, ProjectManagerOptions, ProjectRecord, ProjectTemplate, ProjectTemplateId, ProviderManagerNcpLLMApi, ResolvedAgentProfile, SERVICE_APP_MANIFEST_FILE_NAME, ServiceAction, ServiceActionCaller, ServiceActionGrant, ServiceActionGrantRequest, ServiceActionGrantState, ServiceActionInvokeRequest, ServiceActionInvokeResult, ServiceActionRisk, ServiceActionRuntimeState, ServiceAppDeleteResult, ServiceAppError, ServiceAppErrorCode, ServiceAppList, ServiceAppManager, ServiceAppManifest, ServiceAppManifestAction, ServiceAppProtocol, ServiceAppRecord, ServiceAppRuntimeStatus, SessionContextCompactionError, SessionContextCompactionErrorCode, SessionContextCompactionManager, SessionContextCompactionResult, SessionManager, SessionManagerOptions, SessionMessageCursorError, SessionMessagePage, type SessionQueuedInput, SessionRequestManager, SessionRequestManagerOptions, SessionSettingsError, SessionSettingsPatch, SkillFrontmatter, type SkillInfo, SkillManager, type SkillScope, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdateProgress, UpdateSnapshot, UpdateStatus, buildAgentRunSendPayload, buildContextCompactionModelInput, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildNextclawNcpRunContext, buildServiceActionId, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextCompactionMessageId, createContextWindowSignature, createLlmUsageRecord, describeAgentRuntimeSessionTypes, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getAutomaticUpdateCheckDelay, getServiceActionName, getServiceAppManifestPath, getUiContentParamsBootstrapScript, getUnsignedUpdateManifest, hasLlmUsageTelemetry, injectUiContentParamsBootstrap, isContextCompactionProjectionMessage, isContextCompactionTimelineMessage, isContextWindowSnapshot, isInboxDeliveryError, isPanelAppAgentCapability, isPanelAppError, isPreferenceError, isProjectError, isReplyCapableChannel, isServiceAppError, isSessionContextCompactionError, isSessionMessageCursorError, isSessionSettingsError, listExtensionChannelIds, listServiceAppManifestActions, mergeServiceAppRuntimeActions, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseServiceAppManifest, parseSkillFrontmatter, readContextWindowEventSessionId, readLatestContextCompactionCheckpoint, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, readServiceAppManifest, resolveAgentRuntimeEntries, resolveAutomaticUpdateCheckIntervalMs, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, waitForAgentRuntimeSessionReply };
+export { AUTOMATIC_UPDATE_CHECK_INTERVAL_MS, AccessLoginResult, AccessManager, AccessManagerOptions, AccessPasswordStatus, AccessPrincipal, AccessRole, AccessSessionRecord, AccessSessionState, AgentManager, AgentManagerOptions, AgentRunClient, type AgentRunReply, type AgentRunReplyOptions, AgentRunSession, type AgentRunStreamOptions, AgentRuntimeEntry, AgentRuntimeProviderRegistration, AgentRuntimeSessionRequestDispatcherOptions, AgentRuntimeSessionTypeDescribeParams, AgentRuntimeSessionTypeIcon, AgentRuntimeSessionTypeOption, AgentRuntimeSessionTypeProvider, type AssetApi, AutomationManager, AutomationManagerOptions, type BuildAgentRunSendPayloadParams, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_CONTINUATION_TEXT, CONTEXT_COMPACTION_PROJECTION_KIND, CONTEXT_COMPACTION_PROJECTION_METADATA_KEY, CONTEXT_COMPACTION_SYSTEM_PREAMBLE, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelManager, ChannelReplyRouterDispatchParams, CommandRegistry, ConfigManager, ConfigManagerOptions, ConfigManagerRuntimeHooks, ConfigMutationResult, ContextCompactionJournalRecoveryService, ContextCompactionModelProjection, ContextCompactionPreflightBeginResult, ContextCompactionPreflightResult, ContextCompactionPreflightService, ContextCompactionTimelineCheckpoint, ContextCompactionTrigger, CreateAgentRunSessionParams, CreateInboxDeliveryInput, CreateProjectInput, DEFAULT_AGENT_RUNTIME_ENTRY_ID, DEFAULT_SERVICE_ACTION_RISK, DirectPromptDispatchParams, ExtensionLoadProgress, ExtensionLoadResult, ExtensionManager, GatewayInboundLoopRuntime, GatewayInboundProcessor, InboxDeliveryError, InboxDeliveryErrorCode, InboxDeliveryManager, InboxDeliveryManagerOptions, InstallationKind, InstalledSkillDetail, InstalledSkillSummary, InstalledSkillsList, type LearningLoopRuntimeConfig, LlmProviderManager, LlmProviderRuntime, LlmUsageManager, LlmUsageManagerOptions, LlmUsageRecord, LlmUsageSnapshot, LlmUsageStats, LlmUsageStore, LlmUsageStoreOptions, LlmUsageSummary, LocalizedTextMap, MAX_INBOX_DELIVERY_CONTENT_LENGTH, McpManager, McpServiceAppRuntimeService, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NcpAgentSessionJournalStore, NextclawKernel, NextclawKernelOptions, NextclawNcpResolvedAgentProfile, NextclawNcpResolvedRunContext, NextclawNcpRunContextResolveParams, PANEL_APP_AGENT_CAPABILITIES, PROJECT_TEMPLATE_IDS, PROVIDER_MODEL_CATALOG_REFRESH_INTERVAL_MS, PanelAppAgentCapability, PanelAppAgentGenerateObjectInput, PanelAppAgentGenerateObjectRequest, PanelAppAgentGenerateObjectResult, PanelAppAgentRunClient, PanelAppAgentSendPayload, PanelAppAgentSendRequest, PanelAppAgentSendResult, PanelAppAssetTokenService, PanelAppBridgeSession, PanelAppCapabilityGrant, PanelAppCapabilityGrantCaller, type PanelAppClientGrant, PanelAppContent, PanelAppDeleteResult, PanelAppEntry, PanelAppError, PanelAppErrorCode, PanelAppList, PanelAppManager, type PanelAppPreferencesUpdate, PreferenceEntry, PreferenceError, PreferenceErrorCode, PreferenceJsonValue, PreferenceManager, PreferenceManagerOptions, ProjectError, ProjectErrorCode, ProjectManager, ProjectManagerOptions, ProjectRecord, ProjectTemplate, ProjectTemplateId, ProviderManagerNcpLLMApi, ProviderModelCatalogEntry, ProviderModelCatalogManager, ProviderModelCatalogSnapshot, ProviderModelsDiscoverInput, ResolvedAgentProfile, SERVICE_APP_MANIFEST_FILE_NAME, ServiceAction, ServiceActionCaller, ServiceActionGrant, ServiceActionGrantRequest, ServiceActionGrantState, ServiceActionInvokeRequest, ServiceActionInvokeResult, ServiceActionRisk, ServiceActionRuntimeState, ServiceAppDeleteResult, ServiceAppError, ServiceAppErrorCode, ServiceAppList, ServiceAppManager, ServiceAppManifest, ServiceAppManifestAction, ServiceAppProtocol, ServiceAppRecord, ServiceAppRuntimeStatus, SessionContextCompactionError, SessionContextCompactionErrorCode, SessionContextCompactionManager, SessionContextCompactionResult, SessionManager, SessionManagerOptions, SessionMessageCursorError, SessionMessagePage, type SessionQueuedInput, SessionRequestManager, SessionRequestManagerOptions, SessionSettingsError, SessionSettingsPatch, SkillFrontmatter, type SkillInfo, SkillManager, type SkillScope, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdateProgress, UpdateSnapshot, UpdateStatus, buildAgentRunSendPayload, buildContextCompactionModelProjection, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildNextclawNcpRunContext, buildServiceActionId, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextCompactionMessageId, createContextWindowSignature, createLlmUsageRecord, describeAgentRuntimeSessionTypes, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getAutomaticUpdateCheckDelay, getServiceActionName, getServiceAppManifestPath, getUiContentParamsBootstrapScript, getUnsignedUpdateManifest, hasLlmUsageTelemetry, injectUiContentParamsBootstrap, isContextCompactionProjectionMessage, isContextCompactionTimelineMessage, isContextWindowSnapshot, isInboxDeliveryError, isPanelAppAgentCapability, isPanelAppError, isPreferenceError, isProjectError, isReplyCapableChannel, isServiceAppError, isSessionContextCompactionError, isSessionMessageCursorError, isSessionSettingsError, listExtensionChannelIds, listServiceAppManifestActions, mergeServiceAppRuntimeActions, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseServiceAppManifest, parseSkillFrontmatter, readContextCompactionCheckpoint, readContextWindowEventSessionId, readLatestContextCompactionCheckpoint, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, readServiceAppManifest, resolveAgentRuntimeEntries, resolveAutomaticUpdateCheckIntervalMs, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, waitForAgentRuntimeSessionReply };
 //# sourceMappingURL=index.d.ts.map