lemma-sdk 0.2.22 → 0.2.24

package/dist/openapi_client/services/FilesService.d.ts

@@ -1,6 +1,7 @@
 import type { CreateFolderRequest } from '../models/CreateFolderRequest.js';
 import type { DatastoreFileUploadRequest } from '../models/DatastoreFileUploadRequest.js';
 import type { DatastoreMessageResponse } from '../models/DatastoreMessageResponse.js';
+import type { DirectoryTreeResponse } from '../models/DirectoryTreeResponse.js';
 import type { FileListResponse } from '../models/FileListResponse.js';
 import type { FileResponse } from '../models/FileResponse.js';
 import type { FileSearchRequest } from '../models/FileSearchRequest.js';
@@ -11,13 +12,13 @@ export declare class FilesService {
     /**
      * List Files
      * @param podId
-     * @param parentId
+     * @param directoryPath
      * @param limit
      * @param pageToken
      * @returns FileListResponse Successful Response
      * @throws ApiError
      */
-    static fileList(podId: string, parentId?: (string | null), limit?: number, pageToken?: (string | null)): CancelablePromise<FileListResponse>;
+    static fileList(podId: string, directoryPath?: string, limit?: number, pageToken?: (string | null)): CancelablePromise<FileListResponse>;
     /**
      * Upload File
      * @param podId
@@ -27,52 +28,60 @@ export declare class FilesService {
      */
     static fileUpload(podId: string, formData: DatastoreFileUploadRequest): CancelablePromise<FileResponse>;
     /**
-     * Create Folder
+     * Delete File
      * @param podId
-     * @param requestBody
+     * @param path
+     * @returns DatastoreMessageResponse Successful Response
+     * @throws ApiError
+     */
+    static fileDelete(podId: string, path: string): CancelablePromise<DatastoreMessageResponse>;
+    /**
+     * Get File
+     * @param podId
+     * @param path
      * @returns FileResponse Successful Response
      * @throws ApiError
      */
-    static fileFolderCreate(podId: string, requestBody: CreateFolderRequest): CancelablePromise<FileResponse>;
+    static fileGet(podId: string, path: string): CancelablePromise<FileResponse>;
     /**
-     * Search Files
+     * Update File
      * @param podId
-     * @param requestBody
-     * @returns FileSearchResponse Successful Response
+     * @param formData
+     * @returns FileResponse Successful Response
      * @throws ApiError
      */
-    static fileSearch(podId: string, requestBody: FileSearchRequest): CancelablePromise<FileSearchResponse>;
+    static fileUpdate(podId: string, formData: update): CancelablePromise<FileResponse>;
     /**
-     * Delete File
+     * Download File
      * @param podId
-     * @param fileId
-     * @returns DatastoreMessageResponse Successful Response
+     * @param path
+     * @returns any Successful Response
      * @throws ApiError
      */
-    static fileDelete(podId: string, fileId: string): CancelablePromise<DatastoreMessageResponse>;
+    static fileDownload(podId: string, path: string): CancelablePromise<any>;
     /**
-     * Get File
+     * Create Folder
      * @param podId
-     * @param fileId
+     * @param requestBody
      * @returns FileResponse Successful Response
      * @throws ApiError
      */
-    static fileGet(podId: string, fileId: string): CancelablePromise<FileResponse>;
+    static fileFolderCreate(podId: string, requestBody: CreateFolderRequest): CancelablePromise<FileResponse>;
     /**
-     * Update File
+     * Search Files
      * @param podId
-     * @param fileId
-     * @param formData
-     * @returns FileResponse Successful Response
+     * @param requestBody
+     * @returns FileSearchResponse Successful Response
      * @throws ApiError
      */
-    static fileUpdate(podId: string, fileId: string, formData?: update): CancelablePromise<FileResponse>;
+    static fileSearch(podId: string, requestBody: FileSearchRequest): CancelablePromise<FileSearchResponse>;
     /**
-     * Download File
+     * Get Directory Tree
      * @param podId
-     * @param fileId
-     * @returns any Successful Response
+     * @param rootPath
+     * @param filesPerDirectory
+     * @returns DirectoryTreeResponse Successful Response
      * @throws ApiError
      */
-    static fileDownload(podId: string, fileId: string): CancelablePromise<any>;
+    static fileTree(podId: string, rootPath?: string, filesPerDirectory?: number): CancelablePromise<DirectoryTreeResponse>;
 }

package/dist/openapi_client/services/FilesService.js

@@ -4,13 +4,13 @@ export 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 __request(OpenAPI, {
             method: 'GET',
             url: '/pods/{pod_id}/datastore/files',
@@ -18,7 +18,7 @@ export class FilesService {
                 'pod_id': podId,
             },
             query: {
-                'parent_id': parentId,
+                'directory_path': directoryPath,
                 'limit': limit,
                 'page_token': pageToken,
             },
@@ -49,81 +49,86 @@ export 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 __request(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 __request(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 __request(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 __request(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`,
@@ -131,42 +136,65 @@ export 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 __request(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 fileDownload(podId, fileId) {
+    static fileSearch(podId, requestBody) {
+        return __request(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 fileTree(podId, rootPath = '/', filesPerDirectory = 3) {
         return __request(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`,

package/dist/openapi_client/services/QueryService.d.ts

@@ -0,0 +1,14 @@
+import type { DatastoreQueryRequest } from '../models/DatastoreQueryRequest.js';
+import type { DatastoreQueryResponse } from '../models/DatastoreQueryResponse.js';
+import type { CancelablePromise } from '../core/CancelablePromise.js';
+export declare class QueryService {
+    /**
+     * Execute Query
+     * Execute a read-only SQL query inside the datastore schema. Joins, aggregates, subqueries, and cross-table reads are allowed as long as the statement is read only.
+     * @param podId
+     * @param requestBody
+     * @returns DatastoreQueryResponse Successful Response
+     * @throws ApiError
+     */
+    static queryExecute(podId: string, requestBody: DatastoreQueryRequest): CancelablePromise<DatastoreQueryResponse>;
+}

package/dist/openapi_client/services/QueryService.js

@@ -0,0 +1,26 @@
+import { OpenAPI } from '../core/OpenAPI.js';
+import { request as __request } from '../core/request.js';
+export class QueryService {
+    /**
+     * Execute Query
+     * Execute a read-only SQL query inside the datastore schema. Joins, aggregates, subqueries, and cross-table reads are allowed as long as the statement is read only.
+     * @param podId
+     * @param requestBody
+     * @returns DatastoreQueryResponse Successful Response
+     * @throws ApiError
+     */
+    static queryExecute(podId, requestBody) {
+        return __request(OpenAPI, {
+            method: 'POST',
+            url: '/pods/{pod_id}/datastore/query',
+            path: {
+                'pod_id': podId,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+}

package/dist/openapi_client/services/RecordsService.d.ts

@@ -4,22 +4,26 @@ import type { BulkUpdateRecordsRequest } from '../models/BulkUpdateRecordsReques
 import type { CreateRecordRequest } from '../models/CreateRecordRequest.js';
 import type { DatastoreMessageResponse } from '../models/DatastoreMessageResponse.js';
 import type { RecordListResponse } from '../models/RecordListResponse.js';
-import type { RecordQueryRequest } from '../models/RecordQueryRequest.js';
 import type { RecordResponse } from '../models/RecordResponse.js';
 import type { UpdateRecordRequest } from '../models/UpdateRecordRequest.js';
 import type { CancelablePromise } from '../core/CancelablePromise.js';
 export declare 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: string, tableName: string, limit?: number, pageToken?: (string | null)): CancelablePromise<RecordListResponse>;
+    static recordList(podId: string, tableName: string, limit?: number, offset?: number, sortBy?: (string | null), order?: string, filter?: (Array<string> | null), sort?: (Array<string> | null), pageToken?: (string | null)): CancelablePromise<RecordListResponse>;
     /**
      * Create Record
      * Insert a record into a table. Reserved tables (`reserved_*`) are system-managed and cannot be mutated through record write endpoints.
@@ -60,16 +64,6 @@ export declare class RecordsService {
      * @throws ApiError
      */
     static recordBulkUpdate(podId: string, tableName: string, requestBody: BulkUpdateRecordsRequest): CancelablePromise<DatastoreMessageResponse>;
-    /**
-     * 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: string, tableName: string, requestBody: RecordQueryRequest): CancelablePromise<RecordListResponse>;
     /**
      * Delete Record
      * Delete a record by primary key.

package/dist/openapi_client/services/RecordsService.js

@@ -3,15 +3,20 @@ import { request as __request } from '../core/request.js';
 export 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 __request(OpenAPI, {
             method: 'GET',
             url: '/pods/{pod_id}/datastore/tables/{table_name}/records',
@@ -21,6 +26,11 @@ export class RecordsService {
             },
             query: {
                 'limit': limit,
+                'offset': offset,
+                'sort_by': sortBy,
+                'order': order,
+                'filter': filter,
+                'sort': sort,
                 'page_token': pageToken,
             },
             errors: {
@@ -124,30 +134,6 @@ export 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 __request(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.

package/dist/react/components/AssistantEmbedded.d.ts

@@ -7,4 +7,4 @@ export interface AssistantEmbeddedProps extends Omit<AssistantExperienceViewProp
     enabled?: boolean;
     theme?: AssistantThemeMode;
 }
-export declare function AssistantEmbedded({ client, podId, assistantId, organizationId, enabled, theme, ...props }: AssistantEmbeddedProps): import("react/jsx-runtime").JSX.Element;
+export declare function AssistantEmbedded({ client, podId, assistantName, assistantId, organizationId, enabled, theme, ...props }: AssistantEmbeddedProps): import("react/jsx-runtime").JSX.Element;

package/dist/react/components/AssistantEmbedded.js

@@ -2,10 +2,11 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useAssistantController } from "../useAssistantController.js";
 import { AssistantThemeScope } from "./AssistantChrome.js";
 import { AssistantExperienceView } from "./AssistantExperience.js";
-export function AssistantEmbedded({ client, podId, assistantId, organizationId, enabled = true, theme = "auto", ...props }) {
+export function AssistantEmbedded({ client, podId, assistantName, assistantId, organizationId, enabled = true, theme = "auto", ...props }) {
     const controller = useAssistantController({
         client,
         podId: podId ?? undefined,
+        assistantName: assistantName ?? undefined,
         assistantId: assistantId ?? undefined,
         organizationId: organizationId ?? undefined,
         enabled,

package/dist/react/useAssistantController.d.ts

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

package/dist/react/useAssistantController.js

@@ -3,6 +3,7 @@ import { useAssistantRuntime } from "./useAssistantRuntime.js";
 import { useAssistantSession } from "./useAssistantSession.js";
 const EMPTY_SCOPE_KEY = JSON.stringify({
     podId: null,
+    assistantName: null,
     assistantId: null,
     organizationId: null,
 });
@@ -538,7 +539,7 @@ function isConversationRunning(status) {
     }
     return true;
 }
-export function useAssistantController({ client, podId, assistantId, organizationId, enabled = true, }) {
+export function useAssistantController({ client, podId, assistantName, assistantId, organizationId, enabled = true, }) {
     const [localError, setLocalError] = useState(null);
     const [messages, setMessages] = useState([]);
     const [conversations, setConversations] = useState([]);
@@ -560,20 +561,23 @@ export function useAssistantController({ client, podId, assistantId, organizatio
     const skipInitialLoadConversationIdsRef = useRef(new Set());
     const scope = useMemo(() => ({
         podId: podId ?? null,
+        assistantName: assistantName ?? assistantId ?? null,
         assistantId: assistantId ?? null,
         organizationId: organizationId ?? null,
-    }), [assistantId, organizationId, podId]);
+    }), [assistantId, assistantName, organizationId, podId]);
     const scopeKey = useMemo(() => JSON.stringify({
         podId: scope.podId ?? null,
+        assistantName: scope.assistantName ?? null,
         assistantId: scope.assistantId ?? null,
         organizationId: scope.organizationId ?? null,
-    }), [scope.assistantId, scope.organizationId, scope.podId]);
+    }), [scope.assistantId, scope.assistantName, scope.organizationId, scope.podId]);
     const handleAssistantSessionError = useCallback((sessionError) => {
         setLocalError((prev) => prev || (sessionError instanceof Error ? sessionError.message : "Assistant session failed"));
     }, []);
     const assistantSession = useAssistantSession({
         client,
         podId: scope.podId ?? undefined,
+        assistantName: scope.assistantName ?? undefined,
         assistantId: scope.assistantId ?? undefined,
         organizationId: scope.organizationId ?? undefined,
         conversationId: activeConversationId ?? undefined,

package/dist/react/useAssistantSession.d.ts

@@ -3,12 +3,20 @@ import { type SseRawEvent } from "../streams.js";
 import type { Conversation, ConversationMessage, ConversationModel, CursorPage } from "../types.js";
 interface ConversationScope {
     podId?: string | null;
+    assistantName?: string | null;
+    /**
+     * @deprecated Use assistantName instead.
+     */
     assistantId?: string | null;
     organizationId?: string | null;
 }
 export interface UseAssistantSessionOptions {
     client: LemmaClient;
     podId?: string;
+    assistantName?: string;
+    /**
+     * @deprecated Use assistantName instead.
+     */
     assistantId?: string;
     organizationId?: string;
     conversationId?: string | null;
@@ -24,6 +32,10 @@ export interface CreateConversationInput {
     title?: string | null;
     model?: ConversationModel | null;
     podId?: string | null;
+    assistantName?: string | null;
+    /**
+     * @deprecated Use assistantName instead.
+     */
     assistantId?: string | null;
     organizationId?: string | null;
     setActive?: boolean;