@yumiai/chat-widget 0.1.2 → 0.2.0

package/dist/GraphStatsLegend-D5bPeXB_.d.ts

@@ -0,0 +1,607 @@
+import React__default from 'react';
+
+/**
+ * JETP-025: Provenance Graph Type Definitions
+ *
+ * Aligned with backend Pydantic models in jetagents/site/graph/graph_models.py.
+ * Protocol reference: doc/proposals/JETP-025/00_shared/01_protocol.md
+ */
+type NodeType = 'agent' | 'action' | 'file' | 'task' | 'reasoning';
+interface GraphNode {
+    id: string;
+    type: NodeType;
+    label: string;
+    timestamp: number;
+    metadata: Record<string, unknown>;
+}
+interface AgentNode extends GraphNode {
+    type: 'agent';
+    agent_id: string;
+    agent_instance_id: number;
+    agent_name: string;
+    level: number;
+    parent_agent_instance_id: number | null;
+    status?: 'running' | 'completed' | 'error';
+}
+interface ActionNode extends GraphNode {
+    type: 'action';
+    tool_name: string;
+    tool_call_id: string;
+    task_purpose: string;
+    agent_instance_id: number;
+    status: 'running' | 'success' | 'error';
+    duration_ms: number | null;
+}
+interface FileNode extends GraphNode {
+    type: 'file';
+    file_id: string;
+    file_name: string;
+    git_path: string;
+    operation: 'create' | 'update' | 'delete' | 'external' | 'referenced';
+    agent_instance_id: number;
+    tool_call_id: string | null;
+    task_purpose: string | null;
+}
+interface TaskNode extends GraphNode {
+    type: 'task';
+    task_id: string;
+    description: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'blocked';
+}
+interface ReasoningNode extends GraphNode {
+    type: 'reasoning';
+    agent_instance_id: number;
+    model: string;
+    content_preview: string;
+    token_count: number | null;
+    duration_ms: number | null;
+    status?: 'thinking' | 'completed';
+    turn_id?: number;
+}
+type ProvenanceNode = AgentNode | ActionNode | FileNode | TaskNode | ReasoningNode;
+type EdgeType = 'spawns' | 'executes' | 'produces' | 'modifies' | 'deletes' | 'thinks' | 'triggers' | 'informs' | 'references';
+interface GraphEdge {
+    source: string;
+    target: string;
+    type: EdgeType;
+    label?: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+interface GraphStats {
+    agent_count: number;
+    action_count: number;
+    file_count: number;
+    task_count: number;
+    reasoning_count: number;
+    max_depth: number;
+}
+interface NodeSet {
+    agents: AgentNode[];
+    actions: ActionNode[];
+    files: FileNode[];
+    tasks: TaskNode[];
+    reasonings: ReasoningNode[];
+}
+interface ProvenanceGraphSnapshot {
+    session_id: number;
+    generated_at: number;
+    node_count: number;
+    edge_count: number;
+    max_turn_id: number | null;
+    nodes: NodeSet;
+    edges: GraphEdge[];
+    stats: GraphStats;
+}
+interface GraphSSEPayload {
+    notification_type?: string;
+    agent_instance_id?: number;
+    callee_instance_id?: number;
+    caller_instance_id?: number;
+    agent_id?: string;
+    agent_name?: string;
+    level?: number;
+    tool_name?: string;
+    tool_call_id?: string;
+    task_purpose?: string;
+    tool_status?: string;
+    timestamp?: string | number;
+    ext?: Record<string, unknown>;
+    content?: unknown[];
+}
+interface GraphFilter {
+    agentInstanceIds?: number[];
+    visibleTypes?: NodeType[];
+    depth?: number;
+    taskIds?: string[];
+}
+
+interface ChatWidgetMessages {
+    'header.title': string;
+    'header.icon': string;
+    'status.connecting': string;
+    'status.running': string;
+    'status.compressing': string;
+    'status.error': string;
+    'status.idle': string;
+    'empty.waiting': string;
+    'empty.icon': string;
+    'round.separator': string;
+    'round.status.running': string;
+    'round.status.completed': string;
+    'round.status.error': string;
+    'round.noMessage': string;
+    'footer.attribution': string;
+    'selection.ask': string;
+    'viewer.loading': string;
+    'viewer.error': string;
+    'viewer.back': string;
+    'viewer.defaultTitle': string;
+    'viewer.copyFull': string;
+    'viewer.copyFullTitle': string;
+    'viewer.referenceFile': string;
+    'viewer.referenceFileTitle': string;
+    'viewer.referencePage': string;
+    'viewer.referencePageTitle': string;
+    'viewer.download': string;
+    'viewer.fullscreen': string;
+    'viewer.fullscreenExit': string;
+    'viewer.close': string;
+    'viewer.unknownType': string;
+    'viewer.iframeHint': string;
+    'viewer.copySnippet': string;
+    'viewer.loadingPdf': string;
+    'viewer.pdfPages': string;
+    'viewer.loadingKicad': string;
+    'viewer.loading3d': string;
+    'viewer.loadingStep': string;
+    'viewer.3d.wireframe': string;
+    'viewer.3d.resetView': string;
+    'viewer.gerberTitle': string;
+    'viewer.gerberBlobWarning': string;
+    'viewer.gerberNoHttpUrl': string;
+    'viewer.pdfPreview': string;
+    'viewer.htmlPreview': string;
+    'viewer.htmlProjectLoading': string;
+    'viewer.htmlProjectNoEntry': string;
+    'viewer.htmlProjectSizeLimit': string;
+    'viewer.htmlStrategyForcedInlineWarning': string;
+    'viewer.htmlStrategyFallbackCspWarning': string;
+    'viewer.copyFullKicadTitle': string;
+    'viewer.zoomIn': string;
+    'viewer.zoomOut': string;
+    'viewer.zoomReset': string;
+    'viewer.loadingWord': string;
+    'viewer.loadingExcel': string;
+    'viewer.loadingPowerPoint': string;
+    'viewer.pptPrev': string;
+    'viewer.pptNext': string;
+    'viewer.pptSlide': string;
+    'viewer.pptThumbnails': string;
+    'viewer.excelRows': string;
+    'viewer.excelColumns': string;
+    'childAgent.status.running': string;
+    'childAgent.status.completed': string;
+    'hitl.form.defaultTitle': string;
+    'hitl.wait.default': string;
+    'todo.completed.count': string;
+    'todo.blocked.count': string;
+    'todo.more': string;
+    'todo.header.done': string;
+    'tool.phase.generating': string;
+    'tool.phase.executing': string;
+    'tool.phase.complete': string;
+    'tool.phase.error': string;
+    'tool.executing': string;
+    'tool.mcp.running': string;
+    'tool.mcp.success': string;
+    'tool.mcp.error': string;
+    'form.placeholder.select': string;
+    'form.required.default': string;
+    'form.submit.submit': string;
+    'form.submit.submitting': string;
+    'form.requestId': string;
+    'pinned.label': string;
+    'plan.title': string;
+    'plan.step': string;
+    'thinking.inProgress': string;
+    'thinking.completed': string;
+    'split.unreadCount': string;
+    'split.askQuestion': string;
+    'split.exitFullscreen': string;
+    'context.inputPlaceholder': string;
+    'context.inputPlaceholderWithFile': string;
+    'context.send': string;
+    'context.removeReference': string;
+    'split.home': string;
+    'split.workspace': string;
+    'split.annotation': string;
+    'split.tabClose': string;
+    'split.tabNew': string;
+    'workspace.title': string;
+    'workspace.searchPlaceholder': string;
+    'workspace.empty': string;
+    'workspace.downloadAll': string;
+    'workspace.recent': string;
+    'workspace.open': string;
+    'workspace.openInNewTab': string;
+    'workspace.download': string;
+    'workspace.copyPath': string;
+    'workspace.expandAll': string;
+    'workspace.collapseAll': string;
+    'annotation.title': string;
+    'annotation.empty': string;
+    'annotation.fileLevelTitle': string;
+    'annotation.fileLevelPlaceholder': string;
+    'annotation.anchoredPlaceholder': string;
+    'annotation.inlineInputPlaceholder': string;
+    'annotation.replyPlaceholder': string;
+    'annotation.anchorLabel': string;
+    'annotation.close': string;
+    'annotation.fabLabel': string;
+    'annotation.fabHeader': string;
+    'annotation.messageCount': string;
+    'annotation.anchorInvalid': string;
+    'annotation.errorRetry': string;
+    'annotation.queuedHint': string;
+    'annotation.selectionLabel': string;
+    'agentControl.pause': string;
+    'agentControl.resume': string;
+    'agentControl.stop': string;
+    'agentControl.paused': string;
+    'agentControl.groupTitle': string;
+    'aria.fileNavigation': string;
+    'kicad.loadFailed': string;
+    'kicad.urlNotReady': string;
+    'kicad.loadingEngine': string;
+    'kicad.sidebarTitle': string;
+    'kicad.sidebarPcb': string;
+    'kicad.sidebarSch': string;
+    'kicad.sidebarGeneric': string;
+    'kicad.viewVisual': string;
+    'kicad.viewSource': string;
+    'provenance.filter.type.agent': string;
+    'provenance.filter.type.action': string;
+    'provenance.filter.type.file': string;
+    'provenance.filter.type.task': string;
+    'provenance.filter.type.reasoning': string;
+    'provenance.filter.depth': string;
+    'provenance.toolbar.zoomToFit': string;
+    'provenance.toolbar.resetCamera': string;
+    'provenance.toolbar.refresh': string;
+    'provenance.legend.reasoning': string;
+    'provenance.legend.action': string;
+    'provenance.legend.file': string;
+    'provenance.legend.task': string;
+    'provenance.legend.references': string;
+    'provenance.legend.edges': string;
+    'provenance.legend.depth': string;
+    'provenance.detail.title': string;
+    'provenance.detail.noSelection': string;
+    'provenance.detail.label.name': string;
+    'provenance.detail.label.id': string;
+    'provenance.detail.label.timestamp': string;
+    'provenance.detail.label.agentId': string;
+    'provenance.detail.label.instanceId': string;
+    'provenance.detail.label.level': string;
+    'provenance.detail.label.status': string;
+    'provenance.detail.label.tool': string;
+    'provenance.detail.label.purpose': string;
+    'provenance.detail.label.duration': string;
+    'provenance.detail.label.path': string;
+    'provenance.detail.label.operation': string;
+    'provenance.detail.label.taskId': string;
+    'provenance.detail.label.description': string;
+    'provenance.detail.label.model': string;
+    'provenance.detail.label.tokenCount': string;
+    'provenance.detail.label.reasoningPreview': string;
+    'provenance.detail.relatedEdges': string;
+    'provenance.page.noSessionHint': string;
+    'provenance.page.loading': string;
+    'provenance.page.emptyGraph': string;
+    'provenance.drawer.emptyGraph': string;
+    'provenance.graph.edgeType.references': string;
+    'toolResult.label': string;
+    'toolResult.expandAll': string;
+    'toolResult.searchSummary': string;
+    'toolResult.scrapeSummary': string;
+    'toolResult.more': string;
+    'plan.status.active': string;
+    'pinned.noMessage': string;
+    'viewer.fallback.unknownType': string;
+    'viewer.fallback.download': string;
+    'fileSize.B': string;
+    'fileSize.KB': string;
+    'fileSize.MB': string;
+    'thinking.title': string;
+    'thinking.step': string;
+    'viewer.stepHint': string;
+    'viewer.threeHint': string;
+    'reference.header': string;
+    'history.noMessage': string;
+    'agent.defaultName': string;
+    'error.unknown': string;
+    'locale': string;
+    'skill.inlineLabel': string;
+    'skill.empty': string;
+    'skill.searchPlaceholder': string;
+    'skill.removeLabel': string;
+    'skill.loading': string;
+    'skill.loadError': string;
+    'skill.loadMore': string;
+    'skill.selectorLabel': string;
+    'pool.idle': string;
+    'pool.collaborating': string;
+    /** JETP-083 WS3.7.7 follow-up: badge text when at least one agent is
+     * paused on a HIL response (no RUNNING agents). ``{{count}}`` = number
+     * of paused agents. */
+    'pool.awaiting': string;
+    'pool.title': string;
+    'pool.empty': string;
+    'pool.state.running': string;
+    /** JETP-083 WS3.7.7 follow-up: agent-row state label for an agent that
+     * is blocked inside ``_await_genui_blocking`` waiting on a human HIL
+     * reply. Distinguishes from ``running`` / ``completed`` / ``lost``;
+     * mapped from backend ``state="PAUSED"``. */
+    'pool.state.paused': string;
+    'pool.state.completed': string;
+    'pool.state.lost': string;
+    'pool.state.unknown': string;
+    'input.placeholder': string;
+    'input.placeholderLoading': string;
+    'discussion.title': string;
+    'discussion.empty': string;
+    'discussion.active': string;
+    'discussion.resolved': string;
+    'discussion.archived': string;
+    'round.foreign.label': string;
+    'round.foreign.unread': string;
+    'round.foreign.expand': string;
+    'sidebar.mainChat': string;
+    'sidebar.chat': string;
+    'sidebar.fileQA': string;
+    'sidebar.selectionQA': string;
+    'sessionList.title': string;
+    'sessionList.newSession': string;
+    'sessionList.logout': string;
+    'sessionList.loading': string;
+    'sessionList.empty': string;
+    'sessionList.unsupported': string;
+    'sessionList.untitled': string;
+    'sessionList.deleteTitle': string;
+    'sessionList.deleteConfirm': string;
+    'sessionList.prevPage': string;
+    'sessionList.nextPage': string;
+    'sessionList.pageInfo': string;
+    'modelPicker.menu.head': string;
+    'modelPicker.menu.aria': string;
+    'modelPicker.auto.title': string;
+    'modelPicker.auto.hint.knownChannel': string;
+    'modelPicker.auto.hint.knownBasename': string;
+    'modelPicker.auto.hint.fallback': string;
+    'modelPicker.row.hint.channelMulti': string;
+    'modelPicker.row.hint.channelSingle': string;
+    'modelPicker.row.hint.versionMulti': string;
+    'modelPicker.fallback.placeholder': string;
+    'modelPicker.inert.title': string;
+    'modelPicker.guestLocked.label': string;
+    'modelPicker.guestLocked.title': string;
+    'modelPicker.loadingList': string;
+    'modelPicker.trigger.title.stale': string;
+    'modelPicker.trigger.title.agentDefault.withChannel': string;
+    'modelPicker.trigger.title.agentDefault': string;
+    'modelPicker.trigger.title.current': string;
+    'modelPicker.row.title.pickDefault': string;
+    'modelPicker.row.title.pick': string;
+    'modelPicker.chip.aria': string;
+    'modelPicker.chip.title.available': string;
+    'modelPicker.chip.title.unavailable': string;
+    'jr.confirmDialog.cancel': string;
+    'jr.confirmDialog.confirm': string;
+    'jr.confirmDialog.loading': string;
+}
+type ChatWidgetLocale = 'zh-CN' | 'en-US';
+declare function resolveMessages(locale?: ChatWidgetLocale, overrides?: Partial<ChatWidgetMessages>): ChatWidgetMessages;
+
+/**
+ * JETP-025: ProvenanceGraphDrawerContent
+ *
+ * Lightweight wrapper for embedding the provenance graph inside an antd Drawer.
+ * Reuses ProvenanceGraph3D + GraphStatsLegend + NodeDetailPanel.
+ *
+ * Supports real-time SSE updates via onProcessEventRef callback.
+ */
+
+interface ProvenanceGraphDrawerContentProps {
+    sessionId: number;
+    onProcessEventRef?: React__default.MutableRefObject<((p: GraphSSEPayload) => void) | null>;
+}
+declare const ProvenanceGraphDrawerContent: React__default.FC<ProvenanceGraphDrawerContentProps>;
+
+/**
+ * Provenance Graph API Client (SDK version)
+ *
+ * Delegates HTTP to the caller-supplied fetch function, decoupling from
+ * any specific Axios instance or auth mechanism.
+ */
+
+interface FetchGraphOptions {
+    sessionId: number;
+    sinceTurnId?: number | null;
+    limit?: number;
+}
+type ProvenanceGraphFetcher = (sessionId: number, params?: {
+    since_turn_id?: number;
+    limit?: number;
+}) => Promise<ProvenanceGraphSnapshot>;
+declare function fetchProvenanceGraph(fetcher: ProvenanceGraphFetcher, opts: FetchGraphOptions): Promise<ProvenanceGraphSnapshot>;
+
+/**
+ * JETP-025: useProvenanceGraph Hook
+ *
+ * Manages the provenance graph lifecycle:
+ *   1. Fetches initial snapshot via REST
+ *   2. Accepts SSE events from parent to incrementally update
+ *   3. Handles reconnection by fetching delta via since_turn_id
+ *   4. Debounces re-renders for burst SSE events
+ */
+
+interface UseProvenanceGraphOptions {
+    sessionId: number | null;
+    /** Adapter-supplied fetcher; when absent, fetch is disabled */
+    fetcher?: ProvenanceGraphFetcher;
+    enabled?: boolean;
+    /** Auto-poll interval in ms. 0 disables. Default 3000. */
+    pollInterval?: number;
+}
+interface UseProvenanceGraphReturn {
+    graph: ProvenanceGraphSnapshot | null;
+    loading: boolean;
+    error: Error | null;
+    processEvent: (payload: GraphSSEPayload) => void;
+    refetch: () => void;
+}
+declare function useProvenanceGraph(opts: UseProvenanceGraphOptions): UseProvenanceGraphReturn;
+
+/**
+ * JETP-025: Client-side GraphBuilder
+ *
+ * Incrementally builds a provenance graph from SSE events.
+ * Maintains Maps for O(1) node lookup and deduplication.
+ *
+ * Handlers: agent_start, agent_end, mcp_start, mcp_end,
+ *           artifact_result, plan_result, model_start, model_result, model_end
+ */
+
+declare class GraphBuilder {
+    private sessionId;
+    private agents;
+    private actions;
+    private files;
+    private tasks;
+    private reasonings;
+    private edges;
+    private edgeKeys;
+    private lastCompletedActions;
+    private readonly handlers;
+    /** Apply an SSE event. Returns true if the event was handled. */
+    applyEvent(payload: GraphSSEPayload): boolean;
+    /** Replace all state from a backend snapshot (initial load). */
+    replaceWithSnapshot(snapshot: ProvenanceGraphSnapshot): void;
+    /** Merge an incremental snapshot (reconnection). */
+    mergeSnapshot(snapshot: ProvenanceGraphSnapshot): void;
+    /** Produce an immutable snapshot for React state. */
+    getSnapshot(): ProvenanceGraphSnapshot;
+    private handleAgentStart;
+    private handleAgentEnd;
+    private handleMcpStart;
+    private handleMcpEnd;
+    private handleArtifactResult;
+    /** JETP-026: create references edges from xref scan result. */
+    private handleXrefScanResult;
+    private handlePlanResult;
+    private handleModelStart;
+    private handleModelResult;
+    private handleModelEnd;
+    private addEdge;
+    private edgeKey;
+    findLatestReasoning(agentInstanceId: number): ReasoningNode | null;
+    private parseTimestamp;
+    private extractString;
+    private extractNumber;
+    private extractArtifactData;
+    private normalizeOperation;
+    /** Merge placeholder file nodes into a real node, remapping all edges.
+     *  Uses exact + stem matching (same ambiguity-safe logic as resolveFileByName). */
+    private absorbPlaceholders;
+    /** Match a file name/path against existing FileNodes by git_path or file_name.
+     *  Pass 1 — exact match.  Pass 2 — stem match (extension stripped) when
+     *  *name* has no extension and exactly one non-placeholder candidate exists. */
+    private resolveFileByName;
+    /** Strip trailing extension: 'arch.md' → 'arch', 'a/b.txt' → 'a/b'. */
+    private static fileStem;
+    /** True when the trailing path component carries a dot-extension (ignores dotfiles). */
+    private static nameHasExtension;
+    private simpleHash;
+    private extractChecklist;
+}
+
+/**
+ * JETP-025: ProvenanceGraph3D
+ *
+ * Core 3D graph visualization using react-force-graph-3d (Three.js).
+ * Renders agent/action/file/task/reasoning nodes as distinct 3D shapes
+ * with animated edges, selection dimming, and camera focus.
+ */
+
+interface ProvenanceGraph3DProps {
+    graph: ProvenanceGraphSnapshot;
+    width?: number;
+    height?: number;
+    selectedNodeId?: string | null;
+    onNodeClick?: (nodeId: string, nodeType: NodeType) => void;
+    onNodeHover?: (nodeId: string | null) => void;
+    onBackgroundClick?: () => void;
+    depthFilter?: number;
+}
+declare const ProvenanceGraph3D: React__default.NamedExoticComponent<ProvenanceGraph3DProps>;
+
+/**
+ * JETP-025: NodeDetailPanel
+ *
+ * Drawer panel showing detailed information about a selected graph node.
+ * Uses antd Drawer + Descriptions for consistent JetForge styling.
+ */
+
+interface NodeDetailPanelProps {
+    open: boolean;
+    nodeId: string | null;
+    graph: ProvenanceGraphSnapshot;
+    onClose: () => void;
+}
+declare const NodeDetailPanel: React__default.NamedExoticComponent<NodeDetailPanelProps>;
+
+/**
+ * JETP-025: FilterBar
+ *
+ * Provides controls for filtering the provenance graph:
+ *   - Node type toggle (multi-select)
+ *   - Depth filter (N-hop from selected node)
+ */
+
+interface FilterBarProps {
+    visibleTypes: Set<NodeType>;
+    onVisibleTypesChange: (types: Set<NodeType>) => void;
+    depth: number;
+    onDepthChange: (depth: number) => void;
+    hasSelection: boolean;
+}
+declare const FilterBar: React__default.NamedExoticComponent<FilterBarProps>;
+
+/**
+ * JETP-025: GraphToolbar
+ *
+ * Floating toolbar with zoom-to-fit, reset camera, and refresh controls.
+ */
+
+interface GraphToolbarProps {
+    onZoomToFit: () => void;
+    onResetCamera: () => void;
+    onRefresh: () => void;
+    loading?: boolean;
+}
+declare const GraphToolbar: React__default.NamedExoticComponent<GraphToolbarProps>;
+
+/**
+ * JETP-025: GraphStatsLegend
+ *
+ * Floating legend showing node counts by type and edge total.
+ */
+
+interface GraphStatsLegendProps {
+    stats: GraphStats;
+    edgeCount: number;
+}
+declare const GraphStatsLegend: React__default.NamedExoticComponent<GraphStatsLegendProps>;
+
+export { type ChatWidgetLocale as C, type EdgeType as E, type FetchGraphOptions as F, GraphBuilder as G, NodeDetailPanel as N, ProvenanceGraph3D as P, type ChatWidgetMessages as a, FilterBar as b, type GraphEdge as c, type GraphFilter as d, type GraphSSEPayload as e, GraphStatsLegend as f, GraphToolbar as g, type NodeType as h, ProvenanceGraphDrawerContent as i, type ProvenanceGraphFetcher as j, type ProvenanceGraphSnapshot as k, type ProvenanceNode as l, fetchProvenanceGraph as m, resolveMessages as r, useProvenanceGraph as u };

package/dist/JsonRenderStandalone-EIZM62JU.js

@@ -0,0 +1,18 @@
+import {
+  JsonRenderStandalone
+} from "./chunk-CFKGNAJM.js";
+import "./chunk-2UC7YLVX.js";
+import "./chunk-GYXTSY22.js";
+import "./chunk-K4KGNVL5.js";
+import "./chunk-56WRZM3R.js";
+import "./chunk-PZXSASDY.js";
+import "./chunk-VXJWGLZ7.js";
+import "./chunk-2SKA3F5U.js";
+import "./chunk-GAMA3VA7.js";
+import "./chunk-7S67DOHQ.js";
+import "./chunk-QLVPIM6R.js";
+import "./chunk-7D4SUZUM.js";
+export {
+  JsonRenderStandalone
+};
+//# sourceMappingURL=JsonRenderStandalone-EIZM62JU.js.map

package/dist/JsonRenderStandalone-EIZM62JU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}