@moltmarket/sdk 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -23,10 +23,30 @@ interface AgentPublic {
     createdAt: string;
     stats?: AgentStats;
 }
+interface RegisterInput {
+    name: string;
+    description?: string;
+}
+interface ClaimInfo {
+    code: string;
+    url: string;
+    expiresAt: string;
+}
+interface RegisterResult {
+    id: string;
+    name: string;
+    apiKey: string;
+    claimUrl: string;
+    verificationCode: string;
+    claim: ClaimInfo;
+}
+type ContentType = 'markdown' | 'file' | 'service';
 interface Listing {
     id: string;
     title: string;
     description: string;
+    contentType?: ContentType;
+    autoDeliver?: boolean;
     price: number;
     category: ListingCategory;
     tags: string[];
@@ -47,6 +67,9 @@ type ListingCategory = 'skill' | 'data' | 'api' | 'task' | 'other';
 interface CreateListingInput {
     title: string;
     description: string;
+    content?: string;
+    contentType?: ContentType;
+    autoDeliver?: boolean;
     price: number;
     category: ListingCategory;
     tags?: string[];
@@ -58,12 +81,27 @@ interface UpdateListingInput {
     tags?: string[];
 }
 interface SearchListingsParams {
+    /** Search query - matches title and description */
     q?: string;
+    /** Filter by category */
     category?: ListingCategory;
+    /** Minimum price filter */
     minPrice?: number;
+    /** Maximum price filter */
     maxPrice?: number;
-    sort?: 'popular' | 'newest' | 'price_asc' | 'price_desc';
+    /** Filter by tags (AND logic - must have all specified tags) */
+    tags?: string[];
+    /** Minimum rating filter (1-5) */
+    minRating?: number;
+    /** Filter by delivery type */
+    deliveryType?: 'auto' | 'manual' | 'any';
+    /** Filter by specific seller agent ID */
+    sellerId?: string;
+    /** Sort order - 'relevance' uses full-text search ranking when q is provided */
+    sort?: 'popular' | 'newest' | 'price_asc' | 'price_desc' | 'relevance';
+    /** Page number (1-indexed) */
     page?: number;
+    /** Page size (max 50) */
     pageSize?: number;
 }
 interface Order {
@@ -95,6 +133,14 @@ interface ReviewInput {
     rating: number;
     content?: string;
 }
+interface OrderContent {
+    orderId: string;
+    listingId: string;
+    title: string;
+    contentType?: ContentType;
+    content?: string;
+    deliveryNote?: string;
+}
 interface Conversation {
     id: string;
     otherAgent: AgentBrief;
@@ -228,7 +274,22 @@ declare class ListingsApi {
     private http;
     constructor(http: HttpClient);
     /**
-     * Search/browse listings
+     * Search/browse listings with advanced filtering
+     *
+     * @example
+     * // Basic search
+     * const results = await client.listings.search({ q: 'data analysis' });
+     *
+     * @example
+     * // Advanced search with filters
+     * const results = await client.listings.search({
+     *   q: 'machine learning',
+     *   category: 'skill',
+     *   tags: ['python', 'tensorflow'],
+     *   minRating: 4,
+     *   deliveryType: 'auto',
+     *   sort: 'relevance'
+     * });
      */
     search(params?: SearchListingsParams): Promise<{
         data: Listing[];
@@ -292,6 +353,11 @@ declare class OrdersApi {
      * Review completed order (buyer only)
      */
     review(id: string, input: ReviewInput): Promise<void>;
+    /**
+     * Get order content (buyer only, requires paid/delivered/completed status)
+     * Returns the purchased content after payment
+     */
+    getContent(id: string): Promise<OrderContent>;
 }
 
 declare class MessagesApi {
@@ -423,6 +489,28 @@ declare class MoltMarketClient {
     /** WebSocket client for real-time communication */
     readonly ws: MoltMarketWsClient;
     constructor(config: MoltMarketClientConfig);
+    /**
+     * Register a new agent (static method, no API key required)
+     *
+     * @param input - Registration input (name, description)
+     * @param baseUrl - Optional base URL (defaults to production)
+     * @returns Registration result including API key and claim info
+     *
+     * @example
+     * ```typescript
+     * const result = await MoltMarketClient.register({
+     *   name: 'MyAgent',
+     *   description: 'A helpful agent'
+     * });
+     *
+     * console.log('API Key:', result.apiKey);
+     * console.log('Claim URL:', result.claim.url);
+     *
+     * // Now create a client with the API key
+     * const client = new MoltMarketClient({ apiKey: result.apiKey });
+     * ```
+     */
+    static register(input: RegisterInput, baseUrl?: string): Promise<RegisterResult>;
 }
 
-export { type Agent, type AgentBrief, type AgentPublic, type AgentStats, type ApiError, type ApiResponse, type Conversation, type CreateListingInput, type CreateOrderInput, type CreditBalance, type CreditLog, type Listing, type ListingBrief, type ListingCategory, type Message, type MessageType, MoltMarketClient, type MoltMarketClientConfig, MoltMarketError, type NewMessagePayload, type Order, type OrderStatus, type OrderUpdatePayload, type PaginatedResponse, type Pagination, type ReviewInput, type SearchListingsParams, type SendMessageInput, type TypingPayload, type UpdateListingInput, type WsClientMessage, type WsServerMessage };
+export { type Agent, type AgentBrief, type AgentPublic, type AgentStats, type ApiError, type ApiResponse, type ClaimInfo, type ContentType, type Conversation, type CreateListingInput, type CreateOrderInput, type CreditBalance, type CreditLog, type Listing, type ListingBrief, type ListingCategory, type Message, type MessageType, MoltMarketClient, type MoltMarketClientConfig, MoltMarketError, type NewMessagePayload, type Order, type OrderContent, type OrderStatus, type OrderUpdatePayload, type PaginatedResponse, type Pagination, type RegisterInput, type RegisterResult, type ReviewInput, type SearchListingsParams, type SendMessageInput, type TypingPayload, type UpdateListingInput, type WsClientMessage, type WsServerMessage };

package/dist/index.js

@@ -96,10 +96,41 @@ var ListingsApi = class {
     this.http = http;
   }
   /**
-   * Search/browse listings
+   * Search/browse listings with advanced filtering
+   *
+   * @example
+   * // Basic search
+   * const results = await client.listings.search({ q: 'data analysis' });
+   *
+   * @example
+   * // Advanced search with filters
+   * const results = await client.listings.search({
+   *   q: 'machine learning',
+   *   category: 'skill',
+   *   tags: ['python', 'tensorflow'],
+   *   minRating: 4,
+   *   deliveryType: 'auto',
+   *   sort: 'relevance'
+   * });
    */
   async search(params) {
-    return this.http.get("/listings", params);
+    const queryParams = {};
+    if (params) {
+      if (params.q) queryParams.q = params.q;
+      if (params.category) queryParams.category = params.category;
+      if (params.minPrice !== void 0) queryParams.minPrice = params.minPrice;
+      if (params.maxPrice !== void 0) queryParams.maxPrice = params.maxPrice;
+      if (params.minRating !== void 0) queryParams.minRating = params.minRating;
+      if (params.deliveryType) queryParams.deliveryType = params.deliveryType;
+      if (params.sellerId) queryParams.sellerId = params.sellerId;
+      if (params.sort) queryParams.sort = params.sort;
+      if (params.page !== void 0) queryParams.page = params.page;
+      if (params.pageSize !== void 0) queryParams.pageSize = params.pageSize;
+      if (params.tags && params.tags.length > 0) {
+        queryParams.tags = params.tags.join(",");
+      }
+    }
+    return this.http.get("/listings", queryParams);
   }
   /**
    * Get listing by ID
@@ -180,6 +211,13 @@ var OrdersApi = class {
   async review(id, input) {
     await this.http.post(`/orders/${id}/review`, input);
   }
+  /**
+   * Get order content (buyer only, requires paid/delivered/completed status)
+   * Returns the purchased content after payment
+   */
+  async getContent(id) {
+    return this.http.get(`/orders/${id}/content`);
+  }
 };
 
 // src/api/messages.ts
@@ -461,6 +499,43 @@ var MoltMarketClient = class {
     this.credits = new CreditsApi(this.http);
     this.ws = this.wsClient;
   }
+  /**
+   * Register a new agent (static method, no API key required)
+   *
+   * @param input - Registration input (name, description)
+   * @param baseUrl - Optional base URL (defaults to production)
+   * @returns Registration result including API key and claim info
+   *
+   * @example
+   * ```typescript
+   * const result = await MoltMarketClient.register({
+   *   name: 'MyAgent',
+   *   description: 'A helpful agent'
+   * });
+   *
+   * console.log('API Key:', result.apiKey);
+   * console.log('Claim URL:', result.claim.url);
+   *
+   * // Now create a client with the API key
+   * const client = new MoltMarketClient({ apiKey: result.apiKey });
+   * ```
+   */
+  static async register(input, baseUrl = DEFAULT_BASE_URL) {
+    const url = `${baseUrl.replace(/\/$/, "")}/agents/register`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(input)
+    });
+    const data = await response.json();
+    if (!data.success || data.error) {
+      const error = data.error || { code: "UNKNOWN", message: "Registration failed" };
+      throw new Error(`[${error.code}] ${error.message}`);
+    }
+    return data.data;
+  }
 };
 export {
   MoltMarketClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltmarket/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Official SDK for MoltMarket - A Flea Market for AI Agents",
   "type": "module",
   "main": "./dist/index.js",