@oxygen-agent/cli 1.1014.1696 → 1.1014.1763

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

@@ -2,6 +2,8 @@ import { findEnrichmentIntentByAlias } from "./enrichment-intents.js";
 import { networkMiningEnabled } from "./network-mining.js";
 import { nativeChatEnabled, withNativeChatDiscovery } from "./native-chat-discovery.js";
 import { RECIPE_PRIMITIVES } from "./recipes.js";
+import { matchSkillPlay } from "./skill-play-routing.js";
+export { matchSkillPlay, SKILL_PLAY_TRIGGERS } from "./skill-play-routing.js";
 // One compact semantic index covers every top-level /api/cli endpoint section.
 // It is navigation, never execution: live schemas, prices, readiness, and
 // approval enforcement remain on the exact command/tool selected from here.
@@ -298,7 +300,7 @@ 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 type registry; tag a registered type with tags attach. 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. A visit or view the user reports goes on the person with oxygen_crm_activity_log (activity_type website_visit, direction inbound, live), after creating a missing person with oxygen_crm_record_assert (free, no approval); oxygen_crm_signal_record is for a provider webhook.",
         posture: "workspace_write",
         gatewayTools: ["oxygen_signals_list", "oxygen_signals_leads_today", "oxygen_signals_registry", "oxygen_tags_attach"],
         gatewayCommands: ["signals list", "signals leads-today", "signals registry", "tags attach"],
@@ -375,7 +377,7 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         gatewayTools: ["oxygen_sequences_send", "oxygen_sequences_create", "oxygen_sequences_enroll", "oxygen_sequences_start", "oxygen_sequences_list", "oxygen_sequences_update", "oxygen_sequences_get", "oxygen_sequences_push_external", "oxygen_sequences_company_pause"],
         gatewayCommands: ["sequences send", "sequences create", "sequences enroll", "sequences start", "sequences list", "sequences update", "sequences get", "sequences push-external", "sequences pause-company"],
         skills: ["oxygen-sequencer"],
-        endpointSections: ["senders", "sequencer", "sequences", "spintax", "subscriptions", "suppressions", "voice"],
+        endpointSections: ["email-assets", "email-documents", "senders", "sequencer", "sequences", "spintax", "subscriptions", "suppressions", "voice"],
         // "sender identity", "sender profile" and "phone number" are here because a
         // blind-user eval (2026-08-09) asked for "our sender identity" and got routed
         // to workspace-access — "identity" matched the AUTH sense. The nouns a user
@@ -411,7 +413,7 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         primitive: "workflows",
         owns: "Deterministic hosted automation definitions, versions, triggers, branching, retries, approvals, modes, and durable runs.",
         notFor: "Local cron, client-side execution, adaptive Agent goals, or outreach cadence already owned by Sequences.",
-        execution: "Author locally if useful, then schema/lint/apply and call the Workflow on OXYGEN workers; outbound uses internal oxygen.sequence_enroll against an already active bounded Sequence. Start from the graph schema's examples[0] (oxygen_workflows_schema subject graph): a minimal valid manifest whose tool node adds a Table row with oxygen_table_rows_insert. A draft that is not saved exists only in your reply, so show its manifest there. To find why a definition fails, lint it as written first. Saving without running is apply with publish false and workflow and trigger status disabled.",
+        execution: "Author locally if useful, then schema/lint/apply and call the Workflow on OXYGEN workers; outbound uses internal oxygen.sequence_enroll against an already active bounded Sequence. Start from the graph schema's examples[0] (oxygen_workflows_schema subject graph): a minimal valid manifest whose tool node adds a Table row with oxygen_table_rows_insert. To change existing rows, a tool node runs oxygen_tables_query with filters, a loop goes over steps.<node>.output.rows (body edge source_handle loop_body, plus an edge back to the loop), and the body calls oxygen_rows_update with row_id loop.each.item._row_id and values. A fixed change on a schedule stays a Workflow: draft and lint it rather than offering a formula column instead; a routine is for checks that need judgment. A cron time is in the person's time zone: set trigger.timezone, and ask for it in your first question when you do not know it. To find why a definition fails, lint it as written first. Saving without running is apply with publish false and workflow and trigger status disabled. If apply is refused, nothing was saved: say so once, never call it saved or a draft in OXYGEN, and never offer another way around the refusal (such as writing the rows directly). Then say in plain words what it would do once saved, and include the full manifest below that: show its manifest every time, since it exists only in your reply.",
         posture: "mixed",
         gatewayTools: ["oxygen_workflows_schema", "oxygen_workflows_lint", "oxygen_workflows_apply", "oxygen_workflows_call", "oxygen_workflows_tail"],
         gatewayCommands: ["workflows schema", "workflows lint", "workflows apply", "workflows call", "workflows tail"],
@@ -459,7 +461,11 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         gatewayCommands: ["companies search plan", "people search plan", "tools search", "find company"],
         skills: ["oxygen-sourcing", "oxygen-enrichment"],
         endpointSections: ["companies", "find", "lead-sourcing", "people", "search", "sourcing", "tools", "verify"],
-        intentTerms: ["find companies", "find people", "source leads", "build a list", "tam", "prospect", "provider", "tool catalog", "find email", "find phone", "local businesses", "local business", "google maps", "storefronts"],
+        // Contacts at accounts are a people search: "merge two lists then find
+        // contacts" scored Records on "merge"/"contact", and "who we should reach at
+        // each company ... cost" scored Billing on "cost".
+        intentTerms: ["find companies", "find people", "source leads", "build a list", "tam", "prospect", "provider", "tool catalog", "find email", "find phone", "local businesses", "local business", "google maps", "storefronts", "find contacts", "contacts per account", "contacts per company", "contacts at each", "reach at each", "people at each"],
+        negativeTerms: ["in my crm", "in our crm", "in the crm", "existing contacts"],
     },
     {
         id: "linkedin-public-research",
@@ -637,7 +643,10 @@ export function inferCapabilityRoute(query) {
     // Card scoring stays the owner of routing; the catalogue only breaks a
     // no-match tie ("get the funding round for these accounts" names no card
     // term) and decorates the data cards it belongs to.
-    const card = explicit ?? highestScoringRoute(normalized) ?? (catalogRow ? cardForCatalogueIntent(catalogRow) : null);
+    // A feature-skill play the ask matches votes for the cards its skill owns and,
+    // when the chosen card lists that skill, travels on the route as the file to open.
+    const play = matchSkillPlay(normalized) ?? sourcingPlaybookFor(normalized);
+    const card = explicit ?? highestScoringRoute(normalized, play?.skill) ?? (catalogRow ? cardForCatalogueIntent(catalogRow) : null);
     if (!card)
         return null;
     const recommendations = recommendationsFor(card, normalized);
@@ -647,7 +656,7 @@ export function inferCapabilityRoute(query) {
     // Sourcing filters belong to the planner, not per-company enrichment.
     const catalogue = catalogRow && CATALOGUE_CARD_IDS.has(card.id) && !isCompanySourcingIntent(normalized)
         ? catalogueRecommendations(catalogRow, card) : null;
-    return withRecordBrief({
+    return withSkillPlay(withRecordBrief({
         card: routeCardFor(card, normalized),
         recommendedTools: recommendations.tools,
         recommendedCommands: recommendations.commands,
@@ -656,7 +665,30 @@ export function inferCapabilityRoute(query) {
         ...(catalogue && catalogRow
             ? { 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 } }
             : {}),
-    }, networkMiningEnabled(runtimeEnv()));
+    }, networkMiningEnabled(runtimeEnv())), play);
+}
+/**
+ * Contacts at accounts has no play of its own: oxygen-sourcing's SKILL.md sends
+ * "merging sources, setting contacts per account" to its playbook reference,
+ * so the route points there (2026-10-22 suite: the merge-then-contacts case
+ * missed two contacts per account and the second-source rule without it).
+ * Contacts already in the CRM stay with Records.
+ */
+function sourcingPlaybookFor(query) {
+    return /\b(find contacts|contacts (per|at each) (account|company)|reach at each|people at each)\b/.test(query)
+        && !/\b(crm|existing contacts)\b/.test(query)
+        ? { skill: "oxygen-sourcing", slug: "playbook", file: "references/playbook.md" }
+        : null;
+}
+/** The play rides only on a card that lists its skill, and that skill is named first. */
+function withSkillPlay(route, play) {
+    if (!play || !route.card.skills.includes(play.skill))
+        return route;
+    return {
+        ...route,
+        card: { ...route.card, skills: [play.skill, ...route.card.skills.filter((skill) => skill !== play.skill)] },
+        play,
+    };
 }
 /**
  * A data-type ask ("tech stack", "decision makers at each account", "funding
@@ -818,6 +850,8 @@ export function serializeCapabilityRoute(route, surfaceOrOptions = "cli", option
         return null;
     const nativeChat = (typeof surfaceOrOptions === "string" ? options.nativeChat : surfaceOrOptions.nativeChat) ?? nativeChatEnabled(runtimeEnv());
     route = withNativeChatDiscovery(route, nativeChat);
+    const play = route.play && (isPublicCapabilitySkill(route.play.skill) || visibleSkills?.includes(route.play.skill))
+        ? route.play : null;
     return {
         capability_id: route.card.id,
         layer: route.card.layer,
@@ -827,6 +861,15 @@ export function serializeCapabilityRoute(route, surfaceOrOptions = "cli", option
         execution: route.card.execution,
         posture: route.card.posture,
         skills: route.card.skills.filter((name) => isPublicCapabilitySkill(name) || visibleSkills?.includes(name)),
+        // The play to open before planning, in both read forms like `hydrate` below.
+        ...(play ? {
+            play: {
+                skill: play.skill,
+                file: play.file,
+                read_cli: `oxygen skills get ${play.skill} --file ${play.file} --json`,
+                read_mcp: { tool: "oxygen_skills_get", arguments: { name: play.skill, file: play.file } },
+            },
+        } : {}),
         endpoint_sections: route.card.endpointSections,
         recommended_commands: route.recommendedCommands,
         recommended_tools: route.recommendedTools,
@@ -1312,6 +1355,10 @@ function routeCardFor(card, query) {
         return { ...card, execution: feed.execution };
     if (card.primitive === "publishing" && isUgcIntent(query))
         return { ...card, ...UGC_ROUTE_VIEW };
+    if (card.primitive === "publishing" && isPostDraftIntent(query))
+        return { ...card, execution: POST_DRAFT_EXECUTION };
+    if (card.primitive === "signals" && isSignalCaptureIntent(query))
+        return { ...card, execution: SIGNAL_CAPTURE_EXECUTION, skills: ["oxygen-signals", "oxygen-crm"] };
     const contactFind = card.id === "sourcing-and-provider-tools" ? oneShotContactFindingRecommendation(query) : null;
     if (contactFind)
         card = { ...card, execution: contactFind.execution };
@@ -1352,6 +1399,8 @@ function routeCardFor(card, query) {
         card = { ...card, posture: "read_only", execution: CANONICAL_COPY_READ_EXECUTION };
     else if (card.id === "knowledge-graph" && isWorkspaceVoiceIntent(query))
         card = { ...card, execution: WORKSPACE_VOICE_EXECUTION };
+    if (card.primitive === "agents" && isAdaptiveWatchIntent(query))
+        card = { ...card, execution: ADAPTIVE_WATCH_EXECUTION };
     if (card.primitive === "workflows" && isRecurringCompanyMonitoringIntent(query))
         card = {
             ...card,
@@ -1396,6 +1445,9 @@ function routeCardFor(card, query) {
     const insert = card.primitive === "tables" ? tableRowInsertRecommendation(query) : null;
     if (insert)
         card = { ...card, posture: "workspace_write", execution: insert.execution };
+    const update = card.primitive === "tables" ? tableRowUpdateRecommendation(query) : null;
+    if (update)
+        card = { ...card, posture: "workspace_write", execution: update.execution };
     const sent = card.id === "connected-linkedin" ? sentLinkedInInvitationReadRecommendation(query) : null;
     if (sent)
         card = { ...card, execution: sent.execution };
@@ -1554,6 +1606,14 @@ export const CAPABILITY_ROUTE_MCP_CALLS = {
     sequenceReplyToStop: () => ({ tool: "oxygen_sequences_update", arguments: { sequence: "<sequence>", reply_to_stop_text: "Reply STOP to opt out." } }),
     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.
+    publishingPostDraft: () => ({
+        tool: "oxygen_publishing_posts_create",
+        arguments: { content_text: "<post>", publish_at: "<iso>", status: "draft" },
+    }),
+    signalCapture: () => ({
+        tool: "oxygen_crm_activity_log",
+        arguments: { object: "people", row_id: "<person rowId or email>", activity_type: "website_visit", direction: "inbound", summary: "<what they viewed>", occurred_at: "<iso>", mode: "live" },
+    }),
     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>" } },
@@ -1649,6 +1709,8 @@ function isSequenceUnsubscribeIntent(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 POST_DRAFT_COMMAND = 'oxygen publishing posts create --draft --publish-at <iso> --text "<post>" --json';
+export const SIGNAL_CAPTURE_COMMAND = 'oxygen crm activity log people <rowId or email> --type website_visit --direction inbound --summary "<what they viewed>" --live --json';
 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
@@ -1906,7 +1968,7 @@ function tableRowRemovalRecommendation(query) {
  */
 function tableRowInsertRecommendation(query) {
     if (!/\brows?\b/.test(query) || !/\b(add|adding|insert\w*|append\w*|put|enter|write)\b/.test(query)
-        || /\b(delete|remove|update|edit|change|set|mark|import\w*|csv|crm|records?|enrich\w*|sync\w*|workflows?|agents?|campaigns?|sequences?|webhooks?|feeds?|functions?|callables?|cells?|dedup\w*|duplicates?)\b/.test(query)
+        || /\b(delete|remove|update|edit|change|set|mark|existing|import\w*|csv|crm|records?|enrich\w*|sync\w*|workflows?|agents?|campaigns?|sequences?|webhooks?|feeds?|functions?|callables?|cells?|dedup\w*|duplicates?)\b/.test(query)
         || /\b(?:add|insert|new)\s+(?:an?\s+|the\s+)?(?:\w+\s+)?columns?\b/.test(query)
         || isSecondPartyDecisionIntent(query))
         return null;
@@ -1916,6 +1978,25 @@ function tableRowInsertRecommendation(query) {
         execution: "Add literal rows with tables rows insert (oxygen_table_rows_insert): table plus rows, an array of {column_key: value} objects. tables create (oxygen_tables_create) makes the columns but takes no rows, so insert after it. Manual rows are a free internal write. Read the rows back with tables query (oxygen_tables_query).",
     };
 }
+/**
+ * Changing values on rows that already exist is oxygen_rows_update. Without this
+ * card "update rows" / "set a cell" ranked create and enrichment tools, and an
+ * Oxygent concluded no row update existed and offered a formula column instead of
+ * the weekly Workflow it was asked for (System 1 routing case, 2026-10-22).
+ */
+function tableRowUpdateRecommendation(query) {
+    if (!/\b(rows?|cells?)\b/.test(query)
+        || !(/\b(update\w*|edit\w*|chang\w*|sets?|setting|overwrit\w*|mark\w*)\b/.test(query) || /\bexisting (?:table )?rows?\b/.test(query))
+        || /\b(delete|remove|insert\w*|append\w*|import\w*|csv|crm|records?|enrich\w*|sync\w*|campaigns?|sequences?|functions?|callables?|dedup\w*|duplicates?|history|provenance|rerun|re-run|retry|columns? run|run columns?|formulas?)\b/.test(query)
+        || /\b(?:add|insert|new|create)\s+(?:an?\s+|the\s+)?(?:\w+\s+)?(?:columns?|rows?)\b/.test(query)
+        || isSecondPartyDecisionIntent(query))
+        return null;
+    return {
+        tools: ["oxygen_rows_update", "oxygen_tables_query", "oxygen_rows_upsert"],
+        commands: ["tables update", "tables query", "tables upsert"],
+        execution: "Change values on existing rows with tables update (oxygen_rows_update): table, row_id and values as {column_key: value}, one row per call, a free internal write. Find the rows and their _row_id with tables query (oxygen_tables_query) and filters first; tables upsert (oxygen_rows_upsert) writes by a key column instead. In a Workflow, loop over the query's rows and call oxygen_rows_update with row_id loop.each.item._row_id. Read the rows back after writing.",
+    };
+}
 /** Reads of grid values/state are separate from executing or resolving actions. */
 function tableReadRecommendation(query) {
     if (isFunctionIntent(query) || isSecondPartyDecisionIntent(query)
@@ -2270,6 +2351,12 @@ function explicitCapabilityIntent(query) {
         return ROUTE_BY_ID.get(readOnly.capabilityId) ?? null;
     if (isOxygentChatIntent(query))
         return ROUTE_BY_ID.get("agents") ?? null;
+    // Values on existing Table rows, ahead of the sourcing rule whose "prospect"
+    // claimed "set a value on rows where stage is prospect". Scheduled or tag
+    // wording keeps its Workflow and Tags owners.
+    if (tableRowUpdateRecommendation(query)
+        && !/\b(workflows?|agents?|routines?|automat\w*|schedul\w*|weekly|daily|nightly|hourly|every|cron|tags?|tagg\w*)\b/.test(query))
+        return ROUTE_BY_ID.get("tables") ?? null;
     // Importing an AI answer is GEO evidence, rather than a Table file import.
     if (/\b(?:geo|aeo|ai (?:(?:search|answer) )?visibility|consumer ai answers?|answer engine optimization|generative engine optimization)\b/.test(query))
         return ROUTE_BY_ID.get("geo") ?? null;
@@ -2385,6 +2472,15 @@ function explicitCapabilityIntent(query) {
     // claimed "a first comment on my LinkedIn post" and "... automatically".
     if (isFirstCommentIntent(query))
         return ROUTE_BY_PRIMITIVE.get("publishing") ?? null;
+    // Writing the workspace's own post is a Publishing draft, ahead of the keyword
+    // post search ("a LinkedIn post about ...") and the public LinkedIn read owner,
+    // which claimed "write a LinkedIn post and save it as a draft".
+    if (isPostDraftIntent(query))
+        return ROUTE_BY_PRIMITIVE.get("publishing") ?? null;
+    // One event the user reports ("log that she visited our pricing page") is a
+    // Signal on the person, not a CRM note or a table row.
+    if (isSignalCaptureIntent(query))
+        return ROUTE_BY_PRIMITIVE.get("signals") ?? null;
     // Publish/approve are writes even when the noun is a public LinkedIn post.
     // The 2026-09-30 connector baseline offered the cookieless read owner first.
     if (isPublishingPostIntent(query))
@@ -2406,6 +2502,8 @@ function explicitCapabilityIntent(query) {
     if (isMailboxVolumeIntent(query) && !/\b(workflow|automation|automate|webhook|cron)\b/.test(query)) {
         return ROUTE_BY_ID.get("sending-infrastructure") ?? null;
     }
+    if (isAdaptiveWatchIntent(query))
+        return ROUTE_BY_PRIMITIVE.get("agents") ?? null;
     if (isHostedWorkflowIntent(query))
         return ROUTE_BY_PRIMITIVE.get("workflows") ?? null;
     if (placementGuideRecommendation(query))
@@ -2582,10 +2680,16 @@ function matchesIntentTerm(query, term) {
     }
     return false;
 }
-function highestScoringRoute(query) {
+/**
+ * A matched play's skill counts as one multi-word term for each card that names
+ * it first: "cold email the whole market" matched the whole-market play, yet its
+ * one card term ("email") picked Messages over Sequences.
+ */
+const PLAY_SKILL_TERM_SCORE = 6;
+function highestScoringRoute(query, playSkill) {
     let best = null;
     for (const card of OXYGEN_CAPABILITY_ROUTES) {
-        let score = 0;
+        let score = playSkill !== undefined && card.skills[0] === playSkill ? PLAY_SKILL_TERM_SCORE : 0;
         for (const term of card.intentTerms) {
             if (matchesIntentTerm(query, term))
                 score += term.includes(" ") ? 6 : 2;
@@ -2612,6 +2716,25 @@ export const LOCAL_BUSINESS_SCRAPE_COMMAND = `oxygen companies search preview --
 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);
 }
+/** Writing or saving the workspace's own post, or asking to post it: a Publishing draft. */
+function isPostDraftIntent(query) {
+    if (/\b(engagers?|engag(?:ed|ing|ement)|comments?|commenters?|react\w*|harvest|scrape|competitors?|creators?|repl(?:y|ies)|tables?|rows?|workflows?|automat\w*|sequences?|campaigns?)\b/.test(query))
+        return false;
+    if (/\b(find|search|research|monitor|watch)\b/.test(query))
+        return false;
+    return (/\b(write|draft|drafts|drafted|compose|save|saved)\b/.test(query) && /\bposts?\b/.test(query))
+        || /\bpost (?:it|this|that)\b|\bpost (?:on|to) (?:linkedin|x|twitter)\b/.test(query);
+}
+/** Recording one reported event (a visit, a view) on a person: a Signal, logged on the Record. */
+function isSignalCaptureIntent(query) {
+    return /\b(record|log|logs|logged|track|note|save|add|capture)\b/.test(query)
+        && /\b(visit(?:s|ed|or)?|viewed|profile views?|signals?)\b/.test(query)
+        // Outreach wording ("set up an email follow-up ... add the people") is a
+        // Sequence for signalled people, not one reported event.
+        && !/\b(list|show|read|which|who|rank|leads? to contact|registry|search|find|inbox|webhook|automat\w*|workflows?|sequences?|enrich\w*|tables?|columns?|feeds?|follow ups?|campaigns?|cadences?|outreach|emails)\b/.test(query);
+}
+const POST_DRAFT_EXECUTION = "Read the voice page first (oxygen_knowledge_page_get, slug voice) and use only numbers a page states. Save the post with oxygen_publishing_posts_create, status draft and no approved flag: it needs no sender, publishes nothing and opens in Publishing for review. A post written only in the reply is not saved. Publishing it is a separate oxygen_publishing_posts_approve after the user says yes; a missing connected sender is the one blocker to name. End by saying it is a draft, not live, with its web_url; if the save is refused, say the post exists only in this chat.";
+const SIGNAL_CAPTURE_EXECUTION = "Find the person with oxygen_crm_record_search; if there is no record, create it with oxygen_crm_record_assert (identity email, values full_name and company_domain when known; free, no card). Then log the event on that record with oxygen_crm_activity_log: row_id the rowId the assert or search returned (not object.id) or her email, activity_type website_visit (or profile_view, post_reaction, new_follower), direction inbound, occurred_at, a one-line summary such as the page viewed. It then shows in the Signals feed and on the person's timeline. Not a note or a table row; contacting nobody. End by saying it is recorded as a website-visit Signal and where it shows (the record's web_url); if a write is refused, say nothing was recorded.";
 function isPublishingPostIntent(query) {
     return /\b(posts?|publishing|content calendar)\b/.test(query)
         && /\b(publish|publishing|schedule|scheduled|approve|approval)\b/.test(query)
@@ -2753,6 +2876,22 @@ function recommendationsFor(card, query) {
             exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.ugcProgramCreate(),
         };
     }
+    if (card.primitive === "publishing" && isPostDraftIntent(query)) {
+        return {
+            tools: ["oxygen_knowledge_page_get", "oxygen_publishing_posts_create", "oxygen_publishing_posts_get"],
+            commands: ["knowledge page get", "publishing posts create", "publishing posts get"],
+            exactCommand: POST_DRAFT_COMMAND,
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.publishingPostDraft(),
+        };
+    }
+    if (card.primitive === "signals" && isSignalCaptureIntent(query)) {
+        return {
+            tools: ["oxygen_crm_record_search", "oxygen_crm_record_assert", "oxygen_crm_activity_log", "oxygen_signals_list"],
+            commands: ["crm search", "crm assert", "crm activity log", "signals list"],
+            exactCommand: SIGNAL_CAPTURE_COMMAND,
+            exactMcpCall: CAPABILITY_ROUTE_MCP_CALLS.signalCapture(),
+        };
+    }
     if (card.primitive === "publishing" && isFirstCommentIntent(query)) {
         return {
             tools: ["oxygen_publishing_posts_create", "oxygen_publishing_posts_update", "oxygen_publishing_posts_get"],
@@ -2971,6 +3110,9 @@ function recommendationsFor(card, query) {
         const insert = tableRowInsertRecommendation(query);
         if (insert)
             return insert;
+        const update = tableRowUpdateRecommendation(query);
+        if (update)
+            return update;
         const read = tableReadRecommendation(query);
         if (read)
             return read;
@@ -3278,6 +3420,14 @@ function recommendationsFor(card, query) {
                 commands: ["workflows templates search", "workflows templates describe", "workflows templates preflight", "workflows templates apply"],
             };
         }
+        // A scheduled change to existing rows: the query and row-update tools the
+        // graph's nodes call rank beside the authoring gateway.
+        if (/\b(rows?|cells?)\b/.test(query) && /\b(updat\w*|edit\w*|chang\w*|sets?|setting|tag\w*|mark\w*|writ\w*)\b/.test(query)
+            && !/\b(insert\w*|add\w*|append\w*|new rows?|delete\w*|remove\w*)\b/.test(query))
+            return {
+                tools: ["oxygen_workflows_schema", "oxygen_workflows_lint", "oxygen_tables_query", "oxygen_rows_update", "oxygen_workflows_apply"],
+                commands: ["workflows schema", "workflows lint", "tables query", "tables update", "workflows apply"],
+            };
         if (isNetNewLinkedInInitiation(query) || /\b(outreach|sequence|enroll|message)\b/.test(query)) {
             return {
                 tools: ["oxygen_workflows_schema", "oxygen_workflows_lint", "oxygen_workflows_apply", "oxygen_tools_get", "oxygen_sequences_list", "oxygen_sequences_start"],
@@ -3733,6 +3883,20 @@ function isHostedWorkflowIntent(query) {
     return /\b(nightly|hourly|daily|weekly|every (?:monday|tuesday|wednesday|thursday|friday|saturday|sunday|day|night|week|month))\b/.test(query)
         || (/\bschedule(?:d)?\b/.test(query) && !/\bpost|content\b/.test(query));
 }
+/**
+ * Watching items that change and working out what each one needs is an Agent's
+ * judgment, not a Workflow's fixed rule: "keep an eye on open deals and suggest
+ * what to do next for each" routed to Records reads, and the Oxygent proposed a
+ * routine without saying why (System 1 routing case, 2026-10-22).
+ */
+function isAdaptiveWatchIntent(query) {
+    if (/\b(workflows?|webhooks?|cron|deterministic|fixed rule|sequences?|campaigns?|posts?|mailbox\w*|deliverability|bounce\w*)\b/.test(query))
+        return false;
+    return /\b(keeps? an eye on|keeps? tabs on|keeps? track of|watch(?:es|ing)?|monitor(?:s|ing)?|look(?:s|ing)? after)\b/.test(query)
+        && /\b(suggest\w*|decid\w*|works? out|figures? out|recommend\w*|judg\w*|what to do|next steps?|next moves?)\b/.test(query)
+        && /\b(each|every|individual\w*|differently|deals?|pipeline|opportunit(?:y|ies)|accounts?)\b/.test(query);
+}
+const ADAPTIVE_WATCH_EXECUTION = "Watching items that change and deciding what fits each one is an Agent's job: each run looks at every item and works out what it needs, while a Workflow repeats one fixed rule. Tell the person that in one plain line. Set it up as an ongoing Agent session with per-run and rolling 24-hour credit caps; in an Oxygent chat, propose a routine and put that line in its why. Read the items first so the goal names real fields (for deals: stage, amount, last activity). Size the caps to one check, about 10 credits a run for reading a few dozen records and writing suggestions, and say so when that is above a limit the person gave. Suggestions stay inside OXYGEN (a task or a note); contacting anyone needs its own approval.";
 function isRecurringCompanyMonitoringIntent(query) {
     return /\b(companies|company|competitors?)\b/.test(query)
         && /\b(monitor(?:ing)?|watch(?:ing|list)?|track(?:ing)?)\b/.test(query)

package/node_modules/@oxygen/shared/dist/contracts/clay-migration.d.ts

@@ -58,6 +58,7 @@ export declare const CLAY_MIGRATION_CONTRACT: import("./schema.js").ContractObje
         enum: readonly ("columns" | "fields" | "graph" | "metadata" | "record_ids" | "records" | "row" | "rows" | "sequence")[];
         description?: string;
     };
+    readonly full: import("./schema.js").BooleanProperty;
     readonly path: import("./schema.js").StringProperty;
     readonly text_offset: {
         type: "integer";

package/node_modules/@oxygen/shared/dist/contracts/clay-migration.js

@@ -2,6 +2,10 @@ import { arr, bool, enumOf, int, obj, str } from "./schema.js";
 export const CLAY_MIGRATION_ACTIONS = ["connect", "status", "discover", "read", "transfer", "checkpoint", "report", "disconnect"];
 export const CLAY_RESOURCE_TYPES = ["workspace", "folder", "workbook", "table", "audience", "workflow", "function", "claygent", "knowledge", "schedule", "campaign"];
 export const CLAY_RESOURCE_DISPOSITIONS = ["pending", "copied", "rebuilt", "needs_decision", "unsupported", "inaccessible", "excluded", "failed"];
+const FULL_READ_SECTIONS = {
+    table: ["metadata", "columns", "rows", "row"], audience: ["metadata", "fields", "record_ids", "records"],
+    workflow: ["metadata", "graph"], campaign: ["metadata", "sequence"],
+};
 export const CLAY_GLOBAL_AUDIENCE_SCOPES = {
     "global-people": { entity_type: "people", global: true },
     "global-companies": { entity_type: "companies", global: true },
@@ -21,6 +25,7 @@ export const CLAY_MIGRATION_CONTRACT = obj({
     resource_id: str({ minLength: 1, maxLength: 256 }),
     row_id: str({ minLength: 1, maxLength: 200, pattern: "^[a-zA-Z0-9][a-zA-Z0-9_-]*$", description: "Source row ID for table read section=row; retains structured cell fields separately from displayed values." }),
     section: enumOf(["metadata", "columns", "rows", "row", "graph", "fields", "record_ids", "records", "sequence"]),
+    full: bool({ description: "Export one entire adapter response (8 MiB data + 1 MiB envelope); config credential redaction applies. No path/text projection. Discover omits derived resources; use report for dispositions/targets." }),
     path: str({ minLength: 1, maxLength: 1000, description: "Dotted path or JSON pointer into a source response, e.g. cells.f_1.fields." }),
     text_offset: int({ minimum: 0, maximum: 8388608, description: "Continue a large scalar read at next_text_offset." }),
     entity_type: enumOf(["people", "companies", "deals"]),
@@ -57,6 +62,27 @@ export function clayMigrationInputIssues(args) {
     }
     if (args.action === "checkpoint")
         requireField("disposition");
+    if (args.full !== undefined && !["read", "discover"].includes(String(args.action)))
+        issues.push({ path: "full", message: "full is only available for read or discover." });
+    if (args.full === true) {
+        if (args.action === "discover") {
+            requireField("resource_type");
+            for (const key of ["section", "resource_id", "record_ids"]) {
+                if (args[key] !== undefined)
+                    issues.push({ path: key, message: `${key} is unavailable for a complete catalog response; use read for an individual resource section.` });
+            }
+        }
+        const sections = Object.hasOwn(FULL_READ_SECTIONS, String(args.resource_type)) ? FULL_READ_SECTIONS[args.resource_type] : ["metadata"];
+        if (args.action === "read" && !sections.includes(String(args.section ?? "metadata"))) {
+            issues.push({ path: "section", message: "This resource does not expose that section for complete export." });
+        }
+        if (args.entity_type !== undefined && args.resource_type !== "audience")
+            issues.push({ path: "entity_type", message: "entity_type only identifies Audience source responses." });
+        for (const key of ["path", "text_offset"]) {
+            if (args[key] !== undefined)
+                issues.push({ path: key, message: `${key} cannot be combined with full; export the entire response or inspect a projection.` });
+        }
+    }
     if (args.section === "records") {
         requireField("entity_type");
         requireField("record_ids");
@@ -82,7 +108,7 @@ export const CLAY_MIGRATION_OPERATION = {
     id: "clay.migration", route: "/api/cli/migrations/clay", method: "POST",
     contract: CLAY_MIGRATION_CONTRACT, inputCheck: clayMigrationInputIssues,
     generated: { cli: false, mcp: false },
-    cli: { path: ["clay", "migration"], summary: "Migrate a Clay workspace into Oxygen: connect, discover source configuration, inspect bounded samples, transfer table and Audience rows, checkpoint native rebuilds and reconcile coverage. Creates no paid runs or active schedules." },
-    mcp: { name: "oxygen_clay_migration", title: "Oxygen: Migrate from Clay", description: "Connect to Clay with browser sign-in, discover resources, read source configuration and samples, transfer table and Audience rows to existing Oxygen tables, checkpoint rebuilds and report coverage. Use native Oxygen tools to create targets and rebuild behavior. Follow cursors; report unsupported or inaccessible resources. Never activates schedules or paid runs.", pack: "integrations", annotations: { openWorldHint: true, destructiveHint: false, idempotentHint: false } },
+    cli: { path: ["clay", "migration"], summary: "Migrate a Clay workspace into Oxygen: connect, discover configuration, inspect samples or export complete responses, transfer table and Audience rows, checkpoint native rebuilds and reconcile coverage. Creates no paid runs or active schedules. Complete exports (--full): 8 MiB data + 1 MiB envelope. Full discovery omits derived resources; report retains dispositions and targets." },
+    mcp: { name: "oxygen_clay_migration", title: "Oxygen: Migrate from Clay", description: "Connect to Clay with browser sign-in, discover resources, inspect or export complete source responses, transfer table and Audience rows to existing Oxygen tables, checkpoint rebuilds and report coverage. Use native Oxygen tools to create targets and rebuild behavior. Follow cursors; report unsupported or inaccessible resources. Never activates schedules or paid runs. Full exports: 8 MiB data + 1 MiB envelope; discover omits derived resources, report retains dispositions and targets.", pack: "integrations", annotations: { openWorldHint: true, destructiveHint: false, idempotentHint: false } },
     mutates: true, spends: false,
 };

package/node_modules/@oxygen/shared/dist/contracts/copilot-attachment-read.d.ts

@@ -0,0 +1,24 @@
+export declare const COPILOT_ATTACHMENT_READ_CONTRACT: import("./schema.js").ContractObject<{
+    readonly offset: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly limit: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly version: import("./schema.js").StringProperty;
+    readonly max_chars: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+}, never>;

package/node_modules/@oxygen/shared/dist/contracts/copilot-attachment-read.js

@@ -0,0 +1,7 @@
+import { int, obj, str } from "./schema.js";
+export const COPILOT_ATTACHMENT_READ_CONTRACT = obj({
+    offset: int({ minimum: 0, maximum: 512 * 1024 * 1024, description: "Byte offset; default 0. Resume at next_offset." }),
+    limit: int({ minimum: 1, maximum: 2048, description: "Original bytes requested; default 2048. Context bounds may return fewer." }),
+    version: str({ minLength: 64, maxLength: 64, description: "Opaque file revision returned by the first read; required when resuming." }),
+    max_chars: int({ minimum: 1024, maximum: 40_000, description: "Complete serialized byte-window size." }),
+});

package/node_modules/@oxygen/shared/dist/contracts/teammates.js

@@ -136,7 +136,12 @@ export const TEAMMATE_OPERATIONS = [
         make_admin: GROUP_PEOPLE("People in it to make admins, by workspace email."),
         remove_admin: GROUP_PEOPLE("Admins to make members again, by workspace email; a group keeps at least one admin."),
     }),
-    teammateGroupOperation("teammate_groups.message", "group_message", "POST", "/{group_id}/messages", "Send a message in a group chat. The Oxygents it @mentions answer, in order; with no mention, the Oxygents it is for answer, or, in a group of only you, whoever answered last. A message that @mentions only people goes to them. In a group with other people, each answer waits for the one before it, and paid or external actions ask whoever sent the message. Each answer is a turn billed from workspace credits.", { message: str({ minLength: 1, maxLength: 16000 }) }, ["message"], true),
+    teammateGroupOperation("teammate_groups.message", "group_message", "POST", "/{group_id}/messages", "Send a message and uploaded files in a group chat. group_id is its Copilot session id: upload with oxygen copilot attach <group_id> <path>, inspect files with copilot attachments (oxygen_copilot_attachments), then bind attachment_ids here; read messages with copilot get (oxygen_copilot_get). The Oxygents it @mentions answer in order; otherwise those it is for answer, or whoever answered last in a group of only you. A mention of only people goes to them. Answers wait for earlier ones and are billed from workspace credits; paid or external actions ask the sender.", {
+        message: str({ minLength: 1, maxLength: 16000 }),
+        attachment_ids: arr(str({ pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" }), {
+            description: "File UUIDs uploaded by you to this group session and ready to send. Omit for text only.",
+        }),
+    }, ["message"], true),
     teammateGroupOperation("teammate_groups.read", "group_read", "POST", "/{group_id}/read", "Mark a group chat read up to its newest turn, or up to turn_index.", { turn_index: int({ minimum: 0 }) }),
     teammateGroupOperation("teammate_groups.leave", "group_leave", "POST", "/{group_id}/leave", "Leave a group chat: it disappears for you and its Oxygents stop answering your waiting messages. If you were its last admin, whoever has been in it longest becomes one; if you were the last person, it ends."),
     teammateGroupOperation("teammate_groups.end", "group_end", "POST", "/{group_id}/end", "End a group chat for everyone in it, as one of its admins: nobody answers in it again, and its messages stay readable."),

package/node_modules/@oxygen/shared/dist/email-brand-kit.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The workspace's newsletter brand kit (tenant table ox_sequencer.email_brand_kit,
+ * migration 0559): the logo, colours, width and font newsletters are designed
+ * with, the company name and postal address every bulk email carries in its
+ * footer, social links and the preference page's title.
+ *
+ * One parser serves the `/api/cli/sequencer/brand-kit` route (web, CLI, MCP):
+ * a patch names only the fields it changes, `null` clears one (a colour, width
+ * or font falls back to its default). Pure and browser-safe.
+ */
+export declare const EMAIL_BRAND_FONT_FAMILIES: readonly ["system", "georgia", "arial", "helvetica", "verdana"];
+export type EmailBrandFontFamily = typeof EMAIL_BRAND_FONT_FAMILIES[number];
+export declare const EMAIL_BRAND_FONT_LABELS: Record<EmailBrandFontFamily, string>;
+/** The CSS font stack each allowlisted family renders with in an email. */
+export declare const EMAIL_BRAND_FONT_STACKS: Record<EmailBrandFontFamily, string>;
+export declare const EMAIL_BRAND_SOCIAL_NETWORKS: readonly ["website", "linkedin", "x", "facebook", "instagram", "youtube", "tiktok", "github"];
+export type EmailBrandSocialNetwork = typeof EMAIL_BRAND_SOCIAL_NETWORKS[number];
+export declare const EMAIL_BRAND_COLOR_FIELDS: readonly ["background_color", "content_background_color", "text_color", "link_color", "button_color", "button_text_color"];
+export type EmailBrandColorField = typeof EMAIL_BRAND_COLOR_FIELDS[number];
+export declare const EMAIL_BRAND_LIMITS: {
+    readonly containerWidthMin: 480;
+    readonly containerWidthMax: 800;
+    readonly logoWidthMin: 40;
+    readonly logoWidthMax: 600;
+    readonly urlMax: 2048;
+    readonly companyNameMax: 120;
+    readonly postalAddressMax: 500;
+    readonly socialLinksMax: 10;
+    readonly preferencePageTitleMax: 120;
+    readonly preferencePageDescriptionMax: 500;
+};
+export type EmailBrandSocialLink = {
+    network: EmailBrandSocialNetwork;
+    url: string;
+};
+/** The kit as every surface reads it (snake_case wire shape), defaults applied. */
+export type EmailBrandKit = {
+    logo_url: string | null;
+    logo_width: number | null;
+    background_color: string;
+    content_background_color: string;
+    text_color: string;
+    link_color: string;
+    button_color: string;
+    button_text_color: string;
+    container_width: number;
+    font_family: EmailBrandFontFamily;
+    company_name: string | null;
+    postal_address: string | null;
+    social_links: EmailBrandSocialLink[];
+    preference_page_title: string | null;
+    preference_page_description: string | null;
+    updated_by: string | null;
+    updated_at: string | null;
+};
+export declare const DEFAULT_EMAIL_BRAND_COLORS: Record<EmailBrandColorField, string>;
+export declare const DEFAULT_EMAIL_BRAND_KIT: EmailBrandKit;
+/** Every editable field; a patch names a subset. */
+export declare const EMAIL_BRAND_KIT_FIELDS: readonly ["logo_url", "logo_width", "background_color", "content_background_color", "text_color", "link_color", "button_color", "button_text_color", "container_width", "font_family", "company_name", "postal_address", "social_links", "preference_page_title", "preference_page_description"];
+export type EmailBrandKitField = typeof EMAIL_BRAND_KIT_FIELDS[number];
+/** A validated change: a present key is written, `null` clears it. */
+export type EmailBrandKitPatch = {
+    logo_url?: string | null;
+    logo_width?: number | null;
+    background_color?: string | null;
+    content_background_color?: string | null;
+    text_color?: string | null;
+    link_color?: string | null;
+    button_color?: string | null;
+    button_text_color?: string | null;
+    container_width?: number | null;
+    font_family?: EmailBrandFontFamily | null;
+    company_name?: string | null;
+    postal_address?: string | null;
+    social_links?: EmailBrandSocialLink[] | null;
+    preference_page_title?: string | null;
+    preference_page_description?: string | null;
+};
+export declare class EmailBrandKitInputError extends Error {
+    readonly field: string;
+    readonly code = "invalid_brand_kit";
+    constructor(field: string, message: string);
+}
+/** `#rrggbb` lowercase from `#rrggbb`, `rrggbb` or `#rgb`; throws on anything else. */
+export declare function normalizeBrandColor(value: unknown, field: string): string;
+/** An absolute https URL; email clients block or warn on plain http images and links. */
+export declare function normalizeBrandUrl(value: unknown, field: string): string;
+export declare function isEmailBrandFontFamily(value: unknown): value is EmailBrandFontFamily;
+/**
+ * Validate a brand kit change. Only the named fields are returned; `null` (or
+ * an empty string for text) clears one. Throws `EmailBrandKitInputError` naming
+ * the field, and refuses a body that names no field.
+ */
+export declare function parseEmailBrandKitPatch(body: Record<string, unknown>): EmailBrandKitPatch;
+/** A newsletter may go live only once the kit carries a postal address. */
+export declare function brandKitHasPostalAddress(kit: Pick<EmailBrandKit, "postal_address"> | null | undefined): boolean;
+/** The email editor's global styles, as the composer and its preview consume them. */
+export type EmailBrandGlobalStyles = {
+    background: string;
+    contentBackground: string;
+    text: string;
+    link: string;
+    button: string;
+    buttonText: string;
+    containerWidth: number;
+    fontFamily: string;
+};
+export declare function brandKitGlobalStyles(kit: Partial<EmailBrandKit> | null | undefined): EmailBrandGlobalStyles;