@oxygen-agent/cli 1.1010.954 → 1.1011.95

package/node_modules/@oxygen/cli-ugc/dist/commands.js

@@ -306,13 +306,13 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 {
                     name: "brief",
                     kind: "string",
-                    description: "Short creator brief (up to 1,200 characters): what the product is, who it is for, key facts and the call to action. Drafts are grounded in it.",
+                    description: "Short creator brief (up to 1,200 characters): what the product is, who it is for, key facts and the call to action. Drafts are grounded in it; share longer guidance as a wiki page with --knowledge-slugs.",
                     required: false,
                 },
                 {
                     name: "description",
                     kind: "string",
-                    description: "Program description.",
+                    description: "Internal note for your team: creators never see it and drafts do not use it. Put what creators need in the brief.",
                     required: false,
                 },
                 {
@@ -330,7 +330,7 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 {
                     name: "posting_target",
                     kind: "posting_target",
-                    description: "Posts each creator should publish by default: <n>/month, <n>/week or <n>/total (n 1–100), or none to clear. One creator's own deal: creators set-target.",
+                    description: "Posts each creator should publish by default: <n>/month, <n>/week or <n>/total (n 1–100), or none to clear (2 every two weeks is 1/week). One creator's own deal: creators set-target.",
                     required: false,
                 },
                 {
@@ -373,7 +373,7 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 {
                     name: "description",
                     kind: "string",
-                    description: "Program description.",
+                    description: "Internal note for your team: creators never see it and drafts do not use it. Put what creators need in the brief.",
                     required: false,
                 },
                 {
@@ -391,7 +391,7 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 {
                     name: "posting_target",
                     kind: "posting_target",
-                    description: "Posts each creator should publish by default: <n>/month, <n>/week or <n>/total (n 1–100), or none to clear. One creator's own deal: creators set-target.",
+                    description: "Posts each creator should publish by default: <n>/month, <n>/week or <n>/total (n 1–100), or none to clear (2 every two weeks is 1/week). One creator's own deal: creators set-target.",
                     required: false,
                 },
                 {

package/node_modules/@oxygen/cli-ugc/dist/field-parser.js

@@ -10,9 +10,24 @@ export function parsePostingTarget(value) {
     const match = /^(\d{1,3})\s*\/\s*(week|month|total)$/.exec(text);
     const count = match ? Number(match[1]) : 0;
     if (!match || count < 1 || count > 100)
-        throw new UgcUsageError("--posting-target must be <n>/month, <n>/total or <n>/week with n from 1 to 100, or none.");
+        throw new UgcUsageError(`--posting-target must be <n>/month, <n>/total or <n>/week with n from 1 to 100, or none.${twoWeekRate(text)}`);
     return { count, period: match[2] };
 }
+/**
+ * A two-week rhythm has no period of its own, so name the rate that matches the
+ * count typed. "Every two weeks: 1/week or 2/month" read as two equal choices,
+ * and a 2026-09-29 blind run set 2/month for 2/fortnight: half the rate.
+ */
+function twoWeekRate(text) {
+    const fortnight = /^(\d{1,3})\s*\/\s*(?:fortnight|2\s*weeks?|two\s*weeks?|bi-?weekly)$/.exec(text);
+    const n = fortnight ? Number(fortnight[1]) : 0;
+    if (n < 1)
+        return "";
+    const monthly = Math.round((n * 52) / 24);
+    return n % 2 === 0
+        ? ` ${n} every two weeks is ${n / 2}/week (counted per calendar week) or about ${monthly}/month.`
+        : ` ${n} every two weeks has no whole weekly count; about ${monthly}/month is the closest rate.`;
+}
 /** A JSON array of emails, or emails separated by commas, semicolons or whitespace. */
 export function parseEmailList(value) {
     const text = value.trim();

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

@@ -338,17 +338,17 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         id: "sequences",
         layer: "Action",
         primitive: "sequences",
-        owns: "Net-new LinkedIn outreach plus versioned multichannel programs, cadence, enrollment, sender limits, suppression, reply-stop, and dispatch.",
+        owns: "Net-new LinkedIn outreach plus versioned multichannel programs, cadence, enrollment, sender limits, suppression, reply-stop, pausing a company when someone there replies, and dispatch.",
         notFor: "A reply in an existing conversation or a direct one-off email; use Messages. Not for general deterministic automation.",
         // The external-campaign sentence exists because a 2026-09-16 blind user asked
         // to "push table rows to smartlead campaign", landed here, read the native
         // email track's "Only 'instantly' is supported" and concluded Smartlead was
         // unreachable. The governed path for a campaign the customer already runs
         // elsewhere is `sequences push-external`; it is not a Sequence.
-        execution: "Use the one-step gateway for new LinkedIn initiation or create/enroll/start a hosted campaign with bounded send authority. Native email sends through connected Google/Microsoft mailboxes, including Microsoft SMTP transport. To push table rows into an existing Smartlead, Instantly, lemlist or HeyReach campaign you already run, use `sequences push-external` (dry_run preview, then --approved).",
+        execution: "Use the one-step gateway for new LinkedIn initiation or create/enroll/start a hosted campaign with bounded send authority. Native email sends through connected Google/Microsoft mailboxes, including Microsoft SMTP transport. To push table rows into an existing Smartlead, Instantly, lemlist or HeyReach campaign you already run, use `sequences push-external` (dry_run preview, then --approved). To stop a company's other leads when one of them replies, set `--company-reply-pause` on the campaign (choose the reply categories); to pause or resume a company on demand, e.g. from a workflow when a meeting is booked, use `sequences pause-company` / `resume-company`. A pause is resumable; a company do-not-contact entry is a permanent block on every campaign.",
         posture: "external_write",
-        gatewayTools: ["oxygen_sequences_send", "oxygen_sequences_create", "oxygen_sequences_enroll", "oxygen_sequences_start", "oxygen_sequences_list", "oxygen_sequences_push_external"],
-        gatewayCommands: ["sequences send", "sequences create", "sequences enroll", "sequences start", "sequences list", "sequences push-external"],
+        gatewayTools: ["oxygen_sequences_send", "oxygen_sequences_create", "oxygen_sequences_enroll", "oxygen_sequences_start", "oxygen_sequences_list", "oxygen_sequences_push_external", "oxygen_sequences_company_pause"],
+        gatewayCommands: ["sequences send", "sequences create", "sequences enroll", "sequences start", "sequences list", "sequences push-external", "sequences pause-company"],
         skills: ["oxygen-sequencer"],
         endpointSections: ["senders", "sequencer", "sequences", "spintax", "suppressions", "voice"],
         // "sender identity", "sender profile" and "phone number" are here because a
@@ -356,7 +356,7 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         // to workspace-access — "identity" matched the AUTH sense. The nouns a user
         // reaches for when naming a sending identity or the dialing pool have to land
         // on the group that actually owns `senders profiles` and `voice numbers`.
-        intentTerms: ["sequence", "campaign", "cadence", "enroll", "outreach", "linkedin message", "linkedin dm", "nurture", "follow up", "sender rotation", "stop on reply", "sender identity", "sending identity", "sender profile", "phone number", "dialing", "dialer", "call", "cold call", "smartlead", "instantly", "lemlist", "heyreach", "external sequencer", "push to campaign", "push rows to campaign", "add leads to campaign"],
+        intentTerms: ["sequence", "campaign", "cadence", "enroll", "outreach", "linkedin message", "linkedin dm", "nurture", "follow up", "sender rotation", "stop on reply", "company replied", "pause company", "pause outreach to a company", "stop outreach to a company", "stop emailing a company", "colleagues", "do not contact a company", "sender identity", "sending identity", "sender profile", "phone number", "dialing", "dialer", "call", "cold call", "smartlead", "instantly", "lemlist", "heyreach", "external sequencer", "push to campaign", "push rows to campaign", "add leads to campaign"],
     },
     {
         id: "publishing",
@@ -654,6 +654,21 @@ function normalizeIntent(query) {
  * posts, with the AI filter applied, before a table exists.
  */
 const LINKEDIN_KEYWORD_POST_COMMAND = 'oxygen signals search preview --family linkedin_posts --keywords "<any of>" --all-keywords "<all of>" --exclude-keywords "<none of>" --ai-filter "<posts to keep>" --json';
+/**
+ * Running (or joining) a creator program is UGC, which lives on the Publishing
+ * card. Checked before the LinkedIn keyword-post rule: "a creator program where
+ * LinkedIn creators post about my product" is not a keyword search (2026-09-29
+ * baselines routed it to Signals, and "creator program" to post tools).
+ */
+function isUgcProgramIntent(query) {
+    return /\b(ugc|user[- ]generated content|creator programs?|ambassador programs?|brand ambassadors?)\b/.test(query)
+        || /\b(invite|recruit|onboard|sponsor)\w*\b.{0,30}\bcreators?\b/.test(query)
+        || /\bcreators?\b.{0,40}\bpost\w*\b.{0,20}\babout (my|our)\b/.test(query);
+}
+/** The creator's side of a program: find one, apply, or accept an invitation. */
+function isUgcCreatorSideIntent(query) {
+    return /\b(join|apply|applying|find|discover|browse|accept)\w*\b.{0,30}\b(creator|ugc|ambassador) programs?\b/.test(query);
+}
 function isLinkedInKeywordPostIntent(query) {
     return /\blinkedin\b/.test(query)
         && /\b(posts?|posting)\b/.test(query)
@@ -720,6 +735,8 @@ function isOpenLinkedInRequestsIntent(query) {
 function explicitCapabilityIntent(query) {
     if (/\b(infographic|graphic designer|render html|carousel pages|visual design|gtm flow image)\b/.test(query))
         return ROUTE_BY_ID.get("visual-rendering") ?? null;
+    if (isUgcProgramIntent(query) || isUgcCreatorSideIntent(query))
+        return ROUTE_BY_PRIMITIVE.get("publishing") ?? null;
     if (isOwnLinkedInNetworkIntent(query) || isOpenLinkedInRequestsIntent(query))
         return ROUTE_BY_ID.get("connected-linkedin") ?? null;
     if (isCompanyPageFollowersIntent(query))
@@ -955,6 +972,19 @@ function isLocalBusinessIntent(query) {
     return /\b(local business(?:es)?|google maps|maps listings?|storefronts?|near me|(?:dental|medical|law|veterinary) (?:practices?|offices?|clinics?)|dentists?|restaurants?|cafes?|coffee shops?|gyms?|salons?|plumbers?|electricians?|contractors?|hvac|auto repair|real estate agents?|businesses (?:in|near|around) [a-z])\b/.test(query);
 }
 function recommendationsFor(card, query) {
+    if (card.primitive === "publishing" && isUgcCreatorSideIntent(query)) {
+        return {
+            tools: ["oxygen_ugc_get", "oxygen_ugc_application_create", "oxygen_ugc_invite_accept"],
+            commands: ["ugc programs discover", "ugc programs apply", "ugc creators accept"],
+        };
+    }
+    if (card.primitive === "publishing" && isUgcProgramIntent(query)) {
+        return {
+            tools: ["oxygen_ugc_program_create", "oxygen_ugc_invite_create", "oxygen_ugc_get"],
+            commands: ["ugc programs create", "ugc creators invite", "ugc programs list"],
+            exactCommand: "oxygen ugc programs create --product-url <your product site> --json",
+        };
+    }
     if (card.id === "sourcing-and-provider-tools" && isCompanyUrlRecoveryIntent(query)) {
         return {
             tools: ["oxygen_companies_search_plan", "oxygen_companies_search_run"],

package/node_modules/@oxygen/shared/dist/company-reply-pause.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Pause a company on reply: when one lead at a company replies, every other lead
+ * of that company is HELD (resumable, nothing is sent) until the reply is
+ * classified or a human resumes it. Shared by the tenant-db hold ledger, the
+ * inbound reply hooks, and the API/CLI/MCP surfaces so a company identity and
+ * the campaign setting resolve identically everywhere.
+ */
+/** Reply statuses that keep a company paused when the setting is enabled. */
+export declare const COMPANY_REPLY_PAUSE_DEFAULT_STATUSES: readonly string[];
+/**
+ * What the retired `stop_on_reply_scope: "company_domain"` meant: every
+ * AI-settable status except out_of_office stopped the company.
+ */
+export declare const COMPANY_REPLY_PAUSE_LEGACY_STATUSES: readonly string[];
+/**
+ * A reply status is an Inbox label key. Keys are minted by `slugifyLabelKey`
+ * (tenant-db email-labels): lower snake_case, never a leading underscore. The
+ * slug has no length limit of its own, so the bound here is generous.
+ */
+export declare const COMPANY_REPLY_PAUSE_STATUS_KEY_PATTERN: RegExp;
+export type CompanyReplyPauseSetting = {
+    enabled: boolean;
+    statuses: string[];
+};
+export type ResolvedCompanyReplyPause = CompanyReplyPauseSetting & {
+    source: "setting" | "legacy_scope" | "off";
+};
+/**
+ * Read a Sequence's `settings.company_reply_pause`. An explicit setting (even a
+ * disabled one) wins over the deprecated `stop_on_reply_scope` alias; without
+ * it, `"company_domain"` reads as enabled with the legacy statuses.
+ */
+export declare function resolveCompanyReplyPause(settings: Record<string, unknown> | null | undefined): ResolvedCompanyReplyPause;
+/**
+ * Every company identity key an enrollment row carries: explicit company-domain
+ * and LinkedIn-company fields plus the recipient email's domain. A consumer mail
+ * host (gmail, outlook, …) is never a company, from either source, so strangers
+ * who share a mail provider are never grouped. Deduplicated and sorted.
+ */
+export declare function companyIdentityKeysFromRowValues(rowValues: Record<string, unknown> | null | undefined, emailColumnKey?: string | null): string[];
+export type CompanyIdentityErrorCode = "company_identity_required" | "company_identity_ambiguous" | "company_domain_invalid" | "company_email_freemail" | "company_email_invalid" | "company_linkedin_invalid";
+/** Resolve the one company a pause/resume action names. */
+export declare function companyIdentityFromActionInput(input: {
+    domain?: string | null;
+    email?: string | null;
+    linkedinCompanyUrl?: string | null;
+}): {
+    ok: true;
+    keys: string[];
+    displayName: string;
+} | {
+    ok: false;
+    code: CompanyIdentityErrorCode;
+    message: string;
+};

package/node_modules/@oxygen/shared/dist/company-reply-pause.js

@@ -0,0 +1,146 @@
+import { companyDncIdentitiesFromRowValues, companyDncIdentityKey, normalizeCompanyDncDomain, normalizeLinkedinCompanyUrl, } from "./dnc-identities.js";
+import { isFreemailDomain } from "./freemail-domains.js";
+import { recipientEmailFromRow } from "./sequences.js";
+/**
+ * Pause a company on reply: when one lead at a company replies, every other lead
+ * of that company is HELD (resumable, nothing is sent) until the reply is
+ * classified or a human resumes it. Shared by the tenant-db hold ledger, the
+ * inbound reply hooks, and the API/CLI/MCP surfaces so a company identity and
+ * the campaign setting resolve identically everywhere.
+ */
+/** Reply statuses that keep a company paused when the setting is enabled. */
+export const COMPANY_REPLY_PAUSE_DEFAULT_STATUSES = [
+    "interested",
+    "neutral",
+    "not_now",
+    "not_interested",
+];
+/**
+ * What the retired `stop_on_reply_scope: "company_domain"` meant: every
+ * AI-settable status except out_of_office stopped the company.
+ */
+export const COMPANY_REPLY_PAUSE_LEGACY_STATUSES = [
+    ...COMPANY_REPLY_PAUSE_DEFAULT_STATUSES,
+    "wrong_person",
+];
+/**
+ * A reply status is an Inbox label key. Keys are minted by `slugifyLabelKey`
+ * (tenant-db email-labels): lower snake_case, never a leading underscore. The
+ * slug has no length limit of its own, so the bound here is generous.
+ */
+export const COMPANY_REPLY_PAUSE_STATUS_KEY_PATTERN = /^[a-z0-9][a-z0-9_]{0,127}$/;
+/**
+ * Read a Sequence's `settings.company_reply_pause`. An explicit setting (even a
+ * disabled one) wins over the deprecated `stop_on_reply_scope` alias; without
+ * it, `"company_domain"` reads as enabled with the legacy statuses.
+ */
+export function resolveCompanyReplyPause(settings) {
+    const raw = settings?.company_reply_pause;
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        const record = raw;
+        const statuses = Array.isArray(record.statuses)
+            ? [...new Set(record.statuses.filter((status) => typeof status === "string" && COMPANY_REPLY_PAUSE_STATUS_KEY_PATTERN.test(status)))]
+            : [];
+        if (record.enabled !== true)
+            return { enabled: false, statuses, source: "setting" };
+        return {
+            enabled: true,
+            statuses: statuses.length > 0 ? statuses : [...COMPANY_REPLY_PAUSE_DEFAULT_STATUSES],
+            source: "setting",
+        };
+    }
+    if (settings?.stop_on_reply_scope === "company_domain") {
+        return { enabled: true, statuses: [...COMPANY_REPLY_PAUSE_LEGACY_STATUSES], source: "legacy_scope" };
+    }
+    return { enabled: false, statuses: [], source: "off" };
+}
+function emailDomain(email) {
+    const at = email.lastIndexOf("@");
+    if (at <= 0)
+        return null;
+    return normalizeCompanyDncDomain(email.slice(at + 1));
+}
+/**
+ * Every company identity key an enrollment row carries: explicit company-domain
+ * and LinkedIn-company fields plus the recipient email's domain. A consumer mail
+ * host (gmail, outlook, …) is never a company, from either source, so strangers
+ * who share a mail provider are never grouped. Deduplicated and sorted.
+ */
+export function companyIdentityKeysFromRowValues(rowValues, emailColumnKey) {
+    if (!rowValues)
+        return [];
+    const keys = new Set();
+    for (const identity of companyDncIdentitiesFromRowValues(rowValues)) {
+        if (identity.kind === "domain" && isFreemailDomain(identity.value))
+            continue;
+        keys.add(identity.key);
+    }
+    const email = recipientEmailFromRow(rowValues, emailColumnKey);
+    const domain = email ? emailDomain(email) : null;
+    if (domain && !isFreemailDomain(domain))
+        keys.add(companyDncIdentityKey("domain", domain));
+    return [...keys].sort();
+}
+/** Resolve the one company a pause/resume action names. */
+export function companyIdentityFromActionInput(input) {
+    const domain = input.domain?.trim() || null;
+    const email = input.email?.trim() || null;
+    const linkedinCompanyUrl = input.linkedinCompanyUrl?.trim() || null;
+    const provided = [domain, email, linkedinCompanyUrl].filter((value) => value !== null).length;
+    if (provided === 0) {
+        return {
+            ok: false,
+            code: "company_identity_required",
+            message: "Name the company with a domain, an email address, or a LinkedIn company URL.",
+        };
+    }
+    if (provided > 1) {
+        return {
+            ok: false,
+            code: "company_identity_ambiguous",
+            message: "Name the company one way only: a domain, an email address, or a LinkedIn company URL.",
+        };
+    }
+    if (domain) {
+        const normalized = normalizeCompanyDncDomain(domain);
+        if (!normalized) {
+            return { ok: false, code: "company_domain_invalid", message: `"${domain}" is not a company domain.` };
+        }
+        if (isFreemailDomain(normalized)) {
+            return {
+                ok: false,
+                code: "company_domain_invalid",
+                message: `${normalized} is a personal email provider, not a company.`,
+            };
+        }
+        return { ok: true, keys: [companyDncIdentityKey("domain", normalized)], displayName: normalized };
+    }
+    if (email) {
+        const at = email.lastIndexOf("@");
+        const normalized = at > 0 && !/\s/.test(email) ? emailDomain(email) : null;
+        if (!normalized) {
+            return { ok: false, code: "company_email_invalid", message: `"${email}" is not an email address.` };
+        }
+        if (isFreemailDomain(normalized)) {
+            return {
+                ok: false,
+                code: "company_email_freemail",
+                message: `${normalized} is a personal email provider, so the address does not identify a company.`,
+            };
+        }
+        return { ok: true, keys: [companyDncIdentityKey("domain", normalized)], displayName: normalized };
+    }
+    const url = normalizeLinkedinCompanyUrl(linkedinCompanyUrl);
+    if (!url) {
+        return {
+            ok: false,
+            code: "company_linkedin_invalid",
+            message: `"${linkedinCompanyUrl}" is not a LinkedIn company page URL.`,
+        };
+    }
+    return {
+        ok: true,
+        keys: [companyDncIdentityKey("linkedin_company", url)],
+        displayName: url.replace(/^https:\/\/www\./, ""),
+    };
+}

package/node_modules/@oxygen/shared/dist/freemail-domains.d.ts

@@ -17,9 +17,9 @@
  *   Two consumers ride on that answer, and they fail in OPPOSITE directions, which is
  *   why this tier is conservative rather than generous:
  *
- *     1. The company-scope reply stop (`settings.stop_on_reply_scope = "company_domain"`)
- *        terminalizes an enrollment's colleagues by matching domain. A host wrongly IN
- *        this tier is harmless here; a host wrongly OUT of it stops strangers who merely
+ *     1. Pause a company on reply (`settings.company_reply_pause`, company-reply-pause.ts)
+ *        holds an enrollment's colleagues by matching domain. A host wrongly IN this
+ *        tier is harmless here; a host wrongly OUT of it pauses strangers who merely
  *        share a mail host — real, customer-visible damage.
  *     2. Company derivation from a person's email domain
  *        (`deriveCompanyDomainFromEmail`, `packages/tenant-db/src/table-link-plan.ts`)

package/node_modules/@oxygen/shared/dist/freemail-domains.js

@@ -17,9 +17,9 @@
  *   Two consumers ride on that answer, and they fail in OPPOSITE directions, which is
  *   why this tier is conservative rather than generous:
  *
- *     1. The company-scope reply stop (`settings.stop_on_reply_scope = "company_domain"`)
- *        terminalizes an enrollment's colleagues by matching domain. A host wrongly IN
- *        this tier is harmless here; a host wrongly OUT of it stops strangers who merely
+ *     1. Pause a company on reply (`settings.company_reply_pause`, company-reply-pause.ts)
+ *        holds an enrollment's colleagues by matching domain. A host wrongly IN this
+ *        tier is harmless here; a host wrongly OUT of it pauses strangers who merely
  *        share a mail host — real, customer-visible damage.
  *     2. Company derivation from a person's email domain
  *        (`deriveCompanyDomainFromEmail`, `packages/tenant-db/src/table-link-plan.ts`)

package/node_modules/@oxygen/shared/dist/linkedin-quota-denial.d.ts

@@ -17,6 +17,8 @@
 import { OxygenError } from "./cli-result.js";
 /** Was this thrown error the quota chokepoint refusing the call? */
 export declare function isLinkedInQuotaDenial(error: unknown): error is OxygenError;
+/** Quota messages include sender display names; log only the typed code. */
+export declare function linkedInQuotaSafeErrorFields(error: unknown): Record<string, unknown>;
 /**
  * When a quota-denied caller may try again — the denial's own `resets_at` when it
  * carries a usable one, else a flat hour. Null for anything that is NOT a quota

package/node_modules/@oxygen/shared/dist/linkedin-quota-denial.js

@@ -15,6 +15,7 @@
  * until its budget resets rather than re-denied on every tenant tick.
  */
 import { OxygenError } from "./cli-result.js";
+import { errorFields } from "./log.js";
 import { isRecord } from "./type-guards.js";
 // The codes a denial is raised with. Each is a "come back later" signal, not a
 // broken caller: a daily cap / closed active window that reopens on its own clock,
@@ -37,6 +38,10 @@ const QUOTA_FALLBACK_BACKOFF_MS = 60 * 60 * 1000;
 export function isLinkedInQuotaDenial(error) {
     return error instanceof OxygenError && QUOTA_DENIED_CODES.has(error.code);
 }
+/** Quota messages include sender display names; log only the typed code. */
+export function linkedInQuotaSafeErrorFields(error) {
+    return isLinkedInQuotaDenial(error) ? { error_code: error.code } : errorFields(error);
+}
 /**
  * When a quota-denied caller may try again — the denial's own `resets_at` when it
  * carries a usable one, else a flat hour. Null for anything that is NOT a quota

package/node_modules/@oxygen/shared/dist/plan-band.d.ts

@@ -14,6 +14,13 @@ import { type WorkspaceTableCapacityStatus } from "./table-capacity.js";
  */
 export type PlanBand = "free" | "49" | "99" | "199" | "499" | "999" | "1999";
 export declare const PLAN_BAND_ORDER: readonly PlanBand[];
+/** Whether a larger plan actually raises either storage limit in force. */
+export declare function largerPlanStorageRelief(band: PlanBand, options?: RepricingOptions): {
+    tableRows: boolean;
+    workspace: boolean;
+};
+/** A database refusal carries its enforced cap, but no billing-plan identity. */
+export declare function anyPlanRaisesTableRowLimit(enforcedLimitRows: number, workspaceLimitRows?: number, options?: RepricingOptions): boolean;
 /** The limits rung each band enforces at today. */
 export declare const PLAN_BAND_LIMITS_TIER: Readonly<Record<PlanBand, LimitsTier>>;
 /**

package/node_modules/@oxygen/shared/dist/plan-band.js

@@ -12,6 +12,30 @@ export const PLAN_BAND_ORDER = [
     "999",
     "1999",
 ];
+/** Whether a larger plan actually raises either storage limit in force. */
+export function largerPlanStorageRelief(band, options = {}) {
+    const current = resolveWorkspaceTableCapacity(band, options);
+    const larger = PLAN_BAND_ORDER.slice(PLAN_BAND_ORDER.indexOf(band) + 1)
+        .map((next) => resolveWorkspaceTableCapacity(next, options));
+    return {
+        tableRows: larger.some((next) => next.tableRowLimit > current.tableRowLimit),
+        workspace: larger.some((next) => next.workspaceRowLimit > current.workspaceRowLimit
+            || next.workspaceDatabaseLimitBytes > current.workspaceDatabaseLimitBytes),
+    };
+}
+/** A database refusal carries its enforced cap, but no billing-plan identity. */
+export function anyPlanRaisesTableRowLimit(enforcedLimitRows, workspaceLimitRows, options = {}) {
+    if (workspaceLimitRows !== undefined) {
+        const matchingBand = PLAN_BAND_ORDER.find((band) => {
+            const capacity = resolveWorkspaceTableCapacity(band, options);
+            return capacity.tableRowLimit === enforcedLimitRows
+                && capacity.workspaceRowLimit === workspaceLimitRows;
+        });
+        // A mismatched pair is drift, not evidence that buying a new plan helps.
+        return matchingBand ? largerPlanStorageRelief(matchingBand, options).tableRows : false;
+    }
+    return PLAN_BAND_ORDER.some((band) => resolveWorkspaceTableCapacity(band, options).tableRowLimit > enforcedLimitRows);
+}
 /** The limits rung each band enforces at today. */
 export const PLAN_BAND_LIMITS_TIER = Object.freeze({
     free: "free",

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

@@ -451,12 +451,23 @@ export type SequenceAutoOptimizeConfig = {
 };
 export declare const SEQUENCE_STEP_KINDS: readonly ["visit_profile", "invite", "wait_for_connection", "message", "inmail", "follow", "like_post", "comment_post", "withdraw_invite", "email_send", "email_reply", "email_enroll", "email_move", "email_stop", "whatsapp_message", "call_task", "crm_task", "wait", "wait_for_signal", "branch", "stop"];
 export type SequenceStepKind = (typeof SEQUENCE_STEP_KINDS)[number];
+/**
+ * Advanced: the sender profile (person) whose LinkedIn account sends this step.
+ * Omitted = the lead's assigned person. LinkedIn lets one of the workspace's
+ * accounts hold a conversation with a lead, so the relationship steps
+ * (invite, message, inmail, withdraw_invite) must all name the same person or
+ * none: that person then owns every lead's LinkedIn thread. Light touches
+ * (visit_profile, follow, like_post, comment_post) may each name anyone.
+ */
+export type SequenceLinkedInStepSender = {
+    sender_profile_id?: string;
+};
 export type SequenceLinkedInVisitProfileStep = {
     id: string;
     channel: "linkedin";
     kind: "visit_profile";
-};
-export type SequenceLinkedInInviteStep = {
+} & SequenceLinkedInStepSender;
+export type SequenceLinkedInInviteStep = SequenceLinkedInStepSender & {
     id: string;
     channel: "linkedin";
     kind: "invite";
@@ -475,7 +486,7 @@ export type SequenceLinkedInAttachment = {
     url: string;
     name?: string;
 };
-export type SequenceLinkedInMessageStep = {
+export type SequenceLinkedInMessageStep = SequenceLinkedInStepSender & {
     id: string;
     channel: "linkedin";
     kind: "message";
@@ -489,7 +500,7 @@ export type SequenceLinkedInMessageStep = {
     /** Files attached to the message (≤ a few, fetched at dispatch). */
     attachments?: SequenceLinkedInAttachment[];
 };
-export type SequenceLinkedInInMailStep = {
+export type SequenceLinkedInInMailStep = SequenceLinkedInStepSender & {
     id: string;
     channel: "linkedin";
     kind: "inmail";
@@ -507,8 +518,8 @@ export type SequenceLinkedInFollowStep = {
     id: string;
     channel: "linkedin";
     kind: "follow";
-};
-export type SequenceLinkedInLikePostStep = {
+} & SequenceLinkedInStepSender;
+export type SequenceLinkedInLikePostStep = SequenceLinkedInStepSender & {
     id: string;
     channel: "linkedin";
     kind: "like_post";
@@ -516,7 +527,7 @@ export type SequenceLinkedInLikePostStep = {
     post_recency_days?: number;
     on_no_post?: "stop";
 };
-export type SequenceLinkedInCommentPostStep = {
+export type SequenceLinkedInCommentPostStep = SequenceLinkedInStepSender & {
     id: string;
     channel: "linkedin";
     kind: "comment_post";
@@ -529,7 +540,7 @@ export type SequenceLinkedInWithdrawInviteStep = {
     id: string;
     channel: "linkedin";
     kind: "withdraw_invite";
-};
+} & SequenceLinkedInStepSender;
 export type SequenceEmailEnrollStep = {
     id: string;
     channel: "email";
@@ -557,6 +568,8 @@ export type SequenceEmailSendStep = {
     id: string;
     channel: "email";
     kind: "email_send";
+    /** Advanced: send this step from this exact inbox instead of the lead's normal assignment. */
+    sender_mailbox_id?: string;
     /**
      * Subject line. Supports {{column}} interpolation.
      *
@@ -990,6 +1003,39 @@ export type SequenceMissingCopy = {
  * stored under `draft`. Empty means nothing to send, so starting would
  * either dispatch a blank message or fail per lead at send time.
  */
+/**
+ * Threaded email steps that would continue another inbox's thread. A provider
+ * thread belongs to the mailbox that opened it, so a step that changes From —
+ * an exact-inbox step, or the return to the lead's assigned inbox after one —
+ * must open a new thread under its own subject. Checked on save and again at
+ * launch, because a draft may be saved half-written.
+ */
+export declare function sequenceSenderThreadConflicts(steps: readonly SequenceStep[]): {
+    index: number;
+    stepId: string;
+    message: string;
+}[];
+/** LinkedIn kinds that open or continue a conversation, so bind the lead to one account. */
+export declare const LINKEDIN_RELATIONSHIP_STEP_KINDS: Set<string>;
+/** LinkedIn light touches: they bind nothing, so each may come from any selected person. */
+export declare const LINKEDIN_LIGHT_TOUCH_STEP_KINDS: Set<string>;
+/**
+ * The person who owns every lead's LinkedIn conversation in this journey, when
+ * the relationship steps name one (null = each lead's assigned person). Only
+ * meaningful once sequenceLinkedInOwnerConflicts is empty.
+ */
+export declare function sequenceLinkedInOwnerProfileId(steps: readonly SequenceStep[]): string | null;
+/**
+ * Relationship steps that disagree about who sends them. LinkedIn lets one of
+ * the workspace's accounts hold a conversation with a lead (and OXYGEN binds
+ * the lead to the first account that invites or messages it), so a connection
+ * request from one person followed by a message from another would be refused.
+ */
+export declare function sequenceLinkedInOwnerConflicts(steps: readonly SequenceStep[]): {
+    index: number;
+    stepId: string;
+    message: string;
+}[];
 export declare function sequenceStepsMissingCopy(steps: readonly SequenceStep[]): SequenceMissingCopy[];
 /**
  * Validate + normalize a raw sequence definition. Assigns stable ids to steps