@mailmodo/cli 0.0.49 → 0.0.50-beta.pr52.80

package/dist/commands/deploy/index.d.ts

@@ -3,12 +3,30 @@ export default class Deploy extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        pause: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        resume: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     private fetchDomainVerifyForDeploy;
     run(): Promise<void>;
     private validateSequence;
+    /**
+     * Calls `POST /sequences/{id}/status` with `{ status: "paused" }` and prints
+     * a confirmation-aware success/no-op message. Skips the prompt entirely when
+     * `--yes` is set so the command stays scriptable. `--json` always emits the
+     * raw server payload (sequenceId, status, alreadyInStatus).
+     */
+    private pauseSequence;
+    /**
+     * Calls `POST /sequences/{id}/status` with `{ status: "active" }`. No prompt
+     * — resuming is the safe direction (it does not start sends that weren't
+     * already queued). `--json` always emits the raw server payload (sequenceId,
+     * status, alreadyInStatus).
+     */
+    private resumeSequence;
+    private updateSequenceStatus;
+    private sequenceStatusPath;
     private buildDeployPayload;
     private resolveMonthlyCapForDeploy;
     private mapEmailToPayload;

package/dist/commands/deploy/index.js

@@ -1,17 +1,28 @@
+import { Flags } from '@oclif/core';
 import { confirm, input } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
 import { API_ENDPOINTS, DEFAULT_BRAND_COLOR } from '../../lib/constants.js';
-import { ERRORS, INFO, PROMPTS, SEPARATOR } from '../../lib/messages.js';
+import { ERRORS, INFO, pauseAlready, pauseSuccess, PROMPTS, resumeAlready, resumeSuccess, SEPARATOR, } from '../../lib/messages.js';
 import { loadTemplate, } from '../../lib/yaml-config.js';
 export default class Deploy extends BaseCommand {
-    static description = 'Deploy email sequences and verify sending domain';
+    static description = 'Deploy, pause, or resume an email sequence';
     static examples = [
         '<%= config.bin %> deploy',
         '<%= config.bin %> deploy --yes',
+        '<%= config.bin %> deploy --pause seq_abc123',
+        '<%= config.bin %> deploy --resume seq_abc123 --json',
     ];
     static flags = {
         ...BaseCommand.baseFlags,
+        pause: Flags.string({
+            description: 'Pause a deployed sequence by ID (stops scheduled + triggered sends)',
+            exclusive: ['resume'],
+        }),
+        resume: Flags.string({
+            description: 'Resume a paused sequence by ID',
+            exclusive: ['pause'],
+        }),
     };
     fetchDomainVerifyForDeploy(jsonOutput, domain) {
         return this.withApiSpinner({ json: jsonOutput, text: '  Checking domain verification...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY, {
@@ -21,6 +32,15 @@ export default class Deploy extends BaseCommand {
     async run() {
         const { flags } = await this.parse(Deploy);
         await this.ensureAuth();
+        const baseFlags = { json: flags.json, yes: flags.yes };
+        if (flags.pause) {
+            await this.pauseSequence(flags.pause, baseFlags);
+            return;
+        }
+        if (flags.resume) {
+            await this.resumeSequence(flags.resume, baseFlags);
+            return;
+        }
         const yamlConfig = await this.ensureYaml();
         const domainReady = await this.ensureDomainReady(yamlConfig, flags);
         if (!domainReady)
@@ -60,6 +80,60 @@ export default class Deploy extends BaseCommand {
         }
         return response.data;
     }
+    /**
+     * Calls `POST /sequences/{id}/status` with `{ status: "paused" }` and prints
+     * a confirmation-aware success/no-op message. Skips the prompt entirely when
+     * `--yes` is set so the command stays scriptable. `--json` always emits the
+     * raw server payload (sequenceId, status, alreadyInStatus).
+     */
+    async pauseSequence(sequenceId, flags) {
+        if (!flags.yes) {
+            const confirmed = await confirm({
+                default: false,
+                message: PROMPTS.PAUSE_CONFIRM,
+            });
+            if (!confirmed) {
+                this.log(`\n  ${INFO.PAUSE_CANCELLED}\n`);
+                return;
+            }
+        }
+        const data = await this.updateSequenceStatus(sequenceId, 'paused', flags, '  Pausing sequence...');
+        if (flags.json) {
+            this.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        const message = data.alreadyInStatus
+            ? pauseAlready(data.sequenceId || sequenceId)
+            : pauseSuccess(data.sequenceId || sequenceId);
+        this.log(`\n  ${message}\n`);
+    }
+    /**
+     * Calls `POST /sequences/{id}/status` with `{ status: "active" }`. No prompt
+     * — resuming is the safe direction (it does not start sends that weren't
+     * already queued). `--json` always emits the raw server payload (sequenceId,
+     * status, alreadyInStatus).
+     */
+    async resumeSequence(sequenceId, flags) {
+        const data = await this.updateSequenceStatus(sequenceId, 'active', flags, '  Resuming sequence...');
+        if (flags.json) {
+            this.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        const message = data.alreadyInStatus
+            ? resumeAlready(data.sequenceId || sequenceId)
+            : resumeSuccess(data.sequenceId || sequenceId);
+        this.log(`\n  ${message}\n`);
+    }
+    async updateSequenceStatus(sequenceId, status, flags, spinnerText) {
+        const response = await this.withApiSpinner({ json: flags.json, text: spinnerText }, () => this.apiClient.post(this.sequenceStatusPath(sequenceId), { status }));
+        if (!response.ok) {
+            this.handleApiError(response);
+        }
+        return response.data;
+    }
+    sequenceStatusPath(sequenceId) {
+        return `${API_ENDPOINTS.SEQUENCES}/${encodeURIComponent(sequenceId)}/status`;
+    }
     async buildDeployPayload(yamlConfig) {
         const [emailsWithHtml, monthlyCap] = await Promise.all([
             Promise.all(yamlConfig.emails.map(async (email) => {

package/dist/commands/deployments/index.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class Deployments extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private renderTable;
+    private statusColor;
+    private colWidth;
+    private formatDate;
+}

package/dist/commands/deployments/index.js

@@ -0,0 +1,76 @@
+import chalk from 'chalk';
+import { BaseCommand } from '../../lib/base-command.js';
+import { API_ENDPOINTS } from '../../lib/constants.js';
+export default class Deployments extends BaseCommand {
+    static description = 'List every deployed sequence on this account, with the IDs needed for deploy --pause / --resume';
+    static examples = [
+        '<%= config.bin %> deployments',
+        '<%= config.bin %> deployments --json',
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(Deployments);
+        await this.ensureAuth();
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Loading deployments...' }, () => this.apiClient.get(API_ENDPOINTS.SEQUENCES));
+        if (!response.ok) {
+            this.handleApiError(response);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(response.data, null, 2));
+            return;
+        }
+        this.renderTable(response.data);
+    }
+    renderTable(data) {
+        const sequences = data.sequences ?? [];
+        if (sequences.length === 0) {
+            this.log(`\n  ${chalk.dim('No deployed sequences yet.')}`);
+            this.log(`  Run ${chalk.cyan('mailmodo deploy')} to deploy one.\n`);
+            return;
+        }
+        const rows = sequences.map((seq) => ({
+            emails: String(seq.emailCount ?? 0),
+            product: seq.productName ?? '',
+            sequenceId: seq.sequenceId ?? '',
+            status: seq.status ?? '',
+            updated: this.formatDate(seq.updatedAt),
+        }));
+        const widths = {
+            emails: this.colWidth(rows, 'emails', 'Emails'),
+            product: this.colWidth(rows, 'product', 'Product'),
+            sequenceId: this.colWidth(rows, 'sequenceId', 'Sequence ID'),
+            status: this.colWidth(rows, 'status', 'Status'),
+            updated: this.colWidth(rows, 'updated', 'Updated'),
+        };
+        this.log(`\n  ${chalk.bold(String(sequences.length))} deployed ${sequences.length === 1 ? 'sequence' : 'sequences'}:\n`);
+        this.log(`  ${chalk.bold('Product'.padEnd(widths.product))}${chalk.bold('Status'.padEnd(widths.status))}${chalk.bold('Emails'.padEnd(widths.emails))}${chalk.bold('Sequence ID'.padEnd(widths.sequenceId))}${chalk.bold('Updated')}`);
+        this.log(`  ${'─'.repeat(widths.product + widths.status + widths.emails + widths.sequenceId + widths.updated)}`);
+        for (const row of rows) {
+            const status = this.statusColor(row.status)(row.status.padEnd(widths.status));
+            this.log(`  ${row.product.padEnd(widths.product)}${status}${row.emails.padEnd(widths.emails)}${chalk.cyan(row.sequenceId.padEnd(widths.sequenceId))}${chalk.dim(row.updated)}`);
+        }
+        this.log('');
+        this.log(`  Pause:  ${chalk.cyan('mailmodo deploy --pause <sequence-id>')}`);
+        this.log(`  Resume: ${chalk.cyan('mailmodo deploy --resume <sequence-id>')}\n`);
+    }
+    statusColor(status) {
+        if (status === 'active')
+            return chalk.green;
+        if (status === 'paused')
+            return chalk.yellow;
+        return chalk.white;
+    }
+    colWidth(rows, key, header) {
+        return Math.max(...rows.map((r) => r[key].length), header.length) + 2;
+    }
+    formatDate(iso) {
+        if (!iso)
+            return '';
+        const parsed = new Date(iso);
+        if (Number.isNaN(parsed.getTime()))
+            return iso;
+        return parsed.toISOString().slice(0, 10);
+    }
+}

package/dist/commands/edit/index.js

@@ -49,6 +49,7 @@ export default class Edit extends BaseCommand {
     async runEditStep(ctx, changeDescription, flags) {
         const response = await this.withApiSpinner({ json: flags.json, text: '  Applying AI edits...' }, () => this.callEditApi(changeDescription, ctx.email, ctx.templateHtml));
         if (!response.ok) {
+            this.handleAiQuotaError(response, 'edit');
             this.handleApiError(response);
         }
         const updated = response.data;

package/dist/commands/init/index.d.ts

@@ -8,5 +8,6 @@ export default class Init extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
+    private persistMonthlyCap;
     private confirmOverwriteIfNeeded;
 }

package/dist/commands/init/index.js

@@ -64,6 +64,7 @@ export default class Init extends BaseCommand {
             url: productUrl,
         }));
         if (!analysisResponse.ok) {
+            this.handleAiQuotaError(analysisResponse, 'init');
             this.handleApiError(analysisResponse);
         }
         const analysis = analysisResponse.data;
@@ -154,12 +155,7 @@ export default class Init extends BaseCommand {
             },
         };
         await saveYaml(yamlConfig);
-        const billingStatus = await this.fetchBillingStatus();
-        const monthlyCap = billingStatus?.cap?.inBlocks;
-        if (monthlyCap !== null && monthlyCap !== undefined) {
-            yamlConfig.project.monthlyCap = monthlyCap;
-            await saveYaml(yamlConfig);
-        }
+        await this.persistMonthlyCap(yamlConfig);
         const templateSaves = analysisPayload.recommendedEmails.flatMap((rec, index) => {
             const generated = generatedEmails[index];
             const saves = [];
@@ -184,6 +180,14 @@ export default class Init extends BaseCommand {
         this.log(`  Created ${chalk.green('mailmodo.yaml')} + ${chalk.green(String(emailConfigs.length))} email templates in ${chalk.green('/mailmodo')}\n`);
         this.log(`  Run ${chalk.cyan("'mailmodo emails'")} to review.\n`);
     }
+    async persistMonthlyCap(yamlConfig) {
+        const billingStatus = await this.fetchBillingStatus();
+        const monthlyCap = billingStatus?.cap?.inBlocks;
+        if (monthlyCap !== null && monthlyCap !== undefined) {
+            yamlConfig.project.monthlyCap = monthlyCap;
+            await saveYaml(yamlConfig);
+        }
+    }
     async confirmOverwriteIfNeeded(flags) {
         const existing = await loadYaml();
         if (!existing)

package/dist/lib/base-command.d.ts

@@ -2,6 +2,11 @@ import { Command } from '@oclif/core';
 import { ApiClient, type ApiRequestDebugInfo } from './api-client.js';
 import { type MailmodoConfig } from './config.js';
 import { type MailmodoYaml } from './yaml-config.js';
+/**
+ * Kind of AI quota that was exhausted. Drives both the headline default
+ * message and the follow-up tip pointing the user at the next-best action.
+ */
+export type AiQuotaFeature = 'edit' | 'init';
 export interface BillingCapUpdateResult {
     autoChargeBlockCount?: number;
     capBlocks: number;
@@ -76,6 +81,25 @@ export declare abstract class BaseCommand extends Command {
         error?: string;
         status: number;
     }): never;
+    /**
+     * Intercepts a 429 "Monthly quota exhausted" response from an AI rate-limited
+     * endpoint (analyze for `init`, email edit for `edit`) and exits with a
+     * feature-specific message that includes the server's error text, the reset
+     * date, optional retry hint, and the next-best action. Returns without
+     * exiting when the response is not a 429 so callers can fall through to
+     * `handleApiError` for non-quota failures.
+     *
+     * @param {{ status: number; error?: string; data?: unknown; debug?: ApiRequestDebugInfo }} response - The failed API response.
+     *   Must carry the parsed JSON body (`data`) so reset/retry fields can be surfaced.
+     * @param {AiQuotaFeature} feature - Which AI quota was hit. Drives the default headline + tip
+     *   shown when the server omits an explicit `error` string.
+     */
+    protected handleAiQuotaError(response: {
+        data?: unknown;
+        debug?: ApiRequestDebugInfo;
+        error?: string;
+        status: number;
+    }, feature: AiQuotaFeature): void;
     protected collectDomainSetupInputs(yamlConfig: MailmodoYaml, skipPrompts: boolean): Promise<{
         address: string;
         domain: string;
@@ -144,12 +168,15 @@ export declare abstract class BaseCommand extends Command {
         value: string;
     }>, guideUrl: string | undefined, json: boolean): void;
     /**
-     * Builds the terminal error string for a failed API call, appending request
-     * metadata when {@link ApiRequestDebugInfo} is available.
+     * Builds the terminal error string for a failed API call. In production only
+     * the user-facing message is returned; verbose request diagnostics (URL,
+     * status, response body, error code) are appended only when [[IS_DEV_MODE]]
+     * is true so end users never see internal request metadata.
      *
      * @param {string} message - Primary error text (HTTP message or generic).
      * @param {{ status: number; debug?: ApiRequestDebugInfo }} response - Failed API response.
-     * @returns {string} Message plus indented Request details for troubleshooting.
+     * @returns {string} Message alone in production, or message plus indented
+     *   Request details when running in dev/debug mode.
      */
     private formatApiFailure;
 }

package/dist/lib/base-command.js

@@ -4,8 +4,8 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { ApiClient } from './api-client.js';
 import { loadConfig } from './config.js';
-import { API_ENDPOINTS } from './constants.js';
-import { ERRORS, INFO, PROMPTS, recordLabel, VALIDATION } from './messages.js';
+import { API_ENDPOINTS, IS_DEV_MODE } from './constants.js';
+import { ERRORS, INFO, PROMPTS, quotaExhaustedMessage, recordLabel, VALIDATION, } from './messages.js';
 import { loadYaml, saveYaml } from './yaml-config.js';
 export const FREE_TIER = 'free';
 /**
@@ -107,6 +107,35 @@ export class BaseCommand extends Command {
         }
         this.error(this.formatApiFailure(response.error || ERRORS.UNEXPECTED_API, response));
     }
+    /**
+     * Intercepts a 429 "Monthly quota exhausted" response from an AI rate-limited
+     * endpoint (analyze for `init`, email edit for `edit`) and exits with a
+     * feature-specific message that includes the server's error text, the reset
+     * date, optional retry hint, and the next-best action. Returns without
+     * exiting when the response is not a 429 so callers can fall through to
+     * `handleApiError` for non-quota failures.
+     *
+     * @param {{ status: number; error?: string; data?: unknown; debug?: ApiRequestDebugInfo }} response - The failed API response.
+     *   Must carry the parsed JSON body (`data`) so reset/retry fields can be surfaced.
+     * @param {AiQuotaFeature} feature - Which AI quota was hit. Drives the default headline + tip
+     *   shown when the server omits an explicit `error` string.
+     */
+    handleAiQuotaError(response, feature) {
+        if (response.status !== 429)
+            return;
+        const body = (response.data ?? {});
+        const isInit = feature === 'init';
+        const message = quotaExhaustedMessage({
+            defaultMessage: isInit
+                ? ERRORS.QUOTA_INIT_DEFAULT
+                : ERRORS.QUOTA_EDIT_DEFAULT,
+            limitReset: body.limitReset,
+            retryAfter: body.retryAfter,
+            serverError: typeof body.error === 'string' ? body.error : undefined,
+            tip: isInit ? ERRORS.QUOTA_INIT_TIP : ERRORS.QUOTA_EDIT_TIP,
+        });
+        this.error(this.formatApiFailure(message, response));
+    }
     async collectDomainSetupInputs(yamlConfig, skipPrompts) {
         if (skipPrompts) {
             const domain = yamlConfig.project?.domain || '';
@@ -267,16 +296,19 @@ export class BaseCommand extends Command {
             this.log(`  Full guide: ${chalk.cyan(guideUrl)}\n`);
     }
     /**
-     * Builds the terminal error string for a failed API call, appending request
-     * metadata when {@link ApiRequestDebugInfo} is available.
+     * Builds the terminal error string for a failed API call. In production only
+     * the user-facing message is returned; verbose request diagnostics (URL,
+     * status, response body, error code) are appended only when [[IS_DEV_MODE]]
+     * is true so end users never see internal request metadata.
      *
      * @param {string} message - Primary error text (HTTP message or generic).
      * @param {{ status: number; debug?: ApiRequestDebugInfo }} response - Failed API response.
-     * @returns {string} Message plus indented Request details for troubleshooting.
+     * @returns {string} Message alone in production, or message plus indented
+     *   Request details when running in dev/debug mode.
      */
     formatApiFailure(message, response) {
         const { debug, status } = response;
-        if (!debug) {
+        if (!IS_DEV_MODE || !debug) {
             return message;
         }
         return [

package/dist/lib/constants.d.ts

@@ -1,3 +1,9 @@
+/**
+ * True when the CLI is running in a dev/debug context. Verbose request
+ * diagnostics (URL, status, response body, error code) are only surfaced
+ * when this is true so end users never see internal request metadata.
+ */
+export declare const IS_DEV_MODE: boolean;
 export declare const API_BASE_URL = "https://app-vertex-debug.azurewebsites.net";
 export declare const API_ENDPOINTS: Readonly<{
     ANALYTICS: "/analytics";

package/dist/lib/constants.js

@@ -1,5 +1,11 @@
 /** Set by `bin/dev.js` when running the CLI locally (tsx bootstrap). */
 const DEV_API_BASE_URL = 'https://app-vertex-debug.azurewebsites.net';
+/**
+ * True when the CLI is running in a dev/debug context. Verbose request
+ * diagnostics (URL, status, response body, error code) are only surfaced
+ * when this is true so end users never see internal request metadata.
+ */
+export const IS_DEV_MODE = Boolean(process.env.MAILMODO_DEV_TSX || process.env.MAILMODO_DEBUG);
 // const PRODUCTION_API_BASE_URL = 'https://api.mailmodo.com';
 const PRODUCTION_API_BASE_URL = 'https://app-vertex-debug.azurewebsites.net';
 export const API_BASE_URL = process.env.MAILMODO_DEV_TSX

package/dist/lib/messages.d.ts

@@ -9,6 +9,7 @@ export declare const PROMPTS: {
     readonly DOMAIN: "What domain will you send from?";
     readonly ENTER_AFTER_RECORDS: "Press Enter once you've added the records, or 'skip'.";
     readonly FROM_NAME: "Display name (optional, shown as sender name):";
+    readonly PAUSE_CONFIRM: "Pause this sequence? All scheduled and triggered sends will stop until you resume.";
     readonly REPLY_TO: "Reply-to address (optional, press Enter to use sender email):";
     readonly SENDER_EMAIL: "Sender email address:";
 };
@@ -19,6 +20,10 @@ export declare const ERRORS: {
     readonly INVALID_API_KEY: `Invalid API key. Run ${string} to re-authenticate.`;
     readonly NOT_LOGGED_IN: `Not logged in. Run ${string} to authenticate.`;
     readonly NO_YAML: `No mailmodo.yaml found. Run ${string} first.`;
+    readonly QUOTA_EDIT_DEFAULT: "Edit limit reached for this month.";
+    readonly QUOTA_EDIT_TIP: "AI edits are limited to 50 per account per month. Manually edit the template file under ./mailmodo to make further changes.";
+    readonly QUOTA_INIT_DEFAULT: "Regeneration limit reached.";
+    readonly QUOTA_INIT_TIP: `Regenerations are limited to 5 per account per month. Run ${string} to modify individual emails instead.`;
     readonly RATE_LIMIT: "Rate limit exceeded. Please try again later.";
     readonly UNEXPECTED_API: "An unexpected API error occurred.";
 };
@@ -33,7 +38,35 @@ export declare const INFO: {
   Then: ${string}`;
     readonly DOMAIN_PENDING_VERIFICATION: `Your domain is not verified yet. Please verify it first. Run ${string} to check the status.`;
     readonly FREE_TIER_CAP_BLOCKED: `Monthly cap is a paid-tier setting and is not available on the free tier. Run ${string} to add a payment method, then set a cap.`;
+    readonly PAUSE_CANCELLED: "Pause cancelled. Sequence is still live.";
     readonly SEQUENCES_NOT_DEPLOYED: `Sequences saved but ${string}.`;
 };
+export declare function pauseSuccess(sequenceId: string): string;
+export declare function pauseAlready(sequenceId: string): string;
+export declare function resumeSuccess(sequenceId: string): string;
+export declare function resumeAlready(sequenceId: string): string;
 export declare function yamlParseError(detail: string): string;
 export declare function recordLabel(index: number): string;
+/**
+ * Parses an ISO-8601 timestamp into a `YYYY-MM-DD` date string.
+ * Returns the raw input if parsing fails so the original value is preserved.
+ */
+export declare function formatQuotaResetDate(value?: string): string | undefined;
+/**
+ * Formats a `retry-after` value (seconds) into a short, human-readable hint
+ * suitable for appending to a 429 error message.
+ */
+export declare function formatRetryAfter(seconds?: number): string | undefined;
+/**
+ * Builds the multi-line message printed when an AI quota (init regeneration or
+ * edit) is exhausted. `serverError` is the message returned by the API; the
+ * default text is used when the server omits it. The tip lists the next action
+ * the user can take (e.g. switch from init to edit).
+ */
+export declare function quotaExhaustedMessage(input: {
+    defaultMessage: string;
+    limitReset?: string;
+    retryAfter?: number;
+    serverError?: string;
+    tip: string;
+}): string;

package/dist/lib/messages.js

@@ -10,6 +10,7 @@ export const PROMPTS = {
     DOMAIN: 'What domain will you send from?',
     ENTER_AFTER_RECORDS: "Press Enter once you've added the records, or 'skip'.",
     FROM_NAME: 'Display name (optional, shown as sender name):',
+    PAUSE_CONFIRM: 'Pause this sequence? All scheduled and triggered sends will stop until you resume.',
     REPLY_TO: 'Reply-to address (optional, press Enter to use sender email):',
     SENDER_EMAIL: 'Sender email address:',
 };
@@ -20,6 +21,10 @@ export const ERRORS = {
     INVALID_API_KEY: `Invalid API key. Run ${chalk.cyan('mailmodo login')} to re-authenticate.`,
     NOT_LOGGED_IN: `Not logged in. Run ${chalk.cyan('mailmodo login')} to authenticate.`,
     NO_YAML: `No mailmodo.yaml found. Run ${chalk.cyan('mailmodo init')} first.`,
+    QUOTA_EDIT_DEFAULT: 'Edit limit reached for this month.',
+    QUOTA_EDIT_TIP: 'AI edits are limited to 50 per account per month. Manually edit the template file under ./mailmodo to make further changes.',
+    QUOTA_INIT_DEFAULT: 'Regeneration limit reached.',
+    QUOTA_INIT_TIP: `Regenerations are limited to 5 per account per month. Run ${chalk.cyan('mailmodo edit <id>')} to modify individual emails instead.`,
     RATE_LIMIT: 'Rate limit exceeded. Please try again later.',
     UNEXPECTED_API: 'An unexpected API error occurred.',
 };
@@ -33,8 +38,21 @@ export const INFO = {
     DOMAIN_NOT_DEPLOYED_HINT: `When ready, run: ${chalk.cyan('mailmodo domain')}\n  Then: ${chalk.cyan('mailmodo deploy')}`,
     DOMAIN_PENDING_VERIFICATION: `Your domain is not verified yet. Please verify it first. Run ${chalk.cyan('mailmodo domain --verify')} to check the status.`,
     FREE_TIER_CAP_BLOCKED: `Monthly cap is a paid-tier setting and is not available on the free tier. Run ${chalk.cyan("'mailmodo billing --checkout'")} to add a payment method, then set a cap.`,
+    PAUSE_CANCELLED: 'Pause cancelled. Sequence is still live.',
     SEQUENCES_NOT_DEPLOYED: `Sequences saved but ${chalk.yellow('NOT deployed')}.`,
 };
+export function pauseSuccess(sequenceId) {
+    return `Sequence ${chalk.cyan(sequenceId)} paused. Run ${chalk.cyan(`mailmodo deploy --resume ${sequenceId}`)} to resume.`;
+}
+export function pauseAlready(sequenceId) {
+    return `Sequence ${chalk.cyan(sequenceId)} is already paused. No change made.`;
+}
+export function resumeSuccess(sequenceId) {
+    return `Sequence ${chalk.cyan(sequenceId)} resumed. Scheduled and triggered sends are live again.`;
+}
+export function resumeAlready(sequenceId) {
+    return `Sequence ${chalk.cyan(sequenceId)} is already active. No change made.`;
+}
 export function yamlParseError(detail) {
     return `mailmodo.yaml has invalid YAML syntax:\n${detail}`;
 }
@@ -42,3 +60,56 @@ export function recordLabel(index) {
     const labels = ['DKIM', 'DMARC', 'Return Path'];
     return labels[index] || `Record ${index + 1}`;
 }
+/**
+ * Parses an ISO-8601 timestamp into a `YYYY-MM-DD` date string.
+ * Returns the raw input if parsing fails so the original value is preserved.
+ */
+export function formatQuotaResetDate(value) {
+    if (!value)
+        return undefined;
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime()))
+        return value;
+    const year = parsed.getUTCFullYear();
+    const month = String(parsed.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(parsed.getUTCDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+/**
+ * Formats a `retry-after` value (seconds) into a short, human-readable hint
+ * suitable for appending to a 429 error message.
+ */
+export function formatRetryAfter(seconds) {
+    if (typeof seconds !== 'number' || !Number.isFinite(seconds) || seconds <= 0)
+        return undefined;
+    if (seconds < 60)
+        return `${Math.round(seconds)} seconds`;
+    const minutes = Math.round(seconds / 60);
+    if (minutes < 60)
+        return `${minutes} minutes`;
+    const hours = Math.round(seconds / 3600);
+    if (hours < 24)
+        return `${hours} hours`;
+    const days = Math.round(seconds / 86_400);
+    return `${days} days`;
+}
+/**
+ * Builds the multi-line message printed when an AI quota (init regeneration or
+ * edit) is exhausted. `serverError` is the message returned by the API; the
+ * default text is used when the server omits it. The tip lists the next action
+ * the user can take (e.g. switch from init to edit).
+ */
+export function quotaExhaustedMessage(input) {
+    const headline = input.serverError || input.defaultMessage;
+    const lines = [headline];
+    const resetDate = formatQuotaResetDate(input.limitReset);
+    if (resetDate && !headline.includes(resetDate)) {
+        lines.push(`Resets on ${resetDate}.`);
+    }
+    const retryHint = formatRetryAfter(input.retryAfter);
+    if (retryHint) {
+        lines.push(`Try again in ${retryHint}.`);
+    }
+    lines.push('', input.tip);
+    return lines.join('\n');
+}

package/oclif.manifest.json

@@ -140,10 +140,12 @@
     "deploy": {
       "aliases": [],
       "args": {},
-      "description": "Deploy email sequences and verify sending domain",
+      "description": "Deploy, pause, or resume an email sequence",
       "examples": [
         "<%= config.bin %> deploy",
-        "<%= config.bin %> deploy --yes"
+        "<%= config.bin %> deploy --yes",
+        "<%= config.bin %> deploy --pause seq_abc123",
+        "<%= config.bin %> deploy --resume seq_abc123 --json"
       ],
       "flags": {
         "json": {
@@ -158,6 +160,26 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "pause": {
+          "description": "Pause a deployed sequence by ID (stops scheduled + triggered sends)",
+          "exclusive": [
+            "resume"
+          ],
+          "name": "pause",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "resume": {
+          "description": "Resume a paused sequence by ID",
+          "exclusive": [
+            "pause"
+          ],
+          "name": "resume",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -176,6 +198,45 @@
         "index.js"
       ]
     },
+    "deployments": {
+      "aliases": [],
+      "args": {},
+      "description": "List every deployed sequence on this account, with the IDs needed for deploy --pause / --resume",
+      "examples": [
+        "<%= config.bin %> deployments",
+        "<%= config.bin %> deployments --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "deployments",
+      "pluginAlias": "@mailmodo/cli",
+      "pluginName": "@mailmodo/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "deployments",
+        "index.js"
+      ]
+    },
     "domain": {
       "aliases": [],
       "args": {},
@@ -365,12 +426,13 @@
         "index.js"
       ]
     },
-    "logout": {
+    "login": {
       "aliases": [],
       "args": {},
-      "description": "Sign out by removing saved credentials from this machine",
+      "description": "Authenticate with Mailmodo using your API key",
       "examples": [
-        "<%= config.bin %> logout"
+        "<%= config.bin %> login",
+        "MAILMODO_API_KEY=YOUR_API_KEY <%= config.bin %> login"
       ],
       "flags": {
         "json": {
@@ -389,7 +451,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logout",
+      "id": "login",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -399,17 +461,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "logout",
+        "login",
         "index.js"
       ]
     },
-    "login": {
+    "logout": {
       "aliases": [],
       "args": {},
-      "description": "Authenticate with Mailmodo using your API key",
+      "description": "Sign out by removing saved credentials from this machine",
       "examples": [
-        "<%= config.bin %> login",
-        "MAILMODO_API_KEY=YOUR_API_KEY <%= config.bin %> login"
+        "<%= config.bin %> logout"
       ],
       "flags": {
         "json": {
@@ -428,7 +489,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "login",
+      "id": "logout",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -438,23 +499,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "login",
+        "logout",
         "index.js"
       ]
     },
-    "preview": {
+    "logs": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Email template ID to preview",
-          "name": "id"
-        }
-      },
-      "description": "Preview an email in browser, as text, or send a test",
+      "args": {},
+      "description": "View email send logs and delivery events",
       "examples": [
-        "<%= config.bin %> preview welcome",
-        "<%= config.bin %> preview welcome --text",
-        "<%= config.bin %> preview welcome --send me@example.com"
+        "<%= config.bin %> logs",
+        "<%= config.bin %> logs --email sarah@example.com",
+        "<%= config.bin %> logs --failed",
+        "<%= config.bin %> logs --json"
       ],
       "flags": {
         "json": {
@@ -470,23 +527,39 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "send": {
-          "description": "Send test email to this address",
-          "name": "send",
+        "email": {
+          "description": "Filter logs by contact email",
+          "name": "email",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "text": {
-          "description": "Output plain text version (for AI agents)",
-          "name": "text",
+        "failed": {
+          "description": "Show only failed/bounced events",
+          "name": "failed",
           "allowNo": false,
           "type": "boolean"
+        },
+        "limit": {
+          "description": "Entries per page (max 200)",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "preview",
+      "id": "logs",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -496,19 +569,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "preview",
+        "logs",
         "index.js"
       ]
     },
-    "logs": {
+    "preview": {
       "aliases": [],
-      "args": {},
-      "description": "View email send logs and delivery events",
+      "args": {
+        "id": {
+          "description": "Email template ID to preview",
+          "name": "id"
+        }
+      },
+      "description": "Preview an email in browser, as text, or send a test",
       "examples": [
-        "<%= config.bin %> logs",
-        "<%= config.bin %> logs --email sarah@example.com",
-        "<%= config.bin %> logs --failed",
-        "<%= config.bin %> logs --json"
+        "<%= config.bin %> preview welcome",
+        "<%= config.bin %> preview welcome --text",
+        "<%= config.bin %> preview welcome --send me@example.com"
       ],
       "flags": {
         "json": {
@@ -524,39 +601,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "email": {
-          "description": "Filter logs by contact email",
-          "name": "email",
+        "send": {
+          "description": "Send test email to this address",
+          "name": "send",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "failed": {
-          "description": "Show only failed/bounced events",
-          "name": "failed",
+        "text": {
+          "description": "Output plain text version (for AI agents)",
+          "name": "text",
           "allowNo": false,
           "type": "boolean"
-        },
-        "limit": {
-          "description": "Entries per page (max 200)",
-          "name": "limit",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs",
+      "id": "preview",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -566,7 +627,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "preview",
         "index.js"
       ]
     },
@@ -657,5 +718,5 @@
       ]
     }
   },
-  "version": "0.0.49"
+  "version": "0.0.50-beta.pr52.80"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.49",
+  "version": "0.0.50-beta.pr52.80",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"