@madewithremy/admin 0.1.0 → 0.1.2

package/dist/prod.js

@@ -36,11 +36,11 @@ function fatal(message) {
   throw new CliError(message);
 }
 var AdminApiError = class extends Error {
-  constructor(method, path5, status, body) {
-    super(`API ${method} ${path5} returned ${status}: ${JSON.stringify(body)}`);
+  constructor(method, path5, status2, body) {
+    super(`API ${method} ${path5} returned ${status2}: ${JSON.stringify(body)}`);
     this.method = method;
     this.path = path5;
-    this.status = status;
+    this.status = status2;
     this.body = body;
     this.name = "AdminApiError";
   }
@@ -2988,6 +2988,7 @@ var CONFIG_FLAGS = {
   "min-chars": { type: "number", min: 0 },
   "drop-blocks": { type: "string" },
   contextual: { type: "string" },
+  "contextual-model": { type: "string" },
   "describe-images": { type: "string" },
   "embedding-model": { type: "string" },
   "image-model": { type: "string" },
@@ -3253,7 +3254,10 @@ function configFromFlags(a) {
   if (dropBlocks !== void 0) {
     chunking.dropBlockTypes = dropBlocks.split(",").map((s) => s.trim()).filter(Boolean);
   }
-  const contextual = triState(a, "contextual", "enabled");
+  const contextual = {
+    ...triState(a, "contextual", "enabled"),
+    ...a.str("contextual-model") ? { modelId: a.str("contextual-model") } : {}
+  };
   const images = {
     ...triState(a, "describe-images", "describe"),
     ...a.str("image-model") ? { modelId: a.str("image-model") } : {}
@@ -3426,7 +3430,10 @@ Search options:
                            coerce: true/false and numbers become typed.
                            Pass a JSON object for the full grammar:
                            metadata, filename, documentIds, pages, contains,
-                           phrase \u2014 e.g. --filter '{"pages":{"max":3}}'
+                           phrase \u2014 e.g. --filter '{"pages":{"max":3}}'.
+                           Metadata takes numeric ranges via {gte,lte}: store
+                           dates as integers (YYYYMMDD or epoch seconds), then
+                           --filter '{"metadata":{"date":{"gte":20250101}}}'
   --phrase <text>          Chunk must contain this exact word sequence
   --contains <words>       Chunk must contain ALL these words, any order
   --max-per-document <n>   Cap hits per document; backfills from others
@@ -3456,6 +3463,8 @@ Tuning a corpus:
     --contextual <true|false>  LLM context blurb per chunk. Improves retrieval
                              on long documents; costs a model call per chunk
                              at ingest. Off by default \u2014 measure on your data.
+    --contextual-model <id>  Which chat model writes the blurbs. Optional:
+                             enabling without it uses the platform default.
     --describe-images <true|false>  Vision pass over images inside documents,
                              substituting a description into the searchable
                              text. ON by default: a document with no images
@@ -4606,6 +4615,13 @@ function stats2(ctx, params = {}) {
     `/_internal/v2/apps/${ctx.appId}/outbound-email/summary${qs(params)}`
   );
 }
+function status(ctx) {
+  return call(
+    ctx,
+    "GET",
+    `/_internal/v2/apps/${ctx.appId}/outbound-email/status`
+  );
+}
 function batches(ctx, params = {}) {
   return call(
     ctx,
@@ -4702,6 +4718,9 @@ var emailSpecs = {
     usage: "Usage: remy-admin email stats [--start <ISO date>] [--end <ISO date>]",
     flags: { ...WINDOW }
   },
+  "email status": {
+    usage: "Usage: remy-admin email status"
+  },
   "email batches": {
     usage: "Usage: remy-admin email batches [--start <ISO date>] [--end <ISO date>] [--limit 50]",
     flags: { ...WINDOW, ...PAGINATION }
@@ -4793,6 +4812,9 @@ async function emailGet(ctx, a) {
 async function emailStats(ctx, a) {
   out(await stats2(ctx, { start: a.str("start"), end: a.str("end") }));
 }
+async function emailStatus(ctx) {
+  out(await status(ctx));
+}
 async function emailBatches(ctx, a) {
   out(
     await batches(ctx, {
@@ -4829,7 +4851,12 @@ async function emailUnsuppress(ctx, a) {
     const { reason, at } = result.platformSuppression;
     console.error(
       `
-Note: removed from this app's list, but ${a.req("email")} is still on the platform suppression list (${reason}${at ? ` since ${at}` : ""}). Mail to it will still be blocked \u2014 that list is account-wide and is not cleared.`
+Note: removed from this app's list, but ${a.req("email")} is still on the ACCOUNT-wide suppression list (${reason}${at ? ` since ${at}` : ""}). Mail to it will still be blocked \u2014 that list is shared by every app and is not cleared.`
+    );
+  } else if (result?.tenantEntryRemoved) {
+    console.error(
+      `
+Note: also cleared this app's provider-side bounce/complaint record for ${a.req("email")}. Mail will be attempted again \u2014 another hard bounce re-suppresses it automatically.`
     );
   }
 }
@@ -4868,6 +4895,7 @@ var emailHandlers = {
   "email list": emailList,
   "email get": emailGet,
   "email stats": emailStats,
+  "email status": emailStatus,
   "email batches": emailBatches,
   "email batch": emailBatch,
   "email suppressions": emailSuppressions,
@@ -4891,7 +4919,8 @@ Subcommands:
   list           List sent messages (includes mail that never reached the provider)
   get            Full detail for one message, including bounce diagnostics
   stats          Counts and rates over a window
-  batches        One row per blast, with per-status counts
+  status         Can this app send right now? Pause/throttle state + daily quota
+  batches        One row per blast, with per-status counts and delivery progress
   batch          Stats for a single blast
   suppressions   This app's unsubscribe list
   suppress       Add an address to the unsubscribe list
@@ -4903,15 +4932,26 @@ Subcommands:
 
 Notes:
   Statuses: suppressed, failed, sent, delivered, blocked, bounced, complained,
-  delayed, rejected. "blocked" means the platform-wide suppression list dropped
-  it \u2014 usually another tenant's hard bounce \u2014 not that this address is bad.
+  delayed, rejected. "blocked" means an SES suppression list dropped it before
+  delivery \u2014 usually this app's OWN list, after an earlier hard bounce or spam
+  report from that address ('unsuppress' clears it and says which list it was).
+
+  'status' is the first check when sends are failing or a send returns
+  409 sending_paused. sending.source 'ses' = Amazon paused the tenant (clears
+  when the finding clears; nothing lifts it directly); 'platform' = our
+  bounce/complaint enforcement \u2014 enforcement.origin 'platform' steps down on
+  its own as rates recover, 'operator' is a human hold and will not. A reduced
+  quota.limit with an expiresAt is an automatic throttle.
 
   --recipient is an exact match and is index-backed; use --search for partials
   (bounded, and not paginated).
 
   A marketing send delivers one message per recipient, so a campaign is many
   rows sharing a batch id. Pass batchId to sendEmail to group them under your own
-  campaign id.
+  campaign id. Large and marketing sends are QUEUED: accepted immediately,
+  delivered in chunks \u2014 a batch's status (accepted|sending|completed|partial|
+  failed), chunksDone/chunksTotal and pending report the progress. status null
+  is a normal send that delivered inline, not an error.
 
   An inbox row's id is its request-log id: open the full detail (parsed message,
   method run, errors) with 'requests get <id>'.
@@ -4934,6 +4974,8 @@ Custom domains \u2014 two independent directions:
   the records and 'verify' again).
 
 Examples:
+  remy-admin email status
+  remy-admin email list --status bounced,blocked --limit 50
   remy-admin email domains add mail.acme.com
   remy-admin email domains verify mail.acme.com
   remy-admin email inbound-domains check acme.com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madewithremy/admin",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Admin SDK + CLI for managing production Remy apps",
   "type": "module",
   "main": "./dist/index.js",