@oxygen-agent/cli 1.1011.98 → 1.1011.322

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

@@ -22,15 +22,16 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         id: "workspace-access",
         layer: "Control",
         primitive: null,
-        owns: "Authentication, CLI identities, API keys, sessions, organizations, and active-workspace selection.",
+        owns: "Authentication, CLI identities, API keys, sessions, organizations, active-workspace selection, and connected apps (ChatGPT, Claude, Codex…) with the default workspace each one works in.",
         notFor: "Workspace GTM data, provider credentials, or execution inside a primitive.",
-        execution: "Resolve identity and select the hosted workspace before operating its primitives.",
+        execution: "Resolve identity and select the hosted workspace before operating its primitives. Each app connected with OAuth keeps its own default workspace: `connectors list` shows them and `connectors set` changes one app only; orgs select changes only the app or CLI that calls it.",
         posture: "mixed",
-        gatewayTools: ["oxygen_whoami", "oxygen_orgs_list", "oxygen_orgs_select"],
-        gatewayCommands: ["whoami", "orgs list", "orgs select"],
+        gatewayTools: ["oxygen_whoami", "oxygen_orgs_list", "oxygen_orgs_select", "oxygen_connector_list", "oxygen_connector_update"],
+        gatewayCommands: ["whoami", "orgs list", "orgs select", "connectors list", "connectors set"],
         skills: ["oxygen-quickstart"],
-        endpointSections: ["api-keys", "auth", "login-requests", "orgs", "sessions", "settings", "whoami"],
-        intentTerms: ["login", "authenticate", "identity", "who am i", "workspace", "organization", "org", "api key", "session", "switch workspace"],
+        // `mcp`: the host-driven MCP Events routes an OAuth connection's subscriptions go through (ADR 0030 §2).
+        endpointSections: ["api-keys", "auth", "connectors", "login-requests", "mcp", "orgs", "sessions", "settings", "whoami"],
+        intentTerms: ["login", "authenticate", "identity", "who am i", "workspace", "organization", "org", "api key", "session", "switch workspace", "connected app", "connected apps", "default workspace"],
     },
     {
         id: "discovery-and-skills",
@@ -214,7 +215,7 @@ 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. To see what a table's own columns can be enriched with and what each costs per row before adding anything, run `tools search --for-table <table>` (MCP oxygen_tools_search with for_table): free, it returns priced suggestions with the exact add command. 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.",
+        execution: "Create and run work in hosted OXYGEN Tables; validate a small sample before bounded paid runs. To see what a table's own columns can be enriched with and what each costs per row before adding anything, run `tools search --for-table <table>` (MCP oxygen_tools_search with for_table): free, it returns priced suggestions with the exact add command. 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. For ICP tiers, read the saved profile with `knowledge page get icp`, then add native Classify Score: `columns add <table> --label 'ICP fit' --score 'low,medium,high' --prompt '<ICP criteria using {{evidence_column}} tokens>' --grounding workspace`. It costs 0.075 credits/row; preview with `columns run --dry-run`. `columns catalog --family classification --json` puts Classify in `data.native`; `data.entries` holds separate prompt templates that can cost more.",
         posture: "mixed",
         gatewayTools: ["oxygen_tables_create", "oxygen_tools_search", "oxygen_columns_add", "oxygen_columns_catalog", "oxygen_enrich_column_preview", "oxygen_tables_link_bulk", "oxygen_callables_manage"],
         gatewayCommands: ["tables create", "tools search", "columns add", "columns catalog", "enrich-column preview", "tables link", "functions list", "functions draft"],
@@ -273,13 +274,13 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         primitive: "signals",
         owns: "Durable typed pulse, engagement, and product events resolved onto records.",
         notFor: "Message bodies, post artifacts, or ad-hoc provider webhooks as private automation state.",
-        execution: "Read the hosted signal stream and feed subscriptions, Sequences, or Workflows.",
+        execution: "Read the hosted signal stream and type registry; tag a registered type with tags attach. Feed subscriptions, Sequences, or Workflows.",
         posture: "workspace_write",
-        gatewayTools: ["oxygen_signals_list", "oxygen_signals_leads_today"],
-        gatewayCommands: ["signals list", "signals leads-today", "signals registry"],
+        gatewayTools: ["oxygen_signals_list", "oxygen_signals_leads_today", "oxygen_signals_registry", "oxygen_tags_attach"],
+        gatewayCommands: ["signals list", "signals leads-today", "signals registry", "tags attach"],
         skills: ["oxygen-gtm", "oxygen-linkedin-marketing"],
         endpointSections: ["signals", "signup-leads"],
-        intentTerms: ["signal", "signals", "intent", "website visit", "job change", "fundraising", "warm leads", "engager", "follower", "viewer"],
+        intentTerms: ["signal", "signals", "signal type", "tag signal", "intent", "website visit", "job change", "fundraising", "warm leads", "engager", "follower", "viewer"],
     },
     {
         id: "dashboards",
@@ -310,15 +311,15 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         id: "ads",
         layer: "Data",
         primitive: "ads",
-        owns: "Competitor ad intelligence today; owned-audience activation is a roadmap boundary.",
+        owns: "Competitor ad intelligence and saved search definitions; owned-audience activation is a roadmap boundary.",
         notFor: "Organic Posts, Publishing, or claiming unshipped audience activation.",
-        execution: "Discover and run the hosted ad-intelligence provider operation with the normal paid-read gate.",
+        execution: "Save a reusable Ads search definition for free; running the hosted ad-intelligence provider operation uses the normal paid-read gate. Guide: /docs/data/ads.",
         posture: "paid_read",
-        gatewayTools: ["oxygen_adyntel_ads_search", "oxygen_tools_search"],
-        gatewayCommands: ["tools search"],
+        gatewayTools: ["oxygen_ads_searches", "oxygen_adyntel_ads_search", "oxygen_tools_search"],
+        gatewayCommands: ["ads searches list", "ads searches save", "tools search"],
         skills: ["oxygen-gtm"],
-        endpointSections: [],
-        intentTerms: ["ad", "ads", "advertising", "ad creative", "competitor ads", "ad intelligence", "meta ads", "linkedin ads"],
+        endpointSections: ["ads"],
+        intentTerms: ["ad", "ads", "advertising", "ad creative", "competitor ads", "ad intelligence", "meta ads", "linkedin ads", "saved ads search", "reusable ads search"],
     },
     {
         id: "tags",
@@ -326,10 +327,10 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         primitive: "tags",
         owns: "The normalized cross-primitive label vocabulary and campaign handle.",
         notFor: "A campaign entity, private per-surface labels, or arbitrary execution state.",
-        execution: "Read or mutate tags through the hosted union surface; rename is preview-first.",
+        execution: "Read or mutate tags through the hosted union surface; rename is preview-first. For saved Ads searches, save a definition with oxygen_ads_searches (CLI: ads searches save), then attach or read its tags here. Guide: /docs/workspace/tags.",
         posture: "workspace_write",
-        gatewayTools: ["oxygen_tags_list", "oxygen_tags_get", "oxygen_tags_rename"],
-        gatewayCommands: ["tags list", "tags get", "tags rename"],
+        gatewayTools: ["oxygen_tags_list", "oxygen_tags_get", "oxygen_tags_attach", "oxygen_tags_rename"],
+        gatewayCommands: ["tags list", "tags get", "tags attach", "tags rename"],
         skills: ["oxygen-gtm"],
         endpointSections: ["tags"],
         intentTerms: ["tag", "tags", "label", "labels", "campaign handle", "grouping", "organize campaign"],
@@ -345,7 +346,7 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         // email track's "Only 'instantly' is supported" and concluded Smartlead was
         // unreachable. The governed path for a campaign the customer already runs
         // elsewhere is `sequences push-external`; it is not a Sequence.
-        execution: "Use the one-step gateway for new LinkedIn initiation or create/enroll/start a hosted campaign with bounded send authority. Native email sends through connected Google/Microsoft mailboxes, including Microsoft SMTP transport. To push table rows into an existing Smartlead, Instantly, lemlist or HeyReach campaign you already run, use `sequences push-external` (dry_run preview, then --approved). To stop a company's other leads when one of them replies, set `--company-reply-pause` on the campaign (choose the reply categories); to pause or resume a company on demand, e.g. from a workflow when a meeting is booked, use `sequences pause-company` / `resume-company`. A pause is resumable; a company do-not-contact entry is a permanent block on every campaign.",
+        execution: "Use the one-step gateway for new LinkedIn initiation or create/enroll/start a hosted campaign with bounded send authority. Native email sends through connected Google/Microsoft mailboxes, including Microsoft SMTP transport. To push table rows into an existing Smartlead, Instantly, lemlist or HeyReach campaign you already run, use `sequences push-external` (dry_run preview, then --approved). To stop a company's other leads when one of them replies, set `--company-reply-pause` on the campaign (choose the reply categories); to pause or resume a company on demand, e.g. from a workflow when a meeting is booked, use `sequences pause-company` / `resume-company`. A pause is resumable; a company do-not-contact entry is a permanent block on every campaign. Step copy takes lead columns as {{column}} and the sending person's name as {{sender_first_name}}, {{sender_last_name}} or {{sender_full_name}} (email adds {{sender_email}}), with no table column.",
         posture: "external_write",
         gatewayTools: ["oxygen_sequences_send", "oxygen_sequences_create", "oxygen_sequences_enroll", "oxygen_sequences_start", "oxygen_sequences_list", "oxygen_sequences_push_external", "oxygen_sequences_company_pause"],
         gatewayCommands: ["sequences send", "sequences create", "sequences enroll", "sequences start", "sequences list", "sequences push-external", "sequences pause-company"],
@@ -356,7 +357,10 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         // to workspace-access — "identity" matched the AUTH sense. The nouns a user
         // reaches for when naming a sending identity or the dialing pool have to land
         // on the group that actually owns `senders profiles` and `voice numbers`.
-        intentTerms: ["sequence", "campaign", "cadence", "enroll", "outreach", "linkedin message", "linkedin dm", "nurture", "follow up", "sender rotation", "stop on reply", "company replied", "pause company", "pause outreach to a company", "stop outreach to a company", "stop emailing a company", "colleagues", "do not contact a company", "sender identity", "sending identity", "sender profile", "phone number", "dialing", "dialer", "call", "cold call", "smartlead", "instantly", "lemlist", "heyreach", "external sequencer", "push to campaign", "push rows to campaign", "add leads to campaign"],
+        // The sign-off terms are here because a 2026-09-29 blind user searched
+        // "preview rendered message per sender sign-off variable" and landed on
+        // collaboration; the {{sender_*}} copy variables live on sequence steps.
+        intentTerms: ["sequence", "campaign", "cadence", "enroll", "outreach", "linkedin message", "linkedin dm", "nurture", "follow up", "sender rotation", "stop on reply", "company replied", "pause company", "pause outreach to a company", "stop outreach to a company", "stop emailing a company", "colleagues", "do not contact a company", "sender identity", "sending identity", "sender profile", "phone number", "dialing", "dialer", "call", "cold call", "smartlead", "instantly", "lemlist", "heyreach", "external sequencer", "push to campaign", "push rows to campaign", "add leads to campaign", "sign-off", "sign off", "signature", "sender name", "sender first name", "sender variable", "sender_first_name"],
     },
     {
         id: "publishing",
@@ -565,12 +569,13 @@ export function inferCapabilityRoute(query) {
     // beside them in `catalogIntent`, never inside them.
     const catalogue = catalogRow && CATALOGUE_CARD_IDS.has(card.id) ? catalogueRecommendations(catalogRow, card) : null;
     return {
-        card,
+        card: routeCardFor(card, normalized),
         recommendedTools: recommendations.tools,
         recommendedCommands: recommendations.commands,
         ...(recommendations.exactCommand ? { exactCommand: recommendations.exactCommand } : {}),
+        ...(recommendations.exactMcpCall ? { exactMcpCall: recommendations.exactMcpCall } : {}),
         ...(catalogue && catalogRow
-            ? { catalogIntent: { id: catalogRow.id, label: catalogRow.label, status: catalogRow.status, group: catalogRow.group, tools: catalogue.tools, commands: catalogue.commands, exactCommand: catalogue.exactCommand } }
+            ? { catalogIntent: { id: catalogRow.id, label: catalogRow.label, status: catalogRow.status, group: catalogRow.group, tools: catalogue.tools, commands: catalogue.commands, exactCommand: catalogue.exactCommand, exactMcpCall: catalogue.exactMcpCall } }
             : {}),
     };
 }
@@ -587,13 +592,25 @@ function cardForCatalogueIntent(row) {
         return ROUTE_BY_ID.get("signals") ?? ROUTE_BY_PRIMITIVE.get("signals") ?? null;
     return ROUTE_BY_PRIMITIVE.get("tables") ?? null;
 }
+/**
+ * The MCP tool a catalogue row's `find` command maps to, named by its command
+ * words alone: "find company --domain <domain> --fields funding,..." once became
+ * the tool "oxygen_find_company_domain_<domain>_fields_...", which does not
+ * exist (funding, hiring-signal and revenue rows, 2026-09-29).
+ */
+export function catalogueFindTool(row) {
+    const command = row.surfaces.find?.split(/\s+--/)[0]?.trim();
+    return command ? `oxygen_${command.replace(/[\s-]+/g, "_")}` : null;
+}
 function catalogueRecommendations(row, card) {
     const exactCommand = `oxygen enrichment catalog --intent ${row.id}`;
+    const exactMcpCall = catalogueIntentMcpCall(row.id);
     if (row.group === "decision_maker" || card.id === "sourcing-and-provider-tools") {
         return {
             tools: ["oxygen_enrichment_catalog", "oxygen_people_search_plan", "oxygen_people_search_run"],
             commands: ["enrichment catalog", "people search plan", "people search run"],
             exactCommand,
+            exactMcpCall,
         };
     }
     if (row.group === "signal") {
@@ -601,13 +618,16 @@ function catalogueRecommendations(row, card) {
             tools: ["oxygen_enrichment_catalog", "oxygen_signals_search_plan", "oxygen_signals_search_run"],
             commands: ["enrichment catalog", "signals search plan", "signals search run"],
             exactCommand,
+            exactMcpCall,
         };
     }
-    const find = row.surfaces.find ? [`oxygen_${row.surfaces.find.replace(/[\s-]+/g, "_")}`] : [];
+    const findTool = catalogueFindTool(row);
+    const find = findTool ? [findTool] : [];
     return {
         tools: ["oxygen_enrichment_catalog", "oxygen_columns_add", "oxygen_enrich_column_preview", ...find],
         commands: ["enrichment catalog", "columns add", "enrich-column preview", ...(row.surfaces.find ? [row.surfaces.find] : [])],
         exactCommand,
+        exactMcpCall,
     };
 }
 export function inferPrimitiveRoute(query) {
@@ -616,7 +636,7 @@ export function inferPrimitiveRoute(query) {
         return null;
     return route;
 }
-export function serializeCapabilityRoute(route) {
+export function serializeCapabilityRoute(route, surface = "cli") {
     if (!route)
         return null;
     return {
@@ -631,9 +651,23 @@ export function serializeCapabilityRoute(route) {
         endpoint_sections: route.card.endpointSections,
         recommended_commands: route.recommendedCommands,
         recommended_tools: route.recommendedTools,
-        ...(route.exactCommand ? { exact_command: route.exactCommand } : {}),
+        ...(surface === "mcp" && route.exactMcpCall
+            ? { exact_mcp_call: route.exactMcpCall }
+            : route.exactCommand ? { exact_command: route.exactCommand } : {}),
         ...(route.catalogIntent
-            ? { catalog_intent: { id: route.catalogIntent.id, label: route.catalogIntent.label, status: route.catalogIntent.status, group: route.catalogIntent.group, tools: route.catalogIntent.tools, commands: route.catalogIntent.commands, exact_command: route.catalogIntent.exactCommand } }
+            ? {
+                catalog_intent: {
+                    id: route.catalogIntent.id,
+                    label: route.catalogIntent.label,
+                    status: route.catalogIntent.status,
+                    group: route.catalogIntent.group,
+                    tools: route.catalogIntent.tools,
+                    commands: route.catalogIntent.commands,
+                    ...(surface === "mcp"
+                        ? { exact_mcp_call: route.catalogIntent.exactMcpCall }
+                        : { exact_command: route.catalogIntent.exactCommand }),
+                },
+            }
             : {}),
         hydrate: {
             cli: "oxygen commands get <exact-command> --json",
@@ -669,6 +703,70 @@ function isUgcProgramIntent(query) {
 function isUgcCreatorSideIntent(query) {
     return /\b(join|apply|applying|find|discover|browse|accept)\w*\b.{0,30}\b(creator|ugc|ambassador) programs?\b/.test(query);
 }
+/** The lifecycle verb of an operator's program ask ("archive program", "delete my creator program"), or null. */
+function ugcProgramLifecycleVerb(query) {
+    return /\b(archive|restore|delete|remove|duplicate|copy|clone) (?:(?:a|an|the|this|that|my|our|old|archived|creator|ugc|brand|ambassador) ){0,3}programs?\b/.exec(query)?.[1] ?? null;
+}
+/** The `ugc programs` leaf and MCP tool per lifecycle verb; delete previews first and names archive when refused. */
+const UGC_PROGRAM_LIFECYCLE = {
+    archive: ["ugc programs archive", "oxygen_ugc_program_update"],
+    restore: ["ugc programs restore", "oxygen_ugc_program_update"],
+    delete: ["ugc programs delete", "oxygen_ugc_program_delete"],
+    remove: ["ugc programs delete", "oxygen_ugc_program_delete"],
+    duplicate: ["ugc programs duplicate", "oxygen_ugc_program_duplicate"],
+    copy: ["ugc programs duplicate", "oxygen_ugc_program_duplicate"],
+    clone: ["ugc programs duplicate", "oxygen_ugc_program_duplicate"],
+};
+/**
+ * A creator's own writing voice: `ugc voice import` learns it from their LinkedIn
+ * history (the web's "Learn your writing voice") and `ugc voice save` keeps what
+ * they write themselves. Only an ask that names the creator context routes here:
+ * "learn my writing voice from my LinkedIn messages" is just as likely the
+ * workspace voice `knowledge synthesize --kind voice` learns from sent LinkedIn and
+ * WhatsApp messages, and brand voice stays with the Knowledge Graph.
+ */
+function isUgcVoiceIntent(query) {
+    return /\bcreators?'?s? voice\b/.test(query)
+        || (/\bvoice\b/.test(query) && /\b(creator|ugc|ambassador)s?\b/.test(query) && !/\bbrand voice\b/.test(query));
+}
+/**
+ * Who approves a creator's post. It is the creator, or the program organizer when
+ * the creator delegated approval; a brand can never require its own approval of
+ * creator posts (Philipp, 2026-09-29).
+ * The MCP acceptance run's "brand approval of creator post before publish" routed
+ * to the Knowledge Graph, so the rule it needed never reached it. Only an
+ * approval word next to a creator's post counts: "find LinkedIn creator posts
+ * about AI" stays a keyword post search.
+ */
+function isUgcPostApprovalIntent(query) {
+    return /\b(?:approv\w*|review\w*|sign[- ]?off)\b.{0,40}\b(?:creator|ugc|ambassador)s?'?\s+posts?\b/.test(query)
+        || /\b(?:creator|ugc|ambassador)s?'?\s+posts?\b.{0,40}\b(?:approv\w*|review\w*|sign[- ]?off)\b/.test(query)
+        || /\bbrand (?:approval|review)\b.{0,40}\b(?:creators?|ugc|ambassadors?)\b/.test(query);
+}
+function isUgcIntent(query) {
+    return isUgcProgramIntent(query) || isUgcCreatorSideIntent(query) || isUgcVoiceIntent(query)
+        || isUgcPostApprovalIntent(query) || ugcProgramLifecycleVerb(query) !== null;
+}
+/**
+ * UGC is Publishing's creator-program subpage (OXYGEN_PRODUCT.md § UGC programs): a
+ * creator-program ask keeps the publishing id, primitive, endpoint sections and
+ * gateways, but must not read Publishing's post-scheduler ownership back (UGC E2E pass, 2026-09-29).
+ */
+const UGC_ROUTE_VIEW = {
+    owns: "UGC creator programs: brand programs, creator invitations and applications, participations, creator voice, program post drafts and approvals, sponsorship, results, and bounded amplification.",
+    notFor: "Scheduling the workspace's own posts, one-to-one messaging, outreach campaigns, or keyword post search.",
+    execution: "Brands create a program from its product URL and invite creators; creators apply or accept in their own workspace. A post publishes only after the creator approves its exact content, or the program organizer does when the creator delegated approval; brands cannot require approval. Paid drafts, voice imports and amplification preview first and need an approved credit ceiling.",
+    posture: "mixed",
+    skills: ["oxygen-ugc", "oxygen-linkedin-marketing"],
+};
+/** The card a route reports: Publishing's own, or its UGC view for a creator-program ask. */
+function routeCardFor(card, query) {
+    if (card.primitive === "publishing" && isUgcIntent(query))
+        return { ...card, ...UGC_ROUTE_VIEW };
+    if (card.id === "knowledge-graph" && isWorkspaceVoiceIntent(query))
+        return { ...card, execution: WORKSPACE_VOICE_EXECUTION };
+    return card;
+}
 function isLinkedInKeywordPostIntent(query) {
     return /\blinkedin\b/.test(query)
         && /\b(posts?|posting)\b/.test(query)
@@ -700,6 +798,104 @@ function isOwnLinkedInNetworkIntent(query) {
     const bothHalves = /\bconnections?\b/.test(query) && /\bfollowers?\b/.test(query);
     return (ownNetwork || bothHalves) && !isNetNewLinkedInInitiation(query);
 }
+/**
+ * The workspace's own voice. `knowledge synthesize --kind voice` learns a writing
+ * voice from the workspace's SENT LinkedIn and WhatsApp messages; brand voice is a
+ * wiki page. "learn my writing voice from my LinkedIn history" scored higher on
+ * the connected-LinkedIn card ("my linkedin") and was offered `linkedin network
+ * setup` (UGC E2E pass, 2026-09-29, OXP-1.15.12). A creator's voice is UGC and is
+ * claimed first (isUgcVoiceIntent); phone voice (numbers, calls) never matches.
+ * The blind baseline also searched "writing style" and "voice learn".
+ */
+function isWorkspaceVoiceIntent(query) {
+    if (/\b(?:calls?|calling|dial\w*|phone|softphone|voicemail|numbers?)\b/.test(query))
+        return false;
+    return /\b(?:writing (?:voice|style)|brand voice|tone of voice|voice guide|(?:my|our) (?:own )?voice|(?:write|sound)s? like (?:me|us))\b/.test(query)
+        || /\b(?:learn|capture|mimic|copy|match)\w*\b.{0,30}\bvoice\b/.test(query)
+        || /\bvoice\b.{0,30}\b(?:learn|capture|mimic|copy|match)\w*\b/.test(query);
+}
+const WORKSPACE_VOICE_EXECUTION = "A writing voice is learned from the workspace's own sent LinkedIn and WhatsApp messages: `oxygen knowledge synthesize --kind voice --json` (MCP: oxygen_context_synthesize with kind voice) runs one low-cost AI call, priced as one low-reasoning AI column cell, the preview included, and reports credits_used; to pin the guide a preview showed, pass its body back with --approved --body (no new AI call), because --approved alone synthesizes and charges again. The pinned guide is the canonical voice at once and grounds message, reply, sequence and post drafts and AI columns. It reads sent messages only, not posts, emails or web pages. Brand voice and tone live in wiki pages (knowledge search). A creator's voice in a UGC program is `ugc voice import`.";
+/** One schedule for every channel of a Sequence, the same as Launch's Sending schedule. */
+export const SEQUENCE_SENDING_SCHEDULE_COMMAND = "oxygen sequences update <sequence> --schedule-timezone <IANA zone> --schedule-days mon-fri --schedule-hours-start 09:00 --schedule-hours-end 17:00 --json";
+/** Launch's unsubscribe switch: the visible link and the one-click headers together. */
+export const SEQUENCE_UNSUBSCRIBE_COMMAND = "oxygen sequences update <sequence> --include-unsubscribe --json";
+/**
+ * Every exact CLI command a route hands out, as the MCP tool call that sends the
+ * same request. The MCP surface serves these in place of the command: an MCP
+ * agent handed a CLI command had to translate it (blind user eval, 2026-09-29).
+ * Each was traced to the same `/api/cli/*` request as its command; the
+ * mcp-server test proves every tool exists and declares every argument.
+ * Factories, so a caller can edit the object it gets.
+ */
+export const CAPABILITY_ROUTE_MCP_CALLS = {
+    connectedAppsList: () => ({ tool: "oxygen_connector_list", arguments: {} }),
+    sequenceSendingSchedule: () => ({
+        tool: "oxygen_sequences_update",
+        arguments: { sequence: "<sequence>", sending_schedule: { timezone: "<IANA zone>", days: [1, 2, 3, 4, 5], start: "09:00", end: "17:00" } },
+    }),
+    sequenceUnsubscribe: () => ({ tool: "oxygen_sequences_update", arguments: { sequence: "<sequence>", include_unsubscribe: true } }),
+    ugcProgramCreate: () => ({ tool: "oxygen_ugc_program_create", arguments: { product_url: "<your product site>" } }),
+    // The first comment rides in `content`, as the CLI's --first-comment does.
+    publishingFirstComment: () => ({
+        tool: "oxygen_publishing_posts_create",
+        arguments: { content_text: "<post>", publish_at: "<iso>", sender_account_id: "<sender_id>", content: { first_comment: "<comment, e.g. the link>" } },
+    }),
+    companyUrlRecovery: () => ({
+        tool: "oxygen_companies_search_plan",
+        arguments: { prompt: "Find the websites for these companies: <company names>", source_intent: "url_recovery" },
+    }),
+    // `records` is a number the tool drops when it is not one; 1000 is its default.
+    companyPageFollowers: () => ({
+        tool: "oxygen_tables_followers",
+        arguments: { action: "preview", company_url: "<linkedin company page URL>", records: 1000 },
+    }),
+    localBusinessScrape: () => ({
+        tool: "oxygen_companies_search_preview",
+        arguments: { action: "preview", source: "google_maps", filters: { q: "<category> in <city, region>" } },
+    }),
+    // Like the CLI command, it leaves the LinkedIn risk acknowledgement to the user.
+    senderConnect: () => ({ tool: "oxygen_senders_connect", arguments: { country: "<cc>" } }),
+    rowClassification: () => ({ tool: "oxygen_columns_catalog", arguments: { family: "classification" } }),
+    // The tool has no `family`: it always searches linkedin_posts, which the API reads as the same source.
+    linkedinKeywordPosts: () => ({
+        tool: "oxygen_signals_search_preview",
+        arguments: {
+            action: "preview",
+            filters: { keywords: ["<any of>"], all_keywords: ["<all of>"], exclude_keywords: ["<none of>"], ai_filter: "<posts to keep>" },
+        },
+    }),
+};
+/** The catalogue row's `enrichment catalog --intent <id>` as an MCP call. */
+export function catalogueIntentMcpCall(intentId) {
+    return { tool: "oxygen_enrichment_catalog", arguments: { intent: intentId } };
+}
+// A Sequence's sending schedule or send window. Workflow language still wins
+// ("a workflow that changes the send window nightly" is automation), and
+// "sending hours" stays with the connected account's working hours.
+function isSequenceScheduleIntent(query) {
+    return /\bsend(?:ing)? (?:schedule|window)s?\b/.test(query)
+        && !/\b(workflow|automation|automate|webhook|cron)\b/.test(query);
+}
+// The unsubscribe option on a Sequence's emails, not the list of people who
+// opted out: a list, import or do-not-contact ask stays with suppressions.
+function isSequenceUnsubscribeIntent(query) {
+    return /\bunsubscribe\b/.test(query)
+        && !/\b(workflow|automation|automate|webhook|cron)\b/.test(query)
+        && !/\b(unsubscribed|lists?|import\w*|suppress\w*|block ?list|blocklist|do not contact|dnc)\b/.test(query);
+}
+/** A post's first comment is set with the post; `publishing posts update` takes the same flag. */
+export const PUBLISHING_FIRST_COMMENT_COMMAND = 'oxygen publishing posts create --publish-at <iso> --sender <sender_id> --text "<post>" --first-comment "<comment, e.g. the link>" --json';
+/**
+ * The comment OXYGEN posts right after a post goes out ("put the link in the first
+ * comment") is part of the post, not a reply to one. The 2026-09-29 baselines found
+ * no flag, guessed `content.first_comment`, and searched in vain.
+ */
+function isFirstCommentIntent(query) {
+    return /\bfirst comments?\b/.test(query)
+        && !/\b(repl(?:y|ies|ied)|respond\w*|answer\w*)\b/.test(query)
+        // Reading comments people left is owned-post comment work, not setting one.
+        && !/\b(show|list|read|see|view|who|whose)\b/.test(query);
+}
 export const COMPANY_PAGE_FOLLOWERS_COMMAND = "oxygen tables followers check --company <linkedin company page URL> --records <n> --json";
 /**
  * "The people who follow HubSpot on LinkedIn" / "a competitor's followers" is a
@@ -732,11 +928,36 @@ function isOpenLinkedInRequestsIntent(query) {
     return /\b(connection|invitation|invite|connect) requests?\b/.test(query)
         || /\b(pending|open|unanswered|outstanding|received|sent) (linkedin )?(invitations?|invites?)\b/.test(query);
 }
+/**
+ * The apps a person connected with OAuth and where each one works: "make
+ * ChatGPT always use workspace X", "default workspace for my Claude
+ * connection", "list my connected apps". Both blind baselines (2026-09-30)
+ * searched exactly this and got only `orgs select`, which changes the calling
+ * app or CLI and never another app; "connection" alone also pulled in the
+ * LinkedIn connections card.
+ */
+function isConnectedAppsIntent(query) {
+    if (/\bconnected apps?\b/.test(query))
+        return true;
+    const connection = /\b(oauth (?:apps?|clients?|connections?|grants?)|mcp (?:clients?|connections?|connectors?))\b/.test(query);
+    const app = connection || /\b(chatgpt|claude|codex|ai (?:apps?|assistants?|clients?))\b/.test(query);
+    if (!app)
+        return false;
+    // An app name alone is not enough ("make Claude always use my brand voice"):
+    // the ask must be about which workspace it works in, or list the connections.
+    const workspaceChoice = /\b(workspaces?|organi[sz]ations?|orgs?)\b/.test(query)
+        && /\b(default|always|without asking|which|per (?:app|connection|client))\b/.test(query);
+    return workspaceChoice || (connection && /\b(list|show|see|which|my)\b/.test(query));
+}
 function explicitCapabilityIntent(query) {
+    if (isConnectedAppsIntent(query))
+        return ROUTE_BY_ID.get("workspace-access") ?? null;
     if (/\b(infographic|graphic designer|render html|carousel pages|visual design|gtm flow image)\b/.test(query))
         return ROUTE_BY_ID.get("visual-rendering") ?? null;
-    if (isUgcProgramIntent(query) || isUgcCreatorSideIntent(query))
+    if (isUgcIntent(query))
         return ROUTE_BY_PRIMITIVE.get("publishing") ?? null;
+    if (isWorkspaceVoiceIntent(query))
+        return ROUTE_BY_ID.get("knowledge-graph") ?? null;
     if (isOwnLinkedInNetworkIntent(query) || isOpenLinkedInRequestsIntent(query))
         return ROUTE_BY_ID.get("connected-linkedin") ?? null;
     if (isCompanyPageFollowersIntent(query))
@@ -750,7 +971,7 @@ function explicitCapabilityIntent(query) {
     // names every attached channel (LinkedIn + WhatsApp + email). Resolve this
     // before public LinkedIn research, whose generic "profile" wording would
     // otherwise route an account-readiness question to scraper tools.
-    if (isSenderProfileIntent(query)) {
+    if (isSenderProfileIntent(query) || isSenderCopyVariableIntent(query)) {
         return ROUTE_BY_PRIMITIVE.get("sequences") ?? null;
     }
     if (isInboxAvatarIntent(query)) {
@@ -773,6 +994,10 @@ function explicitCapabilityIntent(query) {
     // enrichment baseline).
     if (/\bprofile viewers?\b/.test(query))
         return ROUTE_BY_ID.get("connected-linkedin") ?? null;
+    // Ahead of the keyword-post, workflow and owned-post-comment rules below, which
+    // claimed "a first comment on my LinkedIn post" and "... automatically".
+    if (isFirstCommentIntent(query))
+        return ROUTE_BY_PRIMITIVE.get("publishing") ?? null;
     if (isLinkedInKeywordPostIntent(query))
         return ROUTE_BY_ID.get("signals") ?? null;
     // Ahead of the workflow rule, whose "retry" would claim it. Why a post failed and how to get it out is Publishing's attempt ledger and
@@ -781,6 +1006,12 @@ function explicitCapabilityIntent(query) {
     // publish" to the connected-account catalog.
     if (isFailedPostIntent(query))
         return ROUTE_BY_PRIMITIVE.get("publishing") ?? null;
+    // When and how a Sequence sends: its sending schedule and its unsubscribe
+    // option. Ahead of the workflow rule, whose bare "schedule" sent the 2026-09-29
+    // unified-launch acceptance agent's "sending schedule" search to Workflows and
+    // hid every Sequences command.
+    if (isSequenceScheduleIntent(query) || isSequenceUnsubscribeIntent(query))
+        return ROUTE_BY_PRIMITIVE.get("sequences") ?? null;
     if (isHostedWorkflowIntent(query))
         return ROUTE_BY_PRIMITIVE.get("workflows") ?? null;
     if (isOwnedPostCommentIntent(query))
@@ -972,17 +1203,38 @@ function isLocalBusinessIntent(query) {
     return /\b(local business(?:es)?|google maps|maps listings?|storefronts?|near me|(?:dental|medical|law|veterinary) (?:practices?|offices?|clinics?)|dentists?|restaurants?|cafes?|coffee shops?|gyms?|salons?|plumbers?|electricians?|contractors?|hvac|auto repair|real estate agents?|businesses (?:in|near|around) [a-z])\b/.test(query);
 }
 function recommendationsFor(card, query) {
+    // A program's lifecycle and a creator's voice are UGC work the Publishing card
+    // also claims ("archive program", "creator voice"); before these they got the
+    // post tools (UGC E2E pass, 2026-09-29).
+    const lifecycle = card.primitive === "publishing" ? UGC_PROGRAM_LIFECYCLE[ugcProgramLifecycleVerb(query) ?? ""] : undefined;
+    if (lifecycle)
+        return { tools: [lifecycle[1], "oxygen_ugc_get"], commands: [lifecycle[0], "ugc programs list"] };
     if (card.primitive === "publishing" && isUgcCreatorSideIntent(query)) {
         return {
             tools: ["oxygen_ugc_get", "oxygen_ugc_application_create", "oxygen_ugc_invite_accept"],
             commands: ["ugc programs discover", "ugc programs apply", "ugc creators accept"],
         };
     }
+    if (card.primitive === "publishing" && isUgcVoiceIntent(query)) {
+        return {
+            tools: ["oxygen_ugc_voice_import", "oxygen_ugc_voice_save", "oxygen_ugc_get"],
+            commands: ["ugc voice import", "ugc voice save", "ugc voice get"],
+        };
+    }
     if (card.primitive === "publishing" && isUgcProgramIntent(query)) {
         return {
             tools: ["oxygen_ugc_program_create", "oxygen_ugc_invite_create", "oxygen_ugc_get"],
             commands: ["ugc programs create", "ugc creators invite", "ugc programs list"],
             exactCommand: "oxygen ugc programs create --product-url <your product site> --json",
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.ugcProgramCreate(),
+        };
+    }
+    if (card.primitive === "publishing" && isFirstCommentIntent(query)) {
+        return {
+            tools: ["oxygen_publishing_posts_create", "oxygen_publishing_posts_update", "oxygen_publishing_posts_get"],
+            commands: ["publishing posts create", "publishing posts update", "publishing posts get"],
+            exactCommand: PUBLISHING_FIRST_COMMENT_COMMAND,
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.publishingFirstComment(),
         };
     }
     if (card.id === "sourcing-and-provider-tools" && isCompanyUrlRecoveryIntent(query)) {
@@ -990,6 +1242,7 @@ function recommendationsFor(card, query) {
             tools: ["oxygen_companies_search_plan", "oxygen_companies_search_run"],
             commands: ["companies search plan", "companies search run"],
             exactCommand: COMPANY_URL_RECOVERY_COMMAND,
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.companyUrlRecovery(),
         };
     }
     if (card.primitive === "tables" && isCompanyPageFollowersIntent(query)) {
@@ -997,6 +1250,7 @@ function recommendationsFor(card, query) {
             tools: ["oxygen_tables_followers", "oxygen_tables_sources"],
             commands: ["tables followers check", "tables followers order", "tables sources"],
             exactCommand: COMPANY_PAGE_FOLLOWERS_COMMAND,
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.companyPageFollowers(),
         };
     }
     if (card.id === "sourcing-and-provider-tools" && isLocalBusinessIntent(query)) {
@@ -1004,6 +1258,15 @@ function recommendationsFor(card, query) {
             tools: ["oxygen_companies_search_preview", "oxygen_companies_search_run"],
             commands: ["companies search filters", "companies search preview", "companies search run"],
             exactCommand: LOCAL_BUSINESS_SCRAPE_COMMAND,
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.localBusinessScrape(),
+        };
+    }
+    if (card.id === "workspace-access" && isConnectedAppsIntent(query)) {
+        return {
+            tools: ["oxygen_connector_list", "oxygen_connector_update"],
+            commands: ["connectors list", "connectors set"],
+            exactCommand: "oxygen connectors list --json",
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.connectedAppsList(),
         };
     }
     if (card.id === "connected-linkedin" && isLinkedInAccountConnectIntent(query)) {
@@ -1011,6 +1274,7 @@ function recommendationsFor(card, query) {
             tools: ["oxygen_senders_connect", "oxygen_senders_list", "oxygen_billing_commitments"],
             commands: ["senders connect", "senders list", "billing commitments"],
             exactCommand: "oxygen senders connect --country <cc> --json",
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.senderConnect(),
         };
     }
     if (card.id === "connected-linkedin" && isLinkedInAccountLimitsIntent(query)) {
@@ -1122,6 +1386,7 @@ function recommendationsFor(card, query) {
                 tools: ["oxygen_columns_catalog", "oxygen_columns_add", "oxygen_columns_run", "oxygen_tables_query"],
                 commands: ["columns catalog", "columns add", "columns run", "tables query"],
                 exactCommand: ROW_CLASSIFICATION_COMMAND,
+                exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.rowClassification(),
             };
         }
         if (isCompanyResearchQuestionIntent(query)) {
@@ -1184,6 +1449,16 @@ function recommendationsFor(card, query) {
         }
     }
     if (card.primitive === "sequences") {
+        if (isSequenceScheduleIntent(query) || isSequenceUnsubscribeIntent(query)) {
+            return {
+                tools: ["oxygen_sequences_update", "oxygen_sequences_get"],
+                commands: ["sequences update", "sequences get"],
+                exactCommand: isSequenceScheduleIntent(query) ? SEQUENCE_SENDING_SCHEDULE_COMMAND : SEQUENCE_UNSUBSCRIBE_COMMAND,
+                exactMcpCall: isSequenceScheduleIntent(query)
+                    ? CAPABILITY_ROUTE_MCP_CALLS.sequenceSendingSchedule()
+                    : CAPABILITY_ROUTE_MCP_CALLS.sequenceUnsubscribe(),
+            };
+        }
         if (isSenderProfileIntent(query)) {
             return {
                 tools: ["oxygen_senders_profiles_list", "oxygen_senders_profiles_get"],
@@ -1282,6 +1557,7 @@ function recommendationsFor(card, query) {
             tools: ["oxygen_signals_search_preview", "oxygen_signals_search_run"],
             commands: ["signals search preview", "signals search run"],
             exactCommand: LINKEDIN_KEYWORD_POST_COMMAND,
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.linkedinKeywordPosts(),
         };
     }
     if (card.primitive === "signals" && /\blinkedin\b.{0,40}\bengagers?\b/.test(query)) {
@@ -1296,6 +1572,13 @@ function recommendationsFor(card, query) {
             commands: ["whatsapp accounts", "whatsapp get", "whatsapp limits get", "whatsapp connect"],
         };
     }
+    // Brand voice is read from its wiki page; only a writing voice is synthesized.
+    if (card.id === "knowledge-graph" && isWorkspaceVoiceIntent(query) && !/\bbrand voice\b/.test(query)) {
+        return {
+            tools: ["oxygen_context_synthesize", "oxygen_knowledge_search", "oxygen_knowledge_page_get"],
+            commands: ["knowledge synthesize", "knowledge search", "knowledge page get"],
+        };
+    }
     return { tools: [...card.gatewayTools], commands: [...card.gatewayCommands] };
 }
 // An email-VERIFICATION ask names a grading verb next to the addresses, or the
@@ -1375,6 +1658,18 @@ function isSenderProfileIntent(query) {
         || (/\bprofiles?\b.{0,64}\b(?:linkedin|whatsapp|mailboxes?|inboxes?|email)\b/.test(query)
             && /\b(?:sender|sending|unif(?:y|ied))\b/.test(query));
 }
+/**
+ * Naming whoever sends a step inside its copy ({{sender_first_name}}, a sign-off
+ * with the sender's name) is Sequence step copy. A 2026-09-29 blind user asked
+ * "preview rendered message per sender sign-off variable" and was routed to
+ * comments and approvals, and "sign every email with …" reads as a one-off
+ * Message. A bare "sender name" stays out: renaming an inbox's From is not copy.
+ */
+function isSenderCopyVariableIntent(query) {
+    return /\bsender (?:first|last|full) name\b/.test(query)
+        || /\bsign off (?:variable|with|per sender)\b|\bper sender sign off\b/.test(query)
+        || /\bsign (?:every|each|all) (?:emails?|messages?|dms?|notes?) with\b/.test(query);
+}
 /** The account's own working hours or daily caps (`senders limits`), not its network. */
 /**
  * Connecting, or asking what it takes to connect, the workspace's own LinkedIn

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

@@ -12,7 +12,7 @@ import { type TagKind } from "./tags.js";
  * both ways: {@link EveryTagKindIsCommentable} fails the build if a taggable
  * kind is missing, and the paired test pins today's list exactly.
  */
-export declare const COLLAB_SUBJECT_KINDS: readonly ["knowledge_page", "publishing_post", "sequence", "table", "workflow", "recipe", "conversation", "mailbox", "sender", "record", "domain", "project", "sender_profile", "voice_number"];
+export declare const COLLAB_SUBJECT_KINDS: readonly ["knowledge_page", "publishing_post", "sequence", "table", "workflow", "recipe", "conversation", "mailbox", "sender", "record", "domain", "project", "sender_profile", "voice_number", "signal_type", "dashboard", "agent", "ad_search_collection"];
 export type CollabSubjectKind = (typeof COLLAB_SUBJECT_KINDS)[number];
 /** Compile-time assertion helper: instantiating with `false` is a type error. */
 type AssertTrue<T extends true> = T;