@lobehub/market-sdk 0.25.1 → 0.26.0

package/dist/index.d.mts

@@ -1698,6 +1698,202 @@ declare class BaseSDK {
     private fetchNewToken;
 }
 
+/**
+ * Admin Agent Item
+ * Extended agent item with admin-specific fields
+ */
+interface AdminAgentItem extends AgentItem {
+    /** Number of knowledge bases attached to the agent */
+    knowledgeCount?: number;
+    /** Owner ID of the agent */
+    ownerId: number;
+    /** Number of plugins attached to the agent */
+    pluginCount?: number;
+    /** Safety check result */
+    safetyCheck?: string | null;
+    /** Publication status */
+    status?: string;
+    /** Token usage */
+    tokenUsage?: 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 +2758,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