@nextclaw/ncp-toolkit 0.4.10 → 0.4.11

package/dist/index.js

@@ -845,6 +845,7 @@ var AgentRunExecutor = class {
 
 // src/agent/agent-backend/agent-backend-session-utils.ts
 import { NcpEventType as NcpEventType4 } from "@nextclaw/ncp";
+var AUTO_SESSION_LABEL_MAX_LENGTH = 64;
 function readMessages(snapshot) {
   const messages = snapshot.messages.map((message) => structuredClone(message));
   if (snapshot.streamingMessage) {
@@ -853,32 +854,83 @@ function readMessages(snapshot) {
   return messages;
 }
 function toSessionSummary(session, liveSession) {
+  const metadata = withAutoSessionLabel({
+    metadata: session.metadata ? structuredClone({
+      ...session.metadata,
+      ...liveSession?.metadata ? liveSession.metadata : {}
+    }) : liveSession?.metadata ? structuredClone(liveSession.metadata) : {},
+    messages: session.messages
+  });
   return {
     sessionId: session.sessionId,
     messageCount: session.messages.length,
     updatedAt: session.updatedAt,
     status: liveSession?.activeExecution ? "running" : "idle",
-    ...session.metadata ? {
-      metadata: structuredClone({
-        ...session.metadata,
-        ...liveSession?.metadata ? liveSession.metadata : {}
-      })
-    } : liveSession?.metadata ? { metadata: structuredClone(liveSession.metadata) } : {}
+    ...Object.keys(metadata).length > 0 ? { metadata } : {}
   };
 }
 function toLiveSessionSummary(session) {
   const snapshot = session.stateManager.getSnapshot();
+  const messages = readMessages(snapshot);
+  const metadata = withAutoSessionLabel({
+    metadata: Object.keys(session.metadata).length > 0 ? structuredClone(session.metadata) : session.activeExecution?.requestEnvelope.metadata ? structuredClone(session.activeExecution.requestEnvelope.metadata) : {},
+    messages
+  });
   return {
     sessionId: session.sessionId,
-    messageCount: readMessages(snapshot).length,
+    messageCount: messages.length,
     updatedAt: now(),
     status: session.activeExecution ? "running" : "idle",
-    ...Object.keys(session.metadata).length > 0 ? { metadata: structuredClone(session.metadata) } : session.activeExecution?.requestEnvelope.metadata ? { metadata: structuredClone(session.activeExecution.requestEnvelope.metadata) } : {}
+    ...Object.keys(metadata).length > 0 ? { metadata } : {}
   };
 }
 function now() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
+function readOptionalString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function truncateLabel(value) {
+  const characters = Array.from(value);
+  if (characters.length <= AUTO_SESSION_LABEL_MAX_LENGTH) {
+    return value;
+  }
+  return `${characters.slice(0, AUTO_SESSION_LABEL_MAX_LENGTH).join("")}\u2026`;
+}
+function resolveAutoSessionLabelFromMessages(messages) {
+  for (const message of messages) {
+    if (message.role !== "user") {
+      continue;
+    }
+    for (const part of message.parts) {
+      if (part.type === "text" || part.type === "rich-text") {
+        const text = readOptionalString(part.text);
+        if (text) {
+          return truncateLabel(text);
+        }
+      }
+    }
+  }
+  return null;
+}
+function withAutoSessionLabel(params) {
+  const existingLabel = readOptionalString(params.metadata.label);
+  if (existingLabel) {
+    return params.metadata;
+  }
+  const nextLabel = resolveAutoSessionLabelFromMessages(params.messages);
+  if (!nextLabel) {
+    return params.metadata;
+  }
+  return {
+    ...params.metadata,
+    label: nextLabel
+  };
+}
 function isTerminalEvent(event) {
   switch (event.type) {
     case NcpEventType4.MessageAbort:
@@ -904,14 +956,19 @@ function buildUpdatedSessionRecord(params) {
   };
 }
 function buildPersistedLiveSessionRecord(params) {
-  return {
-    sessionId: params.sessionId,
-    messages: readMessages(params.session.stateManager.getSnapshot()),
-    updatedAt: params.updatedAt,
+  const messages = readMessages(params.session.stateManager.getSnapshot());
+  const metadata = withAutoSessionLabel({
     metadata: {
       ...params.session.metadata ? structuredClone(params.session.metadata) : {},
       ...params.session.activeExecution?.requestEnvelope.metadata ? structuredClone(params.session.activeExecution.requestEnvelope.metadata) : {}
-    }
+    },
+    messages
+  });
+  return {
+    sessionId: params.sessionId,
+    messages,
+    updatedAt: params.updatedAt,
+    metadata
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ncp-toolkit",
-  "version": "0.4.10",
+  "version": "0.4.11",
   "private": false,
   "description": "Toolkit implementations built on top of the NextClaw Communication Protocol.",
   "type": "module",
@@ -22,7 +22,7 @@
     "prettier": "^3.3.3",
     "tsup": "^8.3.5",
     "typescript": "^5.6.3",
-    "vitest": "^2.1.2",
+    "vitest": "^4.1.2",
     "@nextclaw/ncp-agent-runtime": "0.3.2"
   },
   "scripts": {