@oxygen-agent/cli 1.1014.1035 → 1.1014.1087

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

@@ -0,0 +1,147 @@
+/** Full DEV onboarding, approved by Philipp on 2026-10-16.
+ * Browser-safe vocabulary. Native owners, never navigation or caller assertions,
+ * establish research results, billing eligibility and resource authority. */
+export declare const GUIDED_ONBOARDING_JOURNEY_VERSION: 1;
+export declare const GUIDED_ONBOARDING_PART1_STEPS: readonly ["company_context", "company_research", "company_review", "audience_company_size", "audience_markets", "audience_industries", "audience_personas", "signals", "prospects", "trial"];
+export declare const GUIDED_ONBOARDING_PART2_STEPS: readonly ["welcome", "daily_rhythm", "linkedin", "campaign", "sequence", "routines", "tour"];
+export declare const GUIDED_ONBOARDING_STEPS: readonly ["company_context", "company_research", "company_review", "audience_company_size", "audience_markets", "audience_industries", "audience_personas", "signals", "prospects", "trial", "welcome", "daily_rhythm", "linkedin", "campaign", "sequence", "routines", "tour", "complete"];
+export type GuidedOnboardingStep = typeof GUIDED_ONBOARDING_STEPS[number];
+export type GuidedOnboardingPart = "part1" | "part2" | "complete";
+export declare function guidedOnboardingPart(step: GuidedOnboardingStep): GuidedOnboardingPart;
+export type GuidedOnboardingChoice = {
+    values: string[];
+};
+export type GuidedOnboardingSignal = {
+    mode: "none" | "selected";
+    values: string[];
+};
+export declare const GUIDED_ONBOARDING_TECHNOLOGY_RELATIONSHIPS: readonly ["uses", "replaces", "integrates_with"];
+export type GuidedOnboardingTechnologyRelationship = typeof GUIDED_ONBOARDING_TECHNOLOGY_RELATIONSHIPS[number];
+export type GuidedOnboardingTechnology = {
+    name: string;
+    relationship: GuidedOnboardingTechnologyRelationship;
+};
+export type GuidedOnboardingTechnologySignal = {
+    mode: "none" | "selected";
+    values: GuidedOnboardingTechnology[];
+};
+export type GuidedOnboardingAnswers = {
+    company_context?: {
+        website: string | null;
+        name: string;
+        description: string;
+        context_links: string[];
+        file_ids: string[];
+    };
+    /** Saving a statement alone is not its native confirmation receipt. */
+    company_review?: {
+        statement: string;
+        profile_revision: string;
+    };
+    audience_company_size?: GuidedOnboardingChoice;
+    audience_markets?: GuidedOnboardingChoice;
+    audience_industries?: GuidedOnboardingChoice;
+    audience_personas?: GuidedOnboardingChoice;
+    signals?: {
+        hiring: GuidedOnboardingSignal;
+        technology: GuidedOnboardingTechnologySignal;
+    };
+    prospects?: {
+        decision: "continue" | "refine";
+        feedback: string;
+    };
+    /** Connect is an intent. Only the native sender owner can prove a connection. */
+    linkedin?: {
+        choice: "connect" | "skip";
+    };
+    /** A draft remains a valid outcome on the optional LinkedIn branch. */
+    sequence?: {
+        decision: "review" | "keep_draft";
+    };
+    tour?: {
+        visited: Array<"overview" | "leads" | "sourcing" | "sequence">;
+    };
+};
+export type GuidedOnboardingResearchStatus = "not_started" | "running" | "completed" | "partial" | "unavailable" | "failed" | "credits_exhausted";
+export type GuidedOnboardingResearch = {
+    status: GuidedOnboardingResearchStatus;
+    run_id: string | null;
+    knowledge_page_ids: string[];
+    /** Fixed customer-safe code only. Provider diagnostics remain in their owner. */
+    fault: {
+        code: string;
+        retryable: boolean;
+    } | null;
+};
+export type GuidedOnboardingProspect = {
+    row_id: string;
+    person_key: string;
+    name: string;
+    title: string;
+    company: string;
+    linkedin_url: string | null;
+    sources: Array<{
+        url: string;
+        title: string;
+    }>;
+    fit: {
+        rationale: string;
+        criteria: string[];
+    };
+};
+export type GuidedOnboardingProspectLimitation = {
+    field: string;
+    code: "unsupported_filter";
+    blocking: boolean;
+    message: string;
+    values: string[];
+    suggestions: string[];
+};
+export type GuidedOnboardingProspects = {
+    status: "not_started" | "running" | "ready" | "partial" | "empty" | "unavailable" | "failed" | "credits_exhausted";
+    table_id: string | null;
+    ingestion_run_ids: string[];
+    /** Up to five native source-backed people; an empty array is never success. */
+    people: GuidedOnboardingProspect[];
+    /** Absent in legacy receipts means unknown, never proof of supported filters.
+     * Current D projections supply actual structured diagnostics, including []. */
+    limitations?: GuidedOnboardingProspectLimitation[];
+    fault: {
+        code: string;
+        retryable: boolean;
+    } | null;
+};
+/** Read projection from native billing, not an accepted browser mutation field.
+ * I owns the actual test Checkout/subscription/grant producer and its signatures. */
+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;
+};
+export type GuidedOnboardingJourney = {
+    version: typeof GUIDED_ONBOARDING_JOURNEY_VERSION;
+    /** Increments on non-destructive restart; activation revision guards writes. */
+    generation: number;
+    step: GuidedOnboardingStep;
+    completed_steps: GuidedOnboardingStep[];
+    /** Presentation state is authoritative and independent of deduplicated history. */
+    navigation: {
+        paused: boolean;
+        tour_active_stop: "overview" | "leads" | "sourcing" | "sequence" | null;
+    };
+    answers: GuidedOnboardingAnswers;
+    /** Native confirmation binds the actual typed company profile revision. */
+    company_confirmation: {
+        profile_revision: string;
+        statement_digest: string;
+        confirmed_at: string;
+    } | null;
+    research: GuidedOnboardingResearch;
+    prospects: GuidedOnboardingProspects;
+};
+/** Free initialization; creates no research, chat turn, subscription or resource. */
+export declare function createGuidedOnboardingJourney(): GuidedOnboardingJourney;
+/** Old saved v1 records have no current-stop evidence. Never guess from visited[]. */
+export declare function normalizeSavedGuidedOnboardingJourney(journey: GuidedOnboardingJourney): GuidedOnboardingJourney;

package/node_modules/@oxygen/shared/dist/guided-onboarding-journey.fixture.d.ts

@@ -0,0 +1,12 @@
+import { type GuidedOnboardingJourney, type GuidedOnboardingEligibility } from "./guided-onboarding-journey.js";
+/** Synthetic component/test data only. Never substitute this for hosted receipts. */
+export declare const GUIDED_ONBOARDING_FIXTURE_NAMES: readonly ["part1_initial", "research_running", "company_review", "audience_question", "technology_relationships", "prospects_ready", "prospects_partial", "prospects_empty", "prospects_unavailable", "prospects_failed", "research_failed", "credits_exhausted", "checkout_pending", "billing_unavailable", "part2_trial", "part2_paid", "linkedin_skipped", "tour_paused_back", "complete"];
+export type GuidedOnboardingFixtureName = typeof GUIDED_ONBOARDING_FIXTURE_NAMES[number];
+export type GuidedOnboardingFixture = {
+    fixture_only: true;
+    label: string;
+    activation_revision: number;
+    journey: GuidedOnboardingJourney;
+    eligibility: GuidedOnboardingEligibility;
+};
+export declare function createGuidedOnboardingFixture(name: GuidedOnboardingFixtureName): GuidedOnboardingFixture;

package/node_modules/@oxygen/shared/dist/guided-onboarding-journey.fixture.js

@@ -0,0 +1,83 @@
+import { createGuidedOnboardingJourney, GUIDED_ONBOARDING_STEPS, } from "./guided-onboarding-journey.js";
+/** Synthetic component/test data only. Never substitute this for hosted receipts. */
+export const GUIDED_ONBOARDING_FIXTURE_NAMES = [
+    "part1_initial", "research_running", "company_review", "audience_question", "technology_relationships",
+    "prospects_ready", "prospects_partial", "prospects_empty", "prospects_unavailable", "prospects_failed", "research_failed",
+    "credits_exhausted", "checkout_pending", "billing_unavailable", "part2_trial", "part2_paid", "linkedin_skipped", "tour_paused_back", "complete",
+];
+export function createGuidedOnboardingFixture(name) {
+    const fixture = {
+        fixture_only: true, label: `Synthetic onboarding fixture: ${name}`, activation_revision: 7,
+        journey: createGuidedOnboardingJourney(),
+        eligibility: { state: "checkout_required", basis: null, subscription_id: null, observed_at: "2026-10-16T12:00:00.000Z", trial_ends_at: null },
+    };
+    const { journey, eligibility } = fixture;
+    if (name === "research_running") {
+        journey.step = "company_research";
+        journey.research = { status: "running", run_id: "fixture-research-run", knowledge_page_ids: [], fault: null };
+    }
+    else if (name === "company_review") {
+        journey.step = "company_review";
+        journey.answers.company_review = { statement: "Synthetic company statement for panel tests.", profile_revision: "3" };
+        journey.research = { status: "completed", run_id: "fixture-research-run", knowledge_page_ids: ["fixture-company-page"], fault: null };
+    }
+    else if (name === "audience_question") {
+        journey.step = "audience_markets";
+        journey.answers.audience_company_size = { values: ["11–50"] };
+        journey.answers.audience_markets = { values: ["Germany", "Custom test market"] };
+    }
+    else if (name === "technology_relationships") {
+        journey.step = "signals";
+        journey.answers.signals = {
+            hiring: { mode: "selected", values: ["Revenue Operations Manager"] },
+            technology: { mode: "selected", values: [
+                    { name: "Apollo", relationship: "replaces" },
+                    { name: "Apollo", relationship: "integrates_with" },
+                ] },
+        };
+    }
+    else if (name.startsWith("prospects_")) {
+        journey.step = "prospects";
+        journey.prospects.status = name === "prospects_ready" ? "ready" : name === "prospects_partial" ? "partial"
+            : name === "prospects_unavailable" ? "unavailable" : name === "prospects_failed" ? "failed" : "empty";
+        journey.prospects.table_id = "fixture-prospects-table";
+        if (name === "prospects_ready" || name === "prospects_partial") {
+            journey.prospects.ingestion_run_ids = ["fixture-prospects-ingestion"];
+            journey.prospects.people = Array.from({ length: name === "prospects_ready" ? 5 : 2 }, (_, index) => ({
+                row_id: `fixture-person-${index + 1}`, person_key: `fixture-key-${index + 1}`,
+                name: `Example Buyer ${index + 1}`, title: "Example sales leader", company: "Example Company",
+                linkedin_url: null, sources: [{ url: "https://example.test/source", title: "Synthetic source — not provider evidence" }],
+                fit: { rationale: "Synthetic fit explanation for layout tests.", criteria: ["example persona"] },
+            }));
+        }
+    }
+    else if (name === "research_failed" || name === "credits_exhausted") {
+        journey.step = "company_research";
+        journey.research.status = name === "research_failed" ? "failed" : "credits_exhausted";
+        journey.research.fault = { code: name === "research_failed" ? "research_unavailable" : "insufficient_credits", retryable: name === "research_failed" };
+    }
+    else if (name === "checkout_pending" || name === "billing_unavailable") {
+        journey.step = "trial";
+        eligibility.state = name === "checkout_pending" ? "checkout_pending" : "unavailable";
+    }
+    else if (["part2_trial", "part2_paid", "linkedin_skipped", "tour_paused_back", "complete"].includes(name)) {
+        journey.step = name === "complete" ? "complete" : name === "linkedin_skipped" ? "campaign" : name === "tour_paused_back" ? "tour" : "welcome";
+        eligibility.state = "eligible";
+        eligibility.basis = name === "part2_paid" ? "paid" : "trial";
+        eligibility.subscription_id = "fixture-subscription";
+        eligibility.trial_ends_at = eligibility.basis === "trial" ? "2026-10-23T12:00:00.000Z" : null;
+        if (name === "linkedin_skipped")
+            journey.answers.linkedin = { choice: "skip" };
+    }
+    const index = GUIDED_ONBOARDING_STEPS.indexOf(journey.step);
+    journey.completed_steps = GUIDED_ONBOARDING_STEPS.slice(0, index);
+    if (index > GUIDED_ONBOARDING_STEPS.indexOf("company_review")) {
+        journey.answers.company_review = { statement: "Synthetic reviewed company statement.", profile_revision: "3" };
+        journey.company_confirmation = { profile_revision: "3", statement_digest: "a".repeat(64), confirmed_at: "2026-10-16T12:00:00.000Z" };
+    }
+    if (name === "tour_paused_back") {
+        journey.answers.tour = { visited: ["overview", "leads", "sourcing"] };
+        journey.navigation = { paused: true, tour_active_stop: "leads" };
+    }
+    return fixture;
+}

package/node_modules/@oxygen/shared/dist/guided-onboarding-journey.js

@@ -0,0 +1,44 @@
+/** Full DEV onboarding, approved by Philipp on 2026-10-16.
+ * Browser-safe vocabulary. Native owners, never navigation or caller assertions,
+ * establish research results, billing eligibility and resource authority. */
+export const GUIDED_ONBOARDING_JOURNEY_VERSION = 1;
+export const GUIDED_ONBOARDING_PART1_STEPS = [
+    "company_context", "company_research", "company_review",
+    "audience_company_size", "audience_markets", "audience_industries", "audience_personas",
+    "signals", "prospects", "trial",
+];
+export const GUIDED_ONBOARDING_PART2_STEPS = [
+    "welcome", "daily_rhythm", "linkedin", "campaign", "sequence", "routines", "tour",
+];
+export const GUIDED_ONBOARDING_STEPS = [
+    ...GUIDED_ONBOARDING_PART1_STEPS, ...GUIDED_ONBOARDING_PART2_STEPS, "complete",
+];
+export function guidedOnboardingPart(step) {
+    if (step === "complete")
+        return "complete";
+    if (GUIDED_ONBOARDING_PART1_STEPS.includes(step))
+        return "part1";
+    if (GUIDED_ONBOARDING_PART2_STEPS.includes(step))
+        return "part2";
+    throw new TypeError("Unknown onboarding step.");
+}
+export const GUIDED_ONBOARDING_TECHNOLOGY_RELATIONSHIPS = ["uses", "replaces", "integrates_with"];
+/** Free initialization; creates no research, chat turn, subscription or resource. */
+export function createGuidedOnboardingJourney() {
+    return {
+        version: GUIDED_ONBOARDING_JOURNEY_VERSION, generation: 1, step: "company_context",
+        completed_steps: [], navigation: { paused: false, tour_active_stop: null }, answers: {}, company_confirmation: null,
+        research: { status: "not_started", run_id: null, knowledge_page_ids: [], fault: null },
+        prospects: { status: "not_started", table_id: null, ingestion_run_ids: [], people: [], fault: null },
+    };
+}
+/** Old saved v1 records have no current-stop evidence. Never guess from visited[]. */
+export function normalizeSavedGuidedOnboardingJourney(journey) {
+    if (journey.navigation === undefined)
+        return { ...journey, navigation: { paused: false, tour_active_stop: null } };
+    const navigation = journey.navigation;
+    if (!navigation || typeof navigation.paused !== "boolean" || (navigation.tour_active_stop !== null
+        && !["overview", "leads", "sourcing", "sequence"].includes(navigation.tour_active_stop)))
+        throw new TypeError("Invalid saved onboarding navigation.");
+    return journey;
+}

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

@@ -0,0 +1,7 @@
+import type { GuidedOnboardingProspectLimitation, GuidedOnboardingProspects } from "./guided-onboarding-journey.js";
+/** Bind actual D result.targeting.limitations, never infer support from success,
+ * an empty people list, a legacy absence, or a general fault. Preserve native
+ * result status/fit/source/ingestion truth and the compatible fault unchanged. */
+export declare function projectGuidedOnboardingProspects(prospects: GuidedOnboardingProspects, limitations: unknown): GuidedOnboardingProspects & {
+    limitations: GuidedOnboardingProspectLimitation[];
+};

package/node_modules/@oxygen/shared/dist/guided-onboarding-prospects.js

@@ -0,0 +1,13 @@
+import { OxygenError } from "./cli-result.js";
+import { arr, bool, enumOf, obj, str, validateContract } from "./contracts/schema.js";
+const limitationsContract = obj({ limitations: arr(obj({ field: str({ minLength: 1 }), code: enumOf(["unsupported_filter"]),
+        blocking: bool(), message: str({ minLength: 1 }), values: arr(str()), suggestions: arr(str()) }, { required: ["field", "code", "blocking", "message", "values", "suggestions"] })) }, { required: ["limitations"] });
+/** Bind actual D result.targeting.limitations, never infer support from success,
+ * an empty people list, a legacy absence, or a general fault. Preserve native
+ * result status/fit/source/ingestion truth and the compatible fault unchanged. */
+export function projectGuidedOnboardingProspects(prospects, limitations) {
+    const checked = validateContract(limitationsContract, { limitations }, { unknown: "reject", overMax: "reject" });
+    if (!checked.ok)
+        throw new OxygenError("onboarding_preview_diagnostics_invalid", "The preview could not describe its supported targeting. Review your saved criteria before retrying.");
+    return { ...prospects, limitations: checked.value.limitations.map(item => ({ ...item, values: [...item.values], suggestions: [...item.suggestions] })) };
+}

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

@@ -0,0 +1,4 @@
+import type { GuidedOnboardingAnswers } from "./guided-onboarding-journey.js";
+/** Same product with distinct relationships is intentional, not a duplicate.
+ * This normalizes saved intent, never claims that a provider supports a filter. */
+export declare function normalizeGuidedOnboardingSignals(value: unknown): NonNullable<GuidedOnboardingAnswers["signals"]>;

package/node_modules/@oxygen/shared/dist/guided-onboarding-signals.js

@@ -0,0 +1,34 @@
+import { OxygenError } from "./cli-result.js";
+import { validateContract } from "./contracts/schema.js";
+import { GUIDED_ONBOARDING_SIGNALS_CONTRACT } from "./contracts/guided-onboarding-journey.js";
+const fail = () => {
+    throw new OxygenError("invalid_onboarding_answer", "Choose hiring roles and technologies with uses, replaces or integrates_with, or explicitly choose none.", { exitCode: 2 });
+};
+const displayName = (name) => name.normalize("NFKC").trim().replace(/\s+/gu, " ");
+/** Same product with distinct relationships is intentional, not a duplicate.
+ * This normalizes saved intent, never claims that a provider supports a filter. */
+export function normalizeGuidedOnboardingSignals(value) {
+    const parsed = validateContract(GUIDED_ONBOARDING_SIGNALS_CONTRACT, value, { unknown: "reject", overMax: "reject" });
+    if (!parsed.ok)
+        return fail();
+    const { hiring, technology } = parsed.value;
+    if ((hiring.mode === "none") !== (hiring.values.length === 0)
+        || (technology.mode === "none") !== (technology.values.length === 0))
+        return fail();
+    const roles = hiring.values.map(displayName);
+    if (roles.some(role => !role))
+        return fail();
+    const seen = new Set();
+    const technologies = [];
+    for (const item of technology.values) {
+        const name = displayName(item.name);
+        if (!name)
+            return fail();
+        const key = JSON.stringify([name.toLowerCase(), item.relationship]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        technologies.push({ name, relationship: item.relationship });
+    }
+    return { hiring: { mode: hiring.mode, values: roles }, technology: { mode: technology.mode, values: technologies } };
+}

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

@@ -0,0 +1,26 @@
+/** DEV onboarding offer. Existing subscription terms and production acquisition stay intact. */
+export declare const GUIDED_TRIAL_OFFER: {
+    readonly key: "guided_onboarding_v2";
+    readonly plan: "oxygen_49";
+    readonly currency: "usd";
+    readonly trial_days: 7;
+    readonly trial_credits: 2000;
+    readonly amount_due_now_cents: 0;
+    readonly monthly_price_cents: 4900;
+    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;
+    eligible: boolean;
+    checkout_allowed: boolean;
+    state: "trial" | "paid" | "checkout_required" | "trial_unavailable" | "subscription_pending";
+    billing_owner_organization_id: string;
+    subscription_id: string | null;
+    trial_ends_at: string | null;
+    cancellation_scheduled: boolean;
+    spendable_credits: number;
+    funded_work_paused: boolean;
+};

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

@@ -0,0 +1,19 @@
+import { guidedActivationEnabled } from "./guided-activation.js";
+/** DEV onboarding offer. Existing subscription terms and production acquisition stay intact. */
+export const GUIDED_TRIAL_OFFER = {
+    key: "guided_onboarding_v2",
+    plan: "oxygen_49",
+    currency: "usd",
+    trial_days: 7,
+    trial_credits: 2_000,
+    amount_due_now_cents: 0,
+    monthly_price_cents: 4_900,
+    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/user-capability-routing.js

@@ -14,6 +14,22 @@ export function capabilityDiscoveryRecovery(query, surface) {
 // connection routes.
 export function inferUserCapabilityRoute(query) {
     const normalized = query.toLowerCase().replace(/[_-]+/g, " ");
+    const journeyAction = savedOnboardingJourneyAction(normalized);
+    if (journeyAction) {
+        const route = getCapabilityRouteMatch("agents");
+        if (route) {
+            const recommendedTools = [`oxygen_onboarding_journey_${journeyAction}`, ...(journeyAction === "get" ? [] : ["oxygen_onboarding_journey_get"])];
+            const recommendedCommands = [`onboarding journey ${journeyAction}`, ...(journeyAction === "get" ? [] : ["onboarding journey get"])];
+            return { ...route, recommendedTools, recommendedCommands, card: { ...route.card,
+                    owns: "Creator-private saved guided onboarding answers, current step and pause/resume position.",
+                    notFor: "Human workspace invitations or permissions, destructive workspace reset, paid Oxygent Start or routine execution.",
+                    gatewayTools: recommendedTools, gatewayCommands: recommendedCommands,
+                    posture: journeyAction === "get" ? "read_only" : "workspace_write",
+                    execution: journeyAction === "get" ? "Read saved onboarding and its current native step. This read starts no research, model, billing reconciliation or message send."
+                        : "Read activationId and current revision first, then hydrate the selected native operation. Use a stable mutation_id; Back and non-destructive restart preserve resources and funding. Company answers prepare native sources and existing bounded research consent. Discovery executes nothing and supplies no approval or billing authority.",
+                } };
+        }
+    }
     // Exact native session activation must outrank the generic Agent gateways.
     // Discovery supplies no approval, preview token or invented session binding.
     if (/\bagent session activate\b/.test(normalized)
@@ -61,6 +77,23 @@ export function inferUserCapabilityRoute(query) {
                 recommendedCommands: ["context profile get", "knowledge bootstrap status", "onboarding activation status"],
                 exactCommand: "oxygen context profile get --json", exactMcpCall: { tool: "oxygen_context_profile_get", arguments: {} } };
     }
+    // Explicit guided-journey discovery precedes the individual campaign,
+    // review and routine nouns that describe its later steps. Consulting keeps
+    // the ordinary onboarding card; this recommendation advertises DEV only.
+    if (isGuidedOnboardingDiscoveryIntent(normalized)) {
+        const route = getCapabilityRouteMatch("onboarding-and-copilot");
+        if (route) {
+            const recommendedTools = ["oxygen_onboarding_activation_status", "oxygen_onboarding_journey_get"];
+            const recommendedCommands = ["onboarding activation status", "onboarding journey get"];
+            return { ...route, recommendedTools, recommendedCommands, card: { ...route.card,
+                    owns: "Creator-owned DEV guided onboarding answers, native resources, current step and saved navigation.",
+                    notFor: "Production onboarding execution, human membership or ordinary GTM consulting.",
+                    posture: "read_only", gatewayTools: recommendedTools, gatewayCommands: recommendedCommands,
+                    execution: "DEV-only two-part guided onboarding; unavailable in production, shadow, local or production-data workspaces. Read your activation first, then use its activationId to read the saved journey and revision. If absent, inspect the free activation-start schema and choose own_agent or oxygent. Resume the native step; answers, prospects, TEST billing, campaigns and routines retain their own schemas, eligibility and approvals. These reads start no research, checkout, model, schedule or send. Ordinary GTM consulting remains with Recipes/Copilot.",
+                }, exactCommand: "oxygen onboarding activation status --json",
+                exactMcpCall: { tool: "oxygen_onboarding_activation_status", arguments: {} } };
+        }
+    }
     if ((/\b(?:linkedin|sequence|campaign)\b/.test(normalized) && /\b(?:preview|review|readiness)\b/.test(normalized)
         && /\b(?:launch|start)\b/.test(normalized) && /\b(?:approval|send limits?|caps?)\b/.test(normalized))
         || (isLinkedInCampaignIntent(normalized) && /\breadiness\b/.test(normalized) && /\bpreview\b/.test(normalized))) {
@@ -159,6 +192,38 @@ export function inferUserCapabilityRoute(query) {
     // intent is exactly what this wrapper exists to answer.
     return getCapabilityRouteMatch("connected-integrations") ?? route;
 }
+/** Saved progress is distinct from general signup research, attended Start,
+ * routine schedules and human membership. Pause wins over a simultaneous resume. */
+function savedOnboardingJourneyAction(query) {
+    if (!/\bonboarding\b/.test(query) || !/\b(?:journey|guided|answers?|steps?|tour)\b/.test(query)
+        || /\b(?:invite|members?|membership|permissions?|roles?|human|colleague|coworker|delete|destroy|wipe)\b/.test(query))
+        return null;
+    if (/\b(?:pause|paused|navigation)\b/.test(query) || (/\btour\b/.test(query) && /\bresume\b/.test(query)))
+        return "navigation";
+    if (/\brestart\b/.test(query))
+        return "restart";
+    if (/\bback\b/.test(query))
+        return "back";
+    if (/\bsave\b/.test(query))
+        return "save";
+    if (/\b(?:resume|read|get)\b/.test(query))
+        return "get";
+    return null;
+}
+/** A saved action is handled first. This is discovery of the multi-step
+ * product journey, not generic advice about improving a GTM operation. */
+function isGuidedOnboardingDiscoveryIntent(query) {
+    if (!/\bonboarding\b/.test(query)
+        || /\b(?:invite|members?|membership|permissions?|roles?|human|colleague|coworker|delete|destroy|wipe|paid)\b/.test(query))
+        return false;
+    if (/^(?:guided )?onboarding$/.test(query.trim()))
+        return true;
+    return /\b(?:first sourcing|daily rhythm)\b/.test(query)
+        || (/\b(?:guide|guided|journey|part [12])\b/.test(query)
+            && /\b(?:business|company|icp|personas?|prospects?|trial|campaign|sequence|briefing)\b/.test(query))
+        || (/\b(?:trial|prospects?|personas?)\b/.test(query)
+            && /\b(?:context|icp|campaign|sequence)\b/.test(query));
+}
 function isCompanyOnboardingContextIntent(query) {
     return /\bonboard\w*\b/.test(query)
         && /\bcompany\b/.test(query)
@@ -266,6 +331,19 @@ function oxygentsRoute(normalized) {
     const group = /\bgroups?\b/.test(normalized);
     const verb = (group ? OXYGENT_GROUP_VERBS : OXYGENT_VERBS).find(([, words]) => words.test(normalized))?.[0]
         ?? (group ? "groups" : "list");
+    // Visibility discovery asks about the contract, not existing conversations.
+    // Keep the shared router's create/update/access recommendations even when
+    // the product noun would otherwise select the roster or "history" GET.
+    // Explicit content reads and other operations retain their native verbs.
+    const privacy = /\b(?:visibility|personal|workspace|private|shared)\b/.test(normalized);
+    const rosterRead = /\b(?:list|inventory|roster)\b|\bwhich\b.*\b(?:have|available)\b/.test(normalized);
+    const contentRead = /\b(?:read|see|view|show|transcript)\b/.test(normalized);
+    const contentSend = /\b(?:messages?|ask|tell|send|talk|continue|resume|handoff|delegat\w*)\b|\b(?:chat with|hand\w* off)\b/.test(normalized);
+    if (!group && privacy && ((verb === "list" && !rosterRead) || verb === "create"
+        || (verb === "update" && /\bvisibility\b/.test(normalized))
+        || (verb === "get" && !contentRead) || (verb === "message" && !contentSend))) {
+        return inferCapabilityRoute(normalized);
+    }
     // Sharing is read and changed as a pair: who has access, then share.
     const pair = verb === "share" ? ["access"] : verb === "access" ? ["share"] : [];
     // A group's id comes from its list; the roster reads follow every ask.

package/node_modules/@oxygen/shared/dist/version.generated.d.ts

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1014.1035";
+export declare const OXYGEN_BUILD_VERSION = "1.1014.1087";

package/node_modules/@oxygen/shared/dist/version.generated.js

@@ -1,2 +1,2 @@
 // GENERATED by scripts/ci/version-stamp.mjs from VERSION + git history. Do not edit; do not commit.
-export const OXYGEN_BUILD_VERSION = "1.1014.1035";
+export const OXYGEN_BUILD_VERSION = "1.1014.1087";