@langgraph-js/ui 3.0.1 → 3.1.0

package/src/memory/fulltext-search.ts

@@ -1,191 +0,0 @@
-// minisearch-idb-chinese-search.ts
-
-import MiniSearch, { AsPlainObject, type Options, type SearchOptions, type SearchResult } from "minisearch";
-import { openDB, type IDBPDatabase } from "idb";
-import { BaseDB, BaseDBConfig } from "./BaseDB";
-import { MemoryRecord } from "./db";
-
-/**
- * 搜索服务配置接口
- */
-export interface FullTextSearchConfig extends BaseDBConfig {
-    miniSearchOptions?: Partial<Options<MemoryRecord>>;
-}
-
-// 默认配置
-const DEFAULT_CONFIG: Required<FullTextSearchConfig> = {
-    dbName: "minisearch_memory_db",
-    dbVersion: 1,
-    storeName: "memory",
-    miniSearchOptions: {
-        fields: ["text", "path", "tags", "referencePath"],
-        storeFields: ["text", "path", "tags", "referencePath"],
-        tokenize: chineseWordSegmenter,
-    },
-};
-
-// --- 1. 中文分词器 ---
-/**
- * 中文分词器，使用 Intl.Segmenter 将中文文本分割成词语。
- * @param text 需要分词的中文文本。
- * @returns 词语数组。
- */
-function chineseWordSegmenter(text: string): string[] {
-    // 移除所有空格，因为中文词语之间通常没有空格
-    const cleanText = text.replace(/ /g, "");
-
-    // 使用 Intl.Segmenter 进行词语分词
-    // 'zh-CN' 或 'cn' 都可以表示中文（中国大陆）
-    const segmenter = new Intl.Segmenter("zh-CN", { granularity: "word" });
-
-    // 获取分词结果并只保留词语内容
-    const segments = Array.from(segmenter.segment(cleanText)).map((item) => item.segment);
-
-    return segments;
-}
-
-export class FullTextSearchService extends BaseDB<MemoryRecord> {
-    private miniSearch!: MiniSearch<MemoryRecord>;
-    protected config: Required<FullTextSearchConfig>;
-    protected db!: IDBPDatabase;
-    constructor(config?: FullTextSearchConfig) {
-        const mergedConfig = {
-            ...DEFAULT_CONFIG,
-            ...config,
-            miniSearchOptions: {
-                ...DEFAULT_CONFIG.miniSearchOptions,
-                ...(config?.miniSearchOptions || {}),
-            },
-        };
-        super(mergedConfig);
-        this.config = mergedConfig;
-    }
-
-    public async initialize(): Promise<void> {
-        if (this.isInitialized) {
-            return;
-        }
-
-        const { storeName } = this.config;
-        this.db = await openDB(this.config.dbName, this.config.dbVersion, {
-            upgrade(db) {
-                if (!db.objectStoreNames.contains(storeName)) {
-                    db.createObjectStore(storeName, { keyPath: "id", autoIncrement: true });
-                }
-                if (!db.objectStoreNames.contains("minisearch_index")) {
-                    db.createObjectStore("minisearch_index");
-                }
-            },
-        });
-
-        // 确保 miniSearchOptions 包含所有必需的字段
-        const miniSearchOptions: Options<MemoryRecord> = {
-            fields: this.config.miniSearchOptions.fields || ["text"],
-            storeFields: this.config.miniSearchOptions.storeFields || ["text"],
-            tokenize: this.config.miniSearchOptions.tokenize || chineseWordSegmenter,
-        };
-
-        this.miniSearch = new MiniSearch(miniSearchOptions);
-
-        try {
-            const savedIndex = await this.loadMiniSearchIndex();
-            if (savedIndex) {
-                console.log(savedIndex);
-                this.miniSearch = await MiniSearch.loadJSAsync(savedIndex, miniSearchOptions);
-                console.log("MiniSearch index loaded from IndexedDB.");
-            } else {
-                console.log("No saved index found, building from documents...");
-                const allDocs = await this.getAll();
-                if (allDocs.length > 0) {
-                    this.miniSearch.addAll(allDocs);
-                    await this.saveMiniSearchIndex(this.miniSearch.toJSON());
-                    console.log(`MiniSearch index built from ${allDocs.length} documents and saved.`);
-                } else {
-                    console.log("No documents found, index is empty.");
-                }
-            }
-            this.isInitialized = true;
-        } catch (error) {
-            console.error("Failed to initialize FullTextSearchService:", error);
-            throw error;
-        }
-    }
-
-    public async insert(doc: Partial<MemoryRecord>): Promise<number> {
-        const transaction = this.db.transaction(this.config.storeName, "readwrite");
-        const store = transaction.objectStore(this.config.storeName);
-        const newDoc: MemoryRecord = { ...doc } as MemoryRecord;
-
-        const id = await store.add(newDoc);
-        newDoc.id = Number(id);
-
-        await transaction.done;
-
-        this.miniSearch.add(newDoc);
-        await this.saveMiniSearchIndex(this.miniSearch.toJSON());
-
-        return newDoc.id;
-    }
-
-    public async update(id: number, doc: Partial<MemoryRecord>): Promise<void> {
-        const transaction = this.db.transaction(this.config.storeName, "readwrite");
-        const store = transaction.objectStore(this.config.storeName);
-        const updatedDoc = { ...doc, id } as MemoryRecord;
-        await store.put(updatedDoc);
-
-        // MiniSearch 没有 update 方法，我们需要先删除再添加
-        const existingDoc = await store.get(id);
-        if (existingDoc) {
-            this.miniSearch.remove(existingDoc);
-        }
-        this.miniSearch.add(updatedDoc);
-        await this.saveMiniSearchIndex(this.miniSearch.toJSON());
-    }
-
-    public async delete(id: number): Promise<void> {
-        const transaction = this.db.transaction(this.config.storeName, "readwrite");
-        const store = transaction.objectStore(this.config.storeName);
-        const doc = await store.get(id);
-        if (doc) {
-            this.miniSearch.remove(doc);
-        }
-        await store.delete(id);
-        await this.saveMiniSearchIndex(this.miniSearch.toJSON());
-    }
-
-    public async query(query: string, options?: SearchOptions & { limit?: number }): Promise<MemoryRecord[]> {
-        const results = this.miniSearch.search(query, options);
-        // 将 SearchResult 转换为 MemoryRecord
-        return results.slice(0, options?.limit ?? 5).map((i) => {
-            const { id, text, ...rest } = i;
-            return {
-                id,
-                text,
-                tags: rest.tags,
-                path: rest.path,
-                type: rest.type,
-                score: Math.round(i.score),
-                referencePath: rest.referencePath,
-            } as unknown as MemoryRecord;
-        });
-    }
-
-    public async get(id: number): Promise<MemoryRecord | undefined> {
-        return this.db.transaction(this.config.storeName, "readonly").objectStore(this.config.storeName).get(id);
-    }
-
-    public async getAll(): Promise<MemoryRecord[]> {
-        return this.db.transaction(this.config.storeName, "readonly").objectStore(this.config.storeName).getAll();
-    }
-
-    private async loadMiniSearchIndex(): Promise<AsPlainObject | null> {
-        return this.db.transaction("minisearch_index", "readonly").objectStore("minisearch_index").get("indexData");
-    }
-
-    private async saveMiniSearchIndex(indexData: AsPlainObject): Promise<void> {
-        const tx = this.db.transaction("minisearch_index", "readwrite");
-        const store = tx.objectStore("minisearch_index");
-        await store.put(indexData, "indexData");
-        await tx.done;
-    }
-}

package/src/memory/index.ts

@@ -1,4 +0,0 @@
-export * from "./tools";
-export * from "./db";
-export * from "./fulltext-search";
-export * from "./BaseDB";

package/src/memory/tools.ts

@@ -1,170 +0,0 @@
-import { createToolUI } from "@langgraph-js/sdk";
-import type { BaseDB, MemoryRecord } from "./BaseDB";
-
-// 获取命名空间（这里简化为标识符）
-function getNamespace(userId?: string): string {
-    return userId || "default";
-}
-
-// 确保 JSON 可序列化
-function ensureJsonSerializable(content: any): any {
-    if (typeof content === "string" || typeof content === "number" || typeof content === "boolean" || content === null) {
-        return content;
-    }
-    if (Array.isArray(content) || typeof content === "object") {
-        return content;
-    }
-    return String(content);
-}
-
-export const createMemoryTool = (store: BaseDB<MemoryRecord>) => {
-    return {
-        manageMemory: createToolUI({
-            name: "manage_memory",
-            description: `这是一个**结构化**工具，用于**管理跨对话的持久化记忆**，以保留上下文、用户偏好和学习到的见解。它支持**创建、更新、检索和删除记忆条目**，从而在互动中保持连续性和个性化。
-
-### 你需要记录记忆的场景
-
-1. 请你第一时间敏锐记录下用户的细节偏好，包括对话风格、习惯、内容、方式等。
-2. 记录下高价值的问答，比如用户对你的纠正、任务过程中的关键信息
-
-
-### 核心功能
-
-该工具具备以下关键能力：
-
-* **记忆生命周期管理：** 对记忆条目进行**全生命周期管理**，包括创建、更新、检索和删除。
-* **分段与标签支持：** 支持**分段或打标签的记忆条目**，方便分类和高效检索。
-* **存储选项灵活：** 提供**临时和永久两种存储选项**，以适应不同类型信息的存储需求。
-`,
-            parameters: [
-                {
-                    name: "path",
-                    type: "string",
-                    description: "记忆路径（创建时需要）",
-                },
-                {
-                    name: "tags",
-                    type: "string[]",
-                    description: "记忆标签（创建或更新时需要）",
-                },
-                {
-                    name: "content",
-                    type: "string",
-                    description: "记忆内容（创建或更新时需要）",
-                },
-                {
-                    name: "action",
-                    type: "string",
-                    enum: ["create", "update", "delete"],
-                    description: "操作类型：create（创建）、update（更新）、delete（删除）",
-                },
-                {
-                    name: "id",
-                    type: "string",
-                    description: "记忆ID（更新或删除时需要，创建时会自动生成）",
-                    required: false,
-                },
-                {
-                    name: "referencePath",
-                    type: "string",
-                    description: "引用文档的 URL",
-                    required: false,
-                },
-            ],
-            handler: async (args) => {
-                const { content, action, id, tags, path, referencePath } = args;
-
-                if ((action === "delete" || action === "update") && !id) {
-                    throw new Error("删除或更新记忆时必须提供记忆ID");
-                }
-
-                if ((action === "create" || action === "update") && !content) {
-                    throw new Error("创建或更新记忆时必须提供内容");
-                }
-
-                try {
-                    if (action === "delete") {
-                        await store.delete(Number(id));
-                        return `已删除记忆 ${id}`;
-                    }
-
-                    const memoryData: MemoryRecord = {
-                        text: content as string,
-                        content: ensureJsonSerializable(content),
-                        createdAt: new Date().toISOString(),
-                        updatedAt: new Date().toISOString(),
-                        namespace: getNamespace(),
-                        tags: tags as string[],
-                        path: path as string,
-                        type: "document",
-                        referencePath: referencePath as string,
-                    };
-
-                    if (action === "create") {
-                        const key = await store.insert(memoryData);
-                        return `已创建记忆 ${key}`;
-                    } else {
-                        await store.update(Number(id), memoryData);
-                        return `已更新记忆 ${id}`;
-                    }
-                } catch (error) {
-                    throw new Error(`记忆操作失败: ${error}`);
-                }
-            },
-        }),
-        searchMemory: createToolUI({
-            name: "search_memory",
-            description: `搜索长期记忆中的相关信息，帮助维护对话上下文`,
-            parameters: [
-                {
-                    name: "query",
-                    type: "string",
-                    description: "请使用中文关键词进行搜索",
-                },
-                {
-                    name: "tags",
-                    type: "string[]",
-                    description: "记忆标签",
-                    required: false,
-                },
-                {
-                    name: "path",
-                    type: "string",
-                    description: "记忆路径，memory://user_id/path/to/memory_name",
-                    required: false,
-                },
-                {
-                    name: "limit",
-                    type: "number",
-                    description: "返回结果的最大数量（默认10）",
-                    required: false,
-                },
-            ],
-            handler: async (args) => {
-                const { query, limit = 10, tags, path } = args;
-
-                if (!query || (typeof query === "string" && query.trim().length === 0)) {
-                    throw new Error("搜索查询不能为空");
-                }
-
-                try {
-                    const results = await store.query(query.toString(), {
-                        limit: limit as number,
-                    });
-
-                    return {
-                        query: query.toString(),
-                        results: results,
-                        total: results.length,
-                        limit: Number(limit),
-                    };
-                } catch (error) {
-                    throw new Error(`搜索记忆失败: ${error}`);
-                }
-            },
-        }),
-    };
-};
-
-export { getNamespace, ensureJsonSerializable };

package/src/sonner/Toaster.tsx

@@ -1,117 +0,0 @@
-import React from "react";
-import { useStore } from "@nanostores/react";
-import { toasts, removeToast } from "./toast";
-import { Toast } from "./types";
-
-const ToastItem: React.FC<{ toast: Toast }> = ({ toast }: { toast: Toast }) => {
-    const getToastStyles = (type: Toast["type"]) => {
-        const baseStyles = "flex items-start gap-3 p-4 rounded-2xl shadow-sm backdrop-blur-md border transition-all duration-300 max-w-sm";
-
-        switch (type) {
-            case "success":
-                return `${baseStyles} bg-white/90 dark:bg-gray-800/90 text-green-700 dark:text-green-300 border-green-200/50 dark:border-green-800/50`;
-            case "error":
-                return `${baseStyles} bg-white/90 dark:bg-gray-800/90 text-red-700 dark:text-red-300 border-red-200/50 dark:border-red-800/50`;
-            case "warning":
-                return `${baseStyles} bg-white/90 dark:bg-gray-800/90 text-orange-700 dark:text-orange-300 border-orange-200/50 dark:border-orange-800/50`;
-            case "info":
-            default:
-                return `${baseStyles} bg-white/90 dark:bg-gray-800/90 text-blue-700 dark:text-blue-300 border-blue-200/50 dark:border-blue-800/50`;
-        }
-    };
-
-    const getIcon = (type: Toast["type"]) => {
-        const iconClasses = "w-5 h-5 flex-shrink-0 mt-0.5 opacity-80";
-
-        switch (type) {
-            case "success":
-                return (
-                    <svg className={iconClasses} fill="currentColor" viewBox="0 0 20 20">
-                        <path
-                            fillRule="evenodd"
-                            d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z"
-                            clipRule="evenodd"
-                        />
-                    </svg>
-                );
-            case "error":
-                return (
-                    <svg className={iconClasses} fill="currentColor" viewBox="0 0 20 20">
-                        <path
-                            fillRule="evenodd"
-                            d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z"
-                            clipRule="evenodd"
-                        />
-                    </svg>
-                );
-            case "warning":
-                return (
-                    <svg className={iconClasses} fill="currentColor" viewBox="0 0 20 20">
-                        <path
-                            fillRule="evenodd"
-                            d="M8.257 3.099c.765-1.36 2.722-1.36 3.486 0l5.58 9.92c.75 1.334-.213 2.98-1.742 2.98H4.42c-1.53 0-2.493-1.646-1.743-2.98l5.58-9.92zM11 13a1 1 0 11-2 0 1 1 0 012 0zm-1-8a1 1 0 00-1 1v3a1 1 0 002 0V6a1 1 0 00-1-1z"
-                            clipRule="evenodd"
-                        />
-                    </svg>
-                );
-            case "info":
-            default:
-                return (
-                    <svg className={iconClasses} fill="currentColor" viewBox="0 0 20 20">
-                        <path
-                            fillRule="evenodd"
-                            d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7-4a1 1 0 11-2 0 1 1 0 012 0zM9 9a1 1 0 000 2v3a1 1 0 001 1h1a1 1 0 100-2v-3a1 1 0 00-1-1H9z"
-                            clipRule="evenodd"
-                        />
-                    </svg>
-                );
-        }
-    };
-
-    return (
-        <div className={getToastStyles(toast.type)}>
-            <div className="flex-shrink-0">{getIcon(toast.type)}</div>
-
-            <div className="flex-1 min-w-0">
-                <div className="text-sm font-medium">{toast.title}</div>
-                {toast.description && <div className="text-sm opacity-90 mt-1">{toast.description}</div>}
-                {toast.action && (
-                    <button
-                        onClick={toast.action.onClick}
-                        className="text-sm font-medium text-current/80 hover:text-current mt-2 px-2 py-1 rounded-md hover:bg-white/10 transition-colors focus:outline-none focus:ring-2 focus:ring-current/50"
-                    >
-                        {toast.action.label}
-                    </button>
-                )}
-            </div>
-
-            <button
-                onClick={() => removeToast(toast.id)}
-                className="flex-shrink-0 ml-2 p-1 rounded-full opacity-60 hover:opacity-100 hover:bg-black/10 dark:hover:bg-white/20 transition-all focus:outline-none focus:ring-2 focus:ring-current/50"
-                aria-label="关闭通知"
-            >
-                <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
-                </svg>
-            </button>
-        </div>
-    );
-};
-
-export const Toaster: React.FC = () => {
-    const currentToasts = useStore(toasts);
-
-    if (currentToasts.length === 0) {
-        return null;
-    }
-
-    return (
-        <div className="fixed top-4 right-4 z-50 space-y-2 pointer-events-none">
-            {currentToasts.map((toast: Toast) => (
-                <div key={toast.id} className="pointer-events-auto animate-in slide-in-from-right-2 fade-in duration-200">
-                    <ToastItem toast={toast} />
-                </div>
-            ))}
-        </div>
-    );
-};

package/src/sonner/index.ts

@@ -1,3 +0,0 @@
-export { Toaster } from "./Toaster";
-export { toast, removeToast, clearToasts } from "./toast";
-export type { Toast, ToastType, ToastOptions } from "./types";

package/src/sonner/toast.ts

@@ -1,50 +0,0 @@
-import { atom } from "nanostores";
-import { Toast, ToastType, ToastOptions } from "./types";
-
-let toastCounter = 0;
-
-export const toasts = atom<Toast[]>([]);
-
-const createToast = (type: ToastType, title: string, description?: string, options?: ToastOptions): string => {
-    const id = `toast-${++toastCounter}`;
-
-    const toast: Toast = {
-        id,
-        type,
-        title,
-        description,
-        duration: options?.duration ?? 4000,
-        action: options?.action,
-    };
-
-    toasts.set([...toasts.get(), toast]);
-
-    // Auto remove after duration
-    if (toast.duration && toast.duration > 0) {
-        setTimeout(() => {
-            removeToast(id);
-        }, toast.duration);
-    }
-
-    return id;
-};
-
-export const toast = {
-    success: (title: string, description?: string, options?: ToastOptions) => createToast("success", title, description, options),
-
-    error: (title: string, description?: string, options?: ToastOptions) => createToast("error", title, description, options),
-
-    warning: (title: string, description?: string, options?: ToastOptions) => createToast("warning", title, description, options),
-
-    info: (title: string, description?: string, options?: ToastOptions) => createToast("info", title, description, options),
-
-    custom: (type: ToastType, title: string, description?: string, options?: ToastOptions) => createToast(type, title, description, options),
-};
-
-export const removeToast = (id: string) => {
-    toasts.set(toasts.get().filter((toast) => toast.id !== id));
-};
-
-export const clearToasts = () => {
-    toasts.set([]);
-};

package/src/sonner/types.ts

@@ -1,21 +0,0 @@
-export type ToastType = "success" | "error" | "warning" | "info";
-
-export interface Toast {
-    id: string;
-    type: ToastType;
-    title: string;
-    description?: string;
-    duration?: number;
-    action?: {
-        label: string;
-        onClick: () => void;
-    };
-}
-
-export interface ToastOptions {
-    duration?: number;
-    action?: {
-        label: string;
-        onClick: () => void;
-    };
-}