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"
                     | "unavailable",   // analysis not available in the current results
    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,            // all lines
                  complaint_index_status,
                  by_line_of_business: { [line]: { report_year, total_complaints,
                    complaint_index, complaint_index_status,
                    contributing_entity_count, low_sample } } } | 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
  publication?: {                  // only for products on published generations; whole-result-set signals
    generation_id,                 // paging token: echo back on later pages
    state, update_in_progress, latest_update_failed, previous_settings,
    warnings: Array<{ code, message }>
  }
}

{
  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,           // null with scope "family"
                scope?: "family",  // parents with no cocode of their own
                available_years,
                observations: Array<{ report_year, line_of_business,
                                      total_complaints, complaint_index,
                                      complaint_index_status, low_sample }>,
                by_entity?: Array<{ cocode, legal_name, observations }> } | 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 }>,
  publication?: { generation_id }  // only for products on published generations
}

{
  excerpts: Array<{ excerpt_id, text, impact_score, source,
                    pain_points, sales_summary, buying_signal_present }>
  total_count: number
  limit: number
  offset: number
  publication?: { generation_id }  // only for products on published generations
}

{
  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_fresh_empty" | "org_cache" | "annotated_cache_hit"
  credits_charged: boolean
}

{
  success: true
  node_id: string
  stakeholder_role: string
}

{
  success: true
  node_id: string
  is_top_pick: boolean
}

{
  system_template: { template_key, name, kind, credit_cost, version, is_default }
  effective_default_key: string
  templates: Array<{ template_key, name, kind, credit_cost, description, version, is_default, requires_lead }>
  pagination: { offset, limit, total, has_more }
}

{
  subject?: string
  body: string
  platform: string
  used_excerpt_ids: number[]
  selected_lead?: { full_name, title, level }
  selected_lead_note?: string
  template_used: { template_key, name, kind, version, source, resolution }
  publication?: { generation_id }  // only for products on published generations
}