reportify-sdk 0.2.8 → 0.2.10

package/dist/index.js

@@ -21,7 +21,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   APIError: () => APIError,
+  AgentModule: () => AgentModule,
   AuthenticationError: () => AuthenticationError,
+  ChannelsModule: () => ChannelsModule,
+  ChatModule: () => ChatModule,
   ConceptsModule: () => ConceptsModule,
   DocsModule: () => DocsModule,
   KBModule: () => KBModule,
@@ -30,8 +33,10 @@ __export(index_exports, {
   RateLimitError: () => RateLimitError,
   Reportify: () => Reportify,
   ReportifyError: () => ReportifyError,
+  SearchModule: () => SearchModule,
   StockModule: () => StockModule,
-  TimelineModule: () => TimelineModule
+  TimelineModule: () => TimelineModule,
+  UserModule: () => UserModule
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -82,11 +87,17 @@ var StockModule = class {
    * Get list of major shareholders
    *
    * @param symbol - Stock symbol
+   * @param options.type - Type of shareholders ('shareholders' or 'outstanding_shareholders')
+   * @param options.limit - Number of results to return (default: 10)
    */
-  async shareholders(symbol) {
+  async shareholders(symbol, options = {}) {
     const response = await this.client.post(
       "/v1/stock/company-shareholders",
-      { symbol }
+      {
+        symbol,
+        type: options.type || "shareholders",
+        limit: options.limit || 10
+      }
     );
     return Array.isArray(response) ? response : response.shareholders || [];
   }
@@ -97,17 +108,28 @@ var StockModule = class {
    * Get income statement data
    *
    * @param symbol - Stock symbol
-   * @param options.period - "annual" or "quarterly"
-   * @param options.limit - Number of periods to return
+   * @param options.period - "annual", "quarterly", or "cumulative quarterly"
+   * @param options.limit - Number of periods to return (default: 8)
+   * @param options.startDate - Start date (YYYY-MM-DD)
+   * @param options.endDate - End date (YYYY-MM-DD)
+   * @param options.calendar - "calendar" or "fiscal" (default: "fiscal")
+   * @param options.fiscalYear - Specific fiscal year (e.g., "2023")
+   * @param options.fiscalQuarter - Specific fiscal quarter (Q1, Q2, Q3, Q4, FY, H1)
    */
   async incomeStatement(symbol, options = {}) {
+    const body = {
+      symbol,
+      period: options.period || "annual",
+      limit: options.limit || 8,
+      calendar: options.calendar || "fiscal"
+    };
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
+    if (options.fiscalQuarter) body.fiscal_quarter = options.fiscalQuarter;
     const response = await this.client.post(
       "/v1/stock/company-income-statement",
-      {
-        symbol,
-        period: options.period || "annual",
-        limit: options.limit || 10
-      }
+      body
     );
     return this.normalizeArrayResponse(response);
   }
@@ -116,16 +138,27 @@ var StockModule = class {
    *
    * @param symbol - Stock symbol
    * @param options.period - "annual" or "quarterly"
-   * @param options.limit - Number of periods to return
+   * @param options.limit - Number of periods to return (default: 8)
+   * @param options.startDate - Start date (YYYY-MM-DD)
+   * @param options.endDate - End date (YYYY-MM-DD)
+   * @param options.calendar - "calendar" or "fiscal" (default: "fiscal")
+   * @param options.fiscalYear - Specific fiscal year (e.g., "2023")
+   * @param options.fiscalQuarter - Specific fiscal quarter (Q1, Q2, Q3, Q4, FY)
    */
   async balanceSheet(symbol, options = {}) {
+    const body = {
+      symbol,
+      period: options.period || "annual",
+      limit: options.limit || 8,
+      calendar: options.calendar || "fiscal"
+    };
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
+    if (options.fiscalQuarter) body.fiscal_quarter = options.fiscalQuarter;
     const response = await this.client.post(
       "/v1/stock/company-balance-sheet",
-      {
-        symbol,
-        period: options.period || "annual",
-        limit: options.limit || 10
-      }
+      body
     );
     return this.normalizeArrayResponse(response);
   }
@@ -133,33 +166,51 @@ var StockModule = class {
    * Get cash flow statement data
    *
    * @param symbol - Stock symbol
-   * @param options.period - "annual" or "quarterly"
-   * @param options.limit - Number of periods to return
+   * @param options.period - "annual", "quarterly", or "cumulative quarterly"
+   * @param options.limit - Number of periods to return (default: 8)
+   * @param options.startDate - Start date (YYYY-MM-DD)
+   * @param options.endDate - End date (YYYY-MM-DD)
+   * @param options.calendar - "calendar" or "fiscal" (default: "fiscal")
+   * @param options.fiscalYear - Specific fiscal year (e.g., "2023")
+   * @param options.fiscalQuarter - Specific fiscal quarter (Q1, Q2, Q3, Q4, FY, H1)
    */
   async cashflowStatement(symbol, options = {}) {
+    const body = {
+      symbol,
+      period: options.period || "annual",
+      limit: options.limit || 8,
+      calendar: options.calendar || "fiscal"
+    };
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
+    if (options.fiscalQuarter) body.fiscal_quarter = options.fiscalQuarter;
     const response = await this.client.post(
       "/v1/stock/company-cashflow-statement",
-      {
-        symbol,
-        period: options.period || "annual",
-        limit: options.limit || 10
-      }
+      body
     );
     return this.normalizeArrayResponse(response);
   }
   /**
-   * Get revenue breakdown by segment, product, or region
+   * Get revenue breakdown
    *
    * @param symbol - Stock symbol
-   * @param options.breakdownType - Type of breakdown
+   * @param options.period - Report cycle (e.g., "FY", "Q2")
+   * @param options.limit - Number of records to return (default: 6)
+   * @param options.startDate - Start date (YYYY-MM-DD)
+   * @param options.endDate - End date (YYYY-MM-DD)
+   * @param options.fiscalYear - Specific fiscal year (e.g., "2023")
    */
   async revenueBreakdown(symbol, options = {}) {
+    const body = { symbol };
+    if (options.period) body.period = options.period;
+    if (options.limit !== void 0) body.limit = options.limit;
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
     const response = await this.client.post(
       "/v1/stock/company-revenue-breakdown",
-      {
-        symbol,
-        breakdown_type: options.breakdownType || "segment"
-      }
+      body
     );
     return this.normalizeArrayResponse(response);
   }
@@ -173,65 +224,43 @@ var StockModule = class {
    * @param options - Query options
    */
   async prices(symbol, options = {}) {
+    const body = { symbol };
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
     const response = await this.client.post(
       "/v1/stock/company-prices",
-      {
-        symbol,
-        start_date: options.startDate,
-        end_date: options.endDate,
-        limit: options.limit || 100
-      }
+      body
     );
     return this.normalizeArrayResponse(response);
   }
   /**
-   * Get K-line (candlestick) data
+   * Get real-time stock quote
    *
    * @param symbol - Stock symbol
-   * @param options - Query options
-   */
-  async kline(symbol, options = {}) {
-    const response = await this.client.post(
-      "/v1/stock/kline",
-      {
-        symbol,
-        interval: options.interval || "1d",
-        adjust: options.adjust || "forward",
-        start_date: options.startDate,
-        end_date: options.endDate,
-        limit: options.limit || 100
-      }
-    );
-    return this.normalizeArrayResponse(response);
-  }
-  /**
-   * Get real-time stock quotes
-   *
-   * @param symbols - Single symbol or array of symbols
    */
-  async quote(symbols) {
-    const symbolList = Array.isArray(symbols) ? symbols : [symbols];
+  async quote(symbol) {
     const response = await this.client.post(
       "/v1/stock/quote-realtime",
-      { symbols: symbolList }
+      { symbol }
     );
-    return this.normalizeArrayResponse(response);
+    if ("data" in response) {
+      return response.data;
+    }
+    return response;
   }
   /**
    * Get stock index prices
    *
-   * @param symbol - Index symbol
+   * @param symbol - Index symbol (e.g., HSI, SPX, DJI)
    * @param options - Query options
    */
   async indexPrices(symbol, options = {}) {
+    const body = { symbol };
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
     const response = await this.client.post(
       "/v1/stock/index-prices",
-      {
-        symbol,
-        start_date: options.startDate,
-        end_date: options.endDate,
-        limit: options.limit || 100
-      }
+      body
     );
     return this.normalizeArrayResponse(response);
   }
@@ -242,39 +271,54 @@ var StockModule = class {
    * Screen stocks based on various criteria
    */
   async screener(options = {}) {
+    const body = {
+      limit: options.limit || 100
+    };
+    if (options.marketCapMoreThan !== void 0) body.market_cap_more_than = options.marketCapMoreThan;
+    if (options.marketCapLowerThan !== void 0) body.market_cap_lower_than = options.marketCapLowerThan;
+    if (options.priceMoreThan !== void 0) body.price_more_than = options.priceMoreThan;
+    if (options.priceLowerThan !== void 0) body.price_lower_than = options.priceLowerThan;
+    if (options.changePercentageMoreThan !== void 0) body.change_percentage_more_than = options.changePercentageMoreThan;
+    if (options.changePercentageLowerThan !== void 0) body.change_percentage_lower_than = options.changePercentageLowerThan;
+    if (options.volumeMoreThan !== void 0) body.volume_more_than = options.volumeMoreThan;
+    if (options.volumeLowerThan !== void 0) body.volume_lower_than = options.volumeLowerThan;
+    if (options.country) body.country = options.country;
+    if (options.exchange) body.exchange = options.exchange;
+    if (options.dividendYieldMoreThan !== void 0) body.dividend_yield_more_than = options.dividendYieldMoreThan;
+    if (options.dividendYieldLowerThan !== void 0) body.dividend_yield_lower_than = options.dividendYieldLowerThan;
+    if (options.peTtmMoreThan !== void 0) body.pe_ttm_more_than = options.peTtmMoreThan;
+    if (options.peTtmLowerThan !== void 0) body.pe_ttm_lower_than = options.peTtmLowerThan;
     const response = await this.client.post(
       "/v1/stock/screener",
-      {
-        market: options.market,
-        sector: options.sector,
-        min_market_cap: options.minMarketCap,
-        max_market_cap: options.maxMarketCap,
-        min_pe: options.minPe,
-        max_pe: options.maxPe,
-        limit: options.limit || 50
-      }
+      body
     );
     return this.normalizeArrayResponse(response);
   }
   /**
    * Get earnings announcement calendar
+   *
+   * @param options.market - Required: Stock market (cn, hk, us)
+   * @param options.startDate - Required: Start date (YYYY-MM-DD)
+   * @param options.endDate - Required: End date (YYYY-MM-DD)
+   * @param options.symbol - Optional: Stock symbol
    */
-  async earningsCalendar(options = {}) {
+  async earningsCalendar(options) {
+    const body = {
+      market: options.market,
+      start_date: options.startDate,
+      end_date: options.endDate
+    };
+    if (options.symbol) body.symbol = options.symbol;
     const response = await this.client.post(
       "/v1/stock/earnings-calendar",
-      {
-        market: options.market || "us",
-        start_date: options.startDate,
-        end_date: options.endDate,
-        symbol: options.symbol
-      }
+      body
     );
     return this.normalizeArrayResponse(response);
   }
   /**
    * Get Hong Kong IPO calendar
    */
-  async ipoCalendarHK(status = "Filing") {
+  async ipoCalendarHK(status) {
     const response = await this.client.post(
       "/v1/stock/ipo-calendar-hk",
       { status }
@@ -364,184 +408,247 @@ var StockModule = class {
   }
 };
 
-// src/timeline.ts
-var TimelineModule = class {
+// src/docs.ts
+var DocsModule = class {
   constructor(client) {
     this.client = client;
   }
   /**
-   * Get timeline for followed companies
-   *
-   * Returns recent content related to companies the user is following.
+   * Get document content and metadata
    *
-   * @param options.num - Number of items to return (default: 10, max: 100)
+   * @param docId - Document ID
    */
-  async companies(options = {}) {
-    const response = await this.client.post(
-      "/v1/tools/timeline/companies",
-      { num: options.num || 10 }
-    );
-    return response.docs || [];
+  async get(docId) {
+    return this.client.get(`/v1/docs/${docId}`);
   }
   /**
-   * Get timeline for followed topics
-   *
-   * Returns recent content related to custom topics the user is following.
+   * Get document summary
    *
-   * @param options.num - Number of items to return
+   * @param docId - Document ID
    */
-  async topics(options = {}) {
-    const response = await this.client.post(
-      "/v1/tools/timeline/topics",
-      { num: options.num || 10 }
-    );
-    return response.docs || [];
+  async summary(docId) {
+    return this.client.get(`/v1/docs/${docId}/summary`);
   }
   /**
-   * Get timeline for followed professional institutes
-   *
-   * Returns recent content from research institutions, banks, etc.
+   * Get raw document content
    *
-   * @param options.num - Number of items to return
+   * @param docId - Document ID
    */
-  async institutes(options = {}) {
-    const response = await this.client.post(
-      "/v1/tools/timeline/institutes",
-      { num: options.num || 10 }
-    );
-    return response.docs || [];
+  async rawContent(docId) {
+    return this.client.get(`/v1/docs/${docId}/raw-content`);
   }
   /**
-   * Get timeline for followed public media
-   *
-   * Returns recent content from public media accounts.
+   * List documents with filters
    *
-   * @param options.num - Number of items to return
+   * @param options - Filter options
    */
-  async publicMedia(options = {}) {
-    const response = await this.client.post(
-      "/v1/tools/timeline/public-media",
-      { num: options.num || 10 }
-    );
-    return response.docs || [];
+  async list(options = {}) {
+    const body = {
+      page_num: options.pageNum || 1,
+      page_size: options.pageSize || 10
+    };
+    if (options.symbols) body.symbols = options.symbols;
+    if (options.categories) body.categories = options.categories;
+    if (options.markets) body.markets = options.markets;
+    if (options.institutions) body.institutions = options.institutions;
+    if (options.tags) body.tags = options.tags;
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    if (options.minScore !== void 0) body.min_score = options.minScore;
+    if (options.extendedFilters) body.extended_filters = options.extendedFilters;
+    if (options.folderIds) body.folder_ids = options.folderIds;
+    const response = await this.client.post("/v1/docs", body);
+    return {
+      items: response.docs || [],
+      total: response.total_count || 0,
+      page: response.page_num || 1,
+      pageSize: response.page_size || 10
+    };
   }
   /**
-   * Get timeline for followed social media
-   *
-   * Returns recent content from social media accounts.
+   * Query documents by symbols
    *
-   * @param options.num - Number of items to return
+   * @param symbols - Required: Stock symbols
+   * @param options - Filter options
    */
-  async socialMedia(options = {}) {
-    const response = await this.client.post(
-      "/v1/tools/timeline/social-media",
-      { num: options.num || 10 }
-    );
-    return response.docs || [];
-  }
-};
-
-// src/kb.ts
-var KBModule = class {
-  constructor(client) {
-    this.client = client;
+  async queryBySymbols(symbols, options = {}) {
+    const body = {
+      symbols,
+      page_num: options.pageNum || 1,
+      page_size: options.pageSize || 10
+    };
+    if (options.categories) body.categories = options.categories;
+    if (options.markets) body.markets = options.markets;
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    const response = await this.client.post("/v1/docs/symbols", body);
+    return {
+      items: response.docs || [],
+      total: response.total_count || 0,
+      page: response.page_num || 1,
+      pageSize: response.page_size || 10
+    };
   }
   /**
-   * Search user's knowledge base
+   * Query documents by tags
    *
-   * Performs semantic search across documents the user has uploaded.
+   * @param tags - Required: Document tags
+   * @param options - Filter options
+   */
+  async queryByTags(tags, options = {}) {
+    const body = {
+      tags,
+      page_num: options.pageNum || 1,
+      page_size: options.pageSize || 10
+    };
+    if (options.categories) body.categories = options.categories;
+    if (options.markets) body.markets = options.markets;
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    const response = await this.client.post("/v1/docs/tags", body);
+    return {
+      items: response.docs || [],
+      total: response.total_count || 0,
+      page: response.page_num || 1,
+      pageSize: response.page_size || 10
+    };
+  }
+  /**
+   * Search document chunks semantically
    *
    * @param query - Search query string
    * @param options - Search options
-   *
-   * @example
-   * ```typescript
-   * const results = await client.kb.search('quarterly revenue', { num: 5 });
-   * results.forEach(chunk => console.log(chunk.content));
-   * ```
    */
-  async search(query, options = {}) {
-    const response = await this.client.post(
-      "/v1/tools/kb/search",
-      {
-        query,
-        folder_ids: options.folderIds,
-        doc_ids: options.docIds,
-        start_date: options.startDate,
-        end_date: options.endDate,
-        num: options.num || 10
-      }
-    );
+  async searchChunks(query, options = {}) {
+    const body = {
+      query,
+      num: options.num || 10
+    };
+    if (options.symbols) body.symbols = options.symbols;
+    if (options.categories) body.categories = options.categories;
+    if (options.folderIds) body.folder_ids = options.folderIds;
+    if (options.docIds) body.doc_ids = options.docIds;
+    if (options.markets) body.markets = options.markets;
+    if (options.institutions) body.institutions = options.institutions;
+    if (options.tags) body.tags = options.tags;
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    if (options.minScore !== void 0) body.min_score = options.minScore;
+    if (options.extendedFilters) body.extended_filters = options.extendedFilters;
+    if (options.includeDocExtraDetails !== void 0) body.include_doc_extra_details = options.includeDocExtraDetails;
+    if (options.refineQuestion !== void 0) body.refine_question = options.refineQuestion;
+    if (options.dateRange) body.date_range = options.dateRange;
+    const response = await this.client.post("/v1/search/chunks", body);
     return response.chunks || [];
   }
-};
-
-// src/docs.ts
-var DocsModule = class {
-  constructor(client) {
-    this.client = client;
-  }
+  // ===========================================================================
+  // Folder Management
+  // ===========================================================================
   /**
-   * Get document content and metadata
+   * Create a new document folder
    *
-   * @param docId - Document ID
+   * @param name - Folder name
+   * @returns Folder ID
    */
-  async get(docId) {
-    return this.client.get(`/v1/docs/${docId}`);
+  async createFolder(name) {
+    const response = await this.client.post("/v1/docs/folder/create", { name });
+    return { folderId: response.folder_id };
   }
   /**
-   * Get document summary
+   * Delete a document folder and all files within it
    *
-   * @param docId - Document ID
+   * @param folderId - Folder ID to delete
+   * @returns Deleted folder ID and document IDs
    */
-  async summary(docId) {
-    return this.client.get(`/v1/docs/${docId}/summary`);
+  async deleteFolder(folderId) {
+    const response = await this.client.delete(
+      "/v1/docs/folder/delete",
+      { folder_id: folderId }
+    );
+    return { folderId: response.folder_id, docIds: response.doc_ids };
   }
+  // ===========================================================================
+  // Document Upload
+  // ===========================================================================
   /**
-   * Get raw document content
+   * Upload documents by URL
    *
-   * @param docId - Document ID
+   * @param docs - Array of document upload requests
+   * @param options.folderId - Optional folder ID
+   * @param options.pdfParsingMode - PDF parsing mode (1: by page, 3: by logic)
    */
-  async rawContent(docId) {
-    return this.client.get(`/v1/docs/${docId}/raw-content`);
+  async uploadDocs(docs, options = {}) {
+    const body = {
+      docs: docs.map((doc) => ({
+        url: doc.url,
+        name: doc.name,
+        metadatas: doc.metadatas,
+        published_at: doc.publishedAt,
+        tags: doc.tags
+      }))
+    };
+    if (options.folderId) body.folder_id = options.folderId;
+    if (options.pdfParsingMode !== void 0) body.pdf_parsing_mode = options.pdfParsingMode;
+    const response = await this.client.post("/v1/docs/upload", body);
+    return {
+      docs: response.docs.map((doc) => ({
+        id: doc.id,
+        title: doc.title,
+        originalUrl: doc.original_url
+      }))
+    };
   }
   /**
-   * List documents with filters
+   * Upload documents by URL asynchronously
    *
-   * @param options - Filter options
+   * @param docs - Array of document upload requests
+   * @param options.folderId - Optional folder ID
+   * @param options.pdfParsingMode - PDF parsing mode (1: by page, 3: by logic)
    */
-  async list(options = {}) {
-    const response = await this.client.post("/v1/docs", {
-      symbols: options.symbols,
-      categories: options.categories,
-      start_date: options.startDate,
-      end_date: options.endDate,
-      page_num: options.page || 1,
-      page_size: options.pageSize || 20
-    });
+  async uploadDocsAsync(docs, options = {}) {
+    const body = {
+      docs: docs.map((doc) => ({
+        url: doc.url,
+        name: doc.name,
+        metadatas: doc.metadatas,
+        published_at: doc.publishedAt,
+        tags: doc.tags
+      }))
+    };
+    if (options.folderId) body.folder_id = options.folderId;
+    if (options.pdfParsingMode !== void 0) body.pdf_parsing_mode = options.pdfParsingMode;
+    const response = await this.client.post("/v1/docs/upload/async", body);
     return {
-      items: response.docs || [],
-      total: response.total || 0,
-      page: response.page_num || 1,
-      pageSize: response.page_size || 20
+      docs: response.docs.map((doc) => ({
+        id: doc.id,
+        title: doc.title,
+        originalUrl: doc.original_url
+      }))
     };
   }
   /**
-   * Search document chunks semantically
+   * Get upload status of a document
    *
-   * @param query - Search query string
-   * @param options - Search options
+   * @param docId - Document ID
+   * @returns Upload status (pending, processing, completed)
    */
-  async searchChunks(query, options = {}) {
-    const response = await this.client.post("/v1/search/chunks", {
-      query,
-      symbols: options.symbols,
-      categories: options.categories,
-      start_date: options.startDate,
-      end_date: options.endDate,
-      num: options.num || 10
-    });
-    return response.chunks || [];
+  async getUploadStatus(docId) {
+    return this.client.get(
+      `/v1/docs/${docId}/upload/status`
+    );
+  }
+  /**
+   * Delete documents
+   *
+   * @param docIds - Array of document IDs to delete
+   * @returns Deleted document IDs
+   */
+  async deleteDocs(docIds) {
+    const response = await this.client.delete(
+      "/v1/docs/delete",
+      { doc_ids: docIds }
+    );
+    return { docIds: response.doc_ids };
   }
 };
 
@@ -850,18 +957,633 @@ var ConceptsModule = class {
   }
 };
 
-// src/types.ts
-var ReportifyError = class extends Error {
-  statusCode;
-  constructor(message, statusCode) {
-    super(message);
-    this.name = "ReportifyError";
-    this.statusCode = statusCode;
+// src/channels.ts
+var ChannelsModule = class {
+  constructor(client) {
+    this.client = client;
   }
-};
-var AuthenticationError = class extends ReportifyError {
-  constructor(message = "Invalid or missing API key") {
-    super(message, 401);
+  /**
+   * Search for channels by query string
+   *
+   * @param query - Search query string
+   * @param options - Pagination options
+   */
+  async search(query, options = {}) {
+    const response = await this.client.post("/v1/channels/search", {
+      query,
+      page_num: options.pageNum || 1,
+      page_size: options.pageSize || 10
+    });
+    return {
+      items: response.channels.map((ch) => ({
+        id: ch.id,
+        name: ch.name,
+        description: ch.description,
+        avatarUrl: ch.avatar_url,
+        following: ch.following
+      })),
+      total: response.total_count || 0,
+      page: response.page_num || 1,
+      pageSize: response.page_size || 10
+    };
+  }
+  /**
+   * Get list of channels user is following
+   *
+   * @param options - Pagination options
+   */
+  async getFollowings(options = {}) {
+    const response = await this.client.get("/v1/channels/followings", {
+      page_num: options.pageNum || 1,
+      page_size: options.pageSize || 10
+    });
+    return {
+      items: response.channels.map((ch) => ({
+        id: ch.id,
+        name: ch.name,
+        description: ch.description,
+        avatarUrl: ch.avatar_url,
+        following: ch.following
+      })),
+      total: response.total_count || 0,
+      page: response.page_num || 1,
+      pageSize: response.page_size || 10
+    };
+  }
+  /**
+   * Follow a channel
+   *
+   * @param channelId - Channel ID to follow
+   */
+  async follow(channelId) {
+    const response = await this.client.post(`/v1/channels/${channelId}/follow`);
+    return {
+      id: response.id,
+      name: response.name,
+      description: response.description,
+      avatarUrl: response.avatar_url,
+      following: response.following
+    };
+  }
+  /**
+   * Unfollow a channel
+   *
+   * @param channelId - Channel ID to unfollow
+   */
+  async unfollow(channelId) {
+    return this.client.delete(
+      `/v1/channels/${channelId}/unfollow`
+    );
+  }
+  /**
+   * Get documents from followed channels
+   *
+   * @param options - Query options
+   */
+  async getDocs(options = {}) {
+    const params = {
+      page_num: options.pageNum || 1,
+      page_size: options.pageSize || 10
+    };
+    if (options.channelIds) params.channel_ids = options.channelIds;
+    const response = await this.client.get("/v1/channels/followings/docs", params);
+    return {
+      items: response.docs || [],
+      total: response.total_count || 0,
+      page: response.page_num || 1,
+      pageSize: response.page_size || 10
+    };
+  }
+};
+
+// src/chat.ts
+var ChatModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Chat completion based on document content
+   *
+   * @param query - User query
+   * @param options - Chat options
+   */
+  async completion(query, options = {}) {
+    const body = {
+      query,
+      mode: options.mode || "concise",
+      session_id: options.sessionId || "",
+      stream: options.stream ?? true
+    };
+    if (options.folderIds) body.folder_ids = options.folderIds;
+    if (options.docIds) body.doc_ids = options.docIds;
+    if (options.categories) body.categories = options.categories;
+    if (options.markets) body.markets = options.markets;
+    if (options.institutions) body.institutions = options.institutions;
+    if (options.symbols) body.symbols = options.symbols;
+    if (options.tags) body.tags = options.tags;
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    if (options.minScore !== void 0) body.min_score = options.minScore;
+    if (options.extendedFilters) body.extended_filters = options.extendedFilters;
+    const response = await this.client.post("/v1/chat/completion", body);
+    return {
+      type: response.type,
+      messageId: response.message_id,
+      message: response.message,
+      extra: response.extra
+    };
+  }
+};
+
+// src/agent.ts
+var AgentModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new agent conversation
+   *
+   * @param agentId - Agent ID
+   * @param title - Optional conversation title
+   */
+  async createConversation(agentId, title) {
+    const body = { agent_id: agentId };
+    if (title) body.title = title;
+    const response = await this.client.post("/v1/agent/conversations", body);
+    return {
+      id: response.id,
+      userId: response.user_id,
+      agentId: response.agent_id,
+      type: response.type,
+      title: response.title,
+      status: response.status,
+      createdAt: response.created_at,
+      updatedAt: response.updated_at
+    };
+  }
+  /**
+   * Chat with agent in a conversation
+   *
+   * @param conversationId - Conversation ID
+   * @param message - User message
+   * @param options - Chat options
+   */
+  async chat(conversationId, message, options = {}) {
+    const body = {
+      message,
+      stream: options.stream ?? true
+    };
+    if (options.documents) {
+      body.documents = options.documents.map((doc) => ({
+        doc_id: doc.docId,
+        doc_title: doc.docTitle,
+        file_type: doc.fileType
+      }));
+    }
+    return this.client.post(`/v1/agent/conversations/${conversationId}/chat`, body);
+  }
+  /**
+   * Get conversation details
+   *
+   * @param conversationId - Conversation ID
+   */
+  async getConversation(conversationId) {
+    const response = await this.client.get(`/v1/agent/conversations/${conversationId}`);
+    return {
+      id: response.id,
+      userId: response.user_id,
+      agentId: response.agent_id,
+      type: response.type,
+      title: response.title,
+      status: response.status,
+      createdAt: response.created_at,
+      updatedAt: response.updated_at
+    };
+  }
+  /**
+   * List messages in a conversation
+   *
+   * @param conversationId - Conversation ID
+   * @param options - Query options
+   */
+  async listMessages(conversationId, options = {}) {
+    const params = {
+      limit: options.limit || 10
+    };
+    if (options.beforeMessageId) params.before_message_id = options.beforeMessageId;
+    const response = await this.client.get(`/v1/agent/conversations/${conversationId}/messages`, params);
+    return {
+      messages: response.messages.map((msg) => ({
+        id: msg.id,
+        userId: msg.user_id,
+        conversationId: msg.conversation_id,
+        turnId: msg.turn_id,
+        role: msg.role,
+        replyToMessageId: msg.reply_to_message_id,
+        content: msg.content,
+        status: msg.status,
+        errorInfo: msg.error_info,
+        assistantMessageId: msg.assistant_message_id,
+        createdAt: msg.created_at,
+        updatedAt: msg.updated_at,
+        assistantEvents: msg.assistant_events
+      }))
+    };
+  }
+  /**
+   * Get assistant message events (streaming or non-streaming)
+   *
+   * @param conversationId - Conversation ID
+   * @param assistantMessageId - Assistant message ID from chat response header
+   * @param options - Query options
+   */
+  async getAssistantMessageEvents(conversationId, assistantMessageId, options = {}) {
+    const params = {
+      stream: options.stream ?? true,
+      timeout: options.timeout || 1800,
+      from_offset: options.fromOffset || 0
+    };
+    return this.client.get(
+      `/v1/agent/conversations/${conversationId}/messages/${assistantMessageId}`,
+      params
+    );
+  }
+  /**
+   * Cancel agent execution
+   *
+   * @param conversationId - Conversation ID
+   * @param assistantMessageId - Assistant message ID
+   */
+  async cancelExecution(conversationId, assistantMessageId) {
+    const response = await this.client.post(`/v1/agent/conversations/${conversationId}/messages/${assistantMessageId}/cancel`);
+    return {
+      responseId: response.response_id,
+      status: response.status
+    };
+  }
+  /**
+   * Get agent generated file
+   *
+   * @param fileId - Agent generated file ID
+   * @returns File content as ArrayBuffer
+   *
+   * @example
+   * ```typescript
+   * const fileContent = await client.agent.getFile('file_abc123');
+   * // Save to file in Node.js
+   * fs.writeFileSync('output.xlsx', Buffer.from(fileContent));
+   * ```
+   */
+  async getFile(fileId) {
+    return this.client.getBytes(`/v1/agent/files/${fileId}`);
+  }
+};
+
+// src/kb.ts
+var KBModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search user's knowledge base
+   *
+   * @deprecated This method uses an internal API not documented in the public OpenAPI spec.
+   *             Consider using client.docs.searchChunks() instead.
+   *
+   * Performs semantic search across documents the user has uploaded
+   * to their personal knowledge base.
+   *
+   * @param query - Search query string
+   * @param options - Search options
+   *
+   * @example
+   * ```typescript
+   * const results = await client.kb.search('quarterly revenue', { num: 5 });
+   * results.forEach(chunk => console.log(chunk.content));
+   * ```
+   */
+  async search(query, options = {}) {
+    console.warn(
+      "kb.search() uses an internal API not documented in the public OpenAPI spec. Consider using docs.searchChunks() instead."
+    );
+    const body = {
+      query,
+      num: options.num || 10
+    };
+    if (options.folderIds) body.folder_ids = options.folderIds;
+    if (options.docIds) body.doc_ids = options.docIds;
+    if (options.startDate) body.start_date = options.startDate;
+    if (options.endDate) body.end_date = options.endDate;
+    const response = await this.client.post(
+      "/v1/tools/kb/search",
+      body
+    );
+    return response.chunks || [];
+  }
+};
+
+// src/timeline.ts
+function emitDeprecationWarning(methodName) {
+  console.warn(
+    `timeline.${methodName}() uses an internal API not documented in the public OpenAPI spec. This endpoint may change without notice.`
+  );
+}
+var TimelineModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get timeline for followed companies
+   *
+   * @deprecated This method uses an internal API not documented in the public OpenAPI spec.
+   *
+   * Returns recent content related to companies the user is following.
+   *
+   * @param options.num - Number of items to return (default: 10, max: 100)
+   */
+  async companies(options = {}) {
+    emitDeprecationWarning("companies");
+    const response = await this.client.post(
+      "/v1/tools/timeline/companies",
+      { num: options.num || 10 }
+    );
+    return response.docs || [];
+  }
+  /**
+   * Get timeline for followed topics
+   *
+   * @deprecated This method uses an internal API not documented in the public OpenAPI spec.
+   *
+   * Returns recent content related to custom topics the user is following.
+   *
+   * @param options.num - Number of items to return
+   */
+  async topics(options = {}) {
+    emitDeprecationWarning("topics");
+    const response = await this.client.post(
+      "/v1/tools/timeline/topics",
+      { num: options.num || 10 }
+    );
+    return response.docs || [];
+  }
+  /**
+   * Get timeline for followed professional institutes
+   *
+   * @deprecated This method uses an internal API not documented in the public OpenAPI spec.
+   *
+   * Returns recent content from research institutions, banks, etc.
+   *
+   * @param options.num - Number of items to return
+   */
+  async institutes(options = {}) {
+    emitDeprecationWarning("institutes");
+    const response = await this.client.post(
+      "/v1/tools/timeline/institutes",
+      { num: options.num || 10 }
+    );
+    return response.docs || [];
+  }
+  /**
+   * Get timeline for followed public media
+   *
+   * @deprecated This method uses an internal API not documented in the public OpenAPI spec.
+   *
+   * Returns recent content from public media accounts.
+   *
+   * @param options.num - Number of items to return
+   */
+  async publicMedia(options = {}) {
+    emitDeprecationWarning("publicMedia");
+    const response = await this.client.post(
+      "/v1/tools/timeline/public-media",
+      { num: options.num || 10 }
+    );
+    return response.docs || [];
+  }
+  /**
+   * Get timeline for followed social media
+   *
+   * @deprecated This method uses an internal API not documented in the public OpenAPI spec.
+   *
+   * Returns recent content from social media accounts.
+   *
+   * @param options.num - Number of items to return
+   */
+  async socialMedia(options = {}) {
+    emitDeprecationWarning("socialMedia");
+    const response = await this.client.post(
+      "/v1/tools/timeline/social-media",
+      { num: options.num || 10 }
+    );
+    return response.docs || [];
+  }
+};
+
+// src/user.ts
+var UserModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get all companies followed by the user
+   *
+   * Returns a list of companies that the user is following,
+   * including company details like symbol, name, logo, and follow timestamp.
+   *
+   * @example
+   * ```typescript
+   * const companies = await client.user.followedCompanies();
+   * companies.forEach(company => {
+   *   console.log(`${company.symbol}: ${company.name}`);
+   * });
+   * ```
+   */
+  async followedCompanies() {
+    const response = await this.client.get("/v1/tools/user/followed-companies");
+    return (response.companies || []).map((company) => ({
+      symbol: company.symbol,
+      ticker: company.ticker,
+      market: company.market,
+      name: company.name,
+      chineseName: company.chinese_name,
+      englishName: company.english_name,
+      logo: company.logo,
+      followedAt: company.followed_at
+    }));
+  }
+};
+
+// src/search.ts
+var SearchModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search documents across all categories
+   *
+   * @param query - Search query string
+   * @param options - Search options
+   * @returns List of matching documents
+   */
+  async all(query, options = {}) {
+    const body = {
+      query,
+      num: options.num || 10
+    };
+    if (options.categories) body.categories = options.categories;
+    if (options.symbols) body.symbols = options.symbols;
+    if (options.industries) body.industries = options.industries;
+    if (options.channelIds) body.channel_ids = options.channelIds;
+    if (options.startDatetime) body.start_datetime = options.startDatetime;
+    if (options.endDatetime) body.end_datetime = options.endDatetime;
+    const response = await this.client.post("/v2/search", body);
+    return response.docs || [];
+  }
+  /**
+   * Search news articles
+   */
+  async news(query, options = {}) {
+    const body = {
+      query,
+      num: options.num || 10
+    };
+    if (options.symbols) body.symbols = options.symbols;
+    if (options.channelIds) body.channel_ids = options.channelIds;
+    if (options.startDatetime) body.start_datetime = options.startDatetime;
+    if (options.endDatetime) body.end_datetime = options.endDatetime;
+    const response = await this.client.post("/v2/search/news", body);
+    return response.docs || [];
+  }
+  /**
+   * Search research reports
+   */
+  async reports(query, options = {}) {
+    const body = {
+      query,
+      num: options.num || 10
+    };
+    if (options.symbols) body.symbols = options.symbols;
+    if (options.industries) body.industries = options.industries;
+    if (options.channelIds) body.channel_ids = options.channelIds;
+    if (options.startDatetime) body.start_datetime = options.startDatetime;
+    if (options.endDatetime) body.end_datetime = options.endDatetime;
+    const response = await this.client.post("/v2/search/reports", body);
+    return response.docs || [];
+  }
+  /**
+   * Search company filings
+   *
+   * @param query - Search query string
+   * @param symbols - Required: Stock symbols to filter by
+   * @param options - Search options
+   */
+  async filings(query, symbols, options = {}) {
+    const body = {
+      query,
+      symbols,
+      num: options.num || 10
+    };
+    if (options.startDatetime) body.start_datetime = options.startDatetime;
+    if (options.endDatetime) body.end_datetime = options.endDatetime;
+    const response = await this.client.post("/v2/search/filings", body);
+    return response.docs || [];
+  }
+  /**
+   * Search earnings call transcripts and slides
+   *
+   * @param query - Search query string
+   * @param symbols - Required: Stock symbols to filter by
+   * @param options - Search options including fiscal year/quarter filters
+   */
+  async conferenceCalls(query, symbols, options = {}) {
+    const body = {
+      query,
+      symbols,
+      num: options.num || 10
+    };
+    if (options.startDatetime) body.start_datetime = options.startDatetime;
+    if (options.endDatetime) body.end_datetime = options.endDatetime;
+    if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
+    if (options.fiscalQuarter) body.fiscal_quarter = options.fiscalQuarter;
+    const response = await this.client.post("/v2/search/conference-calls", body);
+    return response.docs || [];
+  }
+  /**
+   * Search earnings financial reports
+   *
+   * @param query - Search query string
+   * @param symbols - Required: Stock symbols to filter by
+   * @param options - Search options including fiscal year/quarter filters
+   */
+  async earningsPack(query, symbols, options = {}) {
+    const body = {
+      query,
+      symbols,
+      num: options.num || 10
+    };
+    if (options.startDatetime) body.start_datetime = options.startDatetime;
+    if (options.endDatetime) body.end_datetime = options.endDatetime;
+    if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
+    if (options.fiscalQuarter) body.fiscal_quarter = options.fiscalQuarter;
+    const response = await this.client.post("/v2/search/earnings-pack", body);
+    return response.docs || [];
+  }
+  /**
+   * Search conference calls and IR (Investor Relations) meetings
+   */
+  async minutes(query, options = {}) {
+    const body = {
+      query,
+      num: options.num || 10
+    };
+    if (options.symbols) body.symbols = options.symbols;
+    if (options.startDatetime) body.start_datetime = options.startDatetime;
+    if (options.endDatetime) body.end_datetime = options.endDatetime;
+    const response = await this.client.post("/v2/search/minutes", body);
+    return response.docs || [];
+  }
+  /**
+   * Search social media content
+   */
+  async socials(query, options = {}) {
+    const body = {
+      query,
+      num: options.num || 10
+    };
+    if (options.symbols) body.symbols = options.symbols;
+    if (options.channelIds) body.channel_ids = options.channelIds;
+    if (options.startDatetime) body.start_datetime = options.startDatetime;
+    if (options.endDatetime) body.end_datetime = options.endDatetime;
+    const response = await this.client.post("/v2/search/socials", body);
+    return response.docs || [];
+  }
+  /**
+   * Search webpage content
+   */
+  async webpages(query, options = {}) {
+    const body = {
+      query,
+      num: options.num || 10
+    };
+    if (options.startDatetime) body.start_datetime = options.startDatetime;
+    if (options.endDatetime) body.end_datetime = options.endDatetime;
+    const response = await this.client.post("/v2/search/webpages", body);
+    return response.docs || [];
+  }
+};
+
+// src/types.ts
+var ReportifyError = class extends Error {
+  statusCode;
+  constructor(message, statusCode) {
+    super(message);
+    this.name = "ReportifyError";
+    this.statusCode = statusCode;
+  }
+};
+var AuthenticationError = class extends ReportifyError {
+  constructor(message = "Invalid or missing API key") {
+    super(message, 401);
     this.name = "AuthenticationError";
   }
 };
@@ -892,12 +1614,17 @@ var Reportify = class {
   baseUrl;
   timeout;
   // Sub-modules
+  search;
   stock;
-  timeline;
-  kb;
   docs;
   quant;
   concepts;
+  channels;
+  chat;
+  agent;
+  kb;
+  timeline;
+  user;
   constructor(config) {
     if (!config.apiKey) {
       throw new AuthenticationError("API key is required");
@@ -905,12 +1632,17 @@ var Reportify = class {
     this.apiKey = config.apiKey;
     this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.timeout = config.timeout || DEFAULT_TIMEOUT;
+    this.search = new SearchModule(this);
     this.stock = new StockModule(this);
-    this.timeline = new TimelineModule(this);
-    this.kb = new KBModule(this);
     this.docs = new DocsModule(this);
     this.quant = new QuantModule(this);
     this.concepts = new ConceptsModule(this);
+    this.channels = new ChannelsModule(this);
+    this.chat = new ChatModule(this);
+    this.agent = new AgentModule(this);
+    this.kb = new KBModule(this);
+    this.timeline = new TimelineModule(this);
+    this.user = new UserModule(this);
   }
   /**
    * Make an HTTP request to the API
@@ -932,7 +1664,7 @@ var Reportify = class {
         headers: {
           Authorization: `Bearer ${this.apiKey}`,
           "Content-Type": "application/json",
-          "User-Agent": "reportify-sdk-js/0.2.8"
+          "User-Agent": "reportify-sdk-js/0.2.10"
         },
         body: options.body ? JSON.stringify(options.body) : void 0,
         signal: controller.signal
@@ -977,90 +1709,46 @@ var Reportify = class {
   async post(path, body) {
     return this.request("POST", path, { body });
   }
-  // ===========================================================================
-  // Search Methods
-  // ===========================================================================
-  /**
-   * Search documents across all categories
-   *
-   * @param query - Search query string
-   * @param options - Search options
-   * @returns List of matching documents
-   *
-   * @example
-   * ```typescript
-   * const docs = await client.search('Tesla earnings', { num: 10 });
-   * docs.forEach(doc => console.log(doc.title));
-   * ```
-   */
-  async search(query, options = {}) {
-    const response = await this.post("/v2/search", {
-      query,
-      num: options.num || 10,
-      categories: options.categories,
-      symbols: options.symbols,
-      start_date: options.startDate,
-      end_date: options.endDate
-    });
-    return response.docs || [];
-  }
   /**
-   * Search news articles
+   * Make a DELETE request
    */
-  async searchNews(query, options = {}) {
-    const response = await this.post("/v2/search/news", {
-      query,
-      num: options.num || 10,
-      symbols: options.symbols,
-      start_date: options.startDate,
-      end_date: options.endDate
-    });
-    return response.docs || [];
+  async delete(path, body) {
+    return this.request("DELETE", path, { body });
   }
   /**
-   * Search research reports
+   * Make a GET request and return raw bytes (for file downloads)
    */
-  async searchReports(query, options = {}) {
-    const response = await this.post("/v2/search/reports", {
-      query,
-      num: options.num || 10,
-      symbols: options.symbols,
-      start_date: options.startDate,
-      end_date: options.endDate
-    });
-    return response.docs || [];
-  }
-  /**
-   * Search company filings
-   */
-  async searchFilings(query, options = {}) {
-    const response = await this.post("/v2/search/filings", {
-      query,
-      num: options.num || 10,
-      symbols: options.symbols,
-      start_date: options.startDate,
-      end_date: options.endDate
-    });
-    return response.docs || [];
-  }
-  /**
-   * Search earnings call transcripts
-   */
-  async searchTranscripts(query, options = {}) {
-    const response = await this.post("/v2/search/conference-calls", {
-      query,
-      num: options.num || 10,
-      symbols: options.symbols,
-      start_date: options.startDate,
-      end_date: options.endDate
+  async getBytes(path) {
+    const url = `${this.baseUrl}${path}`;
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": "reportify-sdk-typescript/0.2.10"
+      }
     });
-    return response.docs || [];
+    if (!response.ok) {
+      if (response.status === 401) {
+        throw new AuthenticationError("Invalid API key");
+      } else if (response.status === 404) {
+        throw new NotFoundError(`Resource not found: ${path}`);
+      } else if (response.status === 429) {
+        throw new RateLimitError("Rate limit exceeded");
+      } else {
+        throw new APIError(`API error: ${response.status}`);
+      }
+    }
+    return response.arrayBuffer();
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APIError,
+  AgentModule,
   AuthenticationError,
+  ChannelsModule,
+  ChatModule,
   ConceptsModule,
   DocsModule,
   KBModule,
@@ -1069,6 +1757,8 @@ var Reportify = class {
   RateLimitError,
   Reportify,
   ReportifyError,
+  SearchModule,
   StockModule,
-  TimelineModule
+  TimelineModule,
+  UserModule
 });