@incremark/chat-core 0.4.0-alpha.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 wangyishuai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/dist/chunk-FOTOSDBV.js

@@ -0,0 +1,89 @@
+import { nanoid } from 'nanoid';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var TOOL_CALL_STATES = {
+  INPUT_STREAMING: "input-streaming",
+  INPUT_AVAILABLE: "input-available",
+  APPROVAL_REQUESTED: "approval-requested",
+  APPROVAL_RESPONDED: "approval-responded",
+  EXECUTING: "executing",
+  OUTPUT_AVAILABLE: "output-available",
+  OUTPUT_ERROR: "output-error",
+  OUTPUT_DENIED: "output-denied"
+};
+function isPartType(part, type) {
+  return part.type === type;
+}
+function isTextPart(part) {
+  return part.type === "text";
+}
+function isToolCallPart(part) {
+  return part.type === "tool-call";
+}
+function isSourcePart(part) {
+  return part.type === "source";
+}
+function isFilePart(part) {
+  return part.type === "file";
+}
+function isUIPart(part) {
+  return part.type === "ui";
+}
+function isReasoningPart(part) {
+  return part.type === "reasoning";
+}
+function createTextMessage(role, content, format = "markdown") {
+  return {
+    id: generateId(),
+    role,
+    parts: [{ type: "text", content, format }],
+    status: "success",
+    createdAt: Date.now()
+  };
+}
+function createStreamingMessage(role) {
+  return {
+    id: generateId(),
+    role,
+    parts: [],
+    status: "streaming",
+    createdAt: Date.now()
+  };
+}
+function generateId() {
+  return `msg-${Date.now()}-${nanoid()}`;
+}
+
+// src/protocol/transport.ts
+var MockTransport = class {
+  constructor() {
+    __publicField(this, "aborted", false);
+  }
+  async *send(messages) {
+    messages[messages.length - 1];
+    const response = "This is a mock response from the AI assistant.";
+    const words = response.split(" ");
+    for (const word of words) {
+      if (this.aborted) {
+        yield { type: "error", error: "Aborted by user" };
+        return;
+      }
+      yield {
+        type: "text",
+        content: word + " ",
+        format: "markdown"
+      };
+      await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    yield { type: "done" };
+  }
+  abort() {
+    this.aborted = true;
+  }
+};
+
+export { MockTransport, TOOL_CALL_STATES, __publicField, createStreamingMessage, createTextMessage, isFilePart, isPartType, isReasoningPart, isSourcePart, isTextPart, isToolCallPart, isUIPart };
+//# sourceMappingURL=chunk-FOTOSDBV.js.map
+//# sourceMappingURL=chunk-FOTOSDBV.js.map

package/dist/chunk-FOTOSDBV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol/message.ts","../src/protocol/transport.ts"],"names":[],"mappings":";;;;;AA4DO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,eAAA,EAAiB,iBAAA;AAAA,EACjB,eAAA,EAAiB,iBAAA;AAAA,EACjB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,SAAA,EAAW,WAAA;AAAA,EACX,gBAAA,EAAkB,kBAAA;AAAA,EAClB,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe;AACjB;AA4HO,SAAS,UAAA,CACd,MACA,IAAA,EAC0B;AAC1B,EAAA,OAAO,KAAK,IAAA,KAAS,IAAA;AACvB;AAKO,SAAS,WAAW,IAAA,EAAqC;AAC9D,EAAA,OAAO,KAAK,IAAA,KAAS,MAAA;AACvB;AAKO,SAAS,eAAe,IAAA,EAAyC;AACtE,EAAA,OAAO,KAAK,IAAA,KAAS,WAAA;AACvB;AAKO,SAAS,aAAa,IAAA,EAAuC;AAClE,EAAA,OAAO,KAAK,IAAA,KAAS,QAAA;AACvB;AAKO,SAAS,WAAW,IAAA,EAAqC;AAC9D,EAAA,OAAO,KAAK,IAAA,KAAS,MAAA;AACvB;AAKO,SAAS,SAAS,IAAA,EAAmC;AAC1D,EAAA,OAAO,KAAK,IAAA,KAAS,IAAA;AACvB;AAKO,SAAS,gBAAgB,IAAA,EAA0C;AACxE,EAAA,OAAO,KAAK,IAAA,KAAS,WAAA;AACvB;AAyBO,SAAS,iBAAA,CACd,IAAA,EACA,OAAA,EACA,MAAA,GAA+B,UAAA,EAClB;AACb,EAAA,OAAO;AAAA,IACL,IAAI,UAAA,EAAW;AAAA,IACf,IAAA;AAAA,IACA,OAAO,CAAC,EAAE,MAAM,MAAA,EAAQ,OAAA,EAAS,QAAQ,CAAA;AAAA,IACzC,MAAA,EAAQ,SAAA;AAAA,IACR,SAAA,EAAW,KAAK,GAAA;AAAI,GACtB;AACF;AAKO,SAAS,uBAAuB,IAAA,EAA0C;AAC/E,EAAA,OAAO;AAAA,IACL,IAAI,UAAA,EAAW;AAAA,IACf,IAAA;AAAA,IACA,OAAO,EAAC;AAAA,IACR,MAAA,EAAQ,WAAA;AAAA,IACR,SAAA,EAAW,KAAK,GAAA;AAAI,GACtB;AACF;AAKA,SAAS,UAAA,GAAqB;AAC5B,EAAA,OAAO,OAAO,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA,EAAI,QAAQ,CAAA,CAAA;AACtC;;;AC1MO,IAAM,gBAAN,MAA6C;AAAA,EAA7C,WAAA,GAAA;AACL,IAAA,aAAA,CAAA,IAAA,EAAQ,SAAA,EAAU,KAAA,CAAA;AAAA,EAAA;AAAA,EAElB,OAAO,KAAK,QAAA,EAAqD;AAC/D,IAAoB,QAAA,CAAS,QAAA,CAAS,MAAA,GAAS,CAAC;AAGhD,IAAA,MAAM,QAAA,GAAW,gDAAA;AACjB,IAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,KAAA,CAAM,GAAG,CAAA;AAEhC,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,IAAI,KAAK,OAAA,EAAS;AAChB,QAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,iBAAA,EAAkB;AAChD,QAAA;AAAA,MACF;AAEA,MAAA,MAAM;AAAA,QACJ,IAAA,EAAM,MAAA;AAAA,QACN,SAAS,IAAA,GAAO,GAAA;AAAA,QAChB,MAAA,EAAQ;AAAA,OACV;AAGA,MAAA,MAAM,IAAI,OAAA,CAAQ,CAAA,OAAA,KAAW,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AAAA,IACtD;AAEA,IAAA,MAAM,EAAE,MAAM,MAAA,EAAO;AAAA,EACvB;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA;AAAA,EACjB;AACF","file":"chunk-FOTOSDBV.js","sourcesContent":["import { nanoid } from 'nanoid'\n\n/**\n * Message protocol types for Incremark Chat-UI\n * Based on Vercel AI SDK & TanStack AI's parts-based message structure\n *\n * Extensibility: Users can extend MessagePart via module augmentation:\n * ```ts\n * declare module '@incremark/chat-core' {\n *   interface CustomParts {\n *     'my-custom': { type: 'my-custom'; data: string };\n *   }\n * }\n * ```\n */\n\n// ============================================================================\n// Base Types\n// ============================================================================\n\n/**\n * Supported message roles\n */\nexport type MessageRole = 'user' | 'assistant' | 'system' | 'agent';\n\n/**\n * Message status during lifecycle\n */\nexport type MessageStatus = 'pending' | 'streaming' | 'success' | 'error';\n\n// ============================================================================\n// Part Types\n// ============================================================================\n\n/**\n * Base part interface - all parts must have a type\n */\nexport interface BasePart {\n  type: string;\n}\n\n/**\n * Text content part\n */\nexport interface TextPart extends BasePart {\n  type: 'text';\n  content: string;\n  format?: 'markdown' | 'plain';\n}\n\n/**\n * Tool call state - 用户可自定义任意状态\n * 提供预定义常量供参考，但不限制用户使用其他值\n */\nexport type ToolCallState = string;\n\n/**\n * 预定义的工具调用状态常量（参考 Vercel AI SDK）\n * 用户可以使用这些常量，也可以使用自定义状态\n */\nexport const TOOL_CALL_STATES = {\n  INPUT_STREAMING: 'input-streaming',\n  INPUT_AVAILABLE: 'input-available',\n  APPROVAL_REQUESTED: 'approval-requested',\n  APPROVAL_RESPONDED: 'approval-responded',\n  EXECUTING: 'executing',\n  OUTPUT_AVAILABLE: 'output-available',\n  OUTPUT_ERROR: 'output-error',\n  OUTPUT_DENIED: 'output-denied'\n} as const;\n\n/**\n * Tool call part (when AI wants to use a tool)\n */\nexport interface ToolCallPart extends BasePart {\n  type: 'tool-call';\n  toolCallId: string;\n  toolName: string;\n  args: Record<string, unknown>;\n  state: ToolCallState;\n  /** 工具执行结果 */\n  output?: unknown;\n  /** 错误信息（当 state 为 output-error 时） */\n  error?: string;\n}\n\n/**\n * Source reference type\n */\nexport type SourceType = 'url' | 'document';\n\n/**\n * Source part (reference to external content)\n */\nexport interface SourcePart extends BasePart {\n  type: 'source';\n  sourceId: string;\n  sourceType: SourceType;\n  url?: string;\n  title?: string;\n  /** 文档类型（当 sourceType 为 document 时） */\n  mediaType?: string;\n}\n\n/**\n * File part (generated or uploaded file)\n */\nexport interface FilePart extends BasePart {\n  type: 'file';\n  fileId: string;\n  /** base64 编码的文件内容或 URL */\n  data: string;\n  mediaType: string;\n  filename?: string;\n}\n\n/**\n * UI component part (for A2UI - Agent to UI)\n */\nexport interface UIPart extends BasePart {\n  type: 'ui';\n  component: string;\n  props: Record<string, unknown>;\n}\n\n/**\n * Reasoning/thought part (for chain-of-thought display)\n */\nexport interface ReasoningPart extends BasePart {\n  type: 'reasoning';\n  content: string;\n  /** 推理状态 */\n  status?: 'thinking' | 'completed' | 'error';\n  /** 思考开始时间（毫秒时间戳） */\n  startTime?: number;\n  /** 思考结束时间（毫秒时间戳） */\n  endTime?: number;\n  /** 思考标题 */\n  title?: string;\n}\n\n// ============================================================================\n// Extensibility Support\n// ============================================================================\n\n/**\n * Built-in parts registry\n */\nexport interface BuiltinParts {\n  text: TextPart;\n  'tool-call': ToolCallPart;\n  source: SourcePart;\n  file: FilePart;\n  ui: UIPart;\n  reasoning: ReasoningPart;\n}\n\n/**\n * Custom parts registry - extend via module augmentation\n * @example\n * ```ts\n * declare module '@incremark/chat-core' {\n *   interface CustomParts {\n *     'weather-card': { type: 'weather-card'; city: string; temp: number };\n *   }\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface CustomParts {}\n\n/**\n * All registered parts\n */\nexport type PartsRegistry = BuiltinParts & CustomParts;\n\n/**\n * Union type for all message parts (built-in + custom)\n */\nexport type MessagePart = PartsRegistry[keyof PartsRegistry];\n\n/**\n * Get part type by name\n */\nexport type PartByType<T extends keyof PartsRegistry> = PartsRegistry[T];\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Generic type guard for any part type\n */\nexport function isPartType<T extends keyof PartsRegistry>(\n  part: MessagePart,\n  type: T\n): part is PartsRegistry[T] {\n  return part.type === type;\n}\n\n/**\n * Type guard for TextPart\n */\nexport function isTextPart(part: MessagePart): part is TextPart {\n  return part.type === 'text';\n}\n\n/**\n * Type guard for ToolCallPart\n */\nexport function isToolCallPart(part: MessagePart): part is ToolCallPart {\n  return part.type === 'tool-call';\n}\n\n/**\n * Type guard for SourcePart\n */\nexport function isSourcePart(part: MessagePart): part is SourcePart {\n  return part.type === 'source';\n}\n\n/**\n * Type guard for FilePart\n */\nexport function isFilePart(part: MessagePart): part is FilePart {\n  return part.type === 'file';\n}\n\n/**\n * Type guard for UIPart\n */\nexport function isUIPart(part: MessagePart): part is UIPart {\n  return part.type === 'ui';\n}\n\n/**\n * Type guard for ReasoningPart\n */\nexport function isReasoningPart(part: MessagePart): part is ReasoningPart {\n  return part.type === 'reasoning';\n}\n\n// ============================================================================\n// Message Types\n// ============================================================================\n\n/**\n * Complete message structure\n */\nexport interface ChatMessage {\n  id: string;\n  role: MessageRole;\n  parts: MessagePart[];\n  status: MessageStatus;\n  createdAt: number;\n  metadata?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Factory Functions\n// ============================================================================\n\n/**\n * Create a new text message\n */\nexport function createTextMessage(\n  role: MessageRole,\n  content: string,\n  format: 'markdown' | 'plain' = 'markdown'\n): ChatMessage {\n  return {\n    id: generateId(),\n    role,\n    parts: [{ type: 'text', content, format }],\n    status: 'success',\n    createdAt: Date.now()\n  };\n}\n\n/**\n * Create a new empty streaming message\n */\nexport function createStreamingMessage(role: 'assistant' | 'agent'): ChatMessage {\n  return {\n    id: generateId(),\n    role,\n    parts: [],\n    status: 'streaming',\n    createdAt: Date.now()\n  };\n}\n\n/**\n * Simple ID generator (can be replaced with more sophisticated one)\n */\nfunction generateId(): string {\n  return `msg-${Date.now()}-${nanoid()}`;\n}\n","/**\n * Transport layer protocol for chat communication\n * Inspired by Vercel AI SDK 5.0+ transport architecture\n */\n\nimport type { ChatMessage } from './message.js';\n\n/**\n * Stream part - chunks of data received during streaming\n */\nexport type StreamPart =\n  | TextStreamPart\n  | ToolCallStreamPart\n  | UIStreamPart\n  | ReasoningStreamPart\n  | DoneStreamPart\n  | ErrorStreamPart;\n\n/**\n * Text content stream part\n */\nexport interface TextStreamPart {\n  type: 'text';\n  content: string;\n  format?: 'markdown' | 'plain';\n}\n\n/**\n * Tool call stream part\n */\nexport interface ToolCallStreamPart {\n  type: 'tool-call';\n  toolCallId?: string;\n  toolName: string;\n  args: Record<string, any>;\n}\n\n/**\n * UI component stream part\n */\nexport interface UIStreamPart {\n  type: 'ui';\n  component: string;\n  props: Record<string, any>;\n}\n\n/**\n * Reasoning stream part\n */\nexport interface ReasoningStreamPart {\n  type: 'reasoning';\n  content: string;\n}\n\n/**\n * Stream completion marker\n */\nexport interface DoneStreamPart {\n  type: 'done';\n}\n\n/**\n * Error stream part\n */\nexport interface ErrorStreamPart {\n  type: 'error';\n  error: string;\n}\n\n/**\n * Transport interface for sending messages and receiving stream\n * This is the key abstraction that allows different implementations:\n * - HTTP streaming\n * - WebSocket\n * - Server-Sent Events (SSE)\n * - Mock for testing\n */\nexport interface ChatTransport {\n  /**\n   * Send messages and return async generator of stream parts\n   *\n   * @param messages - Full conversation history (or context window)\n   * @returns Async generator yielding stream parts\n   */\n  send(messages: ChatMessage[]): AsyncGenerator<StreamPart>;\n\n  /**\n   * Abort the current stream (optional)\n   */\n  abort?(): void;\n}\n\n/**\n * Simple mock transport for testing\n */\nexport class MockTransport implements ChatTransport {\n  private aborted = false;\n\n  async *send(messages: ChatMessage[]): AsyncGenerator<StreamPart> {\n    const lastMessage = messages[messages.length - 1];\n\n    // Simulate streaming response\n    const response = \"This is a mock response from the AI assistant.\";\n    const words = response.split(' ');\n\n    for (const word of words) {\n      if (this.aborted) {\n        yield { type: 'error', error: 'Aborted by user' };\n        return;\n      }\n\n      yield {\n        type: 'text',\n        content: word + ' ',\n        format: 'markdown'\n      };\n\n      // Simulate network delay\n      await new Promise(resolve => setTimeout(resolve, 50));\n    }\n\n    yield { type: 'done' };\n  }\n\n  abort(): void {\n    this.aborted = true;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+import { ChatMessage, MessageStatus, ChatTransport } from './protocol/index.js';
+export { BasePart, BuiltinParts, CustomParts, DoneStreamPart, ErrorStreamPart, FilePart, MessagePart, MessageRole, MockTransport, PartByType, PartsRegistry, ReasoningPart, ReasoningStreamPart, SourcePart, SourceType, StreamPart, TOOL_CALL_STATES, TextPart, TextStreamPart, ToolCallPart, ToolCallState, ToolCallStreamPart, UIPart, UIStreamPart, createStreamingMessage, createTextMessage, isFilePart, isPartType, isReasoningPart, isSourcePart, isTextPart, isToolCallPart, isUIPart } from './protocol/index.js';
+
+/**
+ * ChatEngine - Core engine for managing chat state and streaming
+ * Framework-agnostic implementation
+ */
+
+/**
+ * State update listener type
+ */
+type StateListener = (state: ChatEngineState) => void;
+/**
+ * Engine state snapshot
+ */
+interface ChatEngineState {
+    messages: ChatMessage[];
+    status: MessageStatus;
+    error?: string;
+}
+/**
+ * ID generator function type
+ */
+type IDGenerator = () => string;
+/**
+ * Default ID generator using nanoid
+ */
+declare const defaultIDGenerator: IDGenerator;
+/**
+ * Configuration for ChatEngine
+ */
+interface ChatEngineConfig {
+    transport: ChatTransport;
+    initialMessages?: ChatMessage[];
+    idGenerator?: IDGenerator;
+}
+/**
+ * Core engine for chat functionality
+ * - Manages message history
+ * - Handles streaming responses
+ * - Emits state updates
+ */
+declare class ChatEngine {
+    private messages;
+    private currentMessage;
+    private status;
+    private error;
+    private listeners;
+    private transport;
+    private abortController;
+    private idGenerator;
+    constructor(config: ChatEngineConfig);
+    /**
+     * Get current state (immutable snapshot)
+     */
+    getState(): ChatEngineState;
+    /**
+     * Subscribe to state updates
+     * @returns Unsubscribe function
+     */
+    subscribe(listener: StateListener): () => void;
+    /**
+     * Send a text message and process the streaming response
+     */
+    sendMessage(text: string): Promise<void>;
+    /**
+     * Abort current streaming
+     */
+    abort(): void;
+    /**
+     * Process streaming response from transport
+     */
+    private processStream;
+    /**
+     * Handle individual stream part
+     */
+    private handleStreamPart;
+    /**
+     * Handle text stream part - incrementally update last text part or create new one
+     */
+    private handleTextPart;
+    /**
+     * Handle tool call part
+     */
+    private handleToolCallPart;
+    /**
+     * Handle UI part
+     */
+    private handleUIPart;
+    /**
+     * Handle reasoning part
+     */
+    private handleReasoningPart;
+    /**
+     * Emit state update to all listeners
+     */
+    private emitUpdate;
+    /**
+     * Generate unique ID using configured generator
+     */
+    private generateId;
+}
+
+export { ChatEngine, type ChatEngineConfig, type ChatEngineState, ChatMessage, ChatTransport, type IDGenerator, MessageStatus, type StateListener, defaultIDGenerator };

package/dist/index.js

@@ -0,0 +1,198 @@
+import { __publicField } from './chunk-FOTOSDBV.js';
+export { MockTransport, TOOL_CALL_STATES, createStreamingMessage, createTextMessage, isFilePart, isPartType, isReasoningPart, isSourcePart, isTextPart, isToolCallPart, isUIPart } from './chunk-FOTOSDBV.js';
+import { nanoid } from 'nanoid';
+
+var defaultIDGenerator = () => `msg_${nanoid()}`;
+var ChatEngine = class {
+  constructor(config) {
+    __publicField(this, "messages", []);
+    __publicField(this, "currentMessage", null);
+    __publicField(this, "status", "success");
+    __publicField(this, "error");
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
+    __publicField(this, "transport");
+    __publicField(this, "abortController", null);
+    __publicField(this, "idGenerator");
+    this.transport = config.transport;
+    this.idGenerator = config.idGenerator || defaultIDGenerator;
+    if (config.initialMessages) {
+      this.messages = [...config.initialMessages];
+    }
+  }
+  /**
+   * Get current state (immutable snapshot)
+   */
+  getState() {
+    return {
+      messages: [...this.messages],
+      status: this.status,
+      error: this.error
+    };
+  }
+  /**
+   * Subscribe to state updates
+   * @returns Unsubscribe function
+   */
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  /**
+   * Send a text message and process the streaming response
+   */
+  async sendMessage(text) {
+    const userMessage = {
+      id: this.generateId(),
+      role: "user",
+      parts: [{ type: "text", content: text, format: "plain" }],
+      status: "success",
+      createdAt: Date.now()
+    };
+    this.messages.push(userMessage);
+    this.emitUpdate();
+    const assistantMessage = {
+      id: this.generateId(),
+      role: "assistant",
+      parts: [],
+      status: "streaming",
+      createdAt: Date.now()
+    };
+    this.messages.push(assistantMessage);
+    this.currentMessage = assistantMessage;
+    this.status = "streaming";
+    this.error = void 0;
+    this.emitUpdate();
+    try {
+      await this.processStream();
+      assistantMessage.status = "success";
+      this.status = "success";
+    } catch (err) {
+      assistantMessage.status = "error";
+      this.status = "error";
+      this.error = err instanceof Error ? err.message : String(err);
+    } finally {
+      this.currentMessage = null;
+      this.emitUpdate();
+    }
+  }
+  /**
+   * Abort current streaming
+   */
+  abort() {
+    if (this.abortController) {
+      this.abortController.abort();
+      this.abortController = null;
+    }
+    this.transport.abort?.();
+  }
+  /**
+   * Process streaming response from transport
+   */
+  async processStream() {
+    this.abortController = new AbortController();
+    for await (const part of this.transport.send(this.messages)) {
+      if (this.abortController.signal.aborted) {
+        throw new Error("Aborted by user");
+      }
+      this.handleStreamPart(part);
+    }
+  }
+  /**
+   * Handle individual stream part
+   */
+  handleStreamPart(part) {
+    if (!this.currentMessage) return;
+    switch (part.type) {
+      case "text":
+        this.handleTextPart(part);
+        break;
+      case "tool-call":
+        this.handleToolCallPart(part);
+        break;
+      case "ui":
+        this.handleUIPart(part);
+        break;
+      case "reasoning":
+        this.handleReasoningPart(part);
+        break;
+      case "done":
+        break;
+      case "error":
+        throw new Error(part.error);
+    }
+    this.emitUpdate();
+  }
+  /**
+   * Handle text stream part - incrementally update last text part or create new one
+   */
+  handleTextPart(part) {
+    if (!this.currentMessage) return;
+    const lastPart = this.currentMessage.parts[this.currentMessage.parts.length - 1];
+    if (lastPart && lastPart.type === "text") {
+      lastPart.content += part.content;
+    } else {
+      this.currentMessage.parts.push({
+        type: "text",
+        content: part.content,
+        format: part.format || "markdown"
+      });
+    }
+  }
+  /**
+   * Handle tool call part
+   */
+  handleToolCallPart(part) {
+    if (!this.currentMessage) return;
+    this.currentMessage.parts.push({
+      type: "tool-call",
+      toolCallId: part.toolCallId || this.generateId(),
+      toolName: part.toolName,
+      args: part.args,
+      state: "input-available"
+    });
+  }
+  /**
+   * Handle UI part
+   */
+  handleUIPart(part) {
+    if (!this.currentMessage) return;
+    this.currentMessage.parts.push({
+      type: "ui",
+      component: part.component,
+      props: part.props
+    });
+  }
+  /**
+   * Handle reasoning part
+   */
+  handleReasoningPart(part) {
+    if (!this.currentMessage) return;
+    this.currentMessage.parts.push({
+      type: "reasoning",
+      content: part.content
+    });
+  }
+  /**
+   * Emit state update to all listeners
+   */
+  emitUpdate() {
+    const state = this.getState();
+    this.listeners.forEach((listener) => {
+      try {
+        listener(state);
+      } catch (err) {
+        console.error("Error in state listener:", err);
+      }
+    });
+  }
+  /**
+   * Generate unique ID using configured generator
+   */
+  generateId() {
+    return this.idGenerator();
+  }
+};
+
+export { ChatEngine, defaultIDGenerator };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/chat-engine.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * ChatEngine - Core engine for managing chat state and streaming\n * Framework-agnostic implementation\n */\n\nimport { nanoid } from 'nanoid';\nimport type {\n  ChatMessage,\n  MessagePart,\n  MessageStatus,\n  StreamPart,\n  ChatTransport,\n  TextPart,\n  ToolCallPart,\n  UIPart,\n  ReasoningPart\n} from '../protocol/index.js';\n\n/**\n * State update listener type\n */\nexport type StateListener = (state: ChatEngineState) => void;\n\n/**\n * Engine state snapshot\n */\nexport interface ChatEngineState {\n  messages: ChatMessage[];\n  status: MessageStatus;\n  error?: string;\n}\n\n/**\n * ID generator function type\n */\nexport type IDGenerator = () => string;\n\n/**\n * Default ID generator using nanoid\n */\nexport const defaultIDGenerator: IDGenerator = () => `msg_${nanoid()}`;\n\n/**\n * Configuration for ChatEngine\n */\nexport interface ChatEngineConfig {\n  transport: ChatTransport;\n  initialMessages?: ChatMessage[];\n  idGenerator?: IDGenerator;\n}\n\n/**\n * Core engine for chat functionality\n * - Manages message history\n * - Handles streaming responses\n * - Emits state updates\n */\nexport class ChatEngine {\n  private messages: ChatMessage[] = [];\n  private currentMessage: ChatMessage | null = null;\n  private status: MessageStatus = 'success';\n  private error: string | undefined;\n  private listeners: Set<StateListener> = new Set();\n  private transport: ChatTransport;\n  private abortController: AbortController | null = null;\n  private idGenerator: IDGenerator;\n\n  constructor(config: ChatEngineConfig) {\n    this.transport = config.transport;\n    this.idGenerator = config.idGenerator || defaultIDGenerator;\n    if (config.initialMessages) {\n      this.messages = [...config.initialMessages];\n    }\n  }\n\n  /**\n   * Get current state (immutable snapshot)\n   */\n  getState(): ChatEngineState {\n    return {\n      messages: [...this.messages],\n      status: this.status,\n      error: this.error\n    };\n  }\n\n  /**\n   * Subscribe to state updates\n   * @returns Unsubscribe function\n   */\n  subscribe(listener: StateListener): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  /**\n   * Send a text message and process the streaming response\n   */\n  async sendMessage(text: string): Promise<void> {\n    // Create user message\n    const userMessage: ChatMessage = {\n      id: this.generateId(),\n      role: 'user',\n      parts: [{ type: 'text', content: text, format: 'plain' }],\n      status: 'success',\n      createdAt: Date.now()\n    };\n\n    this.messages.push(userMessage);\n    this.emitUpdate();\n\n    // Create assistant message placeholder\n    const assistantMessage: ChatMessage = {\n      id: this.generateId(),\n      role: 'assistant',\n      parts: [],\n      status: 'streaming',\n      createdAt: Date.now()\n    };\n\n    this.messages.push(assistantMessage);\n    this.currentMessage = assistantMessage;\n    this.status = 'streaming';\n    this.error = undefined;\n    this.emitUpdate();\n\n    // Process stream\n    try {\n      await this.processStream();\n      assistantMessage.status = 'success';\n      this.status = 'success';\n    } catch (err) {\n      assistantMessage.status = 'error';\n      this.status = 'error';\n      this.error = err instanceof Error ? err.message : String(err);\n    } finally {\n      this.currentMessage = null;\n      this.emitUpdate();\n    }\n  }\n\n  /**\n   * Abort current streaming\n   */\n  abort(): void {\n    if (this.abortController) {\n      this.abortController.abort();\n      this.abortController = null;\n    }\n    this.transport.abort?.();\n  }\n\n  /**\n   * Process streaming response from transport\n   */\n  private async processStream(): Promise<void> {\n    this.abortController = new AbortController();\n\n    for await (const part of this.transport.send(this.messages)) {\n      if (this.abortController.signal.aborted) {\n        throw new Error('Aborted by user');\n      }\n\n      this.handleStreamPart(part);\n    }\n  }\n\n  /**\n   * Handle individual stream part\n   */\n  private handleStreamPart(part: StreamPart): void {\n    if (!this.currentMessage) return;\n\n    switch (part.type) {\n      case 'text':\n        this.handleTextPart(part);\n        break;\n\n      case 'tool-call':\n        this.handleToolCallPart(part);\n        break;\n\n      case 'ui':\n        this.handleUIPart(part);\n        break;\n\n      case 'reasoning':\n        this.handleReasoningPart(part);\n        break;\n\n      case 'done':\n        // Stream completed\n        break;\n\n      case 'error':\n        throw new Error(part.error);\n    }\n\n    this.emitUpdate();\n  }\n\n  /**\n   * Handle text stream part - incrementally update last text part or create new one\n   */\n  private handleTextPart(part: StreamPart & { type: 'text' }): void {\n    if (!this.currentMessage) return;\n\n    const lastPart = this.currentMessage.parts[this.currentMessage.parts.length - 1];\n\n    // If last part is text, append to it (incremental update)\n    if (lastPart && lastPart.type === 'text') {\n      lastPart.content += part.content;\n    } else {\n      // Otherwise create new text part\n      this.currentMessage.parts.push({\n        type: 'text',\n        content: part.content,\n        format: part.format || 'markdown'\n      });\n    }\n  }\n\n  /**\n   * Handle tool call part\n   */\n  private handleToolCallPart(part: StreamPart & { type: 'tool-call' }): void {\n    if (!this.currentMessage) return;\n\n    this.currentMessage.parts.push({\n      type: 'tool-call',\n      toolCallId: part.toolCallId || this.generateId(),\n      toolName: part.toolName,\n      args: part.args,\n      state: 'input-available'\n    });\n  }\n\n  /**\n   * Handle UI part\n   */\n  private handleUIPart(part: StreamPart & { type: 'ui' }): void {\n    if (!this.currentMessage) return;\n\n    this.currentMessage.parts.push({\n      type: 'ui',\n      component: part.component,\n      props: part.props\n    });\n  }\n\n  /**\n   * Handle reasoning part\n   */\n  private handleReasoningPart(part: StreamPart & { type: 'reasoning' }): void {\n    if (!this.currentMessage) return;\n\n    this.currentMessage.parts.push({\n      type: 'reasoning',\n      content: part.content\n    });\n  }\n\n  /**\n   * Emit state update to all listeners\n   */\n  private emitUpdate(): void {\n    const state = this.getState();\n    this.listeners.forEach(listener => {\n      try {\n        listener(state);\n      } catch (err) {\n        console.error('Error in state listener:', err);\n      }\n    });\n  }\n\n  /**\n   * Generate unique ID using configured generator\n   */\n  private generateId(): string {\n    return this.idGenerator();\n  }\n}\n"]}

package/dist/protocol/index.d.ts

@@ -0,0 +1,287 @@
+/**
+ * Message protocol types for Incremark Chat-UI
+ * Based on Vercel AI SDK & TanStack AI's parts-based message structure
+ *
+ * Extensibility: Users can extend MessagePart via module augmentation:
+ * ```ts
+ * declare module '@incremark/chat-core' {
+ *   interface CustomParts {
+ *     'my-custom': { type: 'my-custom'; data: string };
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Supported message roles
+ */
+type MessageRole = 'user' | 'assistant' | 'system' | 'agent';
+/**
+ * Message status during lifecycle
+ */
+type MessageStatus = 'pending' | 'streaming' | 'success' | 'error';
+/**
+ * Base part interface - all parts must have a type
+ */
+interface BasePart {
+    type: string;
+}
+/**
+ * Text content part
+ */
+interface TextPart extends BasePart {
+    type: 'text';
+    content: string;
+    format?: 'markdown' | 'plain';
+}
+/**
+ * Tool call state - 用户可自定义任意状态
+ * 提供预定义常量供参考，但不限制用户使用其他值
+ */
+type ToolCallState = string;
+/**
+ * 预定义的工具调用状态常量（参考 Vercel AI SDK）
+ * 用户可以使用这些常量，也可以使用自定义状态
+ */
+declare const TOOL_CALL_STATES: {
+    readonly INPUT_STREAMING: "input-streaming";
+    readonly INPUT_AVAILABLE: "input-available";
+    readonly APPROVAL_REQUESTED: "approval-requested";
+    readonly APPROVAL_RESPONDED: "approval-responded";
+    readonly EXECUTING: "executing";
+    readonly OUTPUT_AVAILABLE: "output-available";
+    readonly OUTPUT_ERROR: "output-error";
+    readonly OUTPUT_DENIED: "output-denied";
+};
+/**
+ * Tool call part (when AI wants to use a tool)
+ */
+interface ToolCallPart extends BasePart {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    state: ToolCallState;
+    /** 工具执行结果 */
+    output?: unknown;
+    /** 错误信息（当 state 为 output-error 时） */
+    error?: string;
+}
+/**
+ * Source reference type
+ */
+type SourceType = 'url' | 'document';
+/**
+ * Source part (reference to external content)
+ */
+interface SourcePart extends BasePart {
+    type: 'source';
+    sourceId: string;
+    sourceType: SourceType;
+    url?: string;
+    title?: string;
+    /** 文档类型（当 sourceType 为 document 时） */
+    mediaType?: string;
+}
+/**
+ * File part (generated or uploaded file)
+ */
+interface FilePart extends BasePart {
+    type: 'file';
+    fileId: string;
+    /** base64 编码的文件内容或 URL */
+    data: string;
+    mediaType: string;
+    filename?: string;
+}
+/**
+ * UI component part (for A2UI - Agent to UI)
+ */
+interface UIPart extends BasePart {
+    type: 'ui';
+    component: string;
+    props: Record<string, unknown>;
+}
+/**
+ * Reasoning/thought part (for chain-of-thought display)
+ */
+interface ReasoningPart extends BasePart {
+    type: 'reasoning';
+    content: string;
+    /** 推理状态 */
+    status?: 'thinking' | 'completed' | 'error';
+    /** 思考开始时间（毫秒时间戳） */
+    startTime?: number;
+    /** 思考结束时间（毫秒时间戳） */
+    endTime?: number;
+    /** 思考标题 */
+    title?: string;
+}
+/**
+ * Built-in parts registry
+ */
+interface BuiltinParts {
+    text: TextPart;
+    'tool-call': ToolCallPart;
+    source: SourcePart;
+    file: FilePart;
+    ui: UIPart;
+    reasoning: ReasoningPart;
+}
+/**
+ * Custom parts registry - extend via module augmentation
+ * @example
+ * ```ts
+ * declare module '@incremark/chat-core' {
+ *   interface CustomParts {
+ *     'weather-card': { type: 'weather-card'; city: string; temp: number };
+ *   }
+ * }
+ * ```
+ */
+interface CustomParts {
+}
+/**
+ * All registered parts
+ */
+type PartsRegistry = BuiltinParts & CustomParts;
+/**
+ * Union type for all message parts (built-in + custom)
+ */
+type MessagePart = PartsRegistry[keyof PartsRegistry];
+/**
+ * Get part type by name
+ */
+type PartByType<T extends keyof PartsRegistry> = PartsRegistry[T];
+/**
+ * Generic type guard for any part type
+ */
+declare function isPartType<T extends keyof PartsRegistry>(part: MessagePart, type: T): part is PartsRegistry[T];
+/**
+ * Type guard for TextPart
+ */
+declare function isTextPart(part: MessagePart): part is TextPart;
+/**
+ * Type guard for ToolCallPart
+ */
+declare function isToolCallPart(part: MessagePart): part is ToolCallPart;
+/**
+ * Type guard for SourcePart
+ */
+declare function isSourcePart(part: MessagePart): part is SourcePart;
+/**
+ * Type guard for FilePart
+ */
+declare function isFilePart(part: MessagePart): part is FilePart;
+/**
+ * Type guard for UIPart
+ */
+declare function isUIPart(part: MessagePart): part is UIPart;
+/**
+ * Type guard for ReasoningPart
+ */
+declare function isReasoningPart(part: MessagePart): part is ReasoningPart;
+/**
+ * Complete message structure
+ */
+interface ChatMessage {
+    id: string;
+    role: MessageRole;
+    parts: MessagePart[];
+    status: MessageStatus;
+    createdAt: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Create a new text message
+ */
+declare function createTextMessage(role: MessageRole, content: string, format?: 'markdown' | 'plain'): ChatMessage;
+/**
+ * Create a new empty streaming message
+ */
+declare function createStreamingMessage(role: 'assistant' | 'agent'): ChatMessage;
+
+/**
+ * Transport layer protocol for chat communication
+ * Inspired by Vercel AI SDK 5.0+ transport architecture
+ */
+
+/**
+ * Stream part - chunks of data received during streaming
+ */
+type StreamPart = TextStreamPart | ToolCallStreamPart | UIStreamPart | ReasoningStreamPart | DoneStreamPart | ErrorStreamPart;
+/**
+ * Text content stream part
+ */
+interface TextStreamPart {
+    type: 'text';
+    content: string;
+    format?: 'markdown' | 'plain';
+}
+/**
+ * Tool call stream part
+ */
+interface ToolCallStreamPart {
+    type: 'tool-call';
+    toolCallId?: string;
+    toolName: string;
+    args: Record<string, any>;
+}
+/**
+ * UI component stream part
+ */
+interface UIStreamPart {
+    type: 'ui';
+    component: string;
+    props: Record<string, any>;
+}
+/**
+ * Reasoning stream part
+ */
+interface ReasoningStreamPart {
+    type: 'reasoning';
+    content: string;
+}
+/**
+ * Stream completion marker
+ */
+interface DoneStreamPart {
+    type: 'done';
+}
+/**
+ * Error stream part
+ */
+interface ErrorStreamPart {
+    type: 'error';
+    error: string;
+}
+/**
+ * Transport interface for sending messages and receiving stream
+ * This is the key abstraction that allows different implementations:
+ * - HTTP streaming
+ * - WebSocket
+ * - Server-Sent Events (SSE)
+ * - Mock for testing
+ */
+interface ChatTransport {
+    /**
+     * Send messages and return async generator of stream parts
+     *
+     * @param messages - Full conversation history (or context window)
+     * @returns Async generator yielding stream parts
+     */
+    send(messages: ChatMessage[]): AsyncGenerator<StreamPart>;
+    /**
+     * Abort the current stream (optional)
+     */
+    abort?(): void;
+}
+/**
+ * Simple mock transport for testing
+ */
+declare class MockTransport implements ChatTransport {
+    private aborted;
+    send(messages: ChatMessage[]): AsyncGenerator<StreamPart>;
+    abort(): void;
+}
+
+export { type BasePart, type BuiltinParts, type ChatMessage, type ChatTransport, type CustomParts, type DoneStreamPart, type ErrorStreamPart, type FilePart, type MessagePart, type MessageRole, type MessageStatus, MockTransport, type PartByType, type PartsRegistry, type ReasoningPart, type ReasoningStreamPart, type SourcePart, type SourceType, type StreamPart, TOOL_CALL_STATES, type TextPart, type TextStreamPart, type ToolCallPart, type ToolCallState, type ToolCallStreamPart, type UIPart, type UIStreamPart, createStreamingMessage, createTextMessage, isFilePart, isPartType, isReasoningPart, isSourcePart, isTextPart, isToolCallPart, isUIPart };

package/dist/protocol/index.js

@@ -0,0 +1,3 @@
+export { MockTransport, TOOL_CALL_STATES, createStreamingMessage, createTextMessage, isFilePart, isPartType, isReasoningPart, isSourcePart, isTextPart, isToolCallPart, isUIPart } from '../chunk-FOTOSDBV.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@incremark/chat-core",
+  "version": "0.4.0-alpha.1",
+  "description": "Framework-agnostic core library for building AI chat interfaces with incremental rendering support.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol/index.d.ts",
+      "import": "./dist/protocol/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.16"
+  },
+  "keywords": [
+    "ai",
+    "chat",
+    "llm",
+    "streaming",
+    "incremental",
+    "framework-agnostic",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingshuaishuai/incremark.git",
+    "directory": "packages/chat-core"
+  },
+  "dependencies": {
+    "nanoid": "^5.1.6"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run -- --coverage"
+  }
+}