@invergent/agent-chat-react 1.6.1 → 1.6.2

package/dist/index.d.cts

@@ -132,6 +132,45 @@ interface AgentChatScheduledWorkList {
     items: AgentChatScheduledWorkItem[];
     total: number;
 }
+type AgentChatInboxKind = "input_required" | "action_required" | "task_complete" | "governance_gate" | "progress_checkin" | (string & {});
+type AgentChatInboxStatus = "pending" | "acknowledged" | "responded" | "expired" | (string & {});
+interface AgentChatInboxItem {
+    id: number;
+    orgId: string;
+    userId: string;
+    sessionId: string;
+    sourceEventId: number;
+    kind: AgentChatInboxKind;
+    status: AgentChatInboxStatus;
+    title: string;
+    body: string | null;
+    payload: Record<string, unknown>;
+    actionRef: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+    readAt: string | null;
+    respondedAt: string | null;
+}
+interface AgentChatInboxList {
+    items: AgentChatInboxItem[];
+    nextCursor: string | null;
+}
+interface AgentChatInboxListInput {
+    status?: AgentChatInboxStatus;
+    kind?: AgentChatInboxKind;
+    sessionId?: string;
+    cursor?: string;
+    limit?: number;
+}
+interface AgentChatInboxStreamEvent {
+    data: string;
+    lastEventId?: string;
+}
+interface AgentChatInboxEventStream {
+    addEventListener(type: "item" | "snapshot", listener: (event: AgentChatInboxStreamEvent) => void): void;
+    close(): void;
+    onerror: (() => void) | null;
+}
 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" | "browser.provisioned" | "browser.destroyed" | "browser.control_granted" | "browser.control_returned" | "clarify.response";
 interface AgentChatRuntimeEvent {
     type: AgentChatEventType;
@@ -142,6 +181,10 @@ interface AgentChatBrowserState {
     status: "provisioning" | "live" | "user-control" | "closed";
     controlOwner: string | null;
 }
+interface AgentChatBrowserPreviewSnapshot {
+    src: string;
+    capturedAt?: string;
+}
 interface AgentChatBrowserStateResponse {
     status: "live" | "user-control";
     controlOwner: string | null;
@@ -321,6 +364,27 @@ interface AgentChatAdapter {
     cancelScheduledWork?(input: {
         scheduleId: string;
     }): Promise<void>;
+    listInbox?(input?: AgentChatInboxListInput): Promise<AgentChatInboxList>;
+    getInboxItem?(input: {
+        itemId: number;
+    }): Promise<AgentChatInboxItem>;
+    markInboxItemRead?(input: {
+        itemId: number;
+    }): Promise<AgentChatInboxItem>;
+    acknowledgeInboxItem?(input: {
+        itemId: number;
+    }): Promise<AgentChatInboxItem>;
+    deleteInboxItem?(input: {
+        itemId: number;
+    }): Promise<void>;
+    respondGovernanceInboxItem?(input: {
+        itemId: number;
+        decision: "approve" | "reject";
+    }): Promise<AgentChatInboxItem>;
+    respondActionRequiredInboxItem?(input: {
+        itemId: number;
+    }): Promise<AgentChatInboxItem>;
+    openInboxStream?(): AgentChatInboxEventStream;
     getArtifact(input: {
         sessionId: string;
         artifactId: string;
@@ -374,6 +438,7 @@ interface AgentChatAdapter {
         after: number;
     }): AgentChatEventStream;
     getBrowserState(sessionId: string): Promise<AgentChatBrowserStateResponse | null>;
+    getBrowserPreviewSnapshot?(sessionId: string): Promise<AgentChatBrowserPreviewSnapshot | null>;
     acquireBrowserControl(sessionId: string): Promise<AgentChatBrowserControlResponse>;
     releaseBrowserControl(sessionId: string): Promise<void>;
     browserLiveViewUrl(sessionId: string): string;
@@ -398,6 +463,8 @@ type SessionTreeNode = AgentChatSessionTreeNode;
 type SessionTree = AgentChatSessionTree;
 type ScheduledWorkItem = AgentChatScheduledWorkItem;
 type ScheduledWorkList = AgentChatScheduledWorkList;
+type InboxItem = AgentChatInboxItem;
+type InboxList = AgentChatInboxList;
 type ToolCallInfo = AgentChatToolCallInfo;
 type TokenUsage = AgentChatTokenUsage;
 type RetryIndicator = AgentChatRetryIndicator;
@@ -448,6 +515,24 @@ declare function useAgentChatRuntime({ adapter, agentId, sessionId, onSessionCha
 type MessageResponseProps = ComponentProps<typeof Streamdown>;
 declare const MessageResponse: React.MemoExoticComponent<({ className, ...props }: MessageResponseProps) => react_jsx_runtime.JSX.Element>;
 
+interface InboxPanelProps {
+    adapter: AgentChatAdapter;
+    title?: string;
+    selectedId?: number | null;
+    onSelectedIdChange?: (itemId: number | null) => void;
+    onSessionSelect?: (sessionId: string) => void;
+    hideHeader?: boolean;
+    limit?: number;
+}
+declare function InboxPanel({ adapter, title, selectedId, onSelectedIdChange, onSessionSelect, hideHeader, limit, }: InboxPanelProps): react_jsx_runtime.JSX.Element;
+
+interface InboxUnreadCountState {
+    unreadCount: number;
+    hasLoaded: boolean;
+    error: string | null;
+}
+declare function useInboxUnreadCount(adapter: AgentChatAdapter): InboxUnreadCountState;
+
 interface ScheduledWorkPanelProps {
     adapter: AgentChatAdapter;
     agentId?: string;
@@ -484,4 +569,4 @@ interface SessionTreePanelProps {
 }
 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 AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, 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 ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, 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 };
+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 AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatProps, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, 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 InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, type RetryIndicator, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, 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, useInboxUnreadCount };

package/dist/index.d.ts

@@ -132,6 +132,45 @@ interface AgentChatScheduledWorkList {
     items: AgentChatScheduledWorkItem[];
     total: number;
 }
+type AgentChatInboxKind = "input_required" | "action_required" | "task_complete" | "governance_gate" | "progress_checkin" | (string & {});
+type AgentChatInboxStatus = "pending" | "acknowledged" | "responded" | "expired" | (string & {});
+interface AgentChatInboxItem {
+    id: number;
+    orgId: string;
+    userId: string;
+    sessionId: string;
+    sourceEventId: number;
+    kind: AgentChatInboxKind;
+    status: AgentChatInboxStatus;
+    title: string;
+    body: string | null;
+    payload: Record<string, unknown>;
+    actionRef: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+    readAt: string | null;
+    respondedAt: string | null;
+}
+interface AgentChatInboxList {
+    items: AgentChatInboxItem[];
+    nextCursor: string | null;
+}
+interface AgentChatInboxListInput {
+    status?: AgentChatInboxStatus;
+    kind?: AgentChatInboxKind;
+    sessionId?: string;
+    cursor?: string;
+    limit?: number;
+}
+interface AgentChatInboxStreamEvent {
+    data: string;
+    lastEventId?: string;
+}
+interface AgentChatInboxEventStream {
+    addEventListener(type: "item" | "snapshot", listener: (event: AgentChatInboxStreamEvent) => void): void;
+    close(): void;
+    onerror: (() => void) | null;
+}
 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" | "browser.provisioned" | "browser.destroyed" | "browser.control_granted" | "browser.control_returned" | "clarify.response";
 interface AgentChatRuntimeEvent {
     type: AgentChatEventType;
@@ -142,6 +181,10 @@ interface AgentChatBrowserState {
     status: "provisioning" | "live" | "user-control" | "closed";
     controlOwner: string | null;
 }
+interface AgentChatBrowserPreviewSnapshot {
+    src: string;
+    capturedAt?: string;
+}
 interface AgentChatBrowserStateResponse {
     status: "live" | "user-control";
     controlOwner: string | null;
@@ -321,6 +364,27 @@ interface AgentChatAdapter {
     cancelScheduledWork?(input: {
         scheduleId: string;
     }): Promise<void>;
+    listInbox?(input?: AgentChatInboxListInput): Promise<AgentChatInboxList>;
+    getInboxItem?(input: {
+        itemId: number;
+    }): Promise<AgentChatInboxItem>;
+    markInboxItemRead?(input: {
+        itemId: number;
+    }): Promise<AgentChatInboxItem>;
+    acknowledgeInboxItem?(input: {
+        itemId: number;
+    }): Promise<AgentChatInboxItem>;
+    deleteInboxItem?(input: {
+        itemId: number;
+    }): Promise<void>;
+    respondGovernanceInboxItem?(input: {
+        itemId: number;
+        decision: "approve" | "reject";
+    }): Promise<AgentChatInboxItem>;
+    respondActionRequiredInboxItem?(input: {
+        itemId: number;
+    }): Promise<AgentChatInboxItem>;
+    openInboxStream?(): AgentChatInboxEventStream;
     getArtifact(input: {
         sessionId: string;
         artifactId: string;
@@ -374,6 +438,7 @@ interface AgentChatAdapter {
         after: number;
     }): AgentChatEventStream;
     getBrowserState(sessionId: string): Promise<AgentChatBrowserStateResponse | null>;
+    getBrowserPreviewSnapshot?(sessionId: string): Promise<AgentChatBrowserPreviewSnapshot | null>;
     acquireBrowserControl(sessionId: string): Promise<AgentChatBrowserControlResponse>;
     releaseBrowserControl(sessionId: string): Promise<void>;
     browserLiveViewUrl(sessionId: string): string;
@@ -398,6 +463,8 @@ type SessionTreeNode = AgentChatSessionTreeNode;
 type SessionTree = AgentChatSessionTree;
 type ScheduledWorkItem = AgentChatScheduledWorkItem;
 type ScheduledWorkList = AgentChatScheduledWorkList;
+type InboxItem = AgentChatInboxItem;
+type InboxList = AgentChatInboxList;
 type ToolCallInfo = AgentChatToolCallInfo;
 type TokenUsage = AgentChatTokenUsage;
 type RetryIndicator = AgentChatRetryIndicator;
@@ -448,6 +515,24 @@ declare function useAgentChatRuntime({ adapter, agentId, sessionId, onSessionCha
 type MessageResponseProps = ComponentProps<typeof Streamdown>;
 declare const MessageResponse: React.MemoExoticComponent<({ className, ...props }: MessageResponseProps) => react_jsx_runtime.JSX.Element>;
 
+interface InboxPanelProps {
+    adapter: AgentChatAdapter;
+    title?: string;
+    selectedId?: number | null;
+    onSelectedIdChange?: (itemId: number | null) => void;
+    onSessionSelect?: (sessionId: string) => void;
+    hideHeader?: boolean;
+    limit?: number;
+}
+declare function InboxPanel({ adapter, title, selectedId, onSelectedIdChange, onSessionSelect, hideHeader, limit, }: InboxPanelProps): react_jsx_runtime.JSX.Element;
+
+interface InboxUnreadCountState {
+    unreadCount: number;
+    hasLoaded: boolean;
+    error: string | null;
+}
+declare function useInboxUnreadCount(adapter: AgentChatAdapter): InboxUnreadCountState;
+
 interface ScheduledWorkPanelProps {
     adapter: AgentChatAdapter;
     agentId?: string;
@@ -484,4 +569,4 @@ interface SessionTreePanelProps {
 }
 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 AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, 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 ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, 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 };
+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 AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatProps, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, 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 InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, type RetryIndicator, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, 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, useInboxUnreadCount };