@oxygen-agent/cli 1.987.20 → 1.1010.1

package/node_modules/@oxygen/shared/dist/enrichment-intents.js

@@ -0,0 +1,809 @@
+// The ENRICHMENT INTENT TAXONOMY: every data type a customer can ask OXYGEN to
+// fill (person profile, work email, phone, headcount, funding round, tech
+// stack, decision makers, signals ...), as one ranked, client-safe list with
+// customer-facing labels, the identity inputs each needs, the typed output
+// fields it fills, which product surface materialises it, and an honest
+// status (default | selectable | no_default | coming_soon | rejected).
+//
+// Why this exists (founder, 2026-09-19): the tool catalog exposes ~1,700
+// provider operations, and neither the Workspace Copilot nor an external agent
+// can pick the right one for "get me the funding round". The catalogue lets a
+// customer name the DATA; the routing registry (packages/tools/src/routing-
+// registry) names the provider chain. This leaf is the customer-facing half
+// and carries NO provider names in labels or descriptions and NO prices —
+// provider order and prices are projected server-side from the registry and
+// the pricing resolver (apps/web/src/lib/enrichment-column-catalog.ts).
+//
+// Vendor cost structure (flat fee, unlimited, zero marginal cost) is internal
+// margin information and must never appear in any string here
+// (OXYGEN_PRODUCT.md, 2026-08-10); enrichment-intents.test.ts lints for it.
+//
+// CLIENT-SAFE LEAF: exported as the `@oxygen/shared/enrichment-intents`
+// subpath, read by browser components and by @oxygen/tools (the registry
+// binds `catalog.taxonomy_id` to these ids). It must never gain a runtime
+// import; enrichment-intents.test.ts guards it.
+export const ENRICHMENT_INTENT_GROUPS = ["person", "contact", "company", "decision_maker", "signal"];
+export const ENRICHMENT_INTENT_GROUP_LABELS = {
+    person: "Person",
+    contact: "Contact",
+    company: "Company",
+    decision_maker: "Decision makers",
+    signal: "Signals",
+};
+const f = (key, label, semanticType, dataType = "text", derived) => ({ key, label, semanticType, dataType, ...(derived ? { derived: true } : {}) });
+export const ENRICHMENT_INTENT_TAXONOMY = [
+    // ── Person ────────────────────────────────────────────────────────────────
+    {
+        id: "enrich_person_profile",
+        label: "Person profile",
+        description: "Fills a person's name, title, company, headline, location, bio, career history, education and skills from their LinkedIn profile.",
+        entity: "person",
+        group: "person",
+        kind: "profile",
+        rank: 10,
+        aliases: ["person profile", "enrich person", "enrich people", "linkedin profile data", "job title", "seniority", "current company", "work history", "person location"],
+        inputShapes: ["linkedin_url"],
+        outputFields: [
+            f("full_name", "Full name", "person.full_name"),
+            f("first_name", "First name", "person.first_name"),
+            f("last_name", "Last name", "person.last_name"),
+            f("job_title", "Job title", "person.job_title"),
+            f("headline", "Headline", "person.headline"),
+            f("current_company", "Current company", null),
+            f("current_company_linkedin_url", "Current company LinkedIn URL", "company.linkedin_url"),
+            f("job_start_date", "Job start date", null),
+            f("location", "Location", "person.location"),
+            f("bio", "Bio", "person.bio"),
+            f("linkedin_followers", "LinkedIn followers", "person.linkedin_followers", "numeric"),
+            f("education", "Education", null, "jsonb"),
+            f("school_name", "School", null),
+        ],
+        surfaces: { preset: "person_enrich", find: "find person", managedFunction: "enrich_person", catalogEntry: "preset:person_enrich", registryFunction: "enrichment", registryIntent: "enrich_person_profile" },
+        status: "default",
+        decision: "D47",
+    },
+    {
+        id: "find_linkedin_profile",
+        label: "LinkedIn profile URL",
+        description: "Resolves a person's LinkedIn profile from first/last name + company domain (or name), with identity validation on every hit.",
+        entity: "person",
+        group: "person",
+        kind: "enrichment",
+        rank: 20,
+        aliases: ["linkedin url", "linkedin urls", "find linkedin", "profile url", "resolve linkedin", "linkedin for each"],
+        inputShapes: ["name_company"],
+        outputFields: [
+            f("linkedin_url", "LinkedIn URL", "person.linkedin_url"),
+            f("linkedin_url_confidence", "Match confidence", null),
+        ],
+        surfaces: { capability: "linkedin_url", find: "find linkedin", managedFunction: "person_linkedin_url", catalogEntry: "capability:linkedin_url", registryFunction: "enrichment", registryIntent: "find_linkedin_profile" },
+        status: "default",
+        decision: "D46",
+    },
+    {
+        id: "person_company",
+        label: "Person's company",
+        description: "Adds the person's current company, then fills that company's domain, industry and headcount from the same profile.",
+        entity: "person",
+        group: "person",
+        kind: "template",
+        rank: 30,
+        aliases: ["person's company", "company of this person", "employer"],
+        inputShapes: ["linkedin_url"],
+        outputFields: [
+            f("current_company_linkedin_url", "Company LinkedIn URL", "company.linkedin_url"),
+            f("company_domain", "Company domain", "company.domain"),
+            f("company_industry", "Industry", "company.industry"),
+            f("company_headcount", "Headcount", "company.employee_count", "numeric"),
+        ],
+        surfaces: { catalogEntry: "recipe:person_company" },
+        status: "default",
+    },
+    // ── Contact ───────────────────────────────────────────────────────────────
+    {
+        id: "find_work_email",
+        label: "Work email",
+        description: "Finds a verified work email through a cost-ordered waterfall that bills only when an address is found.",
+        entity: "person",
+        group: "contact",
+        kind: "enrichment",
+        rank: 40,
+        aliases: ["work email", "business email", "email address", "find email", "emails for", "email finder", "with emails"],
+        inputShapes: ["linkedin_url", "name_domain", "first_last_domain"],
+        outputFields: [
+            f("email", "Work email", "person.work_email"),
+            f("email_status", "Deliverability", "person.email_status"),
+        ],
+        surfaces: { capability: "work_email", find: "find email", managedFunction: "work_email", catalogEntry: "capability:work_email", registryFunction: "enrichment", registryIntent: "find_work_email" },
+        status: "default",
+    },
+    {
+        id: "find_personal_email",
+        label: "Personal email",
+        description: "Finds a personal (non-work) email from a LinkedIn profile, billed only on a hit and graded before it lands.",
+        entity: "person",
+        group: "contact",
+        kind: "enrichment",
+        rank: 50,
+        aliases: ["personal email", "gmail", "home email", "private email", "consumer email"],
+        inputShapes: ["linkedin_url"],
+        outputFields: [f("personal_email", "Personal email", "person.personal_email")],
+        surfaces: { capability: "personal_email", find: "find personal-email", managedFunction: "personal_email", catalogEntry: "capability:personal_email", registryFunction: "enrichment", registryIntent: "find_personal_email" },
+        status: "default",
+        decision: "D43",
+    },
+    {
+        id: "find_phone",
+        label: "Phone",
+        description: "Finds a mobile or direct-dial number through a short cheapest-first waterfall that bills only on a hit, with optional line-type verification.",
+        entity: "person",
+        group: "contact",
+        kind: "enrichment",
+        rank: 60,
+        aliases: ["mobile number", "mobile phone", "cell phone", "direct dial", "work phone", "phone number", "phone numbers", "this person's mobile", "find phone", "find mobile", "a mobile"],
+        inputShapes: ["linkedin_url", "email", "name_domain"],
+        outputFields: [
+            f("mobile_phone", "Mobile phone", "person.mobile_phone"),
+            f("work_phone", "Work / direct-dial phone", "person.phone"),
+            f("phone_line_type", "Line type", null),
+            f("phone_carrier", "Carrier", null),
+        ],
+        surfaces: { capability: "mobile_phone", find: "find phone", managedFunction: "mobile_phone", catalogEntry: "capability:mobile_phone", registryFunction: "enrichment", registryIntent: "find_mobile_phone" },
+        status: "default",
+        decision: "D44",
+    },
+    {
+        id: "verify_email",
+        label: "Email verification",
+        description: "Grades addresses you already have as valid, invalid, catch-all or unknown; catch-all domains escalate once to a second verifier.",
+        entity: "person",
+        group: "contact",
+        kind: "verification",
+        rank: 70,
+        aliases: ["verify email", "verify these emails", "validate email", "email verification", "deliverability", "bounce check", "catch-all"],
+        inputShapes: ["email"],
+        outputFields: [f("email_verdict", "Verdict", "person.email_status")],
+        surfaces: { capability: "verify_email", find: "verify email", catalogEntry: "capability:verify_email", registryFunction: "enrichment", registryIntent: "verify_email" },
+        status: "default",
+        decision: "D45",
+    },
+    {
+        id: "verify_phone",
+        label: "Phone verification",
+        description: "Checks line type, carrier and reachability of numbers you already hold.",
+        entity: "person",
+        group: "contact",
+        kind: "verification",
+        rank: 80,
+        aliases: ["verify phone", "verify these phone numbers", "validate phone", "line type", "is this a mobile"],
+        inputShapes: ["phone"],
+        outputFields: [
+            f("phone_line_type", "Line type", null),
+            f("phone_carrier", "Carrier", null),
+            f("phone_verdict", "Verdict", null),
+        ],
+        surfaces: { registryFunction: "enrichment", registryIntent: "verify_phone" },
+        status: "selectable",
+        statusReason: "Runs today as the optional verification step of the Phone column; a standalone phone-verification column is a follow-up.",
+    },
+    // ── Company ───────────────────────────────────────────────────────────────
+    {
+        id: "enrich_company:identity",
+        label: "Company identity",
+        description: "Resolves a company's website domain and LinkedIn page from whichever one you have, or from the name.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 100,
+        aliases: ["company domain", "company website", "website domain", "company linkedin page", "resolve domain", "company url"],
+        inputShapes: ["name", "domain", "linkedin_url"],
+        outputFields: [f("company_domain", "Domain", "company.domain"), f("company_linkedin_url", "LinkedIn URL", "company.linkedin_url")],
+        surfaces: { preset: "company_enrich", companyFields: ["domain", "linkedin_url"], find: "find company", managedFunction: "company_domain", catalogEntry: "preset:company_enrich", registryFunction: "enrichment", registryIntent: "enrich_company", registryInputShapes: ["field:domain", "field:linkedin_url"] },
+        status: "default",
+        decision: "D48",
+    },
+    {
+        id: "enrich_company:headcount",
+        label: "Headcount",
+        description: "Current employee count and size band.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 110,
+        aliases: ["headcount", "employee count", "how many employees", "company size", "employees"],
+        inputShapes: ["domain", "linkedin_url"],
+        outputFields: [f("company_headcount", "Headcount", "company.employee_count", "numeric"), f("company_employee_range", "Size band", "company.employee_range", "text", true)],
+        surfaces: { preset: "company_enrich", companyFields: ["headcount"], managedFunction: "company_employee_count", catalogEntry: "preset:company_enrich", registryFunction: "enrichment", registryIntent: "enrich_company", registryInputShapes: ["field:headcount"] },
+        status: "default",
+        decision: "D48",
+    },
+    {
+        id: "enrich_company:industry",
+        label: "Industry",
+        description: "The company's industry classification.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 120,
+        aliases: ["company industry", "which industry", "sector", "what industry"],
+        inputShapes: ["domain", "linkedin_url"],
+        outputFields: [f("company_industry", "Industry", "company.industry")],
+        surfaces: { preset: "company_enrich", companyFields: ["industry"], managedFunction: "company_industry", catalogEntry: "preset:company_enrich", registryFunction: "enrichment", registryIntent: "enrich_company", registryInputShapes: ["field:industry"] },
+        status: "default",
+        decision: "D48",
+    },
+    {
+        id: "enrich_company:company_profile",
+        label: "Company profile",
+        description: "Description, founded year, headquarters, company type, specialties, size band and logo from one profile lookup.",
+        entity: "company",
+        group: "company",
+        kind: "profile",
+        rank: 130,
+        aliases: ["company profile", "company description", "founded year", "headquarters", "company type", "specialties", "company logo", "firmographics"],
+        inputShapes: ["domain", "linkedin_url"],
+        outputFields: [
+            f("company_profile", "Company profile", null, "jsonb"),
+            f("company_description", "Description", "company.description", "text", true),
+            f("company_founded_year", "Founded year", "company.founded_year", "numeric", true),
+            f("company_hq_address", "HQ address", "company.hq_location", "text", true),
+            f("company_hq_country", "HQ country", "company.hq_country", "text", true),
+            f("company_type", "Company type", null, "text", true),
+            f("company_specialties", "Specialties", "company.specialties", "jsonb", true),
+            f("company_logo_url", "Logo", "company.logo_url", "text", true),
+        ],
+        surfaces: { preset: "company_enrich", companyFields: ["company_profile", "description", "founded_year", "hq_address", "hq_country", "company_type", "specialties", "logo_url"], managedFunction: "enrich_company", catalogEntry: "preset:company_enrich", registryFunction: "enrichment", registryIntent: "enrich_company", registryInputShapes: ["field:company_profile"] },
+        status: "default",
+        decision: "D48",
+    },
+    {
+        id: "enrich_company:funding",
+        label: "Funding",
+        description: "Total raised, latest round with type, amount and date, number of rounds and named investors.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 140,
+        aliases: ["funding", "funding round", "last round", "latest round", "raised", "investors", "series a", "seed round", "total funding", "fundraising"],
+        inputShapes: ["domain"],
+        outputFields: [
+            f("company_funding", "Funding", null, "jsonb"),
+            f("company_funding_stage", "Funding stage", null, "text", true),
+            f("company_latest_funding_round", "Latest round", null, "jsonb", true),
+            f("company_total_funding", "Total funding", "company.funding_raised", "numeric", true),
+            f("company_funding_rounds_count", "Rounds", null, "numeric", true),
+            f("company_investors", "Investors", null, "jsonb", true),
+        ],
+        // Not in the company bundle (founder, 2026-09-24: one profile lookup, no
+        // opt-in fields); a caller names the fields on `find company`.
+        surfaces: { find: "find company --domain <domain> --fields funding,funding_stage,latest_funding_round,total_funding,funding_rounds_count,investors", companyFields: ["funding", "funding_stage", "latest_funding_round", "total_funding", "funding_rounds_count", "investors"], managedFunction: "company_total_funding", registryFunction: "enrichment", registryIntent: "enrich_company", registryInputShapes: ["field:funding"] },
+        status: "default",
+        decision: "D49",
+    },
+    {
+        id: "enrich_company:technologies",
+        label: "Tech stack",
+        description: "Technologies the company runs: from its job postings with confidence and first/last-seen dates, or from its website; plus a yes/no check for technologies you name.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 150,
+        aliases: ["tech stack", "technologies they use", "technographics", "tools they use", "software they use", "built with"],
+        inputShapes: ["domain"],
+        outputFields: [f("company_technologies", "Technologies", "company.technologies", "jsonb"), f("company_technology_check", "Uses named technology", null, "boolean", true)],
+        surfaces: { preset: "company_tech_stack", companyFields: ["technologies", "technology_check"], managedFunction: "company_tech_stack", catalogEntry: "preset:company_tech_stack", registryFunction: "enrichment", registryIntent: "enrich_company", registryInputShapes: ["field:technologies"] },
+        status: "default",
+        decision: "D49",
+    },
+    {
+        id: "enrich_company:hiring_signals",
+        label: "Hiring signals",
+        description: "Open roles at the company: how many and which.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 160,
+        aliases: ["open roles", "job openings", "are they hiring", "is hiring", "job postings", "hiring signals"],
+        inputShapes: ["domain", "linkedin_url"],
+        outputFields: [f("company_hiring_signals", "Hiring signals", null, "jsonb"), f("company_job_openings", "Open roles", null, "numeric", true)],
+        // Not in the company bundle (founder, 2026-09-24).
+        surfaces: { find: "find company --domain <domain> --fields hiring_signals,job_openings", companyFields: ["hiring_signals", "job_openings"], managedFunction: "company_job_openings", registryFunction: "enrichment", registryIntent: "enrich_company", registryInputShapes: ["field:hiring_signals"] },
+        status: "default",
+    },
+    {
+        id: "enrich_company:competitors",
+        label: "Competitors",
+        description: "Named competitors of the company.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 170,
+        aliases: ["their competitors", "competitors of", "who competes with", "named competitors"],
+        inputShapes: ["domain"],
+        outputFields: [f("company_competitors", "Competitors", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["leadmagic"],
+    },
+    {
+        id: "enrich_company:corporate_structure",
+        label: "Corporate structure",
+        description: "Parent company and subsidiaries.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 180,
+        aliases: ["parent company", "subsidiaries", "corporate structure", "owned by", "holding"],
+        inputShapes: ["domain"],
+        outputFields: [
+            f("company_corporate_structure", "Corporate structure", null, "jsonb"),
+            f("company_parent_company", "Parent company", null, "text", true),
+            f("company_subsidiaries", "Subsidiaries", null, "jsonb", true),
+        ],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["discolike"],
+    },
+    {
+        id: "enrich_company:acquisitions",
+        label: "Acquisitions",
+        description: "Companies it acquired and acquisition events it was part of.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 190,
+        aliases: ["acquisitions", "acquired", "m&a", "mergers"],
+        inputShapes: ["domain"],
+        outputFields: [f("company_acquisitions", "Acquisitions", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["predictleads", "leadmagic"],
+    },
+    {
+        id: "enrich_company:news",
+        label: "Recent news",
+        description: "Dated company announcements: launches, expansion, leadership, layoffs.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 200,
+        aliases: ["recent news", "company news", "announcements", "press mentions", "what happened recently"],
+        inputShapes: ["domain"],
+        outputFields: [f("company_news", "News", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["predictleads", "leadmagic"],
+    },
+    {
+        id: "enrich_company:web_presence",
+        label: "Web presence",
+        description: "Crunchbase, GitHub, Facebook, Instagram and YouTube pages for the company.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 210,
+        aliases: ["crunchbase url", "github url", "facebook page", "instagram page", "youtube channel", "social links"],
+        inputShapes: ["name", "domain"],
+        outputFields: [
+            f("company_crunchbase_url", "Crunchbase", null),
+            f("company_github_url", "GitHub", null),
+            f("company_facebook_url", "Facebook", "company.facebook_url"),
+            f("company_instagram_url", "Instagram", "company.instagram_url"),
+            f("company_youtube_url", "YouTube", null),
+        ],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["serper"],
+    },
+    {
+        id: "domain_check",
+        label: "Domain status",
+        description: "Whether a domain is live, redirecting, parked or dead, reused free for 30 days.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 220,
+        aliases: ["domain status", "is the website live", "dead domain", "parked domain"],
+        inputShapes: ["domain"],
+        outputFields: [f("domain_check", "Domain status", null), f("domain_check_label", "Domain status (label)", null, "text", true)],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the free domain-status check leaves the catalogue until the default chains are re-measured.",
+        decision: "D51",
+    },
+    {
+        id: "company_revenue_estimate",
+        label: "Revenue (estimate)",
+        description: "Estimated annual revenue as a figure or a range; no source reports exact revenue for private companies.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 230,
+        aliases: ["revenue", "annual revenue", "revenue estimate", "how much do they make", "arr", "reported revenue", "exact revenue", "financials", "company revenue"],
+        inputShapes: ["domain"],
+        outputFields: [f("company_revenue", "Revenue (estimate)", "company.revenue")],
+        // Not in the company bundle (founder, 2026-09-24).
+        surfaces: { find: "find company --domain <domain> --fields revenue", companyFields: ["revenue"], managedFunction: "company_revenue_estimate", registryFunction: "enrichment", registryIntent: "enrich_company", registryInputShapes: ["field:revenue"] },
+        status: "default",
+        decision: "D50",
+    },
+    {
+        id: "company_revenue_exact",
+        label: "Revenue (reported)",
+        description: "Reported revenue figures.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 240,
+        aliases: [],
+        inputShapes: ["domain"],
+        outputFields: [],
+        surfaces: {},
+        status: "rejected",
+        statusReason: "Merged into Revenue (estimate): no provider in the catalogue reports exact revenue for private companies, so one Revenue row answers with a labelled estimate.",
+        decision: "D50",
+    },
+    {
+        id: "company_headcount_growth",
+        label: "Headcount growth",
+        description: "Employee growth over 6, 12 and 24 months.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 250,
+        aliases: ["headcount growth", "employee growth", "growing team", "hiring velocity", "growth rate"],
+        inputShapes: ["domain"],
+        outputFields: [f("company_headcount_growth", "Headcount growth", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): four wired providers document headcount growth; the default is being chosen.",
+        decision: "D34c",
+        candidateProviders: ["apollo", "peopledatalabs", "signalbase", "crustdata"],
+    },
+    {
+        id: "company_website_traffic",
+        label: "Website traffic",
+        description: "Estimated monthly visits to the company's website.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 260,
+        aliases: ["website traffic", "monthly visits", "web traffic", "site visitors"],
+        inputShapes: ["domain"],
+        outputFields: [f("company_website_traffic", "Website traffic", null, "numeric")],
+        surfaces: { managedFunction: "website_traffic" },
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): only a keyword-derived traffic estimate is wired today; a visits-grade source is being chosen.",
+        decision: "D34b",
+        candidateProviders: ["adyntel", "apollo"],
+    },
+    // ── Decision makers (search-shaped; the catalogue references them, it never adds a second chain) ──
+    {
+        id: "people_search:account_contacts",
+        label: "Decision makers at each account",
+        description: "Finds the right people at accounts you already hold, by role and seniority.",
+        entity: "person",
+        group: "decision_maker",
+        kind: "search",
+        rank: 300,
+        aliases: ["decision maker", "decision makers", "head of sales at", "people at these companies", "contacts at each account", "who should i contact", "find people at company"],
+        inputShapes: ["company_domain", "company_linkedin_url"],
+        outputFields: [f("full_name", "Full name", "person.full_name"), f("job_title", "Job title", "person.job_title"), f("linkedin_url", "LinkedIn URL", "person.linkedin_url")],
+        surfaces: { managedFunction: "find_people_at_company", registryFunction: "people_search", registryIntent: "account_contacts" },
+        status: "default",
+    },
+    {
+        id: "people_search:persona_search",
+        label: "People matching a persona",
+        description: "Builds a people list from title, seniority, department, location and company filters.",
+        entity: "person",
+        group: "decision_maker",
+        kind: "search",
+        rank: 310,
+        aliases: ["find people matching", "people search", "persona list", "prospect list", "leads matching"],
+        inputShapes: ["persona_filters"],
+        outputFields: [f("full_name", "Full name", "person.full_name"), f("job_title", "Job title", "person.job_title"), f("linkedin_url", "LinkedIn URL", "person.linkedin_url")],
+        surfaces: { registryFunction: "people_search", registryIntent: "persona_search" },
+        status: "default",
+    },
+    {
+        id: "people_search:reachable_persona",
+        label: "Reachable people",
+        description: "People matching a persona who already have an email or phone on file.",
+        entity: "person",
+        group: "decision_maker",
+        kind: "search",
+        rank: 320,
+        aliases: ["reachable", "with phone", "with email", "contactable people"],
+        inputShapes: ["persona_filters"],
+        outputFields: [f("full_name", "Full name", "person.full_name"), f("linkedin_url", "LinkedIn URL", "person.linkedin_url")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["contactout"],
+    },
+    {
+        id: "people_search:audience_sizing",
+        label: "Audience size",
+        description: "How many people match a persona before you buy any of them.",
+        entity: "person",
+        group: "decision_maker",
+        kind: "search",
+        rank: 330,
+        aliases: ["how many people", "audience size", "count people", "market size people"],
+        inputShapes: ["persona_filters"],
+        outputFields: [f("audience_count", "Matching people", null, "numeric")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["blitzapi"],
+    },
+    {
+        id: "company_search:find_lookalikes",
+        label: "Lookalike companies",
+        description: "Companies that resemble the accounts you already hold.",
+        entity: "company",
+        group: "decision_maker",
+        kind: "search",
+        rank: 340,
+        aliases: ["lookalike", "similar companies", "companies like", "more like these"],
+        inputShapes: ["seed_accounts"],
+        outputFields: [f("company_name", "Company", "company.name"), f("company_domain", "Domain", "company.domain")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["leadmagic"],
+    },
+    // ── Signals (streams and watch-lists; referenced) ─────────────────────────
+    {
+        id: "signals:funding_events",
+        label: "Funding events",
+        description: "Companies that raised a round, market-wide or across a watch-list.",
+        entity: "company",
+        group: "signal",
+        kind: "signal",
+        rank: 400,
+        aliases: ["just raised", "funding events", "new funding", "raised a round", "fundraising signal"],
+        inputShapes: ["market", "watch_list"],
+        outputFields: [f("event", "Funding event", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["predictleads"],
+    },
+    {
+        id: "signals:hiring_surge",
+        label: "Hiring surge",
+        description: "Companies actively hiring for given roles, departments or locations.",
+        entity: "company",
+        group: "signal",
+        kind: "signal",
+        rank: 410,
+        aliases: ["hiring surge", "companies hiring", "hiring for", "new job posts"],
+        inputShapes: ["market", "watch_list"],
+        outputFields: [f("event", "Hiring event", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["blitzapi", "theirstack"],
+    },
+    {
+        id: "signals:tech_adoption",
+        label: "Technology adoption",
+        description: "Companies using or newly adopting a named technology.",
+        entity: "company",
+        group: "signal",
+        kind: "signal",
+        rank: 420,
+        aliases: ["tech adoption", "started using", "companies using", "adopted"],
+        inputShapes: ["market", "watch_list"],
+        outputFields: [f("event", "Technology event", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["predictleads", "theirstack"],
+    },
+    {
+        id: "signals:news_events",
+        label: "News events",
+        description: "Dated company news across a market or a watch-list.",
+        entity: "company",
+        group: "signal",
+        kind: "signal",
+        rank: 430,
+        aliases: ["news events", "company news feed", "announcements feed"],
+        inputShapes: ["market", "watch_list"],
+        outputFields: [f("event", "News event", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["predictleads"],
+    },
+    {
+        id: "signals:acquisition_events",
+        label: "Acquisition events",
+        description: "Companies acquired or acquiring in a time window.",
+        entity: "company",
+        group: "signal",
+        kind: "signal",
+        rank: 440,
+        aliases: ["acquisition events", "got acquired", "acquired companies", "m&a signal"],
+        inputShapes: ["market", "watch_list"],
+        outputFields: [f("event", "Acquisition event", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["predictleads"],
+    },
+    {
+        id: "signals:job_change",
+        label: "Job changes",
+        description: "People on a watch-list who changed role or company.",
+        entity: "person",
+        group: "signal",
+        kind: "signal",
+        rank: 450,
+        aliases: ["job change", "changed jobs", "new role", "left the company", "promoted"],
+        inputShapes: ["watch_list"],
+        outputFields: [f("event", "Job-change event", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+        candidateProviders: ["leadmagic"],
+    },
+    {
+        id: "signals:signal_monitor",
+        label: "Signal monitor",
+        description: "Re-runs any signal on a cadence over a watch-list and writes only new events, under a recurring credit cap.",
+        entity: "company",
+        group: "signal",
+        kind: "signal",
+        rank: 460,
+        aliases: ["watch these companies", "alert me when", "recurring signal", "signal monitor"],
+        inputShapes: ["watch_list"],
+        outputFields: [f("event", "Signal event", null, "jsonb")],
+        surfaces: {},
+        status: "coming_soon",
+        statusReason: "Coming soon (D51, 2026-09-19): the catalogue ships the default chains customers need most first; this data type returns once its lane is measured.",
+        decision: "D51",
+    },
+    // ── Rejected (kept so nobody re-adds them silently; pruning is never deletion) ──
+    {
+        id: "reverse_phone_lookup",
+        label: "Person from phone number",
+        description: "Identify a person from a phone number.",
+        entity: "person",
+        group: "contact",
+        kind: "enrichment",
+        rank: 900,
+        aliases: ["reverse phone", "who owns this number"],
+        inputShapes: ["phone"],
+        outputFields: [],
+        surfaces: {},
+        status: "rejected",
+        statusReason: "No managed provider and no customer demand recorded.",
+        decision: "D33",
+    },
+    {
+        id: "whatsapp_number_validation",
+        label: "WhatsApp number check",
+        description: "Whether a number is on WhatsApp.",
+        entity: "person",
+        group: "contact",
+        kind: "verification",
+        rank: 910,
+        aliases: ["whatsapp check", "on whatsapp"],
+        inputShapes: ["phone"],
+        outputFields: [],
+        surfaces: {},
+        status: "rejected",
+        statusReason: "No managed provider; WhatsApp reachability belongs to the messaging channel, not enrichment.",
+        decision: "D33",
+    },
+    {
+        id: "linkedin_engagement_score",
+        label: "LinkedIn engagement score",
+        description: "A score of how engaged a person is on LinkedIn.",
+        entity: "person",
+        group: "person",
+        kind: "signal",
+        rank: 920,
+        aliases: ["engagement score", "linkedin activity score"],
+        inputShapes: ["linkedin_url"],
+        outputFields: [],
+        surfaces: {},
+        status: "rejected",
+        statusReason: "Owned by Posts and Signals (engagement telemetry), not by enrichment.",
+        decision: "D33",
+    },
+    {
+        id: "is_hiring_as_enrichment",
+        label: "Is hiring (flag)",
+        description: "A yes/no hiring flag as an enrichment column.",
+        entity: "company",
+        group: "company",
+        kind: "enrichment",
+        rank: 930,
+        aliases: [],
+        inputShapes: ["domain"],
+        outputFields: [],
+        surfaces: {},
+        status: "rejected",
+        statusReason: "Covered by Hiring signals (open roles) and the Hiring surge signal; a bare flag would duplicate both.",
+        decision: "D33",
+    },
+];
+const COST_STRUCTURE_WORDS = /\b(flat[- ]fee|unlimited|zero[- ]marginal|\$0 marginal|subscription)\b/i;
+/** True when a customer-facing string leaks vendor cost structure (OXYGEN_PRODUCT.md 2026-08-10). */
+export function leaksCostStructure(text) {
+    return COST_STRUCTURE_WORDS.test(text);
+}
+export function listEnrichmentIntents(filter) {
+    const statuses = filter?.status === undefined ? null : Array.isArray(filter.status) ? filter.status : [filter.status];
+    return ENRICHMENT_INTENT_TAXONOMY
+        .filter((row) => (filter?.group ? row.group === filter.group : true))
+        .filter((row) => (filter?.entity ? row.entity === filter.entity : true))
+        .filter((row) => (statuses ? statuses.includes(row.status) : true))
+        .sort((a, b) => a.rank - b.rank)
+        .map((row) => ({ ...row }));
+}
+export function getEnrichmentIntent(id) {
+    return ENRICHMENT_INTENT_TAXONOMY.find((row) => row.id === id) ?? null;
+}
+function pointerForRows(rows) {
+    const live = rows.filter((row) => row.status !== "rejected");
+    if (live.length === 0)
+        return null;
+    if (live.length === 1) {
+        const row = live[0];
+        return { intent: row.id, group: row.group, exact_command: `oxygen enrichment catalog --intent ${row.id}` };
+    }
+    const group = live[0].group;
+    return { intent: null, group, exact_command: `oxygen enrichment catalog --group ${group}` };
+}
+/** Catalogue pointer for a column-catalogue entry id such as `preset:company_enrich` or `capability:work_email`. */
+export function catalogPointerForEntry(entryId) {
+    return pointerForRows(ENRICHMENT_INTENT_TAXONOMY.filter((row) => row.surfaces.catalogEntry === entryId));
+}
+/** Catalogue pointer for one company enrichment field key such as `technologies` or `latest_funding_round`. */
+export function catalogPointerForCompanyField(field) {
+    return pointerForRows(ENRICHMENT_INTENT_TAXONOMY.filter((row) => row.surfaces.companyFields?.includes(field) === true));
+}
+export function findEnrichmentIntentByAlias(query) {
+    const normalized = query.toLowerCase().replace(/[^a-z0-9&'\s-]/g, " ").replace(/\s+/g, " ").trim();
+    // Match the phrase as typed and with plain plurals folded ("personal emails"
+    // -> "personal email"), so an alias never has to list both forms.
+    const forms = [` ${normalized} `, ` ${normalized.replace(/\b([a-z]{4,}?)(?:ies|s)\b/g, (word, stem) => (word.endsWith("ies") ? `${stem}y` : stem))} `];
+    let best = null;
+    for (const row of ENRICHMENT_INTENT_TAXONOMY) {
+        if (row.status === "rejected")
+            continue;
+        for (const alias of row.aliases) {
+            if (!forms.some((form) => form.includes(` ${alias} `)))
+                continue;
+            if (!best || alias.length > best.length || (alias.length === best.length && row.rank < best.row.rank)) {
+                best = { row, length: alias.length };
+            }
+        }
+    }
+    return best ? { ...best.row } : null;
+}