lemma-sdk 0.2.28 → 0.2.31

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

@@ -1,3 +1,4 @@
+import type { ConvertedFileResponse } from '../models/ConvertedFileResponse.js';
 import type { CreateFolderRequest } from '../models/CreateFolderRequest.js';
 import type { DatastoreFileUploadRequest } from '../models/DatastoreFileUploadRequest.js';
 import type { DatastoreMessageResponse } from '../models/DatastoreMessageResponse.js';
@@ -28,7 +29,7 @@ export declare class FilesService {
      */
     static fileUpload(podId: string, formData: DatastoreFileUploadRequest): CancelablePromise<FileResponse>;
     /**
-     * Delete File Or Folder. Deleting a folder will cleanup whole subtreee
+     * Delete File Or Folder
      * @param podId
      * @param path
      * @returns DatastoreMessageResponse Successful Response
@@ -51,6 +52,31 @@ export declare class FilesService {
      * @throws ApiError
      */
     static fileUpdate(podId: string, formData: update): CancelablePromise<FileResponse>;
+    /**
+     * Get Converted File Metadata
+     * @param podId
+     * @param path
+     * @returns ConvertedFileResponse Successful Response
+     * @throws ApiError
+     */
+    static fileConvertedGet(podId: string, path: string): CancelablePromise<ConvertedFileResponse>;
+    /**
+     * Download Converted File Artifact
+     * @param podId
+     * @param path
+     * @param artifact
+     * @returns any Successful Response
+     * @throws ApiError
+     */
+    static fileConvertedDownload(podId: string, path: string, artifact?: string): CancelablePromise<any>;
+    /**
+     * Render Converted File As HTML
+     * @param podId
+     * @param path
+     * @returns any Successful Response
+     * @throws ApiError
+     */
+    static fileConvertedRender(podId: string, path: string): CancelablePromise<any>;
     /**
      * Download File
      * @param podId

package/dist/openapi_client/services/FilesService.js

@@ -49,7 +49,7 @@ export class FilesService {
         });
     }
     /**
-     * Delete File Or Folder. Deleting a folder will cleanup whole subtreee
+     * Delete File Or Folder
      * @param podId
      * @param path
      * @returns DatastoreMessageResponse Successful Response
@@ -113,6 +113,74 @@ export class FilesService {
             },
         });
     }
+    /**
+     * Get Converted File Metadata
+     * @param podId
+     * @param path
+     * @returns ConvertedFileResponse Successful Response
+     * @throws ApiError
+     */
+    static fileConvertedGet(podId, path) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/pods/{pod_id}/datastore/files/converted/by-path',
+            path: {
+                'pod_id': podId,
+            },
+            query: {
+                'path': path,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+    /**
+     * Download Converted File Artifact
+     * @param podId
+     * @param path
+     * @param artifact
+     * @returns any Successful Response
+     * @throws ApiError
+     */
+    static fileConvertedDownload(podId, path, artifact = 'document.md') {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/pods/{pod_id}/datastore/files/converted/download',
+            path: {
+                'pod_id': podId,
+            },
+            query: {
+                'path': path,
+                'artifact': artifact,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+    /**
+     * Render Converted File As HTML
+     * @param podId
+     * @param path
+     * @returns any Successful Response
+     * @throws ApiError
+     */
+    static fileConvertedRender(podId, path) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/pods/{pod_id}/datastore/files/converted/render',
+            path: {
+                'pod_id': podId,
+            },
+            query: {
+                'path': path,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
     /**
      * Download File
      * @param podId

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

@@ -107,7 +107,7 @@ export declare class WorkflowsService {
     static workflowGraphUpdate(podId: string, workflowName: string, requestBody: WorkflowGraphUpdateRequest): CancelablePromise<FlowResponse>;
     /**
      * Install Workflow
-     * Install a workflow for runtime execution. Provide `account_id` when the workflow needs an integration account binding.
+     * Install a workflow for runtime execution. Provide `account_id` when the workflow needs an integration account binding, and provide `schedule` when installing a scheduled workflow.
      * @param podId
      * @param workflowName
      * @param requestBody

package/dist/openapi_client/services/WorkflowsService.js

@@ -233,7 +233,7 @@ export class WorkflowsService {
     }
     /**
      * Install Workflow
-     * Install a workflow for runtime execution. Provide `account_id` when the workflow needs an integration account binding.
+     * Install a workflow for runtime execution. Provide `account_id` when the workflow needs an integration account binding, and provide `schedule` when installing a scheduled workflow.
      * @param podId
      * @param workflowName
      * @param requestBody

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

@@ -0,0 +1,6 @@
+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;
+export declare function sortConversationMessagesByCreatedAt(messages: ConversationMessage[]): ConversationMessage[];
+export declare function getLatestAssistantMessage(messages: ConversationMessage[]): ConversationMessage | null;

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/index.d.ts

@@ -4,25 +4,79 @@ 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 { useAgentRuns } from "./useAgentRuns.js";
+export type { UseAgentRunsOptions, UseAgentRunsResult } from "./useAgentRuns.js";
+export { useAgentInputSchema } from "./useAgentInputSchema.js";
+export type { UseAgentInputSchemaOptions, UseAgentInputSchemaResult, } from "./useAgentInputSchema.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 { useOrganizationMembers } from "./useOrganizationMembers.js";
+export type { UseOrganizationMembersOptions, UseOrganizationMembersResult, } from "./useOrganizationMembers.js";
+export { useCurrentUser } from "./useCurrentUser.js";
+export type { UseCurrentUserOptions, UseCurrentUserResult } from "./useCurrentUser.js";
+export { usePodAccess } from "./usePodAccess.js";
+export type { PodAccessStatus, UsePodAccessOptions, UsePodAccessResult, } from "./usePodAccess.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 { useFunctionRun } from "./useFunctionRun.js";
+export type { UseFunctionRunOptions, UseFunctionRunResult } from "./useFunctionRun.js";
+export { useFunctionRuns } from "./useFunctionRuns.js";
+export type { UseFunctionRunsOptions, UseFunctionRunsResult } from "./useFunctionRuns.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 { useWorkflowRun } from "./useWorkflowRun.js";
+export type { UseWorkflowRunOptions, UseWorkflowRunResult } from "./useWorkflowRun.js";
+export { useWorkflowRuns } from "./useWorkflowRuns.js";
+export type { UseWorkflowRunsOptions, UseWorkflowRunsResult } from "./useWorkflowRuns.js";
+export { useWorkflowResume } from "./useWorkflowResume.js";
+export type { UseWorkflowResumeOptions, UseWorkflowResumeResult, } from "./useWorkflowResume.js";
 export { useFlowRunHistory } from "./useFlowRunHistory.js";
 export type { UseFlowRunHistoryOptions, UseFlowRunHistoryResult, } from "./useFlowRunHistory.js";

package/dist/react/index.js

@@ -1,14 +1,41 @@
 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 { useAgentRuns } from "./useAgentRuns.js";
+export { useAgentInputSchema } from "./useAgentInputSchema.js";
 export { useAssistantSession } from "./useAssistantSession.js";
 export { useAssistantRuntime } from "./useAssistantRuntime.js";
+export { useMembers } from "./useMembers.js";
+export { useOrganizationMembers } from "./useOrganizationMembers.js";
+export { useCurrentUser } from "./useCurrentUser.js";
+export { usePodAccess } from "./usePodAccess.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 { useFunctionRun } from "./useFunctionRun.js";
+export { useFunctionRuns } from "./useFunctionRuns.js";
 export { useFlowSession } from "./useFlowSession.js";
+export { useWorkflowStart } from "./useWorkflowStart.js";
+export { useWorkflowRun } from "./useWorkflowRun.js";
+export { useWorkflowRuns } from "./useWorkflowRuns.js";
+export { useWorkflowResume } from "./useWorkflowResume.js";
 export { useFlowRunHistory } from "./useFlowRunHistory.js";

package/dist/react/useAgentInputSchema.d.ts

@@ -0,0 +1,19 @@
+import type { LemmaClient } from "../client.js";
+import type { JsonSchemaLike } from "../schema-form.js";
+import type { Agent } from "../types.js";
+export interface UseAgentInputSchemaOptions {
+    client: LemmaClient;
+    podId?: string;
+    agentName: string;
+    enabled?: boolean;
+    autoLoad?: boolean;
+}
+export interface UseAgentInputSchemaResult {
+    agent: Agent | null;
+    inputSchema: JsonSchemaLike | null;
+    outputSchema: JsonSchemaLike | null;
+    isLoading: boolean;
+    error: Error | null;
+    refresh: () => Promise<Agent | null>;
+}
+export declare function useAgentInputSchema({ client, podId, agentName, enabled, autoLoad, }: UseAgentInputSchemaOptions): UseAgentInputSchemaResult;

package/dist/react/useAgentInputSchema.js

@@ -0,0 +1,73 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { normalizeError, resolvePodClient } from "./utils.js";
+export function useAgentInputSchema({ client, podId, agentName, enabled = true, autoLoad = true, }) {
+    const [agent, setAgent] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const trimmedAgentName = agentName.trim();
+    const isEnabled = enabled && trimmedAgentName.length > 0;
+    const refresh = useCallback(async (signal) => {
+        if (!isEnabled) {
+            setAgent(null);
+            setError(null);
+            setIsLoading(false);
+            return null;
+        }
+        setIsLoading(true);
+        setError(null);
+        try {
+            const scopedClient = resolvePodClient(client, podId);
+            const nextAgent = await scopedClient.agents.get(trimmedAgentName);
+            if (signal?.aborted)
+                return null;
+            setAgent(nextAgent);
+            return nextAgent;
+        }
+        catch (refreshError) {
+            if (signal?.aborted)
+                return null;
+            const normalized = normalizeError(refreshError, "Failed to load agent schema.");
+            setError(normalized);
+            setAgent(null);
+            return null;
+        }
+        finally {
+            if (!signal?.aborted)
+                setIsLoading(false);
+        }
+    }, [client, isEnabled, podId, trimmedAgentName]);
+    useEffect(() => {
+        if (!isEnabled) {
+            setAgent(null);
+            setError(null);
+            setIsLoading(false);
+            return;
+        }
+        if (!autoLoad)
+            return;
+        const controller = new AbortController();
+        let cancelled = false;
+        (async () => {
+            try {
+                await refresh(controller.signal);
+            }
+            catch {
+                if (!cancelled) {
+                    setError(normalizeError(new Error("Failed to load agent schema."), "Failed to load agent schema."));
+                }
+            }
+        })();
+        return () => {
+            cancelled = true;
+            controller.abort();
+        };
+    }, [autoLoad, isEnabled, refresh]);
+    return useMemo(() => ({
+        agent,
+        inputSchema: (agent?.input_schema ?? null),
+        outputSchema: (agent?.output_schema ?? null),
+        isLoading,
+        error,
+        refresh,
+    }), [agent, error, isLoading, refresh]);
+}

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,56 @@
+import { useCallback, useMemo } from "react";
+import { isTerminalTaskStatus, normalizeRunStatus } from "../run-utils.js";
+import { resolvePodClient } from "./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;
+}
+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]);
+    return useMemo(() => {
+        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,
+        };
+    }, [session, start, submitInput]);
+}

package/dist/react/useAgentRuns.d.ts

@@ -0,0 +1,33 @@
+import type { LemmaClient } from "../client.js";
+import type { Task } from "../types.js";
+export interface UseAgentRunsOptions {
+    client: LemmaClient;
+    podId?: string;
+    agentName?: string;
+    enabled?: boolean;
+    autoLoad?: boolean;
+    limit?: number;
+    pageToken?: string;
+    initialTaskId?: string | null;
+}
+export interface UseAgentRunsResult {
+    runs: Task[];
+    total: number;
+    nextPageToken: string | null;
+    selectedTaskId: string | null;
+    effectiveSelectedTaskId: string | null;
+    selectedRun: Task | null;
+    isLoading: boolean;
+    isLoadingMore: boolean;
+    error: Error | null;
+    selectRun: (taskId: string | null) => void;
+    clearSelection: () => void;
+    refresh: (overrides?: {
+        limit?: number;
+        pageToken?: string;
+    }) => Promise<Task[]>;
+    loadMore: (overrides?: {
+        limit?: number;
+    }) => Promise<Task[]>;
+}
+export declare function useAgentRuns({ client, podId, agentName, enabled, autoLoad, limit, pageToken, initialTaskId, }: UseAgentRunsOptions): UseAgentRunsResult;