lemma-sdk 0.2.9 → 0.2.11

package/dist/react/components/assistant-types.d.ts

@@ -0,0 +1,72 @@
+import type { ReactNode } from "react";
+import type { AssistantRenderableMessage, AssistantToolInvocation } from "../useAssistantController.js";
+export interface AssistantConversationListItem {
+    id: string;
+    title?: string | null;
+    status?: string | null;
+    updated_at?: string | null;
+    created_at?: string | null;
+}
+export interface AssistantControllerView {
+    messages: AssistantRenderableMessage[];
+    conversations: AssistantConversationListItem[];
+    activeConversationId: string | null;
+    conversationModel: string | null;
+    setConversationModel(model: string | null): Promise<void>;
+    isActiveConversationRunning: boolean;
+    isLoading: boolean;
+    isLoadingConversations: boolean;
+    isLoadingMessages: boolean;
+    isLoadingOlderMessages: boolean;
+    hasOlderMessages: boolean;
+    isUploadingFiles: boolean;
+    pendingFiles: File[];
+    error: string | null;
+    pendingActions: unknown[];
+    completedActions: unknown[];
+    selectConversation(conversationId: string | null): void;
+    sendMessage(content: string, options?: {
+        forceNewConversation?: boolean;
+    }): Promise<void>;
+    uploadFiles(files: File[], options?: {
+        deferUntilSend?: boolean;
+    }): Promise<void>;
+    removePendingFile(fileKey: string): void;
+    clearPendingFiles(): void;
+    loadOlderMessages(): Promise<boolean>;
+    clearMessages(): void;
+    stop(): void;
+}
+export interface AssistantConversationRenderArgs {
+    conversation: AssistantConversationListItem;
+    isActive: boolean;
+}
+export interface AssistantMessageRenderArgs {
+    message: AssistantRenderableMessage;
+}
+export interface AssistantToolRenderArgs {
+    invocation: AssistantToolInvocation;
+    message: AssistantRenderableMessage;
+    activeConversationId: string | null;
+}
+export interface AssistantPresentedFileRenderArgs extends AssistantToolRenderArgs {
+    filepath: string;
+}
+export interface AssistantPendingFileRenderArgs {
+    file: File;
+    remove: () => void;
+}
+export interface AssistantExperienceCustomizationProps {
+    title?: ReactNode;
+    subtitle?: ReactNode;
+    placeholder?: string;
+    emptyState?: ReactNode;
+    draft?: string;
+    onDraftChange?: (value: string) => void;
+    showConversationList?: boolean;
+    renderConversationLabel?: (args: AssistantConversationRenderArgs) => ReactNode;
+    renderMessageContent?: (args: AssistantMessageRenderArgs) => ReactNode;
+    renderToolInvocation?: (args: AssistantToolRenderArgs) => ReactNode;
+    renderPresentedFile?: (args: AssistantPresentedFileRenderArgs) => ReactNode;
+    renderPendingFile?: (args: AssistantPendingFileRenderArgs) => ReactNode;
+}

package/dist/react/components/assistant-types.js

@@ -0,0 +1 @@
+export {};

package/dist/react/index.d.ts

@@ -10,6 +10,12 @@ 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 { useAssistantController } from "./useAssistantController.js";
+export type { AssistantAction, AssistantConversationScope, AssistantMessagePart, AssistantRenderableMessage, AssistantToolInvocation, UseAssistantControllerOptions, UseAssistantControllerResult, } from "./useAssistantController.js";
+export type { AssistantConversationRenderArgs, AssistantControllerView, AssistantExperienceCustomizationProps, AssistantMessageRenderArgs, AssistantPendingFileRenderArgs, AssistantPresentedFileRenderArgs, AssistantToolRenderArgs, } from "./components/assistant-types.js";
+export { AssistantExperienceView } from "./components/AssistantExperience.js";
+export type { ActiveToolBanner, AskUserInputQuestion, AssistantExperienceViewProps, DisplayMessageRow, PendingAskUserInput, PlanStepState, PlanSummaryState, } from "./components/AssistantExperience.js";
+export { buildDisplayMessageRows, 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";

package/dist/react/index.js

@@ -4,6 +4,9 @@ export { useAgentRunStream } from "./useAgentRun.js";
 export { useAssistantRun } from "./useAssistantRun.js";
 export { useAssistantSession } from "./useAssistantSession.js";
 export { useAssistantRuntime } from "./useAssistantRuntime.js";
+export { useAssistantController } from "./useAssistantController.js";
+export { AssistantExperienceView } from "./components/AssistantExperience.js";
+export { buildDisplayMessageRows, 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";

package/dist/react/useAssistantController.d.ts

@@ -0,0 +1,83 @@
+import type { LemmaClient } from "../client.js";
+import type { Conversation, ConversationModel } from "../types.js";
+export interface AssistantConversationScope {
+    podId?: string | null;
+    assistantId?: string | null;
+    organizationId?: string | null;
+}
+export interface AssistantToolInvocation {
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    state: "call" | "result";
+    result?: Record<string, unknown>;
+}
+export type AssistantMessagePart = {
+    id: string;
+    type: "text";
+    text: string;
+} | {
+    id: string;
+    type: "reasoning";
+    text: string;
+    state?: "streaming" | "done";
+    durationMs?: number;
+    startedAtMs?: number;
+} | {
+    id: string;
+    type: "tool";
+    toolInvocation: AssistantToolInvocation;
+};
+export interface AssistantRenderableMessage {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    toolInvocations?: AssistantToolInvocation[];
+    parts?: AssistantMessagePart[];
+    createdAt?: Date;
+}
+export interface AssistantAction {
+    id: string;
+    type: "tool_call" | "message" | "thinking";
+    status: "pending" | "executing" | "completed" | "failed";
+    toolName?: string;
+    toolArgs?: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+    timestamp: Date;
+}
+export interface UseAssistantControllerOptions extends AssistantConversationScope {
+    client: LemmaClient;
+    enabled?: boolean;
+}
+export interface UseAssistantControllerResult {
+    messages: AssistantRenderableMessage[];
+    conversations: Conversation[];
+    activeConversationId: string | null;
+    conversationModel: ConversationModel | null;
+    isActiveConversationRunning: boolean;
+    isLoading: boolean;
+    isLoadingConversations: boolean;
+    isLoadingMessages: boolean;
+    isLoadingOlderMessages: boolean;
+    hasOlderMessages: boolean;
+    isUploadingFiles: boolean;
+    pendingFiles: File[];
+    error: string | null;
+    pendingActions: AssistantAction[];
+    completedActions: AssistantAction[];
+    selectConversation: (conversationId: string | null) => void;
+    setConversationModel: (model: ConversationModel | null) => Promise<void>;
+    sendMessage: (content: string, options?: {
+        forceNewConversation?: boolean;
+    }) => Promise<void>;
+    uploadFiles: (files: File[], options?: {
+        deferUntilSend?: boolean;
+    }) => Promise<void>;
+    removePendingFile: (fileKey: string) => void;
+    clearPendingFiles: () => void;
+    loadOlderMessages: () => Promise<boolean>;
+    clearMessages: () => void;
+    stop: () => void;
+}
+export declare function useAssistantController({ client, podId, assistantId, organizationId, enabled, }: UseAssistantControllerOptions): UseAssistantControllerResult;