lemma-sdk 0.2.44 → 0.2.46

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

@@ -1,16 +1,17 @@
 import type { FlowDetailResponse } from '../models/FlowDetailResponse.js';
-import type { FlowRunEntity } from '../models/FlowRunEntity.js';
 import type { WorkflowCreateRequest } from '../models/WorkflowCreateRequest.js';
 import type { WorkflowGraphUpdateRequest } from '../models/WorkflowGraphUpdateRequest.js';
 import type { WorkflowListResponse } from '../models/WorkflowListResponse.js';
+import type { WorkflowRunFormSubmitRequest } from '../models/WorkflowRunFormSubmitRequest.js';
 import type { WorkflowRunListResponse } from '../models/WorkflowRunListResponse.js';
+import type { WorkflowRunResponse } from '../models/WorkflowRunResponse.js';
 import type { WorkflowRunWaitAssignmentListResponse } from '../models/WorkflowRunWaitAssignmentListResponse.js';
 import type { WorkflowUpdateRequest } from '../models/WorkflowUpdateRequest.js';
 import type { CancelablePromise } from '../core/CancelablePromise.js';
 export declare class WorkflowsService {
     /**
      * List Workflow Runs Waiting For Current User
-     * List active human form waits assigned to the current pod member.
+     * The current user's approval queue: active form waits assigned to them, with the owning run.
      * @param podId
      * @param limit
      * @param pageToken
@@ -20,23 +21,32 @@ export declare class WorkflowsService {
     static workflowRunWaitingAssignedToMe(podId: string, limit?: number, pageToken?: (string | null)): CancelablePromise<WorkflowRunWaitAssignmentListResponse>;
     /**
      * Get Workflow Run
-     * Get current state, context, and step history of a workflow run.
+     * Get current state, context, step history, and the active wait (when WAITING) of a workflow run.
      * @param podId
      * @param runId
-     * @returns FlowRunEntity Successful Response
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowRunGet(podId: string, runId: string): CancelablePromise<FlowRunEntity>;
+    static workflowRunGet(podId: string, runId: string): CancelablePromise<WorkflowRunResponse>;
     /**
-     * Resume Workflow Run
-     * Resume a run in WAITING or EXECUTING state. The payload is written back into the current waiting node output and execution continues.
+     * Cancel Workflow Run
+     * Cancel a non-terminal run. The active wait (if any) is cancelled in the same transaction; late completion events for cancelled waits are dropped. Cancelling a terminal run returns 409.
+     * @param podId
+     * @param runId
+     * @returns WorkflowRunResponse Successful Response
+     * @throws ApiError
+     */
+    static workflowRunCancel(podId: string, runId: string): CancelablePromise<WorkflowRunResponse>;
+    /**
+     * Submit Workflow Run Form
+     * Submit the form the run is waiting on. `node_id` must match the run's active HUMAN wait (409 when the run is not waiting on a form, 422 on node mismatch, 403 when the wait is assigned to someone else). The submitted `inputs` become the form node's output, available to later nodes as `<node_id>.<field>`.
      * @param podId
      * @param runId
      * @param requestBody
-     * @returns FlowRunEntity Successful Response
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowRunResume(podId: string, runId: string, requestBody: Record<string, any>): CancelablePromise<FlowRunEntity>;
+    static workflowRunFormSubmit(podId: string, runId: string, requestBody: WorkflowRunFormSubmitRequest): CancelablePromise<WorkflowRunResponse>;
     /**
      * Visualize Workflow Run
      * Render an HTML view of a run overlaid on its workflow graph.
@@ -46,17 +56,6 @@ export declare class WorkflowsService {
      * @throws ApiError
      */
     static workflowRunVisualize(podId: string, runId: string): CancelablePromise<string>;
-    /**
-     * List Workflow Runs
-     * List recent runs for a given workflow.
-     * @param podId
-     * @param workflowName
-     * @param limit
-     * @param pageToken
-     * @returns WorkflowRunListResponse Successful Response
-     * @throws ApiError
-     */
-    static workflowRunList(podId: string, workflowName: string, limit?: number, pageToken?: (string | null)): CancelablePromise<WorkflowRunListResponse>;
     /**
      * List Workflows
      * List all workflows in a pod.
@@ -69,7 +68,7 @@ export declare class WorkflowsService {
     static workflowList(podId: string, limit?: number, pageToken?: (string | null)): CancelablePromise<WorkflowListResponse>;
     /**
      * Create Workflow
-     * Create a workflow definition. Use this before uploading graph nodes/edges with `workflow.graph.update`.
+     * Create a workflow definition. The graph (`nodes`/`edges`) can be included in this call to create a ready-to-run workflow in one step, or omitted to create a shell and upload the graph later with `workflow.graph.update`.
      * @param podId
      * @param requestBody
      * @returns FlowDetailResponse Successful Response
@@ -115,15 +114,25 @@ export declare class WorkflowsService {
      */
     static workflowGraphUpdate(podId: string, workflowName: string, requestBody: WorkflowGraphUpdateRequest): CancelablePromise<FlowDetailResponse>;
     /**
-     * Start Workflow
-     * Start a new workflow run. For event/scheduled/datastore starts, the request body is treated as initial trigger payload and merged into execution context.
+     * List Workflow Runs
+     * List recent runs for a given workflow.
      * @param podId
      * @param workflowName
-     * @param requestBody
-     * @returns FlowRunEntity Successful Response
+     * @param limit
+     * @param pageToken
+     * @returns WorkflowRunListResponse Successful Response
+     * @throws ApiError
+     */
+    static workflowRunList(podId: string, workflowName: string, limit?: number, pageToken?: (string | null)): CancelablePromise<WorkflowRunListResponse>;
+    /**
+     * Create Workflow Run
+     * Create a new run for this workflow. Takes no request body: if the workflow's entry node is a FORM node the run is created WAITING on it (see `active_wait` in the response) and input is submitted via `workflow.run.form.submit`; otherwise the run executes immediately. Trigger payloads for scheduled/event/datastore starts are supplied by the platform, not through this endpoint.
+     * @param podId
+     * @param workflowName
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowStart(podId: string, workflowName: string, requestBody: Record<string, any>): CancelablePromise<FlowRunEntity>;
+    static workflowRunCreate(podId: string, workflowName: string): CancelablePromise<WorkflowRunResponse>;
     /**
      * Visualize Workflow
      * Render an HTML visualization for debugging workflow graph structure.

package/dist/openapi_client/services/WorkflowsService.js

@@ -3,7 +3,7 @@ import { request as __request } from '../core/request.js';
 export class WorkflowsService {
     /**
      * List Workflow Runs Waiting For Current User
-     * List active human form waits assigned to the current pod member.
+     * The current user's approval queue: active form waits assigned to them, with the owning run.
      * @param podId
      * @param limit
      * @param pageToken
@@ -28,10 +28,10 @@ export class WorkflowsService {
     }
     /**
      * Get Workflow Run
-     * Get current state, context, and step history of a workflow run.
+     * Get current state, context, step history, and the active wait (when WAITING) of a workflow run.
      * @param podId
      * @param runId
-     * @returns FlowRunEntity Successful Response
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
     static workflowRunGet(podId, runId) {
@@ -48,71 +48,65 @@ export class WorkflowsService {
         });
     }
     /**
-     * Resume Workflow Run
-     * Resume a run in WAITING or EXECUTING state. The payload is written back into the current waiting node output and execution continues.
+     * Cancel Workflow Run
+     * Cancel a non-terminal run. The active wait (if any) is cancelled in the same transaction; late completion events for cancelled waits are dropped. Cancelling a terminal run returns 409.
      * @param podId
      * @param runId
-     * @param requestBody
-     * @returns FlowRunEntity Successful Response
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowRunResume(podId, runId, requestBody) {
+    static workflowRunCancel(podId, runId) {
         return __request(OpenAPI, {
             method: 'POST',
-            url: '/pods/{pod_id}/workflow-runs/{run_id}/resume',
+            url: '/pods/{pod_id}/workflow-runs/{run_id}/cancel',
             path: {
                 'pod_id': podId,
                 'run_id': runId,
             },
-            body: requestBody,
-            mediaType: 'application/json',
             errors: {
                 422: `Validation Error`,
             },
         });
     }
     /**
-     * Visualize Workflow Run
-     * Render an HTML view of a run overlaid on its workflow graph.
+     * Submit Workflow Run Form
+     * Submit the form the run is waiting on. `node_id` must match the run's active HUMAN wait (409 when the run is not waiting on a form, 422 on node mismatch, 403 when the wait is assigned to someone else). The submitted `inputs` become the form node's output, available to later nodes as `<node_id>.<field>`.
      * @param podId
      * @param runId
-     * @returns string Successful Response
+     * @param requestBody
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowRunVisualize(podId, runId) {
+    static workflowRunFormSubmit(podId, runId, requestBody) {
         return __request(OpenAPI, {
-            method: 'GET',
-            url: '/pods/{pod_id}/workflow-runs/{run_id}/visualize',
+            method: 'POST',
+            url: '/pods/{pod_id}/workflow-runs/{run_id}/form',
             path: {
                 'pod_id': podId,
                 'run_id': runId,
             },
+            body: requestBody,
+            mediaType: 'application/json',
             errors: {
                 422: `Validation Error`,
             },
         });
     }
     /**
-     * List Workflow Runs
-     * List recent runs for a given workflow.
+     * Visualize Workflow Run
+     * Render an HTML view of a run overlaid on its workflow graph.
      * @param podId
-     * @param workflowName
-     * @param limit
-     * @param pageToken
-     * @returns WorkflowRunListResponse Successful Response
+     * @param runId
+     * @returns string Successful Response
      * @throws ApiError
      */
-    static workflowRunList(podId, workflowName, limit = 100, pageToken) {
+    static workflowRunVisualize(podId, runId) {
         return __request(OpenAPI, {
             method: 'GET',
-            url: '/pods/{pod_id}/workflow-runs/{workflow_name}/runs',
+            url: '/pods/{pod_id}/workflow-runs/{run_id}/visualize',
             path: {
                 'pod_id': podId,
-                'workflow_name': workflowName,
-            },
-            query: {
-                'limit': limit,
-                'page_token': pageToken,
+                'run_id': runId,
             },
             errors: {
                 422: `Validation Error`,
@@ -146,7 +140,7 @@ export class WorkflowsService {
     }
     /**
      * Create Workflow
-     * Create a workflow definition. Use this before uploading graph nodes/edges with `workflow.graph.update`.
+     * Create a workflow definition. The graph (`nodes`/`edges`) can be included in this call to create a ready-to-run workflow in one step, or omitted to create a shell and upload the graph later with `workflow.graph.update`.
      * @param podId
      * @param requestBody
      * @returns FlowDetailResponse Successful Response
@@ -257,24 +251,48 @@ export class WorkflowsService {
         });
     }
     /**
-     * Start Workflow
-     * Start a new workflow run. For event/scheduled/datastore starts, the request body is treated as initial trigger payload and merged into execution context.
+     * List Workflow Runs
+     * List recent runs for a given workflow.
      * @param podId
      * @param workflowName
-     * @param requestBody
-     * @returns FlowRunEntity Successful Response
+     * @param limit
+     * @param pageToken
+     * @returns WorkflowRunListResponse Successful Response
+     * @throws ApiError
+     */
+    static workflowRunList(podId, workflowName, limit = 100, pageToken) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/pods/{pod_id}/workflows/{workflow_name}/runs',
+            path: {
+                'pod_id': podId,
+                'workflow_name': workflowName,
+            },
+            query: {
+                'limit': limit,
+                'page_token': pageToken,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+    /**
+     * Create Workflow Run
+     * Create a new run for this workflow. Takes no request body: if the workflow's entry node is a FORM node the run is created WAITING on it (see `active_wait` in the response) and input is submitted via `workflow.run.form.submit`; otherwise the run executes immediately. Trigger payloads for scheduled/event/datastore starts are supplied by the platform, not through this endpoint.
+     * @param podId
+     * @param workflowName
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowStart(podId, workflowName, requestBody) {
+    static workflowRunCreate(podId, workflowName) {
         return __request(OpenAPI, {
             method: 'POST',
-            url: '/pods/{pod_id}/workflows/{workflow_name}/start',
+            url: '/pods/{pod_id}/workflows/{workflow_name}/runs',
             path: {
                 'pod_id': podId,
                 'workflow_name': workflowName,
             },
-            body: requestBody,
-            mediaType: 'application/json',
             errors: {
                 422: `Validation Error`,
             },

package/dist/react/assistant-output.d.ts

@@ -2,5 +2,11 @@ import type { ConversationMessage } from "../types.js";
 export declare function normalizeConversationStatus(status: unknown): string | undefined;
 export declare function isConversationRunningStatus(status: unknown): boolean;
 export declare function extractConversationMessageText(content: unknown): string;
+/**
+ * Display text for a flat conversation message. Text/thinking/notification
+ * messages carry their body under `text`; tool_return messages may carry a
+ * human-readable payload under `tool_result`.
+ */
+export declare function conversationMessageText(message: Pick<ConversationMessage, "text" | "tool_result"> | null | undefined): string;
 export declare function sortConversationMessagesByCreatedAt(messages: ConversationMessage[]): ConversationMessage[];
 export declare function getLatestAssistantMessage(messages: ConversationMessage[]): ConversationMessage | null;

package/dist/react/assistant-output.js

@@ -72,6 +72,22 @@ export function extractConversationMessageText(content) {
         return content.text.trim();
     return extractTextFromStructuredContentEntry(content);
 }
+/**
+ * Display text for a flat conversation message. Text/thinking/notification
+ * messages carry their body under `text`; tool_return messages may carry a
+ * human-readable payload under `tool_result`.
+ */
+export function conversationMessageText(message) {
+    if (!message)
+        return "";
+    if (typeof message.text === "string" && message.text.trim().length > 0) {
+        return message.text.trim();
+    }
+    if (message.tool_result !== undefined && message.tool_result !== null) {
+        return extractConversationMessageText(message.tool_result);
+    }
+    return "";
+}
 export function sortConversationMessagesByCreatedAt(messages) {
     return [...messages].sort((a, b) => {
         const aTime = Number.isFinite(new Date(a.created_at).getTime()) ? new Date(a.created_at).getTime() : 0;

package/dist/react/useAddPodMember.js

@@ -20,7 +20,7 @@ export function useAddPodMember({ client, podId, enabled = true, defaultRole = P
             const resolvedPodId = resolvePodId(client, podId);
             const nextMember = await client.podMembers.add(resolvedPodId, {
                 organization_member_id: organizationMemberId,
-                role: input.role ?? defaultRole,
+                roles: [input.role ?? defaultRole],
             });
             setAddedMember(nextMember);
             onSuccessRef.current?.(nextMember);

package/dist/react/useAssistantController.d.ts

@@ -1,5 +1,5 @@
 import type { LemmaClient } from "../client.js";
-import type { AgentRuntimeConfig, AvailableModelInfo, Conversation, ConversationModel } from "../types.js";
+import type { AgentRuntimeConfig, AvailableModelInfo, Conversation, ConversationModel, MessageKind } from "../types.js";
 import { type AssistantStreamingTool } from "./useAssistantSession.js";
 export type { AssistantStreamingTool } from "./useAssistantSession.js";
 export interface AssistantConversationScope {
@@ -50,8 +50,12 @@ export interface AssistantRenderableMessage {
     agent_run_id?: string | null;
     metadata?: Record<string, unknown> | null;
     message_metadata?: Record<string, unknown> | null;
+    /** Flat message fields, passed through so consumers can inspect the raw kind. */
+    kind?: MessageKind;
     tool_call_id?: string | null;
     tool_name?: string | null;
+    tool_args?: unknown;
+    tool_result?: unknown;
 }
 export interface AssistantAction {
     id: string;
@@ -80,6 +84,7 @@ export interface UseAssistantControllerOptions extends AssistantConversationScop
 export interface SendAssistantControllerMessageOptions {
     forceNewConversation?: boolean;
     metadata?: Record<string, unknown> | null;
+    conversationMetadata?: Record<string, unknown> | null;
     instructions?: string | null;
 }
 export type AssistantUserApprovalDecision = "APPROVE_ONCE" | "APPROVE_FOR_SESSION" | "DENY";
@@ -93,6 +98,8 @@ export interface UseAssistantControllerResult {
     isActiveConversationRunning: boolean;
     isLoading: boolean;
     isLoadingConversations: boolean;
+    isLoadingMoreConversations: boolean;
+    hasMoreConversations: boolean;
     isLoadingMessages: boolean;
     isLoadingOlderMessages: boolean;
     hasOlderMessages: boolean;
@@ -112,6 +119,7 @@ export interface UseAssistantControllerResult {
     removePendingFile: (fileKey: string) => void;
     clearPendingFiles: () => void;
     loadOlderMessages: () => Promise<boolean>;
+    loadMoreConversations: () => Promise<Conversation[]>;
     resolveUserApproval: (approvalId: string, decision: AssistantUserApprovalDecision, response?: Record<string, unknown> | null) => Promise<void>;
     clearMessages: () => void;
     stop: () => void;