@oxygen-agent/cli 1.1014.1343 → 1.1014.1420

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

@@ -12,9 +12,6 @@ import { BROWSER_OPERATIONS } from "./browser-operations.js";
 import { TABLE_FEED_UPDATE_OPERATION } from "./table-feed-update.js";
 import { GEO_OPERATIONS } from "./geo.js";
 import { CUSTOMER_OPERATIONS } from "./customer-operations.js";
-import { GUIDED_ONBOARDING_JOURNEY_OPERATIONS } from "./guided-onboarding-journey.js";
-import { GUIDED_FIRST_SOURCING_OPERATIONS } from "./guided-first-sourcing.js";
-import { GUIDED_COMPANY_FILE_UPLOAD_OPERATION } from "./guided-company-files.js";
 import { GUIDED_ACTIVATION_OPERATIONS } from "./guided-activation.js";
 import { AGENT_SESSION_OPERATIONS } from "./agent-sessions.js";
 import { REPLY_OXYGENT_OPERATIONS } from "./reply-oxygent.js";
@@ -63,6 +60,6 @@ export function operationFormData(spec, body) {
     }
     return form;
 }
-export const OPERATION_SPECS = [SENDER_LIMITS_SET_OPERATION, CONNECTOR_UPDATE_OPERATION, CONNECTOR_EVENTS_REVOKE_OPERATION, WORKSPACE_PAGES_GET_OPERATION, WORKSPACE_PAGES_UPDATE_OPERATION, TABLE_FEED_UPDATE_OPERATION, ...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...GUIDED_ONBOARDING_JOURNEY_OPERATIONS, ...GUIDED_FIRST_SOURCING_OPERATIONS, GUIDED_COMPANY_FILE_UPLOAD_OPERATION, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS];
-export const CLI_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...GUIDED_ONBOARDING_JOURNEY_OPERATIONS, ...GUIDED_FIRST_SOURCING_OPERATIONS, GUIDED_COMPANY_FILE_UPLOAD_OPERATION, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.cli !== false);
-export const MCP_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...GUIDED_ONBOARDING_JOURNEY_OPERATIONS, ...GUIDED_FIRST_SOURCING_OPERATIONS, GUIDED_COMPANY_FILE_UPLOAD_OPERATION, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.mcp !== false);
+export const OPERATION_SPECS = [SENDER_LIMITS_SET_OPERATION, CONNECTOR_UPDATE_OPERATION, CONNECTOR_EVENTS_REVOKE_OPERATION, WORKSPACE_PAGES_GET_OPERATION, WORKSPACE_PAGES_UPDATE_OPERATION, TABLE_FEED_UPDATE_OPERATION, ...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS];
+export const CLI_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.cli !== false);
+export const MCP_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.mcp !== false);

package/node_modules/@oxygen/shared/dist/contracts/table-query-raw.d.ts

@@ -13,4 +13,8 @@ export declare const TABLE_QUERY_CLI_DEFAULT_MAX_CHARS = 12000;
 export declare function tableQueryRawResultFits(data: Record<string, unknown>, maxChars: number | undefined): boolean;
 /** What a page shortened to fit its result window says to do next (CLI, MCP and API alike). */
 export declare const TABLE_QUERY_RESULT_WINDOW_NEXT_STEP: string;
-export declare function tableQueryRawRecovery(table: string, row?: string): Record<string, unknown>;
+/** The field whose value is longest in a row (system fields excluded): the one to drop or inspect. */
+export declare function tableRowWidestField(row: unknown): string | undefined;
+/** Leads a refusal's next step with the exact field to drop or inspect, when the row is known. */
+export declare function tableQueryWidestFieldStep(widestField: string | undefined): string;
+export declare function tableQueryRawRecovery(table: string, row?: string, firstRow?: unknown): Record<string, unknown>;

package/node_modules/@oxygen/shared/dist/contracts/table-query-raw.js

@@ -12,10 +12,33 @@ export function tableQueryRawResultFits(data, maxChars) {
 /** What a page shortened to fit its result window says to do next (CLI, MCP and API alike). */
 export const TABLE_QUERY_RESULT_WINDOW_NEXT_STEP = "This page holds fewer rows than the limit so it fits the result window; every value is complete. "
     + "Continue with nextCursor (same table, filters, sorts and fields), or select fewer fields for more rows per page.";
-export function tableQueryRawRecovery(table, row) {
+/** The field whose value is longest in a row (system fields excluded): the one to drop or inspect. */
+export function tableRowWidestField(row) {
+    if (!row || typeof row !== "object" || Array.isArray(row))
+        return undefined;
+    let widest;
+    let widestLength = 0;
+    for (const [key, value] of Object.entries(row)) {
+        if (key.startsWith("_") || value === undefined)
+            continue;
+        const length = JSON.stringify(value).length;
+        if (length > widestLength) {
+            widest = key;
+            widestLength = length;
+        }
+    }
+    return widest;
+}
+/** Leads a refusal's next step with the exact field to drop or inspect, when the row is known. */
+export function tableQueryWidestFieldStep(widestField) {
+    return widestField ? `Field \`${widestField}\` is the largest value in that row: drop it from fields or inspect it. ` : "";
+}
+export function tableQueryRawRecovery(table, row, firstRow) {
+    const widestField = tableRowWidestField(firstRow);
     return {
         table,
         ...(row ? { row } : {}),
-        next_step: "Reduce fields/limit. Inspect a large cell with `tables rows inspect --table <table> --row <row> --field <field> --projection value --path /row/<field>/<key>`; select a JSON Pointer and continue with value_cursor. MCP: hydrate oxygen_table_row_inspect with oxygen_capabilities_schema, then dispatch it through oxygen_capabilities_read. CLI: --full restores legacy reads; --output <path> keeps full JSON outside context.",
+        ...(widestField ? { widest_field: widestField } : {}),
+        next_step: tableQueryWidestFieldStep(widestField) + "Reduce fields/limit. Inspect a large cell with `tables rows inspect --table <table> --row <row> --field <field> --projection value --path /row/<field>/<key>`; select a JSON Pointer and continue with value_cursor. MCP: hydrate oxygen_table_row_inspect with oxygen_capabilities_schema, then dispatch it through oxygen_capabilities_read. CLI: --full restores legacy reads; --output <path> keeps full JSON outside context.",
     };
 }

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

@@ -5,7 +5,7 @@ import { NEW_TEAMMATE_NAME, TEAMMATE_AVATAR_COLORS, TEAMMATE_AVATAR_KEYS, TEAMMA
 import { arr, bool, enumOf, int, obj, str } from "./schema.js";
 /**
  * AI teammates (ADR 0032), branded Oxygents: Agents with one ongoing chat,
- * shared by default or Personal, the workspace's first one ("New Bot" until named) and
+ * shared by default or Personal, the workspace's first one ("Oxygent" until named) and
  * any others added, none with a role (Tim, 2026-10-13). Every member but a client
  * login has them where the workspace does (launched 2026-10-17).
  * The people-facing names say Oxygent (`oxygen oxygents`, `oxygen_oxygents_*`,

package/node_modules/@oxygen/shared/dist/enrollment-origin.d.ts

@@ -16,7 +16,9 @@ export type EnrollmentOriginKind = typeof ENROLLMENT_ORIGIN_KINDS[number];
 export declare const ENROLLMENT_ACTOR_TYPES: readonly ["user", "agent", "workflow", "api_key", "system"];
 export type EnrollmentActorType = typeof ENROLLMENT_ACTOR_TYPES[number];
 /** The surface the enroll call came through. */
-export declare const ENROLLMENT_GATEWAYS: readonly ["cli", "mcp", "web", "copilot", "agent", "workflow", "engagement_watch"];
+export declare const ENROLLMENT_GATEWAYS: readonly ["cli", "mcp", "web", "copilot", "agent", "workflow", "engagement_watch", 
+/** The scheduled sync that enrolls new rows of a live campaign's bound table. */
+"table_sync"];
 export type EnrollmentGateway = typeof ENROLLMENT_GATEWAYS[number];
 export declare const ENROLLMENT_REF_TYPES: readonly ["workflow_run", "agent_run", "copilot_session", "engagement_watch", "guided_activation"];
 export type EnrollmentRefType = typeof ENROLLMENT_REF_TYPES[number];

package/node_modules/@oxygen/shared/dist/enrollment-origin.js

@@ -31,6 +31,8 @@ export const ENROLLMENT_GATEWAYS = [
     "agent",
     "workflow",
     "engagement_watch",
+    /** The scheduled sync that enrolls new rows of a live campaign's bound table. */
+    "table_sync",
 ];
 export const ENROLLMENT_REF_TYPES = [
     "workflow_run",

package/node_modules/@oxygen/shared/dist/guided-activation.d.ts

@@ -47,11 +47,13 @@ export type GuidedActivation = {
     resources: GuidedActivationResources;
     outcomes: Partial<Record<"first_leads" | "sequence" | "launch" | GuidedActivationPurpose, "proposed" | "armed" | "launched" | "confirmed_sent" | "paused">>;
     reviews: Partial<Record<GuidedActivationReview["purpose"], GuidedActivationReview>>;
+    /** `finished_at`: the person chose a play (or closed onboarding), so the chat is an ordinary Oxygent chat again. */
     onboarding_start: {
         state: "claimed" | "posted";
         chat_id: string;
         turn_id?: string;
         event_seq?: number;
+        finished_at?: string;
     } | null;
     last_fault: {
         code: string;

package/node_modules/@oxygen/shared/dist/guided-onboarding-company-context.d.ts

@@ -1,4 +1,3 @@
-import type { GuidedOnboardingAnswers } from "./guided-onboarding-journey.js";
 /** One native-supported input budget for web/CLI/MCP and D research preparation. */
 export declare const GUIDED_ONBOARDING_COMPANY_CONTEXT_LIMITS: {
     readonly descriptionChars: 6000;
@@ -7,6 +6,14 @@ export declare const GUIDED_ONBOARDING_COMPANY_CONTEXT_LIMITS: {
     readonly nameChars: 160;
     readonly urlChars: 2000;
 };
+/** Company context saved on a guided activation; the knowledge bootstrap still reads it. */
+export type GuidedOnboardingCompanyContext = {
+    website: string | null;
+    name: string;
+    description: string;
+    context_links: string[];
+    file_ids: string[];
+};
 export declare const GUIDED_ONBOARDING_COMPANY_CONTEXT_CONTRACT: import("./contracts/schema.js").ContractObject<{
     readonly website: {
         oneOf: [import("./contracts/schema.js").StringProperty, import("./contracts/schema.js").NullProperty];
@@ -19,4 +26,4 @@ export declare const GUIDED_ONBOARDING_COMPANY_CONTEXT_CONTRACT: import("./contr
 }, "context_links" | "description" | "file_ids" | "name" | "website">;
 /** Input-only rule; existing evidence links retain their independent navigation policy. */
 export declare function normalizeGuidedOnboardingContextLink(value: string): string;
-export declare function normalizeGuidedOnboardingCompanyContext(input: unknown): NonNullable<GuidedOnboardingAnswers["company_context"]>;
+export declare function normalizeGuidedOnboardingCompanyContext(input: unknown): GuidedOnboardingCompanyContext;

package/node_modules/@oxygen/shared/dist/guided-trial-billing.d.ts

@@ -1,4 +1,5 @@
-/** DEV onboarding offer. Existing subscription terms and production acquisition stay intact. */
+/** Retired DEV onboarding trial offer. New checkouts no longer create it; the
+ * marker still identifies subscriptions that were started under it. */
 export declare const GUIDED_TRIAL_OFFER: {
     readonly key: "guided_onboarding_v2";
     readonly plan: "oxygen_49";
@@ -10,7 +11,6 @@ export declare const GUIDED_TRIAL_OFFER: {
     readonly card_required: true;
     readonly early_charge_allowed: false;
 };
-export declare function guidedTrialAcquisitionEnabled(env?: Record<string, string | undefined>): boolean;
 export declare function isGuidedTrialSubscription(metadata: Record<string, unknown> | null | undefined): boolean;
 export type GuidedTrialBilling = {
     offer: typeof GUIDED_TRIAL_OFFER;
@@ -24,3 +24,11 @@ export type GuidedTrialBilling = {
     spendable_credits: number;
     funded_work_paused: boolean;
 };
+/** Read projection from native billing: a paid plan or a retained guided trial. */
+export type GuidedOnboardingEligibility = {
+    state: "unverified" | "checkout_required" | "checkout_pending" | "eligible" | "unavailable";
+    basis: "paid" | "trial" | null;
+    subscription_id: string | null;
+    observed_at: string | null;
+    trial_ends_at: string | null;
+};

package/node_modules/@oxygen/shared/dist/guided-trial-billing.js

@@ -1,5 +1,5 @@
-import { guidedActivationEnabled } from "./guided-activation.js";
-/** DEV onboarding offer. Existing subscription terms and production acquisition stay intact. */
+/** Retired DEV onboarding trial offer. New checkouts no longer create it; the
+ * marker still identifies subscriptions that were started under it. */
 export const GUIDED_TRIAL_OFFER = {
     key: "guided_onboarding_v2",
     plan: "oxygen_49",
@@ -11,9 +11,6 @@ export const GUIDED_TRIAL_OFFER = {
     card_required: true,
     early_charge_allowed: false,
 };
-export function guidedTrialAcquisitionEnabled(env = process.env) {
-    return guidedActivationEnabled(env);
-}
 export function isGuidedTrialSubscription(metadata) {
     return metadata?.oxygen_trial_offer === GUIDED_TRIAL_OFFER.key;
 }

package/node_modules/@oxygen/shared/dist/knowledge-bootstrap.d.ts

@@ -256,6 +256,12 @@ export type KnowledgeBootstrapConsent = {
     source: string | null;
     /** Clerk user who accepted, when the surface knows. Informational. */
     granted_by_clerk_user_id: string | null;
+    /**
+     * `agent`: agent-led onboarding (Philipp, 2026-10-19). The Oxygent researches the
+     * company in the chat with its sub-agents, so the automatic background pass and
+     * the brain draft do not run; a manual request still does.
+     */
+    research?: "agent";
 };
 /**
  * Read consent out of an organization's control-DB metadata blob, FAIL-CLOSED.

package/node_modules/@oxygen/shared/dist/knowledge-bootstrap.js

@@ -243,6 +243,7 @@ function readGrant(raw) {
             ...(creatorLinkedinUrl ? { creator_linkedin_url: creatorLinkedinUrl } : {}),
             source: typeof record.source === "string" && record.source.length > 0 ? record.source : null,
             granted_by_clerk_user_id: grantedBy,
+            ...(record.research === "agent" ? { research: "agent" } : {}),
         },
     };
 }

package/node_modules/@oxygen/shared/dist/onboarding-plays.d.ts

@@ -0,0 +1,68 @@
+export declare const ONBOARDING_PROPOSE_PLAYS_TOOL_NAME = "propose_plays";
+export declare const ONBOARDING_PLAY_LIMITS: {
+    readonly minPlays: 2;
+    readonly maxPlays: 4;
+    readonly titleChars: 80;
+    readonly lineChars: 240;
+    readonly slugChars: 120;
+};
+export type OnboardingPlay = {
+    id: string;
+    title: string;
+    /** Who it targets: segment and buyer. */
+    audience: string;
+    /** The signal or trigger it acts on. */
+    trigger: string | null;
+    /** The angle: what the message offers them. */
+    angle: string;
+    /** Why it fits this company, from the research. */
+    why: string | null;
+    /** What running it does first. */
+    firstStep: string;
+    /** The play's Knowledge page, when one was written. */
+    page: string | null;
+};
+export type OnboardingPlayProposal = {
+    id: string;
+    plays: OnboardingPlay[];
+};
+/** The proposal a chat is waiting on, as every surface reads it. */
+export type PendingOnboardingPlayProposal = OnboardingPlayProposal & {
+    turnId: string;
+};
+/** The tool's input schema, as the model reads it. */
+export declare const ONBOARDING_PROPOSE_PLAYS_INPUT_SCHEMA: Record<string, unknown>;
+/** Validate the plays the model proposed, minting ids. */
+export declare function normalizeOnboardingPlayProposal(args: Record<string, unknown>, mintId: () => string): {
+    ok: true;
+    proposal: OnboardingPlayProposal;
+} | {
+    ok: false;
+    message: string;
+};
+/** The proposal as the turn's reply: what the CLI and MCP print, and what the next turn reads back. */
+export declare function renderOnboardingPlayProposalText(proposal: OnboardingPlayProposal): string;
+/** Read a stored proposal back, refusing anything malformed. */
+export declare function readOnboardingPlayProposal(value: unknown): OnboardingPlayProposal | null;
+/** The message a chosen play sends, as the person's own. */
+export declare function onboardingPlayMessage(play: Pick<OnboardingPlay, "title" | "firstStep" | "page">): string;
+type ProjectionTurn = {
+    id: string;
+    status: string;
+    turnIndex: number;
+};
+type ProjectionEvent = {
+    turnId: string | null;
+    kind: string;
+    payload: Record<string, unknown>;
+};
+/**
+ * The plays the chat is waiting on, or null. Like a question, only the newest
+ * turn can be waiting, and only when it completed by proposing: choosing one
+ * sends a new message, which is the end of the wait.
+ */
+export declare function projectPendingOnboardingPlayProposal(input: {
+    turns: readonly ProjectionTurn[];
+    events: readonly ProjectionEvent[];
+}): PendingOnboardingPlayProposal | null;
+export {};

package/node_modules/@oxygen/shared/dist/onboarding-plays.js

@@ -0,0 +1,114 @@
+// Agent-led onboarding (Philipp, 2026-10-19): the onboarding turn ends with a
+// few proposed outbound plays as cards. Choosing one has the Oxygent run it in
+// the chat, as an ordinary message the person sent; typing steers instead.
+//
+// One owner for the contract, because four readers depend on it: the tool that
+// validates the model's proposal, the session read that projects the pending
+// one, the card that shows it and the route that runs the chosen play.
+export const ONBOARDING_PROPOSE_PLAYS_TOOL_NAME = "propose_plays";
+export const ONBOARDING_PLAY_LIMITS = {
+    minPlays: 2,
+    maxPlays: 4,
+    titleChars: 80,
+    lineChars: 240,
+    slugChars: 120,
+};
+const line = (description) => ({ type: "string", minLength: 1, maxLength: ONBOARDING_PLAY_LIMITS.lineChars, description });
+/** The tool's input schema, as the model reads it. */
+export const ONBOARDING_PROPOSE_PLAYS_INPUT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        plays: {
+            type: "array",
+            minItems: ONBOARDING_PLAY_LIMITS.minPlays,
+            maxItems: ONBOARDING_PLAY_LIMITS.maxPlays,
+            items: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    title: { type: "string", minLength: 1, maxLength: ONBOARDING_PLAY_LIMITS.titleChars, description: "Short name, e.g. \"New VP Sales at Series A SaaS\"." },
+                    audience: line("Who: the segment and the buyer persona."),
+                    trigger: line("The signal or event that makes now the moment, if any."),
+                    angle: line("What the outreach offers them, in one line."),
+                    why: line("Why this fits this company, from the research."),
+                    first_step: line("What running it does first, e.g. \"Find 50 matching accounts and their VP Sales\"."),
+                    page: { type: "string", maxLength: ONBOARDING_PLAY_LIMITS.slugChars, description: "The play's Knowledge page slug, if you wrote one." },
+                },
+                required: ["title", "audience", "angle", "first_step"],
+            },
+        },
+    },
+    required: ["plays"],
+};
+const clean = (value, max) => typeof value === "string" ? value.replace(/\s+/g, " ").trim().slice(0, max) : "";
+/** Validate the plays the model proposed, minting ids. */
+export function normalizeOnboardingPlayProposal(args, mintId) {
+    const raw = Array.isArray(args.plays) ? args.plays : [];
+    const plays = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry))
+            continue;
+        const record = entry;
+        const title = clean(record.title, ONBOARDING_PLAY_LIMITS.titleChars);
+        const audience = clean(record.audience, ONBOARDING_PLAY_LIMITS.lineChars);
+        const angle = clean(record.angle, ONBOARDING_PLAY_LIMITS.lineChars);
+        const firstStep = clean(record.first_step ?? record.firstStep, ONBOARDING_PLAY_LIMITS.lineChars);
+        if (!title || !audience || !angle || !firstStep)
+            continue;
+        const trigger = clean(record.trigger, ONBOARDING_PLAY_LIMITS.lineChars);
+        const why = clean(record.why, ONBOARDING_PLAY_LIMITS.lineChars);
+        const page = clean(record.page, ONBOARDING_PLAY_LIMITS.slugChars);
+        plays.push({ id: typeof record.id === "string" && record.id ? record.id : mintId(), title, audience, trigger: trigger || null,
+            angle, why: why || null, firstStep, page: /^[a-z0-9][a-z0-9-]*$/.test(page) ? page : null });
+    }
+    if (plays.length < ONBOARDING_PLAY_LIMITS.minPlays || plays.length > ONBOARDING_PLAY_LIMITS.maxPlays) {
+        return { ok: false, message: `Propose ${ONBOARDING_PLAY_LIMITS.minPlays} to ${ONBOARDING_PLAY_LIMITS.maxPlays} plays, each with a title, audience, angle and first step.` };
+    }
+    return { ok: true, proposal: { id: typeof args.id === "string" && args.id ? args.id : mintId(), plays } };
+}
+/** The proposal as the turn's reply: what the CLI and MCP print, and what the next turn reads back. */
+export function renderOnboardingPlayProposalText(proposal) {
+    return [
+        "Plays I'd run first:",
+        ...proposal.plays.map((play, index) => `${index + 1}. **${play.title}**: ${play.audience}. ${play.angle}`),
+        "Pick one to start it, or tell me what to change.",
+    ].join("\n");
+}
+/** Read a stored proposal back, refusing anything malformed. */
+export function readOnboardingPlayProposal(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const record = value;
+    if (typeof record.id !== "string" || !record.id)
+        return null;
+    const normalized = normalizeOnboardingPlayProposal(record, () => "");
+    return normalized.ok && normalized.proposal.plays.every((play) => play.id) ? normalized.proposal : null;
+}
+/** The message a chosen play sends, as the person's own. */
+export function onboardingPlayMessage(play) {
+    return `Run the play "${play.title}". Start with: ${play.firstStep}${play.page ? ` (see [[${play.page}]])` : ""}`;
+}
+/**
+ * The plays the chat is waiting on, or null. Like a question, only the newest
+ * turn can be waiting, and only when it completed by proposing: choosing one
+ * sends a new message, which is the end of the wait.
+ */
+export function projectPendingOnboardingPlayProposal(input) {
+    const newest = input.turns.reduce((latest, turn) => (latest === null || turn.turnIndex > latest.turnIndex ? turn : latest), null);
+    if (!newest || newest.status !== "completed")
+        return null;
+    for (let index = input.events.length - 1; index >= 0; index -= 1) {
+        const event = input.events[index];
+        if (!event || event.turnId !== newest.id || event.kind !== "tool_call_finished")
+            continue;
+        if (event.payload.tool !== ONBOARDING_PROPOSE_PLAYS_TOOL_NAME)
+            continue;
+        const result = event.payload.result;
+        if (!result || typeof result !== "object" || result.ok === false)
+            continue;
+        const proposal = readOnboardingPlayProposal(result.proposal);
+        return proposal ? { ...proposal, turnId: newest.id } : null;
+    }
+    return null;
+}

package/node_modules/@oxygen/shared/dist/onboarding-research.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Agent-led onboarding's research (Philipp, 2026-10-19; OXYGEN_PRODUCT.md
+ * "Agent-led onboarding"): the first "Start onboarding" turn of a guided
+ * activation is OXYGEN-funded, and its research sub-agents may search the web,
+ * read the company's site and LinkedIn, find its people and write draft
+ * Knowledge pages in parallel, without an approval card per call. These bounds
+ * are what replaces the card. Shared by the worker (the sub-agents' grant), the
+ * tool route (who pays) and the credit rail (the funding policy).
+ */
+export declare const ONBOARDING_RESEARCH_PURPOSE = "onboarding_research";
+/** The research sub-agent the onboarding turn delegates to. */
+export declare const ONBOARDING_RESEARCH_SUBAGENT = "onboarding_researcher";
+/** Provider credits OXYGEN pays for one workspace's onboarding research, over its lifetime. */
+export declare const ONBOARDING_RESEARCH_MAX_CREDITS = 300;
+/** Ceiling on any one research call; a call that names a higher one is lowered to it. */
+export declare const ONBOARDING_RESEARCH_MAX_CREDITS_PER_CALL = 15;
+/** The onboarding turn's own and its sub-agents' inference, credited back once the turn settles. */
+export declare const ONBOARDING_RESEARCH_INFERENCE_MAX_CREDITS = 150;
+/**
+ * Eight areas at once (offer, ICP, plays, signals, competitors, company
+ * LinkedIn, people, the signing-up person), with room for one follow-up pass.
+ */
+export declare const ONBOARDING_RESEARCH_SUBAGENT_LIMITS: {
+    readonly maxRuns: 12;
+    readonly maxParallelTasks: 8;
+    readonly maxInferencesPerRun: 8;
+    readonly maxCapabilityCallsPerRun: 24;
+};
+/**
+ * Read-only provider tools the research may call through `oxygen_tools_run_live`.
+ * Nothing here writes outside OXYGEN; the costly ones (competitor search at 61
+ * credits, large exa result sets) stay out or are capped per call.
+ */
+export declare const ONBOARDING_RESEARCH_TOOL_IDS: readonly ["serper.search", "exa.search", "exa.contents", "exa.find_similar", "firecrawl.map", "firecrawl.scrape", "web.page_fetch", "scraper.linkedin_company", "scraper.linkedin_profile", "scraper.linkedin_profile_search", "scraper.linkedin_job_search", "blitzapi.employee_search", "blitzapi.person_profile_enrich", "blitzapi.company_profile_enrich", "predictleads.company_news_events", "predictleads.company_job_openings", "predictleads.company_similar_companies"];
+export declare function onboardingResearchToolAllowed(toolId: unknown): boolean;
+/** Knowledge page types a research sub-agent may not write: canonical voice and positioning stay proposal-gated. */
+export declare const ONBOARDING_RESEARCH_DENIED_PAGE_TYPES: readonly ["voice", "brand", "positioning", "message_playbook", "playbook"];

package/node_modules/@oxygen/shared/dist/onboarding-research.js

@@ -0,0 +1,57 @@
+/**
+ * Agent-led onboarding's research (Philipp, 2026-10-19; OXYGEN_PRODUCT.md
+ * "Agent-led onboarding"): the first "Start onboarding" turn of a guided
+ * activation is OXYGEN-funded, and its research sub-agents may search the web,
+ * read the company's site and LinkedIn, find its people and write draft
+ * Knowledge pages in parallel, without an approval card per call. These bounds
+ * are what replaces the card. Shared by the worker (the sub-agents' grant), the
+ * tool route (who pays) and the credit rail (the funding policy).
+ */
+export const ONBOARDING_RESEARCH_PURPOSE = "onboarding_research";
+/** The research sub-agent the onboarding turn delegates to. */
+export const ONBOARDING_RESEARCH_SUBAGENT = "onboarding_researcher";
+/** Provider credits OXYGEN pays for one workspace's onboarding research, over its lifetime. */
+export const ONBOARDING_RESEARCH_MAX_CREDITS = 300;
+/** Ceiling on any one research call; a call that names a higher one is lowered to it. */
+export const ONBOARDING_RESEARCH_MAX_CREDITS_PER_CALL = 15;
+/** The onboarding turn's own and its sub-agents' inference, credited back once the turn settles. */
+export const ONBOARDING_RESEARCH_INFERENCE_MAX_CREDITS = 150;
+/**
+ * Eight areas at once (offer, ICP, plays, signals, competitors, company
+ * LinkedIn, people, the signing-up person), with room for one follow-up pass.
+ */
+export const ONBOARDING_RESEARCH_SUBAGENT_LIMITS = {
+    maxRuns: 12,
+    maxParallelTasks: 8,
+    maxInferencesPerRun: 8,
+    maxCapabilityCallsPerRun: 24,
+};
+/**
+ * Read-only provider tools the research may call through `oxygen_tools_run_live`.
+ * Nothing here writes outside OXYGEN; the costly ones (competitor search at 61
+ * credits, large exa result sets) stay out or are capped per call.
+ */
+export const ONBOARDING_RESEARCH_TOOL_IDS = [
+    "serper.search",
+    "exa.search",
+    "exa.contents",
+    "exa.find_similar",
+    "firecrawl.map",
+    "firecrawl.scrape",
+    "web.page_fetch",
+    "scraper.linkedin_company",
+    "scraper.linkedin_profile",
+    "scraper.linkedin_profile_search",
+    "scraper.linkedin_job_search",
+    "blitzapi.employee_search",
+    "blitzapi.person_profile_enrich",
+    "blitzapi.company_profile_enrich",
+    "predictleads.company_news_events",
+    "predictleads.company_job_openings",
+    "predictleads.company_similar_companies",
+];
+export function onboardingResearchToolAllowed(toolId) {
+    return typeof toolId === "string" && ONBOARDING_RESEARCH_TOOL_IDS.includes(toolId);
+}
+/** Knowledge page types a research sub-agent may not write: canonical voice and positioning stay proposal-gated. */
+export const ONBOARDING_RESEARCH_DENIED_PAGE_TYPES = ["voice", "brand", "positioning", "message_playbook", "playbook"];

package/node_modules/@oxygen/shared/dist/placement-copy.d.ts

@@ -0,0 +1,8 @@
+/** Browser-safe copy policy shared by placement forms and native request owners. */
+export declare const PLACEMENT_COPY_GUIDANCE = "Use the outreach email you would send to a prospect. Import a Sequence step or write realistic copy; do not use delivery-check text or no-reply notices.";
+export declare const PLACEMENT_SAMPLE_COPY: {
+    subject: string;
+    body_text: string;
+};
+/** Reject obvious diagnostic placeholders, without scoring or rewriting outreach. */
+export declare function placementCopyIssue(subject: string, bodyText: string, bodyHtml?: string): string | null;

package/node_modules/@oxygen/shared/dist/placement-copy.js

@@ -0,0 +1,16 @@
+/** Browser-safe copy policy shared by placement forms and native request owners. */
+export const PLACEMENT_COPY_GUIDANCE = "Use the outreach email you would send to a prospect. Import a Sequence step or write realistic copy; do not use delivery-check text or no-reply notices.";
+export const PLACEMENT_SAMPLE_COPY = {
+    subject: "A question about your outbound workflow",
+    body_text: "Hi,\n\nHow does your team move from a list of target accounts to personalized outreach today?\n\nWe help teams keep research, enrichment and follow-ups in one workspace so reps spend less time moving data between tools.\n\nWould it be useful to compare that with your current workflow?",
+};
+/** Reject obvious diagnostic placeholders, without scoring or rewriting outreach. */
+export function placementCopyIssue(subject, bodyText, bodyHtml) {
+    if (!subject.trim() || !bodyText.trim())
+        return PLACEMENT_COPY_GUIDANCE;
+    const diagnosticSubject = /^(?:(?:oxygen|emailguard|sendkit|dev|workspace|internal|plain|html)\s+)*(?:(?:inbox[ -]placement|inbox|deliverability|delivery|placement|spam|primary)(?:\s+(?:test|check|probe))|test\s+(?:email|message))(?:\s|[:—–-]|$)/i;
+    const diagnosticBody = /\b(?:this\s+(?:(?:email|message)\s+)?is\s+(?:an?\s+|the\s+)?(?:(?:oxygen|dev|workspace)\s+)*(?:inbox[ -]placement|inbox|deliverability|delivery|placement)\s+(?:test|check|probe)|no\s+(?:reply|response)\s+(?:is\s+)?(?:needed|required)|do\s+not\s+reply)\b/i;
+    const htmlText = bodyHtml?.replace(/<[^<>]*>/g, " ").replace(/&nbsp;|&#160;/gi, " ") ?? "";
+    return diagnosticSubject.test(subject.trim()) || diagnosticBody.test(bodyText) || diagnosticBody.test(htmlText)
+        ? PLACEMENT_COPY_GUIDANCE : null;
+}

package/node_modules/@oxygen/shared/dist/product-analytics-events.d.ts

@@ -25,6 +25,14 @@ export declare const PRODUCT_EVENTS: {
     readonly ONBOARDING_RESET: "onboarding_reset";
     readonly ACTIVATION_PATH_SELECTED: "activation_path_selected";
     readonly AGENT_CONNECTED: "agent_connected";
+    /**
+     * Browser-side, on onboarding's Install OXYGEN step (`/setup/agent`): what a
+     * founder did there before connecting or leaving. `action` is agent_selected,
+     * endpoint_copied, prompt_copied, connected, open_agent, open_oxygen,
+     * copilot_instead or skipped; `agent` is claude, chatgpt or cli;
+     * `seconds_on_step` is a number. A handful per signup, never per poll.
+     */
+    readonly AGENT_SETUP_ACTION: "agent_setup_action";
     readonly FIRST_RECORD_CREATED: "first_record_created";
     /**
      * The prescribed first play (inbound-led outbound), walked on ANY surface.

package/node_modules/@oxygen/shared/dist/product-analytics-events.js

@@ -25,6 +25,14 @@ export const PRODUCT_EVENTS = {
     ONBOARDING_RESET: "onboarding_reset",
     ACTIVATION_PATH_SELECTED: "activation_path_selected",
     AGENT_CONNECTED: "agent_connected",
+    /**
+     * Browser-side, on onboarding's Install OXYGEN step (`/setup/agent`): what a
+     * founder did there before connecting or leaving. `action` is agent_selected,
+     * endpoint_copied, prompt_copied, connected, open_agent, open_oxygen,
+     * copilot_instead or skipped; `agent` is claude, chatgpt or cli;
+     * `seconds_on_step` is a number. A handful per signup, never per poll.
+     */
+    AGENT_SETUP_ACTION: "agent_setup_action",
     FIRST_RECORD_CREATED: "first_record_created",
     /**
      * The prescribed first play (inbound-led outbound), walked on ANY surface.

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

@@ -701,13 +701,40 @@ export type SequenceStopStep = {
  *   emailsUnsubscribed   → { signal: "email_unsubscribed" }
  *   aircallDone          → out of scope (no Aircall integration)
  * Negate any leaf with present:false (e.g. "no email on file" = { has_column: "email", present: false }).
+ *
+ * A CONTACT leaf `{ has_contact: "email" | "linkedin" | "phone", present? }` asks
+ * whether the step that channel needs could reach the lead, resolved exactly as
+ * dispatch resolves it: email and phone through the sequence's mapped column with
+ * the built-in fallbacks, LinkedIn through the profile captured at enrollment. It
+ * is what "If has email / LinkedIn / phone" in the builder writes, so one campaign
+ * can route every lead instead of splitting the audience by data.
+ */
+export declare const SEQUENCE_CONTACT_CHANNELS: readonly ["email", "linkedin", "phone"];
+export type SequenceContactChannel = (typeof SEQUENCE_CONTACT_CHANNELS)[number];
+/** What a lead can be reached by, as dispatch resolves it; a contact leaf reads this. */
+export type SequenceLeadContacts = Record<SequenceContactChannel, boolean>;
+/**
+ * Resolve a lead's reachable contacts the way dispatch does: the mapped email or
+ * phone column first, then the built-in keys, and LinkedIn from the profile the
+ * enrollment captured (a row value alone never makes a LinkedIn step sendable).
  */
+export declare function sequenceLeadContacts(input: {
+    rowValues: Record<string, unknown> | null | undefined;
+    settings?: {
+        email_column_key?: string | null;
+        phone_column_key?: string | null;
+    } | null;
+    linkedin: boolean;
+}): SequenceLeadContacts;
 export type SequenceSignalCondition = {
     signal: SequenceSignal;
     present?: boolean;
 } | {
     has_column: string;
     present?: boolean;
+} | {
+    has_contact: SequenceContactChannel;
+    present?: boolean;
 } | {
     all: SequenceSignalCondition[];
 } | {
@@ -959,9 +986,10 @@ export declare function sequenceTemplateVariables(definition: SequenceDefinition
  * `rowValues` is optional and backward-compatible: when omitted (undefined), a data
  * leaf ({ has_column }) evaluates as ABSENT — present:false matches, present:true
  * does not — so an existing signal-only caller is unaffected. Signal leaves ignore
- * rowValues entirely.
+ * rowValues entirely. A contact leaf ({ has_contact }) reads `contacts`; without
+ * it, the contact counts as absent.
  */
-export declare function evaluateSequenceCondition(condition: SequenceSignalCondition, firedSignals: Iterable<string>, rowValues?: Record<string, unknown> | null): boolean;
+export declare function evaluateSequenceCondition(condition: SequenceSignalCondition, firedSignals: Iterable<string>, rowValues?: Record<string, unknown> | null, contacts?: SequenceLeadContacts): boolean;
 /** Variant label for an index: 0 → "a" (the base step), 1 → "b", … */
 export declare function sequenceVariantLabel(index: number): string;
 type StepVariantContent = Record<string, string>;