@nextclaw/ncp-toolkit 0.4.17 → 0.5.0

package/dist/index.d.ts

@@ -69,6 +69,7 @@ declare class EventPublisher {
 
 type RuntimeFactoryParams = {
     sessionId: string;
+    agentId?: string;
     stateManager: NcpAgentConversationStateManager;
     sessionMetadata: Record<string, unknown>;
     setSessionMetadata: (nextMetadata: Record<string, unknown>) => void;
@@ -76,6 +77,7 @@ type RuntimeFactoryParams = {
 type CreateRuntimeFn = (params: RuntimeFactoryParams) => NcpAgentRuntime;
 type AgentSessionRecord = {
     sessionId: string;
+    agentId?: string;
     messages: NcpMessage[];
     updatedAt: string;
     metadata?: Record<string, unknown>;
@@ -88,6 +90,7 @@ type LiveSessionExecution = {
 };
 type LiveSessionState = {
     sessionId: string;
+    agentId?: string;
     runtime: NcpAgentRuntime;
     stateManager: NcpAgentConversationStateManager;
     metadata: Record<string, unknown>;

package/dist/index.js

@@ -751,15 +751,28 @@ var EventPublisher = class {
 };
 
 // src/agent/agent-backend/agent-live-session-registry.ts
+function readOptionalAgentId(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim().toLowerCase();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function readAgentIdFromMetadata(metadata) {
+  return readOptionalAgentId(metadata?.agent_id) ?? readOptionalAgentId(metadata?.agentId);
+}
 var AgentLiveSessionRegistry = class {
   constructor(sessionStore, createRuntime) {
     this.sessionStore = sessionStore;
     this.createRuntime = createRuntime;
   }
   sessions = /* @__PURE__ */ new Map();
-  async ensureSession(sessionId, initialMetadata) {
+  ensureSession = async (sessionId, initialMetadata) => {
     const existing = this.sessions.get(sessionId);
     if (existing) {
+      if (!existing.agentId) {
+        existing.agentId = readAgentIdFromMetadata(initialMetadata) ?? existing.agentId;
+      }
       if (initialMetadata && Object.keys(initialMetadata).length > 0) {
         existing.metadata = {
           ...existing.metadata,
@@ -778,8 +791,10 @@ var AgentLiveSessionRegistry = class {
       ...storedSession?.metadata ? structuredClone(storedSession.metadata) : {},
       ...initialMetadata ? structuredClone(initialMetadata) : {}
     };
+    const sessionAgentId = readOptionalAgentId(storedSession?.agentId) ?? readAgentIdFromMetadata(initialMetadata);
     const session = {
       sessionId,
+      ...sessionAgentId ? { agentId: sessionAgentId } : {},
       stateManager,
       metadata: sessionMetadata,
       runtime: null,
@@ -788,6 +803,7 @@ var AgentLiveSessionRegistry = class {
     };
     session.runtime = this.createRuntime({
       sessionId,
+      ...sessionAgentId ? { agentId: sessionAgentId } : {},
       stateManager,
       sessionMetadata,
       setSessionMetadata: (nextMetadata) => {
@@ -798,23 +814,23 @@ var AgentLiveSessionRegistry = class {
     });
     this.sessions.set(sessionId, session);
     return session;
-  }
-  getSession(sessionId) {
+  };
+  getSession = (sessionId) => {
     return this.sessions.get(sessionId) ?? null;
-  }
-  deleteSession(sessionId) {
+  };
+  deleteSession = (sessionId) => {
     const session = this.sessions.get(sessionId) ?? null;
     if (session) {
       this.sessions.delete(sessionId);
     }
     return session;
-  }
-  clear() {
+  };
+  clear = () => {
     this.sessions.clear();
-  }
-  listSessions() {
+  };
+  listSessions = () => {
     return [...this.sessions.values()];
-  }
+  };
 };
 function cloneMessages(messages) {
   return messages.map((message) => structuredClone(message));
@@ -1099,6 +1115,13 @@ var AgentBackendSessionRealtime = class {
 // src/agent/agent-backend/agent-backend-session-utils.ts
 import { NcpEventType as NcpEventType5 } from "@nextclaw/ncp";
 var AUTO_SESSION_LABEL_MAX_LENGTH = 64;
+function readOptionalAgentId2(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim().toLowerCase();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
 function readMessages(snapshot) {
   const messages = snapshot.messages.map((message) => structuredClone(message));
   if (snapshot.streamingMessage) {
@@ -1116,6 +1139,7 @@ function toSessionSummary(session, liveSession) {
   });
   return {
     sessionId: session.sessionId,
+    ...readOptionalAgentId2(session.agentId) ? { agentId: readOptionalAgentId2(session.agentId) } : {},
     messageCount: session.messages.length,
     updatedAt: session.updatedAt,
     status: liveSession?.activeExecution ? "running" : "idle",
@@ -1131,6 +1155,7 @@ function toLiveSessionSummary(session) {
   });
   return {
     sessionId: session.sessionId,
+    ...readOptionalAgentId2(session.agentId) ? { agentId: readOptionalAgentId2(session.agentId) } : {},
     messageCount: messages.length,
     updatedAt: now(),
     status: session.activeExecution ? "running" : "idle",
@@ -1186,6 +1211,19 @@ function withAutoSessionLabel(params) {
 }
 
 // src/agent/agent-backend/agent-backend-session-persistence.ts
+function readOptionalAgentId3(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim().toLowerCase();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function readAgentIdFromMetadata2(metadata) {
+  return readOptionalAgentId3(metadata?.agent_id) ?? readOptionalAgentId3(metadata?.agentId);
+}
+function resolvePersistedAgentId(params) {
+  return readOptionalAgentId3(params.liveSession?.agentId) ?? readOptionalAgentId3(params.storedSession?.agentId) ?? readAgentIdFromMetadata2(params.liveSession?.metadata) ?? readAgentIdFromMetadata2(params.storedSession?.metadata);
+}
 function buildUpdatedSessionRecord(params) {
   const nextMetadata = params.patch.metadata === null ? {} : params.patch.metadata ? structuredClone(params.patch.metadata) : structuredClone(params.liveSession?.metadata ?? params.storedSession?.metadata ?? {});
   if (params.liveSession) {
@@ -1193,6 +1231,15 @@ function buildUpdatedSessionRecord(params) {
   }
   return {
     sessionId: params.sessionId,
+    ...resolvePersistedAgentId({
+      liveSession: params.liveSession,
+      storedSession: params.storedSession
+    }) ? {
+      agentId: resolvePersistedAgentId({
+        liveSession: params.liveSession,
+        storedSession: params.storedSession
+      })
+    } : {},
     messages: params.liveSession ? readMessages(params.liveSession.stateManager.getSnapshot()) : params.storedSession?.messages.map((message) => structuredClone(message)) ?? [],
     updatedAt: params.updatedAt,
     metadata: nextMetadata
@@ -1209,6 +1256,9 @@ function buildPersistedLiveSessionRecord(params) {
   });
   return {
     sessionId: params.sessionId,
+    ...readOptionalAgentId3(params.session.agentId) ?? readAgentIdFromMetadata2(params.session.metadata) ?? readAgentIdFromMetadata2(params.session.activeExecution?.requestEnvelope.metadata) ? {
+      agentId: readOptionalAgentId3(params.session.agentId) ?? readAgentIdFromMetadata2(params.session.metadata) ?? readAgentIdFromMetadata2(params.session.activeExecution?.requestEnvelope.metadata)
+    } : {},
     messages,
     updatedAt: params.updatedAt,
     metadata

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ncp-toolkit",
-  "version": "0.4.17",
+  "version": "0.5.0",
   "private": false,
   "description": "Toolkit implementations built on top of the NextClaw Communication Protocol.",
   "type": "module",
@@ -15,7 +15,7 @@
     "dist"
   ],
   "dependencies": {
-    "@nextclaw/ncp": "0.4.6"
+    "@nextclaw/ncp": "0.5.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",
@@ -23,7 +23,7 @@
     "tsup": "^8.3.5",
     "typescript": "^5.6.3",
     "vitest": "^4.1.2",
-    "@nextclaw/ncp-agent-runtime": "0.3.6"
+    "@nextclaw/ncp-agent-runtime": "0.3.7"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --out-dir dist",