@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/analytics.d.ts

@@ -0,0 +1,1273 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.analytics` (Analytics): 51 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"compute_cohort_analytics_sales_report_cohort_post">;
+ *
+ * Reference with examples: analytics.md
+ */
+/* eslint-disable */
+
+/** `g8.api.analytics.<member>` -> the operationId it calls. */
+export interface AnalyticsMembers {
+  computeCohort: "compute_cohort_analytics_sales_report_cohort_post";
+  explainCohort: "explain_cohort_analytics_sales_report_cohort_explain_post";
+  exportCohortCsv: "export_cohort_csv_analytics_sales_report_export_post";
+  getActivationFunnel: "get_activation_funnel_analytics_product_usage_activation_funnel_get";
+  getActiveUsers: "get_active_users_analytics_product_usage_active_users_get";
+  getAnalyticsDataSources: "get_analytics_data_sources_analytics_data_sources_get";
+  getAudienceByIndustry: "get_audience_by_industry_analytics_outbound_audience_industry_get";
+  getAudienceByIndustryGroup: "get_audience_by_industry_group_analytics_outbound_audience_industry_group_get";
+  getAudienceBySeniority: "get_audience_by_seniority_analytics_outbound_audience_seniority_get";
+  getCallMetrics: "get_call_metrics_analytics_outbound_call_metrics_get";
+  getCallTrend: "get_call_trend_analytics_outbound_call_metrics_trend_get";
+  getCampaignDashboard: "get_campaign_dashboard_analytics_outbound_dashboards_campaign_get";
+  getCampaignVisitors: "get_campaign_visitors_analytics_campaign_visitors_get";
+  getChannelAttribution: "get_channel_attribution_analytics_outbound_channel_attribution_get";
+  getDataQuality: "get_data_quality_analytics_sales_report_data_quality_get";
+  getDunning: "get_dunning_analytics_subscriptions_dunning_get";
+  getEmailBySequence: "get_email_by_sequence_analytics_outbound_email_metrics_by_sequence_get";
+  getEmailByStep: "get_email_by_step_analytics_outbound_email_metrics_by_step_get";
+  getEmailMetrics: "get_email_metrics_analytics_outbound_email_metrics_get";
+  getEmailTrend: "get_email_trend_analytics_outbound_email_metrics_trend_get";
+  getExecutiveDashboard: "get_executive_dashboard_analytics_outbound_dashboards_executive_get";
+  getFeatureAdoption: "get_feature_adoption_analytics_product_usage_feature_adoption_get";
+  getFilterOptions: "get_filter_options_analytics_sales_report_filter_options_get";
+  getLaunchpadActivityProfile: "get_launchpad_activity_profile_analytics_launchpad_activity_profile_get";
+  getLaunchpadBriefing: "get_launchpad_briefing_analytics_launchpad_briefing_get";
+  getLaunchpadCalendarToday: "get_launchpad_calendar_today_analytics_launchpad_calendar_today_get";
+  getLaunchpadHomeFeed: "get_launchpad_home_feed_analytics_launchpad_home_feed_get";
+  getLaunchpadSmartCards: "get_launchpad_smart_cards_analytics_launchpad_smart_cards_get";
+  getManagerDashboard: "get_manager_dashboard_analytics_outbound_dashboards_manager_get";
+  getMeetingByChannel: "get_meeting_by_channel_analytics_outbound_meeting_metrics_by_channel_get";
+  getMeetingFunnel: "get_meeting_funnel_analytics_outbound_meeting_funnel_get";
+  getMeetingMetrics: "get_meeting_metrics_analytics_outbound_meeting_metrics_get";
+  getMeetingTrend: "get_meeting_trend_analytics_outbound_meeting_metrics_trend_get";
+  getMovement: "get_movement_analytics_subscriptions_movement_get";
+  getMrr: "get_mrr_analytics_subscriptions_mrr_get";
+  getMySdrDashboard: "get_my_sdr_dashboard_analytics_outbound_dashboards_sdr_get";
+  getOutboundSummary: "get_outbound_summary_analytics_outbound_summary_get";
+  getPlanDistribution: "get_plan_distribution_analytics_subscriptions_plan_distribution_get";
+  getRetention: "get_retention_analytics_subscriptions_retention_get";
+  getSdrActivity: "get_sdr_activity_analytics_outbound_sdr_activity_get";
+  getSdrActivityByEmail: "get_sdr_activity_by_email_analytics_outbound_sdr_activity__sdr_email__get";
+  getSdrDaily: "get_sdr_daily_analytics_outbound_sdr_activity_daily_get";
+  getSdrDashboardByEmail: "get_sdr_dashboard_by_email_analytics_outbound_dashboards_sdr__sdr_email__get";
+  getSdrLeaderboard: "get_sdr_leaderboard_analytics_outbound_sdr_activity_leaderboard_get";
+  getSequencePerformance: "get_sequence_performance_analytics_outbound_sequence_performance_get";
+  getSequencePerformanceById: "get_sequence_performance_by_id_analytics_outbound_sequence_performance__sequence_id__get";
+  getTeamComparison: "get_team_comparison_analytics_outbound_sdr_activity_team_comparison_get";
+  getTopPages: "get_top_pages_analytics_product_usage_top_pages_get";
+  getTrialConversion: "get_trial_conversion_analytics_subscriptions_trial_conversion_get";
+  getVoiceAiOutcomes: "get_voice_ai_outcomes_analytics_outbound_call_metrics_voice_ai_get";
+  postDataQuality: "post_data_quality_analytics_sales_report_data_quality_post";
+}
+
+/** Input and output of every `g8.api.analytics` operation, keyed by operationId. */
+export interface AnalyticsOperations {
+  /**
+   * POST /analytics/sales-report/cohort
+   * Compute Cohort
+   * tier: read · scope: analytics:read
+   */
+  compute_cohort_analytics_sales_report_cohort_post: {
+    input: {
+    query?: {
+      /** IANA timezone the local-day window bounds are computed in, e.g. `Asia/Tokyo`. Changes which deals fall inside the date range. */
+      tz?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: FilterQueryDto;
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * POST /analytics/sales-report/cohort/explain
+   * Explain Cohort
+   * tier: read · scope: analytics:read
+   */
+  explain_cohort_analytics_sales_report_cohort_explain_post: {
+    input: {
+    query?: {
+      /** IANA timezone the local-day window bounds are computed in, e.g. `Asia/Tokyo`. Changes which deals fall inside the date range. */
+      tz?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: FilterQueryDto;
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * POST /analytics/sales-report/export
+   * Export Cohort Csv
+   * tier: read · scope: analytics:read
+   */
+  export_cohort_csv_analytics_sales_report_export_post: {
+    input: {
+    query?: {
+      /** IANA timezone the local-day window bounds are computed in, e.g. `Asia/Tokyo`. Changes which deals fall inside the date range. */
+      tz?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ExportRequestDto;
+  };
+    output: void;
+  };
+  /**
+   * GET /analytics/product-usage/activation-funnel
+   * Get Activation Funnel
+   * tier: read · scope: analytics:read
+   */
+  get_activation_funnel_analytics_product_usage_activation_funnel_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/product-usage/active-users
+   * Get Active Users
+   * tier: read · scope: analytics:read
+   */
+  get_active_users_analytics_product_usage_active_users_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/data-sources
+   * Get Analytics Data Sources
+   * tier: read · scope: analytics:read
+   */
+  get_analytics_data_sources_analytics_data_sources_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/audience/industry
+   * Get Audience By Industry
+   * tier: read · scope: analytics:read
+   */
+  get_audience_by_industry_analytics_outbound_audience_industry_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/audience/industry-group
+   * Get Audience By Industry Group
+   * tier: read · scope: analytics:read
+   */
+  get_audience_by_industry_group_analytics_outbound_audience_industry_group_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/audience/seniority
+   * Get Audience By Seniority
+   * tier: read · scope: analytics:read
+   */
+  get_audience_by_seniority_analytics_outbound_audience_seniority_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/call-metrics
+   * Get Call Metrics
+   * tier: read · scope: analytics:read
+   */
+  get_call_metrics_analytics_outbound_call_metrics_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/call-metrics/trend
+   * Get Call Trend
+   * tier: read · scope: analytics:read
+   */
+  get_call_trend_analytics_outbound_call_metrics_trend_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/dashboards/campaign
+   * Get Campaign Dashboard
+   * tier: read · scope: analytics:read
+   */
+  get_campaign_dashboard_analytics_outbound_dashboards_campaign_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/campaign-visitors
+   * Get Campaign Visitors
+   * tier: read · scope: analytics:read
+   */
+  get_campaign_visitors_analytics_campaign_visitors_get: {
+    input: {
+    query?: {
+      /** Window start (inclusive), YYYY-MM-DD. If omitted, derived from `days`. */
+      start_date?: string | null;
+      /** Window end (inclusive), YYYY-MM-DD. If omitted, today. */
+      end_date?: string | null;
+      /** Rolling 'last N days from today'. Ignored when start_date/end_date are supplied. */
+      days?: number | null;
+      /** Row cap for the steps + contacts tables */
+      limit?: number;
+      /** Include the Top contacts table (contact name + email — PII). Set false to omit it entirely for a privacy-lean response. */
+      include_contacts?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CampaignVisitorsReport_;
+  };
+  /**
+   * GET /analytics/outbound/channel-attribution
+   * Get Channel Attribution
+   * tier: read · scope: analytics:read
+   */
+  get_channel_attribution_analytics_outbound_channel_attribution_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/sales-report/data-quality
+   * Get Data Quality
+   * tier: read · scope: analytics:read
+   */
+  get_data_quality_analytics_sales_report_data_quality_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/subscriptions/dunning
+   * Get Dunning
+   * tier: read · scope: analytics:read
+   */
+  get_dunning_analytics_subscriptions_dunning_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/email-metrics/by-sequence
+   * Get Email By Sequence
+   * tier: read · scope: analytics:read
+   */
+  get_email_by_sequence_analytics_outbound_email_metrics_by_sequence_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+      /** Sequences to return. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/email-metrics/by-step
+   * Get Email By Step
+   * tier: read · scope: analytics:read
+   */
+  get_email_by_step_analytics_outbound_email_metrics_by_step_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+      /** Narrow to one sequence. Omit for every sequence's steps folded together by step order. */
+      sequence_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/email-metrics
+   * Get Email Metrics
+   * tier: read · scope: analytics:read
+   */
+  get_email_metrics_analytics_outbound_email_metrics_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/email-metrics/trend
+   * Get Email Trend
+   * tier: read · scope: analytics:read
+   */
+  get_email_trend_analytics_outbound_email_metrics_trend_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/dashboards/executive
+   * Get Executive Dashboard
+   * tier: read · scope: analytics:read
+   */
+  get_executive_dashboard_analytics_outbound_dashboards_executive_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/product-usage/feature-adoption
+   * Get Feature Adoption
+   * tier: read · scope: analytics:read
+   */
+  get_feature_adoption_analytics_product_usage_feature_adoption_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/sales-report/filter-options
+   * Get Filter Options
+   * tier: read · scope: analytics:read
+   */
+  get_filter_options_analytics_sales_report_filter_options_get: {
+    input: {
+    query?: {
+      /** Start of the window to grade time-bucket granularities against. Must be sent WITH `to`. Omit both and the response is unchanged and carries no `granularity` block. */
+      from?: string | null;
+      /** End of that window. Must be sent WITH `from`. */
+      to?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/launchpad/activity-profile
+   * Get Launchpad Activity Profile
+   * tier: read · scope: analytics:read
+   */
+  get_launchpad_activity_profile_analytics_launchpad_activity_profile_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/launchpad/briefing
+   * Get Launchpad Briefing
+   * tier: read · scope: analytics:read
+   */
+  get_launchpad_briefing_analytics_launchpad_briefing_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/launchpad/calendar/today
+   * Get Launchpad Calendar Today
+   * tier: read · scope: analytics:read
+   */
+  get_launchpad_calendar_today_analytics_launchpad_calendar_today_get: {
+    input: {
+    query?: {
+      /** ISO date to read instead of today. */
+      date?: string | null;
+      /** IANA timezone the day boundaries are computed in. */
+      timezone?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/launchpad/home-feed
+   * Get Launchpad Home Feed
+   * tier: read · scope: analytics:read
+   */
+  get_launchpad_home_feed_analytics_launchpad_home_feed_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/launchpad/smart-cards
+   * Get Launchpad Smart Cards
+   * tier: read · scope: analytics:read
+   */
+  get_launchpad_smart_cards_analytics_launchpad_smart_cards_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/dashboards/manager
+   * Get Manager Dashboard
+   * tier: read · scope: analytics:read
+   */
+  get_manager_dashboard_analytics_outbound_dashboards_manager_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/meeting-metrics/by-channel
+   * Get Meeting By Channel
+   * tier: read · scope: analytics:read
+   */
+  get_meeting_by_channel_analytics_outbound_meeting_metrics_by_channel_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/meeting-funnel
+   * Get Meeting Funnel
+   * tier: read · scope: analytics:read
+   */
+  get_meeting_funnel_analytics_outbound_meeting_funnel_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/meeting-metrics
+   * Get Meeting Metrics
+   * tier: read · scope: analytics:read
+   */
+  get_meeting_metrics_analytics_outbound_meeting_metrics_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/meeting-metrics/trend
+   * Get Meeting Trend
+   * tier: read · scope: analytics:read
+   */
+  get_meeting_trend_analytics_outbound_meeting_metrics_trend_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/subscriptions/movement
+   * Get Movement
+   * tier: read · scope: analytics:read
+   */
+  get_movement_analytics_subscriptions_movement_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/subscriptions/mrr
+   * Get Mrr
+   * tier: read · scope: analytics:read
+   */
+  get_mrr_analytics_subscriptions_mrr_get: {
+    input: {
+    query?: {
+      /** Length of the trend series, in days. */
+      trailing_days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/dashboards/sdr
+   * Get My Sdr Dashboard
+   * tier: read · scope: analytics:read
+   */
+  get_my_sdr_dashboard_analytics_outbound_dashboards_sdr_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/summary
+   * Get Outbound Summary
+   * tier: read · scope: analytics:read
+   */
+  get_outbound_summary_analytics_outbound_summary_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/subscriptions/plan-distribution
+   * Get Plan Distribution
+   * tier: read · scope: analytics:read
+   */
+  get_plan_distribution_analytics_subscriptions_plan_distribution_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/subscriptions/retention
+   * Get Retention
+   * tier: read · scope: analytics:read
+   */
+  get_retention_analytics_subscriptions_retention_get: {
+    input: {
+    query?: {
+      /** Trailing window, in days. */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/sdr-activity
+   * Get Sdr Activity
+   * tier: read · scope: analytics:read
+   */
+  get_sdr_activity_analytics_outbound_sdr_activity_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/sdr-activity/{sdr_email}
+   * Get Sdr Activity By Email
+   * tier: read · scope: analytics:read
+   */
+  get_sdr_activity_by_email_analytics_outbound_sdr_activity__sdr_email__get: {
+    input: {
+    path: {
+      /** The rep's email address. */
+      sdr_email: string;
+    };
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/sdr-activity/daily
+   * Get Sdr Daily
+   * tier: read · scope: analytics:read
+   */
+  get_sdr_daily_analytics_outbound_sdr_activity_daily_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+      /** Narrow to one rep. Omit for the whole team. */
+      sdr_email?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/dashboards/sdr/{sdr_email}
+   * Get Sdr Dashboard By Email
+   * tier: read · scope: analytics:read
+   */
+  get_sdr_dashboard_by_email_analytics_outbound_dashboards_sdr__sdr_email__get: {
+    input: {
+    path: {
+      /** The rep's email address. */
+      sdr_email: string;
+    };
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/sdr-activity/leaderboard
+   * Get Sdr Leaderboard
+   * tier: read · scope: analytics:read
+   */
+  get_sdr_leaderboard_analytics_outbound_sdr_activity_leaderboard_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+      /** Reps to return. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/sequence-performance
+   * Get Sequence Performance
+   * tier: read · scope: analytics:read
+   */
+  get_sequence_performance_analytics_outbound_sequence_performance_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+      /** Sequences to return. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/sequence-performance/{sequence_id}
+   * Get Sequence Performance By Id
+   * tier: read · scope: analytics:read
+   */
+  get_sequence_performance_by_id_analytics_outbound_sequence_performance__sequence_id__get: {
+    input: {
+    path: {
+      /** Sequence id. */
+      sequence_id: string;
+    };
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/sdr-activity/team-comparison
+   * Get Team Comparison
+   * tier: read · scope: analytics:read
+   */
+  get_team_comparison_analytics_outbound_sdr_activity_team_comparison_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/product-usage/top-pages
+   * Get Top Pages
+   * tier: read · scope: analytics:read
+   */
+  get_top_pages_analytics_product_usage_top_pages_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+      /** Rows per list. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/subscriptions/trial-conversion
+   * Get Trial Conversion
+   * tier: read · scope: analytics:read
+   */
+  get_trial_conversion_analytics_subscriptions_trial_conversion_get: {
+    input: {
+    query?: {
+      /** Trailing window, in days. */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * GET /analytics/outbound/call-metrics/voice-ai
+   * Get Voice Ai Outcomes
+   * tier: read · scope: analytics:read
+   */
+  get_voice_ai_outcomes_analytics_outbound_call_metrics_voice_ai_get: {
+    input: {
+    query?: {
+      /** Size of the trailing window, in days, ending today (UTC). */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+  /**
+   * POST /analytics/sales-report/data-quality
+   * Post Data Quality
+   * tier: read · scope: analytics:read
+   */
+  post_data_quality_analytics_sales_report_data_quality_post: {
+    input: {
+    query?: {
+      /** IANA timezone the local-day window bounds are computed in, e.g. `Asia/Tokyo`. Changes which deals fall inside the date range. */
+      tz?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: FilterQueryDto;
+  };
+    output: ApiResponse_ReportPayload_;
+  };
+}
+
+// 19 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_CampaignVisitorsReport_ {
+  data: CampaignVisitorsReport;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_ReportPayload_ {
+  data: ReportPayload;
+  pagination?: PaginationMeta | null;
+}
+
+/**
+ * One row of the Top contacts table.
+ *
+ * Carries PII (``name`` / ``email``) for the org's own contacts. Omitted
+ * entirely from the response when the request passes ``include_contacts=false``.
+ */
+export interface CampaignVisitorContact {
+  /** Per-org contact id */
+  contact_id: number;
+  /** Contact work email when resolvable (PII) */
+  email?: string | null;
+  /** Most recent path this contact clicked to */
+  last_path?: string | null;
+  /** Latest click timestamp (ISO) */
+  last_seen?: string | null;
+  /** Contact full name when resolvable (PII) */
+  name?: string | null;
+  /** Sequencer step the click was attributed to */
+  step_id?: string | null;
+  /** Human-readable step label when resolvable */
+  step_label?: string | null;
+  /** Click events by this contact in the window */
+  visits: number;
+}
+
+/** One row of the Email Link Engagement table (a clicked destination URL). */
+export interface CampaignVisitorLink {
+  /** events ÷ emails_with_link × 100, clamped [0,100]; null when no denominator */
+  ctr_percent?: number | null;
+  /** Sends whose template embedded this URL (CTR denominator) */
+  emails_with_link?: number | null;
+  /** Human click events on this URL (scanner-filtered) */
+  events: number;
+  /** Clicked destination host */
+  host: string;
+  /** Latest click timestamp (ISO) */
+  last_seen?: string | null;
+  /** Clicked destination path */
+  path: string;
+  /** Sequencer steps whose links drove these clicks */
+  step_ids?: Array<string>;
+  /** Human-readable labels for step_ids when resolvable */
+  step_labels?: Array<string> | null;
+  /** Distinct contacts who clicked this URL */
+  unique_contacts: number;
+}
+
+/** One row of the Top campaign steps table. */
+export interface CampaignVisitorStep {
+  /** EMAIL sends dispatched from this step in the window */
+  emails_sent?: number | null;
+  /** Of those sends, how many carried a link */
+  emails_with_link?: number | null;
+  /** Campaign click events attributed to this step */
+  events: number;
+  /** Earliest click timestamp (ISO) */
+  first_seen?: string | null;
+  /** Latest click timestamp (ISO) */
+  last_seen?: string | null;
+  /** Sequencer step id (globally-unique CUID) */
+  step_id: string;
+  /** Human-readable '{sequence} / Step {n}' when resolvable */
+  step_label?: string | null;
+  /** Distinct contacts who clicked from this step */
+  unique_contacts: number;
+}
+
+/** Composite Campaign Visitors report for a single org (analytics report a23). */
+export interface CampaignVisitorsReport {
+  link_engagement: Array<CampaignVisitorLink>;
+  summary: CampaignVisitorsSummary;
+  top_campaign_steps: Array<CampaignVisitorStep>;
+  top_contacts: Array<CampaignVisitorContact>;
+  window: CampaignVisitorsWindow;
+}
+
+/**
+ * KPI tiles for the org's campaign-click activity in the window.
+ *
+ * All click-derived counters are email-security-scanner filtered (humans only)
+ * when ``SEQUENCER_VISITOR_SCANNER_FILTER=enforce`` — the same honest counts the
+ * in-app report shows. ``total_page_events`` is all page volume (not filtered).
+ */
+export interface CampaignVisitorsSummary {
+  /** Total (contact, step) click groups before the `limit` cap */
+  contact_rows: number;
+  /** Diagnostic: campaign clicks with an encrypted (#c=e1.) hash */
+  encrypted_pageviews: number;
+  /** Distinct identified web sessions on campaign clicks */
+  identified_visitors: number;
+  /** False when the org has no visitor-tracking pipeline / no page events */
+  jitsu_wired: boolean;
+  /** Total distinct clicked (host, path) before the ceiling */
+  link_rows: number;
+  /** Parseable campaign-attributed click events */
+  pageview_events: number;
+  /** Diagnostic: campaign clicks with a plaintext hash */
+  plaintext_pageviews: number;
+  /** Total distinct campaign steps before the `limit` cap */
+  step_rows: number;
+  /** All page events in the window (campaign + non-campaign) */
+  total_page_events: number;
+  /** Distinct sequencer steps that drew clicks */
+  unique_campaign_steps: number;
+  /** Distinct contacts who clicked a campaign link */
+  unique_contacts: number;
+  /** Campaign clicks whose tracking hash could not be decoded */
+  unparseable_pageviews: number;
+}
+
+/** The resolved reporting window echoed back to the caller. */
+export interface CampaignVisitorsWindow {
+  /** Inclusive calendar-day span of the window */
+  days: number;
+  /** Window end (inclusive), YYYY-MM-DD */
+  end_date: string;
+  /** 'anchored' (explicit start/end) or 'rolling' (last-N-days) */
+  mode: string;
+  /** Window start (inclusive), YYYY-MM-DD */
+  start_date: string;
+}
+
+export interface DateRangeDto {
+  from: string;
+  to: string;
+}
+
+/**
+ * Export body — the cohort filter plus the section selector.
+ *
+ * The FE sends ``section`` in the JSON body alongside the filter (see
+ * ``sales-report.service.ts``). Absent / unknown values fall back to the
+ * persons drill-down CSV, so older clients keep working unchanged.
+ *
+ * Inherits every AC-3 filter cap from ``FilterQueryDto``, including the
+ * cross-group ``_bound_total_filter_values`` validator — the export streams
+ * the SAME cohort the screen shows, so an uncapped ``/export`` would be a
+ * download-shaped bypass of the cap ``/cohort`` applies.
+ */
+export interface ExportRequestDto {
+  audiences?: IntIdFilterGroupDto | null;
+  campaign?: FilterGroupDto | null;
+  channel?: FilterGroupDto | null;
+  country?: FilterGroupDto | null;
+  date: DateRangeDto;
+  grading_bucket?: GradingBucketFilterGroupDto | null;
+  granularity?: ("day" | "week" | "month") | null;
+  headcount?: HeadcountFilterGroupDto | null;
+  industry?: FilterGroupDto | null;
+  lifecycle?: FilterGroupDto | null;
+  objections?: ObjectionCodeFilterGroupDto | null;
+  pipeline?: UuidFilterGroupDto | null;
+  pipeline_target?: ("prospects_meeting" | "prospects_revenue" | "customers_revenue") | null;
+  rec_type?: IntIdFilterGroupDto | null;
+  rep?: FilterGroupDto | null;
+  section?: string | null;
+  signals_calendar?: FilterGroupDto | null;
+  signals_chat?: FilterGroupDto | null;
+  signals_crm?: FilterGroupDto | null;
+  signals_email?: FilterGroupDto | null;
+  signals_enrichment?: FilterGroupDto | null;
+  signals_forms?: FilterGroupDto | null;
+  signals_intent?: FilterGroupDto | null;
+  signals_linkedin?: FilterGroupDto | null;
+  signals_sequence?: FilterGroupDto | null;
+  signals_sms?: FilterGroupDto | null;
+  signals_voice?: FilterGroupDto | null;
+  signals_website?: FilterGroupDto | null;
+  stage?: UuidFilterGroupDto | null;
+  tier?: FilterGroupDto | null;
+}
+
+/**
+ * One filter group — list of values + optional NOT toggle.
+ *
+ * ``in_`` is capped at ``MAX_FILTER_VALUES_PER_GROUP`` items of
+ * ``MAX_FILTER_VALUE_LENGTH`` characters each. Over-cap input raises during
+ * body parsing, so FastAPI answers 422 with the offending group named in
+ * ``detail[].loc`` (``["body", "<group>", "in"]``) and the cap in
+ * ``detail[].msg`` — no handler code, and therefore no SQL, runs.
+ *
+ * THIS SHAPE DOES NOT NEST. ``in_`` holds scalars and there is no
+ * group-of-groups member, so a caller cannot vary the tree depth: it is fixed
+ * at 2 (query -> group -> values) by construction, and ``extra="forbid"`` on
+ * both models keeps it that way. A depth check here would be validation that
+ * can never fire. Add one WITH the member that introduces nesting, not before
+ * it.
+ *
+ * Do not confuse this with ``SegmentFilterGroup``
+ * (``contacts/domain/value_objects/ag_grid_models.py:111``), which IS
+ * recursive and is where AC-3's "tree depth" belongs. Different model,
+ * different route, still unbounded — see the scope note above the constants.
+ */
+export interface FilterGroupDto {
+  in?: Array<string>;
+  not?: boolean;
+}
+
+/**
+ * JSON shape consumed by POST /api/sales-report/cohort.
+ *
+ * Empty groups are omitted by callers; absent groups treated as empty.
+ */
+export interface FilterQueryDto {
+  audiences?: IntIdFilterGroupDto | null;
+  campaign?: FilterGroupDto | null;
+  channel?: FilterGroupDto | null;
+  country?: FilterGroupDto | null;
+  date: DateRangeDto;
+  grading_bucket?: GradingBucketFilterGroupDto | null;
+  granularity?: ("day" | "week" | "month") | null;
+  headcount?: HeadcountFilterGroupDto | null;
+  industry?: FilterGroupDto | null;
+  lifecycle?: FilterGroupDto | null;
+  objections?: ObjectionCodeFilterGroupDto | null;
+  pipeline?: UuidFilterGroupDto | null;
+  pipeline_target?: ("prospects_meeting" | "prospects_revenue" | "customers_revenue") | null;
+  rec_type?: IntIdFilterGroupDto | null;
+  rep?: FilterGroupDto | null;
+  signals_calendar?: FilterGroupDto | null;
+  signals_chat?: FilterGroupDto | null;
+  signals_crm?: FilterGroupDto | null;
+  signals_email?: FilterGroupDto | null;
+  signals_enrichment?: FilterGroupDto | null;
+  signals_forms?: FilterGroupDto | null;
+  signals_intent?: FilterGroupDto | null;
+  signals_linkedin?: FilterGroupDto | null;
+  signals_sequence?: FilterGroupDto | null;
+  signals_sms?: FilterGroupDto | null;
+  signals_voice?: FilterGroupDto | null;
+  signals_website?: FilterGroupDto | null;
+  stage?: UuidFilterGroupDto | null;
+  tier?: FilterGroupDto | null;
+}
+
+/**
+ * `grading_bucket` — a CLOSED vocabulary (`GRADING_BUCKETS`). An unknown
+ * bucket produces no band clause and widens to the full book.
+ */
+export interface GradingBucketFilterGroupDto {
+  in?: Array<"high" | "med" | "low">;
+  not?: boolean;
+}
+
+/**
+ * `headcount` — a CLOSED vocabulary (`HEADCOUNT_BANDS`), and the exact list
+ * `/filter-options` hands the client.
+ */
+export interface HeadcountFilterGroupDto {
+  in?: Array<"1-10" | "11-50" | "51-200" | "201-1000" | "1001+">;
+  not?: boolean;
+}
+
+/**
+ * `rec_type` / `audiences` — `Lead.rec_type` is `SmallInteger` and
+ * `audience_id` is `Integer`; both appliers coerce and skip what will not
+ * parse.
+ */
+export interface IntIdFilterGroupDto {
+  in?: Array<string>;
+  not?: boolean;
+}
+
+/**
+ * `objections` — codes live in the PER-ORG `cb_objection_codes` catalog, so
+ * only the SHAPE can be checked here. Blank is the one thing the applier
+ * provably cannot use.
+ */
+export interface ObjectionCodeFilterGroupDto {
+  in?: Array<string>;
+  not?: boolean;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+/**
+ * An OPEN envelope around one report's answer.
+ *
+ * The app wraps every one of these reports in `{success, data, meta}`, where
+ * `meta` carries the cache state, the window and - on the agency reports -
+ * `failed_org_ids`, the orgs that contributed NOTHING to the totals above.
+ * That field is the difference between "this client sent no email" and "we
+ * could not query this client", so it is forwarded rather than flattened
+ * away.
+ *
+ * Open on purpose: `data` is `dict | list` in the app and its contents grow
+ * with the product. A closed model would turn every new metric into a
+ * silently dropped one.
+ */
+export type ReportPayload = Record<string, unknown>;
+
+/**
+ * `pipeline` / `stage` — `CBDeal.pipeline_id` and `.stage_id` are real
+ * `PostgresUUID` columns, so a non-UUID can only ever fail open.
+ */
+export interface UuidFilterGroupDto {
+  in?: Array<string>;
+  not?: boolean;
+}