@lobehub/market-sdk 0.28.2 → 0.28.4-beta.1

package/dist/index.d.mts

@@ -801,6 +801,590 @@ interface OwnAgentListQuery {
     /** Filter by specific status, if not provided returns all statuses */
     status?: AgentStatus;
 }
+/**
+ * Agent fork request parameters
+ * Defines the request body for forking an agent
+ */
+interface AgentForkRequest {
+    /** New agent identifier (required, must be globally unique) */
+    identifier: string;
+    /** New agent name (optional, defaults to "{original name} (Fork)") */
+    name?: string;
+    /** Status of the forked agent (optional, defaults to published) */
+    status?: 'published' | 'unpublished' | 'archived' | 'deprecated';
+    /** Version number to fork (optional, defaults to current version) */
+    versionNumber?: number;
+    /** Visibility of the forked agent (optional, defaults to public) */
+    visibility?: 'public' | 'private' | 'internal';
+}
+/**
+ * Agent fork response structure
+ * Defines the structure of the agent fork API response
+ */
+interface AgentForkResponse {
+    /** The newly created agent */
+    agent: {
+        createdAt: string;
+        forkedFromAgentId: number;
+        id: number;
+        identifier: string;
+        name: string;
+        ownerId: number;
+        updatedAt: string;
+    };
+    /** Information about the source agent */
+    source: {
+        agentId: number;
+        identifier: string;
+        versionNumber: number;
+    };
+    /** The initial version created for the forked agent */
+    version: {
+        agentId: number;
+        createdAt: string;
+        id: number;
+        versionNumber: number;
+    };
+}
+/**
+ * Agent fork item structure
+ * Represents a single forked agent in the forks list
+ */
+interface AgentForkItem {
+    createdAt: string;
+    forkCount: number;
+    id: number;
+    identifier: string;
+    name: string;
+    ownerId: number;
+}
+/**
+ * Agent forks list response
+ * Response structure for listing all forks of an agent
+ */
+interface AgentForksResponse {
+    forks: AgentForkItem[];
+    totalCount: number;
+}
+/**
+ * Agent fork source response
+ * Response structure for getting the source agent that this agent was forked from
+ */
+interface AgentForkSourceResponse {
+    source: AgentForkItem | null;
+}
+
+/**
+ * Agent Group Types
+ *
+ * Type definitions for agent group-related API requests and responses
+ */
+/**
+ * Agent group list query parameters
+ */
+interface AgentGroupListQuery {
+    /** Filter by category */
+    category?: string;
+    /** Filter by official status */
+    isOfficial?: 'true' | 'false';
+    /** Locale for localized content */
+    locale?: string;
+    /** Sort order */
+    order?: 'asc' | 'desc';
+    /** Filter by owner ID */
+    ownerId?: number | string;
+    /** Current page number (1-based) */
+    page?: number;
+    /** Number of items per page */
+    pageSize?: number;
+    /** Search query string */
+    q?: string;
+    /** Sort field */
+    sort?: 'createdAt' | 'updatedAt' | 'name' | 'recommended';
+    /** Publication status filter */
+    status?: 'published' | 'unpublished' | 'archived' | 'deprecated' | 'all';
+    /** Visibility filter */
+    visibility?: 'public' | 'private' | 'internal' | 'all';
+}
+/**
+ * Own agent groups list query parameters (authenticated)
+ */
+interface OwnAgentGroupListQuery {
+    /** Locale for localized content */
+    locale?: string;
+    /** Sort order */
+    order?: 'asc' | 'desc';
+    /** Current page number (1-based) */
+    page?: number;
+    /** Number of items per page */
+    pageSize?: number;
+    /** Search query string */
+    q?: string;
+    /** Sort field */
+    sort?: 'createdAt' | 'updatedAt' | 'name';
+}
+/**
+ * Agent group item in list
+ * Aligned with AgentItem structure for consistency
+ */
+interface AgentGroupItem {
+    /** Avatar URL (from current version) */
+    avatar?: string;
+    /** Background color (from current version) */
+    backgroundColor?: string;
+    /** Category (from current version) */
+    category?: string;
+    /** Comment count */
+    commentCount?: number;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Current version ID */
+    currentVersionId?: number;
+    /** Description (from current version) */
+    description?: string;
+    /** Favorite count */
+    favoriteCount?: number;
+    /** Homepage URL */
+    homepage?: string;
+    /** Unique identifier (used as id for consistency) */
+    id: string;
+    /** Unique identifier */
+    identifier: string;
+    /** Install count */
+    installCount?: number;
+    /** Whether this is a featured group */
+    isFeatured?: boolean;
+    /** Whether this is official */
+    isOfficial?: boolean;
+    /** Like count */
+    likeCount?: number;
+    /** Group name */
+    name: string;
+    /** Owner account ID */
+    ownerId: number;
+    /** Average rating */
+    ratingAverage?: number;
+    /** Rating count */
+    ratingCount?: number;
+    /** Safety check status */
+    safetyCheck?: string;
+    /** Publication status */
+    status?: 'published' | 'unpublished' | 'archived' | 'deprecated';
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Version number (from current version) */
+    versionNumber?: number;
+    /** Visibility */
+    visibility?: 'public' | 'private' | 'internal';
+}
+/**
+ * Agent group list response
+ * Aligned with AgentListResponse structure for consistency
+ */
+interface AgentGroupListResponse {
+    currentPage: number;
+    items: AgentGroupItem[];
+    pageSize: number;
+    totalCount: number;
+    totalPages: number;
+}
+/**
+ * Agent group detail query parameters
+ */
+interface AgentGroupDetailQuery {
+    /** Group identifier */
+    identifier: string;
+    /** Locale for localized content */
+    locale?: string;
+    /** Specific version number to retrieve */
+    version?: number;
+}
+/**
+ * Member agent in group
+ */
+interface MemberAgent {
+    /** A2A protocol version */
+    a2aProtocolVersion?: string;
+    /** Avatar */
+    avatar?: string;
+    /** Category */
+    category?: string;
+    /** Configuration */
+    config: any;
+    /** Default input modes */
+    defaultInputModes?: string[];
+    /** Default output modes */
+    defaultOutputModes?: string[];
+    /** Description */
+    description: string;
+    /** Display order */
+    displayOrder: number;
+    /** Documentation URL */
+    documentationUrl?: string;
+    /** Whether enabled */
+    enabled: boolean;
+    /** Extensions */
+    extensions?: any[];
+    /** Whether push notifications are supported */
+    hasPushNotifications?: boolean;
+    /** Whether state transition history is supported */
+    hasStateTransitionHistory?: boolean;
+    /** Whether streaming is supported */
+    hasStreaming?: boolean;
+    /** Unique identifier */
+    identifier: string;
+    /** Interfaces */
+    interfaces?: any[];
+    /** Name */
+    name: string;
+    /** Preferred transport */
+    preferredTransport?: string;
+    /** Role */
+    role: 'supervisor' | 'participant';
+    /** Security requirements */
+    securityRequirements?: any[];
+    /** Security schemes */
+    securitySchemes?: any;
+    /** Summary */
+    summary?: string;
+    /** Whether authenticated extended card is supported */
+    supportsAuthenticatedExtendedCard?: boolean;
+    /** Tags */
+    tags?: any;
+    /** URL */
+    url: string;
+    /** Version */
+    version: string;
+}
+/**
+ * Agent group detail response
+ */
+interface AgentGroupDetail {
+    /** Author/owner information */
+    author?: {
+        avatar?: string;
+        name?: string;
+        userName?: string;
+    };
+    group: {
+        avatar?: string;
+        backgroundColor?: string;
+        category?: string;
+        commentCount?: number;
+        config?: any;
+        createdAt: string;
+        currentVersionId?: number;
+        description: string;
+        favoriteCount?: number;
+        homepage?: string;
+        identifier: string;
+        installCount?: number;
+        isFeatured?: boolean;
+        isOfficial?: boolean;
+        likeCount?: number;
+        name: string;
+        ownerId: number;
+        ratingAverage?: number;
+        ratingCount?: number;
+        safetyCheck?: string;
+        status: string;
+        tags?: any;
+        updatedAt: string;
+        version: string;
+        versionNumber: number;
+        visibility: string;
+    };
+    /** Locale for localized content */
+    locale?: string;
+    memberAgents: MemberAgent[];
+    /** Summary extracted from description (auto-filled, max 200 chars) */
+    summary?: string;
+    /** All versions of this group */
+    versions?: Array<{
+        isLatest: boolean;
+        status: string;
+        updatedAt: string;
+        version: string;
+        versionNumber: number;
+    }>;
+}
+/**
+ * Member agent for creation
+ */
+interface CreateMemberAgent {
+    a2aProtocolVersion?: string;
+    avatar?: string;
+    category?: string;
+    config: any;
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+    description: string;
+    displayOrder?: number;
+    documentationUrl?: string;
+    extensions?: any[];
+    hasPushNotifications?: boolean;
+    hasStateTransitionHistory?: boolean;
+    hasStreaming?: boolean;
+    identifier: string;
+    interfaces?: any[];
+    name: string;
+    preferredTransport?: string;
+    role: 'supervisor' | 'participant';
+    securityRequirements?: any[];
+    securitySchemes?: any;
+    summary?: string;
+    supportsAuthenticatedExtendedCard?: boolean;
+    tags?: any;
+    url: string;
+}
+/**
+ * Create agent group request
+ */
+interface AgentGroupCreateRequest {
+    avatar?: string;
+    backgroundColor?: string;
+    category?: string;
+    config?: any;
+    description: string;
+    homepage?: string;
+    identifier: string;
+    memberAgents: CreateMemberAgent[];
+    name: string;
+    versionName?: string;
+    visibility?: 'public' | 'private' | 'internal';
+}
+/**
+ * Create agent group response
+ */
+interface AgentGroupCreateResponse {
+    group: {
+        avatar?: string;
+        backgroundColor?: string;
+        category?: string;
+        createdAt: string;
+        currentVersionId?: number;
+        description: string;
+        homepage?: string;
+        id: number;
+        identifier: string;
+        isFeatured: boolean;
+        isOfficial: boolean;
+        name: string;
+        ownerId: number;
+        status: string;
+        updatedAt: string;
+        visibility: string;
+    };
+    groupVersion: {
+        agentGroupId: number;
+        createdAt: string;
+        description: string;
+        id: number;
+        isLatest: boolean;
+        name: string;
+        status: string;
+        version: string;
+        versionNumber: number;
+    };
+    memberAgents: Array<{
+        agentGroupId: number;
+        createdAt: string;
+        displayOrder: number;
+        enabled: boolean;
+        id: number;
+        identifier: string;
+        name: string;
+        role: string;
+        updatedAt: string;
+    }>;
+}
+/**
+ * Member agent update for version create
+ */
+interface UpdateMemberAgent {
+    avatar?: string;
+    category?: string;
+    config?: any;
+    description?: string;
+    identifier: string;
+    name?: string;
+    url?: string;
+}
+/**
+ * Create agent group version request
+ */
+interface AgentGroupVersionCreateRequest {
+    avatar?: string;
+    backgroundColor?: string;
+    category?: string;
+    changelog?: string;
+    config?: any;
+    description?: string;
+    identifier: string;
+    memberAgents?: UpdateMemberAgent[];
+    name?: string;
+    tags?: any;
+}
+/**
+ * Create agent group version response
+ */
+interface AgentGroupVersionCreateResponse {
+    groupVersion: {
+        agentGroupId: number;
+        changelog?: string;
+        createdAt: string;
+        description: string;
+        id: number;
+        isLatest: boolean;
+        name: string;
+        status: string;
+        version: string;
+        versionNumber: number;
+    };
+    memberVersions: Array<{
+        agentForGroupId: number;
+        createdAt: string;
+        description: string;
+        id: number;
+        name: string;
+        url: string;
+        version: string;
+        versionNumber: number;
+    }>;
+}
+/**
+ * Modify agent group request
+ */
+interface AgentGroupModifyRequest {
+    avatar?: string;
+    backgroundColor?: string;
+    category?: string;
+    homepage?: string;
+    identifier: string;
+    isFeatured?: boolean;
+    isOfficial?: boolean;
+    name?: string;
+    status?: 'published' | 'unpublished' | 'archived' | 'deprecated';
+    visibility?: 'public' | 'private' | 'internal';
+}
+/**
+ * Modify agent group response
+ */
+interface AgentGroupModifyResponse {
+    avatar?: string;
+    backgroundColor?: string;
+    category?: string;
+    createdAt: string;
+    currentVersionId?: number;
+    description: string;
+    homepage?: string;
+    id: number;
+    identifier: string;
+    isFeatured: boolean;
+    isOfficial: boolean;
+    name: string;
+    ownerId: number;
+    status: string;
+    updatedAt: string;
+    visibility: string;
+}
+/**
+ * Agent group status
+ */
+type AgentGroupStatus = 'published' | 'unpublished' | 'archived' | 'deprecated';
+/**
+ * Agent group status change response
+ */
+interface AgentGroupStatusChangeResponse {
+    identifier: string;
+    status: AgentGroupStatus;
+    success: boolean;
+}
+/**
+ * Agent group fork request parameters
+ * Defines the request body for forking an agent group
+ */
+interface AgentGroupForkRequest {
+    /** New group identifier (required, must be globally unique) */
+    identifier: string;
+    /** New group name (optional, defaults to "{original name} (Fork)") */
+    name?: string;
+    /** Status of the forked group (optional, defaults to published) */
+    status?: 'published' | 'unpublished' | 'archived' | 'deprecated';
+    /** Version number to fork (optional, defaults to current version) */
+    versionNumber?: number;
+    /** Visibility of the forked group (optional, defaults to public) */
+    visibility?: 'public' | 'private' | 'internal';
+}
+/**
+ * Agent group fork response structure
+ * Defines the structure of the agent group fork API response
+ */
+interface AgentGroupForkResponse {
+    /** The newly created agent group */
+    group: {
+        createdAt: string;
+        forkedFromGroupId: number;
+        id: number;
+        identifier: string;
+        name: string;
+        ownerId: number;
+        updatedAt: string;
+    };
+    /** The initial version created for the forked group */
+    groupVersion: {
+        agentGroupId: number;
+        createdAt: string;
+        id: number;
+        versionNumber: number;
+    };
+    /** All member agents created in the forked group */
+    memberAgents: Array<{
+        id: number;
+        identifier: string;
+        name: string;
+        role: string;
+    }>;
+    /** All member agent versions created in the forked group */
+    memberVersions: Array<{
+        agentForGroupId: number;
+        id: number;
+        versionNumber: number;
+    }>;
+    /** Information about the source group */
+    source: {
+        groupId: number;
+        identifier: string;
+        versionNumber: number;
+    };
+}
+/**
+ * Agent group fork item structure
+ * Represents a single forked agent group in the forks list
+ */
+interface AgentGroupForkItem {
+    createdAt: string;
+    forkCount: number;
+    id: number;
+    identifier: string;
+    name: string;
+    ownerId: number;
+}
+/**
+ * Agent group forks list response
+ * Response structure for listing all forks of an agent group
+ */
+interface AgentGroupForksResponse {
+    forks: AgentGroupForkItem[];
+    totalCount: number;
+}
+/**
+ * Agent group fork source response
+ * Response structure for getting the source group that this group was forked from
+ */
+interface AgentGroupForkSourceResponse {
+    source: AgentGroupForkItem | null;
+}
 
 /**
  * Market Service Discovery Document
@@ -1862,6 +2446,43 @@ interface UserAgentItem {
     /** Last update timestamp */
     updatedAt: string;
 }
+/**
+ * User Agent Group Item
+ *
+ * Represents a simplified agent group item for user profile display
+ */
+interface UserAgentGroupItem {
+    /** Avatar emoji or URL */
+    avatar?: string;
+    /** Background color hex code */
+    backgroundColor?: string;
+    /** Agent group category */
+    category?: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Agent group description */
+    description?: string;
+    /** Total favorite count */
+    favoriteCount: number;
+    /** Agent group database ID */
+    id: string;
+    /** Agent group unique identifier */
+    identifier: string;
+    /** Total install count */
+    installCount: number;
+    /** Whether the agent group is featured */
+    isFeatured: boolean;
+    /** Whether the agent group is officially maintained */
+    isOfficial: boolean;
+    /** Total like count */
+    likeCount: number;
+    /** Agent group name */
+    name: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Current version number */
+    versionNumber?: number;
+}
 /**
  * User Info Query
  *
@@ -1877,8 +2498,14 @@ interface UserInfoQuery {
  * Response structure for getUserInfo endpoint
  */
 interface UserInfoResponse {
+    /** List of user's published public agent groups */
+    agentGroups: UserAgentGroupItem[];
     /** List of user's published public agents */
     agents: UserAgentItem[];
+    /** List of user's forked agent groups (excludes shallow forks) */
+    forkedAgentGroups: UserAgentGroupItem[];
+    /** List of user's forked agents (excludes shallow forks) */
+    forkedAgents: UserAgentItem[];
     /** User profile information */
     user: UserProfile;
 }
@@ -1908,6 +2535,71 @@ interface UpdateUserInfoResponse {
     /** Updated user profile */
     user: UserProfile;
 }
+/**
+ * User Registration Request
+ *
+ * Request body for user registration via trust token
+ */
+interface RegisterUserRequest {
+    /** User's avatar URL (optional) */
+    avatarUrl?: string;
+    /** User's display name (optional) */
+    displayName?: string;
+    /** User ID to follow after registration (optional) */
+    followUserId?: string;
+    /** Extended metadata (optional) */
+    meta?: AccountMeta;
+    /** The Clerk user ID to register (required) */
+    registerUserId: string;
+    /** Unique username (optional) */
+    userName?: string;
+}
+/**
+ * Registered User Profile
+ *
+ * User profile returned after registration
+ */
+interface RegisteredUserProfile {
+    /** User's avatar URL */
+    avatarUrl: string | null;
+    /** Clerk user ID */
+    clerkId: string | null;
+    /** Account creation timestamp */
+    createdAt: string;
+    /** User's display name */
+    displayName: string | null;
+    /** User's email */
+    email: string | null;
+    /** Whether email is verified */
+    emailVerified: boolean | null;
+    /** Number of followers */
+    followerCount: number;
+    /** Number of users this user is following */
+    followingCount: number;
+    /** Account ID (primary key) */
+    id: number;
+    /** Extended metadata for user profile */
+    meta: AccountMeta | null;
+    /** User's unique namespace */
+    namespace: string;
+    /** Account type (user or organization) */
+    type: string | null;
+    /** Unique username */
+    userName: string | null;
+}
+/**
+ * User Registration Response
+ *
+ * Response structure for user registration endpoint
+ */
+interface RegisterUserResponse {
+    /** Whether this is a newly created account */
+    created: boolean;
+    /** Whether the registration was successful */
+    success: boolean;
+    /** Registered user profile */
+    user: RegisteredUserProfile;
+}
 /**
  * Follow Request
  *
@@ -1966,14 +2658,14 @@ interface FollowListResponse {
 /**
  * Target Type for favorites and likes
  */
-type InteractionTargetType = 'agent' | 'plugin';
+type InteractionTargetType = 'agent' | 'plugin' | 'agent-group';
 /**
  * Favorite Request
  *
  * Request body for add/remove favorite operations
  */
 interface FavoriteRequest {
-    /** The identifier of the target agent/plugin */
+    /** The identifier of the target agent, plugin, or agent group */
     targetId: string;
     /** The type of target */
     targetType: InteractionTargetType;
@@ -1984,7 +2676,7 @@ interface FavoriteRequest {
  * Query parameters for checking favorite status
  */
 interface CheckFavoriteQuery {
-    /** The identifier of the target agent/plugin */
+    /** The identifier of the target agent, plugin, or agent group */
     targetId: string;
     /** The type of target */
     targetType: InteractionTargetType;
@@ -2026,7 +2718,7 @@ interface FavoriteListResponse {
  * Request body for like/unlike operations
  */
 interface LikeRequest {
-    /** The identifier of the target agent/plugin */
+    /** The identifier of the target agent, plugin, or agent group */
     targetId: string;
     /** The type of target */
     targetType: InteractionTargetType;
@@ -2037,7 +2729,7 @@ interface LikeRequest {
  * Query parameters for checking like status
  */
 interface CheckLikeQuery {
-    /** The identifier of the target agent/plugin */
+    /** The identifier of the target agent, plugin, or agent group */
     targetId: string;
     /** The type of target */
     targetType: InteractionTargetType;
@@ -3430,6 +4122,7 @@ declare class AgentService extends BaseSDK {
     /**
      * Retrieves all published agent identifiers
      *
+     *
      * Returns a lightweight list of all published agent identifiers without
      * full agent metadata. This is useful for clients that need to know which
      * agents are available without fetching complete agent information.
@@ -3589,6 +4282,217 @@ declare class AgentService extends BaseSDK {
      * @returns Promise resolving to the status change response
      */
     deprecate(identifier: string, options?: globalThis.RequestInit): Promise<AgentStatusChangeResponse>;
+    /**
+     * Forks an existing agent to create a new agent owned by the current user
+     *
+     * Creates a complete copy of the agent including configuration, skills,
+     * and version data. Statistical data (ratings, likes, etc.) are reset to zero.
+     * Requires authentication.
+     *
+     * @param sourceIdentifier - Identifier of the agent to fork
+     * @param forkData - Fork request parameters (new identifier, name, etc.)
+     * @param options - Optional request options
+     * @returns Promise resolving to the fork response with new agent details
+     */
+    forkAgent(sourceIdentifier: string, forkData: AgentForkRequest, options?: globalThis.RequestInit): Promise<AgentForkResponse>;
+    /**
+     * Retrieves all public forks of a specific agent
+     *
+     * Returns a list of agents that were forked from the specified agent.
+     * Only returns forks that are public and published.
+     *
+     * @param identifier - Identifier of the source agent
+     * @param options - Optional request options
+     * @returns Promise resolving to the forks list response
+     */
+    getAgentForks(identifier: string, options?: globalThis.RequestInit): Promise<AgentForksResponse>;
+    /**
+     * Retrieves the source agent that this agent was forked from
+     *
+     * Returns null if the agent is not a fork (original agent).
+     *
+     * @param identifier - Identifier of the agent to check
+     * @param options - Optional request options
+     * @returns Promise resolving to the fork source response
+     */
+    getAgentForkSource(identifier: string, options?: globalThis.RequestInit): Promise<AgentForkSourceResponse>;
+}
+
+/**
+ * Agent Groups Service
+ *
+ * Provides access to agent group-related functionality in the LobeHub Marketplace.
+ * This service handles listing, creating, versioning, and managing agent groups.
+ */
+declare class AgentGroupService extends BaseSDK {
+    /**
+     * Retrieves a list of agent groups from the marketplace
+     *
+     * Supports filtering, pagination, and localization of results.
+     *
+     * @param params - Query parameters for filtering and pagination
+     * @param options - Optional request options
+     * @returns Promise resolving to the agent group list response containing items and pagination info
+     */
+    getAgentGroupList(params?: AgentGroupListQuery, options?: globalThis.RequestInit): Promise<AgentGroupListResponse>;
+    /**
+     * Retrieves a list of agent groups owned by the authenticated user
+     *
+     * Returns all agent groups regardless of their publish status (published, unpublished,
+     * archived, deprecated). Requires authentication.
+     *
+     * @param params - Query parameters for filtering and pagination
+     * @param options - Optional request options (must include authentication)
+     * @returns Promise resolving to the agent group list response containing items with status field
+     */
+    getOwnAgentGroups(params?: OwnAgentGroupListQuery, options?: globalThis.RequestInit): Promise<AgentGroupListResponse>;
+    /**
+     * Retrieves detailed information about a specific agent group
+     *
+     * Returns complete agent group information including group metadata,
+     * all member agents, and localized content.
+     *
+     * @param identifier - Unique identifier of the agent group
+     * @param params - Query parameters for locale and version
+     * @param options - Optional request options
+     * @returns Promise resolving to the agent group detail information
+     */
+    getAgentGroupDetail(identifier: string, params?: Omit<AgentGroupDetailQuery, 'identifier'>, options?: globalThis.RequestInit): Promise<AgentGroupDetail>;
+    /**
+     * Creates a new agent group in the marketplace
+     *
+     * Creates a new agent group with initial version (v1) and all member agents.
+     * Requires authentication and ownership.
+     *
+     * @param groupData - The agent group data to create
+     * @param options - Optional request options
+     * @returns Promise resolving to the created agent group response
+     */
+    createAgentGroup(groupData: AgentGroupCreateRequest, options?: globalThis.RequestInit): Promise<AgentGroupCreateResponse>;
+    /**
+     * Creates a new version for an existing agent group
+     *
+     * Creates a new version with unified version number for the group and all member agents.
+     * Fields not provided will be inherited from the latest version.
+     *
+     * @param versionData - The version data to create
+     * @param options - Optional request options
+     * @returns Promise resolving to the created version response
+     */
+    createAgentGroupVersion(versionData: AgentGroupVersionCreateRequest, options?: globalThis.RequestInit): Promise<AgentGroupVersionCreateResponse>;
+    /**
+     * Modifies an existing agent group
+     *
+     * Updates the agent group's base information. Can be used to change status,
+     * metadata, or other group properties. Only the owner can modify the group.
+     *
+     * @param groupData - The agent group data to modify
+     * @param options - Optional request options
+     * @returns Promise resolving to the modified agent group response
+     */
+    modifyAgentGroup(groupData: AgentGroupModifyRequest, options?: globalThis.RequestInit): Promise<AgentGroupModifyResponse>;
+    /**
+     * Checks if an agent group exists in the marketplace
+     *
+     * @param identifier - Unique identifier of the agent group
+     * @param options - Optional request options
+     * @returns Promise resolving to true if agent group exists, false otherwise
+     */
+    checkAgentGroupExists(identifier: string, options?: globalThis.RequestInit): Promise<boolean>;
+    /**
+     * Changes the status of an agent group
+     *
+     * Internal helper method used by publish/unpublish/archive/deprecate methods.
+     * Requires authentication.
+     *
+     * @param identifier - Unique identifier of the agent group
+     * @param status - New status to set
+     * @param options - Optional request options
+     * @returns Promise resolving to the status change response
+     */
+    private changeStatus;
+    /**
+     * Publishes an agent group to the marketplace
+     *
+     * Makes the agent group publicly visible and available for use.
+     * Requires authentication and ownership of the agent group.
+     * Only groups with "Safe" safety check status can be published.
+     *
+     * @param identifier - Unique identifier of the agent group
+     * @param options - Optional request options
+     * @returns Promise resolving to the status change response
+     */
+    publish(identifier: string, options?: globalThis.RequestInit): Promise<AgentGroupStatusChangeResponse>;
+    /**
+     * Unpublishes an agent group from the marketplace
+     *
+     * Hides the agent group from public view. The agent group data is preserved
+     * and can be republished later.
+     * Requires authentication and ownership of the agent group.
+     *
+     * @param identifier - Unique identifier of the agent group
+     * @param options - Optional request options
+     * @returns Promise resolving to the status change response
+     */
+    unpublish(identifier: string, options?: globalThis.RequestInit): Promise<AgentGroupStatusChangeResponse>;
+    /**
+     * Archives an agent group
+     *
+     * Marks the agent group as archived. Archived agent groups are typically
+     * no longer actively maintained but may still be accessible.
+     * Requires authentication and ownership of the agent group.
+     *
+     * @param identifier - Unique identifier of the agent group
+     * @param options - Optional request options
+     * @returns Promise resolving to the status change response
+     */
+    archive(identifier: string, options?: globalThis.RequestInit): Promise<AgentGroupStatusChangeResponse>;
+    /**
+     * Deprecates an agent group
+     *
+     * Marks the agent group as deprecated. Deprecated agent groups are still
+     * accessible but users are encouraged to migrate to alternatives.
+     * Requires authentication and ownership of the agent group.
+     *
+     * @param identifier - Unique identifier of the agent group
+     * @param options - Optional request options
+     * @returns Promise resolving to the status change response
+     */
+    deprecate(identifier: string, options?: globalThis.RequestInit): Promise<AgentGroupStatusChangeResponse>;
+    /**
+     * Forks an existing agent group to create a new group owned by the current user
+     *
+     * Creates a complete copy of the agent group including all member agents,
+     * their configurations, and version data. Statistical data (ratings, likes, etc.)
+     * are reset to zero. Requires authentication.
+     *
+     * @param sourceIdentifier - Identifier of the agent group to fork
+     * @param forkData - Fork request parameters (new identifier, name, etc.)
+     * @param options - Optional request options
+     * @returns Promise resolving to the fork response with new group details
+     */
+    forkAgentGroup(sourceIdentifier: string, forkData: AgentGroupForkRequest, options?: globalThis.RequestInit): Promise<AgentGroupForkResponse>;
+    /**
+     * Retrieves all public forks of a specific agent group
+     *
+     * Returns a list of agent groups that were forked from the specified group.
+     * Only returns forks that are public and published.
+     *
+     * @param identifier - Identifier of the source agent group
+     * @param options - Optional request options
+     * @returns Promise resolving to the forks list response
+     */
+    getAgentGroupForks(identifier: string, options?: globalThis.RequestInit): Promise<AgentGroupForksResponse>;
+    /**
+     * Retrieves the source agent group that this group was forked from
+     *
+     * Returns null if the agent group is not a fork (original group).
+     *
+     * @param identifier - Identifier of the agent group to check
+     * @param options - Optional request options
+     * @returns Promise resolving to the fork source response
+     */
+    getAgentGroupForkSource(identifier: string, options?: globalThis.RequestInit): Promise<AgentGroupForkSourceResponse>;
 }
 
 /**
@@ -4308,6 +5212,33 @@ declare class UserService extends BaseSDK {
      * @throws Error if userName is already taken or update fails
      */
     updateUserInfo(data: UpdateUserInfoRequest, options?: globalThis.RequestInit): Promise<UpdateUserInfoResponse>;
+    /**
+     * Registers a new user via trust token authentication
+     *
+     * This endpoint ONLY accepts x-lobe-trust-token header authentication (Bearer tokens are not supported).
+     * User information (email, username) is automatically fetched from app.lobehub.com.
+     * If the user already exists (by email or userId), returns the existing user info.
+     *
+     * @param data - Registration data including registerUserId (required) and optional followUserId
+     * @param options - Optional request options (must include x-lobe-trust-token header)
+     * @returns Promise resolving to the registration response with user profile
+     * @throws Error if user is banned, follow user is banned, or registration fails
+     *
+     * @example
+     * ```typescript
+     * const result = await userService.register({
+     *   registerUserId: 'user_abc123',
+     *   followUserId: 'user_xyz789', // Optional
+     *   displayName: 'John Doe',
+     *   userName: 'johndoe'
+     * }, {
+     *   headers: {
+     *     'x-lobe-trust-token': trustToken
+     *   }
+     * });
+     * ```
+     */
+    register(data: RegisterUserRequest, options?: globalThis.RequestInit): Promise<RegisterUserResponse>;
 }
 
 /**
@@ -4592,6 +5523,11 @@ declare class MarketSDK extends BaseSDK {
      * Provides methods to list, search, retrieve agent information, and upload agents
      */
     readonly agents: AgentService;
+    /**
+     * Agent Groups service for accessing agent group-related functionality
+     * Provides methods to list, create, version, and manage agent groups
+     */
+    readonly agentGroups: AgentGroupService;
     /**
      * Auth service for authentication and authorization
      * Provides methods for OIDC user authentication, client registration, and M2M token management
@@ -4772,4 +5708,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 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 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, MarketSDK, type MarketSDKOptions, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, 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 RefreshConnectionResponse, type RefreshTokenRequest, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillErrorResponse, type SkillProviderInfo, type SkillProviderStatus, type SkillTool, 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 };
+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 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, MarketSDK, type MarketSDKOptions, 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, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillErrorResponse, type SkillProviderInfo, type SkillProviderStatus, type SkillTool, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateMemberAgent, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentGroupItem, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };