@sciol/xyzen 0.3.6 → 0.3.8

package/dist/marketplace/hooks/useBohriumMcp.d.ts

@@ -0,0 +1,61 @@
+import { McpActivationProgress } from '../types/bohrium';
+/**
+ * 使用 Bohrium 应用列表 (with React Query)
+ */
+export declare const useBohriumAppList: (page?: number, pageSize?: number, searchQuery?: string) => {
+    apps: import('..').BohriumApp[];
+    totalCount: number;
+    totalPages: number;
+    currentPage: number;
+    loading: boolean;
+    error: string | null;
+    isError: boolean;
+    refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<import('..').BohriumAppListResponse, Error>>;
+    prefetchNextPage: () => void;
+};
+/**
+ * 使用 Bohrium 应用列表（无限加载版）
+ */
+export declare const useBohriumInfiniteAppList: (pageSize?: number, searchQuery?: string) => {
+    apps: import('..').BohriumApp[];
+    totalCount: number;
+    totalPages: number;
+    pageCount: number;
+    loading: boolean;
+    isFetchingNextPage: boolean;
+    hasNextPage: boolean;
+    fetchNextPage: (options?: import('@tanstack/query-core').FetchNextPageOptions) => Promise<import('@tanstack/query-core').InfiniteQueryObserverResult<import('@tanstack/query-core').InfiniteData<import('..').BohriumAppListResponse, unknown>, Error>>;
+    refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<import('@tanstack/query-core').InfiniteData<import('..').BohriumAppListResponse, unknown>, Error>>;
+    error: string | null;
+    isError: boolean;
+};
+/**
+ * 使用 Bohrium 应用详情 (with React Query)
+ */
+export declare const useBohriumAppDetail: (appKey?: string) => {
+    detail: import('..').BohriumAppDetail | null;
+    loading: boolean;
+    error: string | null;
+    isError: boolean;
+    refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<import('..').BohriumAppDetail, Error>>;
+};
+/**
+ * 使用 MCP 激活流程
+ */
+export declare const useMcpActivation: () => {
+    progress: McpActivationProgress;
+    activateMcp: (appKey: string) => Promise<{
+        detail: import('..').BohriumAppDetail;
+        endpoint: {
+            url: string;
+            token: string;
+        };
+    }>;
+    reset: () => void;
+};
+/**
+ * 检查 Bohrium 认证状态
+ */
+export declare const useBohriumAuth: () => {
+    isAuthenticated: boolean;
+};

package/dist/marketplace/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Marketplace Module Entry
+ * 统一导出 marketplace 模块的所有功能
+ */
+export * from './types/bohrium';
+export { bohriumService } from './services/bohriumService';
+export { useBohriumAppDetail, useBohriumAppList, useBohriumAuth, useMcpActivation, } from './hooks/useBohriumMcp';
+export { default as McpActivationProgress } from './components/McpActivationProgress';
+export { default as McpServerCard } from './components/McpServerCard';
+export { default as McpServerDetail } from './components/McpServerDetail';
+export { default as UnifiedMcpMarketList } from './components/UnifiedMcpMarketList';
+export * from './utils/starredApps';

package/dist/marketplace/services/bohriumService.d.ts

@@ -0,0 +1,34 @@
+import { BohriumAppDetail, BohriumAppListResponse } from '../types/bohrium';
+/**
+ * Bohrium Service 类
+ */
+declare class BohriumService {
+    /**
+     * 获取 MCP 应用列表
+     */
+    getAppList(page?: number, pageSize?: number, search?: string): Promise<BohriumAppListResponse>;
+    /**
+     * 获取应用详情（包含 latestDeploymentId）
+     */
+    getAppDetail(appKey: string): Promise<BohriumAppDetail>;
+    /**
+     * 获取 MCP 服务端点配置
+     */
+    getMcpEndpoint(deploymentId: number): Promise<{
+        url: string;
+        token: string;
+    }>;
+    /**
+     * 轮询获取 MCP 端点（处理沙盒启动延迟）
+     */
+    waitForMcpEndpoint(deploymentId: number, maxRetries?: number, retryInterval?: number, onProgress?: (retryCount: number, maxRetries: number) => void): Promise<{
+        url: string;
+        token: string;
+    }>;
+    /**
+     * 检查是否已认证
+     */
+    isAuthenticated(): boolean;
+}
+export declare const bohriumService: BohriumService;
+export {};

package/dist/marketplace/types/bohrium.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Bohrium Marketplace Types
+ * 定义 Bohrium 平台相关的数据类型
+ */
+/**
+ * Bohrium 应用基础信息
+ */
+export interface BohriumApp {
+    id: number;
+    appKey: string;
+    appUuid: string;
+    title: string;
+    description: string;
+    descriptionCn: string;
+    cover: string;
+    type: number;
+    machineType: string;
+    subscribeNum: number;
+    accessNum: number;
+    latestVersion?: string;
+    tags?: BohriumTag[];
+    authors?: BohriumAuthor[];
+    keywords?: string;
+}
+/**
+ * Bohrium 应用详细信息
+ */
+export interface BohriumAppDetail extends BohriumApp {
+    latestDeploymentId: number;
+    readmeLink?: string;
+    readmeLinkCn?: string;
+    helpLink?: string;
+    helpLinkCn?: string;
+    createTime: string;
+    updateTime: string;
+    status: number;
+    spacePath: string;
+    changeLogs?: BohriumChangeLog[];
+}
+/**
+ * Bohrium 标签
+ */
+export interface BohriumTag {
+    id: number;
+    name: string;
+    theme: string;
+    customTheme?: string;
+}
+/**
+ * Bohrium 作者信息
+ */
+export interface BohriumAuthor {
+    userId: number;
+    userName: string;
+    avatarUrl?: string;
+    email?: string;
+    extId?: string;
+}
+/**
+ * Bohrium 更新日志
+ */
+export interface BohriumChangeLog {
+    id: number;
+    version: string;
+    changelog: string;
+    createTime: string;
+}
+/**
+ * Bohrium API 响应
+ */
+export interface BohriumApiResponse<T> {
+    code: number;
+    data: T;
+    message?: string;
+}
+/**
+ * Bohrium 应用列表响应
+ */
+export interface BohriumAppListResponse {
+    items: BohriumApp[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPage: number;
+}
+/**
+ * Bohrium MCP 服务配置
+ */
+export interface BohriumMcpConfig {
+    mcpServers: {
+        [key: string]: {
+            url: string;
+        };
+    };
+}
+/**
+ * MCP 激活状态
+ */
+export declare enum McpActivationStatus {
+    IDLE = "idle",
+    FETCHING_DETAIL = "fetching_detail",
+    ACTIVATING = "activating",
+    POLLING = "polling",
+    SUCCESS = "success",
+    ERROR = "error",
+    TIMEOUT = "timeout"
+}
+/**
+ * MCP 激活进度信息
+ */
+export interface McpActivationProgress {
+    status: McpActivationStatus;
+    message: string;
+    progress: number;
+    deploymentId?: number;
+    endpoint?: {
+        url: string;
+        token: string;
+    };
+    error?: string;
+    retryCount?: number;
+}
+/**
+ * Bohrium 认证配置
+ */
+export interface BohriumAuthConfig {
+    accessKey: string;
+    appKey: string;
+}

package/dist/marketplace/utils/starredApps.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Starred Apps Local Storage Management
+ * 管理用户收藏的 Bohrium MCP 应用
+ */
+export interface StarredApp {
+    appId: string;
+    appName: string;
+    starredAt: number;
+}
+/**
+ * 获取所有收藏的应用
+ */
+export declare function getStarredApps(): StarredApp[];
+/**
+ * 检查应用是否已收藏
+ */
+export declare function isAppStarred(appId: string): boolean;
+/**
+ * 添加应用到收藏
+ */
+export declare function addStarredApp(appId: string, appName: string): void;
+/**
+ * 从收藏中移除应用
+ */
+export declare function removeStarredApp(appId: string): void;
+/**
+ * 切换应用收藏状态
+ */
+export declare function toggleStarredApp(appId: string, appName: string): boolean;
+/**
+ * 获取收藏的应用 ID 列表
+ */
+export declare function getStarredAppIds(): string[];
+/**
+ * 清空所有收藏
+ */
+export declare function clearStarredApps(): void;

package/dist/service/mcpService.d.ts

@@ -1,9 +1,9 @@
-import { BuiltinMcpServer, McpServer, McpServerCreate, McpServerUpdate } from '../types/mcp';
+import { McpServer, McpServerCreate, McpServerUpdate } from '../types/mcp';
 export declare const mcpService: {
     getMcpServers(): Promise<McpServer[]>;
     createMcpServer(server: McpServerCreate): Promise<McpServer>;
     updateMcpServer(id: string, server: McpServerUpdate): Promise<McpServer>;
     deleteMcpServer(id: string): Promise<void>;
     refreshMcpServers(): Promise<void>;
-    getBuiltinMcpServers(): Promise<BuiltinMcpServer[]>;
+    getBuiltinMcpServers(): Promise<unknown[]>;
 };

package/dist/store/slices/agentSlice.d.ts

@@ -4,10 +4,16 @@ import { XyzenState } from '../types';
 export interface AgentSlice {
     agents: Agent[];
     agentsLoading: boolean;
+    publishedAgents: Agent[];
+    publishedAgentsLoading: boolean;
+    officialAgents: Agent[];
+    officialAgentsLoading: boolean;
     hiddenGraphAgentIds: string[];
     systemAgents: Agent[];
     systemAgentsLoading: boolean;
     fetchAgents: () => Promise<void>;
+    fetchPublishedGraphAgents: () => Promise<void>;
+    fetchOfficialGraphAgents: () => Promise<void>;
     fetchSystemAgents: () => Promise<void>;
     getSystemChatAgent: () => Promise<Agent>;
     getSystemWorkshopAgent: () => Promise<Agent>;
@@ -15,6 +21,8 @@ export interface AgentSlice {
     createGraphAgent: (graphAgent: GraphAgentCreate) => Promise<void>;
     updateAgent: (agent: Agent) => Promise<void>;
     updateAgentProvider: (agentId: string, providerId: string | null) => Promise<void>;
+    toggleGraphAgentPublish: (agentId: string) => Promise<void>;
+    setGraphAgentPublish: (agentId: string, isPublished: boolean) => Promise<void>;
     deleteAgent: (id: string) => Promise<void>;
     removeGraphAgentFromSidebar: (id: string) => void;
     addGraphAgentToSidebar: (id: string) => void;
@@ -26,6 +34,7 @@ export interface GraphAgentCreate {
     name: string;
     description: string;
     state_schema?: Record<string, unknown>;
+    is_published?: boolean;
 }
 export declare const createAgentSlice: StateCreator<XyzenState, [
     ["zustand/immer", never]

package/dist/store/slices/mcpSlice.d.ts

@@ -1,9 +1,9 @@
-import { BuiltinMcpServer, McpServer, McpServerCreate, McpServerUpdate } from '../../types/mcp';
+import { BuiltinMcpData, ExplorableMcpServer, McpServer, McpServerCreate, McpServerUpdate } from '../../types/mcp';
 import { StateCreator } from 'zustand';
 import { XyzenState } from '../types';
 export interface McpSlice {
     mcpServers: McpServer[];
-    builtinMcpServers: BuiltinMcpServer[];
+    builtinMcpServers: ExplorableMcpServer<BuiltinMcpData>[];
     lastFetchTime: number;
     isEditMcpServerModalOpen: boolean;
     editingMcpServer: McpServer | null;
@@ -11,7 +11,7 @@ export interface McpSlice {
     fetchBuiltinMcpServers: () => Promise<void>;
     refreshMcpServers: () => Promise<void>;
     addMcpServer: (server: McpServerCreate) => Promise<void>;
-    quickAddBuiltinServer: (server: BuiltinMcpServer) => Promise<void>;
+    quickAddBuiltinServer: (server: ExplorableMcpServer<BuiltinMcpData>) => Promise<void>;
     editMcpServer: (id: string, server: McpServerUpdate) => Promise<void>;
     removeMcpServer: (id: string) => Promise<void>;
     updateMcpServerInList: (server: McpServer) => void;

package/dist/types/mcp.d.ts

@@ -11,14 +11,54 @@ export interface McpServer {
     }[];
     user_id: string;
 }
-export interface BuiltinMcpServer {
+/**
+ * 内置 MCP Server 数据
+ */
+export interface BuiltinMcpData {
     name: string;
     module_name: string;
     mount_path: string;
     description: string;
-    is_builtin: boolean;
+    is_builtin: true;
     requires_auth: boolean;
     is_default?: boolean;
+    banner?: string;
 }
+/**
+ * Bohrium MCP Server 数据
+ */
+export interface BohriumMcpData {
+    id: number;
+    appKey: string;
+    appUuid: string;
+    title: string;
+    description: string;
+    descriptionCn: string;
+    cover: string;
+    type: number;
+    subscribeNum: number;
+    accessNum: number;
+    tags?: Array<{
+        id: number;
+        name: string;
+        theme: string;
+    }>;
+    latestDeploymentId?: number;
+}
+/**
+ * 可探索的 MCP Server（统一类型）
+ */
+export interface ExplorableMcpServer<T = BuiltinMcpData | BohriumMcpData> {
+    id: string;
+    name: string;
+    description: string;
+    source: "official" | "bohrium" | string;
+    cover?: string;
+    data: T;
+}
+export declare function isBuiltinMcp(server: ExplorableMcpServer): server is ExplorableMcpServer<BuiltinMcpData>;
+export declare function isBohriumMcp(server: ExplorableMcpServer): server is ExplorableMcpServer<BohriumMcpData>;
+/** @deprecated Use ExplorableMcpServer instead */
+export type BuiltinMcpServer = ExplorableMcpServer<BuiltinMcpData>;
 export type McpServerCreate = Omit<McpServer, "id" | "status" | "tools" | "user_id">;
 export type McpServerUpdate = Partial<Omit<McpServer, "id" | "tools" | "user_id">>;

package/dist/utils/mcpConverters.d.ts

@@ -0,0 +1,32 @@
+import { BohriumApp } from '../marketplace/types/bohrium';
+import { BohriumMcpData, BuiltinMcpData, ExplorableMcpServer } from '../types/mcp';
+interface LegacyBuiltinServer {
+    name: string;
+    module_name: string;
+    mount_path: string;
+    description: string;
+    requires_auth?: boolean;
+    is_default?: boolean;
+    banner?: string;
+    data?: unknown;
+    source?: string;
+}
+/**
+ * 将旧格式的 builtin server 数据转换为新的 ExplorableMcpServer 格式
+ * 兼容后端可能返回的多种格式
+ */
+export declare function convertToExplorableMcpServer(server: LegacyBuiltinServer | ExplorableMcpServer<BuiltinMcpData>): ExplorableMcpServer<BuiltinMcpData>;
+/**
+ * 将 Bohrium App 转换为 ExplorableMcpServer 格式
+ */
+export declare function convertBohriumAppToMcpServer(app: BohriumApp): ExplorableMcpServer<BohriumMcpData>;
+/**
+ * 批量转换 builtin servers
+ * 接受 unknown 类型以便从后端 API 直接使用
+ */
+export declare function convertBuiltinServers(servers: unknown): ExplorableMcpServer<BuiltinMcpData>[];
+/**
+ * 批量转换 Bohrium apps
+ */
+export declare function convertBohriumApps(apps: BohriumApp[]): ExplorableMcpServer<BohriumMcpData>[];
+export {};