@lobehub/market-types 1.0.4 → 1.0.6

package/README.md

@@ -0,0 +1,102 @@
+# LobeHub Market Types
+
+[![NPM version](https://img.shields.io/npm/v/@lobehub/market-sdk.svg?style=flat)](https://npmjs.org/package/@lobehub/market-types)
+[![NPM downloads](https://img.shields.io/npm/dm/@lobehub/market-sdk.svg?style=flat)](https://npmjs.org/package/@lobehub/market-types)
+
+This package contains TypeScript type definitions for the LobeHub Market ecosystem. It provides a comprehensive set of interfaces and type definitions that are shared between the API server and client applications.
+
+## Overview
+
+The type definitions in this package are organized into the following categories:
+
+- **Market Base Types**: Common type definitions used across all marketplace items
+- **Plugin Types**: Types related to plugins, their capabilities, and deployment options
+- **Agent Types**: Types related to AI agents and their features
+
+## Installation
+
+```bash
+npm install @lobehub/market-types
+# or
+yarn add @lobehub/market-types
+# or
+pnpm add @lobehub/market-types
+```
+
+## Usage
+
+Import the types you need in your TypeScript files:
+
+```typescript
+import { AgentItem, MarketItemBase, PluginManifest } from '@lobehub/market-types';
+
+// Use the types in your code
+const plugin: PluginManifest = {
+  id: 'my-plugin',
+  name: 'My Plugin',
+  description: 'A sample plugin',
+  version: '1.0.0',
+  // ...other properties
+};
+```
+
+## Type Categories
+
+### Market Base Types
+
+The `MarketItemBase` interface defines the common properties shared by all marketplace items:
+
+```typescript
+interface MarketItemBase {
+  author?: string;
+  category?: string;
+  description: string;
+  identifier: string;
+  name: string;
+  // ...other properties
+}
+```
+
+### Plugin Types
+
+Plugin-related types include:
+
+- `PluginManifest`: Complete specification of a plugin
+- `PluginTool`: Definition of a tool provided by a plugin
+- `PluginPrompt`: Definition of a prompt template
+- `PluginResource`: Definition of a resource provided by a plugin
+- `DeploymentOption`: Deployment configuration for a plugin
+
+### Agent Types
+
+Agent-related types include:
+
+- `AgentItem`: Definition of an agent in the marketplace
+
+## Structure
+
+```
+src/
+├── market.ts       - Base marketplace item types
+├── agent/          - Agent-related types
+│   └── index.ts    - Agent type definitions
+├── plugin/         - Plugin-related types
+│   ├── admin.ts    - Admin-specific plugin types
+│   ├── capabilities.ts - Plugin capability types
+│   ├── deploymentOption.ts - Deployment option types
+│   ├── plugin.ts   - Core plugin types
+│   └── index.ts    - Plugin exports
+└── index.ts        - Package exports
+```
+
+## Development
+
+To build the package:
+
+```bash
+pnpm build
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -1,384 +1,550 @@
 import { z } from 'zod';
 
 /**
- * 市场列表中单个资源项的基础结构
+ * Base structure for a single resource item in the marketplace.
+ * This interface defines the common properties shared by all marketplace items,
+ * including plugins, agents, and other resources.
  */
 interface MarketItemBase {
-    /** 全局唯一标识符, 通常包含作者/命名空间和名称 */
-    identifier: string;
-    /** 在市场列表中显示的名称 (已本地化) */
-    name: string;
-    /** 在市场列表中显示的简短描述 (已本地化) */
-    description: string;
-    /** 指向该资源详细 Manifest 文件的 URL */
-    manifestUrl: string;
-    /** 作者或组织名称 */
+    /** Author or organization name */
     author?: string;
-    /** 资源在市场中创建的日期 (ISO 8601) */
+    /** Category name used for classification */
+    category?: string;
+    /** Optional: Compatibility information for different platforms or versions */
+    compatibility?: Record<string, any>;
+    /** Resource creation date in the marketplace (ISO 8601 format) */
     createdAt: string;
-    /** 资源在市场中最后更新的日期 (ISO 8601) */
-    updatedAt: string;
-    /** 资源的主页或文档链接 */
+    /** Localized short description displayed in the marketplace listing */
+    description: string;
+    /** URL to the resource's homepage or documentation */
     homepage?: string;
-    /** 图标 URL 或 Emoji */
+    /** Icon URL or Emoji character */
     icon?: string;
-    /** 标签列表 (已本地化) */
+    /** Globally unique identifier, typically contains author/namespace and name */
+    identifier: string;
+    /** URL pointing to the detailed manifest file for this resource */
+    manifestUrl: string;
+    /** Localized display name shown in the marketplace listing */
+    name: string;
+    /** List of localized tags for filtering and categorization */
     tags?: string[];
-    /** 分类名称 */
-    category?: string;
-    /** 可选：兼容性信息 */
-    compatibility?: Record<string, any>;
+    /** Resource's last update date in the marketplace (ISO 8601 format) */
+    updatedAt: string;
 }
 
+/**
+ * Connection types for plugin communication.
+ * - http: The plugin communicates via HTTP protocol
+ * - stdio: The plugin communicates via standard input/output
+ */
+declare const ConnectionTypeEnum: z.ZodEnum<["http", "stdio"]>;
+type ConnectionType = z.infer<typeof ConnectionTypeEnum>;
+/**
+ * Plugin installation methods.
+ * Different ways to install and deploy a plugin.
+ */
+declare const InstallationMethodEnum: z.ZodEnum<["npm", "go", "python", "docker", "git", "binaryUrl", "manual", "none"]>;
+type InstallationMethod = z.infer<typeof InstallationMethodEnum>;
+/**
+ * System dependency required by a plugin.
+ * Defines a software dependency that must be installed on the system.
+ */
+interface SystemDependency {
+    /** Command to check if the dependency is installed */
+    checkCommand?: string;
+    /** Description of what this dependency is for */
+    description?: string;
+    /** Platform-specific installation instructions */
+    installInstructions?: Record<string, string>;
+    /** Name of the dependency */
+    name: string;
+    /** Minimum required version */
+    requiredVersion?: string;
+    /** Type of dependency (e.g., 'runtime', 'library') */
+    type?: string;
+    /** Whether version parsing is required to check compatibility */
+    versionParsingRequired?: boolean;
+}
+/**
+ * Connection configuration for a plugin.
+ * Defines how the application should communicate with the plugin.
+ */
+interface ConnectionConfig {
+    /** Command-line arguments for the plugin process */
+    args?: string[];
+    /** Command to execute to start the plugin */
+    command?: string;
+    /** Type of connection (http or stdio) */
+    type: ConnectionType;
+    /** URL for HTTP-based plugins */
+    url?: string;
+}
+/**
+ * Details for installing a plugin.
+ * Provides specific information needed during the installation process.
+ */
+interface InstallationDetails {
+    /** Package name for npm, pip, or other package managers */
+    packageName?: string;
+    /** Git repository URL to clone */
+    repositoryUrlToClone?: string;
+    /** Ordered list of setup steps to execute after installation */
+    setupSteps?: string[];
+}
+/**
+ * Deployment option for a plugin.
+ * A plugin can offer multiple deployment options, each with different requirements.
+ */
+interface DeploymentOption {
+    /** Connection configuration for this deployment option */
+    connection: ConnectionConfig;
+    /** Human-readable description of this deployment option */
+    description?: string;
+    /** Detailed installation instructions */
+    installationDetails?: InstallationDetails;
+    /** Method used to install this plugin */
+    installationMethod: string;
+    /** Whether this is the recommended deployment option */
+    isRecommended?: boolean;
+    /** System dependencies required for this deployment option */
+    systemDependencies?: SystemDependency[];
+}
+
+/**
+ * Schema defining the capabilities a plugin can provide.
+ * Each capability is represented as a boolean flag.
+ */
 declare const PluginCapabilitiesSchema: z.ZodObject<{
-    tools: z.ZodDefault<z.ZodBoolean>;
+    /** Whether the plugin provides custom prompts */
     prompts: z.ZodDefault<z.ZodBoolean>;
+    /** Whether the plugin provides resources (assets) */
     resources: z.ZodDefault<z.ZodBoolean>;
+    /** Whether the plugin provides tools (functions) */
+    tools: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    tools: boolean;
     prompts: boolean;
     resources: boolean;
+    tools: boolean;
 }, {
-    tools?: boolean | undefined;
     prompts?: boolean | undefined;
     resources?: boolean | undefined;
+    tools?: boolean | undefined;
 }>;
 /**
- * 工具项定义
+ * Definition of a tool that a plugin can provide.
+ * Tools are functions that can be called by the chat application.
  */
 interface PluginTool {
-    name: string;
+    /** Human-readable description of what the tool does */
     description?: string;
+    /** JSON schema defining the expected input parameters */
     inputSchema?: Record<string, any>;
+    /** Unique identifier for the tool within the plugin */
+    name: string;
 }
 /**
- * 资源项定义
+ * Definition of a resource (asset) that a plugin can provide.
+ * Resources can be images, data files, or other assets needed by the plugin.
  */
 interface PluginResource {
-    uri: string;
-    name?: string;
+    /** MIME type of the resource (e.g., 'image/png', 'application/json') */
     mimeType?: string;
+    /** Optional display name for the resource */
+    name?: string;
+    /** URI where the resource can be accessed */
+    uri: string;
 }
 /**
- * 提示词参数定义
+ * Definition of an argument for a prompt template.
+ * Arguments allow users to customize the prompt when using it.
  */
 interface PromptArgument {
+    /** Human-readable description of the argument's purpose */
+    description?: string;
+    /** Argument identifier */
     name: string;
+    /** Whether the argument must be provided (defaults to false if omitted) */
     required?: boolean;
-    description?: string;
+    /** Data type of the argument (e.g., 'string', 'number') */
     type?: string;
 }
 /**
- * 提示词项定义
+ * Definition of a prompt template that a plugin can provide.
+ * Prompts are pre-defined templates that can be used in conversations.
  */
 interface PluginPrompt {
-    name: string;
-    description: string;
+    /** List of customizable arguments for this prompt */
     arguments?: PromptArgument[];
-}
-
-/**
- * 连接类型
- */
-declare const ConnectionTypeEnum: z.ZodEnum<["http", "stdio"]>;
-type ConnectionType = z.infer<typeof ConnectionTypeEnum>;
-/**
- * MCP安装方法
- */
-declare const InstallationMethodEnum: z.ZodEnum<["npm", "go", "python", "docker", "git", "binaryUrl", "manual", "none"]>;
-type InstallationMethod = z.infer<typeof InstallationMethodEnum>;
-/**
- * 系统依赖项
- */
-interface SystemDependency {
+    /** Human-readable description of what the prompt does */
+    description: string;
+    /** Unique identifier for the prompt within the plugin */
     name: string;
-    type?: string;
-    requiredVersion?: string;
-    checkCommand?: string;
-    installInstructions?: Record<string, string>;
-    versionParsingRequired?: boolean;
-    description?: string;
-}
-/**
- * MCP连接配置
- */
-interface ConnectionConfig {
-    type: ConnectionType;
-    command?: string;
-    args?: string[];
-    url?: string;
-}
-interface InstallationDetails {
-    packageName?: string;
-    repositoryUrlToClone?: string;
-    setupSteps?: string[];
-}
-/**
- * MCP部署选项
- */
-interface DeploymentOption {
-    installationMethod: string;
-    installationDetails?: InstallationDetails;
-    connection: ConnectionConfig;
-    isRecommended?: boolean;
-    description?: string;
-    systemDependencies?: SystemDependency[];
 }
 
 /**
- * 兼容性信息
+ * Plugin compatibility information.
+ * Defines the compatibility requirements for a plugin with respect to app versions and platforms.
  */
 interface PluginCompatibility {
-    platforms?: string[];
-    minAppVersion?: string;
+    /** Maximum app version the plugin is compatible with */
     maxAppVersion?: string;
+    /** Minimum app version required to use the plugin */
+    minAppVersion?: string;
+    /** List of supported platforms (e.g., 'web', 'desktop', 'mobile') */
+    platforms?: string[];
 }
+/**
+ * Base plugin item schema with Zod validation.
+ * Defines the structure and validation rules for plugin items in the marketplace.
+ */
 declare const BasePluginItemSchema: z.ZodObject<{
-    identifier: z.ZodString;
-    name: z.ZodString;
-    description: z.ZodString;
-    manifestUrl: z.ZodString;
     author: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodString;
-    updatedAt: z.ZodString;
-    homepage: z.ZodOptional<z.ZodString>;
-    icon: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    category: z.ZodOptional<z.ZodString>;
     capabilities: z.ZodObject<{
-        tools: z.ZodDefault<z.ZodBoolean>;
         prompts: z.ZodDefault<z.ZodBoolean>;
         resources: z.ZodDefault<z.ZodBoolean>;
+        tools: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        tools: boolean;
         prompts: boolean;
         resources: boolean;
+        tools: boolean;
     }, {
-        tools?: boolean | undefined;
         prompts?: boolean | undefined;
         resources?: boolean | undefined;
+        tools?: boolean | undefined;
     }>;
-    toolsCount: z.ZodOptional<z.ZodNumber>;
-    promptsCount: z.ZodOptional<z.ZodNumber>;
-    resourcesCount: z.ZodOptional<z.ZodNumber>;
-    isValidated: z.ZodDefault<z.ZodBoolean>;
+    category: z.ZodOptional<z.ZodString>;
+    commentCount: z.ZodDefault<z.ZodNumber>;
+    createdAt: z.ZodString;
+    description: z.ZodString;
+    homepage: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    identifier: z.ZodString;
     installCount: z.ZodDefault<z.ZodNumber>;
+    isFeatured: z.ZodDefault<z.ZodBoolean>;
+    isValidated: z.ZodDefault<z.ZodBoolean>;
+    manifestUrl: z.ZodString;
+    name: z.ZodString;
+    promptsCount: z.ZodOptional<z.ZodNumber>;
     ratingAverage: z.ZodOptional<z.ZodNumber>;
     ratingCount: z.ZodDefault<z.ZodNumber>;
-    commentCount: z.ZodDefault<z.ZodNumber>;
-    isFeatured: z.ZodDefault<z.ZodBoolean>;
+    resourcesCount: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    toolsCount: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    identifier: string;
-    name: string;
-    description: string;
-    manifestUrl: string;
-    createdAt: string;
-    updatedAt: string;
     capabilities: {
-        tools: boolean;
         prompts: boolean;
         resources: boolean;
+        tools: boolean;
     };
-    isValidated: boolean;
-    installCount: number;
-    ratingCount: number;
     commentCount: number;
+    createdAt: string;
+    description: string;
+    identifier: string;
+    installCount: number;
     isFeatured: boolean;
+    isValidated: boolean;
+    manifestUrl: string;
+    name: string;
+    ratingCount: number;
+    updatedAt: string;
     author?: string | undefined;
+    category?: string | undefined;
     homepage?: string | undefined;
     icon?: string | undefined;
-    tags?: string[] | undefined;
-    category?: string | undefined;
-    toolsCount?: number | undefined;
     promptsCount?: number | undefined;
-    resourcesCount?: number | undefined;
     ratingAverage?: number | undefined;
+    resourcesCount?: number | undefined;
+    tags?: string[] | undefined;
+    toolsCount?: number | undefined;
 }, {
-    identifier: string;
-    name: string;
-    description: string;
-    manifestUrl: string;
-    createdAt: string;
-    updatedAt: string;
     capabilities: {
-        tools?: boolean | undefined;
         prompts?: boolean | undefined;
         resources?: boolean | undefined;
+        tools?: boolean | undefined;
     };
+    createdAt: string;
+    description: string;
+    identifier: string;
+    manifestUrl: string;
+    name: string;
+    updatedAt: string;
     author?: string | undefined;
+    category?: string | undefined;
+    commentCount?: number | undefined;
     homepage?: string | undefined;
     icon?: string | undefined;
-    tags?: string[] | undefined;
-    category?: string | undefined;
-    toolsCount?: number | undefined;
-    promptsCount?: number | undefined;
-    resourcesCount?: number | undefined;
-    isValidated?: boolean | undefined;
     installCount?: number | undefined;
+    isFeatured?: boolean | undefined;
+    isValidated?: boolean | undefined;
+    promptsCount?: number | undefined;
     ratingAverage?: number | undefined;
     ratingCount?: number | undefined;
-    commentCount?: number | undefined;
-    isFeatured?: boolean | undefined;
+    resourcesCount?: number | undefined;
+    tags?: string[] | undefined;
+    toolsCount?: number | undefined;
 }>;
 /**
- * Plugin (MCP Server) 类型资源项的定义 (继承基础结构)
- * 注: 这个定义会与现有的 PluginItem 结构进行整合
+ * Plugin marketplace item definition.
+ * Extends the base marketplace item with plugin-specific properties.
+ * This interface represents a plugin as it appears in the marketplace listing.
  */
 interface MarketPluginItem extends MarketItemBase {
+    /** Capabilities provided by this plugin */
     capabilities?: {
-        tools: boolean;
+        /** Whether the plugin provides custom prompts */
         prompts: boolean;
+        /** Whether the plugin provides resources (assets) */
         resources: boolean;
+        /** Whether the plugin provides tools (functions) */
+        tools: boolean;
     };
-    toolsCount?: number;
-    promptsCount?: number;
-    resourcesCount?: number;
-    isValidated?: boolean;
+    /** Number of comments on this plugin */
+    commentCount?: number;
+    /** Number of times this plugin has been installed */
     installCount?: number;
+    /** Whether this plugin is featured in the marketplace */
+    isFeatured?: boolean;
+    /** Whether this plugin has been validated by the system */
+    isValidated?: boolean;
+    /** Number of prompts provided by this plugin */
+    promptsCount?: number;
+    /** Average rating (typically 1-5 scale) */
     ratingAverage?: number;
+    /** Number of ratings received */
     ratingCount?: number;
-    commentCount?: number;
-    isFeatured?: boolean;
+    /** Number of resources provided by this plugin */
+    resourcesCount?: number;
+    /** Number of tools provided by this plugin */
+    toolsCount?: number;
 }
+/** Type alias for the base plugin item validated by Zod schema */
 type BasePluginItem = z.infer<typeof BasePluginItemSchema>;
+/**
+ * Plugin manifest definition.
+ * This is the complete specification of a plugin, including all its capabilities,
+ * metadata, and deployment options.
+ */
 interface PluginManifest {
-    id: string;
-    name: string;
-    version: string;
-    description: string;
-    category?: string;
-    tags?: string[];
+    /** Author information */
     author?: {
+        /** Author or organization name */
         name: string;
+        /** URL to the author's website or profile */
         url?: string;
     };
-    homepage?: string;
-    icon?: string;
+    /** Capabilities provided by this plugin */
     capabilities?: {
-        tools?: boolean;
+        /** Whether the plugin provides custom prompts */
         prompts?: boolean;
+        /** Whether the plugin provides resources */
         resources?: boolean;
+        /** Whether the plugin provides tools */
+        tools?: boolean;
     };
-    deploymentOptions?: DeploymentOption[];
+    /** Category for classification */
+    category?: string;
+    /** Compatibility requirements */
     compatibility?: PluginCompatibility;
-    tools?: PluginTool[];
-    resources?: PluginResource[];
-    prompts?: PluginPrompt[];
+    /** Available deployment options */
+    deploymentOptions?: DeploymentOption[];
+    /** Human-readable description */
+    description: string;
+    /** URL to the plugin's homepage or documentation */
+    homepage?: string;
+    /** Icon URL or emoji */
+    icon?: string;
+    /** Unique identifier for the plugin */
+    id: string;
+    /** Whether this plugin has been validated */
     isValidated?: boolean;
+    /** Display name of the plugin */
+    name: string;
+    /** List of prompt templates provided by this plugin */
+    prompts?: PluginPrompt[];
+    /** List of resources provided by this plugin */
+    resources?: PluginResource[];
+    /** List of tags for filtering and discovery */
+    tags?: string[];
+    /** List of tools provided by this plugin */
+    tools?: PluginTool[];
+    /** Timestamp when the plugin was validated (ISO 8601) */
     validatedAt?: string;
+    /** Semantic version string (e.g., "1.0.0") */
+    version: string;
 }
 
+/**
+ * Schema for admin-managed plugin items with additional status and visibility fields.
+ * Extends the base plugin schema with administrative properties.
+ */
 declare const AdminPluginItemSchema: z.ZodObject<{
-    identifier: z.ZodString;
-    name: z.ZodString;
-    description: z.ZodString;
-    manifestUrl: z.ZodString;
     author: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodString;
-    updatedAt: z.ZodString;
-    homepage: z.ZodOptional<z.ZodString>;
-    icon: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    category: z.ZodOptional<z.ZodString>;
     capabilities: z.ZodObject<{
-        tools: z.ZodDefault<z.ZodBoolean>;
         prompts: z.ZodDefault<z.ZodBoolean>;
         resources: z.ZodDefault<z.ZodBoolean>;
+        tools: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        tools: boolean;
         prompts: boolean;
         resources: boolean;
+        tools: boolean;
     }, {
-        tools?: boolean | undefined;
         prompts?: boolean | undefined;
         resources?: boolean | undefined;
+        tools?: boolean | undefined;
     }>;
-    toolsCount: z.ZodOptional<z.ZodNumber>;
-    promptsCount: z.ZodOptional<z.ZodNumber>;
-    resourcesCount: z.ZodOptional<z.ZodNumber>;
-    isValidated: z.ZodDefault<z.ZodBoolean>;
+    category: z.ZodOptional<z.ZodString>;
+    commentCount: z.ZodDefault<z.ZodNumber>;
+    createdAt: z.ZodString;
+    description: z.ZodString;
+    homepage: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    identifier: z.ZodString;
     installCount: z.ZodDefault<z.ZodNumber>;
+    isFeatured: z.ZodDefault<z.ZodBoolean>;
+    isValidated: z.ZodDefault<z.ZodBoolean>;
+    manifestUrl: z.ZodString;
+    name: z.ZodString;
+    promptsCount: z.ZodOptional<z.ZodNumber>;
     ratingAverage: z.ZodOptional<z.ZodNumber>;
     ratingCount: z.ZodDefault<z.ZodNumber>;
-    commentCount: z.ZodDefault<z.ZodNumber>;
-    isFeatured: z.ZodDefault<z.ZodBoolean>;
+    resourcesCount: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    toolsCount: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodString;
 } & {
+    /** Publication status of the plugin */
     status: z.ZodEnum<["published", "unpublished", "archived", "deprecated"]>;
+    /** Visibility level of the plugin */
     visibility: z.ZodEnum<["public", "private", "internal"]>;
 }, "strip", z.ZodTypeAny, {
     status: "published" | "unpublished" | "archived" | "deprecated";
-    identifier: string;
-    name: string;
-    description: string;
-    manifestUrl: string;
-    createdAt: string;
-    updatedAt: string;
     capabilities: {
-        tools: boolean;
         prompts: boolean;
         resources: boolean;
+        tools: boolean;
     };
-    isValidated: boolean;
-    installCount: number;
-    ratingCount: number;
     commentCount: number;
+    createdAt: string;
+    description: string;
+    identifier: string;
+    installCount: number;
     isFeatured: boolean;
+    isValidated: boolean;
+    manifestUrl: string;
+    name: string;
+    ratingCount: number;
+    updatedAt: string;
     visibility: "public" | "private" | "internal";
     author?: string | undefined;
+    category?: string | undefined;
     homepage?: string | undefined;
     icon?: string | undefined;
-    tags?: string[] | undefined;
-    category?: string | undefined;
-    toolsCount?: number | undefined;
     promptsCount?: number | undefined;
-    resourcesCount?: number | undefined;
     ratingAverage?: number | undefined;
+    resourcesCount?: number | undefined;
+    tags?: string[] | undefined;
+    toolsCount?: number | undefined;
 }, {
     status: "published" | "unpublished" | "archived" | "deprecated";
-    identifier: string;
-    name: string;
-    description: string;
-    manifestUrl: string;
-    createdAt: string;
-    updatedAt: string;
     capabilities: {
-        tools?: boolean | undefined;
         prompts?: boolean | undefined;
         resources?: boolean | undefined;
+        tools?: boolean | undefined;
     };
+    createdAt: string;
+    description: string;
+    identifier: string;
+    manifestUrl: string;
+    name: string;
+    updatedAt: string;
     visibility: "public" | "private" | "internal";
     author?: string | undefined;
+    category?: string | undefined;
+    commentCount?: number | undefined;
     homepage?: string | undefined;
     icon?: string | undefined;
-    tags?: string[] | undefined;
-    category?: string | undefined;
-    toolsCount?: number | undefined;
-    promptsCount?: number | undefined;
-    resourcesCount?: number | undefined;
-    isValidated?: boolean | undefined;
     installCount?: number | undefined;
+    isFeatured?: boolean | undefined;
+    isValidated?: boolean | undefined;
+    promptsCount?: number | undefined;
     ratingAverage?: number | undefined;
     ratingCount?: number | undefined;
-    commentCount?: number | undefined;
-    isFeatured?: boolean | undefined;
+    resourcesCount?: number | undefined;
+    tags?: string[] | undefined;
+    toolsCount?: number | undefined;
 }>;
+/**
+ * Interface for admin-managed plugin items.
+ * Extends the market plugin item with administrative properties.
+ */
 interface AdminPluginItem extends MarketPluginItem {
+    /** Unique numeric identifier for the plugin in the database */
     id: number;
+    /** User ID of the plugin owner */
     ownerId: number;
+    /** Publication status of the plugin */
     status: 'published' | 'unpublished' | 'archived';
+    /** Visibility level controlling who can access the plugin */
     visibility: 'public' | 'private' | 'internal';
 }
+/**
+ * Plugin version database model.
+ * Represents a specific version of a plugin in the database.
+ */
+interface PluginVersion {
+    /** Creation timestamp (ISO 8601 format) */
+    createdAt: string;
+    /** Unique numeric identifier for the version */
+    id: number;
+    /** Whether this is the latest version of the plugin */
+    isLatest: boolean;
+    /** Whether this version has been validated by the system */
+    isValidated: boolean;
+    /** The full manifest data for this version */
+    manifest: PluginManifest;
+    /** URL to the manifest file, or null if stored directly */
+    manifestUrl: string | null;
+    /** Additional metadata for this version */
+    meta: Record<string, any> | null;
+    /** ID of the parent plugin */
+    pluginId: number;
+    /** Number of prompts provided by this version */
+    promptsCount: number;
+    /** Number of resources provided by this version */
+    resourcesCount: number;
+    /** Number of tools provided by this version */
+    toolsCount: number;
+    /** Last update timestamp (ISO 8601 format) */
+    updatedAt: string;
+    /** Semantic version string (e.g., "1.0.0") */
+    version: string;
+}
+/**
+ * Detailed admin plugin item with version history.
+ * Used for displaying complete plugin information in the admin interface.
+ */
 interface AdminPluginItemDetail extends Omit<AdminPluginItem, 'manifestUrl'> {
+    /** Full manifest data for the current version */
     manifest: PluginManifest;
+    /** List of all versions of this plugin */
+    versions: PluginVersion[];
 }
 /**
- * MCP部署选项
+ * Admin deployment option with database ID.
+ * Extends the basic deployment option with a database identifier.
  */
 interface AdminDeploymentOption extends DeploymentOption {
+    /** Unique numeric identifier for the deployment option */
     id: number;
 }
+/**
+ * Admin system dependency with database ID.
+ * Extends the basic system dependency with a database identifier.
+ */
 interface AdminSystemDependency extends SystemDependency {
+    /** Unique numeric identifier for the system dependency */
     id: number;
 }
 
-export { type AdminDeploymentOption, type AdminPluginItem, type AdminPluginItemDetail, AdminPluginItemSchema, type AdminSystemDependency, type BasePluginItem, BasePluginItemSchema, type ConnectionConfig, type ConnectionType, ConnectionTypeEnum, type DeploymentOption, type InstallationDetails, type InstallationMethod, InstallationMethodEnum, type MarketItemBase, type MarketPluginItem, PluginCapabilitiesSchema, type PluginCompatibility, type PluginManifest, type PluginPrompt, type PluginResource, type PluginTool, type PromptArgument, type SystemDependency };
+export { type AdminDeploymentOption, type AdminPluginItem, type AdminPluginItemDetail, AdminPluginItemSchema, type AdminSystemDependency, type BasePluginItem, BasePluginItemSchema, type ConnectionConfig, type ConnectionType, ConnectionTypeEnum, type DeploymentOption, type InstallationDetails, type InstallationMethod, InstallationMethodEnum, type MarketItemBase, type MarketPluginItem, PluginCapabilitiesSchema, type PluginCompatibility, type PluginManifest, type PluginPrompt, type PluginResource, type PluginTool, type PluginVersion, type PromptArgument, type SystemDependency };

package/dist/index.mjs

@@ -1,43 +1,50 @@
+// src/plugin/admin.ts
+import { z as z3 } from "zod";
+
 // src/plugin/plugin.ts
 import { z as z2 } from "zod";
 
 // src/plugin/capabilities.ts
 import { z } from "zod";
 var PluginCapabilitiesSchema = z.object({
-  tools: z.boolean().default(false),
+  /** Whether the plugin provides custom prompts */
   prompts: z.boolean().default(false),
-  resources: z.boolean().default(false)
+  /** Whether the plugin provides resources (assets) */
+  resources: z.boolean().default(false),
+  /** Whether the plugin provides tools (functions) */
+  tools: z.boolean().default(false)
 });
 
 // src/plugin/plugin.ts
 var BasePluginItemSchema = z2.object({
-  identifier: z2.string(),
-  name: z2.string(),
-  description: z2.string(),
-  manifestUrl: z2.string(),
   author: z2.string().optional(),
+  capabilities: PluginCapabilitiesSchema,
+  category: z2.string().optional(),
+  commentCount: z2.number().default(0),
   createdAt: z2.string(),
-  updatedAt: z2.string(),
+  description: z2.string(),
   homepage: z2.string().optional(),
   icon: z2.string().optional(),
-  tags: z2.array(z2.string()).optional(),
-  category: z2.string().optional(),
-  capabilities: PluginCapabilitiesSchema,
-  toolsCount: z2.number().optional(),
-  promptsCount: z2.number().optional(),
-  resourcesCount: z2.number().optional(),
-  isValidated: z2.boolean().default(false),
+  identifier: z2.string(),
   installCount: z2.number().default(0),
+  isFeatured: z2.boolean().default(false),
+  isValidated: z2.boolean().default(false),
+  manifestUrl: z2.string(),
+  name: z2.string(),
+  promptsCount: z2.number().optional(),
   ratingAverage: z2.number().optional(),
   ratingCount: z2.number().default(0),
-  commentCount: z2.number().default(0),
-  isFeatured: z2.boolean().default(false)
+  resourcesCount: z2.number().optional(),
+  tags: z2.array(z2.string()).optional(),
+  toolsCount: z2.number().optional(),
+  updatedAt: z2.string()
 });
 
 // src/plugin/admin.ts
-import { z as z3 } from "zod";
 var AdminPluginItemSchema = BasePluginItemSchema.extend({
+  /** Publication status of the plugin */
   status: z3.enum(["published", "unpublished", "archived", "deprecated"]),
+  /** Visibility level of the plugin */
   visibility: z3.enum(["public", "private", "internal"])
 });
 
@@ -46,13 +53,21 @@ import { z as z4 } from "zod";
 var ConnectionTypeEnum = z4.enum(["http", "stdio"]);
 var InstallationMethodEnum = z4.enum([
   "npm",
+  // Node.js package manager
   "go",
+  // Go language
   "python",
+  // Python language
   "docker",
+  // Docker container
   "git",
+  // Git repository
   "binaryUrl",
+  // Direct binary download URL
   "manual",
+  // Manual installation with instructions
   "none"
+  // No installation required
 ]);
 export {
   AdminPluginItemSchema,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/plugin/plugin.ts","../src/plugin/capabilities.ts","../src/plugin/admin.ts","../src/plugin/deploymentOption.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { MarketItemBase } from '../market';\nimport {\n  PluginCapabilitiesSchema,\n  PluginPrompt,\n  PluginResource,\n  PluginTool,\n  PromptArgument,\n} from './capabilities';\nimport { DeploymentOption } from './deploymentOption';\n\n/**\n * 兼容性信息\n */\nexport interface PluginCompatibility {\n  platforms?: string[];\n  minAppVersion?: string;\n  maxAppVersion?: string;\n}\n\n// 基础插件项 Schema\nexport const BasePluginItemSchema = z.object({\n  identifier: z.string(),\n  name: z.string(),\n  description: z.string(),\n  manifestUrl: z.string(),\n  author: z.string().optional(),\n  createdAt: z.string(),\n  updatedAt: z.string(),\n  homepage: z.string().optional(),\n  icon: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  category: z.string().optional(),\n  capabilities: PluginCapabilitiesSchema,\n  toolsCount: z.number().optional(),\n  promptsCount: z.number().optional(),\n  resourcesCount: z.number().optional(),\n  isValidated: z.boolean().default(false),\n  installCount: z.number().default(0),\n  ratingAverage: z.number().optional(),\n  ratingCount: z.number().default(0),\n  commentCount: z.number().default(0),\n  isFeatured: z.boolean().default(false),\n});\n\n/**\n * Plugin (MCP Server) 类型资源项的定义 (继承基础结构)\n * 注: 这个定义会与现有的 PluginItem 结构进行整合\n */\nexport interface MarketPluginItem extends MarketItemBase {\n  // 能力信息\n  capabilities?: {\n    tools: boolean;\n    prompts: boolean;\n    resources: boolean;\n  };\n  // 数量统计\n  toolsCount?: number;\n  promptsCount?: number;\n  resourcesCount?: number;\n  // 验证状态\n  isValidated?: boolean;\n  // 统计信息\n  installCount?: number;\n  ratingAverage?: number;\n  ratingCount?: number;\n  commentCount?: number;\n  isFeatured?: boolean;\n}\n\n// 导出类型\nexport type BasePluginItem = z.infer<typeof BasePluginItemSchema>;\n\n// 插件清单\nexport interface PluginManifest {\n  id: string;\n  name: string;\n  version: string;\n  description: string;\n  category?: string;\n  tags?: string[];\n  author?: {\n    name: string;\n    url?: string;\n  };\n  homepage?: string;\n  icon?: string;\n  capabilities?: {\n    tools?: boolean;\n    prompts?: boolean;\n    resources?: boolean;\n  };\n  deploymentOptions?: DeploymentOption[];\n  compatibility?: PluginCompatibility;\n  // 工具定义\n  tools?: PluginTool[];\n  // 资源定义\n  resources?: PluginResource[];\n  // 提示词定义\n  prompts?: PluginPrompt[];\n  // 验证信息\n  isValidated?: boolean;\n  validatedAt?: string;\n}\n","\n// 插件能力定义\nimport { z } from 'zod';\n\nexport const PluginCapabilitiesSchema = z.object({\n  tools: z.boolean().default(false),\n  prompts: z.boolean().default(false),\n  resources: z.boolean().default(false),\n});\n\n/**\n * 工具项定义\n */\nexport interface PluginTool {\n  name: string;\n  description?: string;\n  inputSchema?: Record<string, any>;\n}\n\n/**\n * 资源项定义\n */\nexport interface PluginResource {\n  uri: string;\n  name?: string;\n  mimeType?: string;\n}\n\n/**\n * 提示词参数定义\n */\nexport interface PromptArgument {\n  name: string;\n  required?: boolean;\n  description?: string;\n  type?: string;\n}\n\n/**\n * 提示词项定义\n */\nexport interface PluginPrompt {\n  name: string;\n  description: string;\n  arguments?: PromptArgument[];\n}\n","// 管理端插件项 Schema\nimport { z } from 'zod';\n\nimport { DeploymentOption, SystemDependency } from '@/plugin/deploymentOption';\n\nimport { BasePluginItemSchema, MarketPluginItem, PluginManifest } from './plugin';\n\nexport const AdminPluginItemSchema = BasePluginItemSchema.extend({\n  status: z.enum(['published', 'unpublished', 'archived', 'deprecated'] as const),\n  visibility: z.enum(['public', 'private', 'internal'] as const),\n});\n\nexport interface AdminPluginItem extends MarketPluginItem {\n  id: number;\n  ownerId: number;\n  status: 'published' | 'unpublished' | 'archived';\n  visibility: 'public' | 'private' | 'internal';\n}\n\nexport interface AdminPluginItemDetail extends Omit<AdminPluginItem, 'manifestUrl'> {\n  manifest: PluginManifest;\n}\n\n/**\n * MCP部署选项\n */\nexport interface AdminDeploymentOption extends DeploymentOption {\n  id: number;\n}\n\nexport interface AdminSystemDependency extends SystemDependency {\n  id: number;\n}\n","import { z } from 'zod';\n\n/**\n * 连接类型\n */\nexport const ConnectionTypeEnum = z.enum(['http', 'stdio']);\nexport type ConnectionType = z.infer<typeof ConnectionTypeEnum>;\n\n/**\n * MCP安装方法\n */\nexport const InstallationMethodEnum = z.enum([\n  'npm',\n  'go',\n  'python',\n  'docker',\n  'git',\n  'binaryUrl',\n  'manual',\n  'none',\n]);\nexport type InstallationMethod = z.infer<typeof InstallationMethodEnum>;\n\n/**\n * 系统依赖项\n */\nexport interface SystemDependency {\n  name: string;\n  type?: string;\n  requiredVersion?: string;\n  checkCommand?: string;\n  installInstructions?: Record<string, string>;\n  versionParsingRequired?: boolean;\n  description?: string;\n}\n\n/**\n * MCP连接配置\n */\nexport interface ConnectionConfig {\n  type: ConnectionType;\n  command?: string;\n  args?: string[];\n  url?: string;\n}\n\nexport interface InstallationDetails {\n  packageName?: string;\n  repositoryUrlToClone?: string;\n  setupSteps?: string[];\n}\n\n/**\n * MCP部署选项\n */\nexport interface DeploymentOption {\n  installationMethod: string;\n  installationDetails?: InstallationDetails;\n  connection: ConnectionConfig;\n  isRecommended?: boolean;\n  description?: string;\n  systemDependencies?: SystemDependency[];\n}\n"],"mappings":";AAAA,SAAS,KAAAA,UAAS;;;ACElB,SAAS,SAAS;AAEX,IAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EAChC,SAAS,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EAClC,WAAW,EAAE,QAAQ,EAAE,QAAQ,KAAK;AACtC,CAAC;;;ADcM,IAAM,uBAAuBC,GAAE,OAAO;AAAA,EAC3C,YAAYA,GAAE,OAAO;AAAA,EACrB,MAAMA,GAAE,OAAO;AAAA,EACf,aAAaA,GAAE,OAAO;AAAA,EACtB,aAAaA,GAAE,OAAO;AAAA,EACtB,QAAQA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,WAAWA,GAAE,OAAO;AAAA,EACpB,WAAWA,GAAE,OAAO;AAAA,EACpB,UAAUA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,MAAMA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,MAAMA,GAAE,MAAMA,GAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACnC,UAAUA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,cAAc;AAAA,EACd,YAAYA,GAAE,OAAO,EAAE,SAAS;AAAA,EAChC,cAAcA,GAAE,OAAO,EAAE,SAAS;AAAA,EAClC,gBAAgBA,GAAE,OAAO,EAAE,SAAS;AAAA,EACpC,aAAaA,GAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EACtC,cAAcA,GAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EAClC,eAAeA,GAAE,OAAO,EAAE,SAAS;AAAA,EACnC,aAAaA,GAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EACjC,cAAcA,GAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EAClC,YAAYA,GAAE,QAAQ,EAAE,QAAQ,KAAK;AACvC,CAAC;;;AE3CD,SAAS,KAAAC,UAAS;AAMX,IAAM,wBAAwB,qBAAqB,OAAO;AAAA,EAC/D,QAAQC,GAAE,KAAK,CAAC,aAAa,eAAe,YAAY,YAAY,CAAU;AAAA,EAC9E,YAAYA,GAAE,KAAK,CAAC,UAAU,WAAW,UAAU,CAAU;AAC/D,CAAC;;;ACVD,SAAS,KAAAC,UAAS;AAKX,IAAM,qBAAqBA,GAAE,KAAK,CAAC,QAAQ,OAAO,CAAC;AAMnD,IAAM,yBAAyBA,GAAE,KAAK;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;","names":["z","z","z","z","z"]}
+{"version":3,"sources":["../src/plugin/admin.ts","../src/plugin/plugin.ts","../src/plugin/capabilities.ts","../src/plugin/deploymentOption.ts"],"sourcesContent":["// Admin plugin item schema definitions\nimport { z } from 'zod';\n\nimport { DeploymentOption, SystemDependency } from './deploymentOption';\nimport { BasePluginItemSchema, MarketPluginItem, PluginManifest } from './plugin';\n\n/**\n * Schema for admin-managed plugin items with additional status and visibility fields.\n * Extends the base plugin schema with administrative properties.\n */\nexport const AdminPluginItemSchema = BasePluginItemSchema.extend({\n  /** Publication status of the plugin */\n  status: z.enum(['published', 'unpublished', 'archived', 'deprecated'] as const),\n  /** Visibility level of the plugin */\n  visibility: z.enum(['public', 'private', 'internal'] as const),\n});\n\n/**\n * Interface for admin-managed plugin items.\n * Extends the market plugin item with administrative properties.\n */\nexport interface AdminPluginItem extends MarketPluginItem {\n  /** Unique numeric identifier for the plugin in the database */\n  id: number;\n  /** User ID of the plugin owner */\n  ownerId: number;\n  /** Publication status of the plugin */\n  status: 'published' | 'unpublished' | 'archived';\n  /** Visibility level controlling who can access the plugin */\n  visibility: 'public' | 'private' | 'internal';\n}\n\n/**\n * Plugin version database model.\n * Represents a specific version of a plugin in the database.\n */\nexport interface PluginVersion {\n  /** Creation timestamp (ISO 8601 format) */\n  createdAt: string;\n  /** Unique numeric identifier for the version */\n  id: number;\n  /** Whether this is the latest version of the plugin */\n  isLatest: boolean;\n  /** Whether this version has been validated by the system */\n  isValidated: boolean;\n  /** The full manifest data for this version */\n  manifest: PluginManifest;\n  /** URL to the manifest file, or null if stored directly */\n  manifestUrl: string | null;\n  /** Additional metadata for this version */\n  meta: Record<string, any> | null;\n  /** ID of the parent plugin */\n  pluginId: number;\n  /** Number of prompts provided by this version */\n  promptsCount: number;\n  /** Number of resources provided by this version */\n  resourcesCount: number;\n  /** Number of tools provided by this version */\n  toolsCount: number;\n  /** Last update timestamp (ISO 8601 format) */\n  updatedAt: string;\n  /** Semantic version string (e.g., \"1.0.0\") */\n  version: string;\n}\n\n/**\n * Detailed admin plugin item with version history.\n * Used for displaying complete plugin information in the admin interface.\n */\nexport interface AdminPluginItemDetail extends Omit<AdminPluginItem, 'manifestUrl'> {\n  /** Full manifest data for the current version */\n  manifest: PluginManifest;\n  /** List of all versions of this plugin */\n  versions: PluginVersion[];\n}\n\n/**\n * Admin deployment option with database ID.\n * Extends the basic deployment option with a database identifier.\n */\nexport interface AdminDeploymentOption extends DeploymentOption {\n  /** Unique numeric identifier for the deployment option */\n  id: number;\n}\n\n/**\n * Admin system dependency with database ID.\n * Extends the basic system dependency with a database identifier.\n */\nexport interface AdminSystemDependency extends SystemDependency {\n  /** Unique numeric identifier for the system dependency */\n  id: number;\n}\n","import { z } from 'zod';\n\nimport { MarketItemBase } from '../market';\nimport { PluginCapabilitiesSchema, PluginPrompt, PluginResource, PluginTool } from './capabilities';\nimport { DeploymentOption } from './deploymentOption';\n\n/**\n * Plugin compatibility information.\n * Defines the compatibility requirements for a plugin with respect to app versions and platforms.\n */\nexport interface PluginCompatibility {\n  /** Maximum app version the plugin is compatible with */\n  maxAppVersion?: string;\n  /** Minimum app version required to use the plugin */\n  minAppVersion?: string;\n  /** List of supported platforms (e.g., 'web', 'desktop', 'mobile') */\n  platforms?: string[];\n}\n\n/**\n * Base plugin item schema with Zod validation.\n * Defines the structure and validation rules for plugin items in the marketplace.\n */\nexport const BasePluginItemSchema = z.object({\n  author: z.string().optional(),\n  capabilities: PluginCapabilitiesSchema,\n  category: z.string().optional(),\n  commentCount: z.number().default(0),\n  createdAt: z.string(),\n  description: z.string(),\n  homepage: z.string().optional(),\n  icon: z.string().optional(),\n  identifier: z.string(),\n  installCount: z.number().default(0),\n  isFeatured: z.boolean().default(false),\n  isValidated: z.boolean().default(false),\n  manifestUrl: z.string(),\n  name: z.string(),\n  promptsCount: z.number().optional(),\n  ratingAverage: z.number().optional(),\n  ratingCount: z.number().default(0),\n  resourcesCount: z.number().optional(),\n  tags: z.array(z.string()).optional(),\n  toolsCount: z.number().optional(),\n  updatedAt: z.string(),\n});\n\n/**\n * Plugin marketplace item definition.\n * Extends the base marketplace item with plugin-specific properties.\n * This interface represents a plugin as it appears in the marketplace listing.\n */\nexport interface MarketPluginItem extends MarketItemBase {\n  /** Capabilities provided by this plugin */\n  capabilities?: {\n    /** Whether the plugin provides custom prompts */\n    prompts: boolean;\n    /** Whether the plugin provides resources (assets) */\n    resources: boolean;\n    /** Whether the plugin provides tools (functions) */\n    tools: boolean;\n  };\n  /** Number of comments on this plugin */\n  commentCount?: number;\n  /** Number of times this plugin has been installed */\n  installCount?: number;\n  /** Whether this plugin is featured in the marketplace */\n  isFeatured?: boolean;\n  /** Whether this plugin has been validated by the system */\n  isValidated?: boolean;\n  /** Number of prompts provided by this plugin */\n  promptsCount?: number;\n  /** Average rating (typically 1-5 scale) */\n  ratingAverage?: number;\n  /** Number of ratings received */\n  ratingCount?: number;\n  /** Number of resources provided by this plugin */\n  resourcesCount?: number;\n  /** Number of tools provided by this plugin */\n  toolsCount?: number;\n}\n\n/** Type alias for the base plugin item validated by Zod schema */\nexport type BasePluginItem = z.infer<typeof BasePluginItemSchema>;\n\n/**\n * Plugin manifest definition.\n * This is the complete specification of a plugin, including all its capabilities,\n * metadata, and deployment options.\n */\nexport interface PluginManifest {\n  /** Author information */\n  author?: {\n    /** Author or organization name */\n    name: string;\n    /** URL to the author's website or profile */\n    url?: string;\n  };\n  /** Capabilities provided by this plugin */\n  capabilities?: {\n    /** Whether the plugin provides custom prompts */\n    prompts?: boolean;\n    /** Whether the plugin provides resources */\n    resources?: boolean;\n    /** Whether the plugin provides tools */\n    tools?: boolean;\n  };\n  /** Category for classification */\n  category?: string;\n  /** Compatibility requirements */\n  compatibility?: PluginCompatibility;\n  /** Available deployment options */\n  deploymentOptions?: DeploymentOption[];\n  /** Human-readable description */\n  description: string;\n  /** URL to the plugin's homepage or documentation */\n  homepage?: string;\n  /** Icon URL or emoji */\n  icon?: string;\n  /** Unique identifier for the plugin */\n  id: string;\n  /** Whether this plugin has been validated */\n  isValidated?: boolean;\n  /** Display name of the plugin */\n  name: string;\n  /** List of prompt templates provided by this plugin */\n  prompts?: PluginPrompt[];\n  /** List of resources provided by this plugin */\n  resources?: PluginResource[];\n  /** List of tags for filtering and discovery */\n  tags?: string[];\n  /** List of tools provided by this plugin */\n  tools?: PluginTool[];\n  /** Timestamp when the plugin was validated (ISO 8601) */\n  validatedAt?: string;\n  /** Semantic version string (e.g., \"1.0.0\") */\n  version: string;\n}\n","// Plugin capability definitions\nimport { z } from 'zod';\n\n/**\n * Schema defining the capabilities a plugin can provide.\n * Each capability is represented as a boolean flag.\n */\nexport const PluginCapabilitiesSchema = z.object({\n  /** Whether the plugin provides custom prompts */\n  prompts: z.boolean().default(false),\n  /** Whether the plugin provides resources (assets) */\n  resources: z.boolean().default(false),\n  /** Whether the plugin provides tools (functions) */\n  tools: z.boolean().default(false),\n});\n\n/**\n * Definition of a tool that a plugin can provide.\n * Tools are functions that can be called by the chat application.\n */\nexport interface PluginTool {\n  /** Human-readable description of what the tool does */\n  description?: string;\n  /** JSON schema defining the expected input parameters */\n  inputSchema?: Record<string, any>;\n  /** Unique identifier for the tool within the plugin */\n  name: string;\n}\n\n/**\n * Definition of a resource (asset) that a plugin can provide.\n * Resources can be images, data files, or other assets needed by the plugin.\n */\nexport interface PluginResource {\n  /** MIME type of the resource (e.g., 'image/png', 'application/json') */\n  mimeType?: string;\n  /** Optional display name for the resource */\n  name?: string;\n  /** URI where the resource can be accessed */\n  uri: string;\n}\n\n/**\n * Definition of an argument for a prompt template.\n * Arguments allow users to customize the prompt when using it.\n */\nexport interface PromptArgument {\n  /** Human-readable description of the argument's purpose */\n  description?: string;\n  /** Argument identifier */\n  name: string;\n  /** Whether the argument must be provided (defaults to false if omitted) */\n  required?: boolean;\n  /** Data type of the argument (e.g., 'string', 'number') */\n  type?: string;\n}\n\n/**\n * Definition of a prompt template that a plugin can provide.\n * Prompts are pre-defined templates that can be used in conversations.\n */\nexport interface PluginPrompt {\n  /** List of customizable arguments for this prompt */\n  arguments?: PromptArgument[];\n  /** Human-readable description of what the prompt does */\n  description: string;\n  /** Unique identifier for the prompt within the plugin */\n  name: string;\n}\n","import { z } from 'zod';\n\n/**\n * Connection types for plugin communication.\n * - http: The plugin communicates via HTTP protocol\n * - stdio: The plugin communicates via standard input/output\n */\nexport const ConnectionTypeEnum = z.enum(['http', 'stdio']);\nexport type ConnectionType = z.infer<typeof ConnectionTypeEnum>;\n\n/**\n * Plugin installation methods.\n * Different ways to install and deploy a plugin.\n */\nexport const InstallationMethodEnum = z.enum([\n  'npm', // Node.js package manager\n  'go', // Go language\n  'python', // Python language\n  'docker', // Docker container\n  'git', // Git repository\n  'binaryUrl', // Direct binary download URL\n  'manual', // Manual installation with instructions\n  'none', // No installation required\n]);\nexport type InstallationMethod = z.infer<typeof InstallationMethodEnum>;\n\n/**\n * System dependency required by a plugin.\n * Defines a software dependency that must be installed on the system.\n */\nexport interface SystemDependency {\n  /** Command to check if the dependency is installed */\n  checkCommand?: string;\n  /** Description of what this dependency is for */\n  description?: string;\n  /** Platform-specific installation instructions */\n  installInstructions?: Record<string, string>;\n  /** Name of the dependency */\n  name: string;\n  /** Minimum required version */\n  requiredVersion?: string;\n  /** Type of dependency (e.g., 'runtime', 'library') */\n  type?: string;\n  /** Whether version parsing is required to check compatibility */\n  versionParsingRequired?: boolean;\n}\n\n/**\n * Connection configuration for a plugin.\n * Defines how the application should communicate with the plugin.\n */\nexport interface ConnectionConfig {\n  /** Command-line arguments for the plugin process */\n  args?: string[];\n  /** Command to execute to start the plugin */\n  command?: string;\n  /** Type of connection (http or stdio) */\n  type: ConnectionType;\n  /** URL for HTTP-based plugins */\n  url?: string;\n}\n\n/**\n * Details for installing a plugin.\n * Provides specific information needed during the installation process.\n */\nexport interface InstallationDetails {\n  /** Package name for npm, pip, or other package managers */\n  packageName?: string;\n  /** Git repository URL to clone */\n  repositoryUrlToClone?: string;\n  /** Ordered list of setup steps to execute after installation */\n  setupSteps?: string[];\n}\n\n/**\n * Deployment option for a plugin.\n * A plugin can offer multiple deployment options, each with different requirements.\n */\nexport interface DeploymentOption {\n  /** Connection configuration for this deployment option */\n  connection: ConnectionConfig;\n  /** Human-readable description of this deployment option */\n  description?: string;\n  /** Detailed installation instructions */\n  installationDetails?: InstallationDetails;\n  /** Method used to install this plugin */\n  installationMethod: string;\n  /** Whether this is the recommended deployment option */\n  isRecommended?: boolean;\n  /** System dependencies required for this deployment option */\n  systemDependencies?: SystemDependency[];\n}\n"],"mappings":";AACA,SAAS,KAAAA,UAAS;;;ACDlB,SAAS,KAAAC,UAAS;;;ACClB,SAAS,SAAS;AAMX,IAAM,2BAA2B,EAAE,OAAO;AAAA;AAAA,EAE/C,SAAS,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA;AAAA,EAElC,WAAW,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA;AAAA,EAEpC,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAClC,CAAC;;;ADSM,IAAM,uBAAuBC,GAAE,OAAO;AAAA,EAC3C,QAAQA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,cAAc;AAAA,EACd,UAAUA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,cAAcA,GAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EAClC,WAAWA,GAAE,OAAO;AAAA,EACpB,aAAaA,GAAE,OAAO;AAAA,EACtB,UAAUA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,MAAMA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,YAAYA,GAAE,OAAO;AAAA,EACrB,cAAcA,GAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EAClC,YAAYA,GAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EACrC,aAAaA,GAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EACtC,aAAaA,GAAE,OAAO;AAAA,EACtB,MAAMA,GAAE,OAAO;AAAA,EACf,cAAcA,GAAE,OAAO,EAAE,SAAS;AAAA,EAClC,eAAeA,GAAE,OAAO,EAAE,SAAS;AAAA,EACnC,aAAaA,GAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EACjC,gBAAgBA,GAAE,OAAO,EAAE,SAAS;AAAA,EACpC,MAAMA,GAAE,MAAMA,GAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACnC,YAAYA,GAAE,OAAO,EAAE,SAAS;AAAA,EAChC,WAAWA,GAAE,OAAO;AACtB,CAAC;;;ADnCM,IAAM,wBAAwB,qBAAqB,OAAO;AAAA;AAAA,EAE/D,QAAQC,GAAE,KAAK,CAAC,aAAa,eAAe,YAAY,YAAY,CAAU;AAAA;AAAA,EAE9E,YAAYA,GAAE,KAAK,CAAC,UAAU,WAAW,UAAU,CAAU;AAC/D,CAAC;;;AGfD,SAAS,KAAAC,UAAS;AAOX,IAAM,qBAAqBA,GAAE,KAAK,CAAC,QAAQ,OAAO,CAAC;AAOnD,IAAM,yBAAyBA,GAAE,KAAK;AAAA,EAC3C;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AACF,CAAC;","names":["z","z","z","z","z"]}

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "@lobehub/market-types",
-  "version": "1.0.4",
+  "version": "1.0.6",
+  "homepage": "https://github.com/lobehub/lobehub-market",
+  "bugs": {
+    "url": "https://github.com/lobehub/lobehub-market/issues/new/choose"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lobehub/lobehub-market.git"
+  },
   "license": "MIT",
+  "author": "LobeHub <i@lobehub.com>",
   "sideEffects": false,
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",