@invergent/agent-chat-react 1.8.1 → 1.9.0

package/dist/index.d.cts

@@ -172,6 +172,57 @@ interface AgentChatScheduledWorkList {
     items: AgentChatScheduledWorkItem[];
     total: number;
 }
+type AgentChatMissionStatus = "active" | "paused" | "satisfied" | "blocked" | "failed" | "cancelled" | "max_iterations_reached" | (string & {});
+interface AgentChatMissionSummary {
+    id: string;
+    orgId: string;
+    userId: string;
+    sessionId: string;
+    agentId: string;
+    description: string;
+    rubric: string;
+    status: AgentChatMissionStatus;
+    iteration: number;
+    maxIterations: number;
+    lastEvaluationResult: string | null;
+    lastEvaluationExplanation: string | null;
+    lastEvaluationFeedback: string | null;
+    lastEvaluationAt: string | null;
+    evaluatorParseFailures: number;
+    pausedReason: string | null;
+    cancelledReason: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AgentChatMissionTask {
+    id: string;
+    goal: string;
+    status: string;
+    attemptCount: number;
+    maxAttempts: number;
+    agentDefName: string | null;
+    result: string | null;
+    resultMetadata: Record<string, unknown> | null;
+    parentIds: string[];
+    currentSessionId: string | null;
+    createdAt: string | null;
+    completedAt: string | null;
+}
+interface AgentChatMissionWorker {
+    taskId: string;
+    workerSessionId: string;
+    agentDefName: string | null;
+    taskStatus: string;
+    sessionStatus: string;
+    latestEventId: number | null;
+    latestEventKind: string | null;
+    latestEventAt: string | null;
+    latestEventSummary: string | null;
+    transcriptUrl: string;
+}
+interface AgentChatMissionList {
+    missions: AgentChatMissionSummary[];
+}
 type AgentChatInboxKind = "input_required" | "action_required" | "task_complete" | "governance_gate" | "progress_checkin" | (string & {});
 type AgentChatInboxStatus = "pending" | "acknowledged" | "responded" | "expired" | (string & {});
 interface AgentChatInboxItem {
@@ -416,6 +467,35 @@ interface AgentChatAdapter {
     cancelScheduledWork?(input: {
         scheduleId: string;
     }): Promise<void>;
+    listMissions?(input?: {
+        status?: string;
+        agentId?: string;
+    }): Promise<AgentChatMissionList>;
+    getMission?(input: {
+        missionId: string;
+    }): Promise<AgentChatMissionSummary>;
+    getMissionTasks?(input: {
+        missionId: string;
+    }): Promise<{
+        tasks: AgentChatMissionTask[];
+    }>;
+    getMissionWorkers?(input: {
+        missionId: string;
+    }): Promise<{
+        workers: AgentChatMissionWorker[];
+    }>;
+    pauseMission?(input: {
+        missionId: string;
+        reason?: string;
+    }): Promise<void>;
+    resumeMission?(input: {
+        missionId: string;
+    }): Promise<void>;
+    cancelMission?(input: {
+        missionId: string;
+        reason?: string;
+        cascadeToWorkers?: boolean;
+    }): Promise<void>;
     listInbox?(input?: AgentChatInboxListInput): Promise<AgentChatInboxList>;
     getInboxItem?(input: {
         itemId: number;
@@ -602,6 +682,52 @@ interface InboxUnreadCountState {
 }
 declare function useInboxUnreadCount(adapter: AgentChatAdapter): InboxUnreadCountState;
 
+interface MissionDashboardProps {
+    adapter: AgentChatAdapter;
+    missionId: string;
+    /** Override the 5s default while testing or in lower-traffic embeddings. */
+    pollIntervalMs?: number;
+    /** Optional click handler for the "Back" button shown on terminal missions. */
+    onNavigateBack?: () => void;
+    /** Optional click handler for a worker row's transcript link.
+     * When unset, the dashboard renders the raw URL the server provided as
+     * an `<a target="_blank">` link — appropriate for hosts that haven't
+     * registered an in-app session view. */
+    onOpenTranscript?: (workerSessionId: string) => void;
+}
+declare function MissionDashboard({ adapter, missionId, pollIntervalMs, onNavigateBack, onOpenTranscript, }: MissionDashboardProps): react_jsx_runtime.JSX.Element;
+
+interface MissionsPanelProps {
+    adapter: AgentChatAdapter;
+    agentId?: string;
+    title?: string;
+    /** Comma-separated status filter passed to ``listMissions``. */
+    status?: string;
+    hideHeader?: boolean;
+    pollIntervalMs?: number;
+    onMissionSelect?: (missionId: string) => void;
+    onMissionPause?: (missionId: string) => void;
+    onMissionResume?: (missionId: string) => void;
+    onMissionCancel?: (missionId: string) => void;
+}
+declare function MissionsPanel({ adapter, agentId, title, status, hideHeader, pollIntervalMs, onMissionSelect, onMissionPause, onMissionResume, onMissionCancel, }: MissionsPanelProps): react_jsx_runtime.JSX.Element | null;
+
+/** Mission statuses that are still actively producing events. */
+declare const ACTIVE_MISSION_STATUSES: ReadonlySet<AgentChatMissionStatus>;
+/** Mission statuses past which no further work happens. */
+declare function isTerminalMissionStatus(status: AgentChatMissionStatus): boolean;
+/** Bucket label for grouping tasks in the dashboard. */
+type MissionTaskBucket = "in_flight" | "done" | "blocked" | "failed_or_cancelled";
+declare function missionTaskBucket(status: string): MissionTaskBucket;
+declare function groupMissionTasksByBucket(tasks: AgentChatMissionTask[]): Record<MissionTaskBucket, AgentChatMissionTask[]>;
+/**
+ * Derive a human-friendly activity label for a worker row. The server
+ * exposes raw event metadata; the client picks the most informative
+ * signal in this order: a recent tool.call summary, a recent
+ * llm.response, else the worker's session status.
+ */
+declare function deriveMissionWorkerActivityLabel(worker: AgentChatMissionWorker): string;
+
 interface ScheduledWorkPanelProps {
     adapter: AgentChatAdapter;
     agentId?: string;
@@ -638,4 +764,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 AgentChatAttachment, type AgentChatChartArtifactSpec, type AgentChatClarifyAnswer, type AgentChatClarifyArgs, type AgentChatClarifyChoice, type AgentChatClarifyQuestion, type AgentChatDisplayAttachment, 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 AgentChatPendingAttachment, 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 ChatComposerError, 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 };
+export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAttachment, type AgentChatChartArtifactSpec, type AgentChatClarifyAnswer, type AgentChatClarifyArgs, type AgentChatClarifyChoice, type AgentChatClarifyQuestion, type AgentChatDisplayAttachment, 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 AgentChatMissionList, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, 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 ChatComposerError, 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, MissionDashboard, type MissionDashboardProps, type MissionTaskBucket, MissionsPanel, type MissionsPanelProps, 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, deriveMissionWorkerActivityLabel, groupMissionTasksByBucket, isTerminalMissionStatus, missionTaskBucket, useAgentChatAdapterContext, useAgentChatRuntime, useInboxUnreadCount };

package/dist/index.d.ts

@@ -172,6 +172,57 @@ interface AgentChatScheduledWorkList {
     items: AgentChatScheduledWorkItem[];
     total: number;
 }
+type AgentChatMissionStatus = "active" | "paused" | "satisfied" | "blocked" | "failed" | "cancelled" | "max_iterations_reached" | (string & {});
+interface AgentChatMissionSummary {
+    id: string;
+    orgId: string;
+    userId: string;
+    sessionId: string;
+    agentId: string;
+    description: string;
+    rubric: string;
+    status: AgentChatMissionStatus;
+    iteration: number;
+    maxIterations: number;
+    lastEvaluationResult: string | null;
+    lastEvaluationExplanation: string | null;
+    lastEvaluationFeedback: string | null;
+    lastEvaluationAt: string | null;
+    evaluatorParseFailures: number;
+    pausedReason: string | null;
+    cancelledReason: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AgentChatMissionTask {
+    id: string;
+    goal: string;
+    status: string;
+    attemptCount: number;
+    maxAttempts: number;
+    agentDefName: string | null;
+    result: string | null;
+    resultMetadata: Record<string, unknown> | null;
+    parentIds: string[];
+    currentSessionId: string | null;
+    createdAt: string | null;
+    completedAt: string | null;
+}
+interface AgentChatMissionWorker {
+    taskId: string;
+    workerSessionId: string;
+    agentDefName: string | null;
+    taskStatus: string;
+    sessionStatus: string;
+    latestEventId: number | null;
+    latestEventKind: string | null;
+    latestEventAt: string | null;
+    latestEventSummary: string | null;
+    transcriptUrl: string;
+}
+interface AgentChatMissionList {
+    missions: AgentChatMissionSummary[];
+}
 type AgentChatInboxKind = "input_required" | "action_required" | "task_complete" | "governance_gate" | "progress_checkin" | (string & {});
 type AgentChatInboxStatus = "pending" | "acknowledged" | "responded" | "expired" | (string & {});
 interface AgentChatInboxItem {
@@ -416,6 +467,35 @@ interface AgentChatAdapter {
     cancelScheduledWork?(input: {
         scheduleId: string;
     }): Promise<void>;
+    listMissions?(input?: {
+        status?: string;
+        agentId?: string;
+    }): Promise<AgentChatMissionList>;
+    getMission?(input: {
+        missionId: string;
+    }): Promise<AgentChatMissionSummary>;
+    getMissionTasks?(input: {
+        missionId: string;
+    }): Promise<{
+        tasks: AgentChatMissionTask[];
+    }>;
+    getMissionWorkers?(input: {
+        missionId: string;
+    }): Promise<{
+        workers: AgentChatMissionWorker[];
+    }>;
+    pauseMission?(input: {
+        missionId: string;
+        reason?: string;
+    }): Promise<void>;
+    resumeMission?(input: {
+        missionId: string;
+    }): Promise<void>;
+    cancelMission?(input: {
+        missionId: string;
+        reason?: string;
+        cascadeToWorkers?: boolean;
+    }): Promise<void>;
     listInbox?(input?: AgentChatInboxListInput): Promise<AgentChatInboxList>;
     getInboxItem?(input: {
         itemId: number;
@@ -602,6 +682,52 @@ interface InboxUnreadCountState {
 }
 declare function useInboxUnreadCount(adapter: AgentChatAdapter): InboxUnreadCountState;
 
+interface MissionDashboardProps {
+    adapter: AgentChatAdapter;
+    missionId: string;
+    /** Override the 5s default while testing or in lower-traffic embeddings. */
+    pollIntervalMs?: number;
+    /** Optional click handler for the "Back" button shown on terminal missions. */
+    onNavigateBack?: () => void;
+    /** Optional click handler for a worker row's transcript link.
+     * When unset, the dashboard renders the raw URL the server provided as
+     * an `<a target="_blank">` link — appropriate for hosts that haven't
+     * registered an in-app session view. */
+    onOpenTranscript?: (workerSessionId: string) => void;
+}
+declare function MissionDashboard({ adapter, missionId, pollIntervalMs, onNavigateBack, onOpenTranscript, }: MissionDashboardProps): react_jsx_runtime.JSX.Element;
+
+interface MissionsPanelProps {
+    adapter: AgentChatAdapter;
+    agentId?: string;
+    title?: string;
+    /** Comma-separated status filter passed to ``listMissions``. */
+    status?: string;
+    hideHeader?: boolean;
+    pollIntervalMs?: number;
+    onMissionSelect?: (missionId: string) => void;
+    onMissionPause?: (missionId: string) => void;
+    onMissionResume?: (missionId: string) => void;
+    onMissionCancel?: (missionId: string) => void;
+}
+declare function MissionsPanel({ adapter, agentId, title, status, hideHeader, pollIntervalMs, onMissionSelect, onMissionPause, onMissionResume, onMissionCancel, }: MissionsPanelProps): react_jsx_runtime.JSX.Element | null;
+
+/** Mission statuses that are still actively producing events. */
+declare const ACTIVE_MISSION_STATUSES: ReadonlySet<AgentChatMissionStatus>;
+/** Mission statuses past which no further work happens. */
+declare function isTerminalMissionStatus(status: AgentChatMissionStatus): boolean;
+/** Bucket label for grouping tasks in the dashboard. */
+type MissionTaskBucket = "in_flight" | "done" | "blocked" | "failed_or_cancelled";
+declare function missionTaskBucket(status: string): MissionTaskBucket;
+declare function groupMissionTasksByBucket(tasks: AgentChatMissionTask[]): Record<MissionTaskBucket, AgentChatMissionTask[]>;
+/**
+ * Derive a human-friendly activity label for a worker row. The server
+ * exposes raw event metadata; the client picks the most informative
+ * signal in this order: a recent tool.call summary, a recent
+ * llm.response, else the worker's session status.
+ */
+declare function deriveMissionWorkerActivityLabel(worker: AgentChatMissionWorker): string;
+
 interface ScheduledWorkPanelProps {
     adapter: AgentChatAdapter;
     agentId?: string;
@@ -638,4 +764,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 AgentChatAttachment, type AgentChatChartArtifactSpec, type AgentChatClarifyAnswer, type AgentChatClarifyArgs, type AgentChatClarifyChoice, type AgentChatClarifyQuestion, type AgentChatDisplayAttachment, 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 AgentChatPendingAttachment, 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 ChatComposerError, 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 };
+export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAttachment, type AgentChatChartArtifactSpec, type AgentChatClarifyAnswer, type AgentChatClarifyArgs, type AgentChatClarifyChoice, type AgentChatClarifyQuestion, type AgentChatDisplayAttachment, 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 AgentChatMissionList, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, 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 ChatComposerError, 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, MissionDashboard, type MissionDashboardProps, type MissionTaskBucket, MissionsPanel, type MissionsPanelProps, 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, deriveMissionWorkerActivityLabel, groupMissionTasksByBucket, isTerminalMissionStatus, missionTaskBucket, useAgentChatAdapterContext, useAgentChatRuntime, useInboxUnreadCount };