@nextclaw/kernel 0.1.6 → 0.1.7

package/dist/index.d.ts

@@ -888,6 +888,7 @@ declare class NextclawNcpToolRegistry implements NcpToolRegistry {
   private buildToolExecutionContext;
   private registerDefaultTools;
   private registerMessagingTools;
+  private resolveMessageChannels;
   private registerExtensionTools;
   private registerTool;
   private registerAdditionalTools;

package/dist/index.js

@@ -2,7 +2,7 @@ import { n as getUnsignedUpdateManifest, r as serializeUnsignedUpdateManifest, t
 import { AgentRouteResolver, CONTEXT_COMPACTION_METADATA_KEY, ChannelManager, ChannelManager as ChannelManager$1, CommandRegistry, ContextBuilder, ContextCompactionService, ContextWindowBudgetService, CronService, CronTool, DEFAULT_SESSION_SEARCH_LIMIT, DisposableStore, EditFileTool, ExecTool, ExtensionToolAdapter, GatewayTool, InputBudgetPruner, LLMProvider, ListDirTool, LiteLLMProvider, MAX_SESSION_SEARCH_LIMIT, MemoryGetTool, MemorySearchTool, MessageBus, MessageTool, ProviderRegistry, ReadFileTool, RequestedSkillsMetadataReader, SessionManager, SessionRequestManager, SessionSearchManager, SessionsHistoryTool, SessionsListTool, Tool, ToolRegistry, WebFetchTool, WebSearchTool, WriteFileTool, buildCompressingCompactionCheckpoint, buildContextWindowSnapshot, buildMinimalSystemExecutionPrompt, buildReloadPlan, buildToolCatalogEntries, createAssistantStreamDeltaControlMessage, createAssistantStreamResetControlMessage, createToolExecutionContext, createTypingStopControlMessage, diffConfigPaths, ensureDir, expandHome, findEffectiveAgentProfile, getConfigPath, getDataDir, getSessionsPath, getWorkspacePath, loadConfig, parseAgentScopedSessionKey, parseThinkingLevel, readCompressedContextCompactionCheckpoint, readParentSessionId, readSessionProjectRoot, resolveConfigSecrets, resolveDefaultAgentProfileId, resolveProviderRuntime, resolveSessionWorkspacePath, resolveThinkingLevel, toDisposable } from "@nextclaw/core";
 import { EventBus, Ingress, createAppEventKey, createTypedKey, eventKeys } from "@nextclaw/shared";
 import { DefaultNcpAgentRuntime, LocalAssetStore, buildAssetContentPath, buildNcpUserContent, buildOpenAiFunctionTool } from "@nextclaw/ncp-agent-runtime";
-import { NcpEventType, readAssistantReasoningNormalizationMode, readAssistantReasoningNormalizationModeFromMetadata, sanitizeAssistantReplyTags, writeAssistantReasoningNormalizationModeToMetadata } from "@nextclaw/ncp";
+import { NcpEventType, consumeNcpRunHandle, createNcpRunHandle, readAssistantReasoningNormalizationMode, readAssistantReasoningNormalizationModeFromMetadata, sanitizeAssistantReplyTags, writeAssistantReasoningNormalizationModeToMetadata } from "@nextclaw/ncp";
 import { DefaultNcpAgentBackend, DefaultNcpAgentConversationStateManager, createAgentClientFromServer } from "@nextclaw/ncp-toolkit";
 import { basename, delimiter, dirname, join, resolve } from "node:path";
 import { access, appendFile, mkdir, readFile, readdir, unlink, writeFile } from "node:fs/promises";
@@ -2611,7 +2611,7 @@ var NextclawNcpToolRegistry = class {
 	registerMessagingTools = (context) => {
 		const { channel, chatId, metadata } = context;
 		const accountId = readMetadataAccountId(metadata, {});
-		const messageTool = new MessageTool((message) => this.options.bus.publishOutbound(message));
+		const messageTool = new MessageTool((message) => this.options.bus.publishOutbound(message), { resolveChannels: this.resolveMessageChannels });
 		messageTool.setContext(channel, chatId, accountId ?? null);
 		this.registerTool(messageTool);
 		if (this.options.cronService) {
@@ -2620,6 +2620,10 @@ var NextclawNcpToolRegistry = class {
 			this.registerTool(cronTool);
 		}
 	};
+	resolveMessageChannels = () => {
+		const channels = (this.options.getExtensionRegistry?.())?.channels ?? [];
+		return [...new Set(channels.map((registration) => registration.channel.id.trim()).filter(Boolean))].sort();
+	};
 	registerExtensionTools = (context) => {
 		const extensionRegistry = this.options.getExtensionRegistry?.();
 		if (!extensionRegistry || extensionRegistry.tools.length === 0) return;
@@ -3383,35 +3387,39 @@ var AgentRuntimeManager = class {
 			}
 		};
 	};
-	createMaterializingAgentClientEndpoint = (backend) => ({
-		get manifest() {
-			return backend.manifest;
-		},
-		start: backend.start,
-		stop: backend.stop,
-		subscribe: backend.subscribe,
-		stream: async (payload) => {
-			await consumeAgentEvents(backend.stream(payload));
-		},
-		abort: backend.abort,
-		send: async (envelope) => {
-			await consumeAgentEvents(backend.send(this.materializeAgentSendEnvelope(envelope)));
-		},
-		emit: async (event) => {
-			switch (event.type) {
-				case NcpEventType.MessageRequest:
-					await consumeAgentEvents(backend.send(this.materializeAgentSendEnvelope(event.payload)));
-					return;
-				case NcpEventType.MessageStreamRequest:
-					await consumeAgentEvents(backend.stream(event.payload));
-					return;
-				case NcpEventType.MessageAbort:
-					await backend.abort(event.payload);
-					return;
-				default: await backend.emit(event);
+	createMaterializingAgentClientEndpoint = (backend) => {
+		const send = async (envelope) => {
+			const requestEnvelope = this.materializeAgentSendEnvelope(envelope);
+			return await consumeNcpRunHandle(backend.send(requestEnvelope), createNcpRunHandle(requestEnvelope));
+		};
+		return {
+			get manifest() {
+				return backend.manifest;
+			},
+			start: backend.start,
+			stop: backend.stop,
+			subscribe: backend.subscribe,
+			stream: async (payload) => {
+				await consumeAgentEvents(backend.stream(payload));
+			},
+			abort: backend.abort,
+			send,
+			emit: async (event) => {
+				switch (event.type) {
+					case NcpEventType.MessageRequest:
+						await send(event.payload);
+						return;
+					case NcpEventType.MessageStreamRequest:
+						await consumeAgentEvents(backend.stream(event.payload));
+						return;
+					case NcpEventType.MessageAbort:
+						await backend.abort(event.payload);
+						return;
+					default: await backend.emit(event);
+				}
 			}
-		}
-	});
+		};
+	};
 	warmDerivedCapabilities = async () => {
 		this.assertNotDisposed();
 		this.warmupPromise ??= this.runDerivedCapabilityWarmup();
@@ -4349,21 +4357,6 @@ var NcpAgentLegacySessionStore = class {
 			metadata: structuredClone(session.metadata)
 		};
 	};
-	getSessionSummary = (sessionId) => {
-		const session = this.getSession(sessionId);
-		if (!session) return null;
-		const lastMessageAt = session.messages.at(-1)?.timestamp;
-		return {
-			sessionId: session.sessionId,
-			...session.agentId ? { agentId: session.agentId } : {},
-			messageCount: session.messages.length,
-			createdAt: session.createdAt,
-			updatedAt: session.updatedAt,
-			...lastMessageAt ? { lastMessageAt } : {},
-			status: "idle",
-			metadata: session.metadata
-		};
-	};
 	listSessionMessages = (sessionId) => this.getSession(sessionId)?.messages ?? [];
 	listSessionSummaries = () => this.sessionManager.listSessions().map((record) => ({
 		sessionId: record.key,
@@ -4429,7 +4422,6 @@ var NcpAgentSessionStoreAdapter = class {
 		};
 	}
 	getSession = async (sessionId) => await this.options.journalStore?.getSession(sessionId) ?? this.legacyStore.getSession(sessionId);
-	getSessionSummary = async (sessionId) => await this.options.journalStore?.getSessionSummary(sessionId) ?? this.legacyStore.getSessionSummary(sessionId);
 	listSessionMessages = async (sessionId) => {
 		const journalStore = this.options.journalStore;
 		return journalStore && await journalStore.hasSession(sessionId) ? await journalStore.listSessionMessages(sessionId) : this.legacyStore.listSessionMessages(sessionId);
@@ -4561,10 +4553,19 @@ function upsertNcpAgentSessionSummaryEvent(params) {
 }
 async function replayNcpAgentSessionEvents(events) {
 	const stateManager = new DefaultNcpAgentConversationStateManager();
-	for (const event of events) await stateManager.dispatch(event.type === NcpEventType.MessageCompleted ? createCompletedMessageEvent(event) : structuredClone(event));
+	for (const event of events) await stateManager.dispatch(createReplayEvent(event));
 	const snapshot = stateManager.getSnapshot();
 	return [...snapshot.messages.map((message) => structuredClone(message)), ...snapshot.streamingMessage ? [structuredClone(snapshot.streamingMessage)] : []];
 }
+function createReplayEvent(event) {
+	const replayEvent = structuredClone(event);
+	if (replayEvent.type === NcpEventType.MessageCompleted) return {
+		type: NcpEventType.MessageSent,
+		payload: replayEvent.payload
+	};
+	if (replayEvent.type === NcpEventType.MessageSent && replayEvent.payload.message.role === "assistant" && (replayEvent.payload.message.status === "pending" || replayEvent.payload.message.status === "streaming")) replayEvent.payload.message.status = "final";
+	return replayEvent;
+}
 function readNcpSessionSummaryActivityAt(summary) {
 	return summary.lastMessageAt ?? summary.createdAt ?? summary.updatedAt;
 }
@@ -4602,19 +4603,14 @@ function readSummaryLabelFromEvent(event) {
 	if (message?.role !== "user") return null;
 	return resolveAutoSessionLabel([message]);
 }
-function createCompletedMessageEvent(event) {
-	return {
-		type: NcpEventType.MessageSent,
-		payload: {
-			sessionId: event.payload.sessionId,
-			message: structuredClone(event.payload.message),
-			...event.payload.correlationId ? { correlationId: event.payload.correlationId } : {},
-			metadata: event.payload.metadata
-		}
-	};
-}
 //#endregion
 //#region src/stores/ncp-agent-session-journal.store.ts
+function serializeJournalEntry(entry) {
+	const serialized = JSON.stringify(entry);
+	if (!serialized) throw new Error("ncp agent session journal entry serialization produced empty output");
+	if (!isRecord$1(JSON.parse(serialized))) throw new Error("ncp agent session journal entry serialization produced a non-object entry");
+	return serialized;
+}
 var NcpAgentSessionJournalStore = class {
 	sessions = /* @__PURE__ */ new Map();
 	nextSeqBySession = /* @__PURE__ */ new Map();
@@ -4646,14 +4642,6 @@ var NcpAgentSessionJournalStore = class {
 		this.sessions.set(normalizedSessionId, loaded);
 		return structuredClone(loaded.record);
 	};
-	getSessionSummary = async (sessionId) => {
-		const normalizedSessionId = normalizeNcpSessionId(sessionId);
-		if (!normalizedSessionId) return null;
-		const indexed = (await this.loadSummaryIndex()).get(normalizedSessionId);
-		if (indexed) return structuredClone(indexed);
-		const record = await this.getSession(normalizedSessionId);
-		return record ? createNcpAgentSessionSummary(record) : null;
-	};
 	listSessionSummaries = async () => {
 		return [...(await this.loadSummaryIndex()).values()].map((summary) => structuredClone(summary)).sort((left, right) => readNcpSessionSummaryActivityAt(right).localeCompare(readNcpSessionSummaryActivityAt(left)));
 	};
@@ -4682,7 +4670,7 @@ var NcpAgentSessionJournalStore = class {
 				}
 			}
 		}))];
-		await writeFile(this.sessionPath(sessionId), `${entries.map((entry) => JSON.stringify(entry)).join("\n")}\n`, "utf-8");
+		await writeFile(this.sessionPath(sessionId), `${entries.map(serializeJournalEntry).join("\n")}\n`, "utf-8");
 		const nextSeq = nextRecord.messages.length + 1;
 		this.sessions.set(sessionId, {
 			record: nextRecord,
@@ -4716,7 +4704,7 @@ var NcpAgentSessionJournalStore = class {
 		const hasJournal = Boolean(existing) || this.nextSeqBySession.has(sessionId);
 		const nextSeq = this.nextSeqBySession.get(sessionId) ?? existing?.nextSeq ?? 1;
 		const path = this.sessionPath(sessionId);
-		if (!hasJournal) await appendFile(path, `${JSON.stringify(createNcpAgentSessionJournalMetadataEntry(session))}\n`, "utf-8");
+		if (!hasJournal) await this.appendJournalEntry(path, createNcpAgentSessionJournalMetadataEntry(session));
 		const entry = {
 			_type: "event",
 			version: 1,
@@ -4724,7 +4712,7 @@ var NcpAgentSessionJournalStore = class {
 			timestamp: updatedAt,
 			event: structuredClone(event)
 		};
-		await appendFile(path, `${JSON.stringify(entry)}\n`, "utf-8");
+		await this.appendJournalEntry(path, entry);
 		this.nextSeqBySession.set(sessionId, nextSeq + 1);
 		this.sessions.delete(sessionId);
 		await this.upsertSummaryIndexForEvent({
@@ -4763,9 +4751,15 @@ var NcpAgentSessionJournalStore = class {
 		let updatedAt = createdAt;
 		let nextSeq = 1;
 		const events = [];
-		for (const line of raw.split("\n")) {
+		for (const [index, line] of raw.split("\n").entries()) {
 			if (!line.trim()) continue;
-			const parsed = JSON.parse(line);
+			let parsed;
+			try {
+				parsed = JSON.parse(line);
+			} catch (error) {
+				console.warn(`[ncp-agent-session-journal] skipped corrupted journal line ${index + 1}: ${error instanceof Error ? error.message : String(error)}`);
+				continue;
+			}
 			if (!isRecord$1(parsed)) continue;
 			if (parsed._type === "metadata") {
 				metadata = isRecord$1(parsed.metadata) ? structuredClone(parsed.metadata) : {};
@@ -4790,6 +4784,9 @@ var NcpAgentSessionJournalStore = class {
 			events
 		};
 	};
+	appendJournalEntry = async (path, entry) => {
+		await appendFile(path, `${serializeJournalEntry(entry)}\n`, "utf-8");
+	};
 	loadSummaryIndex = async () => {
 		if (this.summaryIndex) return this.summaryIndex;
 		try {
@@ -4858,6 +4855,116 @@ var NcpAgentSessionJournalStore = class {
 	indexPath = () => resolve(this.journalDir, NCP_AGENT_SESSION_JOURNAL_INDEX_FILE);
 };
 //#endregion
+//#region src/contributions/session-context-window/index.ts
+const STREAM_REFRESH_DELAY_MS = 1500;
+function formatBackgroundError$1(error) {
+	if (error instanceof Error) return error.stack ?? error.message;
+	return String(error);
+}
+function readEventSessionId(event) {
+	const payload = "payload" in event ? event.payload : null;
+	if (!payload || typeof payload !== "object") return null;
+	return "sessionId" in payload && typeof payload.sessionId === "string" ? payload.sessionId.trim() || null : null;
+}
+function isContextWindow(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function createSignature(value) {
+	return JSON.stringify(value);
+}
+function shouldRefreshDuringStream(event) {
+	switch (event.type) {
+		case NcpEventType.MessageTextDelta:
+		case NcpEventType.MessageReasoningDelta:
+		case NcpEventType.MessageToolCallArgsDelta:
+		case NcpEventType.MessageToolCallResult: return true;
+		default: return false;
+	}
+}
+function shouldRefreshImmediately(event) {
+	switch (event.type) {
+		case NcpEventType.MessageCompleted:
+		case NcpEventType.MessageFailed:
+		case NcpEventType.MessageAbort:
+		case NcpEventType.RunFinished:
+		case NcpEventType.RunError: return true;
+		default: return false;
+	}
+}
+var SessionContextWindowContribution = class {
+	unsubscribeNcpEvent = null;
+	stopped = true;
+	pendingTimers = /* @__PURE__ */ new Map();
+	lastPublishedSignatureBySession = /* @__PURE__ */ new Map();
+	constructor(kernel) {
+		this.kernel = kernel;
+	}
+	start = () => {
+		if (this.unsubscribeNcpEvent) return;
+		this.stopped = false;
+		this.unsubscribeNcpEvent = this.kernel.eventBus.on(eventKeys.ncpEvent, this.handleNcpEvent);
+	};
+	dispose = () => {
+		this.unsubscribeNcpEvent?.();
+		this.unsubscribeNcpEvent = null;
+		this.stopped = true;
+		for (const timer of this.pendingTimers.values()) clearTimeout(timer);
+		this.pendingTimers.clear();
+		this.lastPublishedSignatureBySession.clear();
+	};
+	handleNcpEvent = (event) => {
+		const sessionId = readEventSessionId(event);
+		if (!sessionId) return;
+		if (event.type === NcpEventType.ContextWindowUpdated) {
+			this.rememberPublishedContextWindow(sessionId, event.payload.contextWindow);
+			return;
+		}
+		if (shouldRefreshImmediately(event)) {
+			this.refreshNow(sessionId);
+			return;
+		}
+		if (shouldRefreshDuringStream(event)) this.refreshSoon(sessionId);
+	};
+	refreshSoon = (sessionId) => {
+		if (this.pendingTimers.has(sessionId)) return;
+		const timer = setTimeout(() => {
+			this.pendingTimers.delete(sessionId);
+			this.refreshNow(sessionId);
+		}, STREAM_REFRESH_DELAY_MS);
+		this.pendingTimers.set(sessionId, timer);
+	};
+	refreshNow = (sessionId) => {
+		const timer = this.pendingTimers.get(sessionId);
+		if (timer) {
+			clearTimeout(timer);
+			this.pendingTimers.delete(sessionId);
+		}
+		this.publishContextWindow(sessionId).catch((error) => {
+			console.error(`[session-context-window] failed to refresh ${sessionId}: ${formatBackgroundError$1(error)}`);
+		});
+	};
+	publishContextWindow = async (sessionId) => {
+		if (this.stopped) return;
+		const contextWindow = (await this.kernel.ncpSessionApi.getSession(sessionId))?.contextWindow;
+		if (!isContextWindow(contextWindow) || this.stopped) return;
+		const endpoint = this.kernel.agentRuntimeManager.currentHandle?.agentClientEndpoint;
+		if (!endpoint) return;
+		const signature = createSignature(contextWindow);
+		if (this.lastPublishedSignatureBySession.get(sessionId) === signature) return;
+		this.lastPublishedSignatureBySession.set(sessionId, signature);
+		await endpoint.emit({
+			type: NcpEventType.ContextWindowUpdated,
+			payload: {
+				sessionId,
+				contextWindow
+			}
+		});
+	};
+	rememberPublishedContextWindow = (sessionId, contextWindow) => {
+		this.lastPublishedSignatureBySession.set(sessionId, createSignature(contextWindow));
+	};
+};
+//#endregion
 //#region src/contributions/session-activity-preview/utils/session-activity-preview-ncp-event.utils.ts
 const PREVIEW_TEXT_MAX_LENGTH = 160;
 function readSessionId(value) {
@@ -5159,7 +5266,7 @@ var NextclawKernel = class {
 			sessionRequester: this.sessionRequests,
 			resolveLearningLoopConfig: () => readLearningLoopRuntimeConfig(this.configManager.loadConfig())
 		});
-		this.contributions = [new SessionActivityPreviewContribution(this)];
+		this.contributions = [new SessionActivityPreviewContribution(this), new SessionContextWindowContribution(this)];
 	}
 	start = async () => {
 		this.ncpSessionApi.start();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/kernel",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "private": false,
   "description": "NextClaw product kernel skeleton for agents, tasks, sessions, context, tools, skills, providers, automation, and channels.",
   "type": "module",
@@ -20,19 +20,19 @@
     "dist"
   ],
   "dependencies": {
-    "@nextclaw/core": "0.12.17",
-    "@nextclaw/mcp": "0.1.82",
-    "@nextclaw/ncp-agent-runtime": "0.3.20",
-    "@nextclaw/ncp-http-agent-server": "0.3.22",
-    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.9",
-    "@nextclaw/ncp-toolkit": "0.5.15",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.9",
-    "@nextclaw/openclaw-compat": "1.0.17",
-    "@nextclaw/runtime": "0.2.49",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.10",
-    "@nextclaw/shared": "0.1.4",
-    "@nextclaw/ncp": "0.5.10",
-    "@nextclaw/ncp-mcp": "0.1.84"
+    "@nextclaw/core": "0.12.18",
+    "@nextclaw/ncp-http-agent-server": "0.3.23",
+    "@nextclaw/mcp": "0.1.83",
+    "@nextclaw/ncp-agent-runtime": "0.3.21",
+    "@nextclaw/ncp-mcp": "0.1.85",
+    "@nextclaw/ncp-toolkit": "0.5.16",
+    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.10",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.11",
+    "@nextclaw/ncp": "0.5.11",
+    "@nextclaw/openclaw-compat": "1.0.18",
+    "@nextclaw/runtime": "0.2.50",
+    "@nextclaw/shared": "0.1.5",
+    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.10"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",