Tool Catalog

{
  products: Array<{
    product_id: number
    name: string
    description: string
    is_active: boolean
    keywords: Array<{ keyword_id, name, auto_extracted }>
    sources: Array<{ source_id, url, title, source_type }>
    industries: Array<{ industry_name, industry_description, industry_code }>
    segment_targeting: "all" | "selected"
    target_segments: Array<{
      insurance_entity_type: "carrier" | "reinsurer" | "agency" | "mga"
        | "brokerage" | "unclassified_intermediary" | "unknown"
      company_ownership: "public" | "private" | "any"
      carrier_facts: {
        lines_of_business: Array<{ line_of_business, premium_min,
                                   premium_max, unknown_premium }>
        licensed_footprint: { min, max } | null
        include_unknown: boolean
      } | null
    }>
  }>
}

{
  product: { ...same shape as one element of list_products }
}

{
  prospects: Array<{
    ticker, company_name,
    assessment_status: "assessed" | "pending_score" | "unassessed",
    deal_score,           // null unless assessed
    buying_signal_score,  // null unless assessed
    rank, rank_total,
    entity_count,         // companies in this corporate family
    matched_entity_count, // how many of them matched your filters
    insurance_entity_types,  // key omitted when unclassified
    ownership, lines_of_business,
    licensed_states, licensed_state_count,
    premium: { currency, report_years, total_all_lines_usd,
               by_line_of_business, contributing_entity_count } | null,
    complaints: { report_years, total_complaints,
                  complaint_index, complaint_index_status } | null,
    children: [...]       // only when include_children=true
  }>
  total_groups: number             // corporate families in the filtered universe
  total_entities: number           // companies inside them
  excluded_no_data_groups: number  // dropped for lacking the data a filter required
  limit: number
  offset: number
}

{
  ticker, company_name,
  assessment_status, deal_score, rank, rank_total,
  company_info: { public_or_private, family_public_or_private,
                  sic_codes, insurance_entity_types,
                  primary_naic_cocode, all_naic_cocodes,
                  licensed_states, insurance_types,
                  website, primary_domain },
  premium: { currency, report_years, total_all_lines_usd, by_line_of_business,
             observations: Array<{ report_year, line_of_business,
                                   annual_premium_usd }> } | null,
  complaints: { cocode, available_years,
                observations: Array<{ report_year, line_of_business,
                                      total_complaints, complaint_index,
                                      complaint_index_status }> } | null,
  hierarchy: { prospect_kind, child_count, eligible_child_count,
               coverage_ratio,
               group: { ticker, company_name, is_self },
               children: Array<{ ticker, company_name,
                                 deal_score, has_assessment }> } | null,
  narrative_scope: "company" | "group",
  findings_summary, recommendation_summary,
  key_opportunity, primary_challenge,
  impact_score_distribution,
  findings: Array<{ finding_id, text, evidence_excerpt_ids }>,
  excerpt_count: number,
  excerpts: Array<{ excerpt_id, text, impact_score, source,
                    pain_points, sales_summary, buying_signal_present }>
}

{
  excerpts: Array<{ excerpt_id, text, impact_score, source,
                    pain_points, sales_summary, buying_signal_present }>
  total_count: number
  limit: number
  offset: number
}

{
  status: "empty" | "ready" | "stale"
  chart: { id, generated_at, expires_at, company_name, node_count, relevant_node_count } | null
  stakeholders: Array<{
    node_id, full_name, title, level, level_label,
    linkedin_url, work_email, manager_name,
    stakeholder_role, stakeholder_role_source,
    annotation_score, annotation_reason,
    is_top_pick, top_pick_source
  }>
  edges: Array<{ from_node_id, to_node_id, relationship }>
  buying_committee_summary: {
    economic_buyer, decision_maker, champion,
    executive_sponsor, evaluator, blockers: [...]
  }
}

{
  status: "ready"
  chart: { id, generated_at, expires_at, company_name, node_count, relevant_node_count }
  stakeholders: Array<{ node_id, full_name, title, level, stakeholder_role, is_top_pick, ... }>
  edges: Array<{ from_node_id, to_node_id, relationship }>
  buying_committee_summary: { economic_buyer, decision_maker, champion, ... }
  generation_source: "org_fresh" | "org_cached" | "annotation_only"
  credits_charged: boolean
}

{
  success: true
  node_id: string
  stakeholder_role: string
}

{
  success: true
  node_id: string
  is_top_pick: boolean
}

{
  subject?: string   // Only for email platform
  body: string
  platform: string
  tone: string
  length: string
  used_excerpt_ids: number[]
  selected_lead?: { full_name, title, level }
  selected_lead_note?: string
}