@convex-dev/agent 0.0.8 → 0.0.9-alpha.1

package/src/mapping.ts

@@ -53,21 +53,11 @@ export function serializeMessageWithId(
   return { message: serializeMessage(messageWithId), id: messageWithId.id };
 }
 
-export function serializeContent(content: Content): SerializedContent {
-  if (typeof content === "string") {
-    return content;
-  }
-  const serialized = content.map((part) => {
-    switch (part.type) {
-      case "image":
-        return { ...part, image: serializeDataOrUrl(part.image) };
-      case "file":
-        return { ...part, file: serializeDataOrUrl(part.data) };
-      default:
-        return part;
-    }
-  });
-  return serialized as SerializedContent;
+export function deserializeMessage(message: SerializedMessage): CoreMessage {
+  return {
+    ...message,
+    content: deserializeContent(message.content),
+  } as CoreMessage;
 }
 
 export function serializeStep<TOOLS extends ToolSet>(
@@ -137,6 +127,23 @@ export function serializeObjectResult(
   };
 }
 
+export function serializeContent(content: Content): SerializedContent {
+  if (typeof content === "string") {
+    return content;
+  }
+  const serialized = content.map((part) => {
+    switch (part.type) {
+      case "image":
+        return { ...part, image: serializeDataOrUrl(part.image) };
+      case "file":
+        return { ...part, file: serializeDataOrUrl(part.data) };
+      default:
+        return part;
+    }
+  });
+  return serialized as SerializedContent;
+}
+
 export function deserializeContent(content: SerializedContent): Content {
   if (typeof content === "string") {
     return content;
@@ -144,7 +151,7 @@ export function deserializeContent(content: SerializedContent): Content {
   return content.map((part) => {
     switch (part.type) {
       case "image":
-        return { ...part, file: deserializeUrl(part.image) };
+        return { ...part, image: deserializeUrl(part.image) };
       case "file":
         return { ...part, file: deserializeUrl(part.data) };
       default:

package/src/react/index.ts

@@ -4,6 +4,17 @@ if (typeof window === "undefined") {
   throw new Error("this is frontend code, but it's running somewhere else!");
 }
 
+/**
+ * Use this hook to stream text from a server action, using the
+ * toTextStreamResponse or equivalent HTTP streaming endpoint returning text.
+ * @param url The URL of the server action to stream text from.
+ *   e.g. https://....convex.site/yourendpoint
+ * @param threadId The ID of the thread to stream text from.
+ * @param token The auth token to use for the request.
+ *   e.g. useAuthToken() from @convex-dev/auth/react
+ * @returns A tuple containing the {text, loading, error} and a function to call the endpoint
+ * with a given prompt, passing up { prompt, threadId } as the body in JSON.
+ */
 export function useStreamingText(
   url: string,
   threadId: string | null,