@oxygen-agent/cli 1.1011.1091 → 1.1012.2

package/node_modules/@oxygen/shared/dist/whatsapp-sender-limits.js

@@ -38,9 +38,59 @@ export const WHATSAPP_SENDER_LIMIT_MAXIMUMS = {
     min_action_spacing_seconds: 3600,
     action_spacing_jitter_seconds: 1800,
 };
+/** OXYGEN policy, not a provider-published guarantee of account safety. */
+export const WHATSAPP_WARMUP_RAMP = [
+    { throughDay: 2, cap: 5 },
+    { throughDay: 6, cap: 10 },
+    { throughDay: 13, cap: 15 },
+];
+export const WHATSAPP_WARMUP_FULL_CAP = WHATSAPP_SENDER_LIMIT_MAXIMUMS.messages_per_day;
+export const WHATSAPP_CONNECTION_COOLDOWN_MS = 24 * 60 * 60 * 1000;
+export const WHATSAPP_WARMUP_DAY_BASIS = "elapsed_24_hour_periods";
+export function whatsAppRampCapForDay(day) {
+    return WHATSAPP_WARMUP_RAMP.find((step) => day <= step.throughDay)?.cap ?? WHATSAPP_WARMUP_FULL_CAP;
+}
+export function whatsAppWarmupDay(anchor, now = new Date()) {
+    if (!anchor || !Number.isFinite(anchor.getTime()))
+        return 0;
+    return Math.max(0, Math.floor((now.getTime() - anchor.getTime()) / WHATSAPP_CONNECTION_COOLDOWN_MS));
+}
+/** Poll timestamps never advance this clock; legacy mirrors retain their creation time. */
+export function whatsAppConnectionCooldown(sender, now = new Date()) {
+    const raw = sender.metadata?.whatsapp_session_connected_at ?? sender.createdAt;
+    const at = raw instanceof Date ? raw : typeof raw === "string" ? new Date(raw) : null;
+    if (!at || !Number.isFinite(at.getTime())) {
+        return { session_connected_at: null, outreach_resume_at: null, blocked: true };
+    }
+    const resume = new Date(at.getTime() + WHATSAPP_CONNECTION_COOLDOWN_MS);
+    return { session_connected_at: at.toISOString(), outreach_resume_at: resume.toISOString(), blocked: now < resume };
+}
+/** Stored reads expose the same elapsed-day policy that dispatch enforces. */
+export function whatsAppWarmupStatus(sender, now = new Date()) {
+    const day = whatsAppWarmupDay(sender.warmupStartedAt, now);
+    const configured = resolveWhatsAppSenderLimits(sender.limitOverrides).messages_per_day;
+    const ramp = whatsAppRampCapForDay(day);
+    return {
+        warmup_started_at: sender.warmupStartedAt && Number.isFinite(sender.warmupStartedAt.getTime()) ? sender.warmupStartedAt.toISOString() : null,
+        warmup_day: day,
+        day_basis: WHATSAPP_WARMUP_DAY_BASIS,
+        ramp_cap_today: ramp,
+        configured_daily_cap: configured,
+        effective_daily_cap: Math.min(configured, ramp),
+        ramp: [
+            ...WHATSAPP_WARMUP_RAMP.map((step, index) => ({
+                from_day: index === 0 ? 0 : WHATSAPP_WARMUP_RAMP[index - 1].throughDay + 1,
+                through_day: step.throughDay, messages_per_day: Math.min(configured, step.cap),
+            })),
+            { from_day: 14, through_day: null, messages_per_day: configured },
+        ],
+        connection_cooldown_hours: 24,
+        ...whatsAppConnectionCooldown(sender, now),
+    };
+}
 /** What each WhatsApp limit counts, for MCP and CLI help. */
 export const WHATSAPP_SENDER_LIMIT_NOTES = {
-    messages_per_day: "Daily WhatsApp messages across direct warm traffic and opted-in Sequence actions; the warm-up ceiling (5, 10, 15, 20 by account age) wins when lower.",
+    messages_per_day: "Daily WhatsApp messages across direct warm traffic and opted-in Sequence actions. Ramp: days 0–2: 5; 3–6: 10; 7–13: 15; 14+: configured cap (20 default, 40 maximum). New outreach waits 24 hours after connection or reconnection.",
     likes_per_day: "Daily reactions.",
     messages_reads_per_day: "Chat and message-history reads.",
     relations_reads_per_day: "Chat-list reads.",

package/node_modules/@oxygen/shared/package.json

@@ -6,6 +6,11 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
+    "./external-write-policy": {
+      "types": "./dist/external-write-policy.d.ts",
+      "import": "./dist/external-write-policy.js",
+      "default": "./dist/external-write-policy.js"
+    },
     "./knowledge-vault-markdown": {
       "types": "./dist/knowledge-vault-markdown.d.ts",
       "import": "./dist/knowledge-vault-markdown.js",
@@ -196,6 +201,11 @@
       "import": "./dist/pricing-sheet.js",
       "default": "./dist/pricing-sheet.js"
     },
+    "./research-depth": {
+      "types": "./dist/research-depth.d.ts",
+      "import": "./dist/research-depth.js",
+      "default": "./dist/research-depth.js"
+    },
     "./copilot-plan": {
       "types": "./dist/copilot-plan.d.ts",
       "import": "./dist/copilot-plan.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.1011.1091",
+  "version": "1.1012.2",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",