@yushaw/sanqian-chat 0.1.1

package/dist/core/index.d.mts

@@ -0,0 +1,156 @@
+import { HitlInterruptPayload, HitlResponse, SanqianSDK } from '@yushaw/sanqian-sdk';
+export { ChatStreamEvent, HitlInterruptPayload, HitlInterruptType, HitlResponse, HitlRiskLevel, ChatMessage as SdkChatMessage, ConversationDetail as SdkConversationDetail, ConversationInfo as SdkConversationInfo, ToolCall as SdkToolCall } from '@yushaw/sanqian-sdk';
+
+/**
+ * @yushaw/sanqian-chat Core Types
+ *
+ * Re-exports SDK types + chat-specific types
+ */
+
+type MessageRole = 'user' | 'assistant' | 'system';
+type ToolCallStatus = 'pending' | 'running' | 'completed' | 'error' | 'cancelled';
+type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'error';
+type ConnectionErrorCode = 'NOT_FOUND' | 'CONNECTION_FAILED' | 'WEBSOCKET_ERROR' | 'AUTH_ERROR' | 'TIMEOUT' | 'UNKNOWN';
+/** Tool call for UI rendering (extended from SDK) */
+interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    status: ToolCallStatus;
+    result?: unknown;
+    error?: string;
+}
+/** Message block for structured rendering */
+interface MessageBlock {
+    type: 'thinking' | 'text' | 'tool_call' | 'tool_result';
+    content: string;
+    timestamp: number;
+    toolName?: string;
+    toolArgs?: Record<string, unknown>;
+    toolCallId?: string;
+    toolStatus?: ToolCallStatus;
+    isIntermediate?: boolean;
+}
+/** Chat message for UI rendering */
+interface ChatMessage {
+    id: string;
+    role: MessageRole;
+    content: string;
+    timestamp: string;
+    isStreaming?: boolean;
+    toolCalls?: ToolCall[];
+    thinking?: string;
+    currentThinking?: string;
+    isThinkingStreaming?: boolean;
+    blocks?: MessageBlock[];
+    isComplete?: boolean;
+}
+/** Conversation info for UI */
+interface ConversationInfo {
+    id: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    messageCount: number;
+}
+interface ConversationDetail extends ConversationInfo {
+    messages: ChatMessage[];
+}
+/** HITL interrupt data for UI (alias for HitlInterruptPayload) */
+type HitlInterruptData = HitlInterruptPayload;
+type WindowPosition = 'center' | 'cursor' | 'remember' | {
+    x: number;
+    y: number;
+};
+interface FloatingWindowConfig {
+    shortcut?: string;
+    position?: WindowPosition;
+    width?: number;
+    height?: number;
+    alwaysOnTop?: boolean;
+    showInTaskbar?: boolean;
+    theme?: 'light' | 'dark' | 'system';
+}
+
+/**
+ * Chat Adapter Interface
+ *
+ * Abstracts the connection to Sanqian backend.
+ * Default implementation uses @yushaw/sanqian-sdk directly.
+ */
+
+/** Stream event callback */
+type StreamEvent = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'thinking';
+    content: string;
+} | {
+    type: 'tool_call';
+    tool_call: {
+        id: string;
+        function: {
+            name: string;
+            arguments: string;
+        };
+    };
+} | {
+    type: 'tool_result';
+    tool_call_id: string;
+    result: unknown;
+} | {
+    type: 'done';
+    conversationId: string;
+    title?: string;
+} | {
+    type: 'error';
+    error: string;
+} | {
+    type: 'interrupt';
+    interrupt_type: string;
+    interrupt_payload: HitlInterruptData;
+    run_id?: string;
+};
+/** Message to send */
+interface SendMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/** Chat adapter interface */
+interface ChatAdapter {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getConnectionStatus(): ConnectionStatus;
+    onConnectionChange(callback: (status: ConnectionStatus, error?: string, errorCode?: ConnectionErrorCode) => void): () => void;
+    listConversations(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        conversations: ConversationInfo[];
+        total: number;
+    }>;
+    getConversation(id: string, options?: {
+        messageLimit?: number;
+    }): Promise<ConversationDetail>;
+    deleteConversation(id: string): Promise<void>;
+    chatStream(messages: SendMessage[], conversationId: string | undefined, onEvent: (event: StreamEvent) => void): Promise<{
+        cancel: () => void;
+    }>;
+    sendHitlResponse?(response: HitlResponse, runId?: string): void;
+    cleanup?(): void;
+}
+/** SDK adapter config */
+interface SdkAdapterConfig {
+    /** SDK instance getter */
+    getSdk: () => SanqianSDK | null;
+    /** Agent ID getter */
+    getAgentId: () => string | null;
+}
+/**
+ * Create adapter that wraps @yushaw/sanqian-sdk
+ */
+declare function createSdkAdapter(config: SdkAdapterConfig): ChatAdapter;
+
+export { type ChatAdapter, type ChatMessage, type ConnectionErrorCode, type ConnectionStatus, type ConversationDetail, type ConversationInfo, type FloatingWindowConfig, type HitlInterruptData, type MessageBlock, type MessageRole, type SdkAdapterConfig, type SendMessage, type StreamEvent, type ToolCall, type ToolCallStatus, type WindowPosition, createSdkAdapter };

package/dist/core/index.d.ts

@@ -0,0 +1,156 @@
+import { HitlInterruptPayload, HitlResponse, SanqianSDK } from '@yushaw/sanqian-sdk';
+export { ChatStreamEvent, HitlInterruptPayload, HitlInterruptType, HitlResponse, HitlRiskLevel, ChatMessage as SdkChatMessage, ConversationDetail as SdkConversationDetail, ConversationInfo as SdkConversationInfo, ToolCall as SdkToolCall } from '@yushaw/sanqian-sdk';
+
+/**
+ * @yushaw/sanqian-chat Core Types
+ *
+ * Re-exports SDK types + chat-specific types
+ */
+
+type MessageRole = 'user' | 'assistant' | 'system';
+type ToolCallStatus = 'pending' | 'running' | 'completed' | 'error' | 'cancelled';
+type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'error';
+type ConnectionErrorCode = 'NOT_FOUND' | 'CONNECTION_FAILED' | 'WEBSOCKET_ERROR' | 'AUTH_ERROR' | 'TIMEOUT' | 'UNKNOWN';
+/** Tool call for UI rendering (extended from SDK) */
+interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    status: ToolCallStatus;
+    result?: unknown;
+    error?: string;
+}
+/** Message block for structured rendering */
+interface MessageBlock {
+    type: 'thinking' | 'text' | 'tool_call' | 'tool_result';
+    content: string;
+    timestamp: number;
+    toolName?: string;
+    toolArgs?: Record<string, unknown>;
+    toolCallId?: string;
+    toolStatus?: ToolCallStatus;
+    isIntermediate?: boolean;
+}
+/** Chat message for UI rendering */
+interface ChatMessage {
+    id: string;
+    role: MessageRole;
+    content: string;
+    timestamp: string;
+    isStreaming?: boolean;
+    toolCalls?: ToolCall[];
+    thinking?: string;
+    currentThinking?: string;
+    isThinkingStreaming?: boolean;
+    blocks?: MessageBlock[];
+    isComplete?: boolean;
+}
+/** Conversation info for UI */
+interface ConversationInfo {
+    id: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    messageCount: number;
+}
+interface ConversationDetail extends ConversationInfo {
+    messages: ChatMessage[];
+}
+/** HITL interrupt data for UI (alias for HitlInterruptPayload) */
+type HitlInterruptData = HitlInterruptPayload;
+type WindowPosition = 'center' | 'cursor' | 'remember' | {
+    x: number;
+    y: number;
+};
+interface FloatingWindowConfig {
+    shortcut?: string;
+    position?: WindowPosition;
+    width?: number;
+    height?: number;
+    alwaysOnTop?: boolean;
+    showInTaskbar?: boolean;
+    theme?: 'light' | 'dark' | 'system';
+}
+
+/**
+ * Chat Adapter Interface
+ *
+ * Abstracts the connection to Sanqian backend.
+ * Default implementation uses @yushaw/sanqian-sdk directly.
+ */
+
+/** Stream event callback */
+type StreamEvent = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'thinking';
+    content: string;
+} | {
+    type: 'tool_call';
+    tool_call: {
+        id: string;
+        function: {
+            name: string;
+            arguments: string;
+        };
+    };
+} | {
+    type: 'tool_result';
+    tool_call_id: string;
+    result: unknown;
+} | {
+    type: 'done';
+    conversationId: string;
+    title?: string;
+} | {
+    type: 'error';
+    error: string;
+} | {
+    type: 'interrupt';
+    interrupt_type: string;
+    interrupt_payload: HitlInterruptData;
+    run_id?: string;
+};
+/** Message to send */
+interface SendMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/** Chat adapter interface */
+interface ChatAdapter {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getConnectionStatus(): ConnectionStatus;
+    onConnectionChange(callback: (status: ConnectionStatus, error?: string, errorCode?: ConnectionErrorCode) => void): () => void;
+    listConversations(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        conversations: ConversationInfo[];
+        total: number;
+    }>;
+    getConversation(id: string, options?: {
+        messageLimit?: number;
+    }): Promise<ConversationDetail>;
+    deleteConversation(id: string): Promise<void>;
+    chatStream(messages: SendMessage[], conversationId: string | undefined, onEvent: (event: StreamEvent) => void): Promise<{
+        cancel: () => void;
+    }>;
+    sendHitlResponse?(response: HitlResponse, runId?: string): void;
+    cleanup?(): void;
+}
+/** SDK adapter config */
+interface SdkAdapterConfig {
+    /** SDK instance getter */
+    getSdk: () => SanqianSDK | null;
+    /** Agent ID getter */
+    getAgentId: () => string | null;
+}
+/**
+ * Create adapter that wraps @yushaw/sanqian-sdk
+ */
+declare function createSdkAdapter(config: SdkAdapterConfig): ChatAdapter;
+
+export { type ChatAdapter, type ChatMessage, type ConnectionErrorCode, type ConnectionStatus, type ConversationDetail, type ConversationInfo, type FloatingWindowConfig, type HitlInterruptData, type MessageBlock, type MessageRole, type SdkAdapterConfig, type SendMessage, type StreamEvent, type ToolCall, type ToolCallStatus, type WindowPosition, createSdkAdapter };

package/dist/core/index.js

@@ -0,0 +1,176 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/index.ts
+var core_exports = {};
+__export(core_exports, {
+  createSdkAdapter: () => createSdkAdapter
+});
+module.exports = __toCommonJS(core_exports);
+
+// src/core/adapter.ts
+function createSdkAdapter(config) {
+  let connectionStatus = "disconnected";
+  const connectionListeners = /* @__PURE__ */ new Set();
+  let currentRunId = null;
+  const updateStatus = (status, error, errorCode) => {
+    connectionStatus = status;
+    connectionListeners.forEach((cb) => cb(status, error, errorCode));
+  };
+  return {
+    async connect() {
+      const sdk = config.getSdk();
+      if (!sdk) throw new Error("SDK not available");
+      updateStatus("connecting");
+      try {
+        await sdk.ensureReady();
+        updateStatus("connected");
+      } catch (e) {
+        updateStatus("error", e instanceof Error ? e.message : "Connection failed", "CONNECTION_FAILED");
+        throw e;
+      }
+    },
+    async disconnect() {
+      updateStatus("disconnected");
+    },
+    isConnected() {
+      const sdk = config.getSdk();
+      return sdk?.isConnected() ?? false;
+    },
+    getConnectionStatus() {
+      return connectionStatus;
+    },
+    onConnectionChange(callback) {
+      connectionListeners.add(callback);
+      callback(connectionStatus);
+      return () => connectionListeners.delete(callback);
+    },
+    async listConversations(options) {
+      const sdk = config.getSdk();
+      const agentId = config.getAgentId();
+      if (!sdk || !agentId) throw new Error("SDK or agent not ready");
+      const result = await sdk.listConversations({ agentId, ...options });
+      return {
+        conversations: result.conversations.map((c) => ({
+          id: c.conversation_id,
+          title: c.title || "Untitled",
+          createdAt: c.created_at || "",
+          updatedAt: c.updated_at || "",
+          messageCount: c.message_count
+        })),
+        total: result.total
+      };
+    },
+    async getConversation(id, options) {
+      const sdk = config.getSdk();
+      if (!sdk) throw new Error("SDK not ready");
+      const detail = await sdk.getConversation(id, { messageLimit: options?.messageLimit });
+      return {
+        id: detail.conversation_id,
+        title: detail.title || "Untitled",
+        createdAt: detail.created_at || "",
+        updatedAt: detail.updated_at || "",
+        messageCount: detail.message_count,
+        messages: (detail.messages || []).map((m, i) => ({
+          id: `msg-${i}`,
+          role: m.role,
+          content: m.content,
+          timestamp: m.created_at || (/* @__PURE__ */ new Date()).toISOString()
+        }))
+      };
+    },
+    async deleteConversation(id) {
+      const sdk = config.getSdk();
+      if (!sdk) throw new Error("SDK not ready");
+      await sdk.deleteConversation(id);
+    },
+    async chatStream(messages, conversationId, onEvent) {
+      const sdk = config.getSdk();
+      const agentId = config.getAgentId();
+      if (!sdk || !agentId) throw new Error("SDK or agent not ready");
+      await sdk.ensureReady();
+      const sdkMessages = messages.map((m) => ({ role: m.role, content: m.content }));
+      const stream = sdk.chatStream(agentId, sdkMessages, { conversationId });
+      const controller = new AbortController();
+      const signal = controller.signal;
+      (async () => {
+        try {
+          for await (const event of stream) {
+            if (signal.aborted) break;
+            switch (event.type) {
+              case "text":
+                onEvent({ type: "text", content: event.content || "" });
+                break;
+              case "thinking":
+                onEvent({ type: "thinking", content: event.content || "" });
+                break;
+              case "tool_call":
+                if (event.tool_call) {
+                  onEvent({ type: "tool_call", tool_call: event.tool_call });
+                }
+                break;
+              case "tool_result":
+                onEvent({ type: "tool_result", tool_call_id: event.tool_call_id || "", result: event.result });
+                break;
+              case "done":
+                onEvent({ type: "done", conversationId: event.conversationId || "", title: event.title });
+                break;
+              case "error":
+                onEvent({ type: "error", error: event.error || "Unknown error" });
+                break;
+              default:
+                const evt = event;
+                if (evt.type === "interrupt") {
+                  currentRunId = evt.run_id || null;
+                  onEvent({
+                    type: "interrupt",
+                    interrupt_type: evt.interrupt_type || "",
+                    interrupt_payload: evt.interrupt_payload,
+                    run_id: evt.run_id
+                  });
+                }
+                break;
+            }
+          }
+        } catch (e) {
+          if (!signal.aborted) {
+            onEvent({ type: "error", error: e instanceof Error ? e.message : "Stream error" });
+          }
+        }
+      })();
+      return {
+        cancel: () => {
+          controller.abort();
+        }
+      };
+    },
+    sendHitlResponse(response, runId) {
+      const sdk = config.getSdk();
+      if (!sdk) return;
+      const id = runId || currentRunId;
+      if (id) {
+        sdk.sendHitlResponse(id, response);
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createSdkAdapter
+});

package/dist/core/index.mjs

@@ -0,0 +1,149 @@
+// src/core/adapter.ts
+function createSdkAdapter(config) {
+  let connectionStatus = "disconnected";
+  const connectionListeners = /* @__PURE__ */ new Set();
+  let currentRunId = null;
+  const updateStatus = (status, error, errorCode) => {
+    connectionStatus = status;
+    connectionListeners.forEach((cb) => cb(status, error, errorCode));
+  };
+  return {
+    async connect() {
+      const sdk = config.getSdk();
+      if (!sdk) throw new Error("SDK not available");
+      updateStatus("connecting");
+      try {
+        await sdk.ensureReady();
+        updateStatus("connected");
+      } catch (e) {
+        updateStatus("error", e instanceof Error ? e.message : "Connection failed", "CONNECTION_FAILED");
+        throw e;
+      }
+    },
+    async disconnect() {
+      updateStatus("disconnected");
+    },
+    isConnected() {
+      const sdk = config.getSdk();
+      return sdk?.isConnected() ?? false;
+    },
+    getConnectionStatus() {
+      return connectionStatus;
+    },
+    onConnectionChange(callback) {
+      connectionListeners.add(callback);
+      callback(connectionStatus);
+      return () => connectionListeners.delete(callback);
+    },
+    async listConversations(options) {
+      const sdk = config.getSdk();
+      const agentId = config.getAgentId();
+      if (!sdk || !agentId) throw new Error("SDK or agent not ready");
+      const result = await sdk.listConversations({ agentId, ...options });
+      return {
+        conversations: result.conversations.map((c) => ({
+          id: c.conversation_id,
+          title: c.title || "Untitled",
+          createdAt: c.created_at || "",
+          updatedAt: c.updated_at || "",
+          messageCount: c.message_count
+        })),
+        total: result.total
+      };
+    },
+    async getConversation(id, options) {
+      const sdk = config.getSdk();
+      if (!sdk) throw new Error("SDK not ready");
+      const detail = await sdk.getConversation(id, { messageLimit: options?.messageLimit });
+      return {
+        id: detail.conversation_id,
+        title: detail.title || "Untitled",
+        createdAt: detail.created_at || "",
+        updatedAt: detail.updated_at || "",
+        messageCount: detail.message_count,
+        messages: (detail.messages || []).map((m, i) => ({
+          id: `msg-${i}`,
+          role: m.role,
+          content: m.content,
+          timestamp: m.created_at || (/* @__PURE__ */ new Date()).toISOString()
+        }))
+      };
+    },
+    async deleteConversation(id) {
+      const sdk = config.getSdk();
+      if (!sdk) throw new Error("SDK not ready");
+      await sdk.deleteConversation(id);
+    },
+    async chatStream(messages, conversationId, onEvent) {
+      const sdk = config.getSdk();
+      const agentId = config.getAgentId();
+      if (!sdk || !agentId) throw new Error("SDK or agent not ready");
+      await sdk.ensureReady();
+      const sdkMessages = messages.map((m) => ({ role: m.role, content: m.content }));
+      const stream = sdk.chatStream(agentId, sdkMessages, { conversationId });
+      const controller = new AbortController();
+      const signal = controller.signal;
+      (async () => {
+        try {
+          for await (const event of stream) {
+            if (signal.aborted) break;
+            switch (event.type) {
+              case "text":
+                onEvent({ type: "text", content: event.content || "" });
+                break;
+              case "thinking":
+                onEvent({ type: "thinking", content: event.content || "" });
+                break;
+              case "tool_call":
+                if (event.tool_call) {
+                  onEvent({ type: "tool_call", tool_call: event.tool_call });
+                }
+                break;
+              case "tool_result":
+                onEvent({ type: "tool_result", tool_call_id: event.tool_call_id || "", result: event.result });
+                break;
+              case "done":
+                onEvent({ type: "done", conversationId: event.conversationId || "", title: event.title });
+                break;
+              case "error":
+                onEvent({ type: "error", error: event.error || "Unknown error" });
+                break;
+              default:
+                const evt = event;
+                if (evt.type === "interrupt") {
+                  currentRunId = evt.run_id || null;
+                  onEvent({
+                    type: "interrupt",
+                    interrupt_type: evt.interrupt_type || "",
+                    interrupt_payload: evt.interrupt_payload,
+                    run_id: evt.run_id
+                  });
+                }
+                break;
+            }
+          }
+        } catch (e) {
+          if (!signal.aborted) {
+            onEvent({ type: "error", error: e instanceof Error ? e.message : "Stream error" });
+          }
+        }
+      })();
+      return {
+        cancel: () => {
+          controller.abort();
+        }
+      };
+    },
+    sendHitlResponse(response, runId) {
+      const sdk = config.getSdk();
+      if (!sdk) return;
+      const id = runId || currentRunId;
+      if (id) {
+        sdk.sendHitlResponse(id, response);
+      }
+    }
+  };
+}
+export {
+  createSdkAdapter
+};

package/dist/main/index.d.mts

@@ -0,0 +1,58 @@
+import { BrowserWindow } from 'electron';
+import { SanqianSDK } from '@yushaw/sanqian-sdk';
+
+/**
+ * @yushaw/sanqian-chat Core Types
+ *
+ * Re-exports SDK types + chat-specific types
+ */
+
+type WindowPosition = 'center' | 'cursor' | 'remember' | {
+    x: number;
+    y: number;
+};
+interface FloatingWindowConfig {
+    shortcut?: string;
+    position?: WindowPosition;
+    width?: number;
+    height?: number;
+    alwaysOnTop?: boolean;
+    showInTaskbar?: boolean;
+    theme?: 'light' | 'dark' | 'system';
+}
+
+/**
+ * FloatingWindow - Main process module for floating chat window
+ */
+
+interface FloatingWindowOptions extends FloatingWindowConfig {
+    /** SDK instance getter */
+    getSdk: () => SanqianSDK | null;
+    /** Agent ID getter */
+    getAgentId: () => string | null;
+    /** Path to preload script */
+    preloadPath: string;
+    /** Path to renderer HTML or URL */
+    rendererPath: string;
+    /** Dev mode - load from URL instead of file */
+    devMode?: boolean;
+}
+declare class FloatingWindow {
+    private window;
+    private options;
+    private savedPosition;
+    private activeStreams;
+    constructor(options: FloatingWindowOptions);
+    private createWindow;
+    private getInitialPosition;
+    private registerShortcut;
+    private setupIpcHandlers;
+    show(): void;
+    hide(): void;
+    toggle(): void;
+    isVisible(): boolean;
+    destroy(): void;
+    getWindow(): BrowserWindow | null;
+}
+
+export { FloatingWindow, type FloatingWindowConfig, type FloatingWindowOptions, type WindowPosition };