@lobehub/market-sdk 0.25.0 → 0.25.1-beta.1

package/dist/index.d.mts

@@ -1568,6 +1568,55 @@ interface PaginationQuery {
     /** Number of results to skip */
     offset?: number;
 }
+/**
+ * Client Info
+ *
+ * Client environment information for debugging feedback
+ */
+interface FeedbackClientInfo {
+    /** Browser/app language */
+    language?: string;
+    /** Screen resolution (e.g., "1920x1080") */
+    screenResolution?: string;
+    /** User timezone */
+    timezone?: string;
+    /** Current page URL */
+    url?: string;
+    /** Browser user agent string */
+    userAgent?: string;
+    /** Viewport dimensions (e.g., "1280x720") */
+    viewport?: string;
+}
+/**
+ * Submit Feedback Request
+ *
+ * Request body for submitting user feedback
+ */
+interface SubmitFeedbackRequest {
+    /** Optional client environment information */
+    clientInfo?: FeedbackClientInfo;
+    /** User email address (required for contact) */
+    email: string;
+    /** Detailed feedback message (1-5000 characters) */
+    message: string;
+    /** Optional screenshot URL */
+    screenshotUrl?: string;
+    /** Feedback title/subject (1-200 characters) */
+    title: string;
+}
+/**
+ * Submit Feedback Response
+ *
+ * Response structure for submit feedback endpoint
+ */
+interface SubmitFeedbackResponse {
+    /** Created issue ID in Linear */
+    issueId: string;
+    /** URL to view the issue in Linear */
+    issueUrl: string;
+    /** Whether the submission was successful */
+    success: boolean;
+}
 
 /**
  * Base SDK class
@@ -1649,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
@@ -2513,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
@@ -2859,6 +3112,45 @@ declare class AuthService extends BaseSDK {
     }>;
 }
 
+/**
+ * Feedback Service
+ *
+ * Provides functionality for submitting user feedback to the LobeHub Marketplace.
+ * Feedback is tracked in Linear for follow-up.
+ *
+ * Note: This endpoint is rate-limited to 3 requests per minute per IP.
+ */
+declare class FeedbackService extends BaseSDK {
+    /**
+     * Submits user feedback
+     *
+     * Creates a feedback issue in Linear for tracking and follow-up.
+     * Email is required for contact purposes.
+     *
+     * Rate limit: 3 requests per minute per IP
+     *
+     * @param data - The feedback data to submit
+     * @param options - Optional request options
+     * @returns Promise resolving to the feedback submission response
+     * @throws Error if rate limit is exceeded (429) or submission fails
+     *
+     * @example
+     * ```typescript
+     * const response = await sdk.feedback.submitFeedback({
+     *   email: 'user@example.com',
+     *   title: 'Feature request',
+     *   message: 'It would be great if...',
+     *   clientInfo: {
+     *     url: window.location.href,
+     *     userAgent: navigator.userAgent,
+     *   },
+     * });
+     * console.log('Feedback submitted:', response.issueUrl);
+     * ```
+     */
+    submitFeedback(data: SubmitFeedbackRequest, options?: globalThis.RequestInit): Promise<SubmitFeedbackResponse>;
+}
+
 /**
  * Plugins Service
  *
@@ -3470,6 +3762,11 @@ declare class MarketSDK extends BaseSDK {
      * Provides methods to like/unlike content and retrieve like lists
      */
     readonly likes: UserLikeService;
+    /**
+     * Feedback service for submitting user feedback
+     * Provides methods to submit feedback which is tracked in Linear
+     */
+    readonly feedback: FeedbackService;
     /**
      * Discovery service for retrieving API service information
      * Used to get information about available endpoints and services
@@ -3578,4 +3875,4 @@ declare function buildTrustedClientPayload(params: {
     userId: string;
 }): TrustedClientPayload;
 
-export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FollowListItem, type FollowListResponse, type FollowRequest, type GetCommandOutputParams, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListLocalFilesParams, MarketAdmin, MarketSDK, type MarketSDKOptions, type MoveLocalFilesParams, type MoveOperation, type OAuthTokenResponse, type OwnAgentListQuery, type PaginationQuery, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshTokenRequest, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, type SearchLocalFilesParams, type SharedTokenState, StatusEnumSchema, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };
+export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetCommandOutputParams, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListLocalFilesParams, MarketAdmin, MarketSDK, type MarketSDKOptions, type MoveLocalFilesParams, type MoveOperation, type OAuthTokenResponse, type OwnAgentListQuery, type PaginationQuery, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshTokenRequest, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, type SearchLocalFilesParams, type SharedTokenState, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };