@oxygen-agent/cli 1.1014.985 → 1.1014.1087

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/index.d.ts

@@ -110,7 +110,6 @@ export * from "./workflow-trigger-label.js";
 export * from "./workspace-event-catalog.js";
 export * from "./notetaker-events.js";
 export * from "./workspace-agents.js";
-export declare const MAX_ROW_LOOP_WRITE_ROWS = 500;
 export * from "./semver.js";
 export * from "./ugc.js";
 export * from "./ugc-amplification-identity.js";

package/node_modules/@oxygen/shared/dist/index.js

@@ -121,12 +121,6 @@ export * from "./workflow-trigger-label.js";
 export * from "./workspace-event-catalog.js";
 export * from "./notetaker-events.js";
 export * from "./workspace-agents.js";
-// Maximum rows a single row-loop write (insert/upsert/preview) may process. The
-// row-loop engine issues one DB round-trip per row, so a 500-row write already
-// approaches request timeouts (~50s observed in prod); larger batches must use
-// the COPY-based bulk engine. Tenant-db enforces this and the CLI/API row caps
-// reference it so they never advertise a batch the row-loop will reject.
-export const MAX_ROW_LOOP_WRITE_ROWS = 500;
 export * from "./semver.js";
 export * from "./ugc.js";
 export * from "./ugc-amplification-identity.js";

package/node_modules/@oxygen/shared/dist/table-limits.d.ts

@@ -3,6 +3,7 @@ export declare const MAX_TABLE_ACTION_RUN_ROWS = 500000;
 export declare const MAX_FORMULA_ACTION_RUN_ROWS = 1000000;
 export declare const MAX_FORMULA_ACTION_RUN_ITEMS = 5000000;
 export declare const MAX_WORKSPACE_ROW_DELETE_ROWS = 50000;
+export declare const MAX_ROW_LOOP_WRITE_ROWS = 500;
 /**
  * Maximum requested row concurrency for one table action run. Native BullMQ
  * persists at most this many slot heads. Actual execution also shares worker

package/node_modules/@oxygen/shared/dist/table-limits.js

@@ -5,6 +5,12 @@ export const MAX_TABLE_ACTION_RUN_ROWS = 500_000;
 export const MAX_FORMULA_ACTION_RUN_ROWS = 1_000_000;
 export const MAX_FORMULA_ACTION_RUN_ITEMS = 5_000_000;
 export const MAX_WORKSPACE_ROW_DELETE_ROWS = 50_000;
+// Maximum rows a single row-loop write (insert/upsert/preview) may process. The
+// row-loop engine issues one DB round-trip per row, so a 500-row write already
+// approaches request timeouts (~50s observed in prod); larger batches must use
+// the COPY-based bulk engine. Tenant-db enforces this and the CLI/API row caps
+// reference it so they never advertise a batch the row-loop will reject.
+export const MAX_ROW_LOOP_WRITE_ROWS = 500;
 /**
  * Maximum requested row concurrency for one table action run. Native BullMQ
  * persists at most this many slot heads. Actual execution also shares worker

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

@@ -1,15 +1,19 @@
 /**
- * AI teammates (ADR 0032): Agents people talk to, each person in one ongoing
- * private chat per teammate, on the Copilot runtime. Each is its owner's until
- * shared with teammates (Tim, 2026-10-14); the first one is everyone's.
+ * AI teammates (ADR 0032): Agents people talk to in one ongoing shared chat
+ * per Workspace Oxygent, on the Copilot runtime. Explicit Personal Oxygents
+ * are creator-only; the first one stays Workspace (Philipp, 2026-10-16).
  *
- * Staff-only on dev. `OXYGEN_TEAMMATES_ENABLED` is the switch; when it is
- * unset the feature follows the Ongoing Agent sessions staff gate, which the
- * dev web and worker already receive, because teammates re-scope those
- * sessions into routines. Production and shadow never qualify.
+ * Staff only: on dev, and in production's staff workspaces, the ones Agents run
+ * in (`agentsEnabledIn`; Tim, 2026-10-16). `OXYGEN_TEAMMATES_ENABLED` is the
+ * switch; when it is unset the feature follows the Ongoing Agent sessions staff
+ * gate, because teammates re-scope those sessions into routines. Shadow never
+ * qualifies.
  */
 export declare function teammatesEnabled(env?: Record<string, string | undefined>): boolean;
+/** Whether this workspace has Oxygents. */
+export declare function teammatesEnabledIn(organizationId: string | null | undefined, env?: Record<string, string | undefined>): boolean;
 export declare function teammatesAvailableTo(env: Record<string, string | undefined>, viewer: {
+    organizationId: string | null;
     email: string | null | undefined;
     member: boolean;
     oxygenRole?: string | null | undefined;
@@ -40,7 +44,7 @@ export declare function isTeammateAvatarColor(value: unknown): value is Teammate
  * Who may use an Oxygent besides its owner, the way Grok Bot shares a Bot
  * (Tim, 2026-10-14: "make agents accessible to your team mates that you can
  * collaborate with your team mates"). A collaborator chats with it and uses its
- * skills, in a chat of their own; a manager also changes its profile and who
+ * skills, in the shared chat; a manager also changes its profile and who
  * has access. Deleting it stays with its owner or a workspace admin.
  */
 export declare const TEAMMATE_SHARE_ROLES: readonly ["collaborator", "manager"];
@@ -57,6 +61,7 @@ export declare function isTeammateShareRole(value: unknown): value is TeammateSh
  */
 export declare function teammateAccessRole(teammate: {
     slug: string;
+    visibility?: "workspace" | "personal";
     ownerActorId: string | null;
     everyone: TeammateShareRole | null;
     personal: TeammateShareRole | null;

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

@@ -1,27 +1,34 @@
+import { agentsEnabled, agentsEnabledIn } from "./agents-enabled.js";
 import { guidedActivationEnabled } from "./guided-activation.js";
 import { isStaffEmail } from "./staff.js";
 /**
- * AI teammates (ADR 0032): Agents people talk to, each person in one ongoing
- * private chat per teammate, on the Copilot runtime. Each is its owner's until
- * shared with teammates (Tim, 2026-10-14); the first one is everyone's.
+ * AI teammates (ADR 0032): Agents people talk to in one ongoing shared chat
+ * per Workspace Oxygent, on the Copilot runtime. Explicit Personal Oxygents
+ * are creator-only; the first one stays Workspace (Philipp, 2026-10-16).
  *
- * Staff-only on dev. `OXYGEN_TEAMMATES_ENABLED` is the switch; when it is
- * unset the feature follows the Ongoing Agent sessions staff gate, which the
- * dev web and worker already receive, because teammates re-scope those
- * sessions into routines. Production and shadow never qualify.
+ * Staff only: on dev, and in production's staff workspaces, the ones Agents run
+ * in (`agentsEnabledIn`; Tim, 2026-10-16). `OXYGEN_TEAMMATES_ENABLED` is the
+ * switch; when it is unset the feature follows the Ongoing Agent sessions staff
+ * gate, because teammates re-scope those sessions into routines. Shadow never
+ * qualifies.
  */
 export function teammatesEnabled(env = process.env) {
-    if (env.OXYGEN_DEPLOY_ENV !== "selfhost-dev")
+    if (env.OXYGEN_DEPLOY_ENV !== "selfhost-dev" && env.OXYGEN_DEPLOY_ENV !== "selfhost-prod")
         return false;
-    if (env.OXYGEN_AGENTS_ENABLED?.trim().toLowerCase() !== "true")
+    if (!agentsEnabled(env))
         return false;
     const flag = env.OXYGEN_TEAMMATES_ENABLED?.trim().toLowerCase();
     if (flag)
         return flag === "staff";
     return env.OXYGEN_AGENT_SESSIONS_ENABLED === "staff";
 }
+/** Whether this workspace has Oxygents. */
+export function teammatesEnabledIn(organizationId, env = process.env) {
+    return teammatesEnabled(env) && agentsEnabledIn(organizationId, env);
+}
 export function teammatesAvailableTo(env, viewer) {
-    return teammatesEnabled(env) && viewer.member && viewer.oxygenRole !== "client" && (guidedActivationEnabled(env) || isStaffEmail(viewer.email, env));
+    return teammatesEnabledIn(viewer.organizationId, env) && viewer.member && viewer.oxygenRole !== "client"
+        && (guidedActivationEnabled(env) || isStaffEmail(viewer.email, env));
 }
 /**
  * The Workspace Agent's slug. Every workspace's first Oxygent is that Agent: an
@@ -57,7 +64,7 @@ export function isTeammateAvatarColor(value) {
  * Who may use an Oxygent besides its owner, the way Grok Bot shares a Bot
  * (Tim, 2026-10-14: "make agents accessible to your team mates that you can
  * collaborate with your team mates"). A collaborator chats with it and uses its
- * skills, in a chat of their own; a manager also changes its profile and who
+ * skills, in the shared chat; a manager also changes its profile and who
  * has access. Deleting it stays with its owner or a workspace admin.
  */
 export const TEAMMATE_SHARE_ROLES = ["collaborator", "manager"];
@@ -76,6 +83,8 @@ export function teammateAccessRole(teammate, actorId) {
         return "manager";
     if (teammate.ownerActorId && teammate.ownerActorId === actorId)
         return "owner";
+    if (teammate.visibility === "personal")
+        return null;
     if (teammate.everyone === "manager" || teammate.personal === "manager")
         return "manager";
     if (teammate.everyone === "collaborator" || teammate.personal === "collaborator")

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.985";
+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.985";
+export const OXYGEN_BUILD_VERSION = "1.1014.1087";