@oxygen-agent/cli 1.45.4

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

@@ -0,0 +1,296 @@
+export const WEEKLY_USAGE_WINDOW_DAYS = 7;
+export const BILLING_CURRENCIES = ["usd"];
+export const DEFAULT_BILLING_CURRENCY = "usd";
+export const CONTACT_SALES_URL = "https://cal.com/tim-scheuer-mxbib9/45";
+export const BASE_PRICING_PLANS = {
+    free: {
+        tier: "free",
+        name: "Free",
+        monthlyPriceCents: 0,
+        monthlyCredits: 500,
+        weeklyCreditsLimit: 500,
+        rolloverCap: 500,
+        byokEnabled: false,
+        description: "Try OXYGEN with managed email, phone enrichment, and AI credits.",
+        ctaLabel: "Start free",
+        features: [
+            "All integrations",
+            "Workflows",
+            "No card required",
+        ],
+    },
+    starter: {
+        tier: "starter",
+        name: "Starter",
+        monthlyPriceCents: 9_900,
+        monthlyCredits: 5_000,
+        weeklyCreditsLimit: 2_000,
+        rolloverCap: 5_000,
+        byokEnabled: true,
+        description: "For founders running focused managed enrichment and AI columns.",
+        ctaLabel: "Choose Starter",
+        features: [
+            "All integrations",
+            "Bring your own keys",
+            "Workflows",
+            "Standard support",
+        ],
+    },
+    pro: {
+        tier: "pro",
+        name: "Pro",
+        monthlyPriceCents: 24_900,
+        monthlyCredits: 12_500,
+        weeklyCreditsLimit: 5_000,
+        rolloverCap: 12_500,
+        byokEnabled: true,
+        description: "For recurring GTM enrichment and AI-column workflows on managed credits.",
+        badge: "Most popular",
+        highlighted: true,
+        ctaLabel: "Choose Pro",
+        features: [
+            "All integrations",
+            "Bring your own keys",
+            "Workflows",
+            "Standard support",
+        ],
+    },
+    team: {
+        tier: "team",
+        name: "Team",
+        monthlyPriceCents: 74_900,
+        monthlyCredits: 37_500,
+        weeklyCreditsLimit: 15_000,
+        rolloverCap: 37_500,
+        byokEnabled: true,
+        description: "For small GTM teams and agencies running shared workflows with their own AI keys.",
+        ctaLabel: "Choose Team",
+        features: [
+            "All integrations",
+            "Bring your own keys",
+            "Workflows",
+            "Premium support",
+        ],
+    },
+    scale: {
+        tier: "scale",
+        name: "Scale",
+        monthlyPriceCents: null,
+        monthlyCredits: 500_000,
+        weeklyCreditsLimit: 500_000,
+        rolloverCap: 500_000,
+        byokEnabled: true,
+        description: "For high-volume GTM teams that need custom limits and rollout support.",
+        ctaLabel: "Contact sales",
+        contactHref: CONTACT_SALES_URL,
+        features: [
+            "500,000+ managed credits / month",
+            "Phone number enrichment on managed credits",
+            "Custom provider routing and BYOK policies",
+            "Dedicated onboarding",
+        ],
+    },
+    enterprise: {
+        tier: "enterprise",
+        name: "Enterprise",
+        monthlyPriceCents: null,
+        monthlyCredits: null,
+        weeklyCreditsLimit: null,
+        rolloverCap: null,
+        byokEnabled: true,
+        description: "Custom procurement, invoicing, limits, and rollout support.",
+        ctaLabel: "Talk to us",
+        contactHref: CONTACT_SALES_URL,
+        features: [
+            "Custom monthly usage pool",
+            "Phone number enrichment",
+            "Custom AI-key and provider routing policies",
+            "SSO, invoicing, and procurement support",
+        ],
+    },
+};
+export const PUBLIC_PLAN_ORDER = [
+    "starter",
+    "pro",
+    "team",
+];
+export const SELF_SERVE_PLAN_TIERS = [
+    "starter",
+    "pro",
+    "team",
+];
+export const CONTACT_SALES_PLAN_TIERS = [
+    "scale",
+    "enterprise",
+];
+export const ACTIVE_SUBSCRIPTION_STATUSES = [
+    "active",
+    "trialing",
+    "past_due",
+];
+const LEGACY_PRICING_PLAN_OVERRIDES = {
+    launch_50: {
+        ...BASE_PRICING_PLANS.starter,
+        name: "Legacy Launch",
+        monthlyPriceCents: 5_000,
+        monthlyCredits: 10_000,
+        weeklyCreditsLimit: 10_000,
+        rolloverCap: 10_000,
+        description: "Legacy Launch plan.",
+    },
+    starter_50: {
+        ...BASE_PRICING_PLANS.starter,
+        name: "Legacy Starter",
+        monthlyPriceCents: 5_000,
+        monthlyCredits: 10_000,
+        weeklyCreditsLimit: 10_000,
+        rolloverCap: 10_000,
+        description: "Legacy Starter plan.",
+    },
+    pro_149: {
+        ...BASE_PRICING_PLANS.pro,
+        name: "Legacy Pro",
+        monthlyPriceCents: 14_900,
+        monthlyCredits: 50_000,
+        weeklyCreditsLimit: 50_000,
+        rolloverCap: 50_000,
+        description: "Legacy Pro plan.",
+    },
+    team_399: {
+        ...BASE_PRICING_PLANS.team,
+        name: "Legacy Team",
+        monthlyPriceCents: 39_900,
+        monthlyCredits: 150_000,
+        weeklyCreditsLimit: 150_000,
+        rolloverCap: 150_000,
+        description: "Legacy Team plan.",
+    },
+    growth_250: {
+        ...BASE_PRICING_PLANS.pro,
+        monthlyPriceCents: 25_000,
+        monthlyCredits: 12_500,
+        weeklyCreditsLimit: 5_000,
+        rolloverCap: 12_500,
+        description: "Legacy Growth plan.",
+    },
+    scale_750: {
+        ...BASE_PRICING_PLANS.team,
+        name: "Legacy Scale",
+        monthlyPriceCents: 75_000,
+        monthlyCredits: 37_500,
+        weeklyCreditsLimit: 15_000,
+        rolloverCap: 37_500,
+        description: "Legacy Scale plan.",
+    },
+    starter_legacy: {
+        ...BASE_PRICING_PLANS.starter,
+        monthlyPriceCents: null,
+        monthlyCredits: 10_000,
+        weeklyCreditsLimit: BASE_PRICING_PLANS.starter.weeklyCreditsLimit,
+        rolloverCap: 10_000,
+        description: "Legacy Starter plan.",
+    },
+    scale_legacy: {
+        ...BASE_PRICING_PLANS.scale,
+        monthlyPriceCents: null,
+        monthlyCredits: 60_000,
+        weeklyCreditsLimit: BASE_PRICING_PLANS.scale.weeklyCreditsLimit,
+        rolloverCap: 120_000,
+        description: "Legacy Scale plan.",
+    },
+};
+export function resolveBasePricingPlan(tier) {
+    if (!tier)
+        return null;
+    if (tier in BASE_PRICING_PLANS) {
+        return BASE_PRICING_PLANS[tier];
+    }
+    const legacy = LEGACY_PRICING_PLAN_OVERRIDES[tier];
+    return legacy ?? null;
+}
+export function applyPricingPlanMetadataOverrides(plan, metadata) {
+    const record = readRecord(metadata);
+    if (!record)
+        return plan;
+    const config = readRecord(record.billing_plan)
+        ?? readRecord(record.custom_plan)
+        ?? readRecord(record.custom_limits)
+        ?? readRecord(record.plan_limits)
+        ?? record;
+    const name = readString(config, "name")
+        ?? readString(config, "plan_name")
+        ?? readString(record, "plan_name")
+        ?? readString(record, "custom_plan_name");
+    const description = readString(config, "description")
+        ?? readString(record, "plan_description")
+        ?? readString(record, "custom_plan_description");
+    const monthlyCredits = readCreditLimit(config, "monthlyCredits", "monthly_credits", "monthly_credit_limit");
+    const weeklyCreditsLimit = readCreditLimit(config, "weeklyCreditsLimit", "weekly_credits_limit", "weekly_credit_limit");
+    const rolloverCap = readCreditLimit(config, "rolloverCap", "rollover_cap", "rollover_credits");
+    const byokEnabled = readBoolean(config, "byokEnabled")
+        ?? readBoolean(config, "byok_enabled");
+    return {
+        ...plan,
+        name: name ?? plan.name,
+        monthlyCredits: monthlyCredits ?? plan.monthlyCredits,
+        weeklyCreditsLimit: weeklyCreditsLimit ?? plan.weeklyCreditsLimit,
+        rolloverCap: rolloverCap ?? plan.rolloverCap,
+        byokEnabled: byokEnabled ?? plan.byokEnabled,
+        description: description ?? plan.description,
+    };
+}
+export function isSelfServePlanTier(value) {
+    return SELF_SERVE_PLAN_TIERS.includes(value);
+}
+export function isBillingCurrency(value) {
+    return BILLING_CURRENCIES.includes(value);
+}
+export function normalizeBillingCurrency(value) {
+    return value && isBillingCurrency(value) ? value : DEFAULT_BILLING_CURRENCY;
+}
+function readRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    return value;
+}
+function readString(record, key) {
+    const value = record[key];
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function readBoolean(record, key) {
+    const value = record[key];
+    return typeof value === "boolean" ? value : null;
+}
+function readCreditLimit(record, ...keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (value === null)
+            return null;
+        if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+            return Math.trunc(value);
+        }
+        if (typeof value === "string" && value.trim()) {
+            const parsed = Number(value);
+            if (Number.isFinite(parsed) && parsed >= 0)
+                return Math.trunc(parsed);
+        }
+    }
+    return null;
+}
+export function getCurrentFreeTierCycleKey(date = new Date()) {
+    const year = date.getUTCFullYear();
+    const month = String(date.getUTCMonth() + 1).padStart(2, "0");
+    return `free:${year}-${month}`;
+}
+export function evaluateWeeklyQuota(usedCredits, requestedCredits, weeklyCreditsLimit) {
+    const projectedCredits = usedCredits + requestedCredits;
+    return {
+        usedCredits,
+        requestedCredits,
+        weeklyCreditsLimit,
+        remainingCredits: Math.max(0, weeklyCreditsLimit - usedCredits),
+        projectedRemainingCredits: Math.max(0, weeklyCreditsLimit - projectedCredits),
+        exceedsLimit: projectedCredits > weeklyCreditsLimit,
+    };
+}
+//# sourceMappingURL=billing.js.map

package/node_modules/@oxygen/shared/dist/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"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"}

package/node_modules/@oxygen/shared/dist/column-types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Shared column data-type detection and value coercion.
+ *
+ * This is the single source of truth for two related problems:
+ *  1. Import inference — deciding a freshly uploaded column is a date column
+ *     instead of dumping everything as `text` (see `inferImportColumnDataType`).
+ *  2. Column retype — converting an existing `text` column's raw values into a
+ *     stronger type without losing data (see `coerceValueForDataType`).
+ *
+ * Both paths must agree on what "looks like a date" means, otherwise an import
+ * would type a column one way and a manual retype another.
+ */
+/** Data types an import can infer for a brand-new column. Dates-only by design. */
+export type ImportColumnDataType = "text" | "timestamptz";
+/** Data types a `text` column can be explicitly retyped into. */
+export type RetypeableDataType = "text" | "numeric" | "boolean" | "timestamptz";
+export declare const RETYPEABLE_DATA_TYPES: readonly RetypeableDataType[];
+export declare const EXCEL_SERIAL_MIN = 10000;
+export declare const EXCEL_SERIAL_MAX = 80000;
+/** Convert an Excel/Sheets date serial to an ISO timestamp, or null if implausible. */
+export declare function excelSerialToIso(serial: number): string | null;
+/** Return the canonical ISO form of an ISO-8601-ish date string, or null. */
+export declare function parseIsoDateString(value: string): string | null;
+/** True when a column label/key implies it holds dates. */
+export declare function looksLikeDateColumnName(label: string): boolean;
+/**
+ * Best-effort conversion of a single cell value to an ISO timestamp.
+ * `allowExcelSerial` controls whether bare numbers (and numeric strings) are
+ * treated as Excel date serials — only enable it when the column name hints at
+ * a date or the user explicitly opted in via a retype.
+ */
+export declare function parseDateValueToIso(value: unknown, options?: {
+    allowExcelSerial: boolean;
+}): string | null;
+/**
+ * Infer the data type of a brand-new imported column from its label and sampled
+ * values. Conservative and dates-only: a column becomes `timestamptz` only when
+ * every non-empty value is an ISO date string, or (when the name hints at a
+ * date) every non-empty value is an Excel serial. Anything else stays `text`.
+ */
+export declare function inferImportColumnDataType(label: string, values: Iterable<unknown>): ImportColumnDataType;
+export type CoercionResult = {
+    ok: true;
+    value: string | number | boolean | null;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Coerce a raw cell value into the representation a target data type expects.
+ * Used by column retype: every value must coerce or the retype is rejected so
+ * the table is never left half-converted.
+ */
+export declare function coerceValueForDataType(value: unknown, dataType: RetypeableDataType): CoercionResult;
+//# sourceMappingURL=column-types.d.ts.map

package/node_modules/@oxygen/shared/dist/column-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.d.ts","sourceRoot":"","sources":["../src/column-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,aAAa,CAAC;AAE1D,iEAAiE;AACjE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAEhF,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAK9D,CAAC;AAWF,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAavC,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/D;AAED,2DAA2D;AAC3D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE;IAAE,gBAAgB,EAAE,OAAO,CAAA;CAAgC,GACnE,MAAM,GAAG,IAAI,CAkBf;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GACxB,oBAAoB,CAsBtB;AAWD,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,kBAAkB,GAC3B,cAAc,CA+BhB"}

package/node_modules/@oxygen/shared/dist/column-types.js

@@ -0,0 +1,161 @@
+/**
+ * Shared column data-type detection and value coercion.
+ *
+ * This is the single source of truth for two related problems:
+ *  1. Import inference — deciding a freshly uploaded column is a date column
+ *     instead of dumping everything as `text` (see `inferImportColumnDataType`).
+ *  2. Column retype — converting an existing `text` column's raw values into a
+ *     stronger type without losing data (see `coerceValueForDataType`).
+ *
+ * Both paths must agree on what "looks like a date" means, otherwise an import
+ * would type a column one way and a manual retype another.
+ */
+export const RETYPEABLE_DATA_TYPES = [
+    "text",
+    "numeric",
+    "boolean",
+    "timestamptz",
+];
+// Excel/Sheets store dates as a serial number of days since 1899-12-30.
+// Day 25569 of that system is the Unix epoch (1970-01-01).
+const EXCEL_EPOCH_DAY_OFFSET = 25_569;
+const MS_PER_DAY = 86_400_000;
+// A bare number is only treated as an Excel date serial when it lands inside
+// this window. ~10000 is 1927-05-18, ~80000 is 2119-01-?? — wide enough for any
+// realistic business date, narrow enough to reject years ("2024"), small
+// counters, and short identifiers that happen to sit in a date-named column.
+export const EXCEL_SERIAL_MIN = 10_000;
+export const EXCEL_SERIAL_MAX = 80_000;
+// Strict ISO-8601-ish date (optionally with time and zone). Deliberately strict:
+// `new Date()` alone would happily parse "46148" or "Acme" into garbage.
+const ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}([T ]\d{2}:\d{2}(:\d{2})?(\.\d+)?\s*(Z|[+-]\d{2}:?\d{2})?)?$/;
+// Column whose name implies a date. Used only as a guardrail for the ambiguous
+// "bare number" case — ISO strings are unambiguous and never need a name hint.
+const DATE_NAME_PATTERN = /(^|[^a-z])(date|datetime|timestamp)([^a-z]|$)|_at$|_on$/i;
+const NUMERIC_STRING_PATTERN = /^-?\d+(\.\d+)?$/;
+/** Convert an Excel/Sheets date serial to an ISO timestamp, or null if implausible. */
+export function excelSerialToIso(serial) {
+    if (!Number.isFinite(serial) || serial < EXCEL_SERIAL_MIN || serial > EXCEL_SERIAL_MAX) {
+        return null;
+    }
+    const date = new Date(Math.round((serial - EXCEL_EPOCH_DAY_OFFSET) * MS_PER_DAY));
+    return Number.isFinite(date.getTime()) ? date.toISOString() : null;
+}
+/** Return the canonical ISO form of an ISO-8601-ish date string, or null. */
+export function parseIsoDateString(value) {
+    const trimmed = value.trim();
+    if (!ISO_DATE_PATTERN.test(trimmed))
+        return null;
+    const date = new Date(trimmed);
+    return Number.isFinite(date.getTime()) ? date.toISOString() : null;
+}
+/** True when a column label/key implies it holds dates. */
+export function looksLikeDateColumnName(label) {
+    return DATE_NAME_PATTERN.test(label.trim());
+}
+/**
+ * Best-effort conversion of a single cell value to an ISO timestamp.
+ * `allowExcelSerial` controls whether bare numbers (and numeric strings) are
+ * treated as Excel date serials — only enable it when the column name hints at
+ * a date or the user explicitly opted in via a retype.
+ */
+export function parseDateValueToIso(value, options = { allowExcelSerial: false }) {
+    if (value === null || value === undefined)
+        return null;
+    if (value instanceof Date) {
+        return Number.isFinite(value.getTime()) ? value.toISOString() : null;
+    }
+    if (typeof value === "number") {
+        return options.allowExcelSerial ? excelSerialToIso(value) : null;
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed === "")
+            return null;
+        const iso = parseIsoDateString(trimmed);
+        if (iso)
+            return iso;
+        if (options.allowExcelSerial && NUMERIC_STRING_PATTERN.test(trimmed)) {
+            return excelSerialToIso(Number(trimmed));
+        }
+    }
+    return null;
+}
+/**
+ * Infer the data type of a brand-new imported column from its label and sampled
+ * values. Conservative and dates-only: a column becomes `timestamptz` only when
+ * every non-empty value is an ISO date string, or (when the name hints at a
+ * date) every non-empty value is an Excel serial. Anything else stays `text`.
+ */
+export function inferImportColumnDataType(label, values) {
+    const nameHintsDate = looksLikeDateColumnName(label);
+    let sawNonEmpty = false;
+    let allIsoStrings = true;
+    let allExcelSerials = true;
+    for (const value of values) {
+        if (value === null || value === undefined || value === "")
+            continue;
+        sawNonEmpty = true;
+        if (parseDateValueToIso(value, { allowExcelSerial: false }) === null) {
+            allIsoStrings = false;
+        }
+        if (!isExcelSerialValue(value)) {
+            allExcelSerials = false;
+        }
+        if (!allIsoStrings && !allExcelSerials)
+            break;
+    }
+    if (!sawNonEmpty)
+        return "text";
+    if (allIsoStrings)
+        return "timestamptz";
+    if (allExcelSerials && nameHintsDate)
+        return "timestamptz";
+    return "text";
+}
+function isExcelSerialValue(value) {
+    if (typeof value === "number")
+        return excelSerialToIso(value) !== null;
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        return NUMERIC_STRING_PATTERN.test(trimmed) && excelSerialToIso(Number(trimmed)) !== null;
+    }
+    return false;
+}
+/**
+ * Coerce a raw cell value into the representation a target data type expects.
+ * Used by column retype: every value must coerce or the retype is rejected so
+ * the table is never left half-converted.
+ */
+export function coerceValueForDataType(value, dataType) {
+    if (value === null || value === undefined || value === "") {
+        return { ok: true, value: null };
+    }
+    switch (dataType) {
+        case "text":
+            return { ok: true, value: typeof value === "string" ? value : String(value) };
+        case "timestamptz": {
+            const iso = parseDateValueToIso(value, { allowExcelSerial: true });
+            return iso
+                ? { ok: true, value: iso }
+                : { ok: false, reason: "not an ISO date or Excel date serial" };
+        }
+        case "numeric": {
+            const numeric = typeof value === "number" ? value : Number(String(value).trim());
+            return Number.isFinite(numeric)
+                ? { ok: true, value: numeric }
+                : { ok: false, reason: "not a finite number" };
+        }
+        case "boolean": {
+            const normalized = String(value).trim().toLowerCase();
+            if (["true", "t", "yes", "y", "1"].includes(normalized)) {
+                return { ok: true, value: true };
+            }
+            if (["false", "f", "no", "n", "0"].includes(normalized)) {
+                return { ok: true, value: false };
+            }
+            return { ok: false, reason: "not a recognized boolean" };
+        }
+    }
+}
+//# sourceMappingURL=column-types.js.map

package/node_modules/@oxygen/shared/dist/column-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.js","sourceRoot":"","sources":["../src/column-types.ts"],"names":[],"mappings":"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"}

package/node_modules/@oxygen/shared/dist/credit-guidance.d.ts

@@ -0,0 +1,15 @@
+export type CreditPosture = "sufficient" | "tight" | "unknown";
+export type CreditGuidance = {
+    estimated_credits: number | null;
+    recommended_max_credits: number | null;
+    available_credits: number | null;
+    credit_posture: CreditPosture;
+    credit_guidance: string;
+};
+export declare function buildCreditGuidance(input: {
+    estimatedCredits: number | null | undefined;
+    availableCredits: number | null | undefined;
+    headroomMultiplier?: number;
+}): CreditGuidance;
+export declare function recommendedCreditCeiling(estimatedCredits: number | null | undefined, headroomMultiplier?: number): number | null;
+//# sourceMappingURL=credit-guidance.d.ts.map

package/node_modules/@oxygen/shared/dist/credit-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-guidance.d.ts","sourceRoot":"","sources":["../src/credit-guidance.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG;IAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,aAAa,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAIF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,cAAc,CAgDjB;AAED,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC3C,kBAAkB,SAA8B,GAC/C,MAAM,GAAG,IAAI,CAQf"}

package/node_modules/@oxygen/shared/dist/credit-guidance.js

@@ -0,0 +1,60 @@
+const DEFAULT_HEADROOM_MULTIPLIER = 1.25;
+export function buildCreditGuidance(input) {
+    const estimatedCredits = normalizeCreditValue(input.estimatedCredits);
+    const availableCredits = normalizeCreditValue(input.availableCredits);
+    const recommendedMaxCredits = recommendedCreditCeiling(estimatedCredits, input.headroomMultiplier ?? DEFAULT_HEADROOM_MULTIPLIER);
+    if (estimatedCredits === null) {
+        return {
+            estimated_credits: null,
+            recommended_max_credits: null,
+            available_credits: availableCredits,
+            credit_posture: "unknown",
+            credit_guidance: "Credit estimate is unavailable; require an explicit max_credits before running paid work.",
+        };
+    }
+    if (availableCredits === null) {
+        return {
+            estimated_credits: estimatedCredits,
+            recommended_max_credits: recommendedMaxCredits,
+            available_credits: null,
+            credit_posture: "unknown",
+            credit_guidance: "Credit estimate is available, but balance is unknown. Use recommended_max_credits only after confirming available credits. Unused credits are not spent.",
+        };
+    }
+    if (recommendedMaxCredits !== null && recommendedMaxCredits <= availableCredits) {
+        return {
+            estimated_credits: estimatedCredits,
+            recommended_max_credits: recommendedMaxCredits,
+            available_credits: availableCredits,
+            credit_posture: "sufficient",
+            credit_guidance: "Credits are sufficient; use recommended_max_credits as a safety ceiling. Unused credits are not spent.",
+        };
+    }
+    return {
+        estimated_credits: estimatedCredits,
+        recommended_max_credits: availableCredits > 0 ? roundCreditValue(availableCredits) : null,
+        available_credits: availableCredits,
+        credit_posture: "tight",
+        credit_guidance: "Credits are tight for the recommended ceiling; ask before running, reduce scope, or top up credits.",
+    };
+}
+export function recommendedCreditCeiling(estimatedCredits, headroomMultiplier = DEFAULT_HEADROOM_MULTIPLIER) {
+    const normalized = normalizeCreditValue(estimatedCredits);
+    if (normalized === null)
+        return null;
+    if (normalized === 0)
+        return 0;
+    const multiplier = Number.isFinite(headroomMultiplier) && headroomMultiplier > 0
+        ? headroomMultiplier
+        : DEFAULT_HEADROOM_MULTIPLIER;
+    return Math.max(1, Math.ceil(normalized * multiplier));
+}
+function normalizeCreditValue(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0)
+        return null;
+    return roundCreditValue(value);
+}
+function roundCreditValue(value) {
+    return Math.round(value * 1000) / 1000;
+}
+//# sourceMappingURL=credit-guidance.js.map

package/node_modules/@oxygen/shared/dist/credit-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-guidance.js","sourceRoot":"","sources":["../src/credit-guidance.ts"],"names":[],"mappings":"AAUA,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEzC,MAAM,UAAU,mBAAmB,CAAC,KAInC;IACC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACtE,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACtE,MAAM,qBAAqB,GAAG,wBAAwB,CACpD,gBAAgB,EAChB,KAAK,CAAC,kBAAkB,IAAI,2BAA2B,CACxD,CAAC;IAEF,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,OAAO;YACL,iBAAiB,EAAE,IAAI;YACvB,uBAAuB,EAAE,IAAI;YAC7B,iBAAiB,EAAE,gBAAgB;YACnC,cAAc,EAAE,SAAS;YACzB,eAAe,EAAE,2FAA2F;SAC7G,CAAC;IACJ,CAAC;IAED,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,OAAO;YACL,iBAAiB,EAAE,gBAAgB;YACnC,uBAAuB,EAAE,qBAAqB;YAC9C,iBAAiB,EAAE,IAAI;YACvB,cAAc,EAAE,SAAS;YACzB,eAAe,EACb,0JAA0J;SAC7J,CAAC;IACJ,CAAC;IAED,IAAI,qBAAqB,KAAK,IAAI,IAAI,qBAAqB,IAAI,gBAAgB,EAAE,CAAC;QAChF,OAAO;YACL,iBAAiB,EAAE,gBAAgB;YACnC,uBAAuB,EAAE,qBAAqB;YAC9C,iBAAiB,EAAE,gBAAgB;YACnC,cAAc,EAAE,YAAY;YAC5B,eAAe,EACb,wGAAwG;SAC3G,CAAC;IACJ,CAAC;IAED,OAAO;QACL,iBAAiB,EAAE,gBAAgB;QACnC,uBAAuB,EAAE,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI;QACzF,iBAAiB,EAAE,gBAAgB;QACnC,cAAc,EAAE,OAAO;QACvB,eAAe,EACb,qGAAqG;KACxG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,gBAA2C,EAC3C,kBAAkB,GAAG,2BAA2B;IAEhD,MAAM,UAAU,GAAG,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAC1D,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,kBAAkB,GAAG,CAAC;QAC9E,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,2BAA2B,CAAC;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAgC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACnF,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACzC,CAAC"}

package/node_modules/@oxygen/shared/dist/file-import.d.ts

@@ -0,0 +1,22 @@
+import { type ImportColumnDataType } from "./column-types.js";
+export type RowsFileFormat = "json" | "jsonl" | "csv" | "xlsx";
+export type ImportTableColumn = {
+    label: string;
+    key: string;
+    data_type: ImportColumnDataType;
+};
+export type NewTableImportRows = {
+    columns: ImportTableColumn[];
+    rows: Record<string, unknown>[];
+    keyBySource: Record<string, string>;
+};
+export declare function inferRowsFileFormat(path: string): RowsFileFormat;
+export declare function normalizeRowsFormat(value: string | undefined, fallback: RowsFileFormat): RowsFileFormat;
+export declare function parseRowsFileBuffer(buffer: Buffer, format: RowsFileFormat, options?: {
+    sheet?: string;
+}): Promise<Record<string, unknown>[]>;
+export declare function parseRowsText(text: string, format: Exclude<RowsFileFormat, "xlsx">): Record<string, unknown>[];
+export declare function inferImportColumnLabels(rows: Record<string, unknown>[]): string[];
+export declare function normalizeRowsForNewTable(rows: Record<string, unknown>[]): NewTableImportRows;
+export declare function normalizeImportColumnKey(value: string): string;
+//# sourceMappingURL=file-import.d.ts.map

package/node_modules/@oxygen/shared/dist/file-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-import.d.ts","sourceRoot":"","sources":["../src/file-import.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,mBAAmB,CAAC;AAG3B,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC;AAIF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAMhE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,cAAc,GACvB,cAAc,CAchB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAGpC;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAW3B;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,CAWjF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,kBAAkB,CAuC5F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW9D"}