lemma-sdk 0.2.27 → 0.2.30

package/dist/react/assistant-output.js

@@ -0,0 +1,90 @@
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+export function normalizeConversationStatus(status) {
+    if (typeof status !== "string")
+        return undefined;
+    const normalized = status.trim().toUpperCase();
+    return normalized.length > 0 ? normalized : undefined;
+}
+export function isConversationRunningStatus(status) {
+    const normalized = normalizeConversationStatus(status);
+    if (!normalized)
+        return false;
+    return normalized === "RUNNING" || normalized === "IN_PROGRESS" || normalized === "PROCESSING";
+}
+function extractTextFromStructuredContentEntry(entry) {
+    if (typeof entry === "string")
+        return entry.trim();
+    if (!isRecord(entry))
+        return "";
+    if (typeof entry.text === "string")
+        return entry.text.trim();
+    if (typeof entry.content === "string")
+        return entry.content.trim();
+    if (typeof entry.value === "string")
+        return entry.value.trim();
+    if (Array.isArray(entry.content)) {
+        const nested = entry.content
+            .map((child) => extractTextFromStructuredContentEntry(child))
+            .filter((text) => text.length > 0)
+            .join("\n")
+            .trim();
+        if (nested.length > 0)
+            return nested;
+    }
+    if (Array.isArray(entry.summary)) {
+        const summary = entry.summary
+            .map((child) => extractTextFromStructuredContentEntry(child))
+            .filter((text) => text.length > 0)
+            .join("\n")
+            .trim();
+        if (summary.length > 0)
+            return summary;
+    }
+    return "";
+}
+export function extractConversationMessageText(content) {
+    if (typeof content === "string")
+        return content.trim();
+    if (Array.isArray(content)) {
+        return content
+            .map((entry) => extractTextFromStructuredContentEntry(entry))
+            .filter((text) => text.length > 0)
+            .join("\n\n")
+            .trim();
+    }
+    if (!isRecord(content))
+        return "";
+    const directContent = content.content;
+    if (typeof directContent === "string")
+        return directContent.trim();
+    if (Array.isArray(directContent)) {
+        const text = directContent
+            .map((entry) => extractTextFromStructuredContentEntry(entry))
+            .filter((entry) => entry.length > 0)
+            .join("\n\n")
+            .trim();
+        if (text.length > 0)
+            return text;
+    }
+    if (typeof content.text === "string")
+        return content.text.trim();
+    return extractTextFromStructuredContentEntry(content);
+}
+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;
+        const bTime = Number.isFinite(new Date(b.created_at).getTime()) ? new Date(b.created_at).getTime() : 0;
+        return aTime - bTime;
+    });
+}
+export function getLatestAssistantMessage(messages) {
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (typeof message?.role === "string" && message.role.toLowerCase() === "assistant") {
+            return message;
+        }
+    }
+    return null;
+}

package/dist/react/components/AssistantExperience.js

@@ -772,7 +772,7 @@ function ToolDetailsPanel({ toolName, args, state, result, onNavigateResource, r
     }
     return (_jsxs("div", { className: "lemma-assistant-tool-details-panel", children: [_jsxs("div", { className: "lemma-assistant-tool-details-header", children: [_jsxs("div", { className: "lemma-assistant-tool-details-heading", children: [_jsx("div", { className: "lemma-assistant-tool-details-title", children: primaryLabel }), hasCommentLabel ? (_jsx("div", { className: "lemma-assistant-tool-details-meta", children: toolDisplayName })) : null] }), canNavigate && onNavigateResource ? (_jsx("button", { type: "button", onClick: () => onNavigateResource(resultData.resourceType, resultData.resourceId, resultData), className: "lemma-assistant-tool-details-link", children: "Open" })) : null] }), _jsx("div", { className: "lemma-assistant-tool-details-stack", children: _jsxs("div", { className: "lemma-assistant-tool-details-section", children: [_jsx("dl", { className: "lemma-assistant-tool-details-list", children: detailRows.map((row, index) => (_jsxs("div", { className: "lemma-assistant-tool-details-list-item", children: [_jsx("dt", { className: "lemma-assistant-tool-details-key", children: row.label }), _jsx("dd", { className: "lemma-assistant-tool-details-value", children: row.value })] }, `${row.label}-${index}`))) }), hiddenInputCount > 0 ? (_jsxs("div", { className: "lemma-assistant-tool-details-more", children: ["+", hiddenInputCount, " more input field", hiddenInputCount === 1 ? "" : "s"] })) : null, hiddenOutputCount > 0 ? (_jsxs("div", { className: "lemma-assistant-tool-details-more", children: ["+", hiddenOutputCount, " more output field", hiddenOutputCount === 1 ? "" : "s"] })) : null, _jsxs("div", { className: "lemma-assistant-tool-details-raw-row", children: [_jsxs("details", { className: "lemma-assistant-tool-details-raw", children: [_jsx("summary", { className: "lemma-assistant-tool-details-raw-summary", children: "Raw input JSON" }), _jsx("div", { className: "lemma-assistant-tool-details-code", children: _jsx("pre", { className: "lemma-assistant-tool-details-code-text", children: JSON.stringify(args, null, 2) }) })] }), Object.keys(resultData).length > 0 ? (_jsxs("details", { className: "lemma-assistant-tool-details-raw", children: [_jsx("summary", { className: "lemma-assistant-tool-details-raw-summary", children: "Raw output JSON" }), _jsx("div", { className: "lemma-assistant-tool-details-code", children: _jsx("pre", { className: "lemma-assistant-tool-details-code-text", children: JSON.stringify(resultData, null, 2) }) })] })) : null] })] }) })] }));
 }
-function InlineToolCall({ invocation, isSelected, onClick, }) {
+function InlineToolCall({ invocation, isSelected, onClick, showStem = true, }) {
     const resultData = (invocation.result || {});
     const isExecuting = invocation.state !== "result";
     const isComplete = invocation.state === "result" && resultData.success !== false;
@@ -785,7 +785,8 @@ function InlineToolCall({ invocation, isSelected, onClick, }) {
         : isFailed
             ? (typeof resultData.error === "string" ? resultData.error : "Tool failed")
             : (formatToolResultSummary(invocation.toolName, invocation.args, resultData) || "Completed");
-    return (_jsxs("button", { type: "button", onClick: onClick, className: "lemma-assistant-inline-tool-call", "data-state": isExecuting ? "executing" : isComplete ? "complete" : isFailed ? "failed" : "idle", "data-selected": isSelected ? "true" : "false", children: [_jsxs("span", { className: "lemma-assistant-inline-tool-call-rail", "aria-hidden": "true", children: [_jsx("span", { className: "lemma-assistant-inline-tool-call-node" }), _jsx("span", { className: "lemma-assistant-inline-tool-call-stem" })] }), _jsxs("span", { className: "lemma-assistant-inline-tool-call-main", children: [_jsxs("span", { className: "lemma-assistant-inline-tool-call-head", children: [_jsx("span", { className: "lemma-assistant-inline-tool-call-name", children: primaryLabel }), _jsx("span", { className: "lemma-assistant-inline-tool-call-status", children: statusLabel }), _jsx("span", { className: "lemma-assistant-inline-tool-call-caret", children: isSelected ? "⌄" : "›" })] }), _jsx("span", { className: "lemma-assistant-inline-tool-call-meta", children: toolMeta }), _jsx("span", { className: "lemma-assistant-inline-tool-call-summary", children: summary })] })] }));
+    const showSummary = summary !== "Completed";
+    return (_jsxs("button", { type: "button", onClick: onClick, className: "lemma-assistant-inline-tool-call", "data-state": isExecuting ? "executing" : isComplete ? "complete" : isFailed ? "failed" : "idle", "data-selected": isSelected ? "true" : "false", children: [_jsxs("span", { className: "lemma-assistant-inline-tool-call-rail", "aria-hidden": "true", children: [_jsx("span", { className: "lemma-assistant-inline-tool-call-node" }), showStem ? _jsx("span", { className: "lemma-assistant-inline-tool-call-stem" }) : null] }), _jsxs("span", { className: "lemma-assistant-inline-tool-call-main", children: [_jsxs("span", { className: "lemma-assistant-inline-tool-call-head", children: [_jsx("span", { className: "lemma-assistant-inline-tool-call-name", children: primaryLabel }), _jsx("span", { className: "lemma-assistant-inline-tool-call-status", children: statusLabel }), _jsx("span", { className: "lemma-assistant-inline-tool-call-caret", children: isSelected ? "⌄" : "›" })] }), _jsx("span", { className: "lemma-assistant-inline-tool-call-meta", children: toolMeta }), showSummary ? _jsx("span", { className: "lemma-assistant-inline-tool-call-summary", children: summary }) : null] })] }));
 }
 function ToolActivityRollup({ detailParts, onNavigateResource, renderToolInvocation, message, activeConversationId, }) {
     const [activeToolCallId, setActiveToolCallId] = useState(null);
@@ -800,6 +801,7 @@ function ToolActivityRollup({ detailParts, onNavigateResource, renderToolInvocat
         ?.toolInvocation;
     const failedCount = toolParts.filter((part) => (part.toolInvocation.state === "result" && part.toolInvocation.result?.success === false)).length;
     const isWorking = !!activeInvocation || reasoningParts.some((part) => part.state === "streaming");
+    const isSingleDetail = detailParts.length === 1;
     const completionSummary = toolParts.length > 0
         ? `Completed ${toolParts.length} tool${toolParts.length === 1 ? "" : "s"}`
         : totalThoughtDurationMs > 0
@@ -815,7 +817,7 @@ function ToolActivityRollup({ detailParts, onNavigateResource, renderToolInvocat
         : `${totalThoughtDurationMs > 0
             ? `Worked for ${formatDurationCompact(totalThoughtDurationMs)}`
             : `Worked through ${detailParts.length} step${detailParts.length === 1 ? "" : "s"}`}${failedCount > 0 ? ` · ${failedCount} failed` : ""}`;
-    return (_jsxs("div", { className: "lemma-assistant-tool-rollup", children: [shouldCollapse ? (_jsxs("button", { type: "button", className: "lemma-assistant-tool-rollup-banner", onClick: () => setIsExpanded((prev) => !prev), "aria-expanded": isExpanded, "aria-label": isExpanded ? "Hide tool activity details" : "Show tool activity details", children: [_jsx("span", { className: "lemma-assistant-tool-rollup-banner-line", "aria-hidden": "true" }), _jsxs("span", { className: "lemma-assistant-tool-rollup-banner-copy", children: [isWorking ? _jsx("span", { className: "lemma-assistant-tool-rollup-dot", "aria-hidden": "true" }) : null, _jsx("span", { className: cx("lemma-assistant-tool-rollup-banner-label", isWorking && "lemma-assistant-tool-rollup-banner-label-working"), children: collapsedSummary }), _jsx("span", { className: "lemma-assistant-tool-rollup-banner-caret", "data-expanded": isExpanded ? "true" : "false", "aria-hidden": "true", children: "\u203A" })] }), _jsx("span", { className: "lemma-assistant-tool-rollup-banner-line", "aria-hidden": "true" })] })) : (_jsxs("div", { className: "lemma-assistant-tool-rollup-header", children: [isWorking ? _jsx("span", { className: "lemma-assistant-tool-rollup-dot" }) : null, _jsx("span", { className: cx("lemma-assistant-tool-rollup-summary", isWorking && "lemma-assistant-tool-rollup-summary-working"), children: summary })] })), !shouldCollapse || isExpanded ? (_jsx("div", { className: "lemma-assistant-tool-rollup-details", children: detailParts.map((part) => {
+    return (_jsxs("div", { className: "lemma-assistant-tool-rollup", "data-single": isSingleDetail ? "true" : "false", children: [shouldCollapse ? (_jsxs("button", { type: "button", className: "lemma-assistant-tool-rollup-banner", onClick: () => setIsExpanded((prev) => !prev), "aria-expanded": isExpanded, "aria-label": isExpanded ? "Hide tool activity details" : "Show tool activity details", children: [_jsx("span", { className: "lemma-assistant-tool-rollup-banner-line", "aria-hidden": "true" }), _jsxs("span", { className: "lemma-assistant-tool-rollup-banner-copy", children: [isWorking ? _jsx("span", { className: "lemma-assistant-tool-rollup-dot", "aria-hidden": "true" }) : null, _jsx("span", { className: cx("lemma-assistant-tool-rollup-banner-label", isWorking && "lemma-assistant-tool-rollup-banner-label-working"), children: collapsedSummary }), _jsx("span", { className: "lemma-assistant-tool-rollup-banner-caret", "data-expanded": isExpanded ? "true" : "false", "aria-hidden": "true", children: "\u203A" })] }), _jsx("span", { className: "lemma-assistant-tool-rollup-banner-line", "aria-hidden": "true" })] })) : (!isSingleDetail ? (_jsxs("div", { className: "lemma-assistant-tool-rollup-header", children: [isWorking ? _jsx("span", { className: "lemma-assistant-tool-rollup-dot" }) : null, _jsx("span", { className: cx("lemma-assistant-tool-rollup-summary", isWorking && "lemma-assistant-tool-rollup-summary-working"), children: summary })] })) : null), !shouldCollapse || isExpanded ? (_jsx("div", { className: cx("lemma-assistant-tool-rollup-details", isSingleDetail && "lemma-assistant-tool-rollup-details-single"), children: detailParts.map((part, partIndex) => {
                     if (part.type === "reasoning") {
                         return (_jsxs("div", { className: "lemma-assistant-tool-rollup-thinking", children: [_jsx("div", { className: "lemma-assistant-tool-rollup-thinking-title", children: part.state === "streaming"
                                         ? "Internal note"
@@ -823,7 +825,7 @@ function ToolActivityRollup({ detailParts, onNavigateResource, renderToolInvocat
                     }
                     const invocation = part.toolInvocation;
                     const isSelected = activeToolCallId === invocation.toolCallId;
-                    return (_jsxs("div", { className: "lemma-assistant-tool-rollup-item", children: [_jsx(InlineToolCall, { invocation: invocation, isSelected: isSelected, onClick: () => setActiveToolCallId((prev) => (prev === invocation.toolCallId ? null : invocation.toolCallId)) }), isSelected ? (_jsx(ToolDetailsPanel, { toolName: invocation.toolName, args: invocation.args, state: invocation.state, result: invocation.result, onNavigateResource: onNavigateResource, renderToolInvocation: renderToolInvocation, message: message, activeConversationId: activeConversationId })) : null] }, part.id));
+                    return (_jsxs("div", { className: "lemma-assistant-tool-rollup-item", children: [_jsx(InlineToolCall, { invocation: invocation, isSelected: isSelected, showStem: partIndex < detailParts.length - 1, onClick: () => setActiveToolCallId((prev) => (prev === invocation.toolCallId ? null : invocation.toolCallId)) }), isSelected ? (_jsx(ToolDetailsPanel, { toolName: invocation.toolName, args: invocation.args, state: invocation.state, result: invocation.result, onNavigateResource: onNavigateResource, renderToolInvocation: renderToolInvocation, message: message, activeConversationId: activeConversationId })) : null] }, part.id));
                 }) })) : null] }));
 }
 function ShowWidgetToolCard({ invocation, onSendPrompt, }) {

package/dist/react/index.d.ts

@@ -4,25 +4,59 @@ export { useAuth } from "./useAuth.js";
 export type { UseAuthResult } from "./useAuth.js";
 export { useAssistantRun } from "./useAssistantRun.js";
 export type { UseAssistantRunOptions, UseAssistantRunResult } from "./useAssistantRun.js";
+export { useConversations } from "./useConversations.js";
+export type { UseConversationsOptions, UseConversationsResult } from "./useConversations.js";
+export { useConversation } from "./useConversation.js";
+export type { UseConversationOptions, UseConversationResult } from "./useConversation.js";
+export { useConversationMessages } from "./useConversationMessages.js";
+export type { UseConversationMessagesOptions, UseConversationMessagesResult, } from "./useConversationMessages.js";
+export { useAgentRun } from "./useAgentRun.js";
+export type { UseAgentRunOptions, UseAgentRunResult } from "./useAgentRun.js";
 export { useAssistantSession } from "./useAssistantSession.js";
 export type { CreateConversationInput, SendAssistantMessageOptions, UseAssistantSessionOptions, UseAssistantSessionResult, } from "./useAssistantSession.js";
 export { useAssistantRuntime } from "./useAssistantRuntime.js";
 export type { UseAssistantRuntimeOptions, UseAssistantRuntimeResult, } from "./useAssistantRuntime.js";
+export { useMembers } from "./useMembers.js";
+export type { UseMembersOptions, UseMembersResult } from "./useMembers.js";
+export { useTables } from "./useTables.js";
+export type { UseTablesOptions, UseTablesResult } from "./useTables.js";
+export { useTable } from "./useTable.js";
+export type { UseTableOptions, UseTableResult } from "./useTable.js";
+export { useRecords } from "./useRecords.js";
+export type { UseRecordsOptions, UseRecordsResult } from "./useRecords.js";
+export { useRecord } from "./useRecord.js";
+export type { UseRecordOptions, UseRecordResult } from "./useRecord.js";
+export { useCreateRecord } from "./useCreateRecord.js";
+export type { UseCreateRecordOptions, UseCreateRecordResult } from "./useCreateRecord.js";
+export { useUpdateRecord } from "./useUpdateRecord.js";
+export type { UseUpdateRecordOptions, UseUpdateRecordResult } from "./useUpdateRecord.js";
+export { useDeleteRecord } from "./useDeleteRecord.js";
+export type { UseDeleteRecordOptions, UseDeleteRecordResult } from "./useDeleteRecord.js";
+export { useBulkRecords } from "./useBulkRecords.js";
+export type { UseBulkRecordsOptions, UseBulkRecordsResult } from "./useBulkRecords.js";
+export { useJoinedRecords } from "./useJoinedRecords.js";
+export type { UseJoinedRecordsOptions, UseJoinedRecordsResult } from "./useJoinedRecords.js";
+export { useRelatedRecords } from "./useRelatedRecords.js";
+export type { RelatedRecordsColumn, RelatedRecordsInclude, RelatedRecordsResolvedInclude, UseRelatedRecordsOptions, UseRelatedRecordsResult, } from "./useRelatedRecords.js";
+export { useReverseRelatedRecords } from "./useReverseRelatedRecords.js";
+export type { ReverseRelatedRecordsColumn, ReverseRelatedRelation, ReverseRelationSelector, UseReverseRelatedRecordsOptions, UseReverseRelatedRecordsResult, } from "./useReverseRelatedRecords.js";
+export { useForeignKeyOptions } from "./useForeignKeyOptions.js";
+export type { ForeignKeyOption, UseForeignKeyOptionsOptions, UseForeignKeyOptionsResult, } from "./useForeignKeyOptions.js";
+export { useRecordSchema } from "./useRecordSchema.js";
+export type { UseRecordSchemaOptions, UseRecordSchemaResult } from "./useRecordSchema.js";
+export { useRecordForm } from "./useRecordForm.js";
+export type { UseRecordFormOptions, UseRecordFormResult } from "./useRecordForm.js";
+export { useSchemaForm } from "./useSchemaForm.js";
+export type { UseSchemaFormOptions, UseSchemaFormResult } from "./useSchemaForm.js";
 export { useAssistantController } from "./useAssistantController.js";
 export type { AssistantAction, AssistantConversationScope, AssistantMessagePart, AssistantRenderableMessage, AssistantToolInvocation, UseAssistantControllerOptions, UseAssistantControllerResult, } from "./useAssistantController.js";
-export type { AssistantConversationRenderArgs, AssistantControllerView, AssistantExperienceCustomizationProps, AssistantMessageRenderArgs, EmptyStateSuggestion, AssistantPendingFileRenderArgs, AssistantPresentedFileRenderArgs, AssistantToolRenderArgs, } from "./components/assistant-types.js";
-export { AssistantAskOverlay, AssistantComposer, AssistantConversationList, AssistantHeader, AssistantMessageViewport, AssistantModelPicker, AssistantPendingFileChip, AssistantShellLayout, AssistantStatusPill, AssistantThemeScope, } from "./components/AssistantChrome.js";
-export type { AssistantAskOverlayProps, AssistantComposerProps, AssistantConversationListProps, AssistantHeaderProps, AssistantMessageViewportProps, AssistantModelPickerProps, AssistantPendingFileChipProps, AssistantShellLayoutProps, AssistantStatusPillProps, AssistantSurfaceTone, AssistantThemeMode, AssistantThemeScopeProps, } from "./components/AssistantChrome.js";
-export { AssistantExperienceView } from "./components/AssistantExperience.js";
-export type { ActiveToolBanner, AskUserInputQuestion, AssistantChromeStyle, AssistantExperienceViewProps, AssistantRadiusScale, AssistantStatusPlacement, DisplayMessageRow, EmptyStateProps, PendingAskUserInput, PlanStepState, PlanSummaryState, } from "./components/AssistantExperience.js";
-export { AssistantEmbedded } from "./components/AssistantEmbedded.js";
-export type { AssistantEmbeddedProps } from "./components/AssistantEmbedded.js";
-export { buildDisplayMessageRows, DEFAULT_EMPTY_STATE_SUGGESTIONS, dedupToolInvocations, EmptyState, findPendingAskUserInput, formatAskUserInputAnswers, getActiveToolBanner, extractPresentFilePathsFromInvocation, latestPlanSummary, MessageGroup, PlanSummaryStrip, ThinkingIndicator, } from "./components/AssistantExperience.js";
 export { useTaskSession } from "./useTaskSession.js";
 export type { CreateTaskInput, UseTaskSessionOptions, UseTaskSessionResult, } from "./useTaskSession.js";
 export { useFunctionSession } from "./useFunctionSession.js";
 export type { UseFunctionSessionOptions, UseFunctionSessionResult, } from "./useFunctionSession.js";
 export { useFlowSession } from "./useFlowSession.js";
 export type { UseFlowSessionOptions, UseFlowSessionResult, } from "./useFlowSession.js";
+export { useWorkflowStart } from "./useWorkflowStart.js";
+export type { UseWorkflowStartOptions, UseWorkflowStartResult, } from "./useWorkflowStart.js";
 export { useFlowRunHistory } from "./useFlowRunHistory.js";
 export type { UseFlowRunHistoryOptions, UseFlowRunHistoryResult, } from "./useFlowRunHistory.js";

package/dist/react/index.js

@@ -1,14 +1,31 @@
 export { AuthGuard } from "./AuthGuard.js";
 export { useAuth } from "./useAuth.js";
 export { useAssistantRun } from "./useAssistantRun.js";
+export { useConversations } from "./useConversations.js";
+export { useConversation } from "./useConversation.js";
+export { useConversationMessages } from "./useConversationMessages.js";
+export { useAgentRun } from "./useAgentRun.js";
 export { useAssistantSession } from "./useAssistantSession.js";
 export { useAssistantRuntime } from "./useAssistantRuntime.js";
+export { useMembers } from "./useMembers.js";
+export { useTables } from "./useTables.js";
+export { useTable } from "./useTable.js";
+export { useRecords } from "./useRecords.js";
+export { useRecord } from "./useRecord.js";
+export { useCreateRecord } from "./useCreateRecord.js";
+export { useUpdateRecord } from "./useUpdateRecord.js";
+export { useDeleteRecord } from "./useDeleteRecord.js";
+export { useBulkRecords } from "./useBulkRecords.js";
+export { useJoinedRecords } from "./useJoinedRecords.js";
+export { useRelatedRecords } from "./useRelatedRecords.js";
+export { useReverseRelatedRecords } from "./useReverseRelatedRecords.js";
+export { useForeignKeyOptions } from "./useForeignKeyOptions.js";
+export { useRecordSchema } from "./useRecordSchema.js";
+export { useRecordForm } from "./useRecordForm.js";
+export { useSchemaForm } from "./useSchemaForm.js";
 export { useAssistantController } from "./useAssistantController.js";
-export { AssistantAskOverlay, AssistantComposer, AssistantConversationList, AssistantHeader, AssistantMessageViewport, AssistantModelPicker, AssistantPendingFileChip, AssistantShellLayout, AssistantStatusPill, AssistantThemeScope, } from "./components/AssistantChrome.js";
-export { AssistantExperienceView } from "./components/AssistantExperience.js";
-export { AssistantEmbedded } from "./components/AssistantEmbedded.js";
-export { buildDisplayMessageRows, DEFAULT_EMPTY_STATE_SUGGESTIONS, dedupToolInvocations, EmptyState, findPendingAskUserInput, formatAskUserInputAnswers, getActiveToolBanner, extractPresentFilePathsFromInvocation, latestPlanSummary, MessageGroup, PlanSummaryStrip, ThinkingIndicator, } from "./components/AssistantExperience.js";
 export { useTaskSession } from "./useTaskSession.js";
 export { useFunctionSession } from "./useFunctionSession.js";
 export { useFlowSession } from "./useFlowSession.js";
+export { useWorkflowStart } from "./useWorkflowStart.js";
 export { useFlowRunHistory } from "./useFlowRunHistory.js";

package/dist/react/useAgentRun.d.ts

@@ -0,0 +1,17 @@
+import type { Task } from "../types.js";
+import { type UseTaskSessionOptions, type UseTaskSessionResult } from "./useTaskSession.js";
+export interface UseAgentRunOptions extends Omit<UseTaskSessionOptions, "taskId"> {
+    agentName?: string;
+    taskId?: string | null;
+}
+export interface UseAgentRunResult extends Omit<UseTaskSessionResult, "start"> {
+    output: Task["output_data"];
+    finalOutput: Task["output_data"];
+    isWaitingForInput: boolean;
+    isFinished: boolean;
+    start: (inputData?: Record<string, unknown> | null, options?: {
+        agentName?: string;
+    }) => Promise<Task>;
+    submitInput: (content: string) => Promise<Task | null>;
+}
+export declare function useAgentRun({ client, podId, agentName, taskId, autoConnect, autoConnectOnStart, onEvent, onStatus, onMessage, onError, }: UseAgentRunOptions): UseAgentRunResult;

package/dist/react/useAgentRun.js

@@ -0,0 +1,58 @@
+import { useCallback } from "react";
+import { isTerminalTaskStatus, normalizeRunStatus } from "../run-utils.js";
+import { useTaskSession, } from "./useTaskSession.js";
+function resolveAgentName(base, override) {
+    const resolved = override ?? base;
+    if (!resolved) {
+        throw new Error("agentName is required.");
+    }
+    return resolved;
+}
+function resolvePodClient(client, podId) {
+    if (!podId || podId === client.podId)
+        return client;
+    return client.withPod(podId);
+}
+export function useAgentRun({ client, podId, agentName, taskId = null, autoConnect = true, autoConnectOnStart = true, onEvent, onStatus, onMessage, onError, }) {
+    const session = useTaskSession({
+        client,
+        podId,
+        taskId,
+        autoConnect,
+        autoConnectOnStart,
+        onEvent,
+        onStatus,
+        onMessage,
+        onError,
+    });
+    const start = useCallback(async (inputData, options) => {
+        return session.start({
+            agentName: resolveAgentName(agentName, options?.agentName),
+            inputData: inputData ?? undefined,
+        });
+    }, [agentName, session]);
+    const submitInput = useCallback(async (content) => {
+        const resolvedTaskId = session.taskId;
+        if (!resolvedTaskId) {
+            throw new Error("taskId is required to submit additional agent input.");
+        }
+        const scopedClient = resolvePodClient(client, podId);
+        await scopedClient.tasks.messages.add(resolvedTaskId, { content });
+        await session.loadMessages(resolvedTaskId);
+        return session.refreshTask(resolvedTaskId);
+    }, [client, podId, session]);
+    const normalizedStatus = normalizeRunStatus(session.status);
+    const isFinished = isTerminalTaskStatus(normalizedStatus);
+    const isWaitingForInput = normalizedStatus === "WAITING";
+    const output = session.task?.output_data ?? null;
+    const finalOutput = isFinished ? output : null;
+    return {
+        ...session,
+        output,
+        finalOutput,
+        isWaitingForInput,
+        isFinished,
+        start,
+        submitInput,
+    };
+}

package/dist/react/useAssistantRun.d.ts

@@ -1,5 +1,6 @@
 import type { LemmaClient } from "../client.js";
 import type { SseRawEvent } from "../streams.js";
+import type { ConversationMessage } from "../types.js";
 export interface UseAssistantRunOptions {
     client: LemmaClient;
     podId?: string;
@@ -10,6 +11,14 @@ export interface UseAssistantRunOptions {
 export interface UseAssistantRunResult {
     isStreaming: boolean;
     error: Error | null;
+    status?: string;
+    messages: ConversationMessage[];
+    output: ConversationMessage["content"] | null;
+    outputText: string;
+    finalOutput: ConversationMessage["content"] | null;
+    finalOutputText: string;
+    latestAssistantMessage: ConversationMessage | null;
+    refresh: () => Promise<ConversationMessage[]>;
     sendMessage: (content: string) => Promise<void>;
     resume: () => Promise<void>;
     stop: () => Promise<void>;

package/dist/react/useAssistantRun.js

@@ -1,4 +1,4 @@
-import { useAssistantSession } from "./useAssistantSession.js";
+import { useConversationMessages } from "./useConversationMessages.js";
 function requireConversationId(conversationId) {
     if (!conversationId) {
         throw new Error("conversationId is required.");
@@ -6,31 +6,41 @@ function requireConversationId(conversationId) {
     return conversationId;
 }
 export function useAssistantRun({ client, podId, conversationId, onEvent, onError, }) {
-    const session = useAssistantSession({
+    const messages = useConversationMessages({
         client,
         podId,
         conversationId,
+        autoLoad: true,
+        autoResume: false,
         onEvent,
         onError,
     });
     const sendMessage = async (content) => {
-        await session.sendMessage(content, {
-            conversationId: requireConversationId(conversationId ?? session.conversationId),
+        await messages.sendMessage(content, {
+            conversationId: requireConversationId(conversationId ?? messages.conversationId),
             createIfMissing: false,
         });
     };
     const resume = async () => {
-        await session.resume(requireConversationId(conversationId ?? session.conversationId));
+        await messages.resume(requireConversationId(conversationId ?? messages.conversationId));
     };
     const stop = async () => {
-        await session.stop(requireConversationId(conversationId ?? session.conversationId));
+        await messages.stop(requireConversationId(conversationId ?? messages.conversationId));
     };
     return {
-        isStreaming: session.isStreaming,
-        error: session.error,
+        isStreaming: messages.isStreaming,
+        error: messages.error,
+        status: messages.status,
+        messages: messages.messages,
+        output: messages.output,
+        outputText: messages.outputText,
+        finalOutput: messages.finalOutput,
+        finalOutputText: messages.finalOutputText,
+        latestAssistantMessage: messages.latestAssistantMessage,
+        refresh: () => messages.refresh(),
         sendMessage,
         resume,
         stop,
-        cancel: session.cancel,
+        cancel: messages.cancel,
     };
 }

package/dist/react/useAssistantSession.d.ts

@@ -59,6 +59,11 @@ export interface UseAssistantSessionResult {
     conversation: Conversation | null;
     status?: string;
     messages: ConversationMessage[];
+    latestAssistantMessage: ConversationMessage | null;
+    output: ConversationMessage["content"] | null;
+    outputText: string;
+    finalOutput: ConversationMessage["content"] | null;
+    finalOutputText: string;
     streamingText: string;
     isStreaming: boolean;
     error: Error | null;