@invergent/agent-chat-react 0.2.2

package/dist/index.d.ts

@@ -0,0 +1,409 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { ComponentProps } from 'react';
+import { Streamdown } from 'streamdown';
+
+type AgentChatRole = "user" | "assistant" | "system";
+type AgentChatMessageStatus = "complete" | "streaming" | "error";
+type AgentChatSystemKind = "skill_invoked" | "artifact" | "error";
+interface AgentChatImageAttachment {
+    /** data: URL (data:image/png;base64,...) or raw base64 string */
+    data: string;
+    /** MIME type, e.g. "image/png", "image/jpeg" */
+    mimeType?: string;
+}
+interface AgentChatMessage {
+    id: string;
+    role: AgentChatRole;
+    content: string;
+    createdAt: Date;
+    status: AgentChatMessageStatus;
+    toolCalls?: AgentChatToolCallInfo[];
+    reasoning?: string;
+    systemKind?: AgentChatSystemKind;
+    systemMeta?: Record<string, unknown>;
+    errorInfo?: AgentChatErrorInfo;
+    images?: AgentChatImageAttachment[];
+}
+interface AgentChatToolCallInfo {
+    id: string;
+    toolName: string;
+    args: string;
+    result?: string;
+    status: "running" | "complete" | "error";
+    checkpointHash?: string;
+    expertResultEventId?: number;
+    expertFeedback?: {
+        rating: "up" | "down";
+        reason?: string;
+    };
+    clarifyAnswers?: AgentChatClarifyAnswer[];
+    cancelled?: boolean;
+}
+interface AgentChatTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens: number;
+    cachedInputTokens: number;
+    totalTokens: number;
+    contextWindow: number;
+    model: string;
+}
+interface AgentChatRetryIndicator {
+    title: string;
+    detail: string;
+    attempt: number;
+}
+type AgentChatErrorCategory = "provider_error" | "rate_limit" | "auth_failed" | "context_overflow" | "network" | "timeout" | "invalid_response" | "tool_error" | "storage_error" | "database_error" | "governance_denied" | "unknown";
+interface AgentChatErrorInfo {
+    category: AgentChatErrorCategory;
+    title: string;
+    detail: string;
+    retryable: boolean;
+}
+interface AgentChatSession {
+    id: string;
+    userId?: string | null;
+    orgId?: string | null;
+    agentId?: string | null;
+    channel?: string | null;
+    status: "active" | "paused" | "completed" | "failed" | string;
+    title?: string | null;
+    model?: string | null;
+    config?: Record<string, unknown>;
+    parentId?: string | null;
+    messageCount?: number;
+    toolCallCount?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    estimatedCostUsd?: number | string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface AgentChatSessionList {
+    sessions: AgentChatSession[];
+    total: number;
+}
+interface AgentChatSessionTreeNode {
+    id: string;
+    parentId: string | null;
+    rootSessionId?: string | null;
+    depth?: number;
+    agentId?: string | null;
+    agentType?: string | null;
+    channel?: string | null;
+    status: "active" | "paused" | "completed" | "failed" | string;
+    title?: string | null;
+    model?: string | null;
+    messageCount?: number;
+    toolCallCount?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AgentChatSessionTree {
+    nodes: AgentChatSessionTreeNode[];
+    total: number;
+}
+type AgentChatEventType = "user.message" | "llm.request" | "llm.response" | "llm.thinking" | "llm.delta" | "tool.call" | "tool.result" | "session.start" | "session.pause" | "session.resume" | "session.complete" | "session.fail" | "session.done" | "harness.wake" | "harness.crash" | "context.compact" | "skill.invoked" | "policy.denied" | "stream.timeout" | "expert.result" | "expert.endorse" | "expert.override" | "artifact.created" | "artifact.updated" | "clarify.response";
+interface AgentChatRuntimeEvent {
+    type: AgentChatEventType;
+    eventId: number;
+    data: Record<string, unknown>;
+}
+interface AgentChatState {
+    messages: AgentChatMessage[];
+    isRunning: boolean;
+    isLoadingHistory: boolean;
+    tokenUsage: AgentChatTokenUsage;
+    retryIndicator: AgentChatRetryIndicator | null;
+    lastEventId: number;
+    sessionDone: boolean;
+    hadDeltas: boolean;
+    terminal: boolean;
+    workspaceRefreshKey: number;
+}
+type AgentChatArtifactKind = "markdown" | "table" | "chart" | "html" | "svg";
+interface AgentChatArtifactMeta {
+    artifact_id: string;
+    session_id: string;
+    name: string;
+    kind: AgentChatArtifactKind;
+    version: number;
+    size: number;
+    created_at: string;
+}
+interface AgentChatMarkdownArtifactSpec {
+    content: string;
+}
+interface AgentChatTableArtifactSpec {
+    columns: string[];
+    rows: Array<Record<string, unknown>>;
+    caption?: string | null;
+}
+interface AgentChatChartArtifactSpec {
+    chart_js: Record<string, unknown>;
+    caption?: string | null;
+}
+interface AgentChatHtmlArtifactSpec {
+    html: string;
+    caption?: string | null;
+}
+interface AgentChatSvgArtifactSpec {
+    svg: string;
+    caption?: string | null;
+}
+type AgentChatArtifactPayload = {
+    meta: AgentChatArtifactMeta;
+    kind: "markdown";
+    spec: AgentChatMarkdownArtifactSpec;
+} | {
+    meta: AgentChatArtifactMeta;
+    kind: "table";
+    spec: AgentChatTableArtifactSpec;
+} | {
+    meta: AgentChatArtifactMeta;
+    kind: "chart";
+    spec: AgentChatChartArtifactSpec;
+} | {
+    meta: AgentChatArtifactMeta;
+    kind: "html";
+    spec: AgentChatHtmlArtifactSpec;
+} | {
+    meta: AgentChatArtifactMeta;
+    kind: "svg";
+    spec: AgentChatSvgArtifactSpec;
+};
+interface AgentChatClarifyChoice {
+    label: string;
+    description?: string;
+}
+interface AgentChatClarifyQuestion {
+    prompt: string;
+    choices?: AgentChatClarifyChoice[];
+    allow_other?: boolean;
+}
+interface AgentChatClarifyArgs {
+    questions: AgentChatClarifyQuestion[];
+}
+interface AgentChatClarifyAnswer {
+    question: string;
+    answer: string;
+    is_other: boolean;
+}
+interface AgentChatSlashCommand {
+    value: string;
+    label: string;
+    description: string;
+}
+interface AgentChatWorkspaceEntry {
+    name: string;
+    path: string;
+    kind: "file" | "dir";
+    size?: number | null;
+    children?: AgentChatWorkspaceEntry[] | null;
+}
+interface AgentChatWorkspaceTree {
+    root: string;
+    entries: AgentChatWorkspaceEntry[];
+    truncated: boolean;
+}
+interface AgentChatWorkspaceFile {
+    path: string;
+    content: string;
+    size: number;
+    mime_type?: string | null;
+    encoding: "utf-8" | "base64";
+    truncated: boolean;
+}
+interface AgentChatWorkspaceUpload {
+    path: string;
+    size: number;
+}
+type AgentChatExpertFeedbackRating = "up" | "down";
+interface AgentChatSseMessageEvent {
+    data: string;
+    lastEventId: string;
+}
+interface AgentChatEventStream {
+    addEventListener(type: AgentChatEventType, listener: (event: AgentChatSseMessageEvent) => void): void;
+    close(): void;
+    onerror: (() => void) | null;
+}
+interface AgentChatAdapter {
+    listSessions(input: {
+        agentId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<AgentChatSessionList>;
+    createSession(input: {
+        agentId?: string;
+        system?: string;
+    }): Promise<AgentChatSession>;
+    getSession(input: {
+        sessionId: string;
+    }): Promise<AgentChatSession>;
+    sendMessage(input: {
+        sessionId: string;
+        content: string;
+        images?: AgentChatImageAttachment[];
+    }): Promise<{
+        eventId?: number;
+        status?: string;
+    }>;
+    pauseSession(input: {
+        sessionId: string;
+    }): Promise<void>;
+    retrySession(input: {
+        sessionId: string;
+    }): Promise<AgentChatSession>;
+    deleteSession?(input: {
+        sessionId: string;
+    }): Promise<void>;
+    getSessionTree?(input: {
+        sessionId: string;
+    }): Promise<AgentChatSessionTree>;
+    stopSession?(input: {
+        sessionId: string;
+    }): Promise<void>;
+    getArtifact(input: {
+        sessionId: string;
+        artifactId: string;
+    }): Promise<AgentChatArtifactPayload>;
+    submitClarifyResponse(input: {
+        sessionId: string;
+        toolCallId: string;
+        responses: AgentChatClarifyAnswer[];
+    }): Promise<{
+        eventId?: number;
+    }>;
+    submitExpertFeedback?(input: {
+        sessionId: string;
+        expertResultEventId: number;
+        rating: AgentChatExpertFeedbackRating;
+        reason?: string;
+    }): Promise<{
+        eventId?: number;
+        eventType?: string;
+    }>;
+    listSlashCommands?(): Promise<AgentChatSlashCommand[]>;
+    getWorkspaceTree(input: {
+        sessionId: string;
+    }): Promise<AgentChatWorkspaceTree>;
+    getWorkspaceFile(input: {
+        sessionId: string;
+        path: string;
+    }): Promise<AgentChatWorkspaceFile>;
+    uploadWorkspaceFile(input: {
+        sessionId: string;
+        file: File;
+        directory?: string;
+    }): Promise<AgentChatWorkspaceUpload>;
+    deleteWorkspaceFile(input: {
+        sessionId: string;
+        path: string;
+    }): Promise<void>;
+    /**
+     * Build a same-origin URL the browser can navigate to (or anchor at via
+     * ``<a href download>``) to download the workspace file.  The adapter
+     * is responsible for embedding any auth credential the server expects
+     * — typically as a query-string token, since cross-origin/anchor
+     * downloads can't carry custom headers.
+     */
+    getWorkspaceDownloadUrl(input: {
+        sessionId: string;
+        path: string;
+    }): string;
+    openEventStream(input: {
+        sessionId: string;
+        after: number;
+    }): AgentChatEventStream;
+}
+interface AgentChatRuntimeApi {
+    messages: AgentChatMessage[];
+    isRunning: boolean;
+    isLoadingHistory: boolean;
+    tokenUsage: AgentChatTokenUsage;
+    retryIndicator: AgentChatRetryIndicator | null;
+    workspaceRefreshKey: number;
+    send(content: string, images?: AgentChatImageAttachment[]): Promise<void>;
+    stop(): Promise<void>;
+    retry(): Promise<void>;
+    markSending(content: string): void;
+    markSendError(errorText: string): void;
+}
+type ChatMessage = AgentChatMessage;
+type SessionTreeNode = AgentChatSessionTreeNode;
+type SessionTree = AgentChatSessionTree;
+type ToolCallInfo = AgentChatToolCallInfo;
+type TokenUsage = AgentChatTokenUsage;
+type RetryIndicator = AgentChatRetryIndicator;
+type ErrorInfo = AgentChatErrorInfo;
+type ArtifactKind = AgentChatArtifactKind;
+type ArtifactPayload = AgentChatArtifactPayload;
+type MarkdownArtifactSpec = AgentChatMarkdownArtifactSpec;
+type TableArtifactSpec = AgentChatTableArtifactSpec;
+type ChartArtifactSpec = AgentChatChartArtifactSpec;
+type HtmlArtifactSpec = AgentChatHtmlArtifactSpec;
+type SvgArtifactSpec = AgentChatSvgArtifactSpec;
+type ClarifyChoice = AgentChatClarifyChoice;
+type ClarifyQuestion = AgentChatClarifyQuestion;
+type ClarifyArgs = AgentChatClarifyArgs;
+type ClarifyAnswer = AgentChatClarifyAnswer;
+type WorkspaceEntry = AgentChatWorkspaceEntry;
+type WorkspaceTree = AgentChatWorkspaceTree;
+type WorkspaceFile = AgentChatWorkspaceFile;
+type WorkspaceUpload = AgentChatWorkspaceUpload;
+
+interface AgentChatProps {
+    adapter: AgentChatAdapter;
+    agentId?: string;
+    sessionId: string | null;
+    onSessionChange?: (sessionId: string) => void;
+    onFileSelect?: (path: string) => void;
+    onMessagesChange?: (messages: AgentChatMessage[]) => void;
+    disabled?: boolean;
+}
+declare function AgentChat({ adapter, agentId, sessionId, onSessionChange, onFileSelect, onMessagesChange, disabled, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+
+interface AgentChatAdapterContextValue {
+    adapter: AgentChatAdapter;
+    sessionId: string | null;
+    onFileSelect?: (path: string) => void;
+}
+declare const AgentChatAdapterProvider: React.Provider<AgentChatAdapterContextValue | null>;
+declare function useAgentChatAdapterContext(): AgentChatAdapterContextValue;
+
+interface UseAgentChatRuntimeInput {
+    adapter: AgentChatAdapter;
+    agentId?: string;
+    sessionId: string | null;
+    onSessionChange?: (sessionId: string) => void;
+}
+declare function useAgentChatRuntime({ adapter, agentId, sessionId, onSessionChange, }: UseAgentChatRuntimeInput): AgentChatRuntimeApi;
+
+type MessageResponseProps = ComponentProps<typeof Streamdown>;
+declare const MessageResponse: React.MemoExoticComponent<({ className, ...props }: MessageResponseProps) => react_jsx_runtime.JSX.Element>;
+
+interface SessionTreePanelProps {
+    adapter: AgentChatAdapter;
+    sessionId?: string | null;
+    activeSessionId?: string;
+    agentId?: string;
+    title?: string;
+    sessionListLimit?: number;
+    /** Treat the root as hidden, so its children appear as top-level rows. */
+    hideRoot?: boolean;
+    /** Suppress the header row (icon + title + running count badge). */
+    hideHeader?: boolean;
+    /**
+     * Fetch the tenant's full session list via ``adapter.listSessions`` and
+     * merge it with the per-session tree.  Off by default; the panel renders
+     * only the tree of ``sessionId`` unless this is set.
+     */
+    loadList?: boolean;
+    onSessionSelect?: (sessionId: string) => void;
+    onSessionDelete?: (sessionId: string) => void;
+}
+declare function SessionTreePanel({ adapter, sessionId, activeSessionId, agentId, title, sessionListLimit, hideRoot, hideHeader, loadList, onSessionSelect, onSessionDelete, }: SessionTreePanelProps): react_jsx_runtime.JSX.Element | null;
+
+export { AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatChartArtifactSpec, type AgentChatClarifyAnswer, type AgentChatClarifyArgs, type AgentChatClarifyChoice, type AgentChatClarifyQuestion, type AgentChatErrorCategory, type AgentChatErrorInfo, type AgentChatEventStream, type AgentChatEventType, type AgentChatExpertFeedbackRating, type AgentChatHtmlArtifactSpec, type AgentChatImageAttachment, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatProps, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatSession, type AgentChatSessionList, type AgentChatSessionTree, type AgentChatSessionTreeNode, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type AgentChatWorkspaceEntry, type AgentChatWorkspaceFile, type AgentChatWorkspaceTree, type AgentChatWorkspaceUpload, type ArtifactKind, type ArtifactPayload, type ChartArtifactSpec, type ChatMessage, type ClarifyAnswer, type ClarifyArgs, type ClarifyChoice, type ClarifyQuestion, type ErrorInfo, type HtmlArtifactSpec, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, type RetryIndicator, type SessionTree, type SessionTreeNode, SessionTreePanel, type SessionTreePanelProps, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, type WorkspaceEntry, type WorkspaceFile, type WorkspaceTree, type WorkspaceUpload, useAgentChatAdapterContext, useAgentChatRuntime };