@amodalai/chat-widget 0.1.0

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/events/types.d.ts

@@ -0,0 +1,72 @@
+import { ToolCallInfo, KBProposalInfo } from '../types';
+export interface EntityReference {
+    entityType: string;
+    entityId: string;
+    source: string;
+    context?: Record<string, unknown>;
+}
+export interface ToolExecutedEvent {
+    type: 'tool_executed';
+    toolName: string;
+    toolId: string;
+    parameters: Record<string, unknown>;
+    status: 'success' | 'error';
+    result?: unknown;
+    duration_ms?: number;
+    error?: string;
+    timestamp: string;
+}
+export interface SkillActivatedEvent {
+    type: 'skill_activated';
+    skill: string;
+    timestamp: string;
+}
+export interface WidgetRenderedEvent {
+    type: 'widget_rendered';
+    widgetType: string;
+    data: Record<string, unknown>;
+    timestamp: string;
+}
+export interface KBProposalEvent {
+    type: 'kb_proposal';
+    proposal: KBProposalInfo;
+    timestamp: string;
+}
+export interface EntityReferencedEvent {
+    type: 'entity_referenced';
+    entity: EntityReference;
+    sourceEvent: WidgetEvent;
+    timestamp: string;
+}
+export interface EntityHoveredEvent {
+    type: 'entity_hovered';
+    entity: EntityReference;
+    timestamp: string;
+}
+export interface EntityUnhoveredEvent {
+    type: 'entity_unhovered';
+    entity: EntityReference;
+    timestamp: string;
+}
+export interface EntityClickedEvent {
+    type: 'entity_clicked';
+    entity: EntityReference;
+    timestamp: string;
+}
+export type AgentDrivenEvent = ToolExecutedEvent | SkillActivatedEvent | WidgetRenderedEvent | KBProposalEvent | EntityReferencedEvent;
+export type InteractionEvent = EntityHoveredEvent | EntityUnhoveredEvent | EntityClickedEvent;
+export type WidgetEvent = AgentDrivenEvent | InteractionEvent;
+export interface WidgetEventMap {
+    tool_executed: ToolExecutedEvent;
+    skill_activated: SkillActivatedEvent;
+    widget_rendered: WidgetRenderedEvent;
+    kb_proposal: KBProposalEvent;
+    entity_referenced: EntityReferencedEvent;
+    entity_hovered: EntityHoveredEvent;
+    entity_unhovered: EntityUnhoveredEvent;
+    entity_clicked: EntityClickedEvent;
+    '*': WidgetEvent;
+}
+export type EntityExtractor = (event: WidgetEvent) => EntityReference[];
+export type { ToolCallInfo, KBProposalInfo };
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM7D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAMD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,GACf,qBAAqB,CAAC;AAE1B,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAM9D,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,iBAAiB,CAAC;IACjC,eAAe,EAAE,mBAAmB,CAAC;IACrC,eAAe,EAAE,mBAAmB,CAAC;IACrC,WAAW,EAAE,eAAe,CAAC;IAC7B,iBAAiB,EAAE,qBAAqB,CAAC;IACzC,cAAc,EAAE,kBAAkB,CAAC;IACnC,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,cAAc,EAAE,kBAAkB,CAAC;IACnC,GAAG,EAAE,WAAW,CAAC;CAClB;AAMD,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,eAAe,EAAE,CAAC;AAGxE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/hooks/useChat.d.ts

@@ -0,0 +1,52 @@
+import { ChatState, ChatAction, ChatMessage, ToolCallInfo, KBProposalInfo, ChatUser } from '../types';
+import { WidgetEventBus } from '../events/event-bus';
+import { WidgetEvent, EntityExtractor } from '../events/types';
+export declare function chatReducer(state: ChatState, action: ChatAction): ChatState;
+export interface UseChatOptions {
+    serverUrl: string;
+    user: ChatUser;
+    /** Return a Bearer token (API key or JWT) for authenticated requests. */
+    getToken?: () => string | null | undefined;
+    onToolCall?: (call: ToolCallInfo) => void;
+    onKBProposal?: (proposal: KBProposalInfo) => void;
+    /** Callback for all widget events (agent-driven + interaction). */
+    onEvent?: (event: WidgetEvent) => void;
+    /** Custom entity extractors. If provided, replaces the default extractor. */
+    entityExtractors?: EntityExtractor[];
+    /** Session type — controls which skills, tools, KB docs load into this session. */
+    sessionType?: string;
+    /** Specific deployment ID to load instead of the active deployment. */
+    deployId?: string;
+    /** Auto-send this message when the hook mounts. Sent exactly once via ref guard. */
+    initialMessage?: string;
+    /** Load an existing session on mount (read-only history view). Takes precedence over initialMessage. */
+    resumeSessionId?: string;
+    /** Called when the SSE stream ends (agent finishes responding). */
+    onStreamEnd?: () => void;
+    /** Called when a session ID is received from the server (first stream init). */
+    onSessionCreated?: (sessionId: string) => void;
+}
+export interface UseChatReturn {
+    messages: ChatMessage[];
+    send: (text: string) => void;
+    /** Stop the current stream without clearing history. */
+    stop: () => void;
+    isStreaming: boolean;
+    activeToolCalls: ToolCallInfo[];
+    session: {
+        id: string | null;
+        role?: string;
+    };
+    error: string | null;
+    reset: () => void;
+    /** Event bus for subscribing to widget events. */
+    eventBus: WidgetEventBus;
+    /** Submit answers to a pending ask_user prompt. */
+    submitAskUserResponse: (askId: string, answers: Record<string, string>) => void;
+    /** Load a historical session for read-only viewing. */
+    loadSession: (sessionId: string) => void;
+    /** True when viewing a loaded historical session. */
+    isHistorical: boolean;
+}
+export declare function useChat(options: UseChatOptions): UseChatReturn;
+//# sourceMappingURL=useChat.d.ts.map

package/dist/hooks/useChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../src/hooks/useChat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,WAAW,EAEX,YAAY,EACZ,cAAc,EAGd,QAAQ,EACT,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAkBpE,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAsO3E;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1C,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wGAAwG;IACxG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,wDAAwD;IACxD,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,kDAAkD;IAClD,QAAQ,EAAE,cAAc,CAAC;IACzB,mDAAmD;IACnD,qBAAqB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IAChF,uDAAuD;IACvD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CA+d9D"}

package/dist/hooks/useSessionHistory.d.ts

@@ -0,0 +1,17 @@
+import { SessionHistoryItem } from '../client';
+export interface UseSessionHistoryOptions {
+    serverUrl: string;
+    getToken?: () => string | null | undefined;
+    enabled: boolean;
+}
+export interface UseSessionHistoryReturn {
+    sessions: SessionHistoryItem[];
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => void;
+    updateTags: (sessionId: string, tags: string[]) => void;
+    updateTitle: (sessionId: string, title: string) => void;
+    allTags: string[];
+}
+export declare function useSessionHistory(options: UseSessionHistoryOptions): UseSessionHistoryReturn;
+//# sourceMappingURL=useSessionHistory.d.ts.map

package/dist/hooks/useSessionHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionHistory.d.ts","sourceRoot":"","sources":["../../src/hooks/useSessionHistory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACxD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CA0E5F"}

package/dist/hooks/useWidgetEvents.d.ts

@@ -0,0 +1,17 @@
+import { WidgetEventBus } from '../events/event-bus';
+import { WidgetEventMap, WidgetEvent } from '../events/types';
+type Unsubscribe = () => void;
+export interface UseWidgetEventsReturn {
+    /** Subscribe to a specific event type. Returns unsubscribe function. */
+    on: <K extends keyof WidgetEventMap>(event: K, listener: (data: WidgetEventMap[K]) => void) => Unsubscribe;
+    /** Subscribe to all events. Returns unsubscribe function. */
+    onAny: (listener: (data: WidgetEvent) => void) => Unsubscribe;
+}
+/**
+ * React hook for subscribing to widget events with automatic cleanup on unmount.
+ * Subscriptions created via `on` / `onAny` are tracked and removed when the
+ * component unmounts.
+ */
+export declare function useWidgetEvents(eventBus: WidgetEventBus | null | undefined): UseWidgetEventsReturn;
+export {};
+//# sourceMappingURL=useWidgetEvents.d.ts.map

package/dist/hooks/useWidgetEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWidgetEvents.d.ts","sourceRoot":"","sources":["../../src/hooks/useWidgetEvents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnE,KAAK,WAAW,GAAG,MAAM,IAAI,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,EAAE,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EACjC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,KACxC,WAAW,CAAC;IACjB,6DAA6D;IAC7D,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,KAAK,WAAW,CAAC;CAC/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,qBAAqB,CAiDlG"}