@oxygen-agent/cli 1.982.3 → 1.987.20

package/node_modules/@oxygen/formula/dist/value-cleaners.js

@@ -0,0 +1,374 @@
+/**
+ * Deterministic value cleaners for dirty GTM strings — company names, job
+ * titles, delimited lists, and email-address classification.
+ *
+ * Pure string functions with no I/O, no tenant context, and no dependencies,
+ * so the exact semantics that clean a cell in the worker also run in the
+ * browser (formula editor previews). Every list below is a fixed, auditable
+ * data set: nothing here calls a provider, spends a credit, or guesses with a
+ * model. When a deterministic list is not enough, the paid verifier columns
+ * are the upgrade — these helpers are the free first pass.
+ */
+// ---------------------------------------------------------------------------
+// Shared text helpers
+// ---------------------------------------------------------------------------
+/** Zero-width joiners, variation selectors, and the BOM — invisible, never meaningful in a cell. */
+const INVISIBLE_PATTERN = /[​-‍⁠︎️⃣]/g;
+/**
+ * Emoji, pictographs, and symbol runs. Deliberately Unicode-property based:
+ * a byte-range or "non-ASCII" filter would eat accented letters, and GTM data
+ * is full of Müller, Ørsted, and Škoda.
+ */
+const PICTOGRAPH_PATTERN = /[\p{Extended_Pictographic}\p{Emoji_Presentation}\p{Emoji_Modifier}\p{So}]/gu;
+/** Leading/trailing punctuation, symbols, quotes, and whitespace. Inner punctuation is preserved. */
+const OUTER_NOISE_PATTERN = /^[\s\p{P}\p{S}]+|[\s\p{P}\p{S}]+$/gu;
+function toText(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    try {
+        return JSON.stringify(value) ?? "";
+    }
+    catch {
+        return "";
+    }
+}
+function collapseWhitespace(value) {
+    return value.replace(INVISIBLE_PATTERN, "").replace(/\s+/gu, " ").trim();
+}
+function trimOuterNoise(value) {
+    return value.replace(OUTER_NOISE_PATTERN, "");
+}
+/** True when every cased letter in the text is upper-case (digits/punctuation ignored). */
+export function isAllCaps(value) {
+    let sawCasedLetter = false;
+    for (const char of value) {
+        if (!/\p{L}/u.test(char))
+            continue;
+        const lower = char.toLowerCase();
+        const upper = char.toUpperCase();
+        if (lower === upper)
+            continue; // caseless script (CJK, etc.) — not evidence either way
+        sawCasedLetter = true;
+        if (char !== upper)
+            return false;
+    }
+    return sawCasedLetter;
+}
+/** Capitalizes the first letter of every word and lowercases the rest (Unicode-aware). */
+export function titleCaseWords(value) {
+    return value.replace(/(\p{L})(\p{L}*)/gu, (_match, first, rest) => first.toUpperCase() + rest.toLowerCase());
+}
+// ---------------------------------------------------------------------------
+// Company names
+// ---------------------------------------------------------------------------
+/**
+ * Legal/corporate suffixes, stored as punctuation-free lower-case keys so
+ * "L.L.C.", "llc", and "LLC," all reduce to `llc`. Multi-word suffixes are
+ * joined ("pty ltd" → `ptyltd`) and matched against the trailing 1–3 tokens.
+ */
+export const COMPANY_LEGAL_SUFFIX_KEYS = new Set([
+    "inc", "incorporated", "corp", "corporation", "co", "company",
+    "ltd", "limited", "llc", "llp", "lp", "plc",
+    "gmbh", "ag", "sa", "sas", "sarl", "srl", "spa",
+    "bv", "nv", "oy", "ab", "as", "pty", "kg", "kk", "pte",
+    "sdnbhd", "ptyltd", "pteltd",
+    "ltda", "ug", "ev", "ou", "sro", "spzoo", "zrt", "kft", "doo",
+    "aps", "hf", "ehf", "ltee",
+]);
+/** The longest suffix key measured in whitespace-separated tokens ("sp. z o.o."). */
+const MAX_SUFFIX_TOKENS = 3;
+/** Separators after which a company string turns into a tagline, not a name. */
+const SHORT_FORM_SEPARATORS = [" - ", " – ", " — ", " | ", ":", " / ", "("];
+const SHORT_FORM_MAX_WORDS = 3;
+function suffixKey(token) {
+    return token.toLowerCase().replace(/[^\p{L}\p{N}]/gu, "");
+}
+function stripLegalSuffixes(tokens) {
+    let remaining = [...tokens];
+    // Bounded: every pass removes at least one token, so the token count is the budget.
+    for (let pass = 0; pass < tokens.length; pass += 1) {
+        while (remaining.length > 1 && suffixKey(remaining[remaining.length - 1] ?? "") === "") {
+            remaining = remaining.slice(0, -1);
+        }
+        let matched = false;
+        for (let span = Math.min(MAX_SUFFIX_TOKENS, remaining.length - 1); span >= 1; span -= 1) {
+            const key = remaining.slice(remaining.length - span).map(suffixKey).join("");
+            if (!key || !COMPANY_LEGAL_SUFFIX_KEYS.has(key))
+                continue;
+            remaining = remaining.slice(0, remaining.length - span);
+            matched = true;
+            break;
+        }
+        if (!matched)
+            break;
+    }
+    return remaining;
+}
+function cutAtShortFormSeparator(value) {
+    let cut = value.length;
+    for (const separator of SHORT_FORM_SEPARATORS) {
+        const index = value.indexOf(separator);
+        if (index > 0 && index < cut)
+            cut = index;
+    }
+    return value.slice(0, cut);
+}
+/**
+ * Canonical company name: legal suffixes removed, stray punctuation and quotes
+ * trimmed, whitespace collapsed. Casing is the author's unless the whole name
+ * shouts ("ACME CORP." → "Acme"), because "hubspot" is how that company writes
+ * itself. `short` additionally cuts a tagline after a separator and keeps at
+ * most three words — the form that fits in an email's first sentence.
+ *
+ * Blank input returns null.
+ */
+export function normalizeCompanyName(value, mode = "display") {
+    const raw = collapseWhitespace(toText(value).replace(PICTOGRAPH_PATTERN, ""));
+    if (!raw)
+        return null;
+    const base = mode === "short" ? collapseWhitespace(cutAtShortFormSeparator(raw)) : raw;
+    if (!base)
+        return null;
+    const tokens = stripLegalSuffixes(base.split(" ").filter(Boolean));
+    let cleaned = collapseWhitespace(trimOuterNoise(tokens.join(" ")));
+    if (!cleaned)
+        cleaned = collapseWhitespace(trimOuterNoise(base));
+    if (!cleaned)
+        return null;
+    if (mode === "short") {
+        const words = cleaned.split(" ").filter(Boolean);
+        if (words.length > SHORT_FORM_MAX_WORDS) {
+            cleaned = words.slice(0, SHORT_FORM_MAX_WORDS).join(" ");
+        }
+    }
+    return isAllCaps(cleaned) ? titleCaseWords(cleaned) : cleaned;
+}
+// ---------------------------------------------------------------------------
+// Job titles
+// ---------------------------------------------------------------------------
+/**
+ * Recruiting and self-promotion phrases that ride along in a scraped headline.
+ * Longest first so "we're hiring" is consumed before the bare "hiring".
+ */
+export const JOB_TITLE_SLOGANS = [
+    "we are hiring",
+    "we're hiring",
+    "join our team",
+    "open to work",
+    "let's connect",
+    "looking for",
+    "now hiring",
+    "opentowork",
+    "join us",
+    "dm me",
+    "hiring",
+];
+const SLOGAN_PATTERNS = JOB_TITLE_SLOGANS
+    .slice()
+    .sort((a, b) => b.length - a.length)
+    .map((phrase) => {
+    const body = phrase
+        .split("")
+        .map((char) => {
+        if (char === " ")
+            return "\\s+";
+        if (char === "'")
+            return "['’‘ʼ´]";
+        return char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    })
+        .join("");
+    // No lookbehind: Safari shipped it late and this engine runs in the browser.
+    return new RegExp(`(^|[^\\p{L}\\p{N}])(?:${body})(?![\\p{L}\\p{N}])`, "giu");
+});
+/**
+ * Separators that join a real title to a second clause. A bare `-`, `,`, `/`,
+ * or `&` is NOT one of them: "Account Executive - EMEA", "Sr. Director, Demand
+ * Generation", and "Director of Importing/Exporting" are whole titles.
+ */
+const JOB_TITLE_SEPARATOR_PATTERN = /\s*\|\s*|\s*[•·]\s*|\s*::\s*|\s+[—–]\s+/u;
+/**
+ * Canonical job title: emoji, hashtags, parentheticals, and hiring slogans
+ * removed, then only the first clause of a separator-joined headline kept.
+ * All-caps titles are title-cased; every other casing is the author's.
+ *
+ * Blank input, or input that was nothing but noise, returns null.
+ */
+export function cleanJobTitle(value) {
+    let text = toText(value);
+    if (!text.trim())
+        return null;
+    text = text.replace(PICTOGRAPH_PATTERN, "").replace(INVISIBLE_PATTERN, "");
+    // Parentheticals, innermost-out; bounded so a pathological paste cannot spin.
+    for (let pass = 0; pass < 4; pass += 1) {
+        const next = text.replace(/\([^()]*\)/g, " ").replace(/\[[^[\]]*\]/g, " ");
+        if (next === text)
+            break;
+        text = next;
+    }
+    text = text.replace(/#[\p{L}\p{N}_-]+/gu, " ");
+    for (const pattern of SLOGAN_PATTERNS)
+        text = text.replace(pattern, "$1");
+    text = collapseWhitespace(text);
+    const segments = text.split(JOB_TITLE_SEPARATOR_PATTERN).map((part) => (part ?? "").trim());
+    const chosen = segments.find((part) => /[\p{L}\p{N}]/u.test(part)) ?? segments[0] ?? "";
+    const cleaned = collapseWhitespace(trimOuterNoise(chosen));
+    if (!cleaned)
+        return null;
+    return isAllCaps(cleaned) ? titleCaseWords(cleaned) : cleaned;
+}
+// ---------------------------------------------------------------------------
+// Delimited lists
+// ---------------------------------------------------------------------------
+/** Tried in order when no separator is given; the first one present wins. */
+const LIST_DELIMITERS = ["\n", ";", "|", ","];
+function cleanListParts(parts) {
+    const seen = new Set();
+    const out = [];
+    for (const part of parts) {
+        const text = collapseWhitespace(toText(part));
+        if (!text || seen.has(text))
+            continue;
+        seen.add(text);
+        out.push(text);
+    }
+    return out;
+}
+/**
+ * Turns one messy cell into a clean array: trimmed, blank-free, de-duplicated
+ * in first-seen order. An existing array or a JSON-encoded array is cleaned in
+ * place; a string is split on the given separator, or on the first delimiter
+ * actually present (newline, `;`, `|`, `,`) when none is given.
+ *
+ * Blank input returns an empty array.
+ */
+export function splitDelimitedList(value, separator) {
+    if (Array.isArray(value))
+        return cleanListParts(value);
+    if (value === null || value === undefined)
+        return [];
+    const text = typeof value === "string" ? value : toText(value);
+    const trimmed = text.trim();
+    if (!trimmed)
+        return [];
+    if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed))
+                return cleanListParts(parsed);
+        }
+        catch {
+            // Not JSON after all — fall through to delimiter splitting.
+        }
+    }
+    const explicit = typeof separator === "string" ? separator : "";
+    if (explicit)
+        return cleanListParts(trimmed.split(explicit));
+    if (/\r?\n/.test(trimmed))
+        return cleanListParts(trimmed.split(/\r?\n/));
+    for (const delimiter of LIST_DELIMITERS) {
+        if (delimiter !== "\n" && trimmed.includes(delimiter)) {
+            return cleanListParts(trimmed.split(delimiter));
+        }
+    }
+    return cleanListParts([trimmed]);
+}
+// ---------------------------------------------------------------------------
+// Email classification
+// ---------------------------------------------------------------------------
+/** Consumer mailbox providers — a person, not a company domain. */
+export const FREE_MAIL_DOMAINS = new Set([
+    "gmail.com", "googlemail.com",
+    "yahoo.com", "yahoo.co.uk", "yahoo.fr", "yahoo.de", "yahoo.co.jp", "yahoo.ca",
+    "yahoo.com.au", "yahoo.es", "yahoo.it", "ymail.com", "rocketmail.com",
+    "hotmail.com", "hotmail.co.uk", "hotmail.fr", "hotmail.de", "hotmail.it", "hotmail.es",
+    "outlook.com", "outlook.fr", "outlook.de", "outlook.es", "outlook.co.uk",
+    "live.com", "live.co.uk", "live.fr", "live.de", "msn.com",
+    "aol.com", "icloud.com", "me.com", "mac.com",
+    "protonmail.com", "proton.me", "pm.me",
+    "gmx.com", "gmx.de", "gmx.net", "gmx.at", "gmx.ch",
+    "web.de", "t-online.de", "freenet.de",
+    "mail.com", "mail.ru", "yandex.ru", "yandex.com",
+    "zoho.com", "fastmail.com", "hey.com", "tutanota.com", "tuta.io",
+    "orange.fr", "wanadoo.fr", "free.fr", "laposte.net", "sfr.fr",
+    "libero.it", "virgilio.it", "seznam.cz",
+    "wp.pl", "o2.pl", "onet.pl", "interia.pl",
+    "qq.com", "163.com", "126.com", "sina.com",
+    "naver.com", "daum.net", "hanmail.net", "rediffmail.com",
+    "bigpond.com", "optusnet.com.au", "telus.net", "shaw.ca", "sympatico.ca", "rogers.com",
+    "btinternet.com", "sky.com", "talktalk.net", "virginmedia.com", "blueyonder.co.uk",
+    "comcast.net", "verizon.net", "att.net", "sbcglobal.net", "cox.net",
+    "charter.net", "earthlink.net", "bellsouth.net",
+    "ziggo.nl", "kpnmail.nl", "home.nl", "telenet.be", "skynet.be", "bluewin.ch",
+    "uol.com.br", "bol.com.br", "terra.com.br",
+]);
+/** Throwaway inbox providers — never worth a send, never worth a credit. */
+export const DISPOSABLE_EMAIL_DOMAINS = new Set([
+    "mailinator.com", "guerrillamail.com", "guerrillamail.net",
+    "10minutemail.com", "10minutemail.net",
+    "tempmail.com", "temp-mail.org", "temp-mail.io", "tempr.email",
+    "yopmail.com", "yopmail.fr", "trashmail.com", "trashmail.me",
+    "getnada.com", "dispostable.com", "maildrop.cc", "sharklasers.com",
+    "throwawaymail.com", "fakeinbox.com", "mohmal.com", "mailnesia.com",
+    "spamgourmet.com", "discard.email", "mintemail.com", "emailondeck.com",
+    "burnermail.io", "tempail.com", "mytemp.email", "moakt.com",
+    "tmpmail.org", "tmpmail.net", "minutemail.com", "mailcatch.com",
+    "spam4.me", "harakirimail.com", "jetable.org", "mailexpire.com",
+    "throwam.com", "tempinbox.com", "inboxkitten.com",
+]);
+/** Shared-inbox local parts — a department, not a person. */
+export const ROLE_EMAIL_LOCAL_PARTS = new Set([
+    "info", "sales", "support", "help", "admin", "administrator",
+    "contact", "hello", "hi", "team", "office",
+    "billing", "invoices", "accounts", "accounting", "finance",
+    "marketing", "hr", "jobs", "careers", "recruiting",
+    "press", "media", "pr", "legal", "privacy", "security", "abuse",
+    "postmaster", "webmaster", "hostmaster",
+    "noreply", "no-reply", "donotreply", "do-not-reply",
+    "newsletter", "notifications", "notification",
+    "mail", "mailer-daemon", "service", "services",
+    "customerservice", "customer-service",
+    "enquiries", "inquiries", "enquiry", "inquiry",
+    "orders", "order", "partners", "partnerships",
+    "feedback", "welcome", "community",
+    "dev", "devops", "it", "ops", "engineering",
+    "alerts", "subscriptions",
+]);
+const EMAIL_SYNTAX_PATTERN = /^[^\s@,;:<>"'()[\]\\]+@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z]{2,}$/;
+/** A domain matches a list when it IS a listed domain or a subdomain of one (mail.yahoo.com). */
+function matchesDomainList(domain, list) {
+    if (list.has(domain))
+        return true;
+    const labels = domain.split(".");
+    for (let index = 1; index < labels.length - 1; index += 1) {
+        if (list.has(labels.slice(index).join(".")))
+            return true;
+    }
+    return false;
+}
+/**
+ * Classifies an email address from OXYGEN's built-in lists, in precedence
+ * order: a throwaway domain wins, then a shared-inbox local part, then a
+ * consumer mailbox provider, and anything left is a company address.
+ *
+ * Blank or syntactically invalid input returns null.
+ */
+export function classifyEmailType(value) {
+    const email = toText(value).trim().toLowerCase();
+    if (!email || !EMAIL_SYNTAX_PATTERN.test(email))
+        return null;
+    const at = email.lastIndexOf("@");
+    const localPart = email.slice(0, at);
+    const domain = email.slice(at + 1);
+    if (matchesDomainList(domain, DISPOSABLE_EMAIL_DOMAINS))
+        return "disposable";
+    const untagged = localPart.split("+")[0] ?? localPart;
+    if (ROLE_EMAIL_LOCAL_PARTS.has(untagged) || ROLE_EMAIL_LOCAL_PARTS.has(localPart))
+        return "role";
+    if (matchesDomainList(domain, FREE_MAIL_DOMAINS))
+        return "personal";
+    return "work";
+}

package/node_modules/@oxygen/shared/dist/billing.d.ts

@@ -172,36 +172,43 @@ export declare const WALKTHROUGH_COMPLETION_BONUS_CREDITS = 1000;
 export declare const WALKTHROUGH_SCRAPE_MAX_CREDITS = 2000;
 export declare const BASE_PRICING_PLANS: {
     readonly free: {
+        readonly monthlyPriceCents: number | null;
+        readonly monthlyCredits: number | null;
+        readonly weeklyCreditsLimit: number | null;
+        readonly rolloverCap: number | null;
+        readonly byokEnabled: boolean;
+        readonly tier: "free";
+        readonly name: "Free";
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
         readonly automationOverageEnabledDefault: false;
         readonly description: "Your CRM, tables, and workflows — free forever. Credits pay for enrichment and AI; connecting a sender, publishing, managed email infrastructure, and your own provider keys need a plan.";
         readonly ctaLabel: "Upgrade";
         readonly features: readonly ["CRM, Tables, Workflows, and Knowledge — unmetered", "Sequences: author, preview, and enroll", "Agents and Workspace Copilot", "Credits for enrichment and AI, topped up any time"];
+    };
+    readonly starter: {
         readonly monthlyPriceCents: number | null;
         readonly monthlyCredits: number | null;
         readonly weeklyCreditsLimit: number | null;
         readonly rolloverCap: number | null;
         readonly byokEnabled: boolean;
-        readonly tier: "free";
-        readonly name: "Free";
-    };
-    readonly starter: {
+        readonly tier: "starter";
+        readonly name: "Starter";
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
         readonly automationOverageEnabledDefault: false;
         readonly description: "For founders running focused managed enrichment and AI columns.";
         readonly ctaLabel: "Choose Starter";
         readonly features: readonly ["99,000 credits every month", "All integrations", "Workflows", "Bring your own keys", "Standard support"];
+    };
+    readonly pro: {
         readonly monthlyPriceCents: number | null;
         readonly monthlyCredits: number | null;
         readonly weeklyCreditsLimit: number | null;
         readonly rolloverCap: number | null;
         readonly byokEnabled: boolean;
-        readonly tier: "starter";
-        readonly name: "Starter";
-    };
-    readonly pro: {
+        readonly tier: "pro";
+        readonly name: "Pro";
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
         readonly automationOverageEnabledDefault: false;
@@ -210,30 +217,30 @@ export declare const BASE_PRICING_PLANS: {
         readonly highlighted: true;
         readonly ctaLabel: "Choose Pro";
         readonly features: readonly ["249,000 credits every month", "All integrations", "Workflows", "Bring your own keys", "Standard support"];
+    };
+    readonly team: {
         readonly monthlyPriceCents: number | null;
         readonly monthlyCredits: number | null;
         readonly weeklyCreditsLimit: number | null;
         readonly rolloverCap: number | null;
         readonly byokEnabled: boolean;
-        readonly tier: "pro";
-        readonly name: "Pro";
-    };
-    readonly team: {
+        readonly tier: "team";
+        readonly name: "Team";
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
         readonly automationOverageEnabledDefault: false;
         readonly description: "For small GTM teams and agencies running shared workflows with their own AI keys.";
         readonly ctaLabel: "Choose Team";
         readonly features: readonly ["749,000 credits every month", "All integrations", "Workflows", "Bring your own keys", "Premium support"];
+    };
+    readonly scale: {
         readonly monthlyPriceCents: number | null;
         readonly monthlyCredits: number | null;
         readonly weeklyCreditsLimit: number | null;
         readonly rolloverCap: number | null;
         readonly byokEnabled: boolean;
-        readonly tier: "team";
-        readonly name: "Team";
-    };
-    readonly scale: {
+        readonly tier: "scale";
+        readonly name: "Scale";
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
         readonly automationOverageEnabledDefault: false;
@@ -241,15 +248,15 @@ export declare const BASE_PRICING_PLANS: {
         readonly ctaLabel: "Contact sales";
         readonly contactHref: "mailto:priority@oxygen-agent.com";
         readonly features: readonly ["10,000,000+ managed credits / month", "Workflows", "Phone number enrichment on managed credits", "Custom provider routing and BYOK policies", "Dedicated onboarding"];
+    };
+    readonly enterprise: {
         readonly monthlyPriceCents: number | null;
         readonly monthlyCredits: number | null;
         readonly weeklyCreditsLimit: number | null;
         readonly rolloverCap: number | null;
         readonly byokEnabled: boolean;
-        readonly tier: "scale";
-        readonly name: "Scale";
-    };
-    readonly enterprise: {
+        readonly tier: "enterprise";
+        readonly name: "Enterprise";
         readonly monthlyAutomationActions: null;
         readonly automationOverageCentsPerMillion: null;
         readonly automationOverageEnabledDefault: false;
@@ -257,13 +264,6 @@ export declare const BASE_PRICING_PLANS: {
         readonly ctaLabel: "Talk to us";
         readonly contactHref: "mailto:priority@oxygen-agent.com";
         readonly features: readonly ["Everything in Team", "Custom usage limits", "Volume pricing", "Dedicated support"];
-        readonly monthlyPriceCents: number | null;
-        readonly monthlyCredits: number | null;
-        readonly weeklyCreditsLimit: number | null;
-        readonly rolloverCap: number | null;
-        readonly byokEnabled: boolean;
-        readonly tier: "enterprise";
-        readonly name: "Enterprise";
     };
 };
 export declare const PUBLIC_PLAN_ORDER: readonly PlanTier[];

package/node_modules/@oxygen/shared/dist/capability-discovery.js

@@ -210,10 +210,10 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         primitive: "tables",
         owns: "Typed working datasets, rows, formulas, AI/tool/waterfall columns, reusable Functions with isolated drafts and published versions, cell state, projects, and run provenance.",
         notFor: "Canonical CRM truth, message cadence, or an off-platform spreadsheet runtime.",
-        execution: "Create and run work in hosted OXYGEN Tables; validate a small sample before bounded paid runs. For standard person or company enrichment, `columns add <table> --preset person_enrich|company_enrich` (MCP oxygen_columns_add with preset) adds the maintained bundle in one call before any hand-built tool column.",
+        execution: "Create and run work in hosted OXYGEN Tables; validate a small sample before bounded paid runs. For standard person or company enrichment, `columns add <table> --preset person_enrich|company_enrich` (MCP oxygen_columns_add with preset) adds the maintained bundle in one call before any hand-built tool column. Person questions over that bundle's profile payload (skill set, grad school, location, job fit, current company) and person appearance research (events, keynotes, podcasts, GitHub profile) are `columns catalog --category people` templates, added with `columns add <table> --prompt-key <key> --input <name>=<column>`. For a company fact OXYGEN already knows how to research (founders, parent company, funding, cloud provider, offers demos, industry, NAICS, HQ, LinkedIn/Crunchbase page lookups) or a page extraction, `columns catalog` lists the ready-made template and `columns add <table> --prompt-key <key> --input <name>=<column>` (MCP oxygen_columns_add with prompt_key) adds it with no prompt to write.",
         posture: "mixed",
-        gatewayTools: ["oxygen_tables_create", "oxygen_columns_add", "oxygen_enrich_column_preview", "oxygen_tables_link_bulk", "oxygen_callables_manage"],
-        gatewayCommands: ["tables create", "columns add", "enrich-column preview", "tables link", "functions list", "functions draft"],
+        gatewayTools: ["oxygen_tables_create", "oxygen_columns_add", "oxygen_columns_catalog", "oxygen_enrich_column_preview", "oxygen_tables_link_bulk", "oxygen_callables_manage"],
+        gatewayCommands: ["tables create", "columns add", "columns catalog", "enrich-column preview", "tables link", "functions list", "functions draft"],
         skills: ["oxygen-gtm", "oxygen-table-tidy", "oxygen-diagnostics", "oxygen-clay-migration", "oxygen-linkedin-marketing"],
         endpointSections: ["action-columns", "callables", "functions", "columns", "company-enrichment", "enrich-column", "enrichment", "projects", "supabase", "table-action-items", "table-action-runs", "table-ingestion-runs", "tables"],
         // "link"/"join"/"connect"/"relate" route here for `tables link`. Added after a
@@ -221,7 +221,12 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         // `tables create` / `columns add` / `enrich-column preview` — none of which
         // do it. The agent only found the right command by grepping the raw 25k-line
         // command manifest, which is not a discovery path a customer has.
-        intentTerms: ["table", "spreadsheet", "rows", "column", "columns", "dataset", "csv", "import", "enrich", "enrichment", "waterfall", "score", "formula", "ai column", "lookup", "link", "link tables", "join", "connect", "relate", "relationship", "function", "functions", "reusable function", "function draft", "function version", "callable"],
+        // "founders" / "parent company" / "cloud provider" / "company research" route
+        // here for `columns catalog`. Added after the 2026-09-16 blind baseline asked
+        // `capabilities search "founders of a company"` and got `route: null` with a
+        // generic sourcing pointer, then hand-wrote four research prompts for
+        // questions the template catalog now answers by key.
+        intentTerms: ["table", "spreadsheet", "rows", "column", "columns", "dataset", "csv", "import", "enrich", "enrichment", "waterfall", "score", "formula", "ai column", "lookup", "link", "link tables", "join", "connect", "relate", "relationship", "function", "functions", "reusable function", "function draft", "function version", "callable", "column template", "skill set", "grad school", "podcast appearance", "keynote", "github profile", "job fit", "founders", "parent company", "subsidiaries", "cloud provider", "company research", "research question", "research column", "web research", "template catalog", "ready-made", "offers demos", "naics"],
     },
     {
         id: "messages",
@@ -838,6 +843,16 @@ function recommendationsFor(card, query) {
                 commands: ["tables watcher preview", "tables watcher create", "tables watcher get", "tables watcher update", "tables watcher pause", "tables watcher resume"],
             };
         }
+        if (isCompanyResearchQuestionIntent(query)) {
+            // A fact the template catalog already answers by key: list the keys first
+            // (free), add the column by key (free), then price and run it. Ahead of
+            // the bare "run" noun below, because "which cloud provider does it run
+            // on" is a question about the company, not about a run.
+            return {
+                tools: ["oxygen_columns_catalog", "oxygen_columns_add", "oxygen_columns_run", "oxygen_tables_describe"],
+                commands: ["columns catalog", "columns add", "columns run", "tables describe"],
+            };
+        }
         if (/\b(table )?(action )?runs?\b/.test(query)) {
             return {
                 tools: ["oxygen_table_runs_get", "oxygen_table_runs_items", "oxygen_table_runs_wait", "oxygen_table_runs_retry_failed"],
@@ -1012,6 +1027,16 @@ function isEmailVerificationIntent(query) {
 // ask ("find companies with a website in Germany") keeps its owner. LinkedIn
 // page recovery is deliberately left to the LinkedIn rules above it, which
 // already resolve company pages through the public-research catalog.
+/**
+ * A company fact the template catalog answers by key — founders, parent company,
+ * subsidiaries, cloud provider, NAICS, demos — and the "ready-made / template
+ * catalog / research question" phrasing itself. Kept to nouns no other card
+ * owns: "funding" alone belongs to Signals and "industry" alone to company
+ * search, so both stay off this list.
+ */
+function isCompanyResearchQuestionIntent(query) {
+    return /\b(founders?|founded by|parent compan(?:y|ies)|subsidiar(?:y|ies)|cloud provider|naics|column templates?|template catalog|ready[- ]made|research question|company research|offers? demos?|gives? demos?)\b/.test(query);
+}
 function isCompanyUrlRecoveryIntent(query) {
     const urlNoun = /\b(websites?|web ?sites?|website urls?|domains?|urls?|homepages?)\b/;
     const companyNoun = /\b(compan(?:y|ies)|accounts?|organi[sz]ations?|brands?|vendors?)\b/;

package/node_modules/@oxygen/shared/dist/column-output-fields.js

@@ -26,7 +26,7 @@
  * may contain a dot or a space. Such a field carries `referenceable: false` and
  * is display-only.
  */
-import { buildResearchCellSchema, deriveResearchOutputContract, usesServerManagedResearchSchema, } from "./research-output-contract.js";
+import { buildResearchCellSchema, isResearchEnvelopeSchema, researchEvidenceRequired, deriveResearchOutputContract, usesServerManagedResearchSchema, } from "./research-output-contract.js";
 import { isTemplateSafePath, parseJsonPath, readJsonPath } from "./json-path.js";
 const MAX_FIELDS = 40;
 const MAX_SCHEMA_DEPTH = 5;
@@ -263,13 +263,21 @@ function researchContract(definition) {
     const prompt = readString(definition.prompt) ?? "";
     const webSearch = isRecord(definition.webSearch) ? definition.webSearch : null;
     const contract = deriveResearchOutputContract(prompt, {
-        evidenceRequired: webSearch?.evidenceMode === "strict",
+        evidenceRequired: researchEvidenceRequired(webSearch),
     });
     // The STORED shape, not the model-facing one: a research cell carries
-    // `sources`, never the `citations` the model answered with.
+    // `sources`, never the `citations` the model answered with. A column whose
+    // own schema is still the research envelope (a catalog template's typed
+    // answer) gets the same rewrite, so `answer.plan_count` is offered and
+    // `citations` is not; a hand-authored schema that replaced the envelope is
+    // used verbatim, because the cell then holds exactly what it declares.
     const schema = serverManaged
         ? buildResearchCellSchema(contract)
-        : (isRecord(definition.outputSchema) ? definition.outputSchema : null);
+        : isRecord(definition.outputSchema)
+            ? (isResearchEnvelopeSchema(definition.outputSchema)
+                ? buildResearchCellSchema(null, definition.outputSchema)
+                : definition.outputSchema)
+            : null;
     if (!schema)
         return EMPTY_CONTRACT;
     return {

package/node_modules/@oxygen/shared/dist/copilot-playbooks.d.ts

@@ -0,0 +1,18 @@
+export type CopilotPlaybookSlug = "tam-sourcing" | "linkedin-content-strategy" | "inbound-led-outbound" | "signal-based-outbound";
+export type CopilotPlaybook = {
+    /**
+     * The skill slug the Copilot loads through its `skills` tool, and the
+     * `name:` in the playbook file's frontmatter. The two are gated equal.
+     */
+    slug: CopilotPlaybookSlug;
+    /** Customer-facing name, exactly as it is spoken in the composer prompt and shown on the Home chip. */
+    title: string;
+};
+export declare const COPILOT_PLAYBOOKS: readonly CopilotPlaybook[];
+/**
+ * The sentence a Home card writes into the composer. It names the skill the way
+ * a person would say it, and the Copilot's prompt maps that title back to the
+ * slug — so the user reads and sends exactly what the card promised.
+ */
+export declare function copilotPlaybookPrompt(playbook: Pick<CopilotPlaybook, "title">): string;
+export declare function getCopilotPlaybook(slug: string): CopilotPlaybook | null;