@aipanel/core 1.2.0-beta.0

package/es/process-logger.mjs

@@ -0,0 +1,193 @@
+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);
+const DEFAULT_MAX_SIZE = 500;
+class ProcessLogBuffer {
+  constructor(options = {}) {
+    __publicField(this, "buffer", []);
+    __publicField(this, "maxSize");
+    __publicField(this, "enabled", true);
+    __publicField(this, "originalConsole", null);
+    this.maxSize = options.maxSize ?? DEFAULT_MAX_SIZE;
+    this.enabled = options.enabled ?? true;
+  }
+  /**
+   * 启动 console 拦截
+   */
+  intercept() {
+    if (this.originalConsole) {
+      return;
+    }
+    this.originalConsole = {
+      log: console.log,
+      info: console.info,
+      warn: console.warn,
+      error: console.error,
+      debug: console.debug
+    };
+    console.log = this.createInterceptor("log", this.originalConsole.log);
+    console.info = this.createInterceptor("info", this.originalConsole.info);
+    console.warn = this.createInterceptor("warn", this.originalConsole.warn);
+    console.error = this.createInterceptor("error", this.originalConsole.error);
+    console.debug = this.createInterceptor("debug", this.originalConsole.debug);
+  }
+  /**
+   * 停止拦截，恢复原始 console
+   */
+  restore() {
+    if (!this.originalConsole) {
+      return;
+    }
+    console.log = this.originalConsole.log;
+    console.info = this.originalConsole.info;
+    console.warn = this.originalConsole.warn;
+    console.error = this.originalConsole.error;
+    console.debug = this.originalConsole.debug;
+    this.originalConsole = null;
+  }
+  /**
+   * 创建拦截器函数
+   */
+  createInterceptor(level, original) {
+    return (...args) => {
+      original.apply(console, args);
+      if (this.enabled) {
+        this.addEntry({
+          level,
+          message: this.serializeArgs(args),
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          source: "console"
+        });
+      }
+    };
+  }
+  /**
+   * 序列化参数为字符串
+   */
+  serializeArgs(args) {
+    return args.map((arg) => {
+      if (typeof arg === "string") {
+        return arg;
+      }
+      if (typeof arg === "number" || typeof arg === "boolean") {
+        return String(arg);
+      }
+      if (arg === null) {
+        return "null";
+      }
+      if (arg === void 0) {
+        return "undefined";
+      }
+      if (typeof arg === "object") {
+        try {
+          return JSON.stringify(arg, null, 2);
+        } catch {
+          return String(arg);
+        }
+      }
+      return String(arg);
+    }).join(" ");
+  }
+  /**
+   * 添加日志条目
+   */
+  addEntry(entry) {
+    if (!this.enabled) {
+      return;
+    }
+    if (this.buffer.length >= this.maxSize) {
+      this.buffer.shift();
+    }
+    this.buffer.push(entry);
+  }
+  /**
+   * 添加 Provider stdout 日志
+   */
+  addProviderStdout(message) {
+    this.addEntry({
+      level: "info",
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      source: "provider-stdout"
+    });
+  }
+  /**
+   * 添加 Provider stderr 日志
+   */
+  addProviderStderr(message) {
+    this.addEntry({
+      level: "error",
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      source: "provider-stderr"
+    });
+  }
+  /**
+   * 获取日志
+   * @param options 过滤选项
+   */
+  getLogs(options = {}) {
+    let logs = [...this.buffer];
+    if (options.level) {
+      const levels = Array.isArray(options.level) ? options.level : [options.level];
+      logs = logs.filter((log) => levels.includes(log.level));
+    }
+    if (options.source) {
+      logs = logs.filter((log) => log.source === options.source);
+    }
+    if (options.since) {
+      const sinceDate = new Date(options.since);
+      logs = logs.filter((log) => new Date(log.timestamp) >= sinceDate);
+    }
+    if (options.limit && options.limit > 0) {
+      logs = logs.slice(-options.limit);
+    }
+    return logs;
+  }
+  /**
+   * 清空缓冲区
+   */
+  clear() {
+    this.buffer = [];
+  }
+  /**
+   * 获取缓冲区大小
+   */
+  size() {
+    return this.buffer.length;
+  }
+  /**
+   * 启用/禁用捕获
+   */
+  setEnabled(enabled) {
+    this.enabled = enabled;
+  }
+  /**
+   * 获取是否启用
+   */
+  isEnabled() {
+    return this.enabled;
+  }
+}
+let globalBuffer = null;
+function getProcessLogBuffer(options) {
+  if (!globalBuffer) {
+    globalBuffer = new ProcessLogBuffer(options);
+  }
+  return globalBuffer;
+}
+function initProcessLogCapture(options) {
+  const buffer = getProcessLogBuffer(options);
+  buffer.intercept();
+  return buffer;
+}
+function stopProcessLogCapture() {
+  if (globalBuffer) {
+    globalBuffer.restore();
+  }
+}
+export {
+  getProcessLogBuffer,
+  initProcessLogCapture,
+  stopProcessLogCapture
+};

package/es/provider.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Web Provider 适配层契约
+ *
+ * 核心层只依赖本文件定义的通用协议；具体 Web UI（Provider）的实现细节
+ * 全部封装在 WebProvider 实现内。新增 Provider 时只需实现本接口。
+ */
+/** 通用会话模型（Provider 私有会话 → 归一化） */
+export interface ChatSession {
+    /** 会话 ID */
+    id: string;
+    /** 会话标题 */
+    title: string;
+    /** 创建时间戳 */
+    createdAt?: number;
+    /** 更新时间戳 */
+    updatedAt?: number;
+    /** 是否已归档 */
+    archived?: boolean;
+    /** 父会话 ID（subagent 会话才有） */
+    parentId?: string;
+    /**
+     * 会话打开 URL（由 buildSessionUrl 填充）。
+     * 无 deepLink 能力时所有会话共用应用壳 URL（同一值），切换会话靠 FOCUS_SESSION 消息。
+     */
+    url?: string;
+}
+/** 会话运行状态 */
+export type SessionStatus = "idle" | "running" | "streaming" | "completed";
+/** Provider 事件（Provider 私有事件 → 归一化，客户端只消费这些事件） */
+export type ProviderEvent = {
+    type: "connected";
+}
+/** 会话信息更新（标题/摘要等） */
+ | {
+    type: "session.updated";
+    session: ChatSession;
+}
+/** 会话运行状态变化 */
+ | {
+    type: "session.status";
+    sessionId: string;
+    status: SessionStatus;
+}
+/** 会话思考状态（由 adapter 自行推导） */
+ | {
+    type: "thinking";
+    sessionId: string;
+    thinking: boolean;
+};
+/** Provider 环境检查结果 */
+export interface ProviderEnvironmentInfo {
+    /** 环境是否就绪 */
+    ok: boolean;
+    /** Provider 版本号 */
+    version?: string;
+    /** 未就绪时的说明（如安装指引） */
+    message?: string;
+}
+/** Provider 启动选项（核心编排层提供的通用运行参数） */
+export interface ProviderStartOptions {
+    /** 服务端口 */
+    port: number;
+    /** 服务主机名 */
+    hostname: string;
+    /** 工作目录 */
+    cwd: string;
+    /** CORS 允许的源 */
+    corsOrigins: string[];
+    /** 项目对应的 Vite 端口（用于回连 Vite 服务） */
+    vitePort: number;
+    /** 上下文 API URL（核心层提供的回连地址） */
+    contextApiUrl?: string;
+    /** 进程日志 API URL（核心层提供的回连地址） */
+    logsApiUrl?: string;
+    /** Vue DevTools API 地址（核心层提供的回连地址） */
+    vueDevtoolsApiUrl?: string;
+    /** 启用 verbose 模式 */
+    verbose?: boolean;
+}
+/**
+ * Provider 初始化上下文（核心层动态加载 Provider 时传入）
+ * Provider 专属配置通过 options 原样传递，schema 由 Provider 自行解析。
+ */
+export interface ProviderInitContext {
+    /** 服务主机名 */
+    hostname: string;
+    /** Chrome DevTools Protocol 端口 */
+    chromeDevtoolsPort: number;
+    /** 实际 Web 端口读取器 */
+    getWebPort(): number;
+    /** 实际代理端口读取器 */
+    getProxyPort(): number;
+    /** 用户完整插件配置（宽松对象，Provider 自解析所需字段） */
+    options?: Record<string, unknown>;
+}
+/** Provider 启动结果 */
+export interface ProviderStartResult {
+    /** 就绪后的服务 URL */
+    url: string;
+    /** 进程句柄（供编排层做就绪等待与退出检测，不透明） */
+    processHandle?: unknown;
+}
+/** Provider 初始化配置（主题/语言/设置等，schema 由 Provider 定义） */
+export interface ProviderConfig {
+    /** 主题模式 */
+    theme?: "light" | "dark" | "auto";
+    /** 界面语言 */
+    language?: string;
+    /** Provider 内部设置 */
+    settings?: unknown;
+    [key: string]: unknown;
+}
+/** Provider 能力描述（客户端据此自适应行为） */
+export interface ProviderCapabilities {
+    /**
+     * 会话是否支持 URL 深链。
+     * true（默认）：iframe 每次切换会话重载，src 直达该会话；
+     * false（SPA 型无深链 Provider）：iframe 保持应用壳 URL 不重载，
+     * 切换会话通过 FOCUS_SESSION 消息完成。
+     */
+    deepLink?: boolean;
+    /**
+     * 是否支持代码审查面板（挂件右上角 </> 按钮）。
+     * true：点击按钮向 iframe 发送 REVIEW_PANEL_TOGGLE，由 Provider 渲染审查面板；
+     * 缺省/false：不支持，客户端隐藏该按钮，避免展示无功能的入口。
+     */
+    reviewPanel?: boolean;
+}
+/**
+ * Web Provider 适配器接口
+ */
+export interface WebProvider {
+    /** 唯一标识（对应插件配置的 provider 字段） */
+    readonly id: string;
+    /** 展示名称 */
+    readonly displayName: string;
+    /** 校验运行环境（CLI 是否安装、版本） */
+    checkEnvironment(): Promise<ProviderEnvironmentInfo>;
+    /** 启动 Web 服务（含运行环境准备），返回就绪 URL */
+    start(options: ProviderStartOptions): Promise<ProviderStartResult>;
+    /** 停止服务 */
+    stop(): Promise<void>;
+    /** 清理孤儿进程（上次退出残留的 provider 进程），返回清理数量（可选） */
+    killOrphans?(): Promise<number>;
+    /** 会话管理（归一化到 ChatSession，过滤逻辑在此内部完成） */
+    listSessions(projectDir: string): Promise<ChatSession[]>;
+    createSession(projectDir: string, title?: string): Promise<ChatSession>;
+    /** 可选：部分 Provider 无删除语义；core 不支持时隐藏删除入口 */
+    deleteSession?(sessionId: string): Promise<void>;
+    /** 会话打开 URL（iframe src）；无 deepLink 能力时返回应用壳 URL（所有会话相同） */
+    buildSessionUrl(projectDir: string, sessionId: string): string;
+    /** Provider 能力描述（客户端自适应行为；缺省按 deepLink=true 处理） */
+    readonly capabilities?: ProviderCapabilities;
+    /** 事件订阅：把 Provider 私有事件归一化为 ProviderEvent；返回取消订阅函数 */
+    subscribeEvents(handler: (e: ProviderEvent) => void): () => void;
+    /** 代理注入到 HTML 的 Provider 侧桥接脚本（可选） */
+    bridgeScript?: string;
+    /** Provider 初始化配置（主题/语言/设置，schema 由 Provider 定义） */
+    applyConfig?(config: ProviderConfig): void;
+}

package/es/types.d.ts

@@ -0,0 +1,275 @@
+/**
+ * 通用类型（Provider 无关）
+ * Provider 专属类型已下沉至 @aipanel/provider-opencode。
+ */
+/**
+ * 展示模式类型
+ */
+export type DisplayMode = "bubble" | "split" | "auto" | "extension" | "extension-selector";
+/**
+ * 分屏模式配置
+ */
+export interface SplitModeOptions {
+    /** 面板宽度，默认 500 */
+    width?: number;
+    /** 最小宽度，默认 400 */
+    minWidth?: number;
+    /** 最大宽度，默认 800 */
+    maxWidth?: number;
+    /** 是否可调整宽度，默认 true */
+    resizable?: boolean;
+    /** 是否收缩主页面，默认 true */
+    shrinkPage?: boolean;
+    /** 默认是否展开，默认 true */
+    defaultOpen?: boolean;
+    /** 面板位置，默认 'right' */
+    position?: "left" | "right";
+}
+/**
+ * 挂件注入配置选项
+ */
+export interface WidgetOptions {
+    /** 主题模式 */
+    theme: string;
+    /** 是否自动打开 */
+    open: boolean;
+    /** 快捷键配置 */
+    hotkey?: string;
+    /** 代理服务端口 */
+    proxyPort?: number;
+    /** 代理服务主机名 */
+    proxyHost?: string;
+    /** 展示模式 */
+    displayMode?: DisplayMode;
+    /** 分屏模式配置 */
+    splitMode?: SplitModeOptions;
+    /** Vite 服务 Web 端口（扩展模式多实例场景用） */
+    vitePort?: string;
+    /** 服务实例唯一标识（扩展模式多实例隔离用） */
+    serviceInstanceId?: string;
+    /** 当前窗口 ID（扩展模式多窗口隔离用） */
+    myWindowId?: number;
+    /** Web 服务端口 */
+    webPort?: number;
+    /** 项目根目录 */
+    projectRoot?: string;
+    /** 是否开启 verbose 日志 */
+    verbose?: boolean;
+}
+/**
+ * 日志文件配置
+ * 给 Agent 提供查看外部服务日志的能力（MCP 工具配置，Provider 无关）
+ */
+export interface LogFileConfig {
+    /** 日志文件的唯一标识符，用于工具调用时指定 */
+    name: string;
+    /** 日志文件路径（绝对路径或相对于项目根目录的相对路径） */
+    path: string;
+    /** 工具描述，告诉 Agent 何时使用此工具查看日志 */
+    description: string;
+}
+/**
+ * 选中的元素信息
+ */
+export interface SelectedElement {
+    /** 文件路径 */
+    filePath: string | null;
+    /** 行号 */
+    line: number | null;
+    /** 列号 */
+    column: number | null;
+    /** 元素内部文本 */
+    innerText: string;
+    /** 元素描述（标签名+选择器） */
+    description?: string;
+}
+/**
+ * 页面上下文数据
+ */
+export interface PageContext {
+    /** 当前页面 URL */
+    url: string;
+    /** 当前页面标题 */
+    title: string;
+    /** 页面唯一标识（sessionStorage 持久化，同 Tab 刷新不变，新 Tab 重生成） */
+    sessionId?: string;
+    /** Chrome DevTools 中的 pageId，通过 MCP list_pages 解析得到 */
+    pageId?: number;
+    /** 当前活跃的浏览器 Tab ID（扩展模式），用于在多 Tab 场景下标识具体是哪个 Tab */
+    tabId?: number;
+    /** Tab 在标签栏的位置索引（从 0 开始），用于 MCP 匹配 Page ID */
+    tabIndex?: number;
+    /** 选中的元素列表 */
+    selectedElements?: SelectedElement[];
+}
+/**
+ * 服务启动任务状态
+ */
+export type ServiceStartupTask = "checking_provider" | "allocating_port" | "preparing_runtime" | "starting_web" | "waiting_web_ready" | "starting_proxy" | "warming_up_chrome" | "creating_session" | "provider_not_installed" | "web_start_timeout" | "proxy_start_failed" | "session_creation_failed" | "chrome_mcp_failed" | "ready";
+/**
+ * 服务启动任务状态映射
+ */
+export declare const SERVICE_STARTUP_TASKS: Record<ServiceStartupTask, string>;
+/**
+ * 挂件主题选项
+ */
+export type AIPanelWidgetTheme = "light" | "dark" | "auto";
+/**
+ * 服务状态
+ */
+export type ServiceStatus = "idle" | "starting" | "ready" | "partial" | "failed";
+/**
+ * Session 状态类型
+ */
+export type AIPanelSessionStatusType = "idle" | "running" | "streaming" | "completed";
+/**
+ * Session 思考状态
+ */
+export interface AIPanelSessionThinkingState {
+    thinking: boolean;
+    statusType: AIPanelSessionStatusType;
+    hasPending: boolean;
+}
+/**
+ * 挂件会话信息
+ */
+export interface AIPanelWidgetSession {
+    id: string;
+    title?: string;
+    updatedAt?: string | number | Date;
+    meta?: string;
+    directory?: string;
+    url?: string;
+}
+/**
+ * 挂件选中的元素
+ */
+export interface AIPanelSelectedElement {
+    filePath: string | null;
+    line: number | null;
+    column: number | null;
+    innerText: string;
+    description?: string;
+}
+/**
+ * 删除选中节点的载荷
+ */
+export interface AIPanelRemoveSelectedPayload {
+    element: AIPanelSelectedElement;
+    index: number;
+    source: "panel" | "bubble";
+}
+/**
+ * 挂件会话列表项
+ */
+export interface AIPanelWidgetSessionItem {
+    key: string;
+    id: string;
+    title: string;
+    meta: string;
+    active: boolean;
+    session: AIPanelWidgetSession;
+    [key: string]: any;
+}
+/**
+ * 选中元素列表项
+ */
+export interface AIPanelSelectedElementItem {
+    key: string;
+    description: string;
+    bubbleFileText: string;
+    panelFileText: string;
+    element: AIPanelSelectedElement;
+}
+/**
+ * 挂件组件 Props
+ */
+export interface AIPanelWidgetProps {
+    open?: boolean;
+    theme?: AIPanelWidgetTheme;
+    title?: string;
+    hotkeyLabel?: string;
+    selectShortcutLabel?: string;
+    selectMode?: boolean;
+    sessionListCollapsed?: boolean;
+    sessionKey?: string;
+    frameLoading?: boolean;
+    loadingSessionList?: boolean;
+    showSessionListSkeleton?: boolean;
+    showEmptyState?: boolean;
+    showError?: boolean;
+    emptyStateText?: string;
+    emptyStateActionText?: string;
+    iframeSrc?: string;
+    sessions?: AIPanelWidgetSession[];
+    currentSessionId?: string | null;
+    selectedElements?: AIPanelSelectedElement[];
+    showClearAll?: boolean;
+    selectEnabled?: boolean;
+    thinking?: boolean;
+    /** 所有 session 的状态映射 */
+    sessionStates?: Record<string, AIPanelSessionThinkingState>;
+    /** 展示模式 */
+    displayMode?: DisplayMode;
+    /** 分屏模式配置 */
+    splitMode?: SplitModeOptions;
+    /** 分屏面板宽度（运行时状态） */
+    splitPanelWidth?: number;
+    /** 隐藏悬浮气泡（浏览器扩展模式下使用） */
+    hideBubble?: boolean;
+    /** 是否支持代码审查面板（右上角 </> 按钮）；由 Provider capabilities.reviewPanel 决定 */
+    reviewPanelEnabled?: boolean;
+}
+/**
+ * 挂件组件事件
+ */
+export type AIPanelWidgetEmits = {
+    (e: "update:open", value: boolean): void;
+    (e: "update:selectMode", value: boolean): void;
+    (e: "update:sessionListCollapsed", value: boolean): void;
+    (e: "update:currentSessionId", value: string | null): void;
+    (e: "update:selectedElements", value: AIPanelSelectedElement[]): void;
+    (e: "update:theme", value: AIPanelWidgetTheme): void;
+    (e: "update:thinking", value: boolean): void;
+    (e: "update:splitPanelWidth", value: number): void;
+    (e: "toggle", value: boolean): void;
+    (e: "close"): void;
+    (e: "toggle-session-list", value: boolean): void;
+    (e: "toggle-select-mode", value: boolean): void;
+    (e: "toggle-theme", value: AIPanelWidgetTheme): void;
+    (e: "create-session"): void;
+    (e: "select-session", session: AIPanelWidgetSession): void;
+    (e: "delete-session", session: AIPanelWidgetSession): void;
+    (e: "click-selected-node", element: AIPanelSelectedElement): void;
+    (e: "remove-selected-node", payload: AIPanelRemoveSelectedPayload): void;
+    (e: "clear-selected-nodes"): void;
+    (e: "empty-action"): void;
+    (e: "frame-loaded"): void;
+    (e: "thinking-change", value: boolean): void;
+    (e: "split-panel-width-change", value: number): void;
+};
+export interface ModelInfo {
+    providerID: string;
+    modelID: string;
+    name?: string;
+    inputCost: number;
+    releaseDate: string;
+}
+/**
+ * Chrome MCP 预热错误类型
+ */
+export declare enum ChromeMcpWarmupErrorType {
+    CHROME_NOT_CONNECTED = "CHROME_NOT_CONNECTED",
+    AI_TIMEOUT = "AI_TIMEOUT",
+    AI_RESPONSE_ERROR = "AI_RESPONSE_ERROR",
+    SESSION_ERROR = "SESSION_ERROR",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Chrome MCP 预热错误
+ */
+export declare class ChromeMcpWarmupError extends Error {
+    type: ChromeMcpWarmupErrorType;
+    details?: string | undefined;
+    constructor(type: ChromeMcpWarmupErrorType, message: string, details?: string | undefined);
+}

package/es/types.mjs

@@ -0,0 +1,40 @@
+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);
+const SERVICE_STARTUP_TASKS = {
+  checking_provider: "\u68C0\u67E5 Provider \u73AF\u5883",
+  allocating_port: "\u5206\u914D\u670D\u52A1\u7AEF\u53E3",
+  preparing_runtime: "\u51C6\u5907\u8FD0\u884C\u73AF\u5883",
+  starting_web: "\u542F\u52A8 Web \u670D\u52A1",
+  waiting_web_ready: "\u7B49\u5F85\u670D\u52A1\u5C31\u7EEA",
+  starting_proxy: "\u542F\u52A8\u4EE3\u7406\u670D\u52A1",
+  warming_up_chrome: "\u9884\u70ED Chrome DevTools",
+  creating_session: "\u521B\u5EFA\u4F1A\u8BDD",
+  provider_not_installed: "Provider \u672A\u5B89\u88C5",
+  web_start_timeout: "\u670D\u52A1\u542F\u52A8\u8D85\u65F6",
+  proxy_start_failed: "\u4EE3\u7406\u670D\u52A1\u542F\u52A8\u5931\u8D25",
+  session_creation_failed: "\u4F1A\u8BDD\u521B\u5EFA\u5931\u8D25",
+  chrome_mcp_failed: "Chrome DevTools \u8FDE\u63A5\u5931\u8D25",
+  ready: "\u51C6\u5907\u5B8C\u6210"
+};
+var ChromeMcpWarmupErrorType = /* @__PURE__ */ ((ChromeMcpWarmupErrorType2) => {
+  ChromeMcpWarmupErrorType2["CHROME_NOT_CONNECTED"] = "CHROME_NOT_CONNECTED";
+  ChromeMcpWarmupErrorType2["AI_TIMEOUT"] = "AI_TIMEOUT";
+  ChromeMcpWarmupErrorType2["AI_RESPONSE_ERROR"] = "AI_RESPONSE_ERROR";
+  ChromeMcpWarmupErrorType2["SESSION_ERROR"] = "SESSION_ERROR";
+  ChromeMcpWarmupErrorType2["UNKNOWN"] = "UNKNOWN";
+  return ChromeMcpWarmupErrorType2;
+})(ChromeMcpWarmupErrorType || {});
+class ChromeMcpWarmupError extends Error {
+  constructor(type, message, details) {
+    super(message);
+    __publicField(this, "type", type);
+    __publicField(this, "details", details);
+    this.name = "ChromeMcpWarmupError";
+  }
+}
+export {
+  ChromeMcpWarmupError,
+  ChromeMcpWarmupErrorType,
+  SERVICE_STARTUP_TASKS
+};

package/es/utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview 通用工具函数
+ */
+/**
+ * 截断字符串到指定长度
+ * @param value - 要截断的字符串
+ * @param maxLength - 最大长度
+ * @returns 截断后的字符串，如果超出长度则添加省略号
+ */
+export declare function truncate(value: string, maxLength: number): string;
+/**
+ * 延迟指定时间
+ * @param ms - 毫秒数
+ * @returns Promise
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * 将字符串编码为 URL-safe Base64（与 Provider 兼容）
+ * 替换 + 为 -, / 为 _, 去掉 =
+ * @param str - 要编码的字符串
+ * @returns URL-safe Base64 编码的字符串
+ */
+export declare function base64Encode(str: string): string;
+/**
+ * 将 URL-safe Base64 解码为字符串
+ * @param base64 - URL-safe Base64 编码的字符串
+ * @returns 解码后的字符串
+ */
+export declare function base64Decode(base64: string): string;
+/**
+ * 从响应数据中提取文本内容
+ * 支持多种常见响应格式
+ */
+export declare function extractTextFromResponse(data: unknown): string | null;