@nextclaw/ncp-toolkit 0.4.8 → 0.4.9

package/dist/index.d.ts

@@ -129,6 +129,7 @@ declare class DefaultNcpAgentBackend implements NcpAgentServerEndpoint, NcpSessi
     listSessionMessages(sessionId: string): Promise<NcpMessage[]>;
     getSession(sessionId: string): Promise<NcpSessionSummary | null>;
     appendMessage: (sessionId: string, message: NcpMessage) => Promise<NcpSessionSummary | null>;
+    updateToolCallResult: (sessionId: string, toolCallId: string, content: unknown) => Promise<NcpSessionSummary | null>;
     updateSession(sessionId: string, patch: NcpSessionPatch): Promise<NcpSessionSummary | null>;
     deleteSession(sessionId: string): Promise<void>;
     private ensureStarted;

package/dist/index.js

@@ -692,7 +692,7 @@ async function consume(events) {
 
 // src/agent/agent-backend/agent-backend.ts
 import {
-  NcpEventType as NcpEventType6
+  NcpEventType as NcpEventType8
 } from "@nextclaw/ncp";
 
 // src/errors/ncp-error-exception.ts
@@ -777,23 +777,28 @@ function cloneMessages(messages) {
 }
 
 // src/agent/agent-backend/agent-run-executor.ts
+import {
+  isHiddenNcpMessage
+} from "@nextclaw/ncp";
 import { NcpEventType as NcpEventType3 } from "@nextclaw/ncp";
 var AgentRunExecutor = class {
   constructor(persistSession) {
     this.persistSession = persistSession;
   }
   async *executeRun(session, envelope, controller) {
-    const messageSent = {
-      type: NcpEventType3.MessageSent,
-      payload: {
-        sessionId: envelope.sessionId,
-        message: structuredClone(envelope.message),
-        metadata: envelope.metadata
-      }
-    };
-    await session.stateManager.dispatch(messageSent);
-    await this.persistSession(envelope.sessionId);
-    yield structuredClone(messageSent);
+    if (!isHiddenNcpMessage(envelope.message)) {
+      const messageSent = {
+        type: NcpEventType3.MessageSent,
+        payload: {
+          sessionId: envelope.sessionId,
+          message: structuredClone(envelope.message),
+          metadata: envelope.metadata
+        }
+      };
+      await session.stateManager.dispatch(messageSent);
+      await this.persistSession(envelope.sessionId);
+      yield structuredClone(messageSent);
+    }
     try {
       for await (const event of session.runtime.run(
         {
@@ -903,8 +908,34 @@ function buildPersistedLiveSessionRecord(params) {
   };
 }
 
-// src/agent/agent-backend/agent-backend-append-message.ts
+// src/agent/agent-backend/agent-backend-update-tool-call-result.ts
 import { NcpEventType as NcpEventType5 } from "@nextclaw/ncp";
+async function updateAgentBackendToolCallResult(params) {
+  const normalizedSessionId = params.sessionId.trim();
+  const normalizedToolCallId = params.toolCallId.trim();
+  if (!normalizedSessionId || !normalizedToolCallId) {
+    return null;
+  }
+  const liveSession = await params.sessionRegistry.ensureSession(normalizedSessionId);
+  const event = {
+    type: NcpEventType5.MessageToolCallResult,
+    payload: {
+      sessionId: normalizedSessionId,
+      toolCallId: normalizedToolCallId,
+      content: params.content
+    }
+  };
+  await liveSession.stateManager.dispatch(event);
+  params.publisher.publish(event);
+  if (liveSession.activeExecution && !liveSession.activeExecution.closed) {
+    liveSession.activeExecution.publisher.publish(event);
+  }
+  await params.persistSession(normalizedSessionId);
+  return params.getSession(normalizedSessionId);
+}
+
+// src/agent/agent-backend/agent-backend-append-message.ts
+import { NcpEventType as NcpEventType6 } from "@nextclaw/ncp";
 async function appendAgentBackendMessage(params) {
   const normalizedSessionId = params.sessionId.trim();
   if (!normalizedSessionId) {
@@ -923,7 +954,7 @@ async function appendAgentBackendMessage(params) {
     sessionId: normalizedSessionId
   };
   const event = {
-    type: NcpEventType5.MessageSent,
+    type: NcpEventType6.MessageSent,
     payload: {
       sessionId: normalizedSessionId,
       message: nextMessage
@@ -938,6 +969,9 @@ async function appendAgentBackendMessage(params) {
   return params.getSession(normalizedSessionId);
 }
 
+// src/agent/agent-backend/agent-backend-stream.ts
+import { NcpEventType as NcpEventType7 } from "@nextclaw/ncp";
+
 // src/agent/agent-backend/async-queue.ts
 function createAsyncQueue() {
   const items = [];
@@ -1004,6 +1038,14 @@ async function* streamAgentBackendExecution(params) {
   const session = params.sessionRegistry.getSession(payload.sessionId);
   const execution = session?.activeExecution;
   if (!session || !execution || execution.closed) {
+    if (session) {
+      yield {
+        type: NcpEventType7.RunFinished,
+        payload: {
+          sessionId: payload.sessionId
+        }
+      };
+    }
     return;
   }
   const queue = createAsyncQueue();
@@ -1081,18 +1123,7 @@ var EventPublisher = class {
 };
 
 // src/agent/agent-backend/agent-backend.ts
-var DEFAULT_SUPPORTED_PART_TYPES = [
-  "text",
-  "file",
-  "source",
-  "step-start",
-  "reasoning",
-  "tool-invocation",
-  "card",
-  "rich-text",
-  "action",
-  "extension"
-];
+var DEFAULT_SUPPORTED_PART_TYPES = ["text", "file", "source", "step-start", "reasoning", "tool-invocation", "card", "rich-text", "action", "extension"];
 var DefaultNcpAgentBackend = class {
   manifest;
   sessionStore;
@@ -1126,7 +1157,7 @@ var DefaultNcpAgentBackend = class {
       return;
     }
     this.started = true;
-    this.publisher.publish({ type: NcpEventType6.EndpointReady });
+    this.publisher.publish({ type: NcpEventType8.EndpointReady });
   }
   async stop() {
     if (!this.started) {
@@ -1147,13 +1178,13 @@ var DefaultNcpAgentBackend = class {
   async emit(event) {
     await this.ensureStarted();
     switch (event.type) {
-      case NcpEventType6.MessageRequest:
+      case NcpEventType8.MessageRequest:
         await this.handleRequest(event.payload);
         return;
-      case NcpEventType6.MessageStreamRequest:
+      case NcpEventType8.MessageStreamRequest:
         await this.streamToSubscribers(event.payload);
         return;
-      case NcpEventType6.MessageAbort:
+      case NcpEventType8.MessageAbort:
         await this.handleAbort(event.payload);
         return;
       default:
@@ -1229,6 +1260,18 @@ var DefaultNcpAgentBackend = class {
       getSession: async (nextSessionId) => this.getSession(nextSessionId)
     });
   };
+  updateToolCallResult = async (sessionId, toolCallId, content) => {
+    await this.ensureStarted();
+    return updateAgentBackendToolCallResult({
+      sessionId,
+      toolCallId,
+      content,
+      sessionRegistry: this.sessionRegistry,
+      publisher: this.publisher,
+      persistSession: async (nextSessionId) => this.persistSession(nextSessionId),
+      getSession: async (nextSessionId) => this.getSession(nextSessionId)
+    });
+  };
   async updateSession(sessionId, patch) {
     const liveSession = this.sessionRegistry.getSession(sessionId);
     const storedSession = await this.sessionStore.getSession(sessionId);
@@ -1325,7 +1368,7 @@ var DefaultNcpAgentBackend = class {
   }
   async createAbortEvent(sessionId, messageId) {
     const abortEvent = {
-      type: NcpEventType6.MessageAbort,
+      type: NcpEventType8.MessageAbort,
       payload: {
         sessionId,
         ...messageId ? { messageId } : {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ncp-toolkit",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "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.1"
+    "@nextclaw/ncp": "0.4.2"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",
@@ -23,7 +23,7 @@
     "tsup": "^8.3.5",
     "typescript": "^5.6.3",
     "vitest": "^2.1.2",
-    "@nextclaw/ncp-agent-runtime": "0.3.1"
+    "@nextclaw/ncp-agent-runtime": "0.3.2"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --out-dir dist",