lemma-sdk 0.2.22 → 0.2.24

package/README.md

@@ -253,7 +253,7 @@ function SupportAssistant() {
       <AssistantEmbedded
         client={client}
         podId="pod_123"
-        assistantId="uuid"
+        assistantName="support_assistant"
         title="Support Assistant"
         subtitle="Ask questions about this pod."
         placeholder="Message Support Assistant"
@@ -300,7 +300,7 @@ function ControlledAssistant() {
   const assistant = useAssistantController({
     client,
     podId: "pod_123",
-    assistantId: "uuid",
+    assistantName: "support_assistant",
   });
 
   return (
@@ -365,7 +365,7 @@ function CustomAssistantShell() {
   const assistant = useAssistantController({
     client,
     podId: "pod_123",
-    assistantId: "uuid",
+    assistantName: "support_assistant",
   });
 
   const rows = buildDisplayMessageRows(assistant.messages);

package/dist/auth.d.ts

@@ -109,6 +109,7 @@ export declare class AuthManager {
      * This helps recover when signout/session-expiry paths leave local markers behind.
      */
     private clearFrontendSessionMarkers;
+    private applyUnauthenticatedState;
     private clearInjectedToken;
     private rawSignOutViaBackend;
     /**

package/dist/auth.js

@@ -278,6 +278,11 @@ export class AuthManager {
             }
         }
     }
+    applyUnauthenticatedState() {
+        const next = { status: "unauthenticated", user: null };
+        this.setState(next);
+        return next;
+    }
     clearInjectedToken() {
         this.injectedToken = null;
         clearTestingToken();
@@ -386,16 +391,11 @@ export class AuthManager {
             const response = await fetch(`${this.apiUrl}/users/me`, this.getRequestInit({ method: "GET" }));
             // Only 401 means not authenticated — 403 means authenticated but forbidden
             if (response.status === 401) {
-                this.clearFrontendSessionMarkers();
-                const next = { status: "unauthenticated", user: null };
-                this.setState(next);
-                return next;
+                return this.applyUnauthenticatedState();
             }
             if (!response.ok) {
                 // For non-401 errors on /users/me, treat as unauthenticated (conservative)
-                const next = { status: "unauthenticated", user: null };
-                this.setState(next);
-                return next;
+                return this.applyUnauthenticatedState();
             }
             const user = (await response.json());
             const next = { status: "authenticated", user };
@@ -403,9 +403,7 @@ export class AuthManager {
             return next;
         }
         catch {
-            const next = { status: "unauthenticated", user: null };
-            this.setState(next);
-            return next;
+            return this.applyUnauthenticatedState();
         }
     }
     /**
@@ -413,8 +411,7 @@ export class AuthManager {
      * Does NOT redirect — call redirectToAuth() explicitly if desired.
      */
     markUnauthenticated() {
-        this.clearFrontendSessionMarkers();
-        this.setState({ status: "unauthenticated", user: null });
+        this.applyUnauthenticatedState();
     }
     /**
      * Sign out the current user session.
@@ -442,6 +439,9 @@ export class AuthManager {
                 // best effort fallback only
             }
         }
+        // Always clear frontend markers on logout attempt, even if backend session
+        // cleanup is partial. This avoids stale local "EXISTS" signals.
+        this.clearFrontendSessionMarkers();
         const isAuthenticated = await this.isAuthenticatedViaCookie();
         if (!isAuthenticated) {
             this.markUnauthenticated();

package/dist/browser/lemma-client.js

@@ -461,6 +461,11 @@ class AuthManager {
             }
         }
     }
+    applyUnauthenticatedState() {
+        const next = { status: "unauthenticated", user: null };
+        this.setState(next);
+        return next;
+    }
     clearInjectedToken() {
         this.injectedToken = null;
         clearTestingToken();
@@ -569,16 +574,11 @@ class AuthManager {
             const response = await fetch(`${this.apiUrl}/users/me`, this.getRequestInit({ method: "GET" }));
             // Only 401 means not authenticated — 403 means authenticated but forbidden
             if (response.status === 401) {
-                this.clearFrontendSessionMarkers();
-                const next = { status: "unauthenticated", user: null };
-                this.setState(next);
-                return next;
+                return this.applyUnauthenticatedState();
             }
             if (!response.ok) {
                 // For non-401 errors on /users/me, treat as unauthenticated (conservative)
-                const next = { status: "unauthenticated", user: null };
-                this.setState(next);
-                return next;
+                return this.applyUnauthenticatedState();
             }
             const user = (await response.json());
             const next = { status: "authenticated", user };
@@ -586,9 +586,7 @@ class AuthManager {
             return next;
         }
         catch {
-            const next = { status: "unauthenticated", user: null };
-            this.setState(next);
-            return next;
+            return this.applyUnauthenticatedState();
         }
     }
     /**
@@ -596,8 +594,7 @@ class AuthManager {
      * Does NOT redirect — call redirectToAuth() explicitly if desired.
      */
     markUnauthenticated() {
-        this.clearFrontendSessionMarkers();
-        this.setState({ status: "unauthenticated", user: null });
+        this.applyUnauthenticatedState();
     }
     /**
      * Sign out the current user session.
@@ -625,6 +622,9 @@ class AuthManager {
                 // best effort fallback only
             }
         }
+        // Always clear frontend markers on logout attempt, even if backend session
+        // cleanup is partial. This avoids stale local "EXISTS" signals.
+        this.clearFrontendSessionMarkers();
         const isAuthenticated = await this.isAuthenticatedViaCookie();
         if (!isAuthenticated) {
             this.markUnauthenticated();
@@ -1638,32 +1638,38 @@ class ConversationsNamespace {
     list(options = {}) {
         return this.http.request("GET", "/conversations", {
             params: {
-                assistant_id: options.assistant_id,
+                assistant_name: options.assistant_name ?? options.assistant_id,
                 pod_id: this.resolvePodId(options.pod_id),
                 organization_id: options.organization_id,
+                global_only: options.global_only ?? false,
                 limit: options.limit ?? 20,
                 page_token: options.page_token,
             },
         });
     }
-    listByAssistant(assistantId, options = {}) {
-        return this.list({ ...options, assistant_id: assistantId });
+    listByAssistant(assistantName, options = {}) {
+        return this.list({ ...options, assistant_name: assistantName });
+    }
+    listByAssistantName(assistantName, options = {}) {
+        return this.listByAssistant(assistantName, options);
     }
     listModels() {
         return this.http.request("GET", "/models");
     }
     create(payload) {
+        const { assistant_id, ...requestBody } = payload;
         return this.http.request("POST", "/conversations", {
             body: {
-                ...payload,
-                pod_id: this.resolvePodId(payload.pod_id),
+                ...requestBody,
+                pod_id: this.resolvePodId(requestBody.pod_id),
+                assistant_name: requestBody.assistant_name ?? assistant_id,
             },
         });
     }
-    createForAssistant(assistantId, payload = {}) {
+    createForAssistant(assistantName, payload = {}) {
         return this.create({
             ...payload,
-            assistant_id: assistantId,
+            assistant_name: assistantName,
         });
     }
     get(conversationId, options = {}) {
@@ -1949,6 +1955,35 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FilesNamespace = void 0;
 const SearchMethod_js_1 = require("./openapi_client/models/SearchMethod.js");
 const FilesService_js_1 = require("./openapi_client/services/FilesService.js");
+function joinDatastorePath(basePath, leaf) {
+    const normalizedLeaf = leaf.replace(/^\/+/, "");
+    const trimmedBase = (basePath ?? "/").trim();
+    const normalizedBase = trimmedBase.length > 0 ? trimmedBase : "/";
+    if (normalizedBase === "/") {
+        return `/${normalizedLeaf}`;
+    }
+    return `${normalizedBase.replace(/\/+$/, "")}/${normalizedLeaf}`;
+}
+function getDirectoryPath(path) {
+    const normalized = path.trim();
+    if (!normalized || normalized === "/") {
+        return "/";
+    }
+    const withoutTrailing = normalized.replace(/\/+$/, "");
+    const index = withoutTrailing.lastIndexOf("/");
+    if (index <= 0) {
+        return "/";
+    }
+    return withoutTrailing.slice(0, index);
+}
+function getBaseName(path) {
+    const normalized = path.trim().replace(/\/+$/, "");
+    const index = normalized.lastIndexOf("/");
+    if (index === -1) {
+        return normalized;
+    }
+    return normalized.slice(index + 1);
+}
 class FilesNamespace {
     constructor(client, http, podId) {
         this.client = client;
@@ -1957,22 +1992,22 @@ class FilesNamespace {
         this.folder = {
             create: (name, options = {}) => {
                 const payload = {
-                    name,
+                    path: joinDatastorePath(options.directoryPath ?? options.parentId, name),
                     description: options.description,
-                    parent_id: options.parentId,
                 };
                 return this.client.request(() => FilesService_js_1.FilesService.fileFolderCreate(this.podId(), payload));
             },
         };
     }
     list(options = {}) {
-        return this.client.request(() => FilesService_js_1.FilesService.fileList(this.podId(), options.parentId, options.limit ?? 100, options.pageToken));
+        const directoryPath = options.directoryPath ?? options.parentId ?? "/";
+        return this.client.request(() => FilesService_js_1.FilesService.fileList(this.podId(), directoryPath, options.limit ?? 100, options.pageToken));
     }
-    get(fileId) {
-        return this.client.request(() => FilesService_js_1.FilesService.fileGet(this.podId(), fileId));
+    get(path) {
+        return this.client.request(() => FilesService_js_1.FilesService.fileGet(this.podId(), path));
     }
-    delete(fileId) {
-        return this.client.request(() => FilesService_js_1.FilesService.fileDelete(this.podId(), fileId));
+    delete(path) {
+        return this.client.request(() => FilesService_js_1.FilesService.fileDelete(this.podId(), path));
     }
     search(query, options = {}) {
         return this.client.request(() => FilesService_js_1.FilesService.fileSearch(this.podId(), {
@@ -1981,28 +2016,37 @@ class FilesNamespace {
             search_method: options.searchMethod ?? SearchMethod_js_1.SearchMethod.HYBRID,
         }));
     }
-    download(fileId) {
-        return this.http.requestBytes("GET", `/pods/${this.podId()}/datastore/files/${fileId}/download`);
+    download(path) {
+        const encodedPath = encodeURIComponent(path);
+        return this.http.requestBytes("GET", `/pods/${this.podId()}/datastore/files/download?path=${encodedPath}`);
     }
     upload(file, options = {}) {
         const payload = {
             data: file,
             name: options.name ?? (file instanceof File ? file.name : undefined),
             description: options.description,
-            parent_id: options.parentId,
+            directory_path: options.directoryPath ?? options.parentId ?? "/",
             search_enabled: options.searchEnabled ?? true,
         };
         return this.client.request(() => FilesService_js_1.FilesService.fileUpload(this.podId(), payload));
     }
-    update(fileId, options = {}) {
+    update(path, options = {}) {
+        const targetDirectory = options.directoryPath ?? options.parentId;
+        const resolvedNewPath = options.newPath
+            ?? (options.name
+                ? joinDatastorePath(targetDirectory ?? getDirectoryPath(path), options.name)
+                : undefined)
+            ?? (targetDirectory
+                ? joinDatastorePath(targetDirectory, getBaseName(path))
+                : undefined);
         const payload = {
+            path,
             data: options.file,
-            name: options.name,
             description: options.description,
-            parent_id: options.parentId,
+            new_path: resolvedNewPath,
             search_enabled: options.searchEnabled,
         };
-        return this.client.request(() => FilesService_js_1.FilesService.fileUpdate(this.podId(), fileId, payload));
+        return this.client.request(() => FilesService_js_1.FilesService.fileUpdate(this.podId(), payload));
     }
 }
 exports.FilesNamespace = FilesNamespace;
@@ -2034,13 +2078,13 @@ class FilesService {
     /**
      * List Files
      * @param podId
-     * @param parentId
+     * @param directoryPath
      * @param limit
      * @param pageToken
      * @returns FileListResponse Successful Response
      * @throws ApiError
      */
-    static fileList(podId, parentId, limit = 100, pageToken) {
+    static fileList(podId, directoryPath = '/', limit = 100, pageToken) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
             method: 'GET',
             url: '/pods/{pod_id}/datastore/files',
@@ -2048,7 +2092,7 @@ class FilesService {
                 'pod_id': podId,
             },
             query: {
-                'parent_id': parentId,
+                'directory_path': directoryPath,
                 'limit': limit,
                 'page_token': pageToken,
             },
@@ -2079,81 +2123,86 @@ class FilesService {
         });
     }
     /**
-     * Create Folder
+     * Delete File
      * @param podId
-     * @param requestBody
-     * @returns FileResponse Successful Response
+     * @param path
+     * @returns DatastoreMessageResponse Successful Response
      * @throws ApiError
      */
-    static fileFolderCreate(podId, requestBody) {
+    static fileDelete(podId, path) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
-            method: 'POST',
-            url: '/pods/{pod_id}/datastore/files/folders',
+            method: 'DELETE',
+            url: '/pods/{pod_id}/datastore/files/by-path',
             path: {
                 'pod_id': podId,
             },
-            body: requestBody,
-            mediaType: 'application/json',
+            query: {
+                'path': path,
+            },
             errors: {
                 422: `Validation Error`,
             },
         });
     }
     /**
-     * Search Files
+     * Get File
      * @param podId
-     * @param requestBody
-     * @returns FileSearchResponse Successful Response
+     * @param path
+     * @returns FileResponse Successful Response
      * @throws ApiError
      */
-    static fileSearch(podId, requestBody) {
+    static fileGet(podId, path) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
-            method: 'POST',
-            url: '/pods/{pod_id}/datastore/files/search',
+            method: 'GET',
+            url: '/pods/{pod_id}/datastore/files/by-path',
             path: {
                 'pod_id': podId,
             },
-            body: requestBody,
-            mediaType: 'application/json',
+            query: {
+                'path': path,
+            },
             errors: {
                 422: `Validation Error`,
             },
         });
     }
     /**
-     * Delete File
+     * Update File
      * @param podId
-     * @param fileId
-     * @returns DatastoreMessageResponse Successful Response
+     * @param formData
+     * @returns FileResponse Successful Response
      * @throws ApiError
      */
-    static fileDelete(podId, fileId) {
+    static fileUpdate(podId, formData) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
-            method: 'DELETE',
-            url: '/pods/{pod_id}/datastore/files/{file_id}',
+            method: 'PATCH',
+            url: '/pods/{pod_id}/datastore/files/by-path',
             path: {
                 'pod_id': podId,
-                'file_id': fileId,
             },
+            formData: formData,
+            mediaType: 'multipart/form-data',
             errors: {
                 422: `Validation Error`,
             },
         });
     }
     /**
-     * Get File
+     * Download File
      * @param podId
-     * @param fileId
-     * @returns FileResponse Successful Response
+     * @param path
+     * @returns any Successful Response
      * @throws ApiError
      */
-    static fileGet(podId, fileId) {
+    static fileDownload(podId, path) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
             method: 'GET',
-            url: '/pods/{pod_id}/datastore/files/{file_id}',
+            url: '/pods/{pod_id}/datastore/files/download',
             path: {
                 'pod_id': podId,
-                'file_id': fileId,
+            },
+            query: {
+                'path': path,
             },
             errors: {
                 422: `Validation Error`,
@@ -2161,42 +2210,65 @@ class FilesService {
         });
     }
     /**
-     * Update File
+     * Create Folder
      * @param podId
-     * @param fileId
-     * @param formData
+     * @param requestBody
      * @returns FileResponse Successful Response
      * @throws ApiError
      */
-    static fileUpdate(podId, fileId, formData) {
+    static fileFolderCreate(podId, requestBody) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
-            method: 'PATCH',
-            url: '/pods/{pod_id}/datastore/files/{file_id}',
+            method: 'POST',
+            url: '/pods/{pod_id}/datastore/files/folders',
             path: {
                 'pod_id': podId,
-                'file_id': fileId,
             },
-            formData: formData,
-            mediaType: 'multipart/form-data',
+            body: requestBody,
+            mediaType: 'application/json',
             errors: {
                 422: `Validation Error`,
             },
         });
     }
     /**
-     * Download File
+     * Search Files
      * @param podId
-     * @param fileId
-     * @returns any Successful Response
+     * @param requestBody
+     * @returns FileSearchResponse Successful Response
+     * @throws ApiError
+     */
+    static fileSearch(podId, requestBody) {
+        return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
+            method: 'POST',
+            url: '/pods/{pod_id}/datastore/files/search',
+            path: {
+                'pod_id': podId,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+    /**
+     * Get Directory Tree
+     * @param podId
+     * @param rootPath
+     * @param filesPerDirectory
+     * @returns DirectoryTreeResponse Successful Response
      * @throws ApiError
      */
-    static fileDownload(podId, fileId) {
+    static fileTree(podId, rootPath = '/', filesPerDirectory = 3) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
             method: 'GET',
-            url: '/pods/{pod_id}/datastore/files/{file_id}/download',
+            url: '/pods/{pod_id}/datastore/files/tree',
             path: {
                 'pod_id': podId,
-                'file_id': fileId,
+            },
+            query: {
+                'root_path': rootPath,
+                'files_per_directory': filesPerDirectory,
             },
             errors: {
                 422: `Validation Error`,
@@ -3680,6 +3752,18 @@ const RecordsService_js_1 = require("./openapi_client/services/RecordsService.js
 function getRecordsPath(podId, table) {
     return `/pods/${encodeURIComponent(podId)}/datastore/tables/${encodeURIComponent(table)}/records`;
 }
+function serializeFilters(filters) {
+    if (!filters || filters.length === 0) {
+        return undefined;
+    }
+    return filters.map((filter) => JSON.stringify(filter));
+}
+function serializeSort(sort) {
+    if (!sort || sort.length === 0) {
+        return undefined;
+    }
+    return sort.map((entry) => JSON.stringify(entry));
+}
 class RecordsNamespace {
     constructor(client, http, podId) {
         this.client = client;
@@ -3703,13 +3787,7 @@ class RecordsNamespace {
     list(table, options = {}) {
         const { filters, sort, limit, pageToken, offset, sortBy, order, params } = options;
         if (filters || sort) {
-            const payload = {
-                filters,
-                sort,
-                limit,
-                page_token: pageToken,
-            };
-            return this.client.request(() => RecordsService_js_1.RecordsService.recordQuery(this.podId(), table, payload));
+            return this.client.request(() => RecordsService_js_1.RecordsService.recordList(this.podId(), table, limit ?? 20, offset, sortBy ?? undefined, order ?? "asc", serializeFilters(filters), serializeSort(sort), pageToken));
         }
         const hasCustomParams = typeof offset === "number" ||
             typeof sortBy === "string" ||
@@ -3727,7 +3805,7 @@ class RecordsNamespace {
                 },
             });
         }
-        return this.client.request(() => RecordsService_js_1.RecordsService.recordList(this.podId(), table, limit ?? 20, pageToken));
+        return this.client.request(() => RecordsService_js_1.RecordsService.recordList(this.podId(), table, limit ?? 20, offset, sortBy ?? undefined, order ?? "asc", undefined, undefined, pageToken));
     }
     listWithParams(table, params) {
         return this.http.request("GET", getRecordsPath(this.podId(), table), {
@@ -3747,7 +3825,7 @@ class RecordsNamespace {
         return this.client.request(() => RecordsService_js_1.RecordsService.recordDelete(this.podId(), table, recordId));
     }
     query(table, payload) {
-        return this.client.request(() => RecordsService_js_1.RecordsService.recordQuery(this.podId(), table, payload));
+        return this.client.request(() => RecordsService_js_1.RecordsService.recordList(this.podId(), table, payload.limit ?? 20, payload.offset, payload.sort_by ?? undefined, payload.order ?? "asc", serializeFilters(payload.filters), serializeSort(payload.sort), payload.page_token));
     }
 }
 exports.RecordsNamespace = RecordsNamespace;
@@ -3762,15 +3840,20 @@ const request_js_1 = require("./openapi_client/core/request.js");
 class RecordsService {
     /**
      * List Records
-     * List table records with token pagination only. Use `record.query` when you need structured filters or explicit sort clauses.
+     * List table records with token pagination only. Use the datastore query endpoint for joins, aggregates, or custom read-only SQL.
      * @param podId
      * @param tableName
      * @param limit Max number of rows to return.
+     * @param offset Row offset for direct pagination.
+     * @param sortBy Optional column name to sort by.
+     * @param order Sort direction for `sort_by`: `asc` or `desc`.
+     * @param filter Optional repeated JSON filters for advanced comparisons. Example: `filter={"field":"amount","op":"gt","value":100}`
+     * @param sort Optional repeated JSON sort clauses. Example: `sort={"field":"created_at","direction":"desc"}`
      * @param pageToken Opaque token from a previous response page.
      * @returns RecordListResponse Successful Response
      * @throws ApiError
      */
-    static recordList(podId, tableName, limit = 20, pageToken) {
+    static recordList(podId, tableName, limit = 20, offset, sortBy, order = 'asc', filter, sort, pageToken) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
             method: 'GET',
             url: '/pods/{pod_id}/datastore/tables/{table_name}/records',
@@ -3780,6 +3863,11 @@ class RecordsService {
             },
             query: {
                 'limit': limit,
+                'offset': offset,
+                'sort_by': sortBy,
+                'order': order,
+                'filter': filter,
+                'sort': sort,
                 'page_token': pageToken,
             },
             errors: {
@@ -3883,30 +3971,6 @@ class RecordsService {
             },
         });
     }
-    /**
-     * Query Records
-     * Query one table with structured filters and sorting. Use this instead of dynamic query parameters when you need filtering. Example filters: `[{"field": "status", "op": "eq", "value": "OPEN"}]`.
-     * @param podId
-     * @param tableName
-     * @param requestBody
-     * @returns RecordListResponse Successful Response
-     * @throws ApiError
-     */
-    static recordQuery(podId, tableName, requestBody) {
-        return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
-            method: 'POST',
-            url: '/pods/{pod_id}/datastore/tables/{table_name}/records/query',
-            path: {
-                'pod_id': podId,
-                'table_name': tableName,
-            },
-            body: requestBody,
-            mediaType: 'application/json',
-            errors: {
-                422: `Validation Error`,
-            },
-        });
-    }
     /**
      * Delete Record
      * Delete a record by primary key.