@nextclaw/kernel 0.1.5 → 0.1.6

package/dist/index.d.ts

@@ -494,6 +494,7 @@ declare class AgentRuntimeManager {
   private disposed;
   constructor(params: AgentRuntimeManagerOptions);
   get currentHandle(): AgentRuntimeHandle | null;
+  isLiveSessionRunning: (sessionId: string) => boolean;
   connectGatewayController: (gatewayController: GatewayController) => void;
   bootstrap: () => Promise<AgentRuntimeHandle>;
   private readonly materializeAgentSendEnvelope;
@@ -663,6 +664,7 @@ type NcpAgentSessionReadableStore = AgentSessionStore & {
 type NcpSessionApiServiceOptions = {
   eventBus: EventBus;
   getConfig: () => Config;
+  isLiveSessionRunning?: (sessionId: string) => boolean;
   ncpAgentSessionStore?: NcpAgentSessionReadableStore;
   sessionManager: SessionManager;
 };
@@ -679,6 +681,7 @@ declare class NcpSessionApiService implements NcpSessionApi {
   getSession: (sessionId: string) => Promise<NcpSessionSummary | null>;
   updateSession: (sessionId: string, patch: NcpSessionPatch) => Promise<NcpSessionSummary | null>;
   deleteSession: (sessionId: string) => Promise<void>;
+  private withLiveSessionStatus;
 }
 //#endregion
 //#region src/app/nextclaw-kernel.d.ts
@@ -722,7 +725,7 @@ declare class NextclawKernel {
   private readonly sessionLifecycleEvents;
   private readonly ncpAgentSessionStore;
   private readonly ncpAgentSessionJournalStore;
-  private startPromise;
+  private readonly contributions;
   constructor(options?: NextclawKernelOptions);
   start: () => Promise<void>;
   dispose: () => Promise<void>;

package/dist/index.js

@@ -625,11 +625,11 @@ function normalizeString(value) {
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : null;
 }
-function isRecord$4(value) {
+function isRecord$5(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function cloneMetadata(value) {
-	return isRecord$4(value) ? structuredClone(value) : void 0;
+	return isRecord$5(value) ? structuredClone(value) : void 0;
 }
 function readStringArray(value) {
 	if (!Array.isArray(value)) return null;
@@ -1876,7 +1876,7 @@ var LlmUsageManager = class {
 };
 //#endregion
 //#region src/tools/session-search.tools.ts
-function isRecord$3(value) {
+function isRecord$4(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function readOptionalInteger(value) {
@@ -1926,7 +1926,7 @@ var SessionSearchTool = class {
 		return issues;
 	};
 	execute = async (args) => {
-		if (!isRecord$3(args)) throw new Error("session_search requires an object argument.");
+		if (!isRecord$4(args)) throw new Error("session_search requires an object argument.");
 		const issues = this.validateArgs(args);
 		if (issues.length > 0) throw new Error(issues.join(" "));
 		return this.queryService.search({
@@ -1939,13 +1939,13 @@ var SessionSearchTool = class {
 };
 //#endregion
 //#region src/features/native-runtime/tools/ncp-asset.tools.ts
-function readOptionalString$3(value) {
+function readOptionalString$4(value) {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : null;
 }
 function readOptionalBase64Bytes(value) {
-	const base64 = readOptionalString$3(value);
+	const base64 = readOptionalString$4(value);
 	if (!base64) return null;
 	try {
 		return Buffer.from(base64, "base64");
@@ -1996,18 +1996,18 @@ var AssetPutTool = class {
 		this.contentBasePath = contentBasePath;
 	}
 	validateArgs = (args) => {
-		const path = readOptionalString$3(args.path);
-		const bytesBase64 = readOptionalString$3(args.bytesBase64);
-		const fileName = readOptionalString$3(args.fileName);
+		const path = readOptionalString$4(args.path);
+		const bytesBase64 = readOptionalString$4(args.bytesBase64);
+		const fileName = readOptionalString$4(args.fileName);
 		if (path && bytesBase64) return ["Provide either path, or bytesBase64 + fileName, not both."];
 		if (path) return [];
 		if (bytesBase64) return fileName ? [] : ["fileName is required when using bytesBase64."];
 		return ["Provide either path, or bytesBase64 + fileName."];
 	};
 	execute = async (args) => {
-		const path = readOptionalString$3(args?.path);
-		const fileName = readOptionalString$3(args?.fileName);
-		const mimeType = readOptionalString$3(args?.mimeType);
+		const path = readOptionalString$4(args?.path);
+		const fileName = readOptionalString$4(args?.fileName);
+		const mimeType = readOptionalString$4(args?.mimeType);
 		const bytes = readOptionalBase64Bytes(args?.bytesBase64);
 		if (path) return {
 			ok: true,
@@ -2050,8 +2050,8 @@ var AssetExportTool = class {
 		this.assetStore = assetStore;
 	}
 	execute = async (args) => {
-		const assetUri = readOptionalString$3(args?.assetUri);
-		const targetPath = readOptionalString$3(args?.targetPath);
+		const assetUri = readOptionalString$4(args?.assetUri);
+		const targetPath = readOptionalString$4(args?.targetPath);
 		if (!assetUri || !targetPath) throw new Error("asset_export requires assetUri and targetPath.");
 		return {
 			ok: true,
@@ -2077,7 +2077,7 @@ var AssetStatTool = class {
 		this.contentBasePath = contentBasePath;
 	}
 	execute = async (args) => {
-		const assetUri = readOptionalString$3(args?.assetUri);
+		const assetUri = readOptionalString$4(args?.assetUri);
 		if (!assetUri) throw new Error("asset_stat requires assetUri.");
 		const record = await this.assetStore.statRecord(assetUri);
 		if (!record) return {
@@ -2252,7 +2252,7 @@ function readRequiredString$1(params, key) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new Error(`${key} must be a non-empty string.`);
 	return value.trim();
 }
-function readOptionalString$2(params, key) {
+function readOptionalString$3(params, key) {
 	const value = params[key];
 	if (typeof value !== "string") return;
 	const trimmed = value.trim();
@@ -2313,7 +2313,7 @@ var SessionRequestTool = class extends Tool {
 		const target = params.target;
 		if (!target || typeof target !== "object" || Array.isArray(target)) throw new Error("target must be an object.");
 		const task = readRequiredString$1(params, "task");
-		const notifyMode = readOptionalString$2(params, "notify")?.toLowerCase();
+		const notifyMode = readOptionalString$3(params, "notify")?.toLowerCase();
 		if (notifyMode !== "none" && notifyMode !== "final_reply") throw new Error("notify must be \"none\" or \"final_reply\".");
 		const { toolCallId, updateToolCallResult } = context;
 		return this.manager.requestSession({
@@ -2322,7 +2322,7 @@ var SessionRequestTool = class extends Tool {
 			updateToolCallResult,
 			targetSessionId: readRequiredString$1(target, "session_id"),
 			task,
-			title: readOptionalString$2(params, "title"),
+			title: readOptionalString$3(params, "title"),
 			notify: notifyMode,
 			handoffDepth: this.handoffDepth
 		});
@@ -2334,13 +2334,13 @@ function readRequiredString(value, key) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new Error(`${key} must be a non-empty string.`);
 	return value.trim();
 }
-function readOptionalString$1(value) {
+function readOptionalString$2(value) {
 	if (typeof value !== "string") return;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : void 0;
 }
 function readSpawnScope(value) {
-	const normalized = readOptionalString$1(value)?.toLowerCase();
+	const normalized = readOptionalString$2(value)?.toLowerCase();
 	if (!normalized || normalized === "standalone") return "standalone";
 	if (normalized === "child") return "child";
 	throw new Error("scope must be \"standalone\" or \"child\".");
@@ -2348,7 +2348,7 @@ function readSpawnScope(value) {
 function readSpawnRequestOptions(value) {
 	if (typeof value === "undefined") return;
 	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("request must be an object.");
-	const notifyMode = readOptionalString$1(value.notify)?.toLowerCase();
+	const notifyMode = readOptionalString$2(value.notify)?.toLowerCase();
 	if (notifyMode === "none" || notifyMode === "final_reply") return { notify: notifyMode };
 	throw new Error("request.notify must be \"none\" or \"final_reply\".");
 }
@@ -2429,10 +2429,10 @@ var SessionSpawnTool = class extends Tool {
 			updateToolCallResult,
 			sourceSessionMetadata: this.sourceSessionMetadata,
 			task,
-			title: readOptionalString$1(rawTitle),
-			agentId: readOptionalString$1(rawAgentId),
-			model: readOptionalString$1(rawModel),
-			runtime: readOptionalString$1(rawRuntime),
+			title: readOptionalString$2(rawTitle),
+			agentId: readOptionalString$2(rawAgentId),
+			model: readOptionalString$2(rawModel),
+			runtime: readOptionalString$2(rawRuntime),
 			handoffDepth: this.handoffDepth,
 			...parentSessionId ? { parentSessionId } : {},
 			notify: request.notify
@@ -2440,11 +2440,11 @@ var SessionSpawnTool = class extends Tool {
 		const session = this.sessionManager.createSession({
 			sourceSessionId: this.sourceSessionId,
 			task,
-			title: readOptionalString$1(rawTitle),
+			title: readOptionalString$2(rawTitle),
 			sourceSessionMetadata: this.sourceSessionMetadata,
-			agentId: readOptionalString$1(rawAgentId),
-			model: readOptionalString$1(rawModel),
-			runtime: readOptionalString$1(rawRuntime),
+			agentId: readOptionalString$2(rawAgentId),
+			model: readOptionalString$2(rawModel),
+			runtime: readOptionalString$2(rawRuntime),
 			...parentSessionId ? { parentSessionId } : {}
 		});
 		this.onSessionUpdated?.(session.sessionId);
@@ -2469,10 +2469,10 @@ var SessionSpawnTool = class extends Tool {
 //#endregion
 //#region src/features/native-runtime/services/nextclaw-ncp-tool-registry.service.ts
 function toToolParams(args) {
-	if (isRecord$4(args)) return args;
+	if (isRecord$5(args)) return args;
 	if (typeof args === "string") try {
 		const parsed = JSON.parse(args);
-		return isRecord$4(parsed) ? parsed : {};
+		return isRecord$5(parsed) ? parsed : {};
 	} catch {
 		return {};
 	}
@@ -2664,14 +2664,14 @@ function readAccountIdForHints(metadata, sessionMetadata) {
 //#endregion
 //#region src/features/native-runtime/services/nextclaw-ncp-context-builder.service.ts
 const TIME_HINT_TRIGGER_PATTERNS = [/\b(now|right now|current time|what time|today|tonight|tomorrow|yesterday|this morning|this afternoon|this evening|date)\b/i, /(现在|此刻|当前时间|现在几点|几点了|今天|今晚|今早|今晨|明天|昨天|日期)/];
-function isRecord$2(value) {
+function isRecord$3(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function mergeInputMetadata(input) {
-	const messageMetadata = input.messages.slice().reverse().find((message) => isRecord$2(message.metadata))?.metadata;
+	const messageMetadata = input.messages.slice().reverse().find((message) => isRecord$3(message.metadata))?.metadata;
 	return {
-		...isRecord$2(messageMetadata) ? structuredClone(messageMetadata) : {},
-		...isRecord$2(input.metadata) ? structuredClone(input.metadata) : {}
+		...isRecord$3(messageMetadata) ? structuredClone(messageMetadata) : {},
+		...isRecord$3(input.metadata) ? structuredClone(input.metadata) : {}
 	};
 }
 const REQUESTED_SKILLS_METADATA_READER = new RequestedSkillsMetadataReader();
@@ -2978,12 +2978,12 @@ function createContextWindowUpdatedEvent(params) {
 		}
 	};
 }
-function isRecord$1(value) {
+function isRecord$2(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function resolveNativeReasoningNormalizationMode(params) {
 	const runtimeEntry = params.config.agents.runtimes.entries.native?.config ?? params.config.ui.ncp.runtimes.native;
-	const runtimeMetadata = isRecord$1(runtimeEntry) ? runtimeEntry : {};
+	const runtimeMetadata = isRecord$2(runtimeEntry) ? runtimeEntry : {};
 	return readAssistantReasoningNormalizationModeFromMetadata(params.sessionMetadata) ?? readAssistantReasoningNormalizationMode(runtimeMetadata.reasoningNormalization) ?? readAssistantReasoningNormalizationMode(runtimeMetadata.reasoning_normalization) ?? readAssistantReasoningNormalizationMode(runtimeMetadata.reasoningNormalizationMode) ?? readAssistantReasoningNormalizationMode(runtimeMetadata.reasoning_normalization_mode) ?? "think-tags";
 }
 function createSessionSearchTools(params) {
@@ -3240,7 +3240,7 @@ function createAgentRuntimeSessionRequestDispatcher(options) {
 }
 //#endregion
 //#region src/managers/agent-runtime.manager.ts
-function readOptionalString(value) {
+function readOptionalString$1(value) {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : null;
@@ -3251,7 +3251,7 @@ function readMessageTask(message) {
 }
 function readSessionMetadataString(metadata, ...keys) {
 	for (const key of keys) {
-		const value = readOptionalString(metadata?.[key]);
+		const value = readOptionalString$1(metadata?.[key]);
 		if (value) return value;
 	}
 }
@@ -3286,6 +3286,7 @@ var AgentRuntimeManager = class {
 	get currentHandle() {
 		return this.handle;
 	}
+	isLiveSessionRunning = (sessionId) => this.backend?.isLiveSessionRunning(sessionId) ?? false;
 	connectGatewayController = (gatewayController) => {
 		this.assertNotDisposed();
 		this.gatewayController = gatewayController;
@@ -3350,7 +3351,7 @@ var AgentRuntimeManager = class {
 		return this.handle;
 	};
 	materializeAgentSendEnvelope = (envelope) => {
-		const existingSessionId = readOptionalString(envelope.sessionId) ?? readOptionalString(envelope.message.sessionId);
+		const existingSessionId = readOptionalString$1(envelope.sessionId) ?? readOptionalString$1(envelope.message.sessionId);
 		if (existingSessionId) return {
 			...envelope,
 			sessionId: existingSessionId,
@@ -4182,13 +4183,6 @@ function buildUpdatedMetadata(params) {
 function normalizeSessionId(sessionId) {
 	return sessionId.trim();
 }
-function toSessionCandidate(record) {
-	const sessionId = normalizeSessionId(record.key);
-	return sessionId ? {
-		...record,
-		sessionId
-	} : null;
-}
 function createSessionListSummary(record) {
 	return {
 		sessionId: record.sessionId,
@@ -4201,9 +4195,6 @@ function createSessionListSummary(record) {
 		metadata: structuredClone(record.metadata)
 	};
 }
-function readSessionActivityAt$1(record) {
-	return record.lastMessageAt ?? record.created_at;
-}
 var NcpSessionApiService = class {
 	unsubscribeSessionUpdated = null;
 	contextWindowPreview;
@@ -4237,8 +4228,11 @@ var NcpSessionApiService = class {
 		this.options.eventBus.emit(eventKeys.sessionSummaryDelete, { sessionKey: normalizedSessionKey });
 	};
 	listSessions = async (options) => {
-		if (this.options.ncpAgentSessionStore?.listSessionSummaries) return applyLimit(await this.options.ncpAgentSessionStore.listSessionSummaries(), options?.limit);
-		return applyLimit(this.options.sessionManager.listSessions().map(toSessionCandidate).filter((record) => Boolean(record)).sort((left, right) => readSessionActivityAt$1(right).localeCompare(readSessionActivityAt$1(left))), options?.limit).map(createSessionListSummary);
+		if (this.options.ncpAgentSessionStore?.listSessionSummaries) return applyLimit(await this.options.ncpAgentSessionStore.listSessionSummaries(), options?.limit).map(this.withLiveSessionStatus);
+		return applyLimit(this.options.sessionManager.listSessions().map((record) => ({
+			...record,
+			sessionId: normalizeSessionId(record.key)
+		})).filter((record) => Boolean(record)).sort((left, right) => (right.lastMessageAt ?? right.created_at).localeCompare(left.lastMessageAt ?? left.created_at)), options?.limit).map(createSessionListSummary).map(this.withLiveSessionStatus);
 	};
 	listSessionMessages = async (sessionId, options) => {
 		const normalizedSessionId = normalizeSessionId(sessionId);
@@ -4251,7 +4245,7 @@ var NcpSessionApiService = class {
 		const normalizedSessionId = normalizeSessionId(sessionId);
 		if (normalizedSessionId && this.options.ncpAgentSessionStore?.getSession) {
 			const record = await this.options.ncpAgentSessionStore.getSession(normalizedSessionId);
-			if (record) return createNcpSessionSummary({
+			if (record) return this.withLiveSessionStatus(createNcpSessionSummary({
 				sessionId: normalizedSessionId,
 				agentId: record.agentId,
 				messages: record.messages,
@@ -4265,12 +4259,12 @@ var NcpSessionApiService = class {
 					sessionId: normalizedSessionId,
 					sessionMessages: record.messages
 				})
-			});
+			}));
 		}
 		const session = normalizedSessionId ? this.options.sessionManager.getIfExists(normalizedSessionId) : null;
 		if (!session) return null;
 		const messages = toNcpMessages(normalizedSessionId, session.messages);
-		return createNcpSessionSummary({
+		return this.withLiveSessionStatus(createNcpSessionSummary({
 			sessionId: normalizedSessionId,
 			agentId: session.agentId,
 			messages,
@@ -4284,7 +4278,7 @@ var NcpSessionApiService = class {
 				sessionId: normalizedSessionId,
 				sessionMessages: messages
 			})
-		});
+		}));
 	};
 	updateSession = async (sessionId, patch) => {
 		const normalizedSessionId = normalizeSessionId(sessionId);
@@ -4321,6 +4315,10 @@ var NcpSessionApiService = class {
 		this.options.sessionManager.delete(normalizedSessionId);
 		await this.publishSessionChange(normalizedSessionId);
 	};
+	withLiveSessionStatus = (summary) => this.options.isLiveSessionRunning?.(summary.sessionId) ? {
+		...summary,
+		status: "running"
+	} : summary;
 };
 //#endregion
 //#region src/utils/ncp-session-metadata.utils.ts
@@ -4505,7 +4503,7 @@ function normalizeNcpAgentId(agentId) {
 	const normalized = agentId?.trim().toLowerCase();
 	return normalized ? normalized : void 0;
 }
-function isRecord(value) {
+function isRecord$1(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function toIsoString(value, fallback) {
@@ -4768,15 +4766,15 @@ var NcpAgentSessionJournalStore = class {
 		for (const line of raw.split("\n")) {
 			if (!line.trim()) continue;
 			const parsed = JSON.parse(line);
-			if (!isRecord(parsed)) continue;
+			if (!isRecord$1(parsed)) continue;
 			if (parsed._type === "metadata") {
-				metadata = isRecord(parsed.metadata) ? structuredClone(parsed.metadata) : {};
+				metadata = isRecord$1(parsed.metadata) ? structuredClone(parsed.metadata) : {};
 				agentId = normalizeNcpAgentId(typeof parsed.agent_id === "string" ? parsed.agent_id : void 0);
 				createdAt = toIsoString(parsed.created_at, createdAt);
 				updatedAt = toIsoString(parsed.updated_at, updatedAt);
 				continue;
 			}
-			if (parsed._type === "event" && isRecord(parsed.event)) {
+			if (parsed._type === "event" && isRecord$1(parsed.event)) {
 				const seq = Number(parsed.seq);
 				nextSeq = Math.max(nextSeq, Number.isFinite(seq) ? Math.trunc(seq) + 1 : nextSeq);
 				updatedAt = toIsoString(parsed.timestamp, updatedAt);
@@ -4860,6 +4858,196 @@ var NcpAgentSessionJournalStore = class {
 	indexPath = () => resolve(this.journalDir, NCP_AGENT_SESSION_JOURNAL_INDEX_FILE);
 };
 //#endregion
+//#region src/contributions/session-activity-preview/utils/session-activity-preview-ncp-event.utils.ts
+const PREVIEW_TEXT_MAX_LENGTH = 160;
+function readSessionId(value) {
+	if (typeof value !== "string") return null;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : null;
+}
+function compactPreviewText(value) {
+	return value.replace(/\s+/g, " ").trim();
+}
+function truncatePreviewText(value) {
+	const compacted = compactPreviewText(value);
+	if (compacted.length <= PREVIEW_TEXT_MAX_LENGTH) return compacted;
+	return compacted.slice(0, PREVIEW_TEXT_MAX_LENGTH - 1).trimEnd();
+}
+function readMessagePreviewText(message) {
+	const chunks = [];
+	for (const part of message.parts) if ((part.type === "text" || part.type === "rich-text") && part.text.trim()) chunks.push(part.text);
+	const previewText = truncatePreviewText(chunks.join(" "));
+	return previewText.length > 0 ? previewText : null;
+}
+function createProjection(sessionId, preview) {
+	if (!sessionId) return null;
+	return {
+		sessionId,
+		preview
+	};
+}
+function formatErrorStatus(error) {
+	if (typeof error === "string" && error.trim()) return `运行出错：${truncatePreviewText(error)}`;
+	if (error && typeof error === "object" && "message" in error) {
+		const message = error.message;
+		if (typeof message === "string" && message.trim()) return `运行出错：${truncatePreviewText(message)}`;
+	}
+	return "运行出错";
+}
+function createSessionActivityPreviewFromNcpEvent(event, timestamp) {
+	switch (event.type) {
+		case NcpEventType.RunStarted: return createProjection(readSessionId(event.payload.sessionId), {
+			state: "running",
+			statusText: "正在处理...",
+			timestamp
+		});
+		case NcpEventType.RunFinished: return createProjection(readSessionId(event.payload.sessionId), {
+			state: "completed",
+			timestamp
+		});
+		case NcpEventType.RunError: return createProjection(readSessionId(event.payload.sessionId), {
+			state: "failed",
+			statusText: formatErrorStatus(event.payload.error),
+			timestamp
+		});
+		case NcpEventType.MessageSent: {
+			const text = readMessagePreviewText(event.payload.message);
+			if (!text || event.payload.message.role !== "user") return null;
+			return createProjection(readSessionId(event.payload.sessionId), {
+				state: "running",
+				statusText: text,
+				timestamp: event.payload.message.timestamp || timestamp
+			});
+		}
+		case NcpEventType.MessageCompleted: {
+			const text = readMessagePreviewText(event.payload.message);
+			if (!text || event.payload.message.role !== "assistant") return null;
+			return createProjection(readSessionId(event.payload.sessionId), {
+				state: "completed",
+				replyText: text,
+				timestamp: event.payload.message.timestamp || timestamp
+			});
+		}
+		case NcpEventType.MessageFailed: return createProjection(readSessionId(event.payload.sessionId), {
+			state: "failed",
+			statusText: formatErrorStatus(event.payload.error),
+			timestamp
+		});
+		case NcpEventType.MessageToolCallStart: return createProjection(readSessionId(event.payload.sessionId), {
+			state: "running",
+			statusText: `正在调用工具：${event.payload.toolName}`,
+			timestamp
+		});
+		case NcpEventType.MessageToolCallEnd:
+		case NcpEventType.MessageToolCallResult: return createProjection(readSessionId(event.payload.sessionId), {
+			state: "running",
+			statusText: "工具调用完成",
+			timestamp
+		});
+		default: return null;
+	}
+}
+//#endregion
+//#region src/contributions/session-activity-preview/utils/session-activity-preview-metadata.utils.ts
+const SESSION_ACTIVITY_PREVIEW_METADATA_KEY = "last_activity_preview";
+const SESSION_ACTIVITY_PREVIEW_STATES = new Set([
+	"running",
+	"completed",
+	"failed",
+	"idle"
+]);
+function isRecord(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readOptionalString(value) {
+	if (typeof value !== "string") return;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+}
+function readSessionActivityPreviewMetadata(value) {
+	if (!isRecord(value)) return null;
+	const state = value.state;
+	const timestamp = readOptionalString(value.timestamp);
+	if (!SESSION_ACTIVITY_PREVIEW_STATES.has(state) || !timestamp) return null;
+	return {
+		state,
+		timestamp,
+		...readOptionalString(value.statusText) ? { statusText: readOptionalString(value.statusText) } : {},
+		...readOptionalString(value.replyText) ? { replyText: readOptionalString(value.replyText) } : {}
+	};
+}
+function compareIsoTimestamp(left, right) {
+	const leftTime = Date.parse(left);
+	const rightTime = Date.parse(right);
+	if (!Number.isFinite(leftTime) || !Number.isFinite(rightTime)) return left.localeCompare(right);
+	return leftTime - rightTime;
+}
+function mergeSessionActivityPreview(current, incoming) {
+	if (current && compareIsoTimestamp(incoming.timestamp, current.timestamp) < 0) return current;
+	return {
+		state: incoming.state,
+		timestamp: incoming.timestamp,
+		...incoming.statusText ?? (incoming.state === "completed" ? current?.statusText : void 0) ? { statusText: incoming.statusText ?? current?.statusText } : {},
+		...incoming.replyText ?? current?.replyText ? { replyText: incoming.replyText ?? current?.replyText } : {}
+	};
+}
+function areSessionActivityPreviewsEqual(left, right) {
+	return Boolean(left) && left?.state === right.state && left.timestamp === right.timestamp && left.statusText === right.statusText && left.replyText === right.replyText;
+}
+function writeSessionActivityPreviewMetadata(metadata, projection) {
+	const current = readSessionActivityPreviewMetadata(metadata?.[SESSION_ACTIVITY_PREVIEW_METADATA_KEY]);
+	const next = mergeSessionActivityPreview(current, projection.preview);
+	if (areSessionActivityPreviewsEqual(current, next)) return null;
+	return {
+		...metadata ?? {},
+		[SESSION_ACTIVITY_PREVIEW_METADATA_KEY]: next
+	};
+}
+//#endregion
+//#region src/contributions/session-activity-preview/index.ts
+function formatBackgroundError(error) {
+	if (error instanceof Error) return error.stack ?? error.message;
+	return String(error);
+}
+function readMetadata(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return;
+	return value;
+}
+var SessionActivityPreviewContribution = class {
+	unsubscribeNcpEvent = null;
+	stopped = true;
+	constructor(kernel) {
+		this.kernel = kernel;
+	}
+	start = () => {
+		if (this.unsubscribeNcpEvent) return;
+		this.stopped = false;
+		this.unsubscribeNcpEvent = this.kernel.eventBus.on(eventKeys.ncpEvent, (event) => {
+			const projection = createSessionActivityPreviewFromNcpEvent(event, (/* @__PURE__ */ new Date()).toISOString());
+			if (!projection) return;
+			this.updatePreview(projection);
+		});
+	};
+	dispose = () => {
+		this.unsubscribeNcpEvent?.();
+		this.unsubscribeNcpEvent = null;
+		this.stopped = true;
+	};
+	updatePreview = (projection) => {
+		this.persistPreview(projection).catch((error) => {
+			console.error(`[session-activity-preview] failed to update ${projection.sessionId}: ${formatBackgroundError(error)}`);
+		});
+	};
+	persistPreview = async (projection) => {
+		if (this.stopped) return;
+		const summary = await this.kernel.ncpSessionApi.getSession(projection.sessionId);
+		if (!summary || this.stopped) return;
+		const nextMetadata = writeSessionActivityPreviewMetadata(readMetadata(summary.metadata), projection);
+		if (!nextMetadata) return;
+		await this.kernel.ncpSessionApi.updateSession(projection.sessionId, { metadata: nextMetadata });
+	};
+};
+//#endregion
 //#region src/app/nextclaw-kernel.ts
 function resolveKernelSessionsDir(options) {
 	const homeDir = options.homeDir?.trim();
@@ -4904,7 +5092,7 @@ var NextclawKernel = class {
 	sessionLifecycleEvents;
 	ncpAgentSessionStore;
 	ncpAgentSessionJournalStore;
-	startPromise = null;
+	contributions;
 	constructor(options = {}) {
 		const sessionsDir = resolveKernelSessionsDir(options);
 		this.sessions = new SessionManager({ sessionsDir });
@@ -4942,12 +5130,6 @@ var NextclawKernel = class {
 			channels: this.channels,
 			providerManager: this.llmProviders
 		});
-		this.ncpSessionApi = new NcpSessionApiService({
-			eventBus: this.eventBus,
-			getConfig: this.configManager.loadConfig,
-			ncpAgentSessionStore: this.ncpAgentSessionStore,
-			sessionManager: this.sessions
-		});
 		this.agentRuntimeManager = new AgentRuntimeManager({
 			bus: this.messageBus,
 			providerManager: this.llmProviders,
@@ -4964,30 +5146,34 @@ var NextclawKernel = class {
 			llmUsage: this.llmUsage,
 			onSessionUpdated: this.publishSessionUpdated
 		});
+		this.ncpSessionApi = new NcpSessionApiService({
+			eventBus: this.eventBus,
+			getConfig: this.configManager.loadConfig,
+			isLiveSessionRunning: this.agentRuntimeManager.isLiveSessionRunning,
+			ncpAgentSessionStore: this.ncpAgentSessionStore,
+			sessionManager: this.sessions
+		});
 		this.learningLoop = new LearningLoopManager({
 			eventBus: this.eventBus,
 			sessionManager: this.sessions,
 			sessionRequester: this.sessionRequests,
 			resolveLearningLoopConfig: () => readLearningLoopRuntimeConfig(this.configManager.loadConfig())
 		});
+		this.contributions = [new SessionActivityPreviewContribution(this)];
 	}
 	start = async () => {
-		this.startPromise ??= Promise.resolve().then(() => {
-			this.ncpSessionApi.start();
-		}).then(() => this.sessionSearch.start()).then(() => this.agentRuntimeManager.bootstrap()).then(() => {
-			this.learningLoop.start();
-		}).catch((error) => {
-			this.startPromise = null;
-			throw error;
-		});
-		return this.startPromise;
+		this.ncpSessionApi.start();
+		this.sessionSearch.start();
+		for (const contribution of this.contributions) contribution.start();
+		this.agentRuntimeManager.bootstrap();
+		this.learningLoop.start();
 	};
 	dispose = async () => {
 		this.learningLoop.dispose();
+		for (const contribution of this.contributions) contribution.dispose();
 		this.ncpSessionApi.dispose();
 		await this.agentRuntimeManager.dispose();
 		await this.sessionSearch.dispose();
-		this.startPromise = null;
 	};
 	publishSessionUpdated = (sessionKey) => {
 		this.sessionLifecycleEvents.publishSessionUpdated(sessionKey);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/kernel",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "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.16",
-    "@nextclaw/ncp-http-agent-server": "0.3.21",
-    "@nextclaw/mcp": "0.1.81",
-    "@nextclaw/ncp-agent-runtime": "0.3.19",
-    "@nextclaw/ncp-mcp": "0.1.83",
-    "@nextclaw/ncp-toolkit": "0.5.14",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.8",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.9",
-    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.8",
-    "@nextclaw/openclaw-compat": "1.0.16",
-    "@nextclaw/shared": "0.1.3",
-    "@nextclaw/runtime": "0.2.48",
-    "@nextclaw/ncp": "0.5.9"
+    "@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"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",