lemma-sdk 0.2.36 → 0.2.38

package/dist/openapi_client/services/WorkflowsService.js

@@ -257,7 +257,7 @@ export class WorkflowsService {
     }
     /**
      * List Workflow Installs
-     * List the current user's installations for a workflow.
+     * List workflow installations visible to the current user. `GLOBAL` workflows return the pod-level install; `USER` workflows return the current user's install.
      * @param podId
      * @param workflowName
      * @returns WorkflowInstallListResponse Successful Response

package/dist/react/index.d.ts

@@ -2,18 +2,12 @@ export { AuthGuard } from "./AuthGuard.js";
 export type { AuthGuardProps } from "./AuthGuard.js";
 export { useAuth } from "./useAuth.js";
 export type { UseAuthResult } from "./useAuth.js";
-export { useAssistantRun } from "./useAssistantRun.js";
-export type { UseAssistantRunOptions, UseAssistantRunResult } from "./useAssistantRun.js";
 export { useConversations } from "./useConversations.js";
 export type { UseConversationsOptions, UseConversationsResult } from "./useConversations.js";
 export { useConversation } from "./useConversation.js";
 export type { UseConversationOptions, UseConversationResult } from "./useConversation.js";
 export { useConversationMessages } from "./useConversationMessages.js";
 export type { UseConversationMessagesOptions, UseConversationMessagesResult, } from "./useConversationMessages.js";
-export { useAgentRun } from "./useAgentRun.js";
-export type { UseAgentRunOptions, UseAgentRunResult } from "./useAgentRun.js";
-export { useAgentRuns } from "./useAgentRuns.js";
-export type { UseAgentRunsOptions, UseAgentRunsResult } from "./useAgentRuns.js";
 export { useAgentInputSchema } from "./useAgentInputSchema.js";
 export type { UseAgentInputSchemaOptions, UseAgentInputSchemaResult, } from "./useAgentInputSchema.js";
 export { useAssistantSession } from "./useAssistantSession.js";
@@ -92,8 +86,6 @@ export { useSchemaForm } from "./useSchemaForm.js";
 export type { UseSchemaFormOptions, UseSchemaFormResult } from "./useSchemaForm.js";
 export { useAssistantController } from "./useAssistantController.js";
 export type { AssistantAction, AssistantConversationScope, AssistantMessagePart, AssistantRenderableMessage, AssistantToolInvocation, UseAssistantControllerOptions, UseAssistantControllerResult, } from "./useAssistantController.js";
-export { useTaskSession } from "./useTaskSession.js";
-export type { CreateTaskInput, UseTaskSessionOptions, UseTaskSessionResult, } from "./useTaskSession.js";
 export { useFunctionSession } from "./useFunctionSession.js";
 export type { UseFunctionSessionOptions, UseFunctionSessionResult, } from "./useFunctionSession.js";
 export { useFunctionRun } from "./useFunctionRun.js";

package/dist/react/index.js

@@ -1,11 +1,8 @@
 export { AuthGuard } from "./AuthGuard.js";
 export { useAuth } from "./useAuth.js";
-export { useAssistantRun } from "./useAssistantRun.js";
 export { useConversations } from "./useConversations.js";
 export { useConversation } from "./useConversation.js";
 export { useConversationMessages } from "./useConversationMessages.js";
-export { useAgentRun } from "./useAgentRun.js";
-export { useAgentRuns } from "./useAgentRuns.js";
 export { useAgentInputSchema } from "./useAgentInputSchema.js";
 export { useAssistantSession } from "./useAssistantSession.js";
 export { useAssistantRuntime } from "./useAssistantRuntime.js";
@@ -45,7 +42,6 @@ export { useRecordSchema } from "./useRecordSchema.js";
 export { useRecordForm } from "./useRecordForm.js";
 export { useSchemaForm } from "./useSchemaForm.js";
 export { useAssistantController } from "./useAssistantController.js";
-export { useTaskSession } from "./useTaskSession.js";
 export { useFunctionSession } from "./useFunctionSession.js";
 export { useFunctionRun } from "./useFunctionRun.js";
 export { useFunctionRuns } from "./useFunctionRuns.js";

package/dist/react/useAssistantController.d.ts

@@ -2,9 +2,13 @@ import type { LemmaClient } from "../client.js";
 import type { AvailableModelInfo, Conversation, ConversationModel } from "../types.js";
 export interface AssistantConversationScope {
     podId?: string | null;
+    agentName?: string | null;
+    /**
+     * @deprecated Use agentName instead.
+     */
     assistantName?: string | null;
     /**
-     * @deprecated Use assistantName instead.
+     * @deprecated Use agentName instead.
      */
     assistantId?: string | null;
     organizationId?: string | null;
@@ -85,4 +89,4 @@ export interface UseAssistantControllerResult {
     clearMessages: () => void;
     stop: () => void;
 }
-export declare function useAssistantController({ client, podId, assistantName, assistantId, organizationId, enabled, }: UseAssistantControllerOptions): UseAssistantControllerResult;
+export declare function useAssistantController({ client, podId, agentName, assistantName, assistantId, organizationId, enabled, }: UseAssistantControllerOptions): UseAssistantControllerResult;

package/dist/react/useAssistantController.js

@@ -539,7 +539,38 @@ function isConversationRunning(status) {
     }
     return true;
 }
-export function useAssistantController({ client, podId, assistantName, assistantId, organizationId, enabled = true, }) {
+function resolveScopedClient(client, podId) {
+    if (podId && podId !== client.podId) {
+        return client.withPod(podId);
+    }
+    return client;
+}
+async function uploadPersonalFiles(client, files) {
+    const uploaded = [];
+    for (const file of files) {
+        uploaded.push(await client.files.upload(file, {
+            name: file.name,
+            namespace: "PRIVATE",
+        }));
+    }
+    return uploaded;
+}
+function formatPersonalFileReferences(files) {
+    return files
+        .map((file) => {
+        const pathParts = file.path.split("/").filter(Boolean);
+        const name = file.name || pathParts[pathParts.length - 1] || file.path;
+        return `- ${name}: ${file.path}`;
+    })
+        .join("\n");
+}
+function appendPersonalFileReferences(content, files) {
+    if (files.length === 0)
+        return content;
+    const references = formatPersonalFileReferences(files);
+    return `${content}\n\nPersonal files available to this run:\n${references}`;
+}
+export function useAssistantController({ client, podId, agentName, assistantName, assistantId, organizationId, enabled = true, }) {
     const [localError, setLocalError] = useState(null);
     const [conversations, setConversations] = useState([]);
     const [activeConversationId, setActiveConversationId] = useState(null);
@@ -564,22 +595,25 @@ export function useAssistantController({ client, podId, assistantName, assistant
     const resumeIfRunningRef = useRef(null);
     const scope = useMemo(() => ({
         podId: podId ?? null,
+        agentName: agentName ?? assistantName ?? assistantId ?? null,
         assistantName: assistantName ?? assistantId ?? null,
         assistantId: assistantId ?? null,
         organizationId: organizationId ?? null,
-    }), [assistantId, assistantName, organizationId, podId]);
+    }), [agentName, assistantId, assistantName, organizationId, podId]);
     const scopeKey = useMemo(() => JSON.stringify({
         podId: scope.podId ?? null,
+        agentName: scope.agentName ?? null,
         assistantName: scope.assistantName ?? null,
         assistantId: scope.assistantId ?? null,
         organizationId: scope.organizationId ?? null,
-    }), [scope.assistantId, scope.assistantName, scope.organizationId, scope.podId]);
+    }), [scope.agentName, scope.assistantId, scope.assistantName, scope.organizationId, scope.podId]);
     const handleAssistantSessionError = useCallback((sessionError) => {
-        setLocalError((prev) => prev || (sessionError instanceof Error ? sessionError.message : "Assistant session failed"));
+        setLocalError((prev) => prev || (sessionError instanceof Error ? sessionError.message : "Agent session failed"));
     }, []);
     const assistantSession = useAssistantSession({
         client,
         podId: scope.podId ?? undefined,
+        agentName: scope.agentName ?? undefined,
         assistantName: scope.assistantName ?? undefined,
         assistantId: scope.assistantId ?? undefined,
         organizationId: scope.organizationId ?? undefined,
@@ -1002,12 +1036,13 @@ export function useAssistantController({ client, podId, assistantName, assistant
                 throw new Error("Conversation could not be initialized");
             }
             const finalConversationId = conversationId;
+            let messageContent = trimmed;
             if (pendingFiles.length > 0) {
                 setIsUploadingFiles(true);
                 try {
-                    await Promise.all(pendingFiles.map((file) => client.resources.upload("conversation", finalConversationId, file, {
-                        name: file.name,
-                    })));
+                    const fileClient = resolveScopedClient(client, scope.podId);
+                    const uploadedFiles = await uploadPersonalFiles(fileClient, pendingFiles);
+                    messageContent = appendPersonalFileReferences(trimmed, uploadedFiles);
                     setPendingFiles([]);
                     touchConversation(finalConversationId, { updated_at: new Date().toISOString() });
                 }
@@ -1015,14 +1050,13 @@ export function useAssistantController({ client, podId, assistantName, assistant
                     setIsUploadingFiles(false);
                 }
             }
-            appendOptimisticUserMessage(trimmed, {
+            appendOptimisticUserMessage(messageContent, {
                 conversationId: finalConversationId,
             });
             setIsStreaming(true);
             touchConversation(finalConversationId, { status: "running" });
-            await sessionSendMessage(trimmed, {
+            await sessionSendMessage(messageContent, {
                 conversationId: finalConversationId,
-                createIfMissing: false,
             });
             touchConversation(finalConversationId, { updated_at: new Date().toISOString() });
         }
@@ -1038,12 +1072,12 @@ export function useAssistantController({ client, podId, assistantName, assistant
     }, [
         activeConversationId,
         appendOptimisticUserMessage,
-        client.resources,
         enabled,
         ensureConversation,
         isStreaming,
         pendingFiles,
         resetConversationState,
+        scope.podId,
         sessionIsStreaming,
         sessionSendMessage,
         touchConversation,
@@ -1061,9 +1095,13 @@ export function useAssistantController({ client, podId, assistantName, assistant
         }
         setIsUploadingFiles(true);
         try {
-            await Promise.all(normalizedFiles.map((file) => client.resources.upload("conversation", activeId, file, {
-                name: file.name,
-            })));
+            const fileClient = resolveScopedClient(client, scope.podId);
+            const uploadedFiles = await uploadPersonalFiles(fileClient, normalizedFiles);
+            const fileMessage = `Personal files available to this run:\n${formatPersonalFileReferences(uploadedFiles)}`;
+            setIsStreaming(true);
+            await sessionSendMessage(fileMessage, {
+                conversationId: activeId,
+            });
             await loadConversationMessages(activeId);
             touchConversation(activeId, { updated_at: new Date().toISOString() });
         }
@@ -1072,15 +1110,18 @@ export function useAssistantController({ client, podId, assistantName, assistant
             throw err;
         }
         finally {
+            setIsStreaming(false);
             setIsUploadingFiles(false);
         }
     }, [
-        client.resources,
+        client,
         enabled,
         isLoading,
         isUploadingFiles,
         loadConversationMessages,
         queuePendingFiles,
+        scope.podId,
+        sessionSendMessage,
         touchConversation,
     ]);
     const { pendingActions, completedActions } = useMemo(() => {

package/dist/react/useAssistantSession.d.ts

@@ -3,9 +3,13 @@ import { type SseRawEvent } from "../streams.js";
 import type { Conversation, ConversationMessage, ConversationModel, CursorPage } from "../types.js";
 interface ConversationScope {
     podId?: string | null;
+    agentName?: string | null;
+    /**
+     * @deprecated Use agentName instead.
+     */
     assistantName?: string | null;
     /**
-     * @deprecated Use assistantName instead.
+     * @deprecated Use agentName instead.
      */
     assistantId?: string | null;
     organizationId?: string | null;
@@ -13,9 +17,13 @@ interface ConversationScope {
 export interface UseAssistantSessionOptions {
     client: LemmaClient;
     podId?: string;
+    agentName?: string;
+    /**
+     * @deprecated Use agentName instead.
+     */
     assistantName?: string;
     /**
-     * @deprecated Use assistantName instead.
+     * @deprecated Use agentName instead.
      */
     assistantId?: string;
     organizationId?: string;
@@ -32,9 +40,13 @@ export interface CreateConversationInput {
     title?: string | null;
     model?: ConversationModel | null;
     podId?: string | null;
+    agentName?: string | null;
+    /**
+     * @deprecated Use agentName instead.
+     */
     assistantName?: string | null;
     /**
-     * @deprecated Use assistantName instead.
+     * @deprecated Use agentName instead.
      */
     assistantId?: string | null;
     organizationId?: string | null;
@@ -42,8 +54,6 @@ export interface CreateConversationInput {
 }
 export interface SendAssistantMessageOptions {
     conversationId?: string | null;
-    createIfMissing?: boolean;
-    createConversation?: CreateConversationInput;
     syncOnTurnEnd?: boolean;
 }
 export interface ResumeAssistantOptions {

package/dist/react/useAssistantSession.js

@@ -17,14 +17,17 @@ function requireConversationId(conversationId) {
     return conversationId;
 }
 function normalizeScope(client, defaults, override) {
-    const resolvedAssistantName = override?.assistantName
+    const resolvedAgentName = override?.agentName
+        ?? override?.assistantName
         ?? override?.assistantId
+        ?? defaults.agentName
         ?? defaults.assistantName
         ?? defaults.assistantId
         ?? null;
     return {
         podId: override?.podId ?? defaults.podId ?? client.podId ?? null,
-        assistantName: resolvedAssistantName,
+        agentName: resolvedAgentName,
+        assistantName: override?.assistantName ?? defaults.assistantName ?? null,
         assistantId: override?.assistantId ?? defaults.assistantId ?? null,
         organizationId: override?.organizationId ?? defaults.organizationId ?? null,
     };
@@ -48,7 +51,7 @@ function resolveResumeInput(input) {
     return input ?? {};
 }
 export function useAssistantSession(options) {
-    const { client, podId: defaultPodId, assistantName: defaultAssistantName, assistantId: defaultAssistantId, organizationId: defaultOrganizationId, conversationId: externalConversationId = null, autoLoad = true, autoResume = false, syncOnTurnEnd = false, onEvent, onStatus, onMessage, onError, } = options;
+    const { client, podId: defaultPodId, agentName: defaultAgentName, assistantName: defaultAssistantName, assistantId: defaultAssistantId, organizationId: defaultOrganizationId, conversationId: externalConversationId = null, autoLoad = true, autoResume = false, syncOnTurnEnd = false, onEvent, onStatus, onMessage, onError, } = options;
     const [conversationId, setConversationIdState] = useState(externalConversationId);
     const [conversation, setConversation] = useState(null);
     const [status, setStatus] = useState(undefined);
@@ -150,10 +153,11 @@ export function useAssistantSession(options) {
     }, []);
     const defaultScope = useMemo(() => ({
         podId: defaultPodId ?? null,
+        agentName: defaultAgentName ?? defaultAssistantName ?? defaultAssistantId ?? null,
         assistantName: defaultAssistantName ?? defaultAssistantId ?? null,
         assistantId: defaultAssistantId ?? null,
         organizationId: defaultOrganizationId ?? null,
-    }), [defaultAssistantId, defaultAssistantName, defaultOrganizationId, defaultPodId]);
+    }), [defaultAgentName, defaultAssistantId, defaultAssistantName, defaultOrganizationId, defaultPodId]);
     const listConversations = useCallback(async (input = {}) => {
         setError(null);
         try {
@@ -161,8 +165,7 @@ export function useAssistantSession(options) {
             const scopedClient = applyPodScope(client, scope.podId);
             const response = await scopedClient.conversations.list({
                 pod_id: scope.podId ?? undefined,
-                assistant_name: scope.assistantName ?? scope.assistantId ?? undefined,
-                organization_id: scope.organizationId ?? undefined,
+                agent_name: scope.agentName ?? undefined,
                 limit: input.limit,
                 page_token: input.pageToken,
             });
@@ -191,12 +194,13 @@ export function useAssistantSession(options) {
             const payload = {
                 title: input.title ?? undefined,
                 pod_id: input.podId ?? defaultPodId ?? scopedClient.podId ?? undefined,
-                assistant_name: input.assistantName
+                agent_name: input.agentName
+                    ?? input.assistantName
                     ?? input.assistantId
+                    ?? defaultAgentName
                     ?? defaultAssistantName
                     ?? defaultAssistantId
                     ?? undefined,
-                organization_id: input.organizationId ?? defaultOrganizationId ?? undefined,
                 model: typeof input.model === "undefined"
                     ? undefined
                     : input.model,
@@ -205,7 +209,7 @@ export function useAssistantSession(options) {
             if (input.setActive !== false) {
                 setConversationIdState(created.id);
                 setConversation(created);
-                setConversationStatus(created.status);
+                setConversationStatus(created.status ?? undefined);
                 setMessages([]);
                 clearStreamingText();
                 autoResumedKeyRef.current = null;
@@ -221,9 +225,9 @@ export function useAssistantSession(options) {
     }, [
         clearStreamingText,
         client,
+        defaultAgentName,
         defaultAssistantId,
         defaultAssistantName,
-        defaultOrganizationId,
         defaultPodId,
         setConversationStatus,
     ]);
@@ -338,7 +342,7 @@ export function useAssistantSession(options) {
         }
         catch (streamError) {
             if (!(streamError instanceof Error && streamError.name === "AbortError")) {
-                const normalized = normalizeError(streamError, "Failed to stream assistant run.");
+                const normalized = normalizeError(streamError, "Failed to stream conversation.");
                 setError(normalized);
                 onErrorRef.current?.(streamError);
             }
@@ -358,7 +362,7 @@ export function useAssistantSession(options) {
         setConversationStatus,
         syncOnTurnEnd,
     ]);
-    const ensureConversation = useCallback(async (overrideConversationId, options) => {
+    const ensureConversation = useCallback(async (overrideConversationId) => {
         const existingId = overrideConversationId ?? conversationId;
         if (existingId) {
             // Avoid a network roundtrip on every send when we already have this conversation in state.
@@ -370,23 +374,17 @@ export function useAssistantSession(options) {
                 return existing;
             throw new Error("Failed to resolve existing conversation.");
         }
-        if (options?.createIfMissing !== true) {
-            throw new Error("conversationId is required.");
-        }
-        return createConversation({
-            ...(options.createConversation ?? {}),
-            setActive: true,
-        });
-    }, [conversation, conversationId, createConversation, refreshConversation]);
+        throw new Error("conversationId is required. Create a conversation before sending a message.");
+    }, [conversation, conversationId, refreshConversation]);
     const sendMessage = useCallback(async (content, input = {}) => {
         setError(null);
         try {
-            const resolvedConversation = await ensureConversation(input.conversationId, input);
+            const resolvedConversation = await ensureConversation(input.conversationId);
             const resolvedConversationId = requireConversationId(resolvedConversation.id);
             cancel();
             const controller = new AbortController();
             abortRef.current = controller;
-            const scope = normalizeScope(client, defaultScope, input.createConversation);
+            const scope = normalizeScope(client, defaultScope);
             const scopedClient = applyPodScope(client, scope.podId);
             const stream = await scopedClient.conversations.sendMessageStream(resolvedConversationId, { content }, {
                 pod_id: scope.podId ?? undefined,
@@ -402,7 +400,7 @@ export function useAssistantSession(options) {
             return resolvedConversation;
         }
         catch (sendError) {
-            const normalized = normalizeError(sendError, "Failed to send assistant message.");
+            const normalized = normalizeError(sendError, "Failed to send agent message.");
             setError(normalized);
             onErrorRef.current?.(sendError);
             throw normalized;
@@ -434,7 +432,7 @@ export function useAssistantSession(options) {
             });
         }
         catch (resumeError) {
-            const normalized = normalizeError(resumeError, "Failed to resume assistant run.");
+            const normalized = normalizeError(resumeError, "Failed to resume conversation.");
             setError(normalized);
             onErrorRef.current?.(resumeError);
             throw normalized;
@@ -487,7 +485,7 @@ export function useAssistantSession(options) {
             clearStreamingText();
         }
         catch (stopError) {
-            const normalized = normalizeError(stopError, "Failed to stop assistant run.");
+            const normalized = normalizeError(stopError, "Failed to stop conversation.");
             setError(normalized);
             onErrorRef.current?.(stopError);
             throw normalized;
@@ -536,7 +534,7 @@ export function useAssistantSession(options) {
             .catch((bootstrapError) => {
             if (cancelled)
                 return;
-            const normalized = normalizeError(bootstrapError, "Failed to load assistant conversation.");
+            const normalized = normalizeError(bootstrapError, "Failed to load agent conversation.");
             setError(normalized);
             onErrorRef.current?.(bootstrapError);
         })

package/dist/react/useConversationMessages.d.ts

@@ -5,9 +5,13 @@ import { type CreateConversationInput, type ResumeAssistantOptions, type SendAss
 export interface UseConversationMessagesOptions {
     client: LemmaClient;
     podId?: string;
+    agentName?: string;
+    /**
+     * @deprecated Use agentName instead.
+     */
     assistantName?: string;
     /**
-     * @deprecated Use assistantName instead.
+     * @deprecated Use agentName instead.
      */
     assistantId?: string;
     organizationId?: string;
@@ -56,4 +60,4 @@ export interface UseConversationMessagesResult {
     clearMessages: () => void;
     createConversation: (input?: CreateConversationInput) => Promise<Conversation>;
 }
-export declare function useConversationMessages({ client, podId, assistantName, assistantId, organizationId, conversationId, enabled, autoLoad, autoResume, limit, syncOnTurnEnd, onEvent, onStatus, onMessage, onError, }: UseConversationMessagesOptions): UseConversationMessagesResult;
+export declare function useConversationMessages({ client, podId, agentName, assistantName, assistantId, organizationId, conversationId, enabled, autoLoad, autoResume, limit, syncOnTurnEnd, onEvent, onStatus, onMessage, onError, }: UseConversationMessagesOptions): UseConversationMessagesResult;

package/dist/react/useConversationMessages.js

@@ -12,7 +12,7 @@ function isSettledStatus(status, isStreaming) {
         return true;
     return !isConversationRunningStatus(normalized);
 }
-export function useConversationMessages({ client, podId, assistantName, assistantId, organizationId, conversationId = null, enabled = true, autoLoad = true, autoResume = false, limit = 100, syncOnTurnEnd = false, onEvent, onStatus, onMessage, onError, }) {
+export function useConversationMessages({ client, podId, agentName, assistantName, assistantId, organizationId, conversationId = null, enabled = true, autoLoad = true, autoResume = false, limit = 100, syncOnTurnEnd = false, onEvent, onStatus, onMessage, onError, }) {
     const [nextPageToken, setNextPageToken] = useState(null);
     const [isLoading, setIsLoading] = useState(false);
     const [isLoadingOlder, setIsLoadingOlder] = useState(false);
@@ -21,6 +21,7 @@ export function useConversationMessages({ client, podId, assistantName, assistan
     const { conversation: sessionConversation, conversationId: sessionConversationId, messages: sessionMessages, status, streamingText, isStreaming, error, refreshConversation, loadMessages, sendMessage, resume, resumeIfRunning, stop, cancel, clearMessages: clearSessionMessages, createConversation, } = useAssistantSession({
         client,
         podId,
+        agentName: agentName ?? assistantName ?? assistantId,
         assistantName,
         assistantId,
         organizationId,

package/dist/react/useConversations.d.ts

@@ -4,9 +4,13 @@ import { type CreateConversationInput } from "./useAssistantSession.js";
 export interface UseConversationsOptions {
     client: LemmaClient;
     podId?: string;
+    agentName?: string;
+    /**
+     * @deprecated Use agentName instead.
+     */
     assistantName?: string;
     /**
-     * @deprecated Use assistantName instead.
+     * @deprecated Use agentName instead.
      */
     assistantId?: string;
     organizationId?: string;
@@ -49,4 +53,4 @@ export interface UseConversationsResult {
     createAndSelectConversation: (input?: Omit<CreateConversationInput, "setActive">) => Promise<Conversation>;
     ensureConversation: (input?: Omit<CreateConversationInput, "setActive">) => Promise<Conversation>;
 }
-export declare function useConversations({ client, podId, assistantName, assistantId, organizationId, enabled, autoLoad, autoSelectFirst, limit, pageToken, initialConversationId, }: UseConversationsOptions): UseConversationsResult;
+export declare function useConversations({ client, podId, agentName, assistantName, assistantId, organizationId, enabled, autoLoad, autoSelectFirst, limit, pageToken, initialConversationId, }: UseConversationsOptions): UseConversationsResult;

package/dist/react/useConversations.js

@@ -8,7 +8,7 @@ function sortConversationsByUpdatedAt(conversations) {
         return bTime - aTime;
     });
 }
-export function useConversations({ client, podId, assistantName, assistantId, organizationId, enabled = true, autoLoad = true, autoSelectFirst = true, limit = 20, pageToken, initialConversationId = null, }) {
+export function useConversations({ client, podId, agentName, assistantName, assistantId, organizationId, enabled = true, autoLoad = true, autoSelectFirst = true, limit = 20, pageToken, initialConversationId = null, }) {
     const [conversations, setConversations] = useState([]);
     const [total, setTotal] = useState(0);
     const [nextPageToken, setNextPageToken] = useState(null);
@@ -17,13 +17,15 @@ export function useConversations({ client, podId, assistantName, assistantId, or
     const [isLoadingMore, setIsLoadingMore] = useState(false);
     const scopeKey = useMemo(() => JSON.stringify({
         podId: podId ?? null,
-        assistantName: assistantName ?? assistantId ?? null,
+        agentName: agentName ?? assistantName ?? assistantId ?? null,
+        assistantName: assistantName ?? null,
         assistantId: assistantId ?? null,
         organizationId: organizationId ?? null,
-    }), [assistantId, assistantName, organizationId, podId]);
+    }), [agentName, assistantId, assistantName, organizationId, podId]);
     const { error, listConversations, createConversation: sessionCreateConversation, } = useAssistantSession({
         client,
         podId,
+        agentName: agentName ?? assistantName ?? assistantId,
         assistantName,
         assistantId,
         organizationId,
@@ -90,7 +92,7 @@ export function useConversations({ client, podId, assistantName, assistantId, or
         const createdConversation = await sessionCreateConversation({
             ...input,
             podId: input.podId ?? podId ?? undefined,
-            assistantName: input.assistantName ?? assistantName ?? assistantId ?? undefined,
+            agentName: input.agentName ?? input.assistantName ?? agentName ?? assistantName ?? assistantId ?? undefined,
             organizationId: input.organizationId ?? organizationId ?? undefined,
             setActive: input.setActive ?? true,
         });
@@ -106,7 +108,7 @@ export function useConversations({ client, podId, assistantName, assistantId, or
             setSelectedConversationId(createdConversation.id);
         }
         return createdConversation;
-    }, [assistantId, assistantName, organizationId, podId, sessionCreateConversation]);
+    }, [agentName, assistantId, assistantName, organizationId, podId, sessionCreateConversation]);
     const createAndSelectConversation = useCallback(async (input = {}) => {
         return createConversation({
             ...input,

package/dist/react/useCreateFolder.d.ts

@@ -1,13 +1,15 @@
 import type { LemmaClient } from "../client.js";
-import type { FileResponse } from "../types.js";
+import type { DatastoreFileNamespace, FileResponse } from "../types.js";
 export interface CreateFolderInput {
     directoryPath?: string;
     parentId?: string;
     description?: string;
+    namespace?: DatastoreFileNamespace | null;
 }
 export interface UseCreateFolderOptions {
     client: LemmaClient;
     podId?: string;
+    namespace?: DatastoreFileNamespace | null;
     enabled?: boolean;
     onSuccess?: (folder: FileResponse) => void;
     onError?: (error: unknown) => void;
@@ -19,4 +21,4 @@ export interface UseCreateFolderResult<TFile extends FileResponse = FileResponse
     createFolder: (name: string, options?: CreateFolderInput) => Promise<TFile | null>;
     reset: () => void;
 }
-export declare function useCreateFolder<TFile extends FileResponse = FileResponse>({ client, podId, enabled, onSuccess, onError, }: UseCreateFolderOptions): UseCreateFolderResult<TFile>;
+export declare function useCreateFolder<TFile extends FileResponse = FileResponse>({ client, podId, namespace, enabled, onSuccess, onError, }: UseCreateFolderOptions): UseCreateFolderResult<TFile>;

package/dist/react/useCreateFolder.js

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { normalizeError, resolvePodClient } from "./utils.js";
-export function useCreateFolder({ client, podId, enabled = true, onSuccess, onError, }) {
+export function useCreateFolder({ client, podId, namespace, enabled = true, onSuccess, onError, }) {
     const [createdFolder, setCreatedFolder] = useState(null);
     const [isSubmitting, setIsSubmitting] = useState(false);
     const [error, setError] = useState(null);
@@ -17,7 +17,10 @@ export function useCreateFolder({ client, podId, enabled = true, onSuccess, onEr
         setError(null);
         try {
             const scopedClient = resolvePodClient(client, podId);
-            const nextFolder = await scopedClient.files.folder.create(trimmedName, options);
+            const nextFolder = await scopedClient.files.folder.create(trimmedName, {
+                ...options,
+                namespace: options.namespace ?? namespace,
+            });
             setCreatedFolder(nextFolder);
             onSuccessRef.current?.(nextFolder);
             return nextFolder;
@@ -31,7 +34,7 @@ export function useCreateFolder({ client, podId, enabled = true, onSuccess, onEr
         finally {
             setIsSubmitting(false);
         }
-    }, [client, enabled, podId]);
+    }, [client, enabled, namespace, podId]);
     const reset = useCallback(() => {
         setCreatedFolder(null);
         setError(null);

package/dist/react/useDeleteFile.d.ts

@@ -1,8 +1,10 @@
 import type { LemmaClient } from "../client.js";
+import type { DatastoreFileNamespace } from "../types.js";
 export interface UseDeleteFileOptions {
     client: LemmaClient;
     podId?: string;
     path?: string | null;
+    namespace?: DatastoreFileNamespace | null;
     enabled?: boolean;
     onSuccess?: (path: string) => void;
     onError?: (error: unknown) => void;
@@ -13,7 +15,8 @@ export interface UseDeleteFileResult {
     error: Error | null;
     remove: (overrides?: {
         path?: string | null;
+        namespace?: DatastoreFileNamespace | null;
     }) => Promise<boolean>;
     reset: () => void;
 }
-export declare function useDeleteFile({ client, podId, path, enabled, onSuccess, onError, }: UseDeleteFileOptions): UseDeleteFileResult;
+export declare function useDeleteFile({ client, podId, path, namespace, enabled, onSuccess, onError, }: UseDeleteFileOptions): UseDeleteFileResult;