sentisense 0.58.0 → 0.60.0

package/dist/index.d.mts

@@ -563,6 +563,8 @@ interface OptionsAggregate {
     netDelta?: number;
     notionalVol?: number;
     contracts?: number;
+    /** Largest unusual-contract premium this session; zero when none qualified. */
+    maxUnusualPremium?: number;
 }
 /**
  * Percentile context for {@link OptionsAggregate}, against that ticker's own trailing
@@ -578,6 +580,8 @@ interface OptionsContext {
     /** Where today's at-the-money implied volatility sits in its own trailing year. */
     ivRank1y?: number;
     skewPctl1y?: number;
+    /** Percentile of this session's largest unusual premium within its trailing year, 0-100. */
+    unusualPremiumPctl1y?: number;
     observations1y?: number;
 }
 /** One open-interest concentration at a strike. */
@@ -606,6 +610,15 @@ interface OptionsUnusualContract {
     oi?: number;
     volOiRatio?: number;
     premium?: number;
+    oiPrior?: number;
+    oiNext?: number;
+    oiChange?: number;
+    /** Net open-interest change: opened, closed, mixed, pending, or unmatched. */
+    oiConfirmation?: "opened" | "closed" | "mixed" | "pending" | "unmatched";
+    /** Open-interest observation time in UTC epoch seconds. */
+    oiObservedAt?: number;
+    /** Which chain supplied the observed open interest. */
+    oiVintage?: "prior_settle" | "settled" | "next_session";
 }
 /**
  * The options dossier for one stock or ETF, from `client.stocks.getOptionsSummary()`.
@@ -734,6 +747,34 @@ interface OptionsOverviewRow {
     /** That wall's share of its own side's open interest, 0 to 1. */
     wallShare?: number;
 }
+/** One ticker's highest-premium unusual contract in the completed session. */
+interface OptionsHighlight {
+    ticker?: string;
+    contract?: string;
+    type?: string;
+    strike?: number;
+    expiry?: string;
+    dte?: number;
+    volume?: number;
+    oi?: number;
+    volOiRatio?: number;
+    premium?: number;
+    /** Percentile against this ticker's trailing-year largest daily unusual premiums, 0-100. */
+    premiumPctl1y?: number;
+    oiPrior?: number;
+    oiNext?: number;
+    oiChange?: number;
+    oiConfirmation?: OptionsUnusualContract["oiConfirmation"];
+    /** Open-interest observation time in UTC epoch seconds. */
+    oiObservedAt?: number;
+    oiVintage?: OptionsUnusualContract["oiVintage"];
+    /** Completed session, ISO calendar day. */
+    asOf?: string;
+    /** UTC ISO timestamp when the build published this highlight. */
+    publishedAt?: string;
+    /** `completed` for an end-of-day session. */
+    session?: string;
+}
 /**
  * The market-wide options radar, from `client.options.getOverview()`.
  *
@@ -765,6 +806,10 @@ interface OptionsOverview {
     rows?: OptionsOverviewRow[];
     /** The ETF board, ranked independently. Omitted entirely when a build has no ETF rows. */
     etfRows?: OptionsOverviewRow[];
+    /** Stock session highlights, up to 3 for FREE keys and 10 for PRO. Omitted when empty. */
+    highlights?: OptionsHighlight[];
+    /** ETF session highlights, up to 3 for FREE keys and 10 for PRO. Omitted when empty. */
+    etfHighlights?: OptionsHighlight[];
     /** Median `ivRank1y` across the ETF board. */
     etfMedianIvRank?: number;
     /** Median put/call volume ratio across the ETF board. */
@@ -1983,11 +2028,28 @@ interface ServingMetric {
 }
 /** Distribution data returned by the v2 distribution endpoint. */
 interface MetricDistribution {
+    /** The metric queried. */
+    metricType?: string;
+    /** The dimension the metric is broken down by, e.g. "source". */
+    dimension?: string;
+    /** Dimension value to a number whose meaning `valueType` gives. Empty when there is no data. */
+    distribution?: Record<string, number>;
+    /**
+     * `"SHARE_PERCENT"` for a count metric (mentions, creators): each value is a percentage share
+     * of the total, summing to about 100. `"MEAN"` for a value metric (sentiment): each value is
+     * the mean reading on the metric's own scale, never a share.
+     */
+    valueType?: "SHARE_PERCENT" | "MEAN";
     [key: string]: unknown;
 }
 interface MarketMood {
     [key: string]: unknown;
 }
+/** Options for `MarketMoodResource.get()`. */
+interface MarketMoodOptions {
+    /** Days of history to return. Omit to get the API's default of 180. */
+    days?: number;
+}
 /** AI-generated market summary with headline and analysis. */
 interface MarketSummary {
     /** Not populated by the API (always empty); retained for backward compatibility. */
@@ -3221,10 +3283,16 @@ declare class EntityMetrics {
      */
     getMetrics(symbol: string, options?: MetricsOptions): Promise<ServingMetric[]>;
     /**
-     * Get distribution data for a metric, broken down by a dimension (default: source).
+     * Get a metric broken down by dimension (default dimension: source).
+     *
+     * `valueType` on the response says what each number in `distribution` is. For a count metric
+     * such as `"mentions"` it is `"SHARE_PERCENT"`: each source's percentage share of the total,
+     * summing to about 100. For `"sentiment"` it is `"MEAN"`: each source's mean polarity over the
+     * window, in [-1, 1]. `"sentisense_score"` has no per-source split and answers with an empty
+     * distribution.
      *
      * @param symbol     Ticker symbol (e.g. "AAPL") or entity urlSlug.
-     * @param metricType The metric to break down (e.g. "mentions", "sentiment").
+     * @param metricType The metric to break down (e.g. "mentions" or "sentiment").
      * @param options    Optional dimension parameter.
      */
     getDistribution(symbol: string, metricType: MetricType, options?: MetricDistributionOptions): Promise<MetricDistribution>;
@@ -3683,7 +3751,13 @@ declare class KB {
 declare class MarketMoodResource {
     private client;
     constructor(client: APIClient);
-    /** Get market mood data (scores, history, sectors). */
+    /**
+     * Get market mood data (scores, history, sectors).
+     *
+     * @param options `days` sets how many days of history to return. Omit it to get the
+     *                API's default of 180.
+     */
+    get(options?: MarketMoodOptions): Promise<MarketMood>;
     get(): Promise<MarketMood>;
 }
 
@@ -4203,6 +4277,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.58.0";
+declare const VERSION = "0.60.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, 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 };
+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 MarketMoodOptions, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type OptionsAggregate, type OptionsContext, type OptionsHighlight, 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

@@ -563,6 +563,8 @@ interface OptionsAggregate {
     netDelta?: number;
     notionalVol?: number;
     contracts?: number;
+    /** Largest unusual-contract premium this session; zero when none qualified. */
+    maxUnusualPremium?: number;
 }
 /**
  * Percentile context for {@link OptionsAggregate}, against that ticker's own trailing
@@ -578,6 +580,8 @@ interface OptionsContext {
     /** Where today's at-the-money implied volatility sits in its own trailing year. */
     ivRank1y?: number;
     skewPctl1y?: number;
+    /** Percentile of this session's largest unusual premium within its trailing year, 0-100. */
+    unusualPremiumPctl1y?: number;
     observations1y?: number;
 }
 /** One open-interest concentration at a strike. */
@@ -606,6 +610,15 @@ interface OptionsUnusualContract {
     oi?: number;
     volOiRatio?: number;
     premium?: number;
+    oiPrior?: number;
+    oiNext?: number;
+    oiChange?: number;
+    /** Net open-interest change: opened, closed, mixed, pending, or unmatched. */
+    oiConfirmation?: "opened" | "closed" | "mixed" | "pending" | "unmatched";
+    /** Open-interest observation time in UTC epoch seconds. */
+    oiObservedAt?: number;
+    /** Which chain supplied the observed open interest. */
+    oiVintage?: "prior_settle" | "settled" | "next_session";
 }
 /**
  * The options dossier for one stock or ETF, from `client.stocks.getOptionsSummary()`.
@@ -734,6 +747,34 @@ interface OptionsOverviewRow {
     /** That wall's share of its own side's open interest, 0 to 1. */
     wallShare?: number;
 }
+/** One ticker's highest-premium unusual contract in the completed session. */
+interface OptionsHighlight {
+    ticker?: string;
+    contract?: string;
+    type?: string;
+    strike?: number;
+    expiry?: string;
+    dte?: number;
+    volume?: number;
+    oi?: number;
+    volOiRatio?: number;
+    premium?: number;
+    /** Percentile against this ticker's trailing-year largest daily unusual premiums, 0-100. */
+    premiumPctl1y?: number;
+    oiPrior?: number;
+    oiNext?: number;
+    oiChange?: number;
+    oiConfirmation?: OptionsUnusualContract["oiConfirmation"];
+    /** Open-interest observation time in UTC epoch seconds. */
+    oiObservedAt?: number;
+    oiVintage?: OptionsUnusualContract["oiVintage"];
+    /** Completed session, ISO calendar day. */
+    asOf?: string;
+    /** UTC ISO timestamp when the build published this highlight. */
+    publishedAt?: string;
+    /** `completed` for an end-of-day session. */
+    session?: string;
+}
 /**
  * The market-wide options radar, from `client.options.getOverview()`.
  *
@@ -765,6 +806,10 @@ interface OptionsOverview {
     rows?: OptionsOverviewRow[];
     /** The ETF board, ranked independently. Omitted entirely when a build has no ETF rows. */
     etfRows?: OptionsOverviewRow[];
+    /** Stock session highlights, up to 3 for FREE keys and 10 for PRO. Omitted when empty. */
+    highlights?: OptionsHighlight[];
+    /** ETF session highlights, up to 3 for FREE keys and 10 for PRO. Omitted when empty. */
+    etfHighlights?: OptionsHighlight[];
     /** Median `ivRank1y` across the ETF board. */
     etfMedianIvRank?: number;
     /** Median put/call volume ratio across the ETF board. */
@@ -1983,11 +2028,28 @@ interface ServingMetric {
 }
 /** Distribution data returned by the v2 distribution endpoint. */
 interface MetricDistribution {
+    /** The metric queried. */
+    metricType?: string;
+    /** The dimension the metric is broken down by, e.g. "source". */
+    dimension?: string;
+    /** Dimension value to a number whose meaning `valueType` gives. Empty when there is no data. */
+    distribution?: Record<string, number>;
+    /**
+     * `"SHARE_PERCENT"` for a count metric (mentions, creators): each value is a percentage share
+     * of the total, summing to about 100. `"MEAN"` for a value metric (sentiment): each value is
+     * the mean reading on the metric's own scale, never a share.
+     */
+    valueType?: "SHARE_PERCENT" | "MEAN";
     [key: string]: unknown;
 }
 interface MarketMood {
     [key: string]: unknown;
 }
+/** Options for `MarketMoodResource.get()`. */
+interface MarketMoodOptions {
+    /** Days of history to return. Omit to get the API's default of 180. */
+    days?: number;
+}
 /** AI-generated market summary with headline and analysis. */
 interface MarketSummary {
     /** Not populated by the API (always empty); retained for backward compatibility. */
@@ -3221,10 +3283,16 @@ declare class EntityMetrics {
      */
     getMetrics(symbol: string, options?: MetricsOptions): Promise<ServingMetric[]>;
     /**
-     * Get distribution data for a metric, broken down by a dimension (default: source).
+     * Get a metric broken down by dimension (default dimension: source).
+     *
+     * `valueType` on the response says what each number in `distribution` is. For a count metric
+     * such as `"mentions"` it is `"SHARE_PERCENT"`: each source's percentage share of the total,
+     * summing to about 100. For `"sentiment"` it is `"MEAN"`: each source's mean polarity over the
+     * window, in [-1, 1]. `"sentisense_score"` has no per-source split and answers with an empty
+     * distribution.
      *
      * @param symbol     Ticker symbol (e.g. "AAPL") or entity urlSlug.
-     * @param metricType The metric to break down (e.g. "mentions", "sentiment").
+     * @param metricType The metric to break down (e.g. "mentions" or "sentiment").
      * @param options    Optional dimension parameter.
      */
     getDistribution(symbol: string, metricType: MetricType, options?: MetricDistributionOptions): Promise<MetricDistribution>;
@@ -3683,7 +3751,13 @@ declare class KB {
 declare class MarketMoodResource {
     private client;
     constructor(client: APIClient);
-    /** Get market mood data (scores, history, sectors). */
+    /**
+     * Get market mood data (scores, history, sectors).
+     *
+     * @param options `days` sets how many days of history to return. Omit it to get the
+     *                API's default of 180.
+     */
+    get(options?: MarketMoodOptions): Promise<MarketMood>;
     get(): Promise<MarketMood>;
 }
 
@@ -4203,6 +4277,6 @@ declare class APIError extends SentiSenseError {
     constructor(message: string, status: number, code?: string);
 }
 
-declare const VERSION = "0.58.0";
+declare const VERSION = "0.60.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, 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 };
+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 MarketMoodOptions, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type OptionsAggregate, type OptionsContext, type OptionsHighlight, 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

@@ -408,10 +408,16 @@ var EntityMetrics = class {
     );
   }
   /**
-   * Get distribution data for a metric, broken down by a dimension (default: source).
+   * Get a metric broken down by dimension (default dimension: source).
+   *
+   * `valueType` on the response says what each number in `distribution` is. For a count metric
+   * such as `"mentions"` it is `"SHARE_PERCENT"`: each source's percentage share of the total,
+   * summing to about 100. For `"sentiment"` it is `"MEAN"`: each source's mean polarity over the
+   * window, in [-1, 1]. `"sentisense_score"` has no per-source split and answers with an empty
+   * distribution.
    *
    * @param symbol     Ticker symbol (e.g. "AAPL") or entity urlSlug.
-   * @param metricType The metric to break down (e.g. "mentions", "sentiment").
+   * @param metricType The metric to break down (e.g. "mentions" or "sentiment").
    * @param options    Optional dimension parameter.
    */
   async getDistribution(symbol, metricType, options = {}) {
@@ -802,12 +808,13 @@ var MarketMoodResource = class {
   constructor(client) {
     this.client = client;
   }
-  /** Get market mood data (scores, history, sectors). */
-  async get() {
-    return this.client.get("/api/v2/market-mood");
+  async get(options) {
+    const days = options?.days;
+    return this.client.get(
+      "/api/v2/market-mood",
+      days === void 0 ? void 0 : { days }
+    );
   }
-  // TODO: accept a `days` param to control history length (the endpoint supports ?days=N).
-  //
   // Market Mood is also reachable through `client.indexes`, which serves it in the shared
   // index envelope alongside fed-sentiment and ai-sentiment. Use this resource when you want
   // the phase band, weekly change, per-signal breakdown and per-sector map; use `indexes`
@@ -1311,7 +1318,7 @@ var Trackers = class {
 };
 
 // src/version.ts
-var VERSION = "0.58.0";
+var VERSION = "0.60.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";