@invergent/agent-chat-react 1.4.3

package/dist/index.d.cts

@@ -0,0 +1,287 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+
+type AgentChatRole = "user" | "assistant" | "system";
+type AgentChatMessageStatus = "complete" | "streaming" | "error";
+type AgentChatSystemKind = "skill_invoked" | "artifact" | "error";
+interface AgentChatMessage {
+    id: string;
+    role: AgentChatRole;
+    content: string;
+    createdAt: Date;
+    status: AgentChatMessageStatus;
+    toolCalls?: AgentChatToolCallInfo[];
+    reasoning?: string;
+    systemKind?: AgentChatSystemKind;
+    systemMeta?: Record<string, unknown>;
+    errorInfo?: AgentChatErrorInfo;
+}
+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;
+}
+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;
+    tokenUsage: AgentChatTokenUsage;
+    retryIndicator: AgentChatRetryIndicator | null;
+    lastEventId: number;
+    sessionDone: boolean;
+    hadDeltas: boolean;
+    terminal: boolean;
+}
+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 {
+    vega_lite: 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;
+}
+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;
+    }): Promise<{
+        eventId?: number;
+        status?: string;
+    }>;
+    pauseSession(input: {
+        sessionId: string;
+    }): Promise<void>;
+    retrySession(input: {
+        sessionId: string;
+    }): Promise<AgentChatSession>;
+    deleteSession?(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[]>;
+    openEventStream(input: {
+        sessionId: string;
+        after: number;
+    }): AgentChatEventStream;
+}
+interface AgentChatRuntimeApi {
+    messages: AgentChatMessage[];
+    isRunning: boolean;
+    tokenUsage: AgentChatTokenUsage;
+    retryIndicator: AgentChatRetryIndicator | null;
+    send(content: string): Promise<void>;
+    stop(): Promise<void>;
+    retry(): Promise<void>;
+    markSending(content: string): void;
+    markSendError(errorText: string): void;
+}
+type ChatMessage = AgentChatMessage;
+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;
+
+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;
+
+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 AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatProps, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatSession, type AgentChatSessionList, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type ArtifactKind, type ArtifactPayload, type ChartArtifactSpec, type ChatMessage, type ClarifyAnswer, type ClarifyArgs, type ClarifyChoice, type ClarifyQuestion, type ErrorInfo, type HtmlArtifactSpec, type MarkdownArtifactSpec, type RetryIndicator, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, useAgentChatAdapterContext, useAgentChatRuntime };

package/dist/index.d.ts

@@ -0,0 +1,287 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+
+type AgentChatRole = "user" | "assistant" | "system";
+type AgentChatMessageStatus = "complete" | "streaming" | "error";
+type AgentChatSystemKind = "skill_invoked" | "artifact" | "error";
+interface AgentChatMessage {
+    id: string;
+    role: AgentChatRole;
+    content: string;
+    createdAt: Date;
+    status: AgentChatMessageStatus;
+    toolCalls?: AgentChatToolCallInfo[];
+    reasoning?: string;
+    systemKind?: AgentChatSystemKind;
+    systemMeta?: Record<string, unknown>;
+    errorInfo?: AgentChatErrorInfo;
+}
+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;
+}
+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;
+    tokenUsage: AgentChatTokenUsage;
+    retryIndicator: AgentChatRetryIndicator | null;
+    lastEventId: number;
+    sessionDone: boolean;
+    hadDeltas: boolean;
+    terminal: boolean;
+}
+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 {
+    vega_lite: 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;
+}
+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;
+    }): Promise<{
+        eventId?: number;
+        status?: string;
+    }>;
+    pauseSession(input: {
+        sessionId: string;
+    }): Promise<void>;
+    retrySession(input: {
+        sessionId: string;
+    }): Promise<AgentChatSession>;
+    deleteSession?(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[]>;
+    openEventStream(input: {
+        sessionId: string;
+        after: number;
+    }): AgentChatEventStream;
+}
+interface AgentChatRuntimeApi {
+    messages: AgentChatMessage[];
+    isRunning: boolean;
+    tokenUsage: AgentChatTokenUsage;
+    retryIndicator: AgentChatRetryIndicator | null;
+    send(content: string): Promise<void>;
+    stop(): Promise<void>;
+    retry(): Promise<void>;
+    markSending(content: string): void;
+    markSendError(errorText: string): void;
+}
+type ChatMessage = AgentChatMessage;
+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;
+
+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;
+
+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 AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatProps, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatSession, type AgentChatSessionList, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type ArtifactKind, type ArtifactPayload, type ChartArtifactSpec, type ChatMessage, type ClarifyAnswer, type ClarifyArgs, type ClarifyChoice, type ClarifyQuestion, type ErrorInfo, type HtmlArtifactSpec, type MarkdownArtifactSpec, type RetryIndicator, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, useAgentChatAdapterContext, useAgentChatRuntime };