@nextclaw/kernel 0.1.9 → 0.1.11

package/dist/index.d.ts

@@ -246,11 +246,13 @@ declare class SessionRunManager {
   deleteActiveSessionRun: (sessionId: string, runId: string) => void;
   streamSessionEvents: (payload: NcpStreamRequestPayload, options?: NcpAgentRunStreamOptions) => AsyncIterable<NcpEndpointEvent>;
   updateToolCallResult: UpdateToolCallResult;
+  patchSessionMetadata: (sessionId: string, patcher: (metadata: Record<string, unknown>) => Record<string, unknown> | null) => Promise<boolean>;
   appendSessionEvent: (sessionId: string, event: NcpEndpointEvent, options?: PublishSessionEventOptions) => Promise<void>;
   private readonly ensureLiveSession;
   private readonly requireLiveSession;
   private readonly publishSessionEvent;
   private readonly persistLiveSessionEvent;
+  private readonly persistSessionMetadata;
   private readonly assertNotDisposed;
   private publishSessionRunStatus;
 }

package/dist/index.js

@@ -2693,6 +2693,18 @@ var SessionRunManager = class {
 		});
 		await this.onSessionUpdated(normalizedSessionId);
 	};
+	patchSessionMetadata = async (sessionId, patcher) => {
+		this.assertNotDisposed();
+		const normalizedSessionId = sessionId.trim();
+		if (!normalizedSessionId) return false;
+		const liveSession = this.liveSessions.get(normalizedSessionId) ?? null;
+		const storedSession = liveSession ? null : await this.ncpAgentSessionStore.getSession(normalizedSessionId);
+		if (!liveSession && !storedSession) return false;
+		const nextMetadata = patcher(structuredClone(liveSession?.metadata ?? storedSession?.metadata ?? {}));
+		if (!nextMetadata) return false;
+		if (liveSession) liveSession.metadata = structuredClone(nextMetadata);
+		return await this.persistSessionMetadata(normalizedSessionId, nextMetadata);
+	};
 	appendSessionEvent = async (sessionId, event, options = {}) => {
 		await this.publishSessionEvent(this.requireLiveSession(sessionId), event, options);
 	};
@@ -2731,7 +2743,14 @@ var SessionRunManager = class {
 			stateManager,
 			sessionMetadata: metadata,
 			setSessionMetadata: (nextMetadata) => {
-				session.metadata = structuredClone(nextMetadata);
+				session.metadata = {
+					...session.metadata,
+					...structuredClone(nextMetadata)
+				};
+				this.persistSessionMetadata(session.sessionId, session.metadata).catch((error) => {
+					const message = error instanceof Error ? error.stack ?? error.message : String(error);
+					console.error(`[session-run] failed to persist runtime metadata for ${session.sessionId}: ${message}`);
+				});
 			}
 		});
 		this.liveSessions.set(sessionId, session);
@@ -2755,13 +2774,14 @@ var SessionRunManager = class {
 	persistLiveSessionEvent = async (session, event) => {
 		const updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 		if (this.ncpAgentSessionStore.appendSessionEvent) {
+			const storedSession = await this.ncpAgentSessionStore.getSession(session.sessionId);
 			await this.ncpAgentSessionStore.appendSessionEvent({
 				session: {
 					sessionId: session.sessionId,
 					...session.agentId ? { agentId: session.agentId } : {},
 					createdAt: session.createdAt,
 					updatedAt,
-					metadata: structuredClone(session.metadata)
+					metadata: storedSession ? {} : structuredClone(session.metadata)
 				},
 				event,
 				updatedAt
@@ -2770,6 +2790,13 @@ var SessionRunManager = class {
 		}
 		await this.ncpAgentSessionStore.saveSession(buildSessionRecord(session, updatedAt));
 	};
+	persistSessionMetadata = async (sessionId, metadata) => {
+		return await this.ncpAgentSessionStore.updateSessionMetadata({
+			sessionId,
+			metadata: structuredClone(metadata),
+			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		});
+	};
 	assertNotDisposed = () => {
 		if (this.disposed) throw new Error("Session run manager has already been disposed.");
 	};
@@ -5335,25 +5362,25 @@ function toAssetPayload(record, contentBasePath) {
 }
 var AssetPutTool = class {
 	name = "asset_put";
-	description = "Put a normal file path or base64 bytes into the managed asset store.";
+	description = "Publish a file to the user as a chat/channel attachment with preview and download support.";
 	parameters = {
 		type: "object",
 		properties: {
 			path: {
 				type: "string",
-				description: "Existing local file path to put into the asset store."
+				description: "Existing local file path to publish to the user as an attachment."
 			},
 			bytesBase64: {
 				type: "string",
-				description: "Base64 file bytes. Use together with fileName when no source path exists."
+				description: "Base64 file bytes to publish when no source path exists. Use with fileName."
 			},
 			fileName: {
 				type: "string",
-				description: "Optional asset file name override. Required when using bytesBase64."
+				description: "Optional display/download file name. Required when using bytesBase64."
 			},
 			mimeType: {
 				type: "string",
-				description: "Optional mime type override."
+				description: "Optional MIME type override for preview and download rendering."
 			}
 		},
 		additionalProperties: false
@@ -5917,7 +5944,6 @@ function writeSessionActivityPreviewMetadata(metadata, projection) {
 //#region src/contributions/session-activity-preview/index.ts
 var SessionActivityPreviewContribution = class {
 	unsubscribeNcpEvent = null;
-	previewWriteChains = /* @__PURE__ */ new Map();
 	constructor(kernel) {
 		this.kernel = kernel;
 	}
@@ -5932,26 +5958,13 @@ var SessionActivityPreviewContribution = class {
 	dispose = () => {
 		this.unsubscribeNcpEvent?.();
 		this.unsubscribeNcpEvent = null;
-		this.previewWriteChains.clear();
 	};
 	updatePreview = (projection) => {
-		const next = (this.previewWriteChains.get(projection.sessionId) ?? Promise.resolve()).catch(() => void 0).then(() => this.persistPreview(projection));
-		this.previewWriteChains.set(projection.sessionId, next);
-		next.catch((error) => {
+		this.kernel.sessionRunManager.patchSessionMetadata(projection.sessionId, (metadata) => writeSessionActivityPreviewMetadata(metadata, projection)).catch((error) => {
 			const message = error instanceof Error ? error.stack ?? error.message : String(error);
 			console.error(`[session-activity-preview] failed to update ${projection.sessionId}: ${message}`);
-		}).finally(() => {
-			if (this.previewWriteChains.get(projection.sessionId) === next) this.previewWriteChains.delete(projection.sessionId);
 		});
 	};
-	persistPreview = async (projection) => {
-		if (!this.unsubscribeNcpEvent) return;
-		const summary = await this.kernel.ncpSessionApi.getSession(projection.sessionId);
-		if (!summary || !this.unsubscribeNcpEvent) return;
-		const nextMetadata = writeSessionActivityPreviewMetadata(summary.metadata && typeof summary.metadata === "object" && !Array.isArray(summary.metadata) ? summary.metadata : void 0, projection);
-		if (!nextMetadata) return;
-		await this.kernel.ncpSessionApi.updateSession(projection.sessionId, { metadata: nextMetadata });
-	};
 };
 //#endregion
 //#region src/tools/session-request.tools.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/kernel",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "private": false,
   "description": "NextClaw product kernel skeleton for agents, tasks, sessions, context, tools, skills, providers, automation, and channels.",
   "type": "module",
@@ -21,19 +21,19 @@
   ],
   "dependencies": {
     "yaml": "^2.8.1",
-    "@nextclaw/channel-extension-feishu": "0.1.4",
-    "@nextclaw/core": "0.12.20",
-    "@nextclaw/channel-extension-weixin": "0.1.7",
-    "@nextclaw/mcp": "0.1.85",
-    "@nextclaw/ncp-agent-runtime": "0.3.23",
-    "@nextclaw/ncp-mcp": "0.1.87",
-    "@nextclaw/ncp-toolkit": "0.5.18",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.12",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.13",
-    "@nextclaw/openclaw-compat": "1.0.20",
-    "@nextclaw/runtime": "0.2.52",
-    "@nextclaw/shared": "0.1.7",
-    "@nextclaw/ncp": "0.5.13"
+    "@nextclaw/channel-extension-feishu": "0.1.5",
+    "@nextclaw/channel-extension-weixin": "0.1.8",
+    "@nextclaw/core": "0.12.21",
+    "@nextclaw/mcp": "0.1.86",
+    "@nextclaw/ncp-agent-runtime": "0.3.25",
+    "@nextclaw/ncp-mcp": "0.1.88",
+    "@nextclaw/ncp-toolkit": "0.5.19",
+    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.13",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.14",
+    "@nextclaw/openclaw-compat": "1.0.21",
+    "@nextclaw/runtime": "0.2.53",
+    "@nextclaw/ncp": "0.5.14",
+    "@nextclaw/shared": "0.1.8"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",