@rtc-agent/component 0.2.7-rc.2 → 0.2.7-rc.4

package/dist/types/index.d.ts

@@ -0,0 +1,391 @@
+/**
+ * Shared type definitions for the RTC Agent component library.
+ *
+ * NOTE: These are UI-layer types for rendering. Once @rtc-agent/protocol
+ * is fully integrated, import canonical types from there and re-export.
+ */
+export type { ContentData, TodoItem, UserMessageContent, ScenarioRef, FileAttachment, PromptContent } from '@rtc-agent/protocol';
+import type { ContentData, TodoItem } from '@rtc-agent/protocol';
+export type { SyncStatus } from '@rtc-agent/persistence';
+import type { SyncStatus } from '@rtc-agent/persistence';
+export type MessageRole = 'user' | 'assistant' | 'system';
+/** 消息同步状态：pending=本地待同步, synced=已同步, failed=同步失败 */
+export interface Message {
+    clientId: string;
+    role: MessageRole;
+    content: ContentData;
+    timestamp: number;
+    /** Is the message still being streamed? */
+    streaming?: boolean;
+    /** 同步状态 */
+    syncStatus: SyncStatus;
+    /**
+     * 父消息的 clientId。
+     * toolcall_output 通过此字段指向对应的 toolcall_input。
+     * 映射自协议层 Message.parent_message_id（server UUID → 解析为 client_id）。
+     */
+    parentClientId?: string;
+}
+/** Session 运行状态，与 protocol SessionStatus 对齐 */
+export type SessionStatus = 'active' | 'closed' | 'idle';
+export interface Session {
+    clientId: string;
+    /** 创建此 Session 的设备 ID（来自 JWT Token），用于前端判断 RTC 请求归属 */
+    deviceId?: string;
+    title: string;
+    createdAt: number;
+    updatedAt: number;
+    todoList?: TodoItem[];
+    /**
+     * 父级 root session 的 clientId（fork 产生的子 session 指向其根 session）。
+     * 为空表示该 session 本身就是 root session。
+     */
+    rootClientSessionId?: string;
+    /** Session 运行状态：active（agent 生成中）/ idle（等待输入）/ closed（已关闭） */
+    status?: SessionStatus;
+    /** 累计纯输入 token 数（不含 cached read/write） */
+    totalInputTokens?: number;
+    /** 累计输出 token 数 */
+    totalOutputTokens?: number;
+    /** 累计总 token 数（包含所有类型） */
+    totalTokens?: number;
+    /** 当前上下文实际 token 数（压缩后回写，用于压缩进度计算） */
+    currentContextTokens?: number;
+    /** 累计缓存读取 token 数 */
+    totalCachedReadTokens?: number;
+    /** 累计缓存写入 token 数 */
+    totalCachedWriteTokens?: number;
+    /** 累计推理 token 数 */
+    totalReasoningTokens?: number;
+    /** 累计成本（美元） */
+    totalCostUsd?: number;
+    /** 最后一次 token 统计更新时间（ISO 8601） */
+    lastTokenUpdateAt?: string;
+    /** 压缩触发阈值（contextTokensLimit - autoCompactBufferTokens） */
+    compressionThreshold?: number;
+    /** 压缩进度 (0-100) */
+    compressionProgress?: number;
+    /** 距离压缩的轮次（-1 表示已超过阈值） */
+    roundsUntilCompression?: number;
+    /** 预估下一轮 token 数 */
+    estimatedNextRoundTokens?: number;
+}
+/**
+ * 会话树节点（递归结构）
+ *
+ * root session 作为"文件夹"，子 session（通过 rootClientSessionId 关联）
+ * 嵌套在 children 中。
+ */
+export interface SessionTreeNode {
+    session: Session;
+    children: SessionTreeNode[];
+    isExpanded: boolean;
+}
+export interface SessionTreeState {
+    /** 根节点列表（rootClientSessionId 为空的 session） */
+    rootNodes: SessionTreeNode[];
+}
+export interface SessionTreeActions {
+    /** 切换节点展开/折叠状态 */
+    toggleExpand(sessionId: string): void;
+    /** 展开指定节点 */
+    expand(sessionId: string): void;
+    /** 折叠指定节点 */
+    collapse(sessionId: string): void;
+    /** 重建整棵树（session 列表变化时调用） */
+    rebuildTree(sessions: Session[]): void;
+}
+/**
+ * 会话 Tab 页签
+ *
+ * 以 sessionId 为唯一标识，同一 session 只允许开一个 tab。
+ */
+export interface SessionTab {
+    /** Session clientId（唯一标识） */
+    sessionId: string;
+    /** 显示标题 */
+    title: string;
+    /** 标题是否为默认/占位值（空、"Untitled"、"New Chat"）。用于标题同步判断。 */
+    isDefault?: boolean;
+    /** 该 Session 是否尚未持久化（未发送过消息）。 */
+    isUnsaved?: boolean;
+    /** Session 运行状态：active（agent 生成中）/ idle（等待输入）/ closed（已关闭） */
+    status?: SessionStatus;
+    /** 预填到 input-area 的初始值 */
+    initialInputValue?: string;
+    /** notice-bar 显示的提示消息 */
+    noticeMessage?: string;
+    /** 每次 setTransientParams 递增，防御 Lit 脏检查跳过 */
+    initialValueVersion?: number;
+}
+export interface SessionTabState {
+    /** 打开的 tab 列表（顺序即显示顺序） */
+    tabs: SessionTab[];
+    /** 当前活动 tab 的 sessionId */
+    activeSessionId: string | null;
+}
+export interface SessionTabActions {
+    /** 打开或切换到指定 session 的 tab。`options.isUnsaved` 用于新建 unsaved draft tab。`options.skipPersist` 用于批量恢复时跳过 localStorage 写入。`options.initialInputValue` / `options.noticeMessage` 用于传递瞬态 UI 参数。 */
+    openOrActivate(sessionId: string, title: string, options?: {
+        isUnsaved?: boolean;
+        activate?: boolean;
+        skipPersist?: boolean;
+        initialInputValue?: string;
+        noticeMessage?: string;
+    }): void;
+    /** 关闭指定 tab。若关闭的是活动 tab，自动激活相邻 tab。 */
+    closeTab(sessionId: string): void;
+    /** 设置活动 tab */
+    setActiveTab(sessionId: string | null): void;
+    /** 清空所有 tab */
+    clearAll(): void;
+    /** 用 sessions 中的最新标题同步已有 Tab 的标题 */
+    updateTabTitles(sessionTitleMap: Map<string, string>): void;
+    /** 用 sessions 中的最新状态同步已有 Tab 的 status */
+    syncTabStatuses(sessionStatusMap: Map<string, SessionStatus>): void;
+    /** 将指定 tab 标记为已保存。 */
+    markSaved(sessionId: string): void;
+    /** 查找当前 unsaved tab，返回第一个 isUnsaved === true 的 tab。 */
+    findUnsavedTab(): SessionTab | undefined;
+    /** 更新指定 tab 的 session 运行状态。 */
+    updateTabStatus(sessionId: string, status: SessionStatus): void;
+    /**
+     * 从 localStorage 恢复活动 Tab
+     *
+     * 仅在首次加载后调用：把上次浏览器关闭前的 activeSessionId 重新设为活动。
+     * 若存储的 id 不在当前 tabs 中，则保持不变。
+     * 返回 true 表示 active 发生了变化。
+     */
+    restoreActiveFromStorage(): boolean;
+    /**
+     * 从 localStorage 读取上次活动 Tab 的 sessionId
+     *
+     * 用于恢复 tabs 循环时决定哪个 tab 应该 activate: true。
+     * 如果 localStorage 为空或不可用，返回 null。
+     */
+    getStoredActiveSessionId(): string | null;
+    /** 设置指定 tab 的瞬态 UI 参数（initialInputValue, noticeMessage），同时递增 initialValueVersion。 */
+    setTransientParams(sessionId: string, params: {
+        initialInputValue?: string;
+        noticeMessage?: string;
+    }): void;
+    /** 清除指定 tab 的瞬态 UI 参数。 */
+    clearTransientParams(sessionId: string): void;
+}
+export type Mode = 'manual' | 'edit' | 'plan' | 'auto' | 'bypass';
+export interface ModeConfig {
+    mode: Mode;
+    label: string;
+    icon: string;
+    description: string;
+}
+export type ToolCallStatus = 'pending' | 'approved' | 'denied' | 'running' | 'done';
+export interface ToolCall {
+    id: string;
+    toolName: string;
+    command?: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+    status: ToolCallStatus;
+}
+export type WindowMode = 'normal' | 'maximized' | 'minimized';
+export interface WindowState {
+    mode: WindowMode;
+    position: {
+        x: number;
+        y: number;
+    };
+    size: {
+        width: number;
+        height: number;
+    };
+    /** Snapshot before maximize/minimize for restore. */
+    lastState?: {
+        position: {
+            x: number;
+            y: number;
+        };
+        size: {
+            width: number;
+            height: number;
+        };
+    };
+}
+export interface AuthState {
+    isLoggedIn: boolean;
+    accessToken?: string;
+    refreshToken?: string;
+    userId?: string;
+    expiresAt?: number;
+}
+export interface WindowStateActions {
+    setMode(mode: WindowMode): void;
+    setPosition(pos: {
+        x: number;
+        y: number;
+    }): void;
+    setSize(size: {
+        width: number;
+        height: number;
+    }): void;
+    maximize(): void;
+    minimize(): void;
+    restore(): void;
+}
+export interface SessionState {
+    sessions: Session[];
+    currentSessionId: string | null;
+}
+export interface SessionActions {
+    /** 创建新 session 并设为 current。返回新 session 的 clientId（同步可得，规避 context 异步传播）。 */
+    createSession(): string;
+    switchSession(id: string): void;
+    renameSession(id: string, title: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    deleteSession(id: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** 通知后端关闭 session（Tab 关闭时调用，fire-and-forget） */
+    closeSession(sessionId: string): Promise<{
+        ok: boolean;
+        error?: Error;
+    }>;
+    /** 重新打开已关闭的 session（打开 closed session 时调用，透明 reopen） */
+    reopenSession(sessionId: string): Promise<{
+        ok: boolean;
+        error?: Error;
+    }>;
+    /** Reset all session state */
+    reset(): void;
+    /** Clear currentSessionId only (keep sessions list). Used when starting a new conversation. */
+    clearCurrentSession(): void;
+    /** Set current session (upsert + select). Used by MessageController after persistence write. */
+    setCurrentSession(session: Session): void;
+    /** Update sessions list without affecting currentSessionId. Used by UIUpdateBus subscription. */
+    setSessions(sessions: Session[]): void;
+}
+export interface MessageState {
+    messages: Message[];
+    /** Whether there are older messages available to load (backward pagination) */
+    hasMore: boolean;
+    /** Whether a loadMore (backward) request is in progress */
+    isLoadingMore: boolean;
+    /** Whether there are newer messages available to load (forward pagination) */
+    hasMoreNewer?: boolean;
+    /** Whether a loadNewer (forward) request is in progress */
+    isLoadingNewer?: boolean;
+}
+export interface MessageActions {
+    sendMessage(content: ContentData): Promise<void>;
+    /** 重新发送失败的消息（保留原 client_id 实现幂等重试） */
+    resendMessage(messageClientId: string, content: ContentData): Promise<void>;
+    /** 分叉对话：基于旧消息创建新 session，替换消息内容 */
+    forkSession(params: {
+        oldSessionClientId: string;
+        oldMessageClientId: string;
+        newSessionClientId: string;
+        newMessageClientId: string;
+        content: ContentData;
+        limit?: number;
+    }): Promise<void>;
+    /** Called by the streaming handler as tokens arrive. */
+    appendToLastMessage(chunk: string): void;
+    /** Finalize the last streaming message. */
+    finalizeLastMessage(): void;
+    /** 清空所有消息。Session 切换时调用，也可作为用户主动操作。 */
+    clearMessages(): void;
+}
+export interface ModeState {
+    currentMode: Mode;
+}
+export interface ModeActions {
+    setMode(mode: Mode): void;
+}
+export interface ToolCallState {
+    pendingCalls: ToolCall[];
+}
+export interface ToolCallActions {
+    approve(id: string): void;
+    approveAll(toolName: string): void;
+    deny(id: string): void;
+}
+export type { OpenAPISchema, ParameterDef, ReturnDef, VisualHooks, FunctionDef, FunctionGroupDef, RegistryConfig, ScenarioDef, ScenarioManifest, } from './skill.js';
+/**
+ * Activity Bar 的活动类型
+ *
+ * - files: 资源管理器（文件树 + 编辑器）
+ * - chat: 聊天模式（当前主界面）
+ * - settings: 设置（底部）
+ */
+export type Activity = 'files' | 'chat' | 'settings';
+/**
+ * 文件树节点（递归结构）
+ *
+ * 对应 VirtualFS 的目录/文件条目。`children` 为 undefined 表示"未加载"
+ * （懒加载语义），与空数组（空目录）区分。
+ */
+export interface FileNode {
+    /** 绝对路径，如 '/scenarios/checkout.md' */
+    path: string;
+    /** 文件名（不含路径） */
+    name: string;
+    /** 节点类型 */
+    type: 'file' | 'folder';
+    /** 子节点。仅 folder 有意义；undefined 表示尚未加载。 */
+    children?: FileNode[];
+    /** 是否展开。仅 folder 有意义。 */
+    isExpanded?: boolean;
+    /** 是否正在懒加载子节点。仅 folder 有意义。 */
+    isLoading?: boolean;
+}
+/**
+ * 编辑器视图模式
+ *
+ * - edit: 仅显示编辑面板
+ * - preview: 仅显示预览面板
+ * - split: 左右分屏（中间可拖动分割条）
+ */
+export type EditorViewMode = 'edit' | 'preview' | 'split';
+/**
+ * 编辑器标签页
+ *
+ * 以 filePath 为唯一标识，同一路径只允许开一个 tab。
+ */
+export interface EditorTab {
+    /** 文件路径（唯一标识） */
+    filePath: string;
+    /** 当前编辑内容 */
+    content: string;
+    /** 是否有未保存修改 */
+    isDirty: boolean;
+    /** 光标位置（行号 / 列号，均 1-based） */
+    cursorPosition: {
+        line: number;
+        column: number;
+    };
+    /** 当前 tab 的视图模式（每个 tab 独立） */
+    viewMode: EditorViewMode;
+}
+/**
+ * 状态栏显示信息
+ *
+ * 由 StatusBarController 从 EditorAreaController 派生，
+ * 供 rtc-status-bar 组件渲染。
+ */
+export interface StatusBarInfo {
+    /** 文件类型标签（如 "Markdown"、"JavaScript"） */
+    fileType: string;
+    /** 编码（固定 "UTF-8"，后续可扩展） */
+    encoding: string;
+    /** 光标位置（行号 / 列号，均 1-based） */
+    cursor: {
+        line: number;
+        column: number;
+    };
+    /** 保存状态：saved=已保存，unsaved=有未保存修改，none=无文件打开 */
+    saveStatus: 'saved' | 'unsaved' | 'none';
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/skill.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Skill System Types
+ *
+ * 定义 Function、FunctionGroup、VisualHooks 等核心类型
+ */
+import type { ZodType } from 'zod';
+/**
+ * CancelledError - 用户取消操作
+ *
+ * 用于区分"用户取消"和"真正的错误"
+ *
+ * M13: 添加 isCancelled brand 属性，解决跨 realm 时 instanceof 不可靠的问题。
+ * 使用 `CancelledError.isCancelledError(err)` 进行类型守卫判断。
+ */
+export declare class CancelledError extends Error {
+    /** M13: brand 属性，用于跨 realm 可靠判断 */
+    readonly isCancelled = true;
+    constructor(message?: string);
+    /**
+     * M13: 跨 realm 安全的类型守卫
+     * 比 instanceof 更可靠（iframe、Worker、不同 bundle 等场景）
+     */
+    static isCancelledError(error: unknown): error is CancelledError;
+}
+/**
+ * OpenAPI Schema 格式的参数定义
+ *
+ * 使用标准 OpenAPI 3.0 Schema 格式，支持：
+ * - 基础类型：string, number, integer, boolean
+ * - 复杂类型：object, array
+ * - 格式：date, date-time, email, uri, uuid 等
+ * - 嵌套对象和数组
+ * - 枚举值
+ * - 示例值（example）
+ */
+export interface OpenAPISchema {
+    /** 数据类型 */
+    type?: 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array';
+    /** 数据格式（如 date, date-time, email, uri, uuid, int32, int64, float, double 等） */
+    format?: string;
+    /** 描述 */
+    description?: string;
+    /** 是否必需（在 object 的 properties 中使用） */
+    required?: boolean;
+    /** 默认值 */
+    default?: unknown;
+    /** 示例值 */
+    example?: unknown;
+    /** 枚举值 */
+    enum?: unknown[];
+    /** 对象属性定义 */
+    properties?: Record<string, OpenAPISchema>;
+    /** 数组项定义 */
+    items?: OpenAPISchema;
+    /** 引用其他 schema（如 '#/components/schemas/User'） */
+    $ref?: string;
+    /** 最小值（number/integer） */
+    minimum?: number;
+    /** 最大值（number/integer） */
+    maximum?: number;
+    /** 最小长度（string） */
+    minLength?: number;
+    /** 最大长度（string） */
+    maxLength?: number;
+    /** 正则模式（string） */
+    pattern?: string;
+    /** 最小项数（array） */
+    minItems?: number;
+    /** 最大项数（array） */
+    maxItems?: number;
+    /** 是否允许重复项（array） */
+    uniqueItems?: boolean;
+}
+/**
+ * 参数定义（OpenAPI 格式）
+ *
+ * 使用 OpenAPI Schema 定义参数类型，支持复杂的嵌套结构
+ */
+export interface ParameterDef {
+    /** 参数名称 */
+    name: string;
+    /** OpenAPI Schema 定义 */
+    schema: OpenAPISchema;
+    /** 是否必需 */
+    required?: boolean;
+    /** 参数描述（可选，如果 schema 中没有 description） */
+    description?: string;
+}
+/**
+ * 返回值定义（OpenAPI 格式）
+ */
+export interface ReturnDef {
+    /** OpenAPI Schema 定义 */
+    schema: OpenAPISchema;
+    /** 返回值描述（可选，如果 schema 中没有 description） */
+    description?: string;
+}
+/**
+ * Visual Hooks - UI 钩子函数
+ */
+export interface VisualHooks {
+    /** 执行开始 */
+    onStart?: (params: Record<string, unknown>) => void | Promise<void>;
+    /** 执行成功 */
+    onSuccess?: (result: unknown) => void | Promise<void>;
+    /** 执行失败 */
+    onError?: (error: Error) => void | Promise<void>;
+    /** 执行进度 */
+    onProgress?: (progress: number) => void | Promise<void>;
+}
+/**
+ * Function 定义
+ */
+export interface FunctionDef {
+    /** Function 名称（如 'user.register'） */
+    name: string;
+    /** Function 描述 */
+    description: string;
+    /** 参数列表（OpenAPI 格式，向后兼容） */
+    parameters?: ParameterDef[];
+    /** Zod schema（用于运行时校验，优先于 parameters） */
+    zodSchema?: ZodType;
+    /** 返回值定义 */
+    returns?: ReturnDef;
+    /** Visual Hooks */
+    hooks?: VisualHooks;
+    /**
+     * 执行函数（第二个参数是进度回调，可选）
+     *
+     * MD13: 返回值类型为 unknown（不再使用 unknown | Promise<unknown>）。
+     * 注释说明：handler 可以是同步或异步函数。FunctionRegistry.execute 内部会 await 返回值，
+     * 因此异步函数返回的 Promise 会被自动解析。同步函数的返回值会被包装为 resolved Promise。
+     */
+    handler: (params: Record<string, unknown>, onProgress?: (progress: number) => void | Promise<void>) => unknown;
+}
+/**
+ * FunctionGroup 定义
+ */
+export interface FunctionGroupDef {
+    /** Group 名称（如 'user'） */
+    name: string;
+    /** Group 描述 */
+    description: string;
+}
+/**
+ * Registry 配置
+ */
+export interface RegistryConfig {
+    /** 应用名称 */
+    name: string;
+    /** 应用描述 */
+    description: string;
+    /** AI 人设 */
+    persona?: string;
+    /** 异步操作错误回调（如文档生成失败） */
+    onError?: (error: Error, context: string) => void;
+}
+/**
+ * Scenario 定义
+ */
+export interface ScenarioDef {
+    /** Scenario 唯一标识（可选，默认从 title 生成） */
+    id?: string;
+    /** Scenario 标题 */
+    title: string;
+    /** Scenario 简短描述（用于 INDEX.md） */
+    description?: string;
+    /** Scenario 内容（Markdown） */
+    content: string;
+    /** 标签 */
+    tags?: string[];
+    /** 作者 */
+    author?: string;
+    /** 创建时间（ISO 8601） */
+    createdAt?: string;
+}
+/**
+ * Scenario Manifest
+ *
+ * m10: 此类型在 scenario-loader.ts 中使用（解析 manifest.json），
+ * 并通过 types/index.ts 和 package index.ts 导出。
+ */
+export interface ScenarioManifest {
+    scenarios: Array<{
+        /** 文件名 */
+        file: string;
+        /** 唯一标识（可选） */
+        id?: string;
+        /** 名称（可选） */
+        name?: string;
+        /** 描述（可选） */
+        description?: string;
+    }>;
+}
+//# sourceMappingURL=skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/types/skill.ts"],"names":[],"mappings":"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"}