@oxygen-agent/cli 1.1011.855 → 1.1011.1091

package/dist/sender-limits-flags.d.ts

@@ -1,4 +1,11 @@
+import type { Command } from "commander";
 import { type ContractFlagOverlay } from "./contract-flags.js";
+/**
+ * `whatsapp limits set`: one flag per key the WhatsApp limits route keeps, with
+ * the WhatsApp defaults and maximums from the shared owner (OXP-11.3.19). The
+ * body is still built by buildSenderLimitsBody, which reads the same flag names.
+ */
+export declare function addWhatsAppLimitFlags(command: Command): Command;
 /**
  * `--working-days` → ISO weekday numbers. Accepts day names or 1-7, comma
  * separated, and ranges (`mon-fri`, `1-5`). A token it cannot read is sent as

package/dist/sender-limits-flags.js

@@ -5,6 +5,7 @@
 import { OxygenError } from "@oxygen/shared/cli-result";
 import { LINKEDIN_SENDER_LIMIT_DEFAULTS, LINKEDIN_SENDER_LIMIT_MAXIMUMS, linkedInSenderLimitCautionLevel, } from "@oxygen/shared/linkedin-sequences";
 import { SENDER_LIMITS_PATCH_CONTRACT } from "@oxygen/shared/contracts/sender-limits";
+import { WHATSAPP_SENDER_LIMIT_DEFAULTS, WHATSAPP_SENDER_LIMIT_KEYS, WHATSAPP_SENDER_LIMIT_MAXIMUMS, WHATSAPP_SENDER_LIMIT_NOTES, } from "@oxygen/shared/whatsapp-sender-limits";
 import { readContractFlags } from "./contract-flags.js";
 /** "<text> (default N, max M)." for a LinkedIn sender limit flag, from the enforced constants. */
 function linkedInLimitHelp(key, text) {
@@ -48,6 +49,18 @@ const LIMIT_FLAG_NAMES = {
     min_action_spacing_seconds: "min-spacing-seconds",
     action_spacing_jitter_seconds: "spacing-jitter-seconds",
 };
+/**
+ * `whatsapp limits set`: one flag per key the WhatsApp limits route keeps, with
+ * the WhatsApp defaults and maximums from the shared owner (OXP-11.3.19). The
+ * body is still built by buildSenderLimitsBody, which reads the same flag names.
+ */
+export function addWhatsAppLimitFlags(command) {
+    for (const key of WHATSAPP_SENDER_LIMIT_KEYS) {
+        const flag = LIMIT_FLAG_NAMES[key] ?? key.replace(/_/g, "-");
+        command.option(`--${flag} <n>`, `${WHATSAPP_SENDER_LIMIT_NOTES[key]} (default ${WHATSAPP_SENDER_LIMIT_DEFAULTS[key]}, max ${WHATSAPP_SENDER_LIMIT_MAXIMUMS[key]}; higher values are clamped).`);
+    }
+    return command;
+}
 const WORKING_DAY_NAMES = {
     mon: 1, monday: 1, tue: 2, tues: 2, tuesday: 2, wed: 3, wednesday: 3, thu: 4, thur: 4, thurs: 4, thursday: 4,
     fri: 5, friday: 5, sat: 6, saturday: 6, sun: 7, sunday: 7,

package/dist/workspace-utility-flags.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+/** Existing native leaves retain their names and default-list alias. */
+export declare function addProviderLimitFlags(command: Command, operation: "list" | "set" | "delete"): Command;
+export declare function providerLimitBody(options: object): Record<string, unknown>;
+export declare function providerLimitQuery(options: object, operation: "list" | "delete"): string;
+export declare function addSuppressionListFlags(command: Command, kind: "addresses" | "domains"): Command;
+export declare function suppressionListQuery(options: object, kind: "addresses" | "domains"): string;

package/dist/workspace-utility-flags.js

@@ -0,0 +1,45 @@
+import { OxygenError } from "@oxygen/shared/cli-result";
+import { validateContract } from "@oxygen/shared/contracts/schema";
+import { emailDomainSuppressionListContract, emailSuppressionListContract, providerLimitListContract, providerLimitSelectorContract, providerLimitUpdateContract } from "@oxygen/shared/contracts/workspace-utilities";
+import { addContractFlags, readContractFlags } from "./contract-flags.js";
+/** Existing native leaves retain their names and default-list alias. */
+export function addProviderLimitFlags(command, operation) {
+    const contract = operation === "set" ? providerLimitUpdateContract : operation === "delete" ? providerLimitSelectorContract : providerLimitListContract;
+    addContractFlags(command, contract, {
+        provider: { valueName: "<provider>" }, operation: { valueName: "<operation>" },
+        limit: { valueName: "<n>" }, window_seconds: { valueName: "<n>" }, offset: { valueName: "<n>" }, max_chars: { valueName: "<n>" },
+    });
+    for (const field of contract.required ?? [])
+        command.options.find((option) => option.long === `--${field.replace(/_/g, "-")}`)?.makeOptionMandatory();
+    return command;
+}
+export function providerLimitBody(options) {
+    const body = readContractFlags(options, providerLimitUpdateContract);
+    const parsed = validateContract(providerLimitUpdateContract, body, { unknown: "reject", overMax: "reject" });
+    if (!parsed.ok)
+        throw new OxygenError("invalid_request", parsed.issues.map((issue) => issue.message).join(" "), { exitCode: 2 });
+    return body;
+}
+export function providerLimitQuery(options, operation) {
+    return query(input(options, operation === "list" ? providerLimitListContract : providerLimitSelectorContract));
+}
+export function addSuppressionListFlags(command, kind) {
+    return addContractFlags(command, suppressionContract(kind), {
+        reason: { valueName: "<reason>" }, search: { valueName: "<text>" }, limit: { valueName: "<n>" }, offset: { valueName: "<n>" }, max_chars: { valueName: "<n>" },
+    });
+}
+export function suppressionListQuery(options, kind) {
+    return query(input(options, suppressionContract(kind)));
+}
+function suppressionContract(kind) {
+    return kind === "addresses" ? emailSuppressionListContract : emailDomainSuppressionListContract;
+}
+function input(options, contract) {
+    const parsed = validateContract(contract, readContractFlags(options, contract), { unknown: "reject", overMax: "clamp" });
+    if (!parsed.ok)
+        throw new OxygenError("invalid_request", parsed.issues.map((issue) => issue.message).join(" "), { exitCode: 2 });
+    return parsed.value;
+}
+function query(args) {
+    return new URLSearchParams(Object.entries(args).filter(([, value]) => value !== null).map(([key, value]) => [key, String(value)])).toString();
+}

package/node_modules/@oxygen/shared/dist/attempt-provenance.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The identity a request asked about versus the one a provider answered with.
+ * Present on a refused attempt; `matched` is `false` whenever it is recorded.
+ */
+export type AttemptIdentityMatch = {
+    matched?: boolean;
+    requested?: string | null;
+    returned?: string | null;
+};
+/** Label for a skipped attempt's reason. Unknown reasons stay generic. */
+export declare function describeSkipReason(reason: string): string;
+/**
+ * Label for a `no_result` attempt whose answer was refused rather than absent,
+ * or `null` for an ordinary empty answer (which still reads "No result").
+ */
+export declare function describeRejectedAnswer(reason: string | null | undefined): string | null;
+/**
+ * One-line requested-vs-returned evidence for a refused attempt, for the cell's
+ * hover title. `null` when neither side named an identity — there is nothing to
+ * show and an empty tooltip is worse than none.
+ */
+export declare function describeIdentityMatch(identityMatch: AttemptIdentityMatch | null | undefined): string | null;

package/node_modules/@oxygen/shared/dist/attempt-provenance.js

@@ -0,0 +1,83 @@
+/**
+ * Human labels for a waterfall attempt's recorded `reason`. Single source of
+ * truth for the /tables data grid (`tables-workspace.tsx`) and the MCP
+ * enrichment-cell-detail widget, so an attempt explains itself one way wherever
+ * it is shown (OXP-7.3.40).
+ *
+ * Every label is grid-cell sized — these render inside a truncated attempt cell,
+ * not a detail panel.
+ */
+const ATTEMPT_REASON_LABELS = {
+    missing_input: "Run condition not met",
+    // The company waterfall's spelling of `missing_input`: it needs at least one
+    // of domain / name / linkedin_url before any lane can be dispatched.
+    missing_identity_input: "Missing identity",
+    byok_not_connected: "Not connected",
+    byok_requires_paid_plan: "Plan required",
+    step_disabled: "Step disabled",
+    unsupported_credential_mode: "Mode unsupported",
+    unknown_capability: "Unknown provider",
+    // A provider answered about a DIFFERENT company than the request named. The
+    // answer was refused rather than written to the row (Plain T-111), so calling
+    // it "skipped" would describe the wrong event entirely.
+    identity_mismatch: "Wrong company",
+    // A search-shaped lane returned no identity at all, so its answer could not be
+    // checked against the requested company and was not trusted.
+    identity_unverifiable: "Identity unverified",
+    // A pre-step that ran only to resolve an identity (e.g. a company LinkedIn
+    // URL) a later requested field needs. It owns no target column and writes no
+    // cell — recorded so the extra provider call is visible, never silent.
+    identity_prerequisite: "Identity step",
+    // Bring-your-own-key lane with no usable connection for this workspace:
+    // not connected, unhealthy, missing secret, or plan-gated.
+    provider_credentials_unavailable: "No credentials",
+    // Priced above the run's approved credit ceiling, so it was never dispatched.
+    credit_ceiling_reached: "Credit cap reached",
+    // An identity pre-step lane the run stood down: the ceiling had no headroom
+    // above what the requested fields themselves need, so resolving the identity
+    // would have spent the answer-bearing lane's budget.
+    identity_prerequisite_unaffordable: "Identity step unfunded",
+    // Oxygen could not resolve a managed price for the lane, so it never ran.
+    managed_price_unavailable: "Price unavailable",
+    // The row's person LinkedIn input is a company or school page, or no profile
+    // link at all, so the row was refused before any lane ran.
+    linkedin_url_not_a_profile: "Not a profile URL",
+};
+/**
+ * Reasons that mean "we got an answer and refused it", not "there was nothing
+ * to find". They arrive on an attempt whose status is `no_result`, where the
+ * bare "No result" reads as an absent answer and hides the rejection.
+ */
+const REJECTED_ANSWER_REASONS = new Set([
+    "identity_mismatch",
+    "identity_unverifiable",
+]);
+/** Label for a skipped attempt's reason. Unknown reasons stay generic. */
+export function describeSkipReason(reason) {
+    return ATTEMPT_REASON_LABELS[reason] ?? "Skipped";
+}
+/**
+ * Label for a `no_result` attempt whose answer was refused rather than absent,
+ * or `null` for an ordinary empty answer (which still reads "No result").
+ */
+export function describeRejectedAnswer(reason) {
+    if (!reason || !REJECTED_ANSWER_REASONS.has(reason))
+        return null;
+    return ATTEMPT_REASON_LABELS[reason] ?? null;
+}
+/**
+ * One-line requested-vs-returned evidence for a refused attempt, for the cell's
+ * hover title. `null` when neither side named an identity — there is nothing to
+ * show and an empty tooltip is worse than none.
+ */
+export function describeIdentityMatch(identityMatch) {
+    if (!identityMatch)
+        return null;
+    const requested = typeof identityMatch.requested === "string" ? identityMatch.requested.trim() : "";
+    const returned = typeof identityMatch.returned === "string" ? identityMatch.returned.trim() : "";
+    if (!requested && !returned)
+        return null;
+    const asked = requested ? `Requested ${requested}` : "Requested company";
+    const got = returned ? `provider returned ${returned}` : "provider returned no identity";
+    return `${asked}; ${got}`;
+}

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

@@ -50,6 +50,12 @@ export declare function occurrencesInPeriod(from: Date, to: Date, anchorDay: num
  * not such a period: it grants monthly slices, so its caller passes the current
  * slice's length (see recomputeOrgCommitmentBlock, P-23).
  *
+ * A calendar month runs 28-31 days, so months are counted in 31-day steps: every
+ * monthly period holds one month, as OXYGEN_PRODUCT.md states ("one more month of
+ * every fixed resource"). Counting in 30-day steps held two months through every
+ * 31-day period, refusing customers' own credits as committed (staff decision
+ * 2026-10-06).
+ *
  * Returns at least 1 — a missing/zero/garbage period length must never collapse
  * the block to nothing, which would silently disable the whole feature.
  */

package/node_modules/@oxygen/shared/dist/billing-anchors.js

@@ -113,6 +113,12 @@ export function occurrencesInPeriod(from, to, anchorDay) {
  * not such a period: it grants monthly slices, so its caller passes the current
  * slice's length (see recomputeOrgCommitmentBlock, P-23).
  *
+ * A calendar month runs 28-31 days, so months are counted in 31-day steps: every
+ * monthly period holds one month, as OXYGEN_PRODUCT.md states ("one more month of
+ * every fixed resource"). Counting in 30-day steps held two months through every
+ * 31-day period, refusing customers' own credits as committed (staff decision
+ * 2026-10-06).
+ *
  * Returns at least 1 — a missing/zero/garbage period length must never collapse
  * the block to nothing, which would silently disable the whole feature.
  */
@@ -120,7 +126,7 @@ export function blockPeriodsForSubscription(periodDays) {
     if (typeof periodDays !== "number" || !Number.isFinite(periodDays) || periodDays <= 0) {
         return 1;
     }
-    return Math.max(1, Math.ceil(periodDays / 30));
+    return Math.max(1, Math.ceil(periodDays / 31));
 }
 /**
  * Days between two instants, floored. Small helper so callers deriving

package/node_modules/@oxygen/shared/dist/capability-discovery.d.ts

@@ -119,6 +119,12 @@ export declare const SEQUENCE_UNSUBSCRIBE_COMMAND = "oxygen sequences update <se
  * Factories, so a caller can edit the object it gets.
  */
 export declare const CAPABILITY_ROUTE_MCP_CALLS: {
+    connectionPrices: () => {
+        tool: string;
+        arguments: {
+            view: string;
+        };
+    };
     connectedAppsList: () => {
         tool: string;
         arguments: {};