backend-manager 5.9.20 → 5.9.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backend-manager",
-  "version": "5.9.20",
+  "version": "5.9.22",
   "description": "Quick tools for developing Firebase functions",
   "main": "src/manager/index.js",
   "files": [

package/src/manager/events/cron/daily/marketing-prune.js

@@ -5,12 +5,14 @@
  * Two-stage process using SSOT segment keys from constants.js:
  *
  *   Stage 1 (engagement_inactive_5m):
- *     → Send re-engagement email via sendCampaign
+ *     → Send re-engagement email via sendCampaign (brand-scoped internally)
  *     → Excludes engagement_inactive_6m (those get pruned instead)
  *
  *   Stage 2 (engagement_inactive_6m):
- *     → Export contacts from segment, bulk delete
- *     → Excludes subscription_paid (never prune paying customers)
+ *     → Create brand-scoped temp segment via createBrandScopedSegment
+ *     → Export contacts, exclude paying customers, bulk delete
+ *     → Log deleted emails to Firestore for recoverability
+ *     → Remove from Beehiiv (same emails)
  *
  * Segment keys are resolved to provider-specific IDs at runtime.
  * Requires marketing.prune.enabled = true in backend-manager-config.json.
@@ -19,8 +21,7 @@
  */
 const sendgridProvider = require('../../../libraries/email/providers/sendgrid.js');
 
-module.exports = async ({ Manager, assistant }) => {
-  // Only run on the 1st of the month
+module.exports = async ({ Manager, assistant, libraries }) => {
   if (new Date().getDate() !== 1) {
     return;
   }
@@ -30,20 +31,29 @@ module.exports = async ({ Manager, assistant }) => {
     return;
   }
 
-  assistant.log('Marketing prune: Starting monthly prune cycle');
+  const brand = Manager.config?.brand;
+
+  assistant.log(`Marketing prune: Starting monthly prune cycle for ${brand?.id || 'unknown'}`);
 
   // --- Stage 1: Re-engagement email ---
-  await stageReengage(Manager, assistant);
+  try {
+    await stageReengage(Manager, assistant);
+  } catch (e) {
+    assistant.error('Marketing prune: Stage 1 (re-engagement) failed:', e.message);
+  }
 
   // --- Stage 2: Delete inactive contacts ---
-  await stagePrune(Manager, assistant);
+  await stagePrune(Manager, assistant, libraries);
 
-  assistant.log('Marketing prune: Completed');
+  assistant.log(`Marketing prune: Completed for ${brand?.id || 'unknown'}`);
 };
 
 /**
  * Stage 1: Send re-engagement email to contacts inactive 5+ months
- * (excluding 6+ months — those get pruned in stage 2)
+ * (excluding 6+ months — those get pruned in stage 2).
+ *
+ * sendCampaign handles brand-scoping internally via _resolveAudience →
+ * createBrandScopedSegment, so this stage is already brand-safe.
  */
 async function stageReengage(Manager, assistant) {
   assistant.log('Marketing prune: Stage 1 — Re-engagement');
@@ -76,26 +86,51 @@ async function stageReengage(Manager, assistant) {
 }
 
 /**
- * Stage 2: Delete contacts inactive 6+ months.
- * Resolves segment IDs from SSOT keys at runtime.
- * Excludes paying customers.
+ * Stage 2: Delete contacts inactive 6+ months (brand-scoped).
+ *
+ * Uses createBrandScopedSegment to AND the engagement_inactive_6m query
+ * with brand_id = '<brandId>' — each brand only prunes its own contacts.
+ * Excludes paying customers (subscription_paid segment).
+ * Logs deleted emails to Firestore for recoverability.
  */
-async function stagePrune(Manager, assistant) {
+async function stagePrune(Manager, assistant, libraries) {
   assistant.log('Marketing prune: Stage 2 — Prune');
 
   const marketing = Manager.config?.marketing || {};
+  const brand = Manager.config?.brand;
+  const { admin } = libraries;
 
-  // --- SendGrid ---
-  if (marketing.campaigns?.enabled !== false && process.env.SENDGRID_API_KEY) {
-    const segmentIdMap = await sendgridProvider.resolveSegmentIds();
-    const pruneSegmentId = segmentIdMap['engagement_inactive_6m'];
+  if (!brand?.id) {
+    assistant.error('Marketing prune: brand.id is missing — aborting to prevent account-global deletion');
+    return;
+  }
 
-    if (!pruneSegmentId) {
-      assistant.error('Marketing prune: engagement_inactive_6m segment not found in SendGrid');
-      return;
-    }
+  if (marketing.campaigns?.enabled === false || !process.env.SENDGRID_API_KEY) {
+    assistant.log('Marketing prune: SendGrid not configured, skipping');
+    return;
+  }
+
+  const segmentIdMap = await sendgridProvider.resolveSegmentIds();
+  const pruneSegmentId = segmentIdMap['engagement_inactive_6m'];
 
-    const exportResult = await sendgridProvider.getSegmentContacts(pruneSegmentId, 180000);
+  if (!pruneSegmentId) {
+    assistant.error('Marketing prune: engagement_inactive_6m segment not found in SendGrid');
+    return;
+  }
+
+  // Brand-scope the prune segment
+  const tempPrune = await sendgridProvider.createBrandScopedSegment(
+    [pruneSegmentId],
+    brand.id,
+  );
+
+  if (!tempPrune) {
+    assistant.error('Marketing prune: Failed to create brand-scoped prune segment');
+    return;
+  }
+
+  try {
+    const exportResult = await sendgridProvider.getSegmentContacts(tempPrune.segmentId, 180000);
 
     if (!exportResult.success) {
       assistant.error('Marketing prune: Failed to export segment:', exportResult.error);
@@ -107,9 +142,45 @@ async function stagePrune(Manager, assistant) {
       return;
     }
 
-    assistant.log(`Marketing prune: Deleting ${exportResult.contacts.length} contacts`);
+    // Exclude paying customers
+    let contactsToPrune = exportResult.contacts;
+    let skippedPaid = 0;
+
+    const paidSegmentId = segmentIdMap['subscription_paid'];
+
+    if (paidSegmentId) {
+      const tempPaid = await sendgridProvider.createBrandScopedSegment(
+        [paidSegmentId],
+        brand.id,
+      );
+
+      if (tempPaid) {
+        try {
+          const paidExport = await sendgridProvider.getSegmentContacts(tempPaid.segmentId, 180000);
+
+          if (paidExport.success && paidExport.contacts.length > 0) {
+            const paidEmails = new Set(paidExport.contacts.map(c => c.email));
+            contactsToPrune = contactsToPrune.filter(c => !paidEmails.has(c.email));
+            skippedPaid = exportResult.contacts.length - contactsToPrune.length;
+            assistant.log(`Marketing prune: Excluded ${skippedPaid} paying customers`);
+          }
+        } finally {
+          await tempPaid.cleanup();
+        }
+      }
+    }
+
+    if (contactsToPrune.length === 0) {
+      assistant.log('Marketing prune: No contacts to prune after paid exclusion');
+      return;
+    }
+
+    const emails = contactsToPrune.map(c => c.email).filter(Boolean);
+
+    assistant.log(`Marketing prune: Deleting ${contactsToPrune.length} contacts for ${brand.id}`);
 
-    const ids = exportResult.contacts.map(c => c.id).filter(Boolean);
+    // Delete from SendGrid
+    const ids = contactsToPrune.map(c => c.id).filter(Boolean);
     let totalDeleted = 0;
 
     for (let i = 0; i < ids.length; i += 100) {
@@ -123,18 +194,39 @@ async function stagePrune(Manager, assistant) {
       }
     }
 
-    assistant.log(`Marketing prune: Deleted ${totalDeleted} SendGrid contacts`);
+    assistant.log(`Marketing prune: Deleted ${totalDeleted} SendGrid contacts for ${brand.id}`);
 
-    // Also remove from Beehiiv (same emails)
+    // Remove from Beehiiv (before Firestore log — a failed log shouldn't skip BH cleanup)
     if (marketing.newsletter?.enabled !== false && process.env.BEEHIIV_API_KEY) {
       const beehiivProvider = require('../../../libraries/email/providers/beehiiv.js');
-      const emails = exportResult.contacts.map(c => c.email).filter(Boolean);
 
-      assistant.log(`Marketing prune: Removing ${emails.length} contacts from Beehiiv`);
+      assistant.log(`Marketing prune: Removing ${emails.length} contacts from Beehiiv for ${brand.id}`);
 
       await Promise.allSettled(
         emails.map(email => beehiivProvider.removeContact(email))
       );
     }
+
+    // Log to Firestore for recoverability (non-fatal — don't abort if write fails)
+    try {
+      const now = new Date();
+      const logKey = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`;
+
+      await admin.firestore()
+        .doc(`marketing-prune-logs/${brand.id}/runs/${logKey}`)
+        .set({
+          brandId: brand.id,
+          date: now.toISOString(),
+          count: emails.length,
+          emails,
+          skippedPaid,
+        });
+
+      assistant.log(`Marketing prune: Logged ${emails.length} pruned emails to Firestore (${logKey})`);
+    } catch (e) {
+      assistant.error('Marketing prune: Failed to write Firestore log:', e.message);
+    }
+  } finally {
+    await tempPrune.cleanup();
   }
 }

package/src/manager/libraries/ai/providers/openai.js

@@ -390,8 +390,8 @@ OpenAI.prototype.request = function (options) {
     // Custom options
     options.dedupeConsecutiveRoles = typeof options.dedupeConsecutiveRoles === 'undefined' ? true : options.dedupeConsecutiveRoles;
 
-    // Format schema
-    options.schema = options.schema || undefined;
+    // Format schema — accept inline object or { path: '...' } to load from a JSON file
+    options.schema = resolveSchema(options.schema, _log);
 
     // Reasons
     options.reasoning = options.reasoning || undefined;
@@ -658,6 +658,33 @@ function normalizePrompt(input) {
   });
 }
 
+function resolveSchema(schema, _log) {
+  if (!schema) {
+    return undefined;
+  }
+
+  // Already an inline schema object (has "type" or "properties")
+  if (!schema.path) {
+    return schema;
+  }
+
+  const filePath = schema.path;
+  const exists = jetpack.exists(filePath);
+
+  _log('Reading schema from path:', filePath);
+
+  if (!exists) {
+    throw new Error(`Schema path ${filePath} not found`);
+  }
+
+  if (exists === 'dir') {
+    throw new Error(`Schema path ${filePath} is a directory`);
+  }
+
+  const raw = jetpack.read(filePath);
+  return JSON5.parse(raw);
+}
+
 function loadContent(input, _log) {
   // console.log('*** input!!!', input.content.slice(0, 50), input.path);
   // console.log('*** input.content', input.content.slice(0, 50));
@@ -1321,5 +1348,6 @@ module.exports._internals = {
   formatMessages,
   normalizeToolEntry,
   normalizeToolChoice,
+  resolveSchema,
   VALID_PROMPT_ROLES,
 };

package/src/manager/libraries/email/data/disposable-domains.json

@@ -604,6 +604,7 @@
   "aminating.com",
   "amiri.net",
   "amiriindustries.com",
+  "amiyiy.xyz",
   "amplewe.us",
   "amplifiedwe.us",
   "amplifywe.us",
@@ -955,6 +956,7 @@
   "bbmailku.com",
   "bboys.fr.nf",
   "bbroot.com",
+  "bbwg.one",
   "bcaoo.com",
   "bcast.ws",
   "bcb.ro",
@@ -1249,6 +1251,7 @@
   "candymail.de",
   "cane.pw",
   "canfga.org",
+  "cangcud.com",
   "cangcutku.pro",
   "cantozil.com",
   "canvect.com",
@@ -2369,6 +2372,8 @@
   "fanclub.pm",
   "fandoe.com",
   "fangoh.com",
+  "fangxiaobai.us.ci",
+  "fangxiaobai1.us.ci",
   "fanicle.com",
   "fansworldwide.de",
   "fantastu.com",
@@ -2487,6 +2492,7 @@
   "flaimenet.ir",
   "flameoflovedegree.com",
   "flashemail.site",
+  "flatimostore.cloud",
   "flavourity.com",
   "flayeraaron.eu.cc",
   "flayerhu.eu.cc",
@@ -3159,11 +3165,13 @@
   "herpderp.nl",
   "hertz.ltd",
   "hesoyam.shop",
+  "hethongtudong.store",
   "hetzez.com",
   "heycmm.cn",
   "hezll.com",
   "hfogzua.top",
   "hh7f.com",
+  "hhan.top",
   "hhe.org.uk",
   "hhyru.us",
   "hi2.in",
@@ -5496,6 +5504,7 @@
   "premigu.co",
   "premirum.shop",
   "premium-mail.fr",
+  "premiumonebd.store",
   "premsy.net",
   "prestige-leadership.org",
   "prestore.space",
@@ -6995,6 +7004,7 @@
   "ultralux.io.vn",
   "ultravex.cfd",
   "ultraz1.io.vn",
+  "ultrmigos.online",
   "uma3.be",
   "umail.net",
   "umil.net",
@@ -7505,6 +7515,7 @@
   "xdnss.cc",
   "xdpxdp.online",
   "xehop.org",
+  "xelio.sbs",
   "xelu.space",
   "xemaps.com",
   "xemne.com",

package/src/test/fixtures/firebase-project/.temp/test-mode.json

@@ -2,5 +2,5 @@
   "env": {
     "TEST_EXTENDED_MODE": ""
   },
-  "updatedAt": "2026-06-27T09:39:36.444Z"
+  "updatedAt": "2026-06-28T20:42:04.980Z"
 }

package/src/test/fixtures/firebase-project/database-debug.log

@@ -2,11 +2,7 @@ WARNING: A terminally deprecated method in sun.misc.Unsafe has been called
 WARNING: sun.misc.Unsafe::objectFieldOffset has been called by akka.util.Unsafe (file:/Users/ian/.cache/firebase/emulators/firebase-database-emulator-v4.11.2.jar)
 WARNING: Please consider reporting this to the maintainers of class akka.util.Unsafe
 WARNING: sun.misc.Unsafe::objectFieldOffset will be removed in a future release
-02:39:43.600 [NamespaceSystem-akka.actor.default-dispatcher-5] INFO akka.event.slf4j.Slf4jLogger - Slf4jLogger started
-02:39:43.698 [main] INFO com.firebase.server.forge.App$ - Listening at 127.0.0.1:9000
-02:39:53.731 [NamespaceSystem-akka.actor.default-dispatcher-5] INFO com.firebase.core.namespace.NamespaceActor - demo-backend-manager-default-rtdb successfully activated FBKV (SurveyIdle(0)) wait: 78ms, init: 0ms
-02:39:53.761 [NamespaceSystem-blocking-namespace-operation-dispatcher-7] INFO com.firebase.core.namespace.StateManager - Namespace demo-backend-manager-default-rtdb status Active to Active
-02:40:05.377 [Thread-0] INFO com.firebase.server.forge.App$ - Attempting graceful shutdown.
-02:40:05.385 [NamespaceSystem-akka.actor.default-dispatcher-6] INFO com.firebase.core.namespace.Terminator$Terminator - 1 actors left to terminate: demo-backend-manager-default-rtdb
-02:40:05.389 [NamespaceSystem-akka.actor.default-dispatcher-8] INFO com.firebase.core.namespace.NamespaceActor - stopped namespace actor for demo-backend-manager-default-rtdb
-02:40:05.392 [Thread-0] INFO com.firebase.server.forge.App$ - Graceful shutdown complete.
+13:42:13.900 [NamespaceSystem-akka.actor.default-dispatcher-5] INFO akka.event.slf4j.Slf4jLogger - Slf4jLogger started
+13:42:14.004 [main] INFO com.firebase.server.forge.App$ - Listening at 127.0.0.1:9000
+13:42:23.201 [Thread-0] INFO com.firebase.server.forge.App$ - Attempting graceful shutdown.
+13:42:23.204 [Thread-0] INFO com.firebase.server.forge.App$ - Graceful shutdown complete.

package/src/test/fixtures/firebase-project/firestore-debug.log

@@ -2,7 +2,7 @@ WARNING: A terminally deprecated method in sun.misc.Unsafe has been called
 WARNING: sun.misc.Unsafe::allocateMemory has been called by io.netty.util.internal.PlatformDependent0$2 (file:/Users/ian/.cache/firebase/emulators/cloud-firestore-emulator-v1.21.0.jar)
 WARNING: Please consider reporting this to the maintainers of class io.netty.util.internal.PlatformDependent0$2
 WARNING: sun.misc.Unsafe::allocateMemory will be removed in a future release
-Jun 27, 2026 2:39:42 AM com.google.cloud.datastore.emulator.firestore.websocket.WebSocketServer start
+Jun 28, 2026 1:42:12 PM com.google.cloud.datastore.emulator.firestore.websocket.WebSocketServer start
 INFO: Started WebSocket server on ws://127.0.0.1:9150
 
 API endpoint: http://127.0.0.1:8080
@@ -20,117 +20,5 @@ If you are running a Firestore in Datastore Mode project, run:
 Note: Support for Datastore Mode is in preview. If you encounter any bugs please file at https://github.com/firebase/firebase-tools/issues.
 Dev App Server is now running.
 
-Jun 27, 2026 2:39:53 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected non-HTTP/2 connection.
-Jun 27, 2026 2:39:53 AM io.grpc.netty.TcpMetrics loadEpollInfo
-INFO: Epoll available during static init of TcpMetrics:false
-Jun 27, 2026 2:39:53 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:39:55 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:39:55 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:03 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:03 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:03 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:03 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:03 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:03 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:03 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:04 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
-Jun 27, 2026 2:40:05 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
 *** shutting down gRPC server since JVM is shutting down
 *** server shut down

package/src/test/fixtures/firebase-project/pubsub-debug.log

@@ -1,6 +1,6 @@
 This is the Google Pub/Sub fake.
 Implementation may be incomplete or differ from the real system.
-Jun 27, 2026 2:39:46 AM com.google.cloud.pubsub.testing.v1.Main main
+Jun 28, 2026 1:42:17 PM com.google.cloud.pubsub.testing.v1.Main main
 INFO: IAM integration is disabled. IAM policy methods and ACL checks are not supported
 SLF4J(W): No SLF4J providers were found.
 SLF4J(W): Defaulting to no-operation (NOP) logger implementation
@@ -9,9 +9,7 @@ WARNING: A terminally deprecated method in sun.misc.Unsafe has been called
 WARNING: sun.misc.Unsafe::allocateMemory has been called by io.netty.util.internal.PlatformDependent0$2 (file:/Users/ian/.cache/firebase/emulators/pubsub-emulator-0.8.33/pubsub-emulator/lib/cloud-pubsub-emulator-0.8.33-all.jar)
 WARNING: Please consider reporting this to the maintainers of class io.netty.util.internal.PlatformDependent0$2
 WARNING: sun.misc.Unsafe::allocateMemory will be removed in a future release
-Jun 27, 2026 2:39:47 AM com.google.cloud.pubsub.testing.v1.Main main
+Jun 28, 2026 1:42:17 PM com.google.cloud.pubsub.testing.v1.Main main
 INFO: Server started, listening on 8085
-Jun 27, 2026 2:39:53 AM io.gapi.emulators.netty.HttpVersionRoutingHandler channelRead
-INFO: Detected HTTP/2 connection.
 *** shutting down gRPC server since JVM is shutting down
 *** server shut down

package/test/helpers/ai-schema-resolve.js

@@ -0,0 +1,119 @@
+/**
+ * Test: AI schema resolution (libraries/ai/providers/openai.js)
+ *
+ * Verifies resolveSchema() — loading JSON Schema from inline objects or file paths.
+ */
+const path = require('path');
+const jetpack = require('fs-jetpack');
+const OpenAI = require('../../src/manager/libraries/ai/providers/openai.js');
+const { resolveSchema } = OpenAI._internals;
+
+function noopLog() {}
+
+const FIXTURES_DIR = path.join(__dirname, '..', 'fixtures', 'ai-schema');
+const VALID_SCHEMA_PATH = path.join(FIXTURES_DIR, 'valid.json');
+const VALID_SCHEMA = {
+  type: 'object',
+  properties: {
+    name: { type: 'string', description: 'The name' },
+    tags: { type: 'array', items: { type: 'string' } },
+  },
+  required: ['name', 'tags'],
+  additionalProperties: false,
+};
+
+module.exports = {
+  description: 'AI schema resolution (inline vs file path)',
+  type: 'group',
+
+  before() {
+    jetpack.dir(FIXTURES_DIR);
+    jetpack.write(VALID_SCHEMA_PATH, VALID_SCHEMA);
+    jetpack.write(path.join(FIXTURES_DIR, 'invalid.json'), '{ not valid json !!!');
+  },
+
+  after() {
+    jetpack.remove(FIXTURES_DIR);
+  },
+
+  tests: [
+    {
+      name: 'undefined-returns-undefined',
+      async run({ assert }) {
+        assert.equal(resolveSchema(undefined, noopLog), undefined, 'undefined → undefined');
+      },
+    },
+
+    {
+      name: 'null-returns-undefined',
+      async run({ assert }) {
+        assert.equal(resolveSchema(null, noopLog), undefined, 'null → undefined');
+      },
+    },
+
+    {
+      name: 'false-returns-undefined',
+      async run({ assert }) {
+        assert.equal(resolveSchema(false, noopLog), undefined, 'false → undefined');
+      },
+    },
+
+    {
+      name: 'inline-object-returned-as-is',
+      async run({ assert }) {
+        const inline = { type: 'object', properties: { x: { type: 'string' } } };
+        const result = resolveSchema(inline, noopLog);
+        assert.deepEqual(result, inline, 'inline schema passed through unchanged');
+      },
+    },
+
+    {
+      name: 'path-loads-json-file',
+      async run({ assert }) {
+        const result = resolveSchema({ path: VALID_SCHEMA_PATH }, noopLog);
+        assert.deepEqual(result, VALID_SCHEMA, 'loaded schema matches fixture');
+      },
+    },
+
+    {
+      name: 'path-not-found-throws',
+      async run({ assert }) {
+        let threw = false;
+        try {
+          resolveSchema({ path: '/nonexistent/schema.json' }, noopLog);
+        } catch (e) {
+          threw = true;
+          assert.equal(e.message.includes('not found'), true, 'error mentions not found');
+        }
+        assert.equal(threw, true, 'should throw on missing file');
+      },
+    },
+
+    {
+      name: 'path-to-directory-throws',
+      async run({ assert }) {
+        let threw = false;
+        try {
+          resolveSchema({ path: FIXTURES_DIR }, noopLog);
+        } catch (e) {
+          threw = true;
+          assert.equal(e.message.includes('is a directory'), true, 'error mentions directory');
+        }
+        assert.equal(threw, true, 'should throw on directory path');
+      },
+    },
+
+    {
+      name: 'invalid-json-throws',
+      async run({ assert }) {
+        let threw = false;
+        try {
+          resolveSchema({ path: path.join(FIXTURES_DIR, 'invalid.json') }, noopLog);
+        } catch (e) {
+          threw = true;
+        }
+        assert.equal(threw, true, 'should throw on invalid JSON');
+      },
+    },
+  ],
+};