@lobehub/market-sdk 0.25.1 → 0.26.1

package/dist/index.d.mts

@@ -1,7 +1,7 @@
+import { z } from 'zod';
 import { AgentItem, MarketItemBase, PluginConnectionType, InstallFailureAnalysisQuery, InstallFailureAnalysis, RangeQuery, RangeStats, TopPluginsQuery, TopPlugin, PluginManifest, AdminPluginItem, AdminPluginItemDetail, PluginVersion, PluginVersionLocalization, AdminDeploymentOption, InstallationDetails, SystemDependency, IncompleteI18nPlugin, CategoryListQuery, CategoryItem, PluginItemDetail, InstallReportRequest, InstallReportResponse, CallReportRequest, CallReportResponse, CloudGatewayRequest, CloudGatewayResponse } from '@lobehub/market-types';
 export * from '@lobehub/market-types';
 export { CategoryItem, CategoryListQuery, CategoryListResponse } from '@lobehub/market-types';
-import { z } from 'zod';
 
 /**
  * Visibility levels for plugins in the marketplace
@@ -1698,6 +1698,250 @@ declare class BaseSDK {
     private fetchNewToken;
 }
 
+/**
+ * Admin Agent Item
+ * Agent item with admin-specific fields for management
+ */
+interface AdminAgentItem {
+    /** Author information */
+    author?: {
+        avatar?: string;
+        name?: string;
+        userName?: string;
+    };
+    /** Avatar URL or emoji */
+    avatar?: string;
+    /** Category name */
+    category?: string;
+    /** Agent configuration */
+    config?: any;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Description */
+    description?: string;
+    /** Agent ID */
+    id: string;
+    /** Agent identifier */
+    identifier: string;
+    /** Install count */
+    installCount?: number;
+    /** Whether featured */
+    isFeatured?: boolean;
+    /** Whether officially maintained */
+    isOfficial: boolean;
+    /** Number of knowledge bases attached */
+    knowledgeCount?: number;
+    /** Display name */
+    name: string;
+    /** Owner ID */
+    ownerId: number;
+    /** Number of plugins attached */
+    pluginCount?: number;
+    /** Provider ID */
+    providerId?: number;
+    /** Safety check result */
+    safetyCheck?: string | null;
+    /** Publication status */
+    status?: string;
+    /** Tags */
+    tags?: string[];
+    /** Token usage */
+    tokenUsage?: number;
+    /** Update timestamp */
+    updatedAt: string;
+    /** URL */
+    url?: string;
+    /** Version name */
+    versionName?: string;
+    /** Version number */
+    versionNumber?: number;
+    /** Version list */
+    versions?: Array<{
+        isLatest: boolean;
+        isValidated: boolean;
+        updatedAt: string;
+        version: string;
+        versionNumber: number;
+    }>;
+}
+/**
+ * Admin Agent Item Detail
+ * Extended agent detail with admin-specific fields
+ */
+interface AdminAgentItemDetail extends AgentItemDetail {
+    /** Safety check result */
+    safetyCheck?: string | null;
+}
+/**
+ * Agent list query parameters for admin
+ */
+interface AdminAgentListQueryParams extends AdminListQueryParams {
+    /** Filter by category */
+    category?: string;
+    /** Filter by official status */
+    isOfficial?: 'true' | 'false';
+    /** Filter by namespace */
+    namespace?: string;
+    /** Filter by status */
+    status?: 'published' | 'unpublished' | 'archived' | 'deprecated' | 'all';
+    /** Filter by visibility */
+    visibility?: 'public' | 'private' | 'internal' | 'all';
+}
+/**
+ * Agent update parameters
+ */
+interface AgentUpdateParams {
+    /** Official homepage or repository URL for the agent */
+    homepage?: string | null;
+    /** Unique identifier for the agent */
+    identifier?: string;
+    /** Whether this agent is featured */
+    isFeatured?: boolean;
+    /** Whether this agent is officially maintained by LobeHub */
+    isOfficial?: boolean;
+    /** Default name of the agent */
+    name?: string;
+    /** Safety check result */
+    safetyCheck?: string | null;
+    /** Publication status */
+    status?: 'published' | 'unpublished' | 'archived' | 'deprecated';
+    /** Visibility level */
+    visibility?: 'public' | 'private' | 'internal';
+}
+/**
+ * Agent by status response item
+ */
+interface AgentByStatusItem {
+    id: number;
+    identifier: string;
+    name: string;
+    status: AgentStatus;
+    updatedAt: string | null;
+}
+/**
+ * Agent version by status response item
+ */
+interface AgentVersionByStatusItem {
+    agentId: number;
+    agentName: string;
+    identifier: string;
+    status: AgentStatus;
+    updatedAt: string | null;
+    version: string;
+    versionId: number;
+}
+/**
+ * Agent Management Service
+ *
+ * Provides administrative functionality for managing agents in the marketplace.
+ * This service handles CRUD operations for agents, agent status, and visibility.
+ */
+declare class AgentService$1 extends BaseSDK {
+    /**
+     * Retrieves a list of agents with admin details
+     *
+     * Supports filtering, pagination, and sorting of results.
+     *
+     * @param params - Query parameters for filtering and pagination
+     * @returns Promise resolving to the agent list response with admin details
+     */
+    getAgents(params?: AdminAgentListQueryParams): Promise<AdminListResponse<AdminAgentItem>>;
+    /**
+     * Retrieves agents filtered by status
+     *
+     * @param status - The status to filter by
+     * @returns Promise resolving to agents matching the status
+     */
+    getAgentsByStatus(status: AgentStatus): Promise<{
+        data: AgentByStatusItem[];
+        total: number;
+    }>;
+    /**
+     * Retrieves agent versions filtered by status
+     *
+     * @param status - The status to filter by
+     * @returns Promise resolving to agent versions matching the status
+     */
+    getAgentVersionsByStatus(status: AgentStatus): Promise<{
+        data: AgentVersionByStatusItem[];
+        total: number;
+    }>;
+    /**
+     * Retrieves a single agent with full admin details
+     *
+     * @param id - Agent ID or identifier
+     * @param options - Optional query parameters
+     * @returns Promise resolving to the detailed agent information
+     */
+    getAgent(id: number | string, options?: {
+        locale?: string;
+        version?: string;
+    }): Promise<AdminAgentItemDetail>;
+    /**
+     * Updates agent information
+     *
+     * @param id - Agent ID or identifier
+     * @param data - Agent update data containing fields to update
+     * @returns Promise resolving to the updated agent
+     */
+    updateAgent(id: number | string, data: AgentUpdateParams): Promise<AdminAgentItem>;
+    /**
+     * Updates agent publication status
+     *
+     * @param id - Agent ID or identifier
+     * @param status - New status to set
+     * @returns Promise resolving to success response
+     */
+    updateAgentStatus(id: number | string, status: 'published' | 'unpublished' | 'archived' | 'deprecated'): Promise<{
+        message: string;
+        success: boolean;
+    }>;
+    /**
+     * Updates agent visibility
+     *
+     * @param id - Agent ID or identifier
+     * @param visibility - New visibility setting
+     * @returns Promise resolving to success response
+     */
+    updateAgentVisibility(id: number | string, visibility: 'public' | 'private' | 'internal'): Promise<{
+        message: string;
+        success: boolean;
+    }>;
+    /**
+     * Deletes an agent
+     *
+     * @param id - Agent ID or identifier
+     * @returns Promise resolving to success response
+     */
+    deleteAgent(id: number | string): Promise<{
+        message: string;
+        success: boolean;
+    }>;
+    /**
+     * Updates status for multiple agents in a single operation
+     *
+     * @param ids - Array of agent IDs to update
+     * @param status - New status to set for all specified agents
+     * @returns Promise resolving to success response
+     */
+    batchUpdateAgentStatus(ids: number[], status: 'published' | 'unpublished' | 'archived' | 'deprecated'): Promise<{
+        message: string;
+        success: boolean;
+        updatedCount: number;
+    }>;
+    /**
+     * Deletes multiple agents in a single operation
+     *
+     * @param ids - Array of agent IDs to delete
+     * @returns Promise resolving to success response
+     */
+    batchDeleteAgents(ids: number[]): Promise<{
+        deletedCount: number;
+        message: string;
+        success: boolean;
+    }>;
+}
+
 /**
  * Market Overview Statistics Interface
  * Defines the structure for market overview data
@@ -2562,21 +2806,29 @@ declare class PluginEnvService extends BaseSDK {
  * LobeHub Market Admin SDK Client
  *
  * Client for accessing administrative functionality of the LobeHub Marketplace.
- * This SDK provides privileged operations for managing plugins, reviews,
+ * This SDK provides privileged operations for managing agents, plugins, reviews,
  * system settings, and dependencies. It requires admin-level authentication.
  */
 declare class MarketAdmin extends BaseSDK {
+    /**
+     * Agent management service
+     * Provides methods for creating, updating, and managing agents
+     */
+    readonly agents: AgentService$1;
     /**
      * Market analysis service
      * Provides methods for accessing market analytics and statistics
      */
     readonly analysis: AnalysisService;
+    /**
+     * Plugin environment service
+     */
+    readonly env: PluginEnvService;
     /**
      * Plugin management service
      * Provides methods for creating, updating, and managing plugins
      */
     readonly plugins: PluginService;
-    readonly env: PluginEnvService;
     /**
      * Review management service
      * Provides methods for moderating and managing user reviews