sentisense 0.56.0 → 0.58.0

package/dist/index.d.mts

@@ -274,6 +274,18 @@ interface ChartDataPoint {
      * `null` for daily / weekly bars (3M and longer) that span whole sessions.
      */
     session?: "pre" | "regular" | "post" | null;
+    /**
+     * True when the bar is restated to the stock's current share count rather than served as it
+     * printed at the time. Always true on this endpoint.
+     *
+     * A stock that has split since a bar was printed would otherwise show that bar on a different
+     * basis from the current one, so both prices and volume are converted to current shares. The
+     * practical consequence is on `volume`: for a stock with a large cumulative split factor, older
+     * bars can report share counts many times the raw prints of the day, which is the restatement
+     * and not an error. Prices through `5Y` are split-adjusted; `10Y` and `MAX` are split- and
+     * dividend-adjusted.
+     */
+    adjusted?: boolean;
 }
 interface ChartData {
     ticker: string;
@@ -284,6 +296,22 @@ interface MarketStatus {
     status: string;
     [key: string]: unknown;
 }
+/**
+ * How one period's EPS was restated to the current share basis, on the rows that carry it.
+ *
+ * Reproduce the original figure by dividing the served value by `multiplier`.
+ */
+interface EpsBasisRepair {
+    /** Which EPS fields on the row were restated, in the order `epsBasic`, `epsDiluted`, `eps`. */
+    fields: string[];
+    /** Restated value divided by the value the provider reported: `0.25` for a 4-for-1 split. */
+    multiplier: number;
+    /**
+     * Execution dates of the splits the provider had not applied to this row's EPS, newest first,
+     * as `YYYY-MM-DD`.
+     */
+    splitExecutionDates: string[];
+}
 /**
  * One period of filed financial statement data from `stocks.getFundamentals()`.
  *
@@ -332,6 +360,26 @@ interface Fundamentals {
     epsBasic?: number | null;
     /** Diluted earnings per share. `null` when the provider reports no diluted figure. */
     epsDiluted?: number | null;
+    /**
+     * Present when this row's EPS was restated, and `null` on almost every row.
+     *
+     * Per-period EPS is served as the provider reports it, and is restated for a small list of
+     * named issuers and nowhere else. A provider that restates a company's share counts for a
+     * split but leaves some older rows' EPS on the pre-split basis produces rows that contradict
+     * themselves; where that has been checked against the company's own filing, the EPS on the
+     * affected rows is divided by the split ratio so it agrees with the share count beside it.
+     * Share counts and net income are never changed.
+     *
+     * `null` means no EPS repair was applied to this row. It does NOT mean the row's EPS and share
+     * count are known to be on the same basis: an unlisted issuer, a row whose figures did not
+     * qualify, and a row whose split history could not be read all carry `null`.
+     *
+     * This marker describes per-period EPS only. The repair never changes `epsTTM` or the other
+     * trailing-twelve-month figures, and the marker never describes a trailing adjustment: those are
+     * assembled separately, and whether they carry a split adjustment of their own depends on which
+     * source served them.
+     */
+    epsBasisRepair?: EpsBasisRepair | null;
     /**
      * The provider's bottom-line income line, which can differ from `netIncome` in size and in
      * sign. Published as the provider states it; it is not promised to reconcile with either EPS
@@ -1051,6 +1099,18 @@ interface GetStoriesOptions {
     /** Look-back window in hours, for example 48 for the last two days. */
     filterHours?: number;
 }
+interface SearchStoriesOptions {
+    /**
+     * Free text, for example `fed decision` or `kb/company/1 guidance`. Explicit entity ids are
+     * read first, then entities recognised in the text, then the remaining words as keywords that
+     * must all appear in the story's own title or summary. A blank query is rejected with a 400.
+     */
+    query: string;
+    /** Look-back window in days, 1 to 30, defaulting to 7. Stories older than 30 days are archived and not searchable. */
+    days?: number;
+    /** Maximum number of stories, defaulting to 20 and capped at 50. */
+    limit?: number;
+}
 interface GetStoriesByTickerOptions {
     limit?: number;
 }
@@ -3046,6 +3106,15 @@ declare class Documents {
      * exported for that array.
      */
     getStoryDetail(clusterId: string): Promise<unknown>;
+    /**
+     * Free-text search across the AI-curated stories, newest first.
+     *
+     * The query is parsed like {@link Documents.search}: explicit entity ids first, then entities
+     * recognised in the text, then the remaining words as keywords that must all appear in the
+     * story's own title or summary. The rows are the same {@link Story} shape {@link
+     * Documents.getStories} returns, so an `id` can go straight to {@link Documents.getStoryDetail}.
+     */
+    searchStories(options: SearchStoriesOptions): Promise<Story[]>;
     /** Get stories for a specific stock. */
     getStoriesByTicker(ticker: string, options?: GetStoriesByTickerOptions): Promise<Story[]>;
 }
@@ -4134,6 +4203,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.56.0";
+declare const VERSION = "0.58.0";
 
-export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type OptionsAggregate, type OptionsContext, type OptionsHistory, type OptionsHistoryWindow, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, type TickerHolders, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };
+export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type OptionsAggregate, type OptionsContext, type OptionsHistory, type OptionsHistoryWindow, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, type SearchStoriesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, type TickerHolders, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };

package/dist/index.d.ts

@@ -274,6 +274,18 @@ interface ChartDataPoint {
      * `null` for daily / weekly bars (3M and longer) that span whole sessions.
      */
     session?: "pre" | "regular" | "post" | null;
+    /**
+     * True when the bar is restated to the stock's current share count rather than served as it
+     * printed at the time. Always true on this endpoint.
+     *
+     * A stock that has split since a bar was printed would otherwise show that bar on a different
+     * basis from the current one, so both prices and volume are converted to current shares. The
+     * practical consequence is on `volume`: for a stock with a large cumulative split factor, older
+     * bars can report share counts many times the raw prints of the day, which is the restatement
+     * and not an error. Prices through `5Y` are split-adjusted; `10Y` and `MAX` are split- and
+     * dividend-adjusted.
+     */
+    adjusted?: boolean;
 }
 interface ChartData {
     ticker: string;
@@ -284,6 +296,22 @@ interface MarketStatus {
     status: string;
     [key: string]: unknown;
 }
+/**
+ * How one period's EPS was restated to the current share basis, on the rows that carry it.
+ *
+ * Reproduce the original figure by dividing the served value by `multiplier`.
+ */
+interface EpsBasisRepair {
+    /** Which EPS fields on the row were restated, in the order `epsBasic`, `epsDiluted`, `eps`. */
+    fields: string[];
+    /** Restated value divided by the value the provider reported: `0.25` for a 4-for-1 split. */
+    multiplier: number;
+    /**
+     * Execution dates of the splits the provider had not applied to this row's EPS, newest first,
+     * as `YYYY-MM-DD`.
+     */
+    splitExecutionDates: string[];
+}
 /**
  * One period of filed financial statement data from `stocks.getFundamentals()`.
  *
@@ -332,6 +360,26 @@ interface Fundamentals {
     epsBasic?: number | null;
     /** Diluted earnings per share. `null` when the provider reports no diluted figure. */
     epsDiluted?: number | null;
+    /**
+     * Present when this row's EPS was restated, and `null` on almost every row.
+     *
+     * Per-period EPS is served as the provider reports it, and is restated for a small list of
+     * named issuers and nowhere else. A provider that restates a company's share counts for a
+     * split but leaves some older rows' EPS on the pre-split basis produces rows that contradict
+     * themselves; where that has been checked against the company's own filing, the EPS on the
+     * affected rows is divided by the split ratio so it agrees with the share count beside it.
+     * Share counts and net income are never changed.
+     *
+     * `null` means no EPS repair was applied to this row. It does NOT mean the row's EPS and share
+     * count are known to be on the same basis: an unlisted issuer, a row whose figures did not
+     * qualify, and a row whose split history could not be read all carry `null`.
+     *
+     * This marker describes per-period EPS only. The repair never changes `epsTTM` or the other
+     * trailing-twelve-month figures, and the marker never describes a trailing adjustment: those are
+     * assembled separately, and whether they carry a split adjustment of their own depends on which
+     * source served them.
+     */
+    epsBasisRepair?: EpsBasisRepair | null;
     /**
      * The provider's bottom-line income line, which can differ from `netIncome` in size and in
      * sign. Published as the provider states it; it is not promised to reconcile with either EPS
@@ -1051,6 +1099,18 @@ interface GetStoriesOptions {
     /** Look-back window in hours, for example 48 for the last two days. */
     filterHours?: number;
 }
+interface SearchStoriesOptions {
+    /**
+     * Free text, for example `fed decision` or `kb/company/1 guidance`. Explicit entity ids are
+     * read first, then entities recognised in the text, then the remaining words as keywords that
+     * must all appear in the story's own title or summary. A blank query is rejected with a 400.
+     */
+    query: string;
+    /** Look-back window in days, 1 to 30, defaulting to 7. Stories older than 30 days are archived and not searchable. */
+    days?: number;
+    /** Maximum number of stories, defaulting to 20 and capped at 50. */
+    limit?: number;
+}
 interface GetStoriesByTickerOptions {
     limit?: number;
 }
@@ -3046,6 +3106,15 @@ declare class Documents {
      * exported for that array.
      */
     getStoryDetail(clusterId: string): Promise<unknown>;
+    /**
+     * Free-text search across the AI-curated stories, newest first.
+     *
+     * The query is parsed like {@link Documents.search}: explicit entity ids first, then entities
+     * recognised in the text, then the remaining words as keywords that must all appear in the
+     * story's own title or summary. The rows are the same {@link Story} shape {@link
+     * Documents.getStories} returns, so an `id` can go straight to {@link Documents.getStoryDetail}.
+     */
+    searchStories(options: SearchStoriesOptions): Promise<Story[]>;
     /** Get stories for a specific stock. */
     getStoriesByTicker(ticker: string, options?: GetStoriesByTickerOptions): Promise<Story[]>;
 }
@@ -4134,6 +4203,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.56.0";
+declare const VERSION = "0.58.0";
 
-export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type OptionsAggregate, type OptionsContext, type OptionsHistory, type OptionsHistoryWindow, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, type TickerHolders, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };
+export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type OptionsAggregate, type OptionsContext, type OptionsHistory, type OptionsHistoryWindow, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, type SearchStoriesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, type TickerHolders, type TrackerEvent, type TrackerGeoEntry, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };

package/dist/index.mjs

@@ -271,6 +271,17 @@ var Documents = class {
   async getStoryDetail(clusterId) {
     return this.client.get(`/api/v1/documents/stories/${encodeURIComponent(clusterId)}`);
   }
+  /**
+   * Free-text search across the AI-curated stories, newest first.
+   *
+   * The query is parsed like {@link Documents.search}: explicit entity ids first, then entities
+   * recognised in the text, then the remaining words as keywords that must all appear in the
+   * story's own title or summary. The rows are the same {@link Story} shape {@link
+   * Documents.getStories} returns, so an `id` can go straight to {@link Documents.getStoryDetail}.
+   */
+  async searchStories(options) {
+    return this.client.get("/api/v1/documents/stories/search", options);
+  }
   /** Get stories for a specific stock. */
   async getStoriesByTicker(ticker, options) {
     return this.client.get(
@@ -1300,7 +1311,7 @@ var Trackers = class {
 };
 
 // src/version.ts
-var VERSION = "0.56.0";
+var VERSION = "0.58.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";