@lobehub/market-sdk 0.31.5 → 0.31.7

package/dist/index.d.mts

@@ -350,7 +350,7 @@ interface AgentListQuery {
     /** Search query string */
     q?: string;
     /** Sort field */
-    sort?: 'createdAt' | 'updatedAt' | 'name' | 'tokenUsage' | 'knowledgeCount' | 'pluginCount' | 'recommended' | 'relevance';
+    sort?: 'createdAt' | 'knowledgeCount' | 'mostUsage' | 'name' | 'pluginCount' | 'recommended' | 'relevance' | 'tokenUsage' | 'updatedAt';
     /** Publication status filter */
     status?: 'published' | 'unpublished' | 'archived' | 'deprecated' | 'all';
     /** Visibility filter */
@@ -892,7 +892,7 @@ interface OwnAgentListQuery {
     /** Search query string */
     q?: string;
     /** Sort field */
-    sort?: 'createdAt' | 'updatedAt' | 'name' | 'tokenUsage' | 'knowledgeCount' | 'pluginCount';
+    sort?: 'createdAt' | 'knowledgeCount' | 'mostUsage' | 'name' | 'pluginCount' | 'tokenUsage' | 'updatedAt';
     /** Filter by specific status, if not provided returns all statuses */
     status?: AgentStatus;
 }
@@ -1768,7 +1768,7 @@ interface PluginQueryParams {
     /** Search query string */
     q?: string;
     /** Field to sort by */
-    sort?: 'installCount' | 'createdAt' | 'updatedAt' | 'ratingAverage' | 'ratingCount' | 'isFeatured' | 'isValidated' | 'recommended' | 'relevance' | 'stars';
+    sort?: 'commentCount' | 'createdAt' | 'githubUpdateAt' | 'installCount' | 'isFeatured' | 'isValidated' | 'ratingAverage' | 'ratingCount' | 'recommended' | 'relevance' | 'stars' | 'updatedAt';
     /** Filter by tags (comma-separated) */
     tags?: string;
 }
@@ -2522,7 +2522,7 @@ interface MarketSkillListQuery {
      * Sort field
      * @default 'createdAt'
      */
-    sort?: 'commentCount' | 'createdAt' | 'forks' | 'installCount' | 'name' | 'ratingAverage' | 'relevance' | 'stars' | 'updatedAt' | 'watchers';
+    sort?: 'commentCount' | 'createdAt' | 'forks' | 'installCount' | 'name' | 'ratingAverage' | 'recommended' | 'relevance' | 'stars' | 'updatedAt' | 'watchers';
 }
 /**
  * Query parameters for getting skill detail
@@ -3050,10 +3050,12 @@ interface MarketSkillVersionsResponse {
  * Author information for a skill comment
  */
 interface SkillCommentAuthor {
-    avatarUrl?: string | null;
+    avatar?: string;
+    background?: string | null;
     displayName?: string | null;
-    id: number;
-    namespace?: string;
+    id?: number;
+    identifier?: string;
+    sourceType?: string | null;
     tags?: string[];
     type: 'agent' | 'user';
 }
@@ -3061,19 +3063,63 @@ interface SkillCommentAuthor {
  * A single skill comment item
  */
 interface SkillCommentItem {
-    agentId: number | null;
     author: SkillCommentAuthor | null;
     content: string;
     createdAt: string;
     downvotes: number;
     id: number;
     parentId: number | null;
+    rating?: number;
     replyCount: number;
+    updatedAt: string;
+    upvotes: number;
+}
+/**
+ * A single skill comment list item
+ */
+type SkillCommentListItem = SkillCommentItem;
+/**
+ * Created skill comment entity
+ */
+interface SkillCommentCreateItem {
+    agentId: number | null;
+    content: string;
+    createdAt: string;
+    downvotes: number;
+    id: number;
+    parentId: number | null;
     skillId: number;
     updatedAt: string;
     upvotes: number;
     userId: number | null;
 }
+/**
+ * Rating payload returned when creating a comment with a score
+ */
+interface SkillCommentRating {
+    score: number;
+}
+/**
+ * Response returned by the create comment endpoint
+ */
+interface SkillCommentCreateResponse extends SkillCommentCreateItem {
+    rating?: SkillCommentRating;
+}
+/**
+ * Latest comment for the authenticated user/agent on a skill
+ */
+interface SkillLatestOwnComment {
+    createdAt: string;
+    id: number;
+    parentId: number | null;
+    replyCount: number;
+}
+/**
+ * Response returned by the delete comment endpoint
+ */
+interface SkillCommentDeleteResponse {
+    success: boolean;
+}
 /**
  * Query parameters for listing skill comments
  */
@@ -6240,6 +6286,14 @@ declare class MarketSkillService extends BaseSDK {
      * @returns Promise resolving to the paginated comment list
      */
     getComments(identifier: string, params?: SkillCommentListQuery, options?: globalThis.RequestInit): Promise<SkillCommentListResponse>;
+    /**
+     * Gets the latest comment for the authenticated user or agent on a skill
+     *
+     * @param identifier - Unique skill identifier
+     * @param options - Optional request options
+     * @returns Promise resolving to the latest own comment or null when none exists
+     */
+    getLatestOwnComment(identifier: string, options?: globalThis.RequestInit): Promise<SkillLatestOwnComment | null>;
     /**
      * Creates a comment on a skill, optionally with a rating
      *
@@ -6251,11 +6305,16 @@ declare class MarketSkillService extends BaseSDK {
     createComment(identifier: string, data: {
         content: string;
         score?: number;
-    }, options?: globalThis.RequestInit): Promise<SkillCommentItem & {
-        rating?: {
-            score: number;
-        };
-    }>;
+    }, options?: globalThis.RequestInit): Promise<SkillCommentCreateResponse>;
+    /**
+     * Deletes a comment from a skill
+     *
+     * @param identifier - Unique skill identifier
+     * @param commentId - Comment ID to delete
+     * @param options - Optional request options
+     * @returns Promise resolving to success status
+     */
+    deleteComment(identifier: string, commentId: number, options?: globalThis.RequestInit): Promise<SkillCommentDeleteResponse>;
     /**
      * Adds or updates a reaction on a comment
      *
@@ -6718,11 +6777,6 @@ declare class MarketSDK extends BaseSDK {
     registerClient(request: ClientRegistrationRequest): Promise<ClientRegistrationResponse>;
 }
 
-/**
- * Market API Error
- *
- * Custom error class for Market API errors that preserves the structured error response.
- */
 declare class MarketAPIError extends Error {
     /** HTTP status code */
     readonly status: number;
@@ -6830,4 +6884,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 AgentForkItem, type AgentForkRequest, type AgentForkResponse, type AgentForkSourceResponse, type AgentForksResponse, type AgentGroupCreateRequest, type AgentGroupCreateResponse, type AgentGroupDetail, type AgentGroupDetailQuery, type AgentGroupForkItem, type AgentGroupForkRequest, type AgentGroupForkResponse, type AgentGroupForkSourceResponse, type AgentGroupForksResponse, type AgentGroupItem, type AgentGroupListQuery, type AgentGroupListResponse, type AgentGroupModifyRequest, type AgentGroupModifyResponse, type AgentGroupStatus, type AgentGroupStatusChangeResponse, type AgentGroupVersionCreateRequest, type AgentGroupVersionCreateResponse, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentProfileEntity, type AgentProfileResponse, 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 AuthorizeParams, type AuthorizeResponse, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type CreateMemberAgent, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAPIError, MarketAdmin, type MarketReportGitHubSkillParams, type MarketReportGitHubSkillResponse, type MarketReportSkillInstallParams, type MarketReportSkillInstallResponse, MarketSDK, type MarketSDKOptions, type MarketSkillAuthor, type MarketSkillCategory, type MarketSkillCategoryQuery, type MarketSkillDetail, type MarketSkillDetailQuery, type MarketSkillGitHubMeta, type MarketSkillListItem, type MarketSkillListQuery, type MarketSkillListResponse, type MarketSkillManifest, type MarketSkillResource, type MarketSkillVersionSummary, type MarketSkillVersionsResponse, type MemberAgent, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OwnAgentGroupListQuery, 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 RefreshConnectionResponse, type RefreshTokenRequest, type RegisterUserRequest, type RegisterUserResponse, type RegisteredUserProfile, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, SDK_USER_AGENT, SDK_VERSION, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillCommentAuthor, type SkillCommentItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillErrorResponse, type SkillProviderInfo, type SkillProviderStatus, type SkillRatingDistribution, type SkillTool, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateAgentProfileRequest, type UpdateAgentProfileResponse, type UpdateMemberAgent, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentGroupItem, 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 AgentForkItem, type AgentForkRequest, type AgentForkResponse, type AgentForkSourceResponse, type AgentForksResponse, type AgentGroupCreateRequest, type AgentGroupCreateResponse, type AgentGroupDetail, type AgentGroupDetailQuery, type AgentGroupForkItem, type AgentGroupForkRequest, type AgentGroupForkResponse, type AgentGroupForkSourceResponse, type AgentGroupForksResponse, type AgentGroupItem, type AgentGroupListQuery, type AgentGroupListResponse, type AgentGroupModifyRequest, type AgentGroupModifyResponse, type AgentGroupStatus, type AgentGroupStatusChangeResponse, type AgentGroupVersionCreateRequest, type AgentGroupVersionCreateResponse, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentProfileEntity, type AgentProfileResponse, 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 AuthorizeParams, type AuthorizeResponse, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type CreateMemberAgent, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAPIError, MarketAdmin, type MarketReportGitHubSkillParams, type MarketReportGitHubSkillResponse, type MarketReportSkillInstallParams, type MarketReportSkillInstallResponse, MarketSDK, type MarketSDKOptions, type MarketSkillAuthor, type MarketSkillCategory, type MarketSkillCategoryQuery, type MarketSkillDetail, type MarketSkillDetailQuery, type MarketSkillGitHubMeta, type MarketSkillListItem, type MarketSkillListQuery, type MarketSkillListResponse, type MarketSkillManifest, type MarketSkillResource, type MarketSkillVersionSummary, type MarketSkillVersionsResponse, type MemberAgent, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OwnAgentGroupListQuery, 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 RefreshConnectionResponse, type RefreshTokenRequest, type RegisterUserRequest, type RegisterUserResponse, type RegisteredUserProfile, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, SDK_USER_AGENT, SDK_VERSION, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillCommentAuthor, type SkillCommentCreateItem, type SkillCommentCreateResponse, type SkillCommentDeleteResponse, type SkillCommentItem, type SkillCommentListItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillCommentRating, type SkillErrorResponse, type SkillLatestOwnComment, type SkillProviderInfo, type SkillProviderStatus, type SkillRatingDistribution, type SkillTool, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateAgentProfileRequest, type UpdateAgentProfileResponse, type UpdateMemberAgent, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentGroupItem, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };

package/dist/index.mjs

@@ -7,11 +7,30 @@ import { SignJWT } from "jose";
 import urlJoin from "url-join";
 
 // src/core/MarketAPIError.ts
+var normalizeErrorDetails = (errorBody) => {
+  if (!errorBody) return void 0;
+  if (typeof errorBody.error === "object" && errorBody.error !== null) {
+    return errorBody.error;
+  }
+  if (typeof errorBody.error === "string") {
+    return {
+      ...errorBody.code ? { code: errorBody.code } : {},
+      message: errorBody.error
+    };
+  }
+  if (typeof errorBody.message === "string") {
+    return {
+      ...errorBody.code ? { code: errorBody.code } : {},
+      message: errorBody.message
+    };
+  }
+  return void 0;
+};
 var MarketAPIError = class _MarketAPIError extends Error {
   constructor(status, statusText, errorBody) {
-    var _a, _b;
-    const errorCode = (_a = errorBody == null ? void 0 : errorBody.error) == null ? void 0 : _a.code;
-    const errorMessage = (_b = errorBody == null ? void 0 : errorBody.error) == null ? void 0 : _b.message;
+    const errorDetails = normalizeErrorDetails(errorBody);
+    const errorCode = errorDetails == null ? void 0 : errorDetails.code;
+    const errorMessage = errorDetails == null ? void 0 : errorDetails.message;
     const message = errorMessage || statusText;
     super(message);
     this.name = "MarketAPIError";
@@ -32,8 +51,7 @@ var MarketAPIError = class _MarketAPIError extends Error {
    * Get the full error details from the API response
    */
   getErrorDetails() {
-    var _a;
-    return (_a = this.errorBody) == null ? void 0 : _a.error;
+    return normalizeErrorDetails(this.errorBody);
   }
   /**
    * Convert to a plain object for logging or serialization
@@ -3942,6 +3960,26 @@ var MarketSkillService = class extends BaseSDK {
     );
     return result;
   }
+  /**
+   * Gets the latest comment for the authenticated user or agent on a skill
+   *
+   * @param identifier - Unique skill identifier
+   * @param options - Optional request options
+   * @returns Promise resolving to the latest own comment or null when none exists
+   */
+  async getLatestOwnComment(identifier, options) {
+    log19("Getting latest own comment for skill %s", identifier);
+    const result = await this.request(
+      `/v1/skills/${encodeURIComponent(identifier)}/comments/latest`,
+      options
+    );
+    if (result) {
+      log19("Retrieved latest own comment for skill %s: id=%d", identifier, result.id);
+    } else {
+      log19("No own comments found for skill %s", identifier);
+    }
+    return result;
+  }
   /**
    * Creates a comment on a skill, optionally with a rating
    *
@@ -3963,6 +4001,26 @@ var MarketSkillService = class extends BaseSDK {
     log19("Comment created on skill %s: id=%d", identifier, result.id);
     return result;
   }
+  /**
+   * Deletes a comment from a skill
+   *
+   * @param identifier - Unique skill identifier
+   * @param commentId - Comment ID to delete
+   * @param options - Optional request options
+   * @returns Promise resolving to success status
+   */
+  async deleteComment(identifier, commentId, options) {
+    log19("Deleting comment %d from skill %s", commentId, identifier);
+    const result = await this.request(
+      `/v1/skills/${encodeURIComponent(identifier)}/comments/${commentId}`,
+      {
+        ...options,
+        method: "DELETE"
+      }
+    );
+    log19("Comment %d deleted from skill %s", commentId, identifier);
+    return result;
+  }
   /**
    * Adds or updates a reaction on a comment
    *