@oxygen-agent/cli 1.982.3 → 1.987.20

package/dist/index.js

@@ -12,7 +12,7 @@ import { registerKnowledgeRepositoryCommands } from "./knowledge-repository-comm
 import { registerVisualCommands } from "./visual-commands.js";
 import { renderPrimaryProviderBoard } from "./admin-primary-providers-render.js";
 import { registerFunctionsCommands } from "./functions-commands.js";
-import { applyOxygenHelp } from "./help.js";
+import { applyOxygenHelp, enableCommandSuggestions, unknownCommandHint } from "./help.js";
 import { buildCommandManifest, getCommandManifestEntry, searchCommandManifest, suggestCommandNames, } from "./command-manifest.js";
 import { AGENCY_DIRECTORY_REGIONS, AGENCY_DIRECTORY_SERVICES, COLLAB_GATE_KINDS, COLLAB_GATE_PROSE, COLLAB_SUBJECT_KINDS, COLLAB_SUBJECT_KINDS_PROSE, COLLAB_SUBJECT_LABELS, COLLAB_SUBJECT_PROSE, GATE_KIND_SUBJECTS, describeWorkflowStatusChange, formatCellForDisplay, formatCopilotPlanDuration, formatCopilotPlanSeconds, formatPublicBudgetScopes, SUBJECT_PATH_FORMS_PROSE, formatSubjectPath, exitCodeForOxygenError, parseSubjectPath, parseSubjectRef, parseWorkflowStatusChange, isVersionGreater, isVersionLess, KNOWLEDGE_BOOTSTRAP_MAX_CREDITS, MAX_CLI_JSON_BODY_BYTES, MAX_MCP_TOOL_NAME_LENGTH, normalizeCopilotPlanStepStatus, OXYGEN_CAPABILITY_ROUTES, OXYGEN_VERSION, OxygenError, getCapabilityRouteMatch, inferUserCapabilityRoute, parseKnowledgePageMarkdown, PLAN_LIMITS, serializeCapabilityRoute, sleep, success, TABLE_IMPORT_ROW_LIMIT, TAG_KINDS_PROSE, toFailure, workflowMcpToolName, } from "@oxygen/shared";
 import { TAG_COLORS } from "@oxygen/shared/select-options";
@@ -3221,9 +3221,9 @@ export function createProgram() {
         .description("What this workspace actually contains: the newest tables, CRM objects, sequences, workflows, agents, wiki pages, posts and projects, each with its id, last activity, tags and link. Read-only, 0 credits. Capability search tells you what OXYGEN can do; this tells you what is here.")
         .option("--kind <kinds>", "Comma-separated kinds to include: table, crm_object, sequence, workflow, agent, knowledge_page, post, project.")
         .option("--tag <tag>", "Only objects carrying this workspace tag. Answered by the Tags footprint read, so it also covers kinds this map does not model.")
-        .option("--query <text>", "Match on name, slug, or tag.")
+        .option("--query <text>", "Match on name, slug, or tag within each kind's scanned window; a kind with `capped: true` may hold older matches this did not search.")
         .option("--json", "Print a JSON envelope.")
-        .addHelpText("after", "\nEach kind returns its newest few objects under a character budget the payload echoes back; `capped` says when a kind holds more than the scan saw. Hydrate one object with its own primitive's read (`oxygen tables describe`, `oxygen workflows get`, `oxygen knowledge page get`).\n\nRead-only means read-only: the map creates nothing in your workspace in order to answer, so an empty wiki reports zero pages rather than a starter set this command seeded. Use `oxygen knowledge index` when you do want the starter wiki created.\n")
+        .addHelpText("after", "\nEach kind returns its newest few objects under a character budget the payload echoes back; `capped` says when a kind holds more than the scan saw. It is a snapshot, not a rollup: per-folder table counts come from `oxygen projects list` (`tableCount`). Hydrate one object with its own primitive's read (`oxygen tables describe`, `oxygen workflows get`, `oxygen knowledge page get`).\n\nRead-only means read-only: the map creates nothing in your workspace in order to answer, so an empty wiki reports zero pages rather than a starter set this command seeded. Use `oxygen knowledge index` when you do want the starter wiki created.\n")
         .action(async (options) => {
         await handleAsyncAction("workspace map", options, async () => {
             const params = new URLSearchParams();
@@ -3408,7 +3408,7 @@ export function createProgram() {
         await handleAsyncAction("orgs billing-owners", options, () => requestOxygen("/api/cli/orgs/billing-owners"));
     }))
         .addCommand(new Command("billing-link")
-        .description("Cover a workspace with a plan you already pay for in another organization (one plan, many workspaces) instead of buying a second subscription. Omit --owner when exactly one of your organizations can pay and Oxygen will use it; `orgs billing-owners` lists them all. Credit billing moves, workspace data access does not.")
+        .description("Cover a workspace with a plan you already pay for in another organization (one plan, many workspaces) instead of buying a second subscription. Omit --owner when exactly one of your organizations can pay and Oxygen will use it; `orgs billing-owners` lists them all. You must be an admin of BOTH organizations, the workspace being linked must not hold a live subscription of its own, and an org-bound key (oxy_live_…) can only link the workspace it is bound to. Credit billing moves, workspace data access does not; plan gates and sending seats then resolve through the owner, so the linked workspace connects senders against the owner's seats and seats are bought there. `plan_tier` in the response is the plan the workspace now runs on; `free` means the owner holds no active paid plan, so connecting senders stays blocked.")
         .option("--owner <organization>", "Billing owner organization id, Clerk org id, or slug. Optional — when omitted, Oxygen uses your one eligible organization, and refuses to pick if there is more than one.")
         .option("--organization <organization>", "Workspace organization to link. Defaults to the active organization.")
         .option("--organization-id <id>", "Alias for --organization.")
@@ -4049,13 +4049,13 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .command("projects")
         .description("Manage table folders (projects). Inspect contents with `oxygen tables list --project <project>`.")
         .addCommand(new Command("list")
-        .description("List table projects in the current tenant database.")
+        .description("List table projects (folders) with each one's active table count (`tableCount`), so empty and oversized folders show without listing every folder's tables. Free.")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
         await handleAsyncAction("projects list", options, () => requestOxygen("/api/cli/projects"));
     }))
         .addCommand(new Command("create")
-        .description("Create a schema-backed table project.")
+        .description("Create a schema-backed table project (folder). Free. Group tables into it with `oxygen tables move <tables...> --project <folder>`.")
         .argument("<name>", "Display name for the project.")
         .option("--json", "Print a JSON envelope.")
         .action(async (name, options) => {
@@ -5656,7 +5656,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--limit <n>", "Maximum tables to list. Defaults to 200; hard cap is 1000.")
         .option("--all", "List every table instead of the newest window.")
         .option("--json", "Print a JSON envelope.")
-        .addHelpText("after", "\nLists the 200 newest tables by default; `capped` in the JSON envelope says when there are more.\n")
+        .addHelpText("after", "\nLists the 200 newest tables by default; `returned` in the JSON envelope is the count in this response and `capped` says when there are more (pass --all for every table). Per-folder totals live on `oxygen projects list` (`tableCount`). `oxygen workspace map --kind table --query <text>` finds a recent table by name but searches only the 200 newest tables (its `capped` says when older ones were not searched); to match a name across every table, read `oxygen tables list --all --json`.\n")
         .action(async (options) => {
         await handleAsyncAction("tables list", options, async () => {
             const params = new URLSearchParams();
@@ -5863,14 +5863,17 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         }));
     }))
         .addCommand(new Command("move")
-        .description("Move a workspace table to a different project.")
-        .argument("<table>", "Table id or slug.")
-        .requiredOption("--project <project>", "Destination project id or slug.")
+        .description("Move one or more workspace tables into a project (folder) in one call. Rows, columns, runs, and provenance are preserved. Free; reverse it by moving the table back.")
+        .argument("<tables...>", "Table ids or slugs; several move together, each reported separately.")
+        .requiredOption("--project <project>", "Destination project id or slug (see `oxygen projects list`).")
         .option("--json", "Print a JSON envelope.")
-        .action(async (table, options) => {
+        .action(async (tables, options) => {
         await handleAsyncAction("tables move", options, () => requestOxygen("/api/cli/tables/move", {
             method: "POST",
-            body: { table, project: options.project },
+            body: {
+                ...(tables.length === 1 ? { table: tables[0] } : { tables }),
+                project: options.project,
+            },
         }));
     }))
         .addCommand(new Command("recover-pending")
@@ -7803,7 +7806,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
     ].join("\n"));
     program
         .command("recipes")
-        .description("Business-case GTM playbooks: proven plays with prerequisites, credit posture, and approval gates spelled out.")
+        .description("Business-case GTM playbooks: proven plays with prerequisites, credit posture, and approval gates spelled out. Whole-motion operator playbooks (TAM sourcing, LinkedIn content strategy, inbound-led outbound, signal-based outbound) are the oxygen-playbooks skill: oxygen skills get oxygen-playbooks --json.")
         .addCommand(new Command("list")
         .description("List recipes, optionally filtered by text, business-case category, journey stage, or audience.")
         .argument("[query]", "Search text (matches slug/title/business case/tags).")
@@ -7973,12 +7976,12 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
     }));
     program
         .command("columns")
-        .description("Workspace table column commands.")
+        .description("Workspace table column commands. Ready-made templates (pricing pages, job posts, event pages, 10-Ks, website facts, market questions, text extraction, plus free 0-credit cleanups — company names, job titles, email type, text to list; person questions over an enriched LinkedIn profile and person appearances; company research questions — founders, parent company, funding, cloud provider, offers demos, industry, NAICS, HQ and footprint, LinkedIn/Crunchbase/careers page lookups): `columns catalog`, then `columns add <table> --prompt-key <key> --input <name>=<column>`. Column choice and provider routing guide: the oxygen-gtm skill's enriching-and-researching.md (`oxygen skills install`). With --json parse stdout only: the envelope is stdout, and the spend and cost notes (`estimated N credits for a live run`) are stderr, so merging the streams breaks the JSON.")
         .addCommand(new Command("add")
-        .description("Add a nullable column to a workspace table. Writes the definition only — this never runs the column and never spends credits; use `columns run` for that, with --dry-run first to see the cost.")
+        .description("Add a nullable column to a workspace table. Writes the definition only — this never runs the column and never spends credits; use `columns run` for that, with --dry-run first to see the cost. For a page, posting or filing the row already links to, or a company fact Oxygen already knows how to research (founders, parent company, funding, cloud provider, offers demos, industry, NAICS, HQ, a LinkedIn or Crunchbase page), pick a template from `columns catalog` (--prompt-key) instead of writing a prompt; or read a URL column with --kind research --research-url. The guide is the oxygen-gtm skill's enriching-and-researching.md. A formula column needs no run at all: it evaluates on read from its current inputs, so `tables query` shows its values immediately.")
         .argument("<table>", "Table id or slug.")
-        .option("--preset <preset>", "Add a pre-built enrichment bundle instead of one column: `person_enrich` (one LinkedIn profile lookup, then headline, bio, location and followers for free) or `company_enrich` (domain, LinkedIn page, headcount, industry and full profile, cascading across providers until one answers). Oxygen finds the identity column itself — override with --input. Creating the columns is free; run them afterwards, --dry-run first.")
-        .option("--input <slot=column...>", "Bind a preset input to an exact column, e.g. --input url=linkedin_url, or --input company_name=account --input domain=website. Repeatable. Only needed when the automatic match is wrong or missing.", collectRepeatable, [])
+        .option("--preset <preset>", "Add a pre-built column bundle instead of one column: `person_enrich` (one LinkedIn profile lookup, then headline, bio, location and followers for free), `company_enrich` (domain, LinkedIn page, headcount, industry and full profile, cascading across providers until one answers), or `domain_check` (1 credit/row for a live/redirect/parked/not_found/dead verdict on every domain, cached 30 days, plus a free label column to filter on). For a single cleaned or classified column, use a template from `columns catalog` instead — that is one column, not a bundle. Oxygen finds the identity column itself — override with --input. Creating the columns is free; run them afterwards, --dry-run first.")
+        .option("--input <slot=column...>", "Bind a preset or template input to an exact column, e.g. --input url=pricing_url with --prompt-key, or --input company_name=account --input domain=website with --preset. Repeatable. For a preset it is only needed when the automatic match is wrong or missing; for a template it names the column each declared input reads.", collectRepeatable, [])
         .option("--capability <capability>", "Seed a ready-to-run enrichment column WITHOUT running it (0 credits): verify_email grades the address a row already holds \u2014 MillionVerifier first, catch-all domains escalate to BounceBan; work_email, mobile_phone and linkedin_url find a value the row is missing through the managed waterfall. Sets kind=enrichment and jsonb; label and key default from the capability. Preview cost with `enrich-column preview --capability <same>` and run later with `enrich-column run --approved --max-credits <n>`.")
         .option("--label <label>", "Display label for the new column. Required unless --prompt-key or --capability supplies a default title.")
         .option("--key <key>", "Optional stable column key. Defaults to a normalized label.")
@@ -7992,9 +7995,10 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--research-exclude-domains <csv>", "Research columns: comma-separated domains to exclude from results.")
         .option("--research-mode <mode>", "Research columns: how tightly the answer is bound to the sources. Default: summarize and combine what they say. strict: answer only from what a source states verbatim (for figures and identifiers). estimate: reason to a figure from the evidence (for revenue or headcount).")
         .option("--research-results <n>", "Research columns: how many search results to ground each row on (1-25, default 5). More evidence costs no extra search, but a larger prompt.")
-        .option("--research-engine <engine>", "Research columns: pin the search provider (exa, parallel, or firecrawl). Defaults to exa, falling back automatically. Most users should not set this.")
-        .option("--prompt-key <key>", "OXYGEN prompt-library key (e.g. email_draft_v1). Materializes prompt + output_schema and forces kind=ai.")
-        .option("--input-mapping <json>", "Required with --prompt-key. JSON object mapping prompt input names to column or literal refs. Copy templates (email_draft_v1, subject_line_variants_v1, ...) reject mappings built only from manual name/title/company columns — ground them on a research or enrichment column, or write a freeform prompt with --prompt instead.")
+        .option("--research-engine <engine>", "Research columns: pin the search provider (exa, parallel, or firecrawl), or with --research-url the page-fetch provider (firecrawl, linkup, or exa). Defaults to exa for search and firecrawl for fetch, falling back automatically. Most users should not set this.")
+        .option("--research-url <column_key>", "Research columns: read the ONE page whose URL is in this column for each row instead of searching the web — a pricing page, a job posting, an event page, a 10-K. The page's content is the only evidence, the answer cites it as its source, and the row costs the fetch plus the model (see --dry-run). A URL ending in .pdf is read by the PDF-capable fetch lane first.")
+        .option("--prompt-key <key>", "Add a column template from `oxygen columns catalog` (e.g. pricing_plan_summary_v1 reads a pricing-page URL column and returns plan count, price range and enterprise plan; company_founders_v1 reads a domain column and returns the founders with sources; person_skill_set_v1 reads the person_enrich payload column with --input profile=person_enrich). Materializes the template's prompt, output schema and grounding and sets its kind (ai, research, formula, or search — a managed web search whose cell is a page URL). Bind each declared input with --input <name>=<column_key>.")
+        .option("--input-mapping <json>", "JSON alternative to --input for --prompt-key: an object mapping template input names to columns, e.g. '{\"url\":{\"column\":\"pricing_url\"}}' (a bare column-key string or {\"literal\": ...} also works). Copy templates (email_draft_v1, subject_line_variants_v1, ...) reject mappings built only from manual name/title/company columns — ground them on a research or enrichment column, or write a freeform prompt with --prompt instead.")
         .option("--model <id>", "AI column model id (e.g. claude-sonnet-4-5). Explicit models require credentialMode byok unless allow-listed managed.")
         .option("--reasoning-level <level>", "AI column reasoning level: low, medium, or high (shown in the web UI as Oxygen Fast, Oxygen Balanced, and Oxygen Max).")
         .option("--run-condition <formula>", "Formula expression gating whether the AI column runs per row. A formula over bare column keys (eu_israel = true), not {{tokens}}.")
@@ -8069,8 +8073,9 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
             if (!options.promptKey && !capability && !options.label) {
                 throw new OxygenError("invalid_request", "--label is required.", { exitCode: 1 });
             }
-            if (options.promptKey && !options.inputMapping) {
-                throw new OxygenError("missing_input_mapping", "--input-mapping is required when --prompt-key is provided.", { exitCode: 1 });
+            const templateInputs = options.promptKey ? parseKeyValuePairs(options.input ?? []) : {};
+            if (options.promptKey && !options.inputMapping && Object.keys(templateInputs).length === 0) {
+                throw new OxygenError("missing_input_mapping", `--prompt-key ${options.promptKey} reads named inputs; bind each one to a column with --input <name>=<column_key> (e.g. --input url=pricing_url), or pass --input-mapping <json>. See \`oxygen columns catalog\` for the inputs a template reads.`, { exitCode: 1 });
             }
             const prompt = readAiPromptOption(options.prompt);
             if (prompt !== null && options.promptKey) {
@@ -8185,8 +8190,14 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
             const body = { table, column };
             if (options.promptKey)
                 body.prompt_key = options.promptKey;
-            if (options.inputMapping)
+            if (options.inputMapping) {
                 body.input_mapping = parseJsonObject(options.inputMapping);
+            }
+            else if (Object.keys(templateInputs).length > 0) {
+                // `--input url=pricing_url` → the same typed column refs the JSON form
+                // carries, so the server sees one shape from both spellings.
+                body.input_mapping = Object.fromEntries(Object.entries(templateInputs).map(([name, columnKey]) => [name, { type: "column", columnKey }]));
+            }
             // Every authoring path, not just --prompt: a definition pasted into
             // --definition-json used to skip this entirely and fail once per row.
             await assertColumnDefinitionReferences(table, column.definition);
@@ -8559,6 +8570,32 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
                 },
             });
         });
+    }))
+        .addCommand(new Command("catalog")
+        .description("List the column templates you can add with `columns add <table> --prompt-key <key>`: the extract templates (pricing-page, job-posting, event, 10-K, website-fact, market and text extractors) and the company research questions (founders, parent company, subsidiaries, funding rounds, market cap, cloud provider, is SaaS, offers demos, industry, NAICS, HQ / states / cities, competitors, LinkedIn / Crunchbase / Glassdoor / careers page lookups) and the person templates (--category people: skill set, grad school, location, job fit and current company read from the person_enrich payload for 15 credits; events, keynotes, podcasts and GitHub profile searched by name), each with the input it reads (bind it with --input <name>=<column_key>), the providers behind it, the answer fields, and the credits per row. Read-only and free.")
+        .option("--category <category>", "Only templates in one picker section: extract (page and text extraction), normalize, organize, summarize (free cleanups and classifications), people (person questions and appearances) or company (company research questions); comma-separate to combine (extract,people). The outreach prompts sit under copy, scoring, qa, research.")
+        .option("--family <family>", "Only one family. Extract: pricing, job_posting, events, filings, site_facts, market, portfolio, text_extraction. Cleanups: company, person, email, lists, classification. Company: web_presence, corporate_structure, funding, footprint, business_model, tech, market. People: profile, appearances.")
+        .option("--kind <kind>", "Only one column kind: research (reads the web or a page, answer with sources), search (a managed web search whose cell is a page URL or the result list, fixed price), ai (reads row text), or formula (free).")
+        .option("--search <term>", "Match a word against template keys, titles and descriptions, e.g. pricing or 10-K.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("columns catalog", options, async () => {
+            const params = new URLSearchParams();
+            for (const [name, value] of [
+                ["category", readOption(options.category)],
+                ["family", readOption(options.family)],
+                ["kind", readOption(options.kind)],
+                ["search", readOption(options.search)],
+            ]) {
+                if (value)
+                    params.set(name, value);
+            }
+            const query = params.toString();
+            const result = await requestOxygen(`/api/cli/tables/columns/catalog${query ? `?${query}` : ""}`, { method: "GET" });
+            if (!options.json)
+                printColumnCatalog(result);
+            return result;
+        });
     }))
         .addCommand(new Command("deps")
         .description("Show the column dependency graph: which columns feed which (formulas, input mappings, run conditions, waterfall targets), transitive up/downstream, and cycles. Read-only.")
@@ -8625,7 +8662,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .command("formulas")
         .description("Formula language for formula columns and per-column run conditions (only-run-if).")
         .addCommand(new Command("functions")
-        .description("List every formula function (name, signature, examples) and the operator grammar. The same language powers formula columns and --run-condition gates.")
+        .description("List every formula function (name, signature, examples), the operator grammar, and the expression_notes that a signature cannot teach (bare column keys, string escapes, no regex flags, read-time evaluation). The same language powers formula columns and --run-condition gates.")
         .option("--category <category>", "Filter by category: logic, string, number, date, url_email, array, json, null_handling, cross_row.")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
@@ -9099,6 +9136,22 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .description("Company prospecting and account enrichment workflows.")
         .addCommand(new Command("search")
         .description("Plan, dry-run, or queue provider-backed company search.")
+        .addCommand(new Command("filters")
+        .description("List Company Search filter fields and options without a provider call.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("companies search filters", options, () => requestOxygen("/api/cli/companies/search/preview"));
+    }))
+        .addCommand(new Command("preview")
+        .description("Preview up to 50 companies free, using native filters from companies search filters.")
+        .requiredOption("--filters-json <json-or-file>", 'Nested native filters as JSON or @file/path, e.g. {"employee_count":{"min":10}}; {} searches all.')
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("companies search preview", options, () => requestOxygen("/api/cli/companies/search/preview", {
+            method: "POST",
+            body: { filters: parseJsonObject(readFileIfPresent(options.filtersJson)) },
+        }));
+    }))
         .addCommand(new Command("plan")
         .description("Compile a company-search prompt into ordered provider routes without provider calls. To turn a list of company NAMES into websites or domains, pass --source-intent url_recovery (e.g. --prompt \"Find the websites for these companies: <names>\" --source-intent url_recovery). The plan carries provider_availability: a route on a benched managed provider reads degraded with a next_action.")
         .argument("[prompt]", "Prompt text or @file (same as --prompt). The --prompt flag wins if both are given.")
@@ -9118,7 +9171,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--founded <range>", "Founded year range: 2015-2024, 2020+, or -2010.")
         .option("--lookalike <csv>", "Comma-separated lookalike company domains.")
         .option("--estimate", "Run a free server-side preflight pass: resolves provider enums and a free count probe for an estimated match count (zero credits).")
-        .option("--materialize-preview", "Create a preview table with route rows.")
+        .option("--materialize-preview", "Create a route-plan table, without company results. For free company rows use companies search preview.")
         .option("--json", "Print a JSON envelope.")
         .action(async (promptArg, options) => {
         await handleAsyncAction("companies search plan", options, () => requestOxygen("/api/cli/companies/search/plan", {
@@ -9128,6 +9181,8 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
     }))
         .addCommand(new Command("run")
         .description("Return a dry-run request or queue a live company-search ingestion run.")
+        .option("--source <source>", "Use company_search with --source-filters-json instead of a prompt or plan.")
+        .option("--source-filters-json <json-or-file>", 'Same nested filters as the free preview, e.g. {"employee_count":{"min":10}}; use with --source company_search.')
         .argument("[prompt]", "Prompt text or @file (same as --prompt). The --prompt flag wins if both are given.")
         .option("--prompt <text-or-file>", "Company-search prompt, or a path to a prompt file.")
         .option("--plan-json <json-or-file>", "Plan JSON returned by companies search plan, or a path to a JSON file.")
@@ -9186,7 +9241,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .argument("<table>", "Table id or slug.")
         .option("--missing-fields <fields>", "Comma-separated fields to fill.")
         .option("--providers <providers>", "Comma-separated provider pool.")
-        .option("--mode <mode>", "dry_run or live. Defaults to live.")
+        .option("--mode <mode>", "dry_run or live. Defaults to live. dry_run returns the same plan as `companies enrich preview` and creates no column; only a live run creates the target columns it fills. To attach a company field for free and run it later, bind the OXYGEN-managed Function instead (`functions list --managed`, then `functions bind`).")
         .option("--max-credits <n>", "Required credit ceiling for live runs.")
         .option("--approved", "Approve this live paid run after inspecting the preview.")
         .option("--all", "Run on all rows.")
@@ -9209,7 +9264,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .description("Plan, dry-run, or queue provider-backed people/contact search.")
         .addCommand(new Command("plan")
         .description("Compile a people-search prompt and optional typed persona filters into ordered provider routes without provider calls.")
-        .requiredOption("--prompt <text-or-file>", "People-search prompt, or a path to a prompt file.")
+        .option("--prompt <text-or-file>", "People-search prompt, or a path to a prompt file. Required unless --from-table names the companies to source employees from.")
         .option("--target-count <n>", "Desired contact count. Single-plan ceiling 50,000; larger requests return an explicit clamp warning and segmentation guidance.")
         .option("--source-intent <intent>", "Override detected intent: persona_search, account_contacts, audience_sizing, profile_lookup, concept_persona, or fallback_broad.")
         .option("--filters-json <json-or-file>", "PeopleSearchFilters JSON inline or a @file/path; wins over individual flags per top-level filter path.")
@@ -9219,7 +9274,15 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--exclude-titles <csv>", "Comma-separated job titles to exclude.")
         .option("--seniorities <csv>", "Comma-separated seniority levels: C-Suite, VP, Director, Manager, Staff.")
         .option("--departments <csv>", "Comma-separated departments/functions: Sales, Marketing, Engineering, ...")
+        .option("--job-functions <csv>", PEOPLE_SEARCH_JOB_FUNCTIONS_HELP)
         .option("--countries <csv>", "Comma-separated ISO 3166-1 alpha-2 person country codes.")
+        .option("--continents <csv>", PEOPLE_SEARCH_CONTINENTS_HELP)
+        .option("--sales-regions <csv>", PEOPLE_SEARCH_SALES_REGIONS_HELP)
+        .option("--min-connections <n>", PEOPLE_SEARCH_MIN_CONNECTIONS_HELP)
+        .option("--from-table <table>", PEOPLE_SEARCH_FROM_TABLE_HELP)
+        .option("--linkedin-url-column <key>", PEOPLE_SEARCH_LINKEDIN_COLUMN_HELP)
+        .option("--company-offset <n>", PEOPLE_SEARCH_COMPANY_OFFSET_HELP)
+        .option("--company-limit <n>", PEOPLE_SEARCH_COMPANY_LIMIT_HELP)
         .option("--keywords <csv>", "Comma-separated free-text persona keywords.")
         .option("--company-domains <csv>", "Comma-separated company domains to scope contacts to.")
         .option("--company-names <csv>", "Comma-separated company names to scope contacts to.")
@@ -9247,7 +9310,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--project <project>", "Folder (project) id or slug the created table lands in. Ignored with --table. Defaults to the workspace default folder.")
         .option("--upsert-key <column>", "Column key used for live upsert. Must match the plan upsert key (linkedin_url).")
         .option("--mode <mode>", "dry_run or live. Defaults to dry_run.")
-        .option("--max-pages <n>", "Maximum provider pages to ingest. Defaults to the route estimate.")
+        .option("--max-pages <n>", "Maximum provider pages to ingest. Defaults to the route estimate. With --from-table it means pages per company.")
         .option("--max-credits <n>", "Required credit ceiling for live runs.")
         .option("--target-count <n>", "Desired contact count when planning from --prompt. Single-plan ceiling 50,000.")
         .option("--source-intent <intent>", "Override detected intent when planning from --prompt.")
@@ -9258,7 +9321,16 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--exclude-titles <csv>", "Comma-separated job titles to exclude when planning from --prompt.")
         .option("--seniorities <csv>", "Comma-separated seniority levels when planning from --prompt.")
         .option("--departments <csv>", "Comma-separated departments/functions when planning from --prompt.")
+        .option("--job-functions <csv>", PEOPLE_SEARCH_JOB_FUNCTIONS_HELP)
         .option("--countries <csv>", "Comma-separated ISO 3166-1 alpha-2 person country codes when planning from --prompt.")
+        .option("--continents <csv>", PEOPLE_SEARCH_CONTINENTS_HELP)
+        .option("--sales-regions <csv>", PEOPLE_SEARCH_SALES_REGIONS_HELP)
+        .option("--min-connections <n>", PEOPLE_SEARCH_MIN_CONNECTIONS_HELP)
+        .option("--from-table <table>", PEOPLE_SEARCH_FROM_TABLE_HELP)
+        .option("--linkedin-url-column <key>", PEOPLE_SEARCH_LINKEDIN_COLUMN_HELP)
+        .option("--company-offset <n>", PEOPLE_SEARCH_COMPANY_OFFSET_HELP)
+        .option("--company-limit <n>", PEOPLE_SEARCH_COMPANY_LIMIT_HELP)
+        .option("--pages-per-company <n>", "Alias for --max-pages on a --from-table run: provider pages per company, 50 people per page.")
         .option("--keywords <csv>", "Comma-separated persona keywords when planning from --prompt.")
         .option("--company-domains <csv>", "Comma-separated company domains when planning from --prompt.")
         .option("--company-names <csv>", "Comma-separated company names when planning from --prompt.")
@@ -11595,7 +11667,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         await handleAsyncAction("senders checkpoints", options, () => requestOxygen("/api/cli/senders/checkpoints"));
     }))
         .addCommand(new Command("connect")
-        .description("Get a Unipile hosted-auth URL to connect a new LinkedIn account (or reconnect with --reconnect). New accounts require --country (the owner's normal LinkedIn login country) and default to syncing only conversations OXYGEN starts; use --inbox-scope all to opt into the full LinkedIn inbox. Use --cookie-auth and --custom-proxy to expose those inputs inside Unipile's hosted wizard; their secrets never pass through OXYGEN. Use --count for bulk onboarding. Links are shareable and valid for 10 minutes.")
+        .description("Get a Unipile hosted-auth URL to connect a new LinkedIn account (or reconnect with --reconnect). Each connected LinkedIn account occupies one LinkedIn sending seat — $30/month, billed in dollars on the billing owner's seat subscription — unless the billing owner still has grandfathered LinkedIn capacity; check `oxygen billing seats --json` before connecting, and a workspace linked to another organization's plan draws on that organization's seats. New accounts require --country (the owner's normal LinkedIn login country) and default to syncing only conversations OXYGEN starts; use --inbox-scope all to opt into the full LinkedIn inbox. Use --cookie-auth and --custom-proxy to expose those inputs inside Unipile's hosted wizard; their secrets never pass through OXYGEN. Use --count for bulk onboarding. Links are shareable and valid for 10 minutes.")
         .option("--reconnect <connection_id>", "Reconnect an existing connection instead of creating a new one. Accepts a connection id.")
         .option("--country <code>", "Required for new accounts: ISO 3166-1 alpha-2 code for the account owner's normal LinkedIn login country (for example DE or US).")
         .option("--sales-nav", "Request Classic + Sales Navigator access during Unipile hosted authentication.")
@@ -12673,14 +12745,14 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     })));
     program.addCommand(new Command("inbox")
-        .description("Unified inbox (unibox): private email + LinkedIn DM + WhatsApp conversations in one stream (--channel all), or a single channel. Public comments on owned LinkedIn posts are not inbox messages; use `publishing comments`. Scan, read threads, and reply.")
+        .description("Unified inbox (unibox): private email + LinkedIn DM + WhatsApp conversations in one stream (the default), or a single channel with --channel; `get` and `send` resolve a conversation's channel from its id. Public comments on owned LinkedIn posts are not inbox messages; use `publishing comments`. Scan, read threads, and reply.")
         .addCommand(new Command("list")
-        .description("List conversations newest first. --channel all merges email + LinkedIn + WhatsApp into one stream (narrow it with --channels); --channel email/linkedin/whatsapp lists a single channel. Primary excludes the negative tier (not_now, not_interested, lost, bounced); All includes every ordinary conversation.")
-        .option("--channel <channel>", "Inbox channel: all (merged), linkedin (default), whatsapp, or email.")
-        .option("--channels <list>", "channel=all only: comma-separated channel groups to include (email,linkedin,whatsapp). Empty = all three.")
+        .description("List conversations newest first across email, LinkedIn, and WhatsApp — the merged stream is the default, --channels narrows it, and --channel email/linkedin/whatsapp lists a single channel. Primary excludes the negative tier (not_now, not_interested, lost, bounced); All includes every ordinary conversation.")
+        .option("--channel <channel>", "Inbox channel: all (default, the merged stream), email, linkedin, or whatsapp.")
+        .option("--channels <list>", "Narrow the merged stream: comma-separated channel groups to include (email,linkedin,whatsapp). Implies --channel all.")
         .option("--account <id>", "LinkedIn only: filter to one sender account (sender id, connection id, or Unipile account id).")
         .option("--unread", "Only show conversations with unread messages.")
-        .option("--unanswered", "Only conversations awaiting YOUR reply — the last message in the thread is inbound. Cross-channel. Off by default: an unfiltered list still shows answered threads. (The web Unibox turns this on by default for its Primary tab.)")
+        .option("--unanswered", "Only conversations awaiting YOUR reply — the last message in the thread is inbound. Cross-channel. Off by default: an unfiltered list still shows answered threads. (The web Unibox turns this on by default for its Primary tab.) It includes inbound mail no campaign sent — unsolicited or spam — so for replies to your outreach add --sequence-id; the ids and per-campaign counts are in sidebar_counts.byCampaign of the same --json response.")
         .option("--responses-only", "Email only: only conversations with an inbound reply (never sent-only threads).")
         .option("--bucket <bucket>", "Email only: primary or others (superseded by --segment).")
         .option("--segment <segment>", "Top tab: primary (everything but the negative status tier), all, or an email-only folder (others, sent, warmup, dmarc).")
@@ -12696,7 +12768,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--search <text>", "Fuzzy search (typos, word order, prefixes) over names, addresses, subjects and the text of every message in EVERY non-warmup conversation: all channels unless --channel narrows, archived and sent-only threads included. --segment, --unanswered and the Primary tab's negative-tier exclusion are ignored while set; explicit facets such as --status still narrow.")
         .option("--include-archived", "Include archived conversations.")
         .option("--limit <n>", "Maximum conversations to return (1-200). Defaults to 50.")
-        .option("--cursor <cursor>", "channel=all only: the previous page's next_cursor — resumes the merged stream after that row.")
+        .option("--cursor <cursor>", "Merged stream only: the previous page's next_cursor — resumes after that row.")
         .option("--no-counts", "channel=all only: skip the sidebar facet counts for a faster paged read (total_conversations/unread_conversations/sidebar_counts omitted from the envelope). Other channels ignore it.")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
@@ -12750,9 +12822,9 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     }))
         .addCommand(new Command("get")
-        .description("Get one conversation with its full message thread. <conversation> accepts a conversation id, Unipile chat id, or (email) Zapbox thread id.")
+        .description("Get one conversation with its full message thread. <conversation> accepts a conversation id, Unipile chat id, or (email) Zapbox thread id, and is resolved on any channel by default (email first, then LinkedIn/WhatsApp).")
         .argument("<conversation>", "Conversation id, Unipile chat id, or Zapbox thread id.")
-        .option("--channel <channel>", "Inbox channel: linkedin (default), whatsapp, or email.")
+        .option("--channel <channel>", "Inbox channel: all (default, resolves the id on any channel), email, linkedin, or whatsapp.")
         .option("--message-limit <n>", "Maximum messages to return (1-500). Defaults to 100.")
         .option("--json", "Print a JSON envelope.")
         .action(async (conversation, options) => {
@@ -12769,10 +12841,10 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     }))
         .addCommand(new Command("send")
-        .description("Reply into a conversation. --channel email replies from the conversation's own mailbox (Zapbox/native Gmail/Graph, threaded); --channel whatsapp warm-replies into an existing WhatsApp conversation; default replies into the LinkedIn conversation. Sends a real message — requires --approved. Without it, returns a preview.")
+        .description("Reply into a conversation on its own channel, resolved from the conversation when --channel is omitted: an email thread replies from its own mailbox (Zapbox/native Gmail/Graph, threaded); a WhatsApp thread gets a warm reply; a LinkedIn thread replies via Unipile. Sends a real message — requires --approved. Without it, returns a preview.")
         .argument("<conversation>", "Conversation id, Unipile chat id, or (email) Zapbox thread id.")
         .requiredOption("--text <message>", "Reply text to send.")
-        .option("--channel <channel>", "Inbox channel: linkedin (default), whatsapp (warm reply), or email.")
+        .option("--channel <channel>", "Optional: email, linkedin, or whatsapp. Resolved from the conversation when omitted.")
         .option("--approved", "Approve and send the message. Without this flag, returns a preview only.")
         .option("--draft-id <id>", "When approving an AI reply-agent draft (email or LinkedIn), its id (marks it sent on success). Use the matching --channel.")
         .option("--attach <url>", "LinkedIn only: attach a file by public URL (image/document). Repeatable, up to 5.", collectRepeatable, [])
@@ -12902,7 +12974,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     }))
         .addCommand(new Command("sync")
-        .description("Force a backstop inbox sync from Unipile for all active sender accounts (pulls recent chats + messages into the unibox).")
+        .description("Force a backstop inbox sync from Unipile for the active LinkedIn and WhatsApp sender accounts (pulls recent chats + messages into the unibox). Email mailboxes are not synced here: they are polled automatically every worker tick, so email replies reach `inbox list` on their own.")
         .option("--account <id>", "Force-sync one sender account (sender id, connection id, or Unipile account id).")
         .option("--chat-limit <n>", "Maximum chats to sync per account. Defaults to 30.")
         .option("--message-limit <n>", "Maximum messages to sync per chat. Defaults to 20.")
@@ -12923,14 +12995,24 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     }))
         .addCommand(new Command("backfill")
-        .description("Opt-in: pull a LinkedIn account's OLDER message history into the unibox. A SLOW, durable background drip walks each conversation's thread strictly backward — one page per worker tick under a dedicated conservative read budget — so a long history fills in over many days and never burns the account's limits. New messages keep arriving in real time via webhooks; this only backfills old history. No messages are sent and no Oxygen credits are charged.")
+        .description("Opt-in, LinkedIn only: pull a LinkedIn account's OLDER message history into the unibox. A SLOW, durable background drip walks each conversation's thread strictly backward — one page per worker tick under a dedicated conservative read budget — so a long history fills in over many days and never burns the account's limits. New messages keep arriving in real time via webhooks; this only backfills old history. --cancel stops an armed drip. No messages are sent and no Oxygen credits are charged.")
         .option("--account <ref>", "Sender account to backfill (sender id, connection id, or Unipile account id). Omit to backfill every active LinkedIn account.")
         .option("--conversation <ref>", "Scope to a single conversation (conversation id or Unipile chat id).")
+        .option("--cancel", "Cancel the active history backfill drip for --account (or every LinkedIn account) instead of arming one. Messages already mirrored stay.")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
         await handleAsyncAction("inbox backfill", options, () => {
             const account = readOption(options.account);
             const conversation = readOption(options.conversation);
+            if (options.cancel) {
+                if (conversation) {
+                    throw new OxygenError("invalid_request", "--cancel stops a sender's whole drip; it cannot be combined with --conversation. Pass --account (or nothing) with --cancel.", { exitCode: 1 });
+                }
+                return requestOxygen("/api/cli/linkedin/inbox/backfill/cancel", {
+                    method: "POST",
+                    body: { ...(account ? { account } : {}) },
+                });
+            }
             return requestOxygen("/api/cli/linkedin/inbox/backfill", {
                 method: "POST",
                 body: {
@@ -13584,11 +13666,11 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .description("Create a draft multichannel sequence from a steps JSON file. Supports LinkedIn, email, WhatsApp, human call_task, and connected-CRM crm_task journeys. Assign LinkedIn senders with --senders (optional at create — a draft can sit senderless, but enroll/start require at least one for LinkedIn journeys); bind an Instantly email track with --email-*. Install/read the oxygen-sequencer skill for complete mapped CRM task examples.")
         .requiredOption("--name <name>", "Human-readable sequence name.")
         .requiredOption("--slug <slug>", "Unique slug for the sequence.")
-        .requiredOption("--steps-file <path>", "Path to a JSON file: { \"steps\": [...] }. LinkedIn steps (visit_profile | invite | wait_for_connection | message | inmail | follow | like_post | comment_post | withdraw_invite), email steps (email_send | email_enroll | email_move | email_stop), WhatsApp (whatsapp_message), human call tasks (call_task), connected-CRM tasks (crm_task; channel crm; exact identity record_mappings + explicit create/update policy + record_links + dynamic task property_mappings/associations), and control steps (wait | wait_for_signal | branch | stop), each with an `id`. Copy templates support {{column}} interpolation from the lead's row, {{column|fallback}} inline fallbacks, deterministic spintax — {{RANDOM|a|b|c}} or industry-standard bare {Hi|Hey|Hello}, nestable like {Would {Tuesday|Thursday} work|next week?} — and {% if column %}…{% endif %} conditionals; a bare {…} region is spintax only when it contains a top-level |, so literal braces (CSS/JSON) pass through. Native email sends (email_send) also expose three reserved sender variables from the sending mailbox: {{sender_name}} (mailbox display name), {{sender_first_name}} (its first word), and {{sender_email}} (the from address); a row column of the same name WINS on collision, and a missing display name renders empty. comment_post takes text_template and/or ai_prompt — a KG-grounded comment generated at send time (a paid AI call) that falls back to text_template if generation fails. A `branch` routes on signals (then/else) or the legacy connection_accepted/already_connected/open_profile sugar (then_id/else_id). A signal condition can also branch on the LEAD'S DATA: a data leaf { has_column: \"email\" } is true when that row_values column has a non-empty value (add present:false for \"missing\") — e.g. route leads that have an email down an email arm and the rest down a LinkedIn arm. MINIMAL EMAIL STEP SHAPE: { \"id\": \"s1\", \"channel\": \"email\", \"kind\": \"email_send\", \"subject_template\": \"...\", \"body_template\": \"...\" } — body_template is REQUIRED on email_send; subject_template is OPTIONAL and is the one control that decides threading: give a step its own subject and it goes out as a NEW email, omit it and the step continues the lead's previous email in the same thread (what the retired email_reply kind used to be — still accepted on input and rewritten into this shape). The FIRST email step of a sequence must carry a subject, since it has no earlier thread to continue; A/B tests use an explicit `variants` array of copy partials on the step (up to 25 alternates, a–z; spintax varies wording INSIDE one variant and is not A/B-tracked). For the complete replay-safe crm_task upsert mapping shape, install/read the oxygen-sequencer skill.")
+        .requiredOption("--steps-file <path>", "Path to a JSON file: { \"steps\": [...] }. LinkedIn steps (visit_profile | invite | wait_for_connection | message | inmail | follow | like_post | comment_post | withdraw_invite), email steps (email_send | email_enroll | email_move | email_stop), WhatsApp (whatsapp_message), human call tasks (call_task), connected-CRM tasks (crm_task; channel crm; exact identity record_mappings + explicit create/update policy + record_links + dynamic task property_mappings/associations), and control steps (wait | wait_for_signal | branch | stop), each with an `id`. Copy templates support {{column}} interpolation from the lead's row, {{column|fallback}} inline fallbacks, deterministic spintax — {{RANDOM|a|b|c}} or industry-standard bare {Hi|Hey|Hello}, nestable like {Would {Tuesday|Thursday} work|next week?} — and {% if column %}…{% endif %} conditionals; a bare {…} region is spintax only when it contains a top-level |, so literal braces (CSS/JSON) pass through. Native email sends (email_send) also expose three reserved sender variables from the sending mailbox: {{sender_name}} (mailbox display name), {{sender_first_name}} (its first word), and {{sender_email}} (the from address); a row column of the same name WINS on collision, and a missing display name renders empty. comment_post takes text_template and/or ai_prompt — a KG-grounded comment generated at send time (a paid AI call) that falls back to text_template if generation fails. A `branch` routes on signals (then/else) or the legacy connection_accepted/already_connected/open_profile sugar (then_id/else_id). A signal condition can also branch on the LEAD'S DATA: a data leaf { has_column: \"email\" } is true when that row_values column has a non-empty value (add present:false for \"missing\") — e.g. route leads that have an email down an email arm and the rest down a LinkedIn arm. MINIMAL EMAIL STEP SHAPE: { \"id\": \"s1\", \"channel\": \"email\", \"kind\": \"email_send\", \"subject_template\": \"...\", \"body_template\": \"...\" } — body_template is REQUIRED on email_send; subject_template is OPTIONAL and is the one control that decides threading: give a step its own subject and it goes out as a NEW email, omit it and the step continues the lead's previous email in the same thread, going out as \"Re: <the previous email's subject>\" (what the retired email_reply kind used to be — still accepted on input, rewritten into this shape, and reported under `warnings` in the response). The FIRST email step of a sequence must carry a subject, since it has no earlier thread to continue. MINIMAL WHATSAPP STEP SHAPE: { \"id\": \"s1\", \"channel\": \"whatsapp\", \"kind\": \"whatsapp_message\", \"template\": \"Hi {{first_name|there}} …\" } — template is REQUIRED, and a live WhatsApp start also needs the sequence's --whatsapp-cold-initiate opt-in. A/B tests use an explicit `variants` array of copy partials on the step (up to 25 alternates, a–z; spintax varies wording INSIDE one variant and is not A/B-tracked). For the complete replay-safe crm_task upsert mapping shape, install/read the oxygen-sequencer skill.")
         .option("--channels <list>", "Comma-separated channels: linkedin,email,whatsapp,call,crm. Defaults to the channels the journey touches. crm_task currently supports HubSpot.")
         .option("--whatsapp-cold-initiate", "WhatsApp: allow cold-initiating new chats (no prior conversation). Required to start a WhatsApp sequence live — WhatsApp via Unipile is unofficial WhatsApp Web, so cold-initiating is an explicit ban-risk opt-in.")
         .option("--phone-column-key <key>", "WhatsApp: row_values key holding each lead's phone number (else falls back to phone/phone_number/mobile).")
-        .option("--senders <ids>", "Comma-separated LinkedIn sender account ids (or connection / Unipile ids). Optional at create; enroll and start require at least one when the journey has LinkedIn steps (attach later with `sequences update --senders`).")
+        .option("--senders <ids>", "Comma-separated LinkedIn or WhatsApp sender account ids (or connection / Unipile ids; `linkedin senders` / `whatsapp accounts` list them). Optional at create; enroll and start require at least one when the journey has LinkedIn or WhatsApp steps (attach later with `sequences update --senders`).")
         .option("--table <id>", "Source table id whose rows supply {{column}} template values.")
         .option("--url-column <key>", "Column key holding each lead's LinkedIn URL/provider id.")
         .option("--email-provider <provider>", "Email provider for the email track. Only 'instantly' is supported.")
@@ -13691,7 +13773,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--phone-column-key <key>", "WhatsApp: row_values key holding each lead's phone number (else falls back to phone/phone_number/mobile).")
         .option("--email-column-key <key>", "Native email: row_values key holding each lead's email (else falls back to email/email_address/work_email). Maps a non-English header (e.g. E-Mail).")
         .option("--linkedin-url-column-key <key>", "LinkedIn: row_values key holding each lead's profile URL (else falls back to linkedin_url/linkedinUrl/linkedin/profile_url). \"\" clears it back to auto-detect.")
-        .option("--senders <ids>", "Comma-separated LinkedIn sender account ids (or connection / Unipile ids).")
+        .option("--senders <ids>", "Comma-separated LinkedIn or WhatsApp sender account ids (or connection / Unipile ids; `linkedin senders` / `whatsapp accounts` list them).")
         .option("--source-table <idOrSlug>", "Bind the table this sequence enrolls leads from (id or slug). Only lands while the sequence has no source table yet (first-writer-wins); its rows become enrollable leads. Draft/paused only.")
         .option("--email-provider <provider>", "Email provider for the email track. Only 'instantly' is supported.")
         .option("--email-connection <id>", "Instantly connection id for the email track.")
@@ -13834,12 +13916,12 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     }))
         .addCommand(new Command("start")
-        .description("Preview or start a sequence. Without --approved, preview scans pending LinkedIn copy and returns exact rendered recipient samples, character counts/limits, copy blockers, per-kind scope, sender/mailbox capacity, CRM readiness, and safety caps. Live start requires --approved; --max-credits is optional. Email/WhatsApp/CRM-task journeys additionally require --max-live-sends because their external actions cost 0 Oxygen credits. Use --dry-run to simulate without any send, provider campaign, CRM task, or credits. The first live start also switches on the standing reply → CRM automation for the workspace.")
+        .description("Preview or start a sequence. Without --approved this is the launch check: it returns launch_readiness (blockers such as a missing send cap or the WhatsApp cold-initiate opt-in, plus warnings), scans pending LinkedIn copy, and returns exact rendered recipient samples, character counts/limits, copy blockers, per-kind scope, sender/mailbox capacity, CRM readiness, and safety caps. Live start requires --approved; --max-credits is optional. Email/WhatsApp/CRM-task journeys additionally require --max-live-sends because their external actions cost 0 Oxygen credits. Use --dry-run to simulate without any send, provider campaign, CRM task, or credits. The first live start also switches on the standing reply → CRM automation for the workspace.")
         .argument("<sequence>", "Sequence id or slug.")
         .option("--approved", "Approve and activate live. Without this flag, returns a preview only, including copy_preview rendered samples and blockers.")
         .option("--max-credits <n>", "Optional credit ceiling for the LinkedIn track (omit for an unbounded run).")
         .option("--max-live-sends <n>", "Live external-action ceiling (positive integer). Required for email, WhatsApp, or crm_task steps.")
-        .option("--dry-run", "Activate in dry-run mode: advance every step with simulated actions, no sends, CRM writes, provider calls, or credits.")
+        .option("--dry-run", "Activate the sequence (status draft → active, startedAt set) in dry-run mode: every step advances with simulated actions — no sends, CRM writes, provider calls, or credits. This is NOT the preview: `sequences start` with no flags is the side-effect-free launch preview, and a dry-run sequence must be paused or deleted to leave that state.")
         .option("--json", "Print a JSON envelope.")
         .action(async (sequence, options) => {
         await handleAsyncAction("sequences start", options, () => {
@@ -17235,6 +17317,9 @@ Full trigger schema: oxygen workflows schema --subject trigger --json
     registerFunctionsCommands(program, handleAsyncAction);
     registerUgcCommands(program, handleAsyncAction);
     registerKnowledgeRepositoryCommands(program, handleAsyncAction);
+    // Last, so every command registered above is covered — including the ones the
+    // register* helpers add after applyOxygenHelp.
+    enableCommandSuggestions(program);
     return program;
 }
 /**
@@ -18526,6 +18611,74 @@ async function assertPromptColumnReferences(table, prompt, inputNames = []) {
         exitCode: 1,
     });
 }
+/**
+ * Human rendering of `columns catalog`: one line per template with the input it
+ * reads and the credits per row, grouped by family. The JSON envelope is the
+ * contract; this is what a person reads in a terminal.
+ */
+function printColumnCatalog(result) {
+    // `requestOxygen` hands back the envelope's `data` already unwrapped, so the
+    // entries sit at the top level; a wrapped envelope is accepted too. Reading
+    // only `result.data` printed "No column templates match." for every catalog
+    // that actually matched (v1.985.2–v1.987.0).
+    const data = isRecord(result) ? (isRecord(result.data) ? result.data : result) : null;
+    const entries = data && Array.isArray(data.entries) ? data.entries.filter(isRecord) : [];
+    const bundles = data && Array.isArray(data.bundles) ? data.bundles.filter(isRecord) : [];
+    if (entries.length === 0 && bundles.length === 0) {
+        process.stderr.write("No column templates match.\n");
+        return;
+    }
+    const byFamily = new Map();
+    for (const entry of entries) {
+        const family = typeof entry.family === "string" ? entry.family : (typeof entry.category === "string" ? entry.category : "other");
+        const bucket = byFamily.get(family) ?? [];
+        bucket.push(entry);
+        byFamily.set(family, bucket);
+    }
+    const lines = [];
+    for (const [family, bucket] of byFamily) {
+        lines.push(`${family.replaceAll("_", " ")}:`);
+        for (const entry of bucket) {
+            const inputs = Array.isArray(entry.inputs)
+                ? entry.inputs.filter(isRecord).map((input) => `${String(input.name)}${input.required === false ? "?" : ""}`).join(", ")
+                : "";
+            const credits = isRecord(entry.credit_estimate) && typeof entry.credit_estimate.label === "string"
+                ? entry.credit_estimate.label
+                : "";
+            lines.push(`  ${String(entry.key)}  [${String(entry.source)}${inputs ? ` · ${inputs}` : ""}]  ${credits}`);
+            if (typeof entry.description === "string" && entry.description)
+                lines.push(`      ${entry.description}`);
+        }
+    }
+    // Bundles after the templates, because a bundle is the bigger commitment (it
+    // creates several columns) and a search that matches both should read as
+    // "here is the single column, and here is the pre-built set". Before this,
+    // `columns catalog --search domain` printed nothing at all for the
+    // domain_check preset and the only surface naming it was `columns add --help`
+    // (blind user eval, 2026-09-17).
+    if (bundles.length > 0) {
+        lines.push("");
+        lines.push("Bundles (several columns at once):");
+        for (const bundle of bundles) {
+            const credits = isRecord(bundle.credit_estimate) && typeof bundle.credit_estimate.label === "string"
+                ? bundle.credit_estimate.label
+                : "";
+            const columnCount = typeof bundle.column_count === "number" ? `${bundle.column_count} columns` : "";
+            const facts = [columnCount, credits].filter(Boolean).join(" · ");
+            lines.push(`  ${String(bundle.id)}  [${String(bundle.category ?? "")}${facts ? ` · ${facts}` : ""}]`);
+            if (typeof bundle.description === "string" && bundle.description)
+                lines.push(`      ${bundle.description}`);
+            if (typeof bundle.caveat === "string" && bundle.caveat)
+                lines.push(`      ${bundle.caveat}`);
+            if (typeof bundle.add_command === "string" && bundle.add_command)
+                lines.push(`      ${bundle.add_command}`);
+        }
+    }
+    lines.push("");
+    lines.push("Prices: a fixed figure is what every row costs; `~X credits/row (up to Y)` is X when the first grounding lane answers and Y reserved per row — `columns run --dry-run` quotes Y for your rows.");
+    lines.push("Add one: oxygen columns add <table> --prompt-key <key> --input <input>=<column_key>, then `columns run <table> <key> --dry-run` for the exact cost.");
+    process.stderr.write(`${lines.join("\n")}\n`);
+}
 function applyAiColumnConfig(definition, options) {
     const model = readOption(options.model);
     if (model)
@@ -18563,6 +18716,7 @@ function applyAiColumnConfig(definition, options) {
     return definition;
 }
 const RESEARCH_ENGINES = new Set(["exa", "parallel", "firecrawl"]);
+const RESEARCH_FETCH_ENGINES = new Set(["firecrawl", "linkup", "exa"]);
 const RESEARCH_MODES = new Set(["strict", "estimate"]);
 /**
  * Fold the `--research-*` flags into `definition.webSearch`.
@@ -18590,10 +18744,24 @@ function applyResearchColumnConfig(definition, options) {
         }
         webSearch.evidenceMode = mode;
     }
+    // Fetch mode: the column reads one page per row instead of searching. The
+    // URL column is a row column key (the same thing a {{token}} would name), so
+    // the server can reject a typo at write time instead of once per row.
+    const researchUrl = readOption(options.researchUrl);
+    if (researchUrl) {
+        if (readOption(options.researchQuery)) {
+            throw new OxygenError("invalid_request", "--research-url reads one page per row, so --research-query does not apply. Drop one of the two.", { exitCode: 1 });
+        }
+        webSearch.source = "fetch";
+        webSearch.urlInput = researchUrl;
+    }
     const engine = readOption(options.researchEngine)?.toLowerCase();
     if (engine) {
-        if (!RESEARCH_ENGINES.has(engine)) {
-            throw new OxygenError("invalid_request", `--research-engine must be exa, parallel, or firecrawl (got ${engine}).`, { exitCode: 1 });
+        const allowed = researchUrl ? RESEARCH_FETCH_ENGINES : RESEARCH_ENGINES;
+        if (!allowed.has(engine)) {
+            throw new OxygenError("invalid_request", researchUrl
+                ? `--research-engine with --research-url must be firecrawl, linkup, or exa (got ${engine}).`
+                : `--research-engine must be exa, parallel, or firecrawl (got ${engine}).`, { exitCode: 1 });
         }
         webSearch.engine = engine;
     }
@@ -19382,8 +19550,8 @@ function readCompaniesSearchRunBody(options, promptArg) {
     const promptSource = options.prompt ?? promptArg;
     const prompt = promptSource ? readFileIfPresent(promptSource) : null;
     const plan = options.planJson ? readSearchPlanJson(options.planJson) : null;
-    if (!prompt && !plan) {
-        throw new OxygenError("invalid_request", "Pass --prompt or --plan-json.", { exitCode: 1 });
+    if (!prompt && !plan && options.source !== "company_search") {
+        throw new OxygenError("invalid_request", "Pass --prompt, --plan-json, or --source company_search with --source-filters-json.", { exitCode: 1 });
     }
     const maxPages = readPositiveInt(options.maxPages);
     const maxCredits = readPositiveNumber(options.maxCredits);
@@ -19392,6 +19560,8 @@ function readCompaniesSearchRunBody(options, promptArg) {
     return {
         ...(prompt ? { prompt } : {}),
         ...(plan ? { plan } : {}),
+        ...(options.source ? { source: options.source } : {}),
+        ...(options.sourceFiltersJson ? { source_filters: parseJsonObject(readFileIfPresent(options.sourceFiltersJson)) } : {}),
         ...(options.routeId ? { route_id: options.routeId } : {}),
         ...(options.toolId ? { tool_id: options.toolId } : {}),
         ...(options.table ? { table: options.table } : {}),
@@ -19540,13 +19710,72 @@ function readSearchPlanJson(value) {
         ? data
         : parsed;
 }
+// Table-driven Employee Finder help, written once and shared by `people search
+// plan` and `people search run` so the price shape reads the same on both.
+const PEOPLE_SEARCH_FROM_TABLE_HELP = "Fan out Blitz Employee Finder over every company LinkedIn URL in a table column: 10 credits per company per page, rows land in a new people table linked back to each company row. Pass the table id or slug, plus --linkedin-url-column.";
+const PEOPLE_SEARCH_LINKEDIN_COLUMN_HELP = "Column key in --from-table holding each company's LinkedIn URL.";
+const PEOPLE_SEARCH_COMPANY_OFFSET_HELP = "Skip this many companies in --from-table. Use it to source the rest after a first-company preview.";
+const PEOPLE_SEARCH_COMPANY_LIMIT_HELP = "Fetch people for at most this many companies from --from-table. Start with --company-limit 1.";
+const PEOPLE_SEARCH_JOB_FUNCTIONS_HELP = "Comma-separated job functions: Sales, Marketing, Engineering, Finance, ...";
+const PEOPLE_SEARCH_CONTINENTS_HELP = "Comma-separated continents: Europe, North America, Asia, ...";
+const PEOPLE_SEARCH_SALES_REGIONS_HELP = "Comma-separated sales regions: EMEA, NAMER, APAC, LATAM.";
+const PEOPLE_SEARCH_MIN_CONNECTIONS_HELP = "Only return people with at least this many LinkedIn connections (0-500).";
+// `source` names the companies table the Employee Finder fans out over. The
+// offset/limit window rides INSIDE `source` when the source is declared here; with
+// a saved plan it rides as `source_overrides`, which the run route applies on top
+// of the plan's own source.
+function readPeopleSearchSource(options) {
+    const table = readOption(options.fromTable);
+    const column = readOption(options.linkedinUrlColumn);
+    if (!table && !column)
+        return null;
+    if (!table || !column) {
+        throw new OxygenError("invalid_request", "--from-table and --linkedin-url-column go together: name the table holding your companies and the column holding each company's LinkedIn URL.", { details: { from_table: table ?? null, linkedin_url_column: column ?? null }, exitCode: 1 });
+    }
+    return { table, linkedin_url_column: column, ...readPeopleSearchCompanyWindow(options) };
+}
+function readPeopleSearchCompanyWindow(options) {
+    const offset = readNonNegativeInt(options.companyOffset);
+    const limit = readPositiveInt(options.companyLimit);
+    return {
+        ...(offset !== undefined ? { company_offset: offset } : {}),
+        ...(limit !== undefined ? { company_limit: limit } : {}),
+    };
+}
+// `--pages-per-company` is the customer-readable spelling of `--max-pages` on a
+// table-driven run, where a page is one provider request per company. Two spellings
+// of one ceiling must never disagree silently on a paid run.
+function readPeopleSearchMaxPages(options) {
+    const perCompany = readPositiveInt(options.pagesPerCompany);
+    const maxPages = readPositiveInt(options.maxPages);
+    if (perCompany !== undefined && maxPages !== undefined && perCompany !== maxPages) {
+        throw new OxygenError("invalid_request", "--pages-per-company and --max-pages set the same ceiling. Pass one of them.", { details: { pages_per_company: perCompany, max_pages: maxPages }, exitCode: 1 });
+    }
+    return perCompany ?? maxPages;
+}
+// A customer pointing at a table has already said what they want; making them
+// also invent a sentence is a question with one answer. The synthesized prompt is
+// the same one the web wizard sends, so both surfaces plan from identical input.
+function readPeopleSearchPrompt(options, source) {
+    if (options.prompt)
+        return readFileIfPresent(options.prompt);
+    if (!source)
+        return null;
+    return `Employees at companies in ${String(source.table)}`;
+}
 function readPeopleSearchPlanBody(options) {
     const targetCount = readPositiveInt(options.targetCount);
     const filters = readPeopleSearchFilters(options);
+    const source = readPeopleSearchSource(options);
+    const prompt = readPeopleSearchPrompt(options, source);
+    if (!prompt) {
+        throw new OxygenError("invalid_request", "Pass --prompt, or --from-table with --linkedin-url-column to source employees from a table you already have.", { exitCode: 1 });
+    }
     return {
-        prompt: readFileIfPresent(options.prompt),
+        prompt,
         ...(targetCount !== undefined ? { target_count: targetCount } : {}),
         ...(options.sourceIntent ? { source_intent: options.sourceIntent } : {}),
+        ...(source ? { source } : {}),
         ...(filters ? { filters } : {}),
         // Free sizing is on by default; only --no-estimate (options.estimate === false) opts out.
         estimate: options.estimate !== false,
@@ -19554,15 +19783,20 @@ function readPeopleSearchPlanBody(options) {
     };
 }
 function readPeopleSearchRunBody(options) {
-    const prompt = options.prompt ? readFileIfPresent(options.prompt) : null;
     const plan = options.planJson ? readSearchPlanJson(options.planJson) : null;
+    const source = readPeopleSearchSource(options);
+    // --from-table is itself the request, so it satisfies the prompt requirement the
+    // same way --plan-json does. A submitted plan already carries its own source and
+    // prompt, so nothing is synthesized on top of one.
+    const prompt = readPeopleSearchPrompt(options, plan ? null : source);
     if (!prompt && !plan) {
-        throw new OxygenError("invalid_request", "Pass --prompt or --plan-json.", { exitCode: 1 });
+        throw new OxygenError("invalid_request", "Pass --prompt, --plan-json, or --from-table with --linkedin-url-column.", { exitCode: 1 });
     }
-    const maxPages = readPositiveInt(options.maxPages);
+    const maxPages = readPeopleSearchMaxPages(options);
     const maxCredits = readPositiveNumber(options.maxCredits);
     const targetCount = readPositiveInt(options.targetCount);
     const filters = prompt ? readPeopleSearchFilters(options) : null;
+    const sourceOverrides = source ? {} : readPeopleSearchCompanyWindow(options);
     return {
         ...(prompt ? { prompt } : {}),
         ...(plan ? { plan } : {}),
@@ -19576,6 +19810,8 @@ function readPeopleSearchRunBody(options) {
         ...(maxCredits !== undefined ? { max_credits: maxCredits } : {}),
         ...(targetCount !== undefined ? { target_count: targetCount } : {}),
         ...(options.sourceIntent ? { source_intent: options.sourceIntent } : {}),
+        ...(source ? { source } : {}),
+        ...(Object.keys(sourceOverrides).length > 0 ? { source_overrides: sourceOverrides } : {}),
         ...(filters ? { filters } : {}),
         // Free sizing is on by default when planning from a prompt; --no-estimate opts out.
         ...(prompt ? { estimate: options.estimate !== false } : {}),
@@ -19616,12 +19852,18 @@ function readPeopleSearchFilters(options) {
     const departments = readCsvOption(options.departments);
     if (departments.length > 0)
         filters.departments = { include: departments };
+    const jobFunctions = readCsvOption(options.jobFunctions);
+    if (jobFunctions.length > 0)
+        filters.job_functions = jobFunctions;
     const keywords = readCsvOption(options.keywords);
     if (keywords.length > 0)
         filters.keywords = { include: keywords };
-    const countries = readCsvOption(options.countries);
-    if (countries.length > 0)
-        filters.geo = { countries };
+    const geo = readPeopleSearchGeo(options);
+    if (geo)
+        filters.geo = geo;
+    const minConnections = readNonNegativeInt(options.minConnections);
+    if (minConnections !== undefined)
+        filters.min_connections = minConnections;
     const contactability = {};
     if (options.requireEmail)
         contactability.require_work_email = true;
@@ -19652,6 +19894,22 @@ function readPeopleSearchFilters(options) {
     }
     return Object.keys(filters).length > 0 ? filters : null;
 }
+// Person location filters share one `geo` object: country, continent, and sales
+// region are separate provider fields, so each one must merge into it rather than
+// replace it.
+function readPeopleSearchGeo(options) {
+    const geo = {};
+    const countries = readCsvOption(options.countries);
+    if (countries.length > 0)
+        geo.countries = countries;
+    const continents = readCsvOption(options.continents);
+    if (continents.length > 0)
+        geo.continents = continents;
+    const salesRegions = readCsvOption(options.salesRegions);
+    if (salesRegions.length > 0)
+        geo.sales_regions = salesRegions;
+    return Object.keys(geo).length > 0 ? geo : null;
+}
 function readCompaniesEnrichBody(table, options) {
     const body = { table };
     const fields = readCsvOption(options.missingFields);
@@ -25760,6 +26018,13 @@ catch (error) {
             cliArgs.slice(-2).join(" ") === "limits --json") {
             process.stderr.write(`Hint: --json belongs to the show subcommand. Run \`${program.name()} limits show --json\`.\n`);
         }
+        // `error: unknown command 'get'` names what is wrong and nothing to try
+        // next; commander's edit-distance suggester cannot reach a synonym.
+        if (error.code === "commander.unknownCommand") {
+            const hint = unknownCommandHint(program, cliArgs);
+            if (hint)
+                process.stderr.write(`${hint}\n`);
+        }
         if (error.code === "commander.excessArguments" &&
             cliArgs[0] === "skills" &&
             cliArgs[1] === "install") {