lemma-sdk 0.2.44 → 0.2.46

package/dist/react/useFiles.js

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { normalizeError, resolvePodClient } from "./utils.js";
-export function useFiles({ client, podId, enabled = true, autoLoad = true, limit = 100, pageToken, directoryPath = "/", parentId, namespace, }) {
+export function useFiles({ client, podId, enabled = true, autoLoad = true, limit = 100, pageToken, directoryPath = "/", parentId, }) {
     const [files, setFiles] = useState([]);
     const [nextPageToken, setNextPageToken] = useState(null);
     const [isLoading, setIsLoading] = useState(false);
@@ -18,7 +18,6 @@ export function useFiles({ client, podId, enabled = true, autoLoad = true, limit
                 pageToken: overrides.pageToken ?? pageToken,
                 directoryPath: overrides.directoryPath ?? directoryPath,
                 parentId: overrides.parentId ?? parentId,
-                namespace: overrides.namespace ?? namespace,
             });
             if (signal?.aborted)
                 return [];
@@ -37,7 +36,7 @@ export function useFiles({ client, podId, enabled = true, autoLoad = true, limit
             if (!signal?.aborted)
                 setIsLoading(false);
         }
-    }, [client, directoryPath, enabled, limit, namespace, pageToken, parentId, podId]);
+    }, [client, directoryPath, enabled, limit, pageToken, parentId, podId]);
     const loadMore = useCallback(async (overrides = {}) => {
         if (!enabled || !nextPageToken || isLoading || isLoadingMore)
             return [];
@@ -50,7 +49,6 @@ export function useFiles({ client, podId, enabled = true, autoLoad = true, limit
                 pageToken: nextPageToken,
                 directoryPath,
                 parentId,
-                namespace,
             });
             const moreFiles = response.items ?? [];
             setFiles((previous) => [...previous, ...moreFiles]);
@@ -64,7 +62,7 @@ export function useFiles({ client, podId, enabled = true, autoLoad = true, limit
         finally {
             setIsLoadingMore(false);
         }
-    }, [client, directoryPath, enabled, isLoading, isLoadingMore, limit, namespace, nextPageToken, parentId, podId]);
+    }, [client, directoryPath, enabled, isLoading, isLoadingMore, limit, nextPageToken, parentId, podId]);
     useEffect(() => {
         if (!enabled) {
             setFiles([]);

package/dist/react/useFlowSession.d.ts

@@ -19,11 +19,14 @@ export interface UseFlowSessionResult {
     setRunId: (runId: string | null) => void;
     start: (options?: {
         flowName?: string;
+        /** Submitted to the entry form when the created run waits on one. */
         inputs?: WorkflowRunInputs;
         connect?: boolean;
     }) => Promise<FlowRun>;
+    /** Submit the form the run is waiting on (run.active_wait). */
     resume: (options: {
         runId?: string | null;
+        nodeId?: string;
         inputs?: WorkflowRunInputs;
         connect?: boolean;
     }) => Promise<FlowRun>;
@@ -34,6 +37,5 @@ export interface UseFlowSessionResult {
         pageToken?: string;
     }) => Promise<WorkflowRunSummary[]>;
     cancel: (runId?: string | null) => Promise<void>;
-    retry: (runId?: string | null) => Promise<void>;
 }
 export declare function useFlowSession({ client, podId, flowName, runId: initialRunId, autoPoll, pollIntervalMs, onRun, onError, }: UseFlowSessionOptions): UseFlowSessionResult;

package/dist/react/useFlowSession.js

@@ -73,7 +73,19 @@ export function useFlowSession({ client, podId, flowName, runId: initialRunId =
         setError(null);
         const scopedClient = resolvePodClient(client, resolvePodId(client, podId));
         const name = resolveFlowName(flowName, options.flowName);
-        const created = await scopedClient.workflows.runs.start(name, options.inputs);
+        // Runs are created without inputs; when the run starts on a form and
+        // inputs were provided, submit them to that form immediately.
+        let created = await scopedClient.workflows.runs.create(name);
+        const activeWait = created.active_wait;
+        if (created.id
+            && activeWait?.wait_type === "HUMAN"
+            && options.inputs
+            && Object.keys(options.inputs).length > 0) {
+            created = await scopedClient.workflows.runs.submitForm(created.id, {
+                node_id: activeWait.node_id,
+                inputs: options.inputs,
+            });
+        }
         setRun(created);
         setRunIdState(created.id ?? null);
         const nextStatus = normalizeRunStatus(created.status);
@@ -88,7 +100,16 @@ export function useFlowSession({ client, podId, flowName, runId: initialRunId =
         setError(null);
         const resolvedPodId = resolvePodId(client, podId);
         const id = resolveRunId(runId, options.runId);
-        const resumed = await client.workflows.runs.resume(id, options.inputs, resolvedPodId);
+        let nodeId = options.nodeId;
+        if (!nodeId) {
+            const sourceRun = run?.id === id ? run : await client.workflows.runs.get(id, resolvedPodId);
+            const wait = sourceRun?.active_wait;
+            if (!wait || wait.wait_type !== "HUMAN") {
+                throw new Error("Run is not waiting on a form; pass nodeId explicitly.");
+            }
+            nodeId = wait.node_id;
+        }
+        const resumed = await client.workflows.runs.submitForm(id, { node_id: nodeId, inputs: options.inputs ?? {} }, resolvedPodId);
         setRun(resumed);
         setRunIdState(resumed.id ?? id);
         const nextStatus = normalizeRunStatus(resumed.status);
@@ -98,7 +119,7 @@ export function useFlowSession({ client, podId, flowName, runId: initialRunId =
             await refresh(resumed.id ?? id);
         }
         return resumed;
-    }, [client, podId, refresh, runId]);
+    }, [client, podId, refresh, run, runId]);
     const cancel = useCallback(async (explicitRunId) => {
         try {
             const resolvedPodId = resolvePodId(client, podId);
@@ -112,19 +133,6 @@ export function useFlowSession({ client, podId, flowName, runId: initialRunId =
             onErrorRef.current?.(cancelError);
         }
     }, [client, podId, refresh, runId]);
-    const retry = useCallback(async (explicitRunId) => {
-        try {
-            const resolvedPodId = resolvePodId(client, podId);
-            const id = resolveRunId(runId, explicitRunId);
-            await client.workflows.runs.retry(id, resolvedPodId);
-            await refresh(id);
-        }
-        catch (retryError) {
-            const normalized = normalizeError(retryError, "Failed to retry flow run.");
-            setError(normalized);
-            onErrorRef.current?.(retryError);
-        }
-    }, [client, podId, refresh, runId]);
     useEffect(() => {
         if (!runId) {
             return;
@@ -198,6 +206,5 @@ export function useFlowSession({ client, podId, flowName, runId: initialRunId =
         refresh,
         listHistory,
         cancel,
-        retry,
     };
 }

package/dist/react/useGlobalSearch.js

@@ -92,7 +92,7 @@ export function useGlobalSearch({ client, podId, query = "", tables = [], files,
                             limit: stableFiles?.limit ?? 8,
                             searchMethod: stableFiles?.searchMethod,
                         });
-                        const mapped = (response.results ?? []).map((result) => ({
+                        const mapped = (response.items ?? []).map((result) => ({
                             kind: "file",
                             sourceKey,
                             sourceLabel: stableFiles?.label ?? "Files",

package/dist/react/useRecord.d.ts

@@ -1,7 +1,7 @@
 import type { LemmaClient } from "../client.js";
 /**
- * React hook for fetching a single record by ID. Unwraps `.data`
- * automatically so `record` is the plain object, not the API envelope.
+ * React hook for fetching a single record by ID. The record API returns the
+ * plain record object directly, so `record` is that object as-is.
  *
  * Perfect for detail panels — pair with `useRecords` for the list.
  *

package/dist/react/useRecord.js

@@ -24,7 +24,7 @@ export function useRecord({ client, podId, tableName, recordId = null, enabled =
             const response = await scopedClient.records.get(trimmedTableName, nextRecordId);
             if (signal?.aborted)
                 return null;
-            const nextRecord = (response.data ?? null);
+            const nextRecord = (response ?? null);
             setRecord(nextRecord);
             return nextRecord;
         }

package/dist/react/useRecordForm.d.ts

@@ -1,6 +1,6 @@
 import type { LemmaClient } from "../client.js";
 import { type RecordSchemaField } from "../record-form.js";
-import type { FunctionRun, RecordResponse } from "../types.js";
+import type { FunctionRun } from "../types.js";
 import { type UseRecordSchemaResult } from "./useRecordSchema.js";
 /**
  * React hook for schema-driven record forms with validation, dirty tracking,
@@ -50,7 +50,7 @@ export interface UseRecordFormOptions {
     submitFunctionName?: string;
     /** Transforms the form payload before passing it as function input. Receives the validated payload, returns the function input object. */
     submitFunctionInput?: (payload: Record<string, unknown>) => Record<string, unknown>;
-    onSubmitSuccess?: (record: Record<string, unknown>, response: RecordResponse | FunctionRun) => void;
+    onSubmitSuccess?: (record: Record<string, unknown>, response: Record<string, unknown> | FunctionRun) => void;
     onError?: (error: unknown) => void;
 }
 export interface UseRecordFormResult {

package/dist/react/useRecordForm.js

@@ -64,7 +64,7 @@ export function useRecordForm({ client, podId, tableName, recordId = null, initi
         try {
             const scopedClient = resolvePodClient(client, podId);
             const response = await scopedClient.records.get(tableName, recordId);
-            const nextRecord = response.data ?? null;
+            const nextRecord = response ?? null;
             setRecord(nextRecord);
             return nextRecord;
         }
@@ -187,7 +187,7 @@ export function useRecordForm({ client, podId, tableName, recordId = null, initi
             const response = resolvedMode === "update" && recordId
                 ? await scopedClient.records.update(tableName, recordId, payload.data)
                 : await scopedClient.records.create(tableName, payload.data);
-            const nextRecord = response.data ?? null;
+            const nextRecord = response ?? null;
             setRecord(nextRecord);
             hydrateValues({
                 ...(nextRecord ?? {}),

package/dist/react/useRecords.d.ts

@@ -17,4 +17,4 @@ export interface UseRecordsResult<TRecord extends Record<string, unknown> = Reco
     refresh: (overrides?: Partial<ListRecordsOptions>) => Promise<TRecord[]>;
     loadMore: (overrides?: Partial<ListRecordsOptions>) => Promise<TRecord[]>;
 }
-export declare function useRecords<TRecord extends Record<string, unknown> = Record<string, unknown>>({ client, podId, tableName, filters, sort, limit, pageToken, offset, sortBy, order, params, enabled, autoLoad, }: UseRecordsOptions): UseRecordsResult<TRecord>;
+export declare function useRecords<TRecord extends Record<string, unknown> = Record<string, unknown>>({ client, podId, tableName, filters, sort, limit, pageToken, offset, enabled, autoLoad, }: UseRecordsOptions): UseRecordsResult<TRecord>;

package/dist/react/useRecords.js

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { normalizeError, resolvePodClient, stringifyComparable } from "./utils.js";
-export function useRecords({ client, podId, tableName, filters, sort, limit = 20, pageToken, offset, sortBy, order, params, enabled = true, autoLoad = true, }) {
+export function useRecords({ client, podId, tableName, filters, sort, limit = 20, pageToken, offset, enabled = true, autoLoad = true, }) {
     const [records, setRecords] = useState([]);
     const [total, setTotal] = useState(0);
     const [nextPageToken, setNextPageToken] = useState(null);
@@ -11,10 +11,8 @@ export function useRecords({ client, podId, tableName, filters, sort, limit = 20
     const isEnabled = enabled && trimmedTableName.length > 0;
     const filtersKey = stringifyComparable(filters);
     const sortKey = stringifyComparable(sort);
-    const paramsKey = stringifyComparable(params);
     const stableFilters = useMemo(() => filters, [filtersKey]);
     const stableSort = useMemo(() => sort, [sortKey]);
-    const stableParams = useMemo(() => params, [paramsKey]);
     const refresh = useCallback(async (overrides = {}, signal) => {
         if (!isEnabled) {
             setRecords([]);
@@ -34,9 +32,6 @@ export function useRecords({ client, podId, tableName, filters, sort, limit = 20
                 limit: overrides.limit ?? limit,
                 pageToken: overrides.pageToken ?? pageToken,
                 offset: overrides.offset ?? offset,
-                sortBy: overrides.sortBy ?? sortBy,
-                order: overrides.order ?? order,
-                params: overrides.params ?? stableParams,
             });
             if (signal?.aborted)
                 return [];
@@ -62,12 +57,9 @@ export function useRecords({ client, podId, tableName, filters, sort, limit = 20
         isEnabled,
         limit,
         offset,
-        order,
         pageToken,
         podId,
-        sortBy,
         stableFilters,
-        stableParams,
         stableSort,
         trimmedTableName,
     ]);
@@ -88,9 +80,6 @@ export function useRecords({ client, podId, tableName, filters, sort, limit = 20
                 limit: overrides.limit ?? limit,
                 pageToken: overrides.pageToken ?? nextPageToken ?? undefined,
                 offset: overrides.offset ?? (nextPageToken ? undefined : (offset ?? 0) + loadedCount),
-                sortBy: overrides.sortBy ?? sortBy,
-                order: overrides.order ?? order,
-                params: overrides.params ?? stableParams,
             });
             const moreRecords = (response.items ?? []);
             setRecords((previous) => [...previous, ...moreRecords]);
@@ -106,7 +95,7 @@ export function useRecords({ client, podId, tableName, filters, sort, limit = 20
         finally {
             setIsLoadingMore(false);
         }
-    }, [client, isEnabled, isLoading, isLoadingMore, limit, nextPageToken, offset, order, podId, records.length, sortBy, stableFilters, stableParams, stableSort, total, trimmedTableName]);
+    }, [client, isEnabled, isLoading, isLoadingMore, limit, nextPageToken, offset, podId, records.length, stableFilters, stableSort, total, trimmedTableName]);
     useEffect(() => {
         if (!isEnabled) {
             setRecords([]);

package/dist/react/useReferencingRecords.d.ts

@@ -1,5 +1,5 @@
 import type { LemmaClient } from "../client.js";
-import type { Table } from "../types.js";
+import type { RecordSort, Table } from "../types.js";
 /**
  * React hook for fetching records from a referencing table that point back
  * to a specific record via a foreign key.
@@ -25,8 +25,7 @@ import type { Table } from "../types.js";
  *   table: "issue_history",
  *   foreignKey: "issue_id",
  *   recordId: selectedIssueId,
- *   sortBy: "created_at",
- *   order: "desc",
+ *   sort: [{ field: "created_at", direction: "desc" }],
  * });
  * ```
  */
@@ -48,8 +47,7 @@ export interface UseReferencingRecordsOptions {
     fields?: string[];
     limit?: number;
     offset?: number;
-    sortBy?: string;
-    order?: "asc" | "desc" | string;
+    sort?: RecordSort[];
     enabled?: boolean;
     autoLoad?: boolean;
 }
@@ -63,4 +61,4 @@ export interface UseReferencingRecordsResult<TRow extends Record<string, unknown
     error: Error | null;
     refresh: () => Promise<TRow[]>;
 }
-export declare function useReferencingRecords<TRow extends Record<string, unknown> = Record<string, unknown>>({ client, podId, table, foreignKey, recordId, fields, limit, offset, sortBy, order, enabled, autoLoad, }: UseReferencingRecordsOptions): UseReferencingRecordsResult<TRow>;
+export declare function useReferencingRecords<TRow extends Record<string, unknown> = Record<string, unknown>>({ client, podId, table, foreignKey, recordId, fields, limit, offset, sort, enabled, autoLoad, }: UseReferencingRecordsOptions): UseReferencingRecordsResult<TRow>;

package/dist/react/useReferencingRecords.js

@@ -25,7 +25,7 @@ function pickDefaultFields(table, foreignKey) {
     });
     return next.slice(0, 6);
 }
-export function useReferencingRecords({ client, podId, table, foreignKey, recordId = null, fields, limit = 20, offset, sortBy, order, enabled = true, autoLoad = true, }) {
+export function useReferencingRecords({ client, podId, table, foreignKey, recordId = null, fields, limit = 20, offset, sort, enabled = true, autoLoad = true, }) {
     const [referencedTable, setReferencedTable] = useState(null);
     const [columns, setColumns] = useState([]);
     const [records, setRecords] = useState([]);
@@ -36,7 +36,9 @@ export function useReferencingRecords({ client, podId, table, foreignKey, record
     const trimmedTable = table.trim();
     const trimmedRecordId = typeof recordId === "string" ? recordId.trim() : "";
     const fieldsKey = stringifyComparable(fields);
+    const sortKey = stringifyComparable(sort);
     const stableFields = useMemo(() => fields, [fieldsKey]);
+    const stableSort = useMemo(() => sort, [sortKey]);
     const isEnabled = enabled && trimmedTable.length > 0 && trimmedRecordId.length > 0;
     const refresh = useCallback(async (signal) => {
         if (!isEnabled) {
@@ -67,8 +69,7 @@ export function useReferencingRecords({ client, podId, table, foreignKey, record
                     }],
                 limit,
                 offset,
-                sortBy,
-                order,
+                sort: stableSort,
             });
             if (signal?.aborted)
                 return [];
@@ -100,10 +101,9 @@ export function useReferencingRecords({ client, podId, table, foreignKey, record
         isEnabled,
         limit,
         offset,
-        order,
         podId,
-        sortBy,
         stableFields,
+        stableSort,
         trimmedRecordId,
         trimmedTable,
     ]);

package/dist/react/useReverseRelatedRecords.d.ts

@@ -1,5 +1,5 @@
 import type { LemmaClient } from "../client.js";
-import type { Table } from "../types.js";
+import type { RecordSort, Table } from "../types.js";
 /**
  * React hook for finding records in *other* tables that reference a given
  * record. Starts from the parent table, discovers all tables with FK
@@ -45,8 +45,7 @@ export interface UseReverseRelatedRecordsOptions {
     fields?: string[];
     limit?: number;
     offset?: number;
-    sortBy?: string;
-    order?: "asc" | "desc" | string;
+    sort?: RecordSort[];
     tablesLimit?: number;
     enabled?: boolean;
     autoLoad?: boolean;
@@ -65,4 +64,4 @@ export interface UseReverseRelatedRecordsResult<TRow extends Record<string, unkn
     error: Error | null;
     refresh: () => Promise<TRow[]>;
 }
-export declare function useReverseRelatedRecords<TRow extends Record<string, unknown> = Record<string, unknown>>({ client, podId, tableName, recordId, relation, fields, limit, offset, sortBy, order, tablesLimit, enabled, autoLoad, }: UseReverseRelatedRecordsOptions): UseReverseRelatedRecordsResult<TRow>;
+export declare function useReverseRelatedRecords<TRow extends Record<string, unknown> = Record<string, unknown>>({ client, podId, tableName, recordId, relation, fields, limit, offset, sort, tablesLimit, enabled, autoLoad, }: UseReverseRelatedRecordsOptions): UseReverseRelatedRecordsResult<TRow>;

package/dist/react/useReverseRelatedRecords.js

@@ -26,7 +26,7 @@ function pickDefaultFields(table, foreignKey) {
     });
     return next.slice(0, 6);
 }
-export function useReverseRelatedRecords({ client, podId, tableName, recordId = null, relation = null, fields, limit = 20, offset, sortBy, order, tablesLimit = 100, enabled = true, autoLoad = true, }) {
+export function useReverseRelatedRecords({ client, podId, tableName, recordId = null, relation = null, fields, limit = 20, offset, sort, tablesLimit = 100, enabled = true, autoLoad = true, }) {
     const [parentTable, setParentTable] = useState(null);
     const [relatedTable, setRelatedTable] = useState(null);
     const [parentRecord, setParentRecord] = useState(null);
@@ -42,8 +42,10 @@ export function useReverseRelatedRecords({ client, podId, tableName, recordId =
     const trimmedRecordId = typeof recordId === "string" ? recordId.trim() : "";
     const relationKey = stringifyComparable(relation);
     const fieldsKey = stringifyComparable(fields);
+    const sortKey = stringifyComparable(sort);
     const stableRelation = useMemo(() => relation, [relationKey]);
     const stableFields = useMemo(() => fields, [fieldsKey]);
+    const stableSort = useMemo(() => sort, [sortKey]);
     const isEnabled = enabled && trimmedTableName.length > 0 && trimmedRecordId.length > 0;
     const refresh = useCallback(async (signal) => {
         if (!isEnabled) {
@@ -73,7 +75,7 @@ export function useReverseRelatedRecords({ client, podId, tableName, recordId =
             const listedTables = tablesResponse.items ?? [];
             const nextParentTable = listedTables.find((tableEntry) => tableEntry.name === trimmedTableName)
                 ?? await scopedClient.tables.get(trimmedTableName);
-            const nextParentRecord = parentRecordResponse.data ?? null;
+            const nextParentRecord = parentRecordResponse ?? null;
             if (signal?.aborted)
                 return [];
             setParentTable(nextParentTable);
@@ -130,8 +132,7 @@ export function useReverseRelatedRecords({ client, podId, tableName, recordId =
                     }],
                 limit,
                 offset,
-                sortBy,
-                order,
+                sort: stableSort,
             });
             if (signal?.aborted)
                 return [];
@@ -162,11 +163,10 @@ export function useReverseRelatedRecords({ client, podId, tableName, recordId =
         isEnabled,
         limit,
         offset,
-        order,
         podId,
-        sortBy,
         stableFields,
         stableRelation,
+        stableSort,
         tablesLimit,
         trimmedRecordId,
         trimmedTableName,

package/dist/react/useUpdateFile.d.ts

@@ -1,5 +1,5 @@
 import type { LemmaClient } from "../client.js";
-import type { DatastoreFileNamespace, FileResponse } from "../types.js";
+import type { FileResponse } from "../types.js";
 export interface UpdateFileInput {
     file?: Blob;
     name?: string;
@@ -8,13 +8,11 @@ export interface UpdateFileInput {
     parentId?: string;
     newPath?: string;
     searchEnabled?: boolean;
-    namespace?: DatastoreFileNamespace | null;
 }
 export interface UseUpdateFileOptions {
     client: LemmaClient;
     podId?: string;
     path?: string | null;
-    namespace?: DatastoreFileNamespace | null;
     enabled?: boolean;
     onSuccess?: (file: FileResponse) => void;
     onError?: (error: unknown) => void;
@@ -28,4 +26,4 @@ export interface UseUpdateFileResult<TFile extends FileResponse = FileResponse>
     }) => Promise<TFile | null>;
     reset: () => void;
 }
-export declare function useUpdateFile<TFile extends FileResponse = FileResponse>({ client, podId, path, namespace, enabled, onSuccess, onError, }: UseUpdateFileOptions): UseUpdateFileResult<TFile>;
+export declare function useUpdateFile<TFile extends FileResponse = FileResponse>({ client, podId, path, enabled, onSuccess, onError, }: UseUpdateFileOptions): UseUpdateFileResult<TFile>;

package/dist/react/useUpdateFile.js

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { normalizeError, resolvePodClient } from "./utils.js";
-export function useUpdateFile({ client, podId, path = null, namespace, enabled = true, onSuccess, onError, }) {
+export function useUpdateFile({ client, podId, path = null, enabled = true, onSuccess, onError, }) {
     const [updatedFile, setUpdatedFile] = useState(null);
     const [isSubmitting, setIsSubmitting] = useState(false);
     const [error, setError] = useState(null);
@@ -23,7 +23,6 @@ export function useUpdateFile({ client, podId, path = null, namespace, enabled =
             const scopedClient = resolvePodClient(client, podId);
             const nextFile = await scopedClient.files.update(nextPath, {
                 ...input,
-                namespace: input.namespace ?? namespace,
             });
             setUpdatedFile(nextFile);
             onSuccessRef.current?.(nextFile);
@@ -38,7 +37,7 @@ export function useUpdateFile({ client, podId, path = null, namespace, enabled =
         finally {
             setIsSubmitting(false);
         }
-    }, [client, isEnabled, namespace, podId, trimmedPath]);
+    }, [client, isEnabled, podId, trimmedPath]);
     const reset = useCallback(() => {
         setUpdatedFile(null);
         setError(null);

package/dist/react/useUpdateRecord.d.ts

@@ -1,5 +1,5 @@
 import type { LemmaClient } from "../client.js";
-import type { FunctionRun, RecordResponse } from "../types.js";
+import type { FunctionRun } from "../types.js";
 /**
  * React hook for updating a single record. Manages loading/error state and
  * exposes an `update` function you can call from event handlers.
@@ -37,7 +37,7 @@ export interface UseUpdateRecordOptions {
     updateVia?: "direct" | "function";
     /** Function name to run when `updateVia` is `"function"`. Falls back to `tableName` if omitted. */
     updateFunctionName?: string;
-    onSuccess?: (record: Record<string, unknown>, response: RecordResponse | FunctionRun) => void;
+    onSuccess?: (record: Record<string, unknown>, response: Record<string, unknown> | FunctionRun) => void;
     onError?: (error: unknown) => void;
 }
 export interface UseUpdateRecordResult<TRecord extends Record<string, unknown> = Record<string, unknown>> {

package/dist/react/useUpdateRecord.js

@@ -34,7 +34,7 @@ export function useUpdateRecord({ client, podId, tableName, recordId = null, ena
                 return nextRecord;
             }
             const response = await scopedClient.records.update(trimmedTableName, nextRecordId, data);
-            const nextRecord = (response.data ?? null);
+            const nextRecord = (response ?? null);
             setUpdatedRecord(nextRecord);
             if (nextRecord) {
                 onSuccessRef.current?.(nextRecord, response);

package/dist/react/useUploadFile.d.ts

@@ -1,17 +1,15 @@
 import type { LemmaClient } from "../client.js";
-import type { DatastoreFileNamespace, FileResponse } from "../types.js";
+import type { FileResponse } from "../types.js";
 export interface UploadFileInput {
     name?: string;
     directoryPath?: string;
     parentId?: string;
     searchEnabled?: boolean;
     description?: string;
-    namespace?: DatastoreFileNamespace | null;
 }
 export interface UseUploadFileOptions {
     client: LemmaClient;
     podId?: string;
-    namespace?: DatastoreFileNamespace | null;
     enabled?: boolean;
     onSuccess?: (file: FileResponse) => void;
     onError?: (error: unknown) => void;
@@ -23,4 +21,4 @@ export interface UseUploadFileResult<TFile extends FileResponse = FileResponse>
     upload: (file: Blob, options?: UploadFileInput) => Promise<TFile | null>;
     reset: () => void;
 }
-export declare function useUploadFile<TFile extends FileResponse = FileResponse>({ client, podId, namespace, enabled, onSuccess, onError, }: UseUploadFileOptions): UseUploadFileResult<TFile>;
+export declare function useUploadFile<TFile extends FileResponse = FileResponse>({ client, podId, enabled, onSuccess, onError, }: UseUploadFileOptions): UseUploadFileResult<TFile>;

package/dist/react/useUploadFile.js

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { normalizeError, resolvePodClient } from "./utils.js";
-export function useUploadFile({ client, podId, namespace, enabled = true, onSuccess, onError, }) {
+export function useUploadFile({ client, podId, enabled = true, onSuccess, onError, }) {
     const [uploadedFile, setUploadedFile] = useState(null);
     const [isSubmitting, setIsSubmitting] = useState(false);
     const [error, setError] = useState(null);
@@ -18,7 +18,6 @@ export function useUploadFile({ client, podId, namespace, enabled = true, onSucc
             const scopedClient = resolvePodClient(client, podId);
             const nextFile = await scopedClient.files.upload(file, {
                 ...options,
-                namespace: options.namespace ?? namespace,
             });
             setUploadedFile(nextFile);
             onSuccessRef.current?.(nextFile);
@@ -33,7 +32,7 @@ export function useUploadFile({ client, podId, namespace, enabled = true, onSucc
         finally {
             setIsSubmitting(false);
         }
-    }, [client, enabled, namespace, podId]);
+    }, [client, enabled, podId]);
     const reset = useCallback(() => {
         setUploadedFile(null);
         setError(null);

package/dist/react/useWorkflowResume.d.ts

@@ -13,6 +13,7 @@ export interface UseWorkflowResumeResult {
     error: Error | null;
     resume: (inputs?: WorkflowRunInputs, options?: {
         runId?: string | null;
+        nodeId?: string;
     }) => Promise<FlowRun>;
 }
 export declare function useWorkflowResume({ client, podId, runId, onRun, onError, }: UseWorkflowResumeOptions): UseWorkflowResumeResult;

package/dist/react/useWorkflowResume.js

@@ -21,7 +21,16 @@ export function useWorkflowResume({ client, podId, runId, onRun, onError, }) {
         try {
             const resolvedPodId = resolvePodId(client, podId);
             const resolvedRunId = resolveRunId(runId, options.runId);
-            const nextRun = await client.workflows.runs.resume(resolvedRunId, inputs, resolvedPodId);
+            let nodeId = options.nodeId;
+            if (!nodeId) {
+                const current = await client.workflows.runs.get(resolvedRunId, resolvedPodId);
+                const wait = current.active_wait;
+                if (!wait || wait.wait_type !== "HUMAN") {
+                    throw new Error("Run is not waiting on a form; pass nodeId explicitly.");
+                }
+                nodeId = wait.node_id;
+            }
+            const nextRun = await client.workflows.runs.submitForm(resolvedRunId, { node_id: nodeId, inputs }, resolvedPodId);
             setRun(nextRun);
             onRunRef.current?.(nextRun);
             return nextRun;

package/dist/react/useWorkflowRun.js

@@ -31,9 +31,7 @@ export function useWorkflowRun({ workflowName, ...options }) {
         const normalizedStatus = normalizeRunStatus(session.status);
         const isFinished = isTerminalFlowStatus(normalizedStatus);
         const isWaitingForInput = normalizedStatus === "WAITING"
-            || !!session.run?.waiting_agent_conversation_id
-            || !!session.run?.waiting_function_run_id
-            || !!session.run?.waiting_timer_id;
+            && session.run?.active_wait?.wait_type === "HUMAN";
         const output = session.run?.execution_context ?? null;
         const finalOutput = isFinished ? output : null;
         return {

package/dist/react/useWorkflowStart.js

@@ -16,14 +16,11 @@ function findFirstFormNode(workflow) {
     }
     return null;
 }
-function isWaitingFlowRun(run) {
+function isWaitingOnForm(run) {
     if (!run)
         return false;
     const normalizedStatus = normalizeRunStatus(run.status);
-    return normalizedStatus === "WAITING"
-        || !!run.waiting_function_run_id
-        || !!run.waiting_agent_conversation_id
-        || !!run.waiting_timer_id;
+    return normalizedStatus === "WAITING" && run.active_wait?.wait_type === "HUMAN";
 }
 export function useWorkflowStart({ client, podId, workflowName, runId = null, enabled = true, autoLoad = true, autoPoll = true, pollIntervalMs = 2000, onRun, onError, }) {
     const [workflow, setWorkflow] = useState(null);
@@ -93,30 +90,18 @@ export function useWorkflowStart({ client, podId, workflowName, runId = null, en
         setIsStarting(true);
         setWorkflowError(null);
         try {
-            const currentWorkflow = workflow?.name === workflowName
-                ? workflow
-                : await refreshWorkflow();
-            const startType = currentWorkflow?.start?.type ?? "MANUAL";
-            if (startType === "MANUAL") {
-                const created = await session.start({
-                    flowName: workflowName,
-                    inputs: {},
-                });
-                const shouldResume = !!created.id && (options.forceResume === true
-                    || Object.keys(inputs).length > 0
-                    || isWaitingFlowRun(created));
-                if (!shouldResume || !created.id) {
-                    return created;
-                }
-                return session.resume({
-                    runId: created.id,
-                    inputs,
-                });
-            }
-            return session.start({
+            // Runs take no start inputs; session.start submits `inputs` to the
+            // entry form when the created run waits on one.
+            const created = await session.start({
                 flowName: workflowName,
                 inputs,
             });
+            if (options.forceResume === true
+                && created.id
+                && isWaitingOnForm(created)) {
+                return session.resume({ runId: created.id, inputs });
+            }
+            return created;
         }
         catch (startError) {
             const normalized = normalizeError(startError, "Failed to start workflow.");