@nextclaw/ncp-react 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,12 +1,13 @@
-import { NcpAgentConversationSnapshot, NcpMessage, NcpAgentClientEndpoint } from '@nextclaw/ncp';
+import { NcpAgentConversationSnapshot, NcpMessage, NcpRequestEnvelope, NcpAgentClientEndpoint } from '@nextclaw/ncp';
 
+type NcpAgentSendInput = string | NcpRequestEnvelope;
 type UseNcpAgentResult = {
     snapshot: NcpAgentConversationSnapshot;
     visibleMessages: readonly NcpMessage[];
     activeRunId: string | null;
     isRunning: boolean;
     isSending: boolean;
-    send: (content: string) => Promise<void>;
+    send: (input: NcpAgentSendInput) => Promise<void>;
     abort: () => Promise<void>;
     streamRun: () => Promise<void>;
 };

package/dist/index.js

@@ -4,7 +4,9 @@ import { useCallback, useEffect as useEffect2, useRef as useRef2, useState as us
 // src/hooks/use-ncp-agent-runtime.ts
 import { useEffect, useRef, useState, useSyncExternalStore } from "react";
 import { DefaultNcpAgentConversationStateManager } from "@nextclaw/ncp-toolkit";
-import "@nextclaw/ncp";
+import {
+  NcpEventType
+} from "@nextclaw/ncp";
 function shouldDispatchEventToSession(event, sessionId) {
   const payload = "payload" in event ? event.payload : null;
   if (!payload || typeof payload !== "object") {
@@ -15,6 +17,51 @@ function shouldDispatchEventToSession(event, sessionId) {
   }
   return payload.sessionId === sessionId;
 }
+function hasMessageContent(message) {
+  return message.parts.some((part) => {
+    if (part.type === "text" || part.type === "rich-text" || part.type === "reasoning") {
+      return part.text.trim().length > 0;
+    }
+    return true;
+  });
+}
+function normalizeSendEnvelope(input, sessionId) {
+  if (typeof input === "string") {
+    const content = input.trim();
+    if (!content) {
+      return null;
+    }
+    return {
+      sessionId,
+      message: {
+        id: `user-${Date.now().toString(36)}`,
+        sessionId,
+        role: "user",
+        status: "final",
+        parts: [{ type: "text", text: content }],
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    };
+  }
+  if (!hasMessageContent(input.message)) {
+    return null;
+  }
+  return {
+    ...input,
+    sessionId: input.sessionId,
+    message: {
+      ...input.message,
+      sessionId: input.message.sessionId || input.sessionId
+    }
+  };
+}
+function toHydrationPayload(sessionId, snapshot) {
+  return {
+    sessionId,
+    messages: snapshot.messages,
+    activeRun: snapshot.activeRun
+  };
+}
 function useScopedAgentManager(sessionId) {
   const managerRef = useRef();
   if (!managerRef.current || managerRef.current.sessionId !== sessionId) {
@@ -54,23 +101,29 @@ function useNcpAgentRuntime({
   const visibleMessages = snapshot.streamingMessage ? [...snapshot.messages, snapshot.streamingMessage] : snapshot.messages;
   const activeRunId = snapshot.activeRun?.runId ?? null;
   const isRunning = !!snapshot.activeRun;
-  const send = async (content) => {
-    if (!content.trim() || isSending || isRunning) {
+  const send = async (input) => {
+    if (isSending || isRunning) {
+      return;
+    }
+    const envelope = normalizeSendEnvelope(input, sessionId);
+    if (!envelope) {
       return;
     }
     setIsSending(true);
-    try {
-      await client.send({
+    const previousSnapshot = manager.getSnapshot();
+    await manager.dispatch({
+      type: NcpEventType.MessageSent,
+      payload: {
         sessionId,
-        message: {
-          id: `user-${Date.now().toString(36)}`,
-          sessionId,
-          role: "user",
-          status: "final",
-          parts: [{ type: "text", text: content.trim() }],
-          timestamp: (/* @__PURE__ */ new Date()).toISOString()
-        }
-      });
+        message: envelope.message,
+        metadata: envelope.metadata
+      }
+    });
+    try {
+      await client.send(envelope);
+    } catch (error) {
+      manager.hydrate(toHydrationPayload(sessionId, previousSnapshot));
+      throw error;
     } finally {
       setIsSending(false);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ncp-react",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "description": "React bindings for building NCP-based agent applications.",
   "type": "module",
@@ -15,8 +15,8 @@
     "dist"
   ],
   "dependencies": {
-    "@nextclaw/ncp-toolkit": "0.2.0",
-    "@nextclaw/ncp": "0.2.0"
+    "@nextclaw/ncp": "0.3.0",
+    "@nextclaw/ncp-toolkit": "0.3.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"