lemma-sdk 0.2.7 → 0.2.9

package/dist/react/useAssistantSession.js

@@ -1,4 +1,4 @@
-import { useCallback, useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { parseSSEJson, readSSE } from "../streams.js";
 import { parseAssistantStreamEvent, upsertConversationMessage } from "../assistant-events.js";
 function resolveOptionalPodId(client, podId) {
@@ -22,15 +22,15 @@ function normalizeError(error, fallback) {
         return error;
     return new Error(fallback);
 }
-function normalizeScope(client, options, override) {
+function normalizeScope(client, defaults, override) {
     return {
-        podId: override?.podId ?? options.podId ?? client.podId ?? null,
-        assistantId: override?.assistantId ?? options.assistantId ?? null,
-        organizationId: override?.organizationId ?? options.organizationId ?? null,
+        podId: override?.podId ?? defaults.podId ?? client.podId ?? null,
+        assistantId: override?.assistantId ?? defaults.assistantId ?? null,
+        organizationId: override?.organizationId ?? defaults.organizationId ?? null,
     };
 }
 export function useAssistantSession(options) {
-    const { client, conversationId: externalConversationId = null, autoLoad = true, onEvent, onStatus, onMessage, onError, } = options;
+    const { client, podId: defaultPodId, assistantId: defaultAssistantId, organizationId: defaultOrganizationId, conversationId: externalConversationId = null, autoLoad = true, onEvent, onStatus, onMessage, onError, } = options;
     const [conversationId, setConversationIdState] = useState(externalConversationId);
     const [conversation, setConversation] = useState(null);
     const [status, setStatus] = useState(undefined);
@@ -53,9 +53,14 @@ export function useAssistantSession(options) {
         abortRef.current?.abort();
         abortRef.current = null;
     }, []);
+    const defaultScope = useMemo(() => ({
+        podId: defaultPodId ?? null,
+        assistantId: defaultAssistantId ?? null,
+        organizationId: defaultOrganizationId ?? null,
+    }), [defaultAssistantId, defaultOrganizationId, defaultPodId]);
     const listConversations = useCallback(async (input = {}) => {
         try {
-            const scope = normalizeScope(client, options, input.scope);
+            const scope = normalizeScope(client, defaultScope, input.scope);
             applyPodScope(client, scope.podId);
             const response = await client.conversations.list({
                 pod_id: scope.podId ?? undefined,
@@ -80,14 +85,14 @@ export function useAssistantSession(options) {
                 next_page_token: null,
             };
         }
-    }, [client, onError, options]);
+    }, [client, defaultScope, onError]);
     const createConversation = useCallback(async (input = {}) => {
-        applyPodScope(client, input.podId ?? options.podId ?? null);
+        applyPodScope(client, input.podId ?? defaultPodId ?? null);
         const payload = {
             title: input.title ?? undefined,
-            pod_id: input.podId ?? options.podId ?? client.podId ?? undefined,
-            assistant_id: input.assistantId ?? options.assistantId ?? undefined,
-            organization_id: input.organizationId ?? options.organizationId ?? undefined,
+            pod_id: input.podId ?? defaultPodId ?? client.podId ?? undefined,
+            assistant_id: input.assistantId ?? defaultAssistantId ?? undefined,
+            organization_id: input.organizationId ?? defaultOrganizationId ?? undefined,
             model: typeof input.model === "undefined"
                 ? undefined
                 : input.model,
@@ -100,13 +105,13 @@ export function useAssistantSession(options) {
             setMessages([]);
         }
         return created;
-    }, [client, options.assistantId, options.organizationId, options.podId]);
+    }, [client, defaultAssistantId, defaultOrganizationId, defaultPodId]);
     const refreshConversation = useCallback(async (explicitConversationId) => {
         const id = explicitConversationId ?? conversationId;
         if (!id)
             return null;
         try {
-            const scope = normalizeScope(client, options);
+            const scope = normalizeScope(client, defaultScope);
             applyPodScope(client, scope.podId);
             const nextConversation = await client.conversations.get(id, {
                 pod_id: scope.podId ?? undefined,
@@ -127,14 +132,14 @@ export function useAssistantSession(options) {
             onError?.(refreshError);
             return null;
         }
-    }, [client, conversationId, onError, onStatus, options]);
+    }, [client, conversationId, defaultScope, onError, onStatus]);
     const loadMessages = useCallback(async (input = {}) => {
         const id = input.conversationId ?? conversationId;
         if (!id) {
             return { items: [], limit: input.limit ?? 20, next_page_token: null };
         }
         try {
-            const scope = normalizeScope(client, options);
+            const scope = normalizeScope(client, defaultScope);
             applyPodScope(client, scope.podId);
             const response = await client.conversations.messages.list(id, {
                 pod_id: scope.podId ?? undefined,
@@ -159,7 +164,7 @@ export function useAssistantSession(options) {
                 next_page_token: null,
             };
         }
-    }, [client, conversationId, onError, options]);
+    }, [client, conversationId, defaultScope, onError]);
     const consume = useCallback(async (stream, controller) => {
         setIsStreaming(true);
         setError(null);
@@ -198,6 +203,10 @@ export function useAssistantSession(options) {
     const ensureConversation = useCallback(async (overrideConversationId, options) => {
         const existingId = overrideConversationId ?? conversationId;
         if (existingId) {
+            // Avoid a network roundtrip on every send when we already have this conversation in state.
+            if (conversation?.id === existingId) {
+                return conversation;
+            }
             const existing = await refreshConversation(existingId);
             if (existing)
                 return existing;
@@ -210,14 +219,14 @@ export function useAssistantSession(options) {
             ...(options.createConversation ?? {}),
             setActive: true,
         });
-    }, [conversationId, createConversation, refreshConversation]);
+    }, [conversation, conversationId, createConversation, refreshConversation]);
     const sendMessage = useCallback(async (content, input = {}) => {
         const resolvedConversation = await ensureConversation(input.conversationId, input);
         const resolvedConversationId = requireConversationId(resolvedConversation.id);
         cancel();
         const controller = new AbortController();
         abortRef.current = controller;
-        const scope = normalizeScope(client, options, input.createConversation);
+        const scope = normalizeScope(client, defaultScope, input.createConversation);
         applyPodScope(client, scope.podId);
         const stream = await client.conversations.sendMessageStream(resolvedConversationId, { content }, {
             pod_id: scope.podId ?? undefined,
@@ -225,28 +234,28 @@ export function useAssistantSession(options) {
         });
         await consume(stream, controller);
         return resolvedConversation;
-    }, [cancel, client, consume, ensureConversation, options]);
+    }, [cancel, client, consume, defaultScope, ensureConversation]);
     const resume = useCallback(async (explicitConversationId) => {
         const id = requireConversationId(explicitConversationId ?? conversationId);
         cancel();
         const controller = new AbortController();
         abortRef.current = controller;
-        const scope = normalizeScope(client, options);
+        const scope = normalizeScope(client, defaultScope);
         applyPodScope(client, scope.podId);
         const stream = await client.conversations.resumeStream(id, {
             pod_id: scope.podId ?? undefined,
             signal: controller.signal,
         });
         await consume(stream, controller);
-    }, [cancel, client, consume, conversationId, options]);
+    }, [cancel, client, consume, conversationId, defaultScope]);
     const stop = useCallback(async (explicitConversationId) => {
         const id = requireConversationId(explicitConversationId ?? conversationId);
-        const scope = normalizeScope(client, options);
+        const scope = normalizeScope(client, defaultScope);
         applyPodScope(client, scope.podId);
         await client.conversations.stopRun(id, {
             pod_id: scope.podId ?? undefined,
         });
-    }, [client, conversationId, options]);
+    }, [client, conversationId, defaultScope]);
     const clearMessages = useCallback(() => {
         setMessages([]);
     }, []);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lemma-sdk",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Official TypeScript SDK for Lemma pod-scoped APIs",
   "type": "module",
   "main": "dist/index.js",